FAM Tools
Sign in
Inventorybeginner5 min readupdated 25 Oct 2026

Adding a custom weapon to a Qbox server

The short answer

Qbox uses ox_inventory for items, so a weapon set up for ox works unchanged. The differences that do exist, and exactly where they are.

Qbox came out of QBCore but took ox_inventory with it, which makes weapon setup closer to an ox server than to a classic QBCore one. That trips people up in both directions.

Adding a custom weapon to a Qbox server — illustrated with a FiveM-compatible minimap render

#Items go through ox_inventory

There is no shared/items.lua to edit. The weapon is declared in ox_inventory's data/weapons.lua exactly as it would be on any ox server, and the image goes in web/images named after the item in lowercase.

ox_inventory/data/weapons.lua
['WEAPON_YOURITEM'] = {
    label = 'Your Weapon',
    weight = 1000,
    durability = 0.03,
    ammoname = 'ammo-9',
},

#The resource half is unchanged

Streaming the model, declaring the metadata in the manifest and getting the load order right work the same on Qbox as anywhere else. A weapon pack that works on an ESX server works here; only the item registration differs.

  1. Drop the resource into resources and ensure it in server.cfg, before ox_inventory
  2. Paste the weapons.lua entry into ox_inventory
  3. Copy the PNG into ox_inventory/web/images, lowercase
  4. Restart ox_inventory as well as the weapon resource
Share this guideXRedditFacebook

Questions

Do QBCore weapon packs work on Qbox?
The resource does. The item entries do not — rewrite them as an ox_inventory weapons.lua entry.
Do I need to restart the whole server?
No, but restart ox_inventory as well as the weapon resource. It reads its images folder at start.
Is the ammo item named the same as on QBCore?
No. ox_inventory uses its own ammo item names, such as ammo-9. Point the weapon at one that already exists on your server.

Ready to pick a map?

Twelve themes on three base map styles, $8 each, instant download.

Relevant to what you just read

The tool for this

Twenty theme pairs for ox_lib and ox_inventory From $15, built in the browser, exported as a drop-in resource.