Installation

Three steps: add the item to your inventory, drop in the image, start the resource. The database table is created for you.

1. Dependencies

Any one of ox_target, qb-target or qtarget will do — whichever you already run is detected on start.

2. server.cfg — ensure order

Start bupa-weaponbag after all of them.

ensure ox_lib
ensure oxmysql
ensure ox_target
ensure bupa-weaponbag

3. Register the bag item

Copy the block for your inventory out of the matching file in install/inv/:

For ox_inventory, two lines in that entry matter:

['weaponbag'] = {
    label = 'Weapon Bag',
    weight = 2500,
    stack = false,
    close = true,
    consume = 0,
    description = 'A tactical bag that carries weapons in shaped pockets.',
    client = { image = 'weaponbag.png' },
    server = { export = 'bupa-weaponbag.useBag' },
},

• server.export — ox_inventory has no CreateUseableItem, so this export is how the bag learns it was used.
• consume = 0 — without it, ox_inventory eats the item the moment it is used and the bag vanishes even if the player cancels the placement. The resource removes the item itself, but only once the bag has actually been put down.

On QBox, QB-Core and ESX the resource registers the usable item itself through the core, so useable = true on the item is all that is needed.

4. Item image

Copy install/img/weaponbag.png into your inventory's image folder:

The weapon pictures shown inside the bag come from that same folder, so there is nothing else to install or generate. If you run a renamed fork and they come up blank, point the script at the right place:

Config.UI.ImagePath = 'nui://my-inventory/html/images/'

5. Overrides, if you need them

Config.Inventory = 'auto'   -- 'ox_inventory' | 'qb-inventory' | 'qs-inventory'
                            -- 'codem-inventory' | 'tgiann-inventory' | 'esx'
Config.Target    = 'auto'   -- 'ox_target' | 'qb-target' | 'qtarget'

6. Language

setr ox:locale "tr"

See Localization for the shipped languages.