# Adding a custom weapon to a Qbox server

> 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.

Source: https://fam-tools.com/guides/qbox-weapon-setup · FAM Tools · published 2026-10-25 · updated 2026-10-25 · about 5 min

**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.

## 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*

```lua
['WEAPON_YOURITEM'] = {
    label = 'Your Weapon',
    weight = 1000,
    durability = 0.03,
    ammoname = 'ammo-9',
},
```

> **Worth knowing** — If you are migrating from QBCore, the item entries you already wrote for shared/items.lua are not used here. The weapons.lua entry replaces them.

## 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

## 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.

## Related

- https://fam-tools.com/guides/ox-inventory-weapon-setup
- https://fam-tools.com/guides/qbcore-weapon-setup
- https://fam-tools.com/guides/weapon-not-showing-in-inventory