Guide How to Add Weapons to Ox Inventory (2025)

[V.CaptainV.Captain is verified member.]

This tutorial shows you step-by-step how to properly add weapons into Ox Inventory on your QBCore server. Whether you’re migrating from qb-inventory or setting up fresh, this guide will cover everything you need so your weapons work seamlessly inside the new grid-based system.

What You’ll Learn:

• How to define weapons inside Ox Inventory’s item files.
• Correctly setting weight, stackable, and metadata.
• Adding durability, decay, and custom descriptions.
• Linking weapons with usable actions and categories.
• Troubleshooting common mistakes (wrong hashes, missing images, etc.).

Example Weapon Item (ox_inventory format):

['weapon_pistol'] = {
label = '9mm Pistol',
description = 'Standard sidearm, lightweight and reliable.',
weight = 2500,
stackable = false,
category = 'weapons',
image = 'weapon_pistol.png',
data = {
rarity = 'common',
quality = 100,
decay = 0.005
},
actions = { 'use', 'drop', 'inspect' }
},

Why Ox Inventory Weapons?

• Full metadata support (attachments, ammo, quality).
• Cleaner configuration compared to qb-inventory.
• Allows durability and item decay for realism.
• Easier management for large custom weapon packs.

Watch the Full Tutorial Here:

This link is hidden for visitors. Please log in or register to view it.

Useful References:

• This link is hidden for visitors. Please log in or register to view it.

Community Engagement:
Got stuck? Post your error or code snippet in the comments, and I’ll help debug. Share your custom weapon setups too—always cool to see how other servers build their armories.