Skip to main content

Nord Inventory · v2.0.0 Documentation

Complete production documentation for Nord Inventory v2.0.0 by Nord Lab.

Welcome · Nord Inventory

Welcome · Nord Inventory Nord Inventory is Nord Lab's production inventory platform for FiveM. It...

Quick Start

Quick Start Minimal production installation for a new server. Applies to: Nord Inventory v2.0.0 ...

Architecture at a Glance

Architecture at a Glance How the resource is separated into editable configuration, public integr...

Build Compatibility · 2.0.0

Build Compatibility · 2.0.0 Snapshot of the production defaults and documented surfaces in this p...

Setup & Configuration

Overview · Setup & Configuration

1 · Setup & Configuration Install Nord Inventory, configure frameworks, permissions, locales, bri...

Requirements & Installation

Requirements & Installation Production installation, dependency order and first-run checks. Appli...

Production Resource Structure

Production Resource Structure The important folders and what server owners should edit. Applies t...

Modular Configuration

Modular Configuration All supported owner configuration is split by responsibility under config/...

Core Configuration

Core Configuration Current config/core.lua defaults. Applies to: Nord Inventory v2.0.0 -- Nord ...

Inventory Runtime Configuration

Inventory Runtime Configuration Slot/weight limits, session behavior and weapon magazine defaults...

Framework Detection & Custom Bridge

Framework Detection & Custom Bridge Framework selection and how to handle unsupported/custom core...

Admin Access & Roles

Admin Access & Roles ACE, server-only license fallback and Nord Staff grants. Applies to: Nord I...

Admin Commands

Admin Commands Current command aliases and access expectations. Applies to: Nord Inventory v2.0....

Notify, Text UI & Target Bridges

Notify, Text UI & Target Bridges Independent bridge selection for notifications, world prompts an...

Locales & Translation

Locales & Translation PT/EN locale architecture and the rule for adding visible UI strings. Appli...

Static Stashes

Static Stashes Static configuration plus dynamic registration options. Applies to: Nord Inventor...

Tebex / Asset Escrow Release

Tebex / Asset Escrow Release Production packaging and distribution notes. Applies to: Nord Inven...

Asset Escrow Map

Asset Escrow Map Which surfaces are intended to stay configurable and which remain protected. App...

Production Checklist

Production Checklist Pre-release checklist for server owners and Nord Lab builds. Applies to: No...

Player Experience

Overview · Player Experience

2 · Player Experience Player inventory behavior, quick slots, lifecycle, item visuals, world drop...

Inventory UI & Dual Inventory

Inventory UI & Dual Inventory Player inventory behavior and the left/right storage model. Applies...

Fast Slots, Hotbar & Special Slots

Fast Slots, Hotbar & Special Slots Default slots 1–7 and quick-use behavior. Applies to: Nord In...

Player Shortcuts

Player Shortcuts Default keyboard shortcuts and commands. Applies to: Nord Inventory v2.0.0 Play...

Received Item Feedback

Received Item Feedback Compact item notifications for rewards, crafting and received items. Appli...

Ground Items, Pickup & Throw

Ground Items, Pickup & Throw Server-synchronized ground drops and safe throw limits. Applies to: ...

Container Items & Backpacks

Container Items & Backpacks Items that own their own nested inventory. Applies to: Nord Inventor...

Metadata, Durability & Expiration

Metadata, Durability & Expiration Per-instance data, lifecycle state and presentation. Applies to...

Metadata Privacy & Hidden Fields

Metadata Privacy & Hidden Fields How integrations can store internal identifiers without exposing...

Durability Repair Items

Durability Repair Items Internal repair consumables and the public durability API. Applies to: N...

Rarity System & Slot Presentation

Rarity System & Slot Presentation Opt-in rarity, metadata override and current levels. Applies to...

Item Props & Use Animations

Item Props & Use Animations Definition-driven held props and safe fallbacks. Applies to: Nord In...

Large Weapons on the Back

Large Weapons on the Back Cosmetic long-weapon display for unequipped inventory weapons. Applies ...

Item Context Actions

Item Context Actions Built-in and provider-registered actions available from an item. Applies to:...

Personal Studio

Personal Studio Player-facing preferences without changing server-wide authority. Applies to: No...

Player Search & Robbery

Player Search & Robbery Server-authoritative player-to-player viewing and one-way transfer. Appli...

Hands-Up Integration

Hands-Up Integration Built-in surrender state plus compatibility with external hands-up resources...

Equipment Slots 2.0

Equipment Slots 2.0 Applies to: Nord Inventory v2.0.0 Special/equipment slots remain real player...

