SMX logo

SMX Documentation

Production-grade Script Knowledge Base

Build 2026.04 Live Docs



Inventory

Scripts · FiveM Ready

Product Overview

smx-inventory is a framework-agnostic inventory core for FiveM with player inventory, trunk/glovebox/stash containers, world drops, weapon durability, attachments, ammo logic, backpacks and admin actions.

3Framework modes (auto/ESX/QB)
9Auto-managed DB tables
4Container types
NUIInventory core interface
Architecture: Event-first runtime with server-authoritative move/use logic, synchronized secondary containers, and automatic schema bootstrap via oxmysql.

Core Feature Set

Inventory Core

Open inventory via command/keymap, drag-and-drop movement, split stacks, give and drop flows.

Secondary Containers

Vehicle trunk, glovebox, dynamic stash, configured world storages and ground-drop containers.

Weapon Systems

Durability per shot, repair flow, weapon box pack/unpack, component attachment mapping and ammo system.

Admin + Integration

Admin give/remove/clear commands plus exports for opening stash/storage contexts from other resources.

Technical Notes

  • Framework resolution: auto, esx, esxold, qbcore
  • Dependency: oxmysql (hard dependency in fxmanifest.lua)
  • NUI entrypoint: html/index.html with script.js
  • Item image routing uses Config.ImagePath = nui://smx-inventory/...; folder rename breaks this path
  • Tables are auto-created on startup; sql/install.sql additionally provides item seed inserts