Troubleshooting

Common issues for the current oxide-meth resource.

Resource Does Not Start

Check that these resources are running first:

• ox_lib
• oxmysql
• o-link

Also confirm:

• sql/install.sql was imported
• your framework and inventory resources start before o-link if o-link depends on them
• the server console does not show missing dependency errors from oxide-meth

Items Do Not Work

Typical causes:

• the registered item name does not exactly match the meth config
• one or more variant shard or bag items were never added to the inventory
• the inventory resource behind o-link.inventory is not exposing the item correctly

If you also run oxide-weed, avoid duplicate or conflicting definitions for shared items such as:

• baggy
• cannabis_leaf

Equipment Placement Does Not Work

Check:

1. the player has the correct placement item in inventory
2. the location is not inside a configured safe zone
3. the player meets any required level for that equipment
4. usable-item registration is succeeding through olink.framework.RegisterUsableItem
5. local target interaction is working through your o-link.target adapter

Cooking Does Not Start

Check:

1. the player is interacting with a valid placed meth_table
2. all four base ingredients exist with the exact configured names
3. the selected additive item names match shared/config/additives.lua
4. o-link.inventory is returning valid item counts for the player

Base ingredient names:

• hydrogen_peroxide
• ammonia
• hydrochloric_acid
• sodium_benzoate

Tray Or Crystallizer Issues

Check:

1. drug_equipment and meth_drying_slots exist in the database
2. liquid_meth_tray and crystallized_meth_tray are registered exactly
3. the player is interacting with a placed meth_crystallizer
4. tray metadata is being preserved by your inventory integration

Breaking Or Bagging Fails

Check:

1. crystallized_meth_tray exists before breaking
2. all variant shard items are registered
3. baggy exists with the exact configured name
4. all meth bag output items are registered
5. inventory add and remove operations are not failing through olink.inventory

Gas Mask Or Usage Effects Look Wrong

Check:

1. the gas_mask item exists exactly
2. the configured clothing component in Config.GasMask matches your clothing setup
3. the bagged meth item metadata includes variant and purity values
4. no other resource is immediately overriding armour, healing, or appearance changes

Progression Does Not Save

Check:

1. drugs_progression exists
2. your o-link.character adapter returns a stable identifier
3. oxmysql is running without query errors
4. the row for drug = 'meth' is being created for the character

Useful Checks

• Confirm the server logs show Server initialized from oxide-meth.
• Use /methkit for a fast setup and /meth_sellkit for bagged output testing.
• Use /methstats to confirm the client can fetch progression data through the callback layer.
• If a stage fails silently, check the server console first for inventory add and remove failures or missing metadata.

Support

Need more help?

• Discord: https://discord.gg/dZ6q8FyGhm
• Website: https://www.oxidestudios.dev/
• o-link (required abstraction layer): https://github.com/WHEREISDAN/o-link