GFX FiveM Gun Menu - Weapon Loadout System for Law Enforcement

Give your police and military departments a professional weapon management system that handles everything from pistols to assault rifles. This customizable gun menu lets authorized players quickly equip loadouts, manage armor, and access specialized weapons through an intuitive interface that works via command, NPC interaction, or both.

What's Included

This script provides a complete weapon arsenal interface with five weapon categories (Equipment, Pistols, Mid-Tier, Rifles, Grenades) plus customizable pricing, stock amounts, and timed purchasing. The system includes an example NPC setup at an Ammu-Nation location, but you can add unlimited weapon dealer locations across your map.

Key Features

• Multi-Framework Support - Works with ESX (old and new), QBCore (old and new) via simple config switch
• Flexible Access Methods - Enable command (/weaponmenu), NPC interaction, or both simultaneously
• Timed Purchases - Add a realistic delay to weapon purchases (configurable, set to 0 to disable)
• Auto-Refund System - When buying a new weapon in the same slot, get 50% of your old weapon's value back (configurable percentage)
• Item or Weapon Mode - Choose whether weapons go directly to player loadout or as inventory items
• Complete Weapon Categories - Pre-configured with 22 weapons across 5 categories, from stun guns to sniper rifles
• Armor Management - Includes half kevlar (50 armor) and full kevlar (100 armor) options
• Custom Pricing - Set individual prices for each weapon and equipment item

Perfect For

• Police departments needing quick loadout access
• Military/SWAT roleplay with tiered weapon systems
• Prison servers where guards need weapon access points
• Gang servers with territory-based weapon dealers
• Event servers requiring rapid team equipment

Technical Details

• Framework: ESX (legacy & modern) / QBCore (old & new) - set via Config.Framework
• Default Command: /weaponmenu (can be disabled)
• NPC Model: s_m_m_ammucountry (customizable)
• Default Location: Ammu-Nation at vector4(-659.804, -936.421, 21.829, 134.34)
• File Size: Lightweight config-based script
• Performance: Minimal impact, menu only loads when accessed

Installation

1. Set your framework type in config.lua (esx/newesx/qb/newqb)
2. Decide whether to use weapons as items (Config.UseWithItem = true/false)
3. Configure buy time delay if you want realistic purchase timing
4. Set refund percentage for weapon exchanges (default 50%)
5. Add or remove weapon dealer NPC locations as needed
6. Customize weapon prices and stock amounts per your economy
7. Restart server and test access via command or NPC

Framework Compatibility

• ✅ ESX - Full support for both legacy (1.9.x) and modern ESX versions
• ✅ QBCore - Compatible with both old QBCore and new QB-Core structures
• ✅ QBOX - Should work as QBOX is QB-based (test Config.Framework = newqb)
• ⚠️ Standalone - Requires framework for weapon/item handling

What Makes It Stand Out

Most weapon menus are framework-locked or require extensive modifications to work with different inventories. This one handles four framework variations out of the box and gives you the choice between direct weapon spawning or item-based distribution. That flexibility means you can adapt it to job-restricted weapons, paid armories, or free police arsenals without rewriting code.

The refund system is particularly smart for law enforcement roleplay - officers can swap between patrol pistols and tactical rifles without wasting money on duplicate purchases. The timed buying feature prevents instant weapon access during active situations, adding realism to equipment procurement.

Weapon Categories Breakdown

Equipment: Half Kevlar (50 armor), Full Kevlar (100 armor), Stun Gun - essential non-lethal gear for police work.

Pistols: Standard Pistol, Combat Pistol, Heavy Pistol, AP Pistol, Desert Eagle - sidearms for various threat levels.

Mid-Tier: Pump Shotgun, Assault Shotgun, Micro SMG, SMG, Combat PDW - close-quarters and patrol weapons.

Rifles: Sniper Rifle, Marksman Rifle, Assault Rifle, Bullpup Rifle, Carbine Rifle - high-threat response weapons.

Grenades: Grenade, Molotov, Smoke Grenade, Flare - tactical equipment for special operations.

Customization Tips

All prices in the default config are set to 0 (free), making this ideal for job-restricted police arsenals. For civilian gun shops, just update the price values to match your server economy. You can restrict access by wrapping the command or NPC interaction in job checks using your framework's native functions.

The NPC system uses coordinates, so you can easily create multiple weapon dealers - one for police station armories, another for gang hideouts, maybe a black market dealer in the desert. Each can have different weapon selections by duplicating the config structure.

Pro Tip: Set Config.UseWithItem = true if you're using advanced inventory systems like ox_inventory or qb-inventory that handle weapon items. Set it to false if you want weapons to go directly to player loadout slots.

Related FiveM Weapon Mods

• Weapon Delivery
• Core Crafting
• Real Weapon Recoil
• Rewards System