Admin Studio & Item Management

Overview · Admin Studio & Item Management

3 · Admin Studio & Item Management Manage definitions, roles, imports, providers, health, backups...

Admin Studio Overview

Admin Studio Overview Server-authoritative administration for items, providers, diagnostics and v...

Permission Matrix

Permission Matrix Exact role hierarchy used by the v2.0.0 server permission bridge. Applies to: ...

Item Registry & Categories

Item Registry & Categories Built-in categories and the provider-aware item registry. Applies to: ...

Creating & Editing Items

Creating & Editing Items Core item fields and DB-authoritative editing workflow. Applies to: Nor...

Internal & External Use Behavior

Internal & External Use Behavior Choose one clear authority for item use. Applies to: Nord Inven...

Lifecycle Editor

Lifecycle Editor Durability, shelf life and repair behavior in item definitions. Applies to: Nor...

Metadata Editor

Metadata Editor Structured metadata defaults, display rules and provider schemas. Applies to: No...

Rarity Editor

Rarity Editor Opt-in rarity configuration in Admin Studio. Applies to: Nord Inventory v2.0.0 Rar...

Imports & Migration Center

Imports & Migration Center Preview-first item-definition migrations and compatibility imports. Ap...

DB-Authoritative Definitions & Precedence

DB-Authoritative Definitions & Precedence Why Admin Studio edits survive runtime registration and...

Delete, Disable & Restore Items

Delete, Disable & Restore Items Source-aware item removal without losing track of reference/runti...

Vehicle Registry

Vehicle Registry Vehicle model/category capacity management in Admin Studio. Applies to: Nord In...

Integrations & Provider Registry

Integrations & Provider Registry Runtime provider ownership, health and registration visibility. ...

System Health, Backups & Audit

System Health, Backups & Audit Operational visibility and recovery controls. Applies to: Nord In...

Recommended Scripts Modal

Recommended Scripts Modal Read-only curated catalog with automatic compatibility tabs, search and...

Developer API & Integrations

Overview · Developer API & Integrations

4 · Developer API & Integrations Complete public export surface, runtime registration, provider o...

Integration API Overview

Integration API Overview Public, versioned integration surface for trusted FiveM resources. Appli...

Canonical Item IDs & Aliases

Canonical Item IDs & Aliases Keep one item identity while supporting legacy third-party names. Ap...

Server Exports · Catalog & Opening

Server Exports · Catalog & Opening Catalog lookup, item identity and inventory opening. Applies t...

Server Exports · Add, Remove & Carry

Server Exports · Add, Remove & Carry Safe item/money mutations and preflight capacity checks. App...

Server Exports · Read & Search

Server Exports · Read & Search Inventory snapshots, slot queries and count/search helpers. Applie...

Server Exports · Metadata & Inventory Management

Server Exports · Metadata & Inventory Management Metadata mutation plus capacity and inventory li...

Client Read-Only Exports

Client Read-Only Exports Local snapshot helpers for UI/gameplay checks. Applies to: Nord Invento...

Registering Stashes & Custom Inventories

Registering Stashes & Custom Inventories Dynamic storage registration from another server resourc...

Usable Items & External Handlers

Usable Items & External Handlers Attach behavior without making the browser authoritative. Applie...

Developer Ecosystem SDK

Developer Ecosystem SDK Provider-aware runtime items, actions, schemas, images, hooks and health ...

Categories & Runtime Catalogs

Categories & Runtime Catalogs Register categories and grouped catalogs from provider resources. A...

Integration Manifests & Provider Ownership

Integration Manifests & Provider Ownership Register a resource as an explicit provider and expose...

Item Actions, Metadata Schemas & Images

Item Actions, Metadata Schemas & Images Presentation and action extension points. Applies to: No...

Durability & Container API

Durability & Container API Lifecycle and nested-storage helpers for integrations. Applies to: No...

Hooks, Capabilities & Diagnostics

Hooks, Capabilities & Diagnostics Feature detection and operational inspection. Applies to: Nord...

Admin Access Exports

Admin Access Exports Public server access bridge used by Nord Staff and trusted administration to...

Player Interaction Exports

Player Interaction Exports Open search/robbery sessions and integrate surrender state. Applies to...

Notify & Text UI Exports

Notify & Text UI Exports Use Nord bridges without binding your integration to the NUI implementat...

OX / QB Migration Examples

OX / QB Migration Examples Common compatibility patterns when moving an integration to Nord Inven...

Complete Export Index

Complete Export Index Generated from export declarations in this exact build. Applies to: Nord I...

