Ammo in FiveM: game ammo pools and inventory ammo items

#Layer one: GTA V ammo pools

In weapons.meta, each weapon points at an ammo info with <AmmoInfo ref="AMMO_PISTOL" />. Weapons that point at the same ammo info share one pool of rounds in the base game — if you give 100 pistol rounds, the combat pistol has them too. Frameworks without an item-based inventory inherit this behaviour.

local ped = PlayerPedId()
SetPedAmmo(ped, `WEAPON_PISTOL`, 60)
print(GetAmmoInPedWeapon(ped, `WEAPON_PISTOL`))
print(GetPedAmmoTypeFromWeapon(ped, `WEAPON_PISTOL`)) -- the ammo type hash
AddAmmoToPed(ped, `WEAPON_PISTOL`, 12)

#Layer two: ox_inventory ammo items

ox_inventory makes ammunition physical: boxes of rounds are items with weight, and each weapon lists the item that reloads it. The weapon item carries its loaded rounds in metadata.ammo. These are the ammo items in ox_inventory’s default data, with the vanilla weapons that use each:

Give ammo like any item: exports.ox_inventory:AddItem(source, 'ammo-9', 48). The full weapon-by-weapon list, including each weapon’s ammo item, is in the weapon names and hashes list.

#QBCore and ESX

Which system you have depends on the inventory, not the framework name. See ESX items and loadout and QBCore shared weapons.

#Ammo for addon weapons

An addon weapon has an AmmoInfo in its weapons.meta, but the inventory also needs to know which item reloads it. In ox_inventory, add the weapon to data/weapons.lua with an ammoname:

['WEAPON_MYRIFLE'] = {
    label = 'My Rifle',
    weight = 3200,
    durability = 0.03,
    ammoname = 'ammo-rifle',
},

1. Pick the calibre that fits the real-world weapon, so players already own the ammo.
2. Match the AmmoInfo in weapons.meta to a similar vanilla weapon for consistent handling.
3. Restart ox_inventory (or the server) after editing data files.

A missing ammoname is the usual reason an addon gun equips but never reloads. ox_inventory weapons data covers every field.

#Troubleshooting