Installation & Usage

Setup

  • Add the taser cartridge item to ox_inventory:
ox_inventory/data/items.lua
["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

config.lua
return {
    reloadLength = 2,                           -- time to reload

    taserCartridgeItem = 'ammo-taser',          -- item name

    maxCartridges = 5                           -- max cartridges
}
OptionTypeWhat it does
reloadLengthnumberReload progress duration, in seconds
taserCartridgeItemstringInventory item consumed when reloading
maxCartridgesnumberCartridges a stun gun holds when full
Edit this page on GitHub

MIT 2026 © xT Development.

On this page