The three tables in ox_inventory’s weapons.lua

#The Weapons table

['WEAPON_APPISTOL'] = {
    label = 'AP Pistol',
    weight = 1400,
    durability = 0.1,
    ammoname = 'ammo-9',
},

['WEAPON_SWITCHBLADE'] = {
    label = 'Switchblade',
    weight = 300,
    durability = 0.1,
    anim = { 'anim@melee@switchblade@holster', 'unholster', 200, 'anim@melee@switchblade@holster', 'holster', 600 },
},

['WEAPON_TEARGAS'] = {
    label = 'Tear Gas',
    weight = 600,
    throwable = true,
},

#The Components table

['at_suppressor_light'] = {
    label = 'Suppressor',
    weight = 280,
    type = 'muzzle',
    client = {
        image = 'at_suppressor.png',
        component = {
            `COMPONENT_AT_PI_SUPP`,
            `COMPONENT_AT_PI_SUPP_02`,
            `COMPONENT_CERAMICPISTOL_SUPP`,
            `COMPONENT_PISTOLXM3_SUPP`,
        },
        usetime = 2500,
    },
},

When a player uses the item on a weapon, ox_inventory picks the first hash in the list that fits that weapon. To make a vanilla attachment work on an add-on weapon, add the add-on’s component hash to the right list. Attachment details: ox_inventory attachments.

#The Ammo table

['ammo-9'] = {
    label = '9mm',
    weight = 7,
},

Which weapon uses which ammo item is listed in ammo types and items.

#Adding an add-on weapon

1. Stream the weapon resource and make sure it spawns with GiveWeaponToPed.
2. Add a Weapons entry with the exact WEAPON_ name, label, weight, durability and ammoname.
3. Add its component hashes to existing attachment items (or new Components entries).
4. Put WEAPON_NAME.png — the exact, uppercase item name, like ox_inventory’s own images — in ox_inventory/web/images/.
5. Restart the server (data files are loaded at start).

Weapons from our studio export with a ready ox_inventory snippet and item image — see ox_inventory weapon setup.

#Common mistakes