Weapon durability in FiveM

#How ox_inventory durability works

When ox_inventory creates a weapon item it sets metadata.durability to 100 if the weapon defines a durability value. As the weapon is fired, durability falls by that value per shot. The weapon item displays its condition in the inventory, and at zero the inventory will not let the player use it.

['WEAPON_PISTOL'] = {
    label = 'Pistol',
    weight = 1130,
    durability = 0.1,
    ammoname = 'ammo-9',
},
['WEAPON_ASSAULTRIFLE'] = {
    label = 'Assault Rifle',
    weight = 4500,
    durability = 0.03,
    ammoname = 'ammo-rifle2',
},

#Tuning: how many shots should a gun last?

Think in magazines: at 0.1 a 12-round pistol lasts about 80 magazines. On a serious roleplay server where shootouts are rare, that is effectively forever; on a gang-heavy server it is a few busy evenings. Adjust per weapon rather than globally, so a rare rifle does not wear as fast as a street pistol.

#Repair kits and gunsmiths

Repair means setting metadata.durability back up on the server. A repair-kit item can do it for the weapon in the player’s hands:

RegisterNetEvent('gunsmith:repairCurrent', function(slot)
    local src = source
    local weapon = exports.ox_inventory:GetSlot(src, slot)
    if not weapon or not weapon.name:find('^WEAPON_') then return end

    -- consume one repair kit first
    if not exports.ox_inventory:RemoveItem(src, 'weapon_repairkit', 1) then return end

    weapon.metadata.durability = 100
    exports.ox_inventory:SetMetadata(src, slot, weapon.metadata)
end)

• Validate on the server: the slot must hold a weapon and the kit must actually be removed.
• Consider partial repairs (+40) so kits are a resource, not a reset button.
• A gunsmith job that repairs for money creates a real roleplay role.

Metadata editing in general is covered in ox_inventory metadata.

#Durability on QBCore

qb-weapons tracks weapon quality in the item’s info and lowers it as the weapon is used, with a repair location configured in its config. The idea is the same; the field names and config differ, so check your qb-weapons version.