Installation & Usage

Setup

• Add the taser cartridge item to ox_inventory:

["ammo-taser"] = {
    label = "Taser Cartridge",
    weight = 100,
    stack = true,
    close = false
},

• Copy ammo-taser.png from the resource into ox_inventory/web/images.

Usage

• Equip the base game stun gun (WEAPON_STUNGUN) — the cartridge UI appears in the bottom right.
• Each shot consumes one cartridge and is saved to the weapon’s item metadata.
• At zero cartridges the stun gun will not fire and a [R] - Reload Taser Cartridges prompt appears.
• Press R to reload, consuming ammo-taser items from your inventory.

Configuration

return {
    reloadLength = 2,                           -- time to reload
 
    taserCartridgeItem = 'ammo-taser',          -- item name
 
    maxCartridges = 5                           -- max cartridges
}