Troubleshooting

Startup Issues

Resource fails to start

Symptoms: Server console shows errors on startup, resource does not appear in resource list.

Solutions:

1. Check dependency order in server.cfg

   ensure ox_lib
   ensure oxmysql
   ensure community_bridge
   ensure oxide-weed

   All three dependencies must start before oxide-weed.

2. Verify database connection — Make sure oxmysql is connected and sql/install.sql has been imported.

3. Verify community_bridge is working — Check that community_bridge detects your framework. Look for its startup messages in the console.

Items not usable

Symptoms: Using a cannabis seed, grow lamp, or other items does nothing. No error in console.

Solutions:

1. Verify items are registered in your framework — All items listed in Installation > Item Registration must exist.

2. Check that items are marked as useable — QBCore: useable = true in the item definition. ESX/ox_inventory: Items are registered via community_bridge automatically.

3. Check for bridge errors — Look for RegisterUsableItem errors in the console from community_bridge.

---

Planting Issues

Seed does nothing when used

Solutions:

1. Check you have a plant pot — Seeds require a plant_pot item in your inventory.

2. Check strain level requirement — If the seed's strain requires a higher level than you have, planting is blocked.

3. Verify the seed has valid metadata — Seeds without metadata default to the Generic strain.

Plant not appearing after placement

Solutions:

1. Check routing bucket — Plants only appear to players in the same routing bucket.

2. Check Config.SpawnDistance — If set too low, plants may not render. Default is 100.0 units.

3. Check for server errors — Look for database insert failures in the console.

---

Growth Issues

Plants not growing

Solutions:

1. Wait for the update interval — Plants update every Config.PlantSettings.updateInterval (default 60 seconds).

2. Check growth stage durations — The final stage is intentionally long (~83 hours). Use grow lamps to accelerate.

3. Use admin commands to test:

   /weed_fasttick    -- Set tick to 5 seconds
   /weed_grow        -- Instant grow to final stage

Plants dying

Solutions:

1. Check water and fertilizer levels — If either reaches 0, the plant is removed. Water decays at 0.2/min, fertilizer at 0.1/min by default.

2. Water and fertilize regularly — Water adds 25 per use (direct) or 20 per watering can use. Fertilizer adds 35 per use.

3. Increase resilience via genetics — Higher resilience trait reduces decay rates by up to 50%.

Quality always low

Solutions:

1. Maintain water and fertilizer above 50% — Care factor accounts for 30% of quality.

2. Use grow lamps — Having at least one lamp linked to a plant adds 10% to the care factor.

3. Use better strains — Genetics account for 70% of quality. Generic (quality 50) caps lower than Amnesia Haze (quality 88).

---

Drying and Processing Issues

Buds not drying

Solutions:

1. Wait for drying time — Default is 30 minutes without heaters. With 3 heaters, approximately 10 minutes.

2. Check the drying tick interval — Updates every Config.Drying.updateInterval (default 30 seconds).

3. Use admin command: /weed_dry

"Not your buds" error

Solutions:

1. Check ownership setting — Config.RequireOwnership = true means only the player who placed the buds can interact. Set to false for shared access.

2. Use the same character — Ownership is tracked by character ID.

Trimming produces no buds

Solutions:

1. Verify you have dried buds — Trimming requires dried_weed_bud, not weed_bud (fresh).

2. Verify you have trimming scissors — Both items must be in your inventory.

3. Check inventory space — Pruning produces 2-5 pruned buds. Your inventory must have space.

---

Selling Issues

Cannot sell to NPCs

Solutions:

1. Check progression level — NPC selling requires level 2 by default (Config.Selling.requiredLevel).

2. Check police requirement — If Config.Selling.minPoliceOnline is set above 0, that many police players must be online.

3. Check NPC blacklist — Cops, EMS, military, and security NPCs are blacklisted. Try a regular civilian ped.

4. Check if selling is enabled — Verify Config.Selling.enabled = true.

NPC always rejects

Solutions:

1. Lower your price — Above 125% of fair value, the NPC always rejects.

2. Check rejection chance — 15% flat rejection chance by default. This is random.

3. Check cooldowns — 5-second player cooldown and 2-minute per-NPC cooldown.

Getting robbed frequently

Solutions:

1. Avoid gang NPCs — NPC models in Config.Selling.gangModels can trigger robberies.

2. Adjust robbery chance — Lower Config.Selling.risks.robberyChance (default 0.15).

---

Store and Scientist Issues

Store NPC not appearing

Solutions:

1. Verify store is enabled — Config.Store.enabled = true

2. Check coordinates — Default: vec3(-1275.97, -1139.92, 6.79). Verify accessibility.

3. Check blip setting — Config.Store.blip.enabled = true for the map blip.

Scientist not offering services

Solutions:

1. Check level requirements — Lab Report: level 2, Cloning: level 4.

2. Verify you have seeds — Both services require a cannabis_seed in inventory.

3. Verify you have funds — These use dirty money (configured via Config.DirtyMoney), not regular cash.

---

Freeze Dryer Issues

Cannot place freeze dryer

Solutions:

1. Check progression level — Requires level 7 (Config.Equipment.freeze_dryer.requiredLevel).

2. Use admin command: /weed_setxp 3200

---

Wild Plant Issues

No wild plants spawning

Solutions:

1. Check if enabled — Config.WildPlants.enabled = true

2. Check zone definitions — Zones must have at least 3 points and plants count > 0.

3. Check spawn distance — Wild plants render within Config.WildPlants.spawnDistance (default 100 units).

4. Check debug output — Enable Config.Debug = true and look for [oxide-weed] Wild zone messages.

---

Smoking Issues

Cannot roll joints or blunts

Rolling requires: rolling papers/cigarillo wraps + weed_1g + lighter. All three must be in inventory. Only one roll can be in progress at a time.

Smoking has no effects

A 60-second cooldown applies between smoking sessions. Dirt-grade weed has minimal effects (40% floor). Higher quality strains produce noticeably stronger effects.

---

General Debugging

Enable Debug Mode

Config.Debug = true  -- in shared/config.lua

Outputs detailed information to the server console prefixed with [oxide-weed].

Useful Admin Commands

Command	Purpose
/weed_info	Show server-wide object counts and your progression
/weed_fasttick	Speed up plant ticks to 5 seconds for testing
/weed_kit	Get all growing supplies
/weed_seeds	Get seeds of random strains
/weed_setxp 3200	Set XP to unlock freeze dryer (level 7)
/weedstats	View your progression stats

Database Checks

SELECT COUNT(*) FROM drug_plants;
SELECT COUNT(*) FROM drug_equipment;
SELECT COUNT(*) FROM drug_lamps;
SELECT COUNT(*) FROM drug_heaters;
SELECT COUNT(*) FROM drug_drying_slots;
SELECT COUNT(*) FROM drug_strains;
SELECT * FROM drugs_progression WHERE drug = 'weed';

---

Getting Help

If none of the above solutions resolve your issue:

1. Enable debug mode (Config.Debug = true) and reproduce the problem
2. Check your server console for error messages with the [oxide-weed] prefix
3. Verify your database tables exist and have the correct schema
4. Confirm all items are registered in your framework
5. Contact Oxide Studios support with:
   • Your server console output
   • Your framework name and version
   • Steps to reproduce the issue
   • Your config changes (if any)