Nord Inventory v1.6.11
Official Nord Lab documentation for Nord Inventory v1.6.11, covering installation, secure admin access, Admin Studio, weapon magazine ammunition, vehicle storage, Nord Staff integration, developer API and production operations.
Welcome · Nord Inventory v1.6.11
Nord Inventory is Nord Lab's production-ready, server-authoritative inventory system for FiveM. I...
Quick Start
This is the shortest path to a working Nord Inventory installation. 1. Requirements FiveM server ...
What’s New · v1.6.11
This page summarizes the important changes since the v1.6.8 prop-fallback release. v1.6.11 · Admi...
1 · Setup & Access
Install Nord Inventory, choose a framework, configure administrator access and set the core runti...
Requirements & Installation
Requirements Requirement Status FiveM / OneSync Required MySQL or MariaDB Required oxmysql Requir...
Framework Detection
Set the framework mode in config.lua: Config.Framework = 'auto' -- auto | esx | qb | qbox | nord...
Admin Access · ACE + License Fallback
Nord Inventory v1.6.11 supports two administrator authorization methods without exposing license ...
Admin Commands
All commands in Config.AdminCommands require Nord Inventory admin access. They can be renamed or...
Core Configuration
The complete configuration is in config.lua. The values below are the defaults shipped with v1.6...
Interaction Providers
Nord can use its own Text UI or a target resource for ground items, configured stashes and vehicl...
Locales
Nord Inventory v1.6.11 ships with: locales/en.json locales/pt.json (Portuguese, PT-PT) Select the...
2 · Player Experience
Player inventory UI, hotbar, ground interactions, containers, metadata and Personal Studio.
Inventory UI & Dual Inventory
Nord uses a dual-inventory layout. Left: the player's own inventory. Right: the currently active ...
Fast Slots & Hotbar
Nord reserves the first five inventory slots as Fast Slots when the default configuration is used...
Ground Items, Pickup & Throw
Items moved to Ground become real server-synchronized ground drops with local world props. Defaul...
Container Items & Backpacks
An item definition can itself provide storage. ['backpack'] = { label = 'Backpack', weigh...
Metadata, Durability & Expiration
Nord stores arbitrary item metadata per item instance. Metadata defaults metadataDefaults = { ...
Personal Studio
Players can customize the presentation of their own inventory without changing Admin Studio or se...
3 · Admin Studio & Items
Manage the item registry, categories, use actions, prop fallback, metadata, lifecycle and imports.
Admin Studio Overview
Open Admin Studio with: /norditems The request is checked server-side using the configured ACE pe...
Item Registry & Categories
The Items workspace uses a folder-style explorer. Built-in categories The package defines categor...
Creating & Editing Items
Admin Studio provides a Quick Create flow and a more detailed Item Management editor. Core fields...
Item Use & Prop Fallback
Explicit use configuration use = { duration = 2500, allowMove = true, cancelable = tr...
Metadata Editor
Nord supports arbitrary metadata while still allowing the item definition to describe expected fi...
Lifecycle Editor
The Item Management Lifecycle page controls durability and shelf life. Durability fields Enabled....
Imports & Exports
Admin Studio includes a migration workspace for item definitions. Import sources The client-side ...
DB-Authoritative Item Definitions
Nord Inventory treats database-backed item definitions as authoritative by item name. Precedence ...
4 · Weapons & Ammunition
Server-authoritative magazine ammunition, reload modes, durability and weapon visuals.
Weapon System Overview
Nord Inventory stores weapons as normal inventory item instances with server-authoritative metada...
Magazine Ammunition · Server Authority
The v1.6.9 ammunition model treats the inventory as the authority for reserve rounds. Reload tran...
Manual & Automatic Reload Modes
Reload mode is a player preference managed in Personal Studio. Manual The player presses R ( INP...
Ammo & Magazine Items · No Hand Props
v1.6.10 intentionally removes hand-held props from ammunition and magazine use actions. Behavior ...
Weapon Durability & Back Display
Durability per fired round For firearms, durability.lossPerUse is interpreted as durability loss...
5 · Vehicle Storage
Trunks, gloveboxes, Vehicle Storage Studio, addon placement, NPC loot and capacity exports.
Vehicle Storage Overview
Nord Inventory v1.6.11 manages trunk and glovebox capacity independently. Each vehicle/category c...
Vehicle Catalog & Capacity Registry
Registry configuration Config.VehicleRegistry = { Enabled = true, AutoImportFramework = t...
Trunk & Glovebox Behavior
Direct commands /trunkinv /gloveboxinv Trunk interaction The default trunk interaction settings i...
Addon Trunk Placement
Admin Studio can create a saved interaction placement for addon vehicles whose metadata/skeleton ...
NPC Vehicle Trunk Loot
Nord can optionally populate verified ambient/NPC vehicle trunks with one-time random loot. Enabl...
Vehicle Storage Exports
Nord provides server exports for external resources that need to know the effective capacity of a...
6 · Nord Staff & Developer API
Nord Staff integration plus server/client exports, stashes, hooks and migration patterns.
Nord Staff Integration
Nord Inventory is designed to integrate with Nord Staff as part of the Nord Lab ecosystem. Integr...
Integration API Overview
Nord Inventory exposes a Nord-native API with familiar slot-inventory contracts so other FiveM re...
Server Exports · Catalog & Opening
Inventory/catalog exports Export Purpose GetInventoryType() Returns nord_inventory GetItemDefini...
Server Exports · Add, Remove & Carry
AddItem local ok, result = exports.nord_inventory:AddItem( source, 'water', 2, { ...
Server Exports · Read & Search
Inventory data local inv = exports.nord_inventory:GetInventory(source) Public inventory data incl...
Server Exports · Metadata & Inventory Management
Metadata exports.nord_inventory:SetMetadata(target, slot, metadata) exports.nord_inventory:GetMet...
Client Read-Only Exports
Nord maintains a lightweight local player-inventory snapshot so common read-only exports work eve...
Registering Stashes & Custom Inventories
RegisterInventory exports.nord_inventory:RegisterInventory('mechanic_storage', { label = 'Mec...
Usable Items & Hooks
RegisterUsableItem Use a trusted server resource to attach behavior to an item: exports.nord_inve...
Runtime Item Registration
Trusted server resources can register an item definition without editing shared/items.lua. local...
OX / QB Migration Examples
Nord intentionally exposes familiar helpers so resource integration can be small. Item count OX-s...
Complete Export Index · v1.6.11
Server · Core and registry GetInventoryType, GetItemDefinition, GetItems, GetItemList, Items,...
7 · Database, Security & Operations
Persistence, security model, troubleshooting, upgrades and production validation.
Item Definition Reference
The normalized definition supports these core fields: Field Purpose label Player-facing item name...
Configuration Reference
This page lists the main configurable groups in v1.6.11. Config Default / purpose Config.Framewor...
Database & Persistence
Item definition precedence Nord uses one deterministic rule: If a row exists in nord_inventory_c...
Security & Server Authority
Nord Inventory is intentionally designed so the UI/client does not become the authority for inven...
Troubleshooting
Admin Studio says access denied Confirm the ACE exists and the group is assigned to the player: a...
Update Guide · v1.6.8 → v1.6.11
Use this page when updating from the previous prop-fallback build. 1. Replace resource files Back...
Production Checklist
Before releasing Nord Inventory on a live server, verify the following. Server oxmysql starts b...
Downloadable Reference Files
The following original v1.6.11 resource files are attached to this BookStack import for quick ref...