settings.debug = true in settings/general.lua and restarting. Then watch your F8 console and server console (filter for [nex_crafting]).
Common issues
| Problem | Fix |
|---|---|
/craftpanel does nothing | You don’t have the permission. Either run add_ace group.admin nex.crafting.creator allow, or make sure your framework group is in settings.permissions.creatorAccess.frameworkGroups. |
DB query failed on start | You forgot to import sql/install.sql. Import it and restart. |
| ”No framework detected” | Your framework resource isn’t started or is loading after nex_crafting. Reorder server.cfg. |
| Benches don’t appear in the world | Empty DB. Open /craftpanel and add one. If they still don’t appear, check the F8 console for prop-load errors — the prop model may be invalid. |
| Placer mode does nothing | object_gizmo isn’t started. Grab it from github.com/DemiAutomatic/object_gizmo and add ensure object_gizmo before nex_crafting. |
| Item images are broken | settings.oxInventory.imagePath doesn’t match your inventory. Default is nui://ox_inventory/web/images/. |
| ”You are missing required materials” but the player has them | Item name mismatch between the recipe ingredient and ox_inventory item name. Edit the recipe and fix the name. |
| Crafting always fails | Failure system is enabled with a base fail chance that’s too high, or the skill check is failing. Lower baseFailChance or disable skillCheck. |
| XP / levels not working | settings.crafting.xpSystem.enabled = false. Flip it on and restart. |
| Discord-gated bench rejects everyone | settings/discord.lua is empty or the bot token is invalid. Make sure the bot has the GUILD_MEMBERS privileged intent enabled in the Discord developer portal. |
| Bench stash button missing | settings.oxInventory.benchStash.enabled = false. Flip it on. |
| Settings I changed in the panel revert after a restart | The script must be able to write to settings/general.lua. On Linux, check file ownership/permissions on that file. |
Before opening a support ticket
Please include:- Your framework (Qbox / QBCore / ESX) and its version.
- Server console output filtered for
[nex_crafting], withsettings.debug = true. - F8 console output from the moment the problem happens.
- What you did and what you expected to happen.