Troubleshooting
Admin Studio says access denied
Confirm the ACE exists and the group is assigned to the player:
add_ace group.admin nord_inventory.admin allow
Also confirm:
Config.AdminAce = 'nord_inventory.admin'
Inventory does not start
- Confirm
oxmysqlis installed. - Start
oxmysqlbeforenord_inventory. - Check MySQL/MariaDB connectivity.
- Check the server console for a Lua/SQL error before the inventory bootstrap completes.
Framework bridge is wrong
Set it explicitly instead of auto:
Config.Framework = 'qb'
-- esx | qbox | nord | standalone
Then restart the resource.
Custom item changes revert after restart
In v1.6.11, a valid DB row is authoritative and should persist. Check:
- that
nord_inventory_custom_itemscontains the item row; - database write errors in the console;
- whether you intentionally used Revert to base, which deletes the override row.
Trunk does not open
Check:
- vehicle is unlocked;
- the vehicle is not classified as no-trunk;
- you are within the configured distance;
- trunk interaction is enabled;
- an addon vehicle with incomplete metadata may need a saved Admin placement.
Glovebox/trunk capacity looks wrong
Capacity precedence is:
model override > category > fallback
Review the model and category in Admin Studio. Historical stored inventory capacity does not override the current vehicle registry settings when storage opens.
Item has no hand prop
For usable items, v1.6.11 should try the prop fallback. Check:
Config.ItemPropAttachments.Enabled = true
Config.ItemPropAttachments.Fallback.Enabled = true
Then verify the item has a valid worldModel, matching name/category rule, or allow the generic fallback.
Ground item uses a box instead of its intended prop
Set a valid worldModel on the item. Otherwise Nord falls back to:
Config.GroundDefaultModel = 'prop_cs_cardbox_01'
A third-party script cannot access a private stash
Open it from trusted server code after checking the player's job/permission. Do not depend on unrestricted client-side access for private storage.
Admin Studio says access denied
Check in order:
- The command is being executed in-game, not from an invalid context.
add_ace group.admin nord_inventory.admin allowexists when using ACE.- The user is actually assigned to that ACE group/principal.
- If using direct fallback,
Config.AdminAccess.LicenseFallback = true. - The player's FiveM license is present in
server/config.lua. - The license may be written with or without the
license:prefix. - Restart the resource after changing the server-only config.
Weapon reload does not consume correctly
- Verify the ammo item name matches the weapon's configured ammunition type.
- Confirm
metadata.magazineSizeis valid or allow GTA clip-size detection for first use. - Remember that reserve ammo must remain as inventory items.
- Do not add another script that writes hidden GTA reserve ammo while Nord controls the weapon.
Ammo item shows a hand prop
In v1.6.10+ ammo/magazine semantics bypass the hand-prop fallback. If a custom script manually attaches a prop outside Nord's use action, remove that external attachment logic.