FREE Admin Menu

A modern NUI admin menu for FiveM servers. It provides a searchable command panel, live player list, quick-action shortcuts, and built-in utility toggles (noclip, godmode, teleports, and more). Commands are driven by JSON configuration and executed through the server’s existing admin command set.

Dependencies

Resource	Required	Purpose
ox_lib	Yes	Callbacks, notifications, dialogs, vehicle properties, clipboard
oxmysql	Yes	Server script dependency
qb-core	No	Unlocks QBCore player data, jobs, gangs, items, and extra commands

Installation

1. Place ag-menu in your resources folder.
2. Ensure ox_lib and oxmysql start before this resource.
3. Add ensure ag-menu to your server.cfg.
4. Grant ACE permissions for the commands your staff should use (see Permissions).

The UI is pre-built under web/build/. To rebuild after editing the React source, run npm install and npm run build inside web/.

Opening the menu

Method	Details
Keybind	U (default) — Open Admin Menu
Command	/admin
Event	TriggerEvent("admin:toggleMenu", true) or false to close

Closing: use the NUI close callback or toggle the menu off with the same methods.

---

User interface

Layout

• Commands tab — all admin actions, grouped and searchable.
• Players tab — online players with expandable details and quick moderation buttons.
• Quick actions — icon sidebar (reload favorites, dev mode, copy coords, and more).

Commands tab

• Category filters: All, Player, Vehicle, Utility, User, Server.
• Search — filter commands by label.
• Favorites — star any command; order is saved locally via Resource KVP (favorites).
• Command types:
  • Button — single click runs the command.
  • Form — expandable panel with validated fields before execution.
• Toggle indicators — commands marked active: true show a green highlight while enabled (e.g. godmode, noclip).
• Auto-close — commands with close: true dismiss the menu after running (e.g. noclip).

Form field types

Forms support these argument types (configured in shared/commands.json):

Type	Description
input	Text field
number	Numeric input with min/max/step
select	Searchable dropdown (static options, optionsKey, or live getOptions)
multi-select	Multiple selection
checkbox	Boolean toggle
slider	Range slider
autocomplete	Typeahead from a fixed list

Select fields can chain options (e.g. pick a job → load grades via setOptions / NUI callback).

Players tab

When the menu opens, the client refreshes:

• Player list — server ID, display name, and (on QBCore) citizen ID.
• Headshots — live ped headshot textures in the list.
• Expanded info (QBCore only): full name, job + grade, gang + grade, cash and bank (formatted).
• Quick buttons per player: Revive, Kill, Kick, Ban (runs the corresponding server commands with that player’s ID).

Quick actions sidebar

Configured in shared/quickactions.json:

Action	Icon	Description
Reload commands	fa-sync-alt	Clears saved favorites (commands-r) after confirmation
Dev mode	fa-terminal	Toggles dev mode (dev); highlights when active; fires hud:client:toggleDev
Copy coords	fa-copy	Submenu: copy vector3 or vector4 to clipboard
Logout	fa-sign-out-alt	QBCore only — runs logout and closes the menu

Quick actions support button and menu (hover submenu) types.

---

Built-in commands

These are implemented in client/commands.lua (or registered on the server) and appear in the menu via shared/commands.json. Additional server commands (e.g. revive, car, fix, kick, ban) are executed with ExecuteCommand and must exist on your server.

Player

Command	Type	Description
Revive Self	Button	Runs revive (framework/admin resource)
Give Armour	Button	Sets ped armour to 100
Remove Stress	Button	QBCore — sets player stress metadata to 0
Relieve Needs	Button	QBCore — sets hunger and thirst to 100
Set PedModel	Form	Change ped model (self or target); 800+ models in pedmodels.json
Give Weapon	Form	Give weapon + ammo to self or target
Give Money	Form	QBCore — cash or bank to a target
Set Job	Form	QBCore — target, job, and grade (grades load dynamically)
Set Gang	Form	QBCore — target, gang, and grade
Give Item	Form	QBCore — target, item, and amount

Vehicle

Command	Type	Description
Spawn Vehicle	Form	Spawn from 3000+ vehicles in vehicles.json; extra buttons Mod and Delete (dv)
Set Engine Audio	Form	ForceVehicleEngineAudio using another vehicle model; Reset extra button
Repair Vehicle	Button	Runs fix (external command)
Teleport to Vehicle	—	tpv — warp into driver seat of current vehicle

Mod (mod) — max performance mods, turbo, xenon, custom wheels, tint, etc. via ox_lib vehicle properties.

