Inventory Items

This section includes the complete item list for the script, ready to be integrated into the most popular inventory systems. Each item is properly configured with its name, label, and parameters to ensure full compatibility and seamless functionality within your server’s inventory setup.

qs-inventory

This guide explains how to add a new throwable weapon to qs-inventory, using a fictional example called Newspaper (weapon_acidpackage).

1️⃣ Register The Item

File: shared/items.lua

['weapon_acidpackage'] = {
    ['name'] = 'weapon_acidpackage',
    ['label'] = 'Newspaper',
    ['weight'] = 1000,
    ['type'] = 'weapon',
    ['ammotype'] = nil,
    ['image'] = 'weapon_acidpackage.png',
    ['unique'] = true,
    ['useable'] = false,
    ['description'] = 'A printed or digital publication with news and articles'
}

2️⃣ Define The Weapon

File: shared/weapons.lua

[`weapon_acidpackage`] = {
    name = 'weapon_acidpackage',
    label = 'Newspaper',
    weapontype = 'Throwable',
    ammotype = nil,
    damagereason = 'Died'
}

3️⃣ Add To Throwable Config List

File: config.lua

Config.Throwables = {
    'ball',
    'bzgas',
    'flare',
    'grenade',
    'molotov',
    'pipebomb',
    'proxmine',
    'smokegrenade',
    'snowball',
    'stickybomb',
    'acidpackage' -- << Add this line
}

4️⃣ Set Durability Multiplier

File: config.lua

Config.DurabilityMultiplier = {
    weapon_acidpackage = 0.15
}

5️⃣ Update Weapon Use Handler

File: client/custom/misc/UseWeapon.lua Add the new weapon to the throwable check:

elseif weaponName == 'weapon_stickybomb' or weaponName == 'weapon_pipebomb' or weaponName == 'weapon_smokegrenade' or weaponName == 'weapon_flare' or weaponName == 'weapon_proxmine' or weaponName == 'weapon_ball' or weaponName == 'weapon_molotov' or weaponName == 'weapon_grenade' or weaponName == 'weapon_bzgas' or weaponName == 'weapon_acidpackage' then

Ensures the system recognizes it as a throwable weapon.

6️⃣ Add The Item Icon

Place the image file in:

html/images/items/weapon_acidpackage.png

This will make the icon appear correctly in the inventory UI.

qb-inventory

This guide explains how to add a new throwable weapon to QBCore, using a fictional example called Newspaper (weapon_acidpackage).

1️⃣ Register The Item

File: qb-core/shared/items.lua

["weapon_acidpackage"] = { name = "weapon_acidpackage", label = "Newspaper", weight = 1000, type = "weapon", image = "weapon_acidpackage.png", unique = true, useable = false, shouldClose = true, description = "A printed or digital publication with news and articles" },

Make sure the image name matches the item name and is placed inside your inventory image directory (e.g. html/images/items/weapon_acidpackage.png).

2️⃣ Register The Weapon

File: qb-core/shared/weapons.lua

["weapon_acidpackage"] = {
    name = "weapon_acidpackage",
    label = "Newspaper",
    weapontype = "Throwable",
    ammotype = nil,
    damagereason = "Died"
}

Defines the weapon’s type and ensures it behaves as a throwable in combat.

3️⃣ Enable Weapon HUD Display

File: qb-hud/config.lua

["weapon_acidpackage"] = true

Ensures the weapon appears on the HUD when equipped.

4️⃣ Mark It As Throwable

File: qb-weapons/config.lua

Config.Throwables = {
    "ball",
    "bzgas",
    "flare",
    "grenade",
    "molotov",
    "pipebomb",
    "proxmine",
    "smokegrenade",
    "snowball",
    "stickybomb",
    "acidpackage" -- << Add this line
}

This tells QBCore to treat acidpackage as a throwable weapon (without the weapon_ prefix).

5️⃣ Add The Item Icon

Place the image file here:

html/images/items/weapon_acidpackage.png

This ensures the Newspaper icon is displayed correctly in the inventory UI.

ox_inventory

This guide explains how to register a new throwable item in ox_inventory, using a custom weapon example called WEAPON_ACIDPACKAGE.

1️⃣ Register The Item

File: usually found in data/items.lua or your custom items definition file.

['WEAPON_ACIDPACKAGE'] = {
    label = 'Newspaper',
    weight = 0,
    throwable = true,
}

You can modify the weight value if needed — setting it to 0 makes the item weightless in the inventory.

2️⃣ Add Icon To Inventory UI

Place your icon in the appropriate image folder (commonly web/images/ or html/images/) and name it exactly:

WEAPON_ACIDPACKAGE.png

The filename must match the item name exactly, including capitalization.

PreviousConfiguration NextTrucker Job