esx_weaponshop

esx_weaponshop is the official weapon store for ESX Legacy. It adds Ammu-Nation locations and a hidden black market dealer, opens a NUI catalog, and lets players buy weapons, a weapon license, ammo, attachments and tints. All purchases are validated and charged on the server.

OverviewCopy Anchor Link

In-game flow:

• Legal shops (Legal = true, default GunShop) charge cash. With Config.LicenseEnable, players without the weapon license get a menu to buy it for Config.LicensePrice first.
• Illegal shops (Legal = false, default BlackWeashop) charge black_money, never need a license and have their blip disabled by default.
• Players can buy ammo, components and tints for a weapon they own and that the zone sells (when Config.WeaponShopUpgrades.Enabled is on).

InstallationCopy Anchor Link

INSERT IGNORE INTO `licenses` (`type`, `label`) VALUES ('weapon', "Weapon licence");

ensure oxmysql
ensure esx_lib
ensure es_extended
ensure esx_license
ensure esx_weaponshop

ConfigurationCopy Anchor Link

Main config (shared/config/main.lua)Copy Anchor Link

Shop zones (shared/config/shops.lua)Copy Anchor Link

Config.Zones = {
    GunShop = {
        Legal = true,
        Blip = { Enabled = true, Sprite = 110, Color = 81, Display = 4, Scale = 0.7, ShortRange = true },
        Items = {
            { name = 'WEAPON_PISTOL', price = 500 },
            { name = 'WEAPON_BAT', price = 50 },
        },
        Locations = {
            vector3(-662.1, -935.3, 20.8),
        },
    },
}

Upgrades (shared/config/upgrades.lua)Copy Anchor Link

Developer APICopy Anchor Link

The resource has no exports. Its server callbacks are used by the NUI:

The server also sends esx_weaponshop:requestWeaponAmmoState to the client and accepts the answer through the net event esx_weaponshop:receiveWeaponAmmoState (only from the same player, matched by request id).

To check the weapon license from your own scripts, use esx_license:

TriggerEvent('esx_license:checkLicense', playerId, 'weapon', function(hasLicense)
    if not hasLicense then
        TriggerClientEvent('esx:showNotification', playerId, 'You need a weapon license.')
    end
end)

Common issuesCopy Anchor Link

• Resource does not start. esx_license is a hard dependency and OneSync must be on.
• License menu never appears. Config.LicenseEnable is false, or the zone has Legal = false.
• Purchase fails silently. The player is too far from a Locations entry, is spamming (cooldown), lacks cash / black money, or cannot carry the weapon.
• Upgrades unavailable. Config.WeaponShopUpgrades.Enabled is off, or Config.OxInventory is true and ox_inventory is not started. The player must own the weapon.
• Changed prices in weashops have no effect. Edit Config.Zones instead.

RelatedCopy Anchor Link

• esx_license
• esx_shops
• Weapons config
• ox_inventory with ESX

Frequently asked questions