Utility

Command	Type	Description
GodMode	Toggle	Player invincibility
NoClip	Toggle	Freecam flight; closes menu; see NoClip / Freecam
Cloak	Toggle	Makes ped invisible
Increased Run Speed	Toggle	1.49× run and swim multiplier
Unlimited Stamina	Toggle	Continuous stamina restore
Superjump	Toggle	Super jump every frame
Night Vision	Toggle	Night vision overlay
Thermal Vision	Toggle	Thermal/seethrough overlay
Teleport to Marker	Button	Runs tpm
Teleport to Coords	Form	tpc x y z — optional keep vehicle
Teleport to Location	Form	tpl from 80+ preset locations in teleports.json; optional keep vehicle
Set Timecycle Modifier	Form	700+ modifiers in timecycles.json with strength slider; Clear resets to default
Dev	Toggle	Toggles dev HUD via hud:client:toggleDev

User / server moderation

Command	Type	Description
Kick Player	Form	Target + reason
Kick All	Button	Runs kick with no args (server-wide)
Ban Player	Form	Target, reason, and ban length

Server-registered commands

Command	Description
pedmodel [model] [target?]	Change ped model (ACE: group.admin)
giveweapon [weapon] [ammo?] [target?]	Give weapon to ped (ACE: group.admin)

Client-only helpers (not all in default menu)

Command	Description
copycoords vec3 / vec4	Copy position (and heading for vec4) to clipboard
commands-r	Reset favorite commands (with ox_lib confirm dialog)
tpc	Teleport to raw coordinates
tpl	Teleport to named location from JSON
tpv	Warp into vehicle driver seat
timecycle	Apply or clear timecycle modifier
engineaudio	Change or reset vehicle engine sound

On resource stop, toggles (godmode, speed, visibility, vision, timecycle) are reset automatically.

---

NoClip / Freecam

NoClip uses an embedded freecam system (client/freecam/):

• Fly with WASD-style movement, mouse look (right-click when menu is open).
• Scroll — adjust speed; Shift — faster; Alt — slower.
• On-screen instructional buttons for controls.
• Ped (and vehicle if driving) position syncs with the camera.
• Gamepad control mappings supported alongside keyboard.

---

QBCore integration

When qb-core is running, the resource:

• Detects framework in init.lua and injects extra commands if they are not already in commands.json.
• Loads Jobs, Gangs, and Items option lists from shared/jobs.json, gangs.json, and items.json.
• Populates Targets and Players with citizen ID, character info, money, job, and gang.
• Registers NUI callbacks JobGrades and GangGrades for dynamic grade dropdowns.
• Adds a Logout quick action.

Without QBCore, targets and players still list server ID and name only.

---

Configuration

shared/commands.json

Define menu entries: label, command, type (button | form), filter, optional active, close, fav, args, and buttons (custom execute label and extra action buttons).

shared/quickactions.json

Sidebar shortcuts: command, icon (Font Awesome class), type (button | menu), optional items for submenus, active, close.

Data files (shared/*.json)

Loaded at runtime and exposed to the UI for selects and autocomplete:

File	Contents
vehicles.json	Vehicle spawn names (~3000)
weapons.json	Weapon hashes
pedmodels.json	Ped model names (~800)
teleports.json	Named locations with coords and inside / outside type
timecycles.json	Timecycle modifier names (~700)
weather.json	Weather types (loaded for custom commands; not used by default menu)
items.json	Inventory items (~225)
jobs.json	Job names
gangs.json	Gang names

Edit these JSON files to match your server without changing Lua or React code.

---

Permissions

• Menu command execution checks ACE: command (via ox_lib:checkPlayerAce).
• Individual registered commands use restricted ACE checks: command.<commandName>.
• Server commands pedmodel and giveweapon require group.admin.

Configure ACE principals in your server config so only staff can open and use the menu.

---

Events & exports

Name	Side	Description
admin:toggleMenu	Client	(boolean) open/close menu
admin:server:RemoveStress	Server	QBCore stress reset
admin:server:RelieveNeeds	Server	QBCore hunger/thirst reset
ag:setPedModel	Client	Apply ped model from server

Callbacks: ag:getTargets, ag:getPlayers, ag:GetPedheadshotTxdString.

---

Tech stack

• Client: Lua 5.4, ox_lib
• Server: Lua, oxmysql, QBCore (optional)
• UI: React 18, TypeScript, Vite, Mantine 7, react-hook-form, Jotai, Font Awesome

Web package version: 2.0.0 (web/package.json).