> ## 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

> Check your server console (filter for [nex_itemwhitelist]) first — every block / hook event logs there.

Check your **server console** (filter for `[nex_itemwhitelist]`) first — every block / hook event logs there.

## Common issues

| Problem                                                                   | Fix                                                                                                                                                                 |
| ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/whitelistmenu` does nothing                                             | You don't have the admin ACE group. Run `add_ace identifier.steam:XXXXXXXXX group.admin` (or whatever you set `Config.AdminGroup` to).                              |
| Blocks aren't firing — players can still drop / trade the item            | The script started **before** `ox_inventory`. Reorder `server.cfg` so `ox_inventory` is listed first. Also check that `Config.Inventory` matches the resource name. |
| `attempt to call nil value (registerHook)` in server console              | Your `ox_inventory` is too old. Update to a recent version.                                                                                                         |
| Notifications don't show up                                               | `Config.NotifySystem` doesn't match what you actually run. Check that the matching resource in `Config.NotifyResources` is started.                                 |
| Discord webhook isn't logging                                             | `Config.Discord.webhook` is empty, or `Config.LogAttempts = false`. Set both. Check the server console for HTTP errors — Discord webhook URLs can be revoked.       |
| Player whitelist works but job whitelist doesn't                          | `Config.Framework` is wrong, or the framework resource isn't started. Set `Config.Framework = 'auto'` or force the correct one.                                     |
| Player can still **buy** the item from a shop                             | ox\_inventory shop hooks only trigger if the shop was opened via `ox_inventory`. Custom shops that bypass ox\_inventory won't be caught.                            |
| "Someone tried to give you a whitelisted item" notification not appearing | `Config.Notifications.attemptNotify` is the message — check that key. It uses your configured `Config.NotifySystem`.                                                |
| Update checker spamming the console                                       | `Config.UpdateCheck` is set to an invalid URL. Either fix it or set it to `''`.                                                                                     |
| Server ID resolves to the wrong player                                    | The player disconnected between you typing the ID and the server resolving it. Re-add the entry.                                                                    |

## Item / weapon name doesn't match

* **Items**: use the exact name from your `ox_inventory` items data. Case-sensitive.
* **Weapons**: the name must be uppercase like `WEAPON_PISTOL`. The menu auto-uppercases it; commands don't, so type it uppercase.

## Resetting the table

If you want to wipe everything:

```sql theme={null}
TRUNCATE TABLE nex_whitelist;
```

The table is auto-recreated on next start, so dropping it works too.

## Before opening a support ticket

Please include:

1. Your framework (Qbox / QBCore / ESX) and ox\_inventory version.
2. Server console output filtered for `[nex_itemwhitelist]`.
3. The exact command you ran or action you took.
4. The output of `/listwhitelist`.

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