Operations API · v2.0.0

Operations API · v2.0.0 Applies to: Nord Inventory v2.0.0 Four server exports are added by the O...

Weapons & Vehicle Storage

Overview · Weapons & Vehicle Storage

5 · Weapons & Vehicle Storage Weapon magazine authority, throwables, lifecycle and secure trunk/g...

Weapon System Overview

Weapon System Overview Weapons as inventory item instances with server-owned ammunition/lifecycle...

Magazine Ammunition · Server Authority

Magazine Ammunition · Server Authority Current magazine model and reload transaction rules. Appli...

Manual & Automatic Reload Modes

Manual & Automatic Reload Modes R vs automatic reload timing in the current config. Applies to: ...

Empty Magazine & Equip Behavior

Empty Magazine & Equip Behavior Keep the actual weapon equipped when the last round is fired. App...

Throwable Weapons

Throwable Weapons Consume inventory only after a projectile is actually thrown. Applies to: Nord...

Weapon Durability & Back Display

Weapon Durability & Back Display Lifecycle remains authoritative while back props remain cosmetic...

Vehicle Storage Overview

Vehicle Storage Overview Trunk/glovebox sessions with model/category capacity resolution. Applies...

Vehicle Registry & Capacity Resolution

Vehicle Registry & Capacity Resolution Category/model data, framework import and unlimited/custom...

Trunk & Glovebox Interaction

Trunk & Glovebox Interaction Access mode, distance checks and interior TAB behavior. Applies to: ...

Live Trunk Session Security

Live Trunk Session Security Why an already-open trunk closes when access becomes invalid. Applies...

Front Trunks / Frunks

Front Trunks / Frunks Front-compartment detection for vehicles whose storage is at the front. App...

Addon Vehicle Trunk Placement

Addon Vehicle Trunk Placement Placement assistance and model overrides for non-standard vehicles....

NPC Vehicle Trunk Loot

NPC Vehicle Trunk Loot Optional randomized loot for eligible NPC vehicle trunks. Applies to: Nor...

Vehicle Storage Exports

Vehicle Storage Exports Capacity queries for other vehicle/garage resources. Applies to: Nord In...

Database, Security & Operations

Overview · Database, Security & Operations

6 · Database, Security & Operations Persistence, security boundaries, diagnostics, backup/restore...

Database Schema Reference

Database Schema Reference Persistent tables installed by the current SQL schema. Applies to: Nor...

Database & Persistence

Database & Persistence Persistent item/storage state and safe restart behavior. Applies to: Nord...

Item Definition Precedence

Item Definition Precedence Deterministic reference/database/provider ownership rules. Applies to:...

Security & Server Authority

Security & Server Authority Trust boundaries for inventory, admin, robbery, links and integration...

Transaction History & Retention

Transaction History & Retention Item history and transaction-log retention defaults. Applies to: ...

Backups & Restore

Backups & Restore Operational backup flow and owner-only restore. Applies to: Nord Inventory v2....

Audit Log

Audit Log Administrative traceability for sensitive operations. Applies to: Nord Inventory v2.0....

Stability Notes

Stability Notes Runtime guardrails and patterns for production servers. Applies to: Nord Invento...

Troubleshooting Playbook

Troubleshooting Playbook Fast diagnosis by symptom. Applies to: Nord Inventory v2.0.0 Inventory ...

Error Reference & Diagnostics

Error Reference & Diagnostics Where to look before changing code. Applies to: Nord Inventory v2....

Upgrade to v2.0.0

Upgrade to v2.0.0 Replace the resource with the complete v2.0.0 build while keeping the resource ...

Performance & Production Tuning

Performance & Production Tuning Practical tuning without weakening authority. Applies to: Nord I...

Operations & Forensics Center — v2.0.0

Operations & Forensics Center — v2.0.0 Nord Inventory v2.0.0 includes an admin-only Operations Ce...

Transaction Ledger & Anti-Dupe

Transaction Ledger & Anti-Dupe Applies to: Nord Inventory v2.0.0 Ledger The Operations Ledger se...

Inventory Manager & Snapshots

Inventory Manager & Snapshots Applies to: Nord Inventory v2.0.0 Source of truth The v2.0.0 manag...

Persistent Placed Items & Movement Policies

Persistent Placed Items & Movement Policies Applies to: Nord Inventory v2.0.0 Persistent placed ...

Operations Configuration & Limits

Operations Configuration & Limits Applies to: Nord Inventory v2.0.0 config/operations.lua is sha...

Nord Ecosystem

Reference Files