> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexdev.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Start by setting settings.debug = true in settings/general.lua and restarting. Then watch your F8 console and server console (filter for [nex_crafting]).

Start by setting `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](https://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:

1. Your framework (Qbox / QBCore / ESX) and its version.
2. Server console output filtered for `[nex_crafting]`, with `settings.debug = true`.
3. F8 console output from the moment the problem happens.
4. What you did and what you expected to happen.

See [Support & contact](/general/support).