For the complete documentation index, see llms.txt. This page is also available as Markdown.

Items

rm_dualgun ships 39 weapon items and 10 ammo items. All three formats live in the [items] folder. Copy the one matching your inventory.


Where each file goes

Your inventory
File
Destination

ox_inventory

items - ox_inventory.lua

ox_inventory/data/items.lua

qb-inventory / qs / origen / ak47

items - qb shared.lua

qb-core/shared/items.lua

Database-backed inventories

items.sql

Run against your database


Weapon items

The item name and the cfg.weapons key are always identical. Adding a weapon to the config without adding the matching item means players can never obtain it.

ox_inventory format

['rm_appistol_dual'] = {
    label = 'Dual AP Pistol', weight = 2000, stack = false, consume = 0,
    client = { event = 'rm_dualgun:client:useItem' },
},

qb-core format

['rm_appistol_dual'] = {
    name = 'rm_appistol_dual', label = 'Dual AP Pistol', weight = 2000,
    type = 'item', image = 'rm_appistol_dual.png',
    unique = false, useable = true, shouldClose = true,
    description = 'Two AP Pistols, one in each hand',
},

Ammo items

Ten ammo items cover all weapon families:

Item
Reloads

dual_pistol_ammo

Pistols, revolvers, heavy pistols

dual_smg_ammo

SMGs, micro SMGs, machine pistols

dual_rifle_ammo

Assault rifles, carbines, bullpups

dual_shotgun_ammo

All shotguns

dual_stungun_ammo

Stun gun

dual_grenade_ammo

Grenade / compact launchers

dual_rocket_ammo

RPG, homing launcher, firework

dual_mg_ammo

MG

dual_minigun_ammo

Minigun

dual_railgun_ammo

Railgun

Which item reloads which weapon is set by the ammo field in cfg.weapons, so you can freely regroup them.

Ammo items are consumed, and only the rounds actually loaded are taken. See Ammo System.


Images

Every item needs an icon named after the item, in your inventory's image folder:

Missing images do not break anything; the slot just renders blank.


Combined weapon items

The six combined duals follow the same pattern, with heavier weights reflecting what they carry:

Item
Label
Weight

rm_microassault_dual

Micro SMG + Assault Rifle

4500

rm_desperado_dual

Desperado (Revolver + Sawed-Off)

4000

rm_chaos_dual

Chaos (RPG + Minigun)

18000

rm_breacher_dual

Breacher (SMG + Pump Shotgun)

5000

rm_pyro_dual

Pyro (Firework + Grenade Launcher)

6000

rm_akimbo_dual

Classic Akimbo (AP Pistol + Micro SMG)

3000


Adding your own

  1. Add the entry to cfg.weapons. See Weapons.

  2. Add an item with the same name to your inventory.

  3. Drop in an image.

  4. Restart both resources.

Item name, config key and image name must all match exactly. Almost every "my new dual gun does nothing" report comes down to a typo across these three.

Last updated