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

​
Common issues

ProblemFix
/whitelistmenu does nothingYou 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 itemThe 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 consoleYour ox_inventory is too old. Update to a recent version.
Notifications don’t show upConfig.NotifySystem doesn’t match what you actually run. Check that the matching resource in Config.NotifyResources is started.
Discord webhook isn’t loggingConfig.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’tConfig.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 shopox_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 appearingConfig.Notifications.attemptNotify is the message — check that key. It uses your configured Config.NotifySystem.
Update checker spamming the consoleConfig.UpdateCheck is set to an invalid URL. Either fix it or set it to ''.
Server ID resolves to the wrong playerThe 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: 
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.