STG ScriptsDocumentation
Weapon Shop

Installation

Install STG Weapon Shop on your FiveM server in five steps, with item notes for ox_inventory, qb-inventory and the default ESX inventory.

Weapon Shop

STG Weapon Shop

ESXQBCoreQBOX
View in store

Download the script

Sign in to the Cfx.re portal with the account you used at checkout and download stg-weaponshop from Granted Assets.

Move the resource

Extract the zip and place the stg-weaponshop folder inside the [STG] category folder in your resources directory.

resources/
└── [STG]/
    └── stg-weaponshop/

Install the dependencies

Weapon Shop needs ox_lib. Skip this step if your server already runs it. If you turn on target interaction, also run ox_target or qb-target.

Check the items

The store hands out the item named by each name in Config.Categories: weapon_* for weapons and ammo-9, ammo-rifle and ammo-shotgun for the ammo boxes. These names match ox_inventory.

Nothing to add. ox_inventory already ships every weapon and ammo item the store sells.

The weapon_* items already exist in qb-core/shared/items.lua. Ammo uses other names in QBCore: pistol_ammo, rifle_ammo and shotgun_ammo.

Change the three ammo name values in the ammo category of stg-weaponshop/config.lua to your item names, and rename the matching images in stg-weaponshop/html/public/weapons/ so the store still shows them.

The default ESX inventory has no weapon items. Set Config.weaponWithItem = false in stg-weaponshop/config.lua so bought weapons go to the weapon wheel.

Ammo boxes are always given as items. Add ammo-9, ammo-rifle and ammo-shotgun to your items table, or change their name values to ammo items your server already has and rename the matching images in stg-weaponshop/html/public/weapons/.

Start the script

Make sure [STG] starts after your framework and ox_lib in server.cfg:

ensure ox_lib
# your framework: es_extended, qb-core or qbx_core
ensure [STG]

Then restart the whole server.

Nothing happens or the console shows an error? See Common Errors.

Next steps

Still having trouble?

Open a ticket on our Discord. Our team answers around 15 hours a day.

Get help on Discord

On this page