FAQ

Frequently asked questions about Chamly Drugs.

Installation & Setup

What frameworks are supported?

ESX Legacy, QBCore, and QBX. The script automatically detects your framework.

Do I need ox_target or qb-target?

No, they're optional. The script has a built-in standalone mode that works without any target system. Just set:

Config.Target.UseTargetSystem = 'standalone'

Where should I put the resource?

Place it in your resources folder. Common locations:

• resources/[chamly]/chamly_drugs/

• resources/[drugs]/chamly_drugs/

• resources/chamly_drugs/

Any location works, just add ensure chamly_drugs to server.cfg.

What items do I need to add?

8 items total:

• Raw: weed, meth, coke, codeine

• Processed: weed_pooch, meth_pooch, coke_pooch, codeine_pooch

See Installation for complete item setup.

Configuration

How do I add new drug locations?

Edit the drug config file (e.g., config/drugs/weed.lua):

harvestLocations = {
    -- Existing location...
    
    -- Add new location:
    {
        drugType = 'weed',
        prop = 'prop_weed_01',
        coords = vec3(X, Y, Z),  -- Your coordinates
        heading = 90.0,
        budCount = { min = 3, max = 6 }
    },
}

See Configuration for details.

How do I get coordinates?

In-game, press F8 and type:

GetEntityCoords(PlayerPedId())

Copy the X, Y, Z values.

How do I change rewards?

Edit drug config file:

harvestReward = {
    amountPerBud = 2,        -- Items per action (was 1)
    bonusChance = 0.2,       -- 20% chance (was 10%)
    bonusAmount = 2          -- Bonus amount (was 1)
}

Can I disable police from using drugs?

Yes! In each drug config:

disabledJobs = { 'police', 'sheriff' }

Add any job names you want to restrict.

How do I change the interaction key?

For standalone mode, edit config/main.lua:

StandaloneSettings = {
    interactKey = 47  -- Change to G key (was 38 = E)
}

Language & Locales

How do I change language?

Edit config/main.lua:

Config.Locale = 'pl'  -- Change to 'pl' for Polish

Then restart: restart chamly_drugs

How do I add my language?

See the Locales Guide for step-by-step instructions.

What languages are included?

• English (en)

• Polish (pl)

Usage & Gameplay

Props/plants don't spawn?

Common causes:

• You're too far away (default spawn distance is 50m)

• Coordinates are wrong in config

• Model doesn't exist in game

Solutions:

• Get closer to configured coordinates

• Check config files for correct coords

• Verify no errors in F8 console

Can't click buds/items?

Check:

• Camera activated properly

• Cursor is visible on screen

• No other UI blocking interaction

• Restart interaction (press ESC and try again)

Not receiving items after harvesting?

Possible issues:

1. Inventory full - Clear space

2. Items don't exist - Add to database (see Installation)

3. Job restricted - Check disabledJobs in config

4. Server error - Check server console

How do I cancel harvesting/processing?

Press ESC key anytime during interaction.

Do items respawn?

Yes! After collecting all items from a location, new ones spawn automatically. No cooldown.

How many raw materials do I need to process?

10 units of raw material per processing session:

• 10x Weed → 2x Weed Pooch

• 10x Meth → 2x Meth Pooch

• 10x Coke → 2x Coke Pooch

• 10x Codeine → 2x Codeine Pooch

Discord Logging

How do I enable Discord logs?

Edit config/logs.lua:

LogsConfig = {
    Enabled = true,  -- Enable logging
    Webhooks = {
        drugs_weed = 'YOUR_WEBHOOK_URL_HERE',
        -- ... add webhooks for each drug
    }
}

How do I create a Discord webhook?

1. Discord Server Settings

2. Integrations → Webhooks

3. Click "New Webhook"

4. Name it (e.g., "Chamly Drugs - Weed")

5. Copy URL

6. Paste in config

What gets logged?

• All harvesting actions (player, location, amount)

• All processing actions (materials, products)

• Player identifiers

• Timestamps

Performance

Script causing lag?

Try these:

1. Reduce spawn distance:

spawnDistance = 30.0  -- Lower from 50.0

1. Limit number of locations - Remove unused farms

2. Check for errors - Server and client console

How many players can use it at once?

No hard limit. Optimized for multiple players. Each player has independent interactions.

Errors & Troubleshooting

"No framework detected" error?

Make sure your framework starts BEFORE chamly_drugs in server.cfg:

ensure es_extended    # Framework FIRST
ensure chamly_drugs   # Script AFTER

"Item doesn't exist" error?

Items not in database. Follow Installation guide to add all 8 items.

Target prompts not appearing?

Solutions:

1. Install ox_target or qb-target, OR

2. Use standalone mode:

Config.Target.UseTargetSystem = 'standalone'

Camera not working?

Check:

• No conflicts with other camera scripts

• No errors in F8 console

• Try pressing ESC and restarting interaction

Player can't move after interaction?

Emergency fix:

• Press ESC

• Type in F8: /logout or relog

• Check server console for errors

Economy & Balance

Are the default rewards balanced?

Default values are moderate. Adjust based on your server's economy:

• Low economy: Increase amountPerBud and bonusChance

• High economy: Decrease values or increase processing requirements

What's the profit margin?

Depends on your selling prices. Default ratio:

• 10 raw → 2 processed = 5:1 conversion

If raw sells for $100 and processed for $1000:

• Raw profit: 10 × $100 = $1,000

• Processed profit: 2 × $1,000 = $2,000

Processing doubles profit in this example.

Can I change processing ratios?

Yes! Edit drug config:

processingRecipe = {
    required = { ['weed'] = 5 },    -- Need only 5 (was 10)
    products = { ['weed_pooch'] = 3 } -- Get 3 bags (was 2)
}

Updates & Support

How do I update the script?

1. Backup your config/ folder

2. Replace old script with new version

3. Restore your config files

4. Check changelog for breaking changes

5. Restart server

Will my configs be overwritten?

Not if you backup config/ folder before updating. Always backup your custom configs.

Where can I get help?

• 📖 Read this FAQ

• 💬 Join Discord

Still Have Questions?

Can't find your answer? Contact Support - we're here to help!