Inventory

Scripts · FiveM Ready

Overview Installation Configuration Exports & Events Usage / Examples Troubleshooting

Core Setup

Config.Framework = 'auto'   -- auto, esx, esxold, qbcore
Config.Language = 'en'

Config.OpenCommand = 'inventory'
Config.OpenKey = 'F2'
Config.TrunkCommand = 'inventorytrunk'
Config.TrunkKey = 'L'
Config.CloseKey = 322

Config.AdminGroups = { 'admin', 'god', 'superadmin' }

Use auto for framework detection unless your environment needs a fixed bridge mode.

Limits, Distances and Visuals

Config.DefaultSlots = 20
Config.DefaultWeight = 500

Config.DropWeight = 500
Config.DropSlots = 20

Config.NearbyDistance = 3.0
Config.GroundDropDistance = 3.0
Config.GroundInteractDistance = 1.6
Config.VehicleDistance = 5.0
Config.TrunkDistance = 2.8

Config.Marker = { ... }
Config.StorageMarker = { ... }

These values define carry limits, container capacities and all world interaction thresholds.

Secondary Containers and Storages

Config.Secondary = {
    glovebox = { slots = 12, maxWeight = 150 },
    trunk = { slots = 28, maxWeight = 1200 },
    stash = { slots = 40, maxWeight = 1500 }
}

Config.Storages = {
    {
        id = 'public_storage_1',
        label = 'PUBLIC STORAGE',
        coords = vec3(-48.4, -1757.9, 29.42),
        access = 'public',
        slots = 40,
        maxWeight = 2000
    }
}

Use Config.Storages for static world storage points with public or job-based access control.

Weapon, Ammo and Backpack Systems

Config.Backpacks = {
    black_backpack = { label = 'BLACK BACKPACK', slots = 20, maxWeight = 900 }
}

Config.WeaponBoxes = { enabled = true, ... }
Config.WeaponAttachments = { enabled = true, ... }
Config.WeaponDurability = { defaultShotLoss = 0.25, repairItem = 'weapon_repairkit', ... }
Config.AmmoSystem = { enabled = true, universalItem = 'ammo_universal', ... }

Weapon systems are fully item-driven. Keep item names in sync with your framework inventory definitions.

Image and Text Localization

Config.ImagePath = 'nui://smx-inventory/html/assets/items/'
Config.FallbackImage = 'nui://smx-inventory/html/assets/item.svg'

Config.Text.en = { ... }
Config.Text.de = Config.Text.en

All UI labels and notify messages are sourced from Config.Text. Add a custom language table and set Config.Language.