Skip to main content

FAQ & Troubleshooting

Common questions and solutions for nd_crafting.

Installation Issues​

"ox_lib is not installed"​

Solution: Make sure ox_lib is:

  1. Downloaded and in your resources folder
  2. Started before nd_crafting in server.cfg
ensure ox_lib
ensure nd_crafting

"oxmysql is not installed"​

Solution: Same as above - ensure oxmysql starts first and is connected to your database.

Database tables not created​

Solution: Run the SQL file manually:

  1. Open your database manager (HeidiSQL, phpMyAdmin, etc.)
  2. Import nd_crafting/sql/install.sql
  3. Restart the resource

Station Issues​

Stations are floating​

Solution: All stations now automatically snap to ground. If you still have issues:

  1. Delete the floating station
  2. Re-place it with /craftadmin
  3. Or add zOffset to the station type config

Can't interact with station​

Checklist:

  1. Are you close enough? (Default 2.0 units)
  2. Is ox_target running?
  3. Check for errors in F8 console
  4. Verify station exists in database

Station not showing recipes​

Possible causes:

  1. Recipe IDs in station config don't match Config.Recipes
  2. Recipe has job restriction you don't meet
  3. Syntax error in config file

Crafting Issues​

Ingredients consumed but no output​

Possible causes:

  1. Craft failed due to successRate (check notifications)
  2. Inventory is full
  3. Check hooks for errors

Crafts stuck at 100%​

Solution:

  1. Check if onCraftComplete hook has errors
  2. Verify oxmysql connection
  3. Run cleanup SQL:
UPDATE nd_crafting_queue 
SET status = 'completed' 
WHERE end_time < UNIX_TIMESTAMP() 
AND status = 'crafting';

Can't cancel crafts​

Possible causes:

  1. Config.Queue.allowCancel = false
  2. Past the cancelTimeLimit
  3. Not your craft

UI Issues​

UI not opening​

Checklist:

  1. Check F8 console for NUI errors
  2. Verify web/dist folder exists
  3. Try ensure nd_crafting

UI stuck open​

Solution:

  1. Press Escape multiple times
  2. If still stuck: /e c to cancel animation
  3. Relog as last resort

Performance Issues​

Server lag when crafting​

Solutions:

  1. Reduce Config.Queue.TickRate (higher = less frequent checks)
  2. Lower Config.Queue.MaxPerStation
  3. Enable Config.Queue.CleanupRetentionDays to auto-delete old crafts

High database load​

Solutions:

  1. Add indexes to database (should be in install.sql)
  2. Run cleanup to remove old completed crafts
  3. Check for stuck queries

Config Errors​

"attempt to index nil value"​

Cause: Syntax error in config file

Solution:

  1. Check for missing commas
  2. Verify all recipe/station IDs are quoted
  3. Match opening and closing braces

Recipe not available​

Checklist:

  1. Recipe ID is in Config.Recipes
  2. Recipe ID is in station's recipes array
  3. No typos in recipe ID
  4. Job/gang restrictions met

Still Need Help?​

  1. Enable Config.Debug = true for more info
  2. Check F8 console for client errors
  3. Check server console for server errors
  4. Join our Discord for support: discord.gg/ndscripts