FREE Admin Menu

A free NUI admin menu that layers a clean, searchable interface over the moderation you already run. Every menu entry is defined in JSON and executes through your server's existing admin command set, so the menu upgrades how staff work without replacing your commands or your permission setup. Staff get a searchable command list, a live player list with ped headshots, quick action shortcuts, and toggles for noclip, godmode, and teleports.

qb-core is optional. Without it, the player list still shows server ID and name. With it, the menu unlocks citizen IDs, jobs, gangs, items, money readouts, and extra commands.

Opening the menu

| Method | Details |
| --- | --- |
| Keybind | U (default) opens the menu |
| Command | /admin |
| Event | TriggerEvent("admin:toggleMenu", true), or false to close |

Interface

• Commands tab: every admin action, grouped and searchable.
• Players tab: online players with expandable details and quick moderation buttons.
• Quick actions: an icon sidebar for 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.
• Command types: Button runs on a single click; Form opens an expandable panel with validated fields before execution.
• Toggle indicators: commands marked active: true show a green highlight while enabled, for example godmode and noclip.
• Auto-close: commands with close: true dismiss the menu after running, for example noclip.

Form field types

Forms are configured in shared/commands.json and support:

| 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: pick a job, then its grades load through setOptions and an NUI callback.

Players tab

When the menu opens, the client refreshes the list with server ID, display name, and live ped headshot textures. On QBCore it also shows citizen ID, full name, job and grade, gang and grade, and formatted cash and bank. Each player row has quick buttons for Revive, Kill, Kick, and Ban that run the matching server command with that player's ID.

Quick actions sidebar

Configured in shared/quickactions.json:

| Action | Description |
| --- | --- |
| Reload commands | Clears saved favorites after confirmation |
| Dev mode | Toggles dev mode and fires hud:client:toggleDev |
| Copy coords | Submenu to copy vector3 or vector4 to clipboard |
| Logout | QBCore only: runs logout and closes the menu |

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

Built-in commands

Entries live in shared/commands.json and run through client/commands.lua or the server. Extra server commands such as revive, car, fix, kick, and ban are executed with ExecuteCommand and must exist on your server.

Player

| Command | Type | Description |
| --- | --- | --- |
| Revive Self | Button | Runs revive |
| Give Armour | Button | Sets ped armour to 100 |
| Remove Stress | Button | QBCore: sets stress metadata to 0 |
| Relieve Needs | Button | QBCore: sets hunger and thirst to 100 |
| Set PedModel | Form | Change ped model on self or target; 800+ models in pedmodels.json |
| Give Weapon | Form | Give weapon and 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 Mod and Delete buttons |
| Set Engine Audio | Form | ForceVehicleEngineAudio using another model; Reset button included |
| Repair Vehicle | Button | Runs fix |
| Teleport to Vehicle | Button | Warps into the driver seat of your current vehicle |

Mod applies max performance parts, turbo, xenon, custom wheels, tint, and more via ox_lib vehicle properties.

Utility

| Command | Type | Description |
| --- | --- | --- |
| GodMode | Toggle | Player invincibility |
| NoClip | Toggle | Freecam flight; closes the menu |
| Cloak | Toggle | Makes the 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 | 80+ preset locations in teleports.json, optional keep vehicle |
| Set Timecycle Modifier | Form | 700+ modifiers in timecycles.json with a strength slider and Clear button |
| Dev | Toggle | Toggles the dev HUD via hud:client:toggleDev |

On resource stop, toggles for godmode, speed, visibility, vision, and timecycle reset automatically.

User and server moderation

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

Two server-registered commands, pedmodel and giveweapon, require ACE group.admin.

NoClip and freecam

NoClip uses an embedded freecam system under client/freecam/:

• WASD-style movement with mouse look (right-click while the menu is open).
• Scroll adjusts speed; Shift is faster, Alt is slower.
• On-screen instructional buttons for the controls.
• Ped position, and vehicle if you are driving, syncs with the camera.
• Gamepad mappings work alongside keyboard.

QBCore integration

When qb-core is running, the resource:

• Detects the framework in init.lua and injects extra commands that 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.

Configuration

Everything is JSON, so you can match the menu to your server without touching Lua or React:

• shared/commands.json: menu entries with label, command, type, filter, and optional active, close, fav, args, and buttons.
• shared/quickactions.json: sidebar shortcuts with command, Font Awesome icon, type, and optional submenu items.

Data files loaded at runtime 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 |
| items.json | Inventory items (~225) |
| jobs.json | Job names |
| gangs.json | Gang names |

Permissions

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

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

Events and exports

| Name | Side | Description |
| --- | --- | --- |
| admin:toggleMenu | Client | (boolean) open or close the 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.

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.

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

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