Troubleshooting

Common problems and how to fix them. Work top to bottom — most issues are item names or load order.

The resource doesn't start

1. Check the server console for red errors mentioning oxide-meth.
2. Make sure ox_lib, oxmysql, and o-link all start before oxide-meth in your server.cfg.
3. The database tables are created automatically the first time the resource starts — but that only works if oxmysql is connected to your database. If the console shows oxmysql connection errors, fix those first.
4. Your framework and inventory resources must start before o-link — if other Oxide resources work, this is already right.

To see detailed logging from the resource, set Config.Debug = true in shared/config.lua and restart it. Turn it back off when you're done.

"You don't have the required items" (but the player does)

This almost always means an item name doesn't match exactly.

1. Compare the item names in your inventory against the tables in Installation — every letter and underscore must match (hydrogen_peroxide, not hydrogen-peroxide or HydrogenPeroxide).
2. Make sure all the variant shard and baggy items exist. If a player cooked Blue Sky, breaking and bagging need crystal_meth_blue_sky and meth_baggy_blue_sky to exist.
3. If you also run oxide-weed, make sure baggy and cannabis_leaf are only defined once in your inventory.

Using an equipment item does nothing

1. The item must be marked usable in your inventory (qb-inventory: useable = true; ox_inventory: usable by default).
2. Equipment can't be used from inside a vehicle — the player gets a warning message.
3. The crystallizer can have a level requirement (requiredLevel in shared/config/equipment.lua) — it ships at 0, but check if you changed it.
4. Placement is blocked inside your configured safe zones — the player gets a "Can't place items in safe zones" message.

No interaction options on placed equipment

The walk-up options (Cook Meth, Break Meth, etc.) come through your targeting resource (usually ox_target) via o-link. If other Oxide resources' target options work, meth's will too. If none work, your targeting resource isn't running or isn't connected through o-link.

Cooking won't start

1. The player needs at least 1 of each of the four ingredients: hydrogen_peroxide, ammonia, hydrochloric_acid, sodium_benzoate.
2. The table must be one placed through this resource — a decoration prop won't work.
3. If additives don't appear in the additive panel, the player either doesn't have any in their inventory or hasn't reached that additive's unlock level.

Trays won't dry / crystallizer looks empty after a restart

1. Confirm the drug_equipment and meth_drying_slots tables exist in your database.
2. Drying takes 5 minutes by default (Config.Drying.dryingTime) — a tray collected early isn't ready, and the script will say so.
3. With ownership on (Config.RequireOwnership = true, the default), only the player who placed a tray can collect it. Other players get no response by design.
4. If trays lose their variant/purity when going in or out of the crystallizer, your inventory resource isn't preserving item metadata — check that you're on a supported inventory (see o-link's documentation).

Breaking or bagging gives nothing

1. Breaking needs at least 1 crystallized_meth_tray in the player's inventory.
2. Bagging needs at least 3 shards of one product plus at least 1 baggy.
3. If the action completes but no item arrives, the player's inventory may be full — they'll get an "inventory is full" message and the materials are refunded.
4. Make sure every variant's shard and baggy item is registered (this is the most common cause).

Gas mask doesn't show on the player

The mask is a clothing component. Config.GasMask ships with component 1, drawable 175 — those numbers are for the default GTA clothing. If your server uses a custom clothing pack, find a mask drawable that exists in your pack and update drawable (and texture) in shared/config.lua.

Usage effects look wrong or don't trigger

1. Only bagged meth is usable — shards and trays are not.
2. The baggy items must be marked usable in your inventory.
3. There's a cooldown (120 seconds by default) after the previous high ends — the player gets a wait message.
4. Meth can't be used inside a vehicle.
5. If armour or healing seem to vanish instantly, another resource (a HUD or health script) may be overriding them.

Progression doesn't save

1. Confirm the drugs_progression table exists.
2. Watch the server console for oxmysql errors — usually wrong database credentials or a missing table.
3. Progression is saved per character. If /methstats shows nothing, the character may not be fully loaded yet — have the player relog.

Quick test tools

• /methkit — gives a full production kit (admin)
• /meth_sellkit — gives finished product with random variants/purities (admin)
• /setmethlvl [id] [level] — set a player's level to test unlocks (admin)
• /methstats — confirms the client can talk to the server and read progression

See Admin for the permission setup these need.