Installation

Quick installation guide for Chamly Drugs.

Requirements

• FiveM Server (latest version recommended)

• Framework: ESX Legacy, QBCore, or QBX

• Target System: ox_target or qb-target (optional - has standalone mode)

Installation Steps

1. Download & Upload

1. Download chamly_drugs from CFX Portal - official site of FiveM with purchased resources

2. Extract the resource

3. Place in your server's resources folder

2. Add to server.cfg

Add AFTER your framework:

# Framework (choose one)
ensure es_extended   # ESX

# ensure qb-core     # QBCore

# ensure qbx_core    # QBX

# Chamly Drugs
ensure chamly_drugs

3. Install Items

You need to add 8 items to your inventory system:

Raw Materials: weed, meth, coke, codeine Processed Products: weed_pooch, meth_pooch, coke_pooch, codeine_pooch

For ESX with ox_inventory

Add to ox_inventory/data/items.lua:

['weed'] = {
    label = 'Marijuana Bud',
    weight = 10,
    stack = true,
    close = true,
    description = 'Raw marijuana buds'
},
['weed_pooch'] = {
    label = 'Weed Bag',
    weight = 50,
    stack = true,
    close = true,
    description = 'Processed marijuana bag'
},
['meth'] = {
    label = 'Meth Crystal',
    weight = 15,
    stack = true,
    close = true,
    description = 'Raw methamphetamine crystals'
},
['meth_pooch'] = {
    label = 'Meth Bag',
    weight = 80,
    stack = true,
    close = true,
    description = 'Processed meth bag'
},
['coke'] = {
    label = 'Cocaine Leaf',
    weight = 10,
    stack = true,
    close = true,
    description = 'Raw cocaine leaves'
},
['coke_pooch'] = {
    label = 'Cocaine Bag',
    weight = 60,
    stack = true,
    close = true,
    description = 'Processed cocaine bag'
},
['codeine'] = {
    label = 'Codeine Vial',
    weight = 12,
    stack = true,
    close = true,
    description = 'Raw codeine vials'
},
['codeine_pooch'] = {
    label = 'Codeine Bag',
    weight = 70,
    stack = true,
    close = true,
    description = 'Processed codeine bag'
},

Don't forget to add item images to ox_inventory/web/images/ folder!

For QBCore

Add to qb-core/shared/items.lua:

['weed'] = {
    name = 'weed',
    label = 'Marijuana Bud',
    weight = 10,
    type = 'item',
    image = 'weed.png',
    unique = false,
    useable = false,
    shouldClose = true,
    description = 'Raw marijuana buds'
},
-- ... repeat for all 8 items

Add item images to qb-inventory/html/images/ folder.

📄 Complete item setup for all systems is in ITEMS_INSTALLATION.md file in the resource folder.

4. Basic Configuration

Edit config/main.lua:

Config.Locale = 'en'  -- Language: 'en' or 'pl'

Config.Target = {
    UseTargetSystem = 'auto'  -- Auto-detect target system
}

5. Restart Server

restart chamly_drugs

Or restart the entire server.

Verification

Test if everything works:

1. Join your server

2. Give yourself a test item: /giveitem [your_id] weed 1

3. Check inventory - item should appear

4. Go to a drug location (check config/drugs/weed.lua for coordinates)

5. Approach a plant and press E (or use target)

6. Complete harvesting minigame

7. Check if you received items

Default Locations

Check these config files for default locations:

• config/drugs/weed.lua - Weed farm coordinates

• config/drugs/meth.lua - Meth lab coordinates

• config/drugs/coke.lua - Cocaine farm coordinates

• config/drugs/codeine.lua - Codeine locations

Troubleshooting

"Item doesn't exist" error

• Add all 8 items to your inventory system

• Restart inventory resource

• Verify item names match exactly

No target prompts appearing

• Install ox_target or qb-target, OR

• Set Config.Target.UseTargetSystem = 'standalone'

"Framework not detected" error

• Ensure framework starts BEFORE chamly_drugs in server.cfg

Props not spawning

• Get closer to location (within 50m)

• Check coordinates in config files

Next Steps

• Configure locations and rewards

• Add translations for your language

• Learn usage mechanics

Need Help?

• 📖 FAQ

• 💬 Support