Overview

Free NUI admin menu built on React and Mantine 7. Commands live in JSON, favorites save to KVP, and the panel unlocks extra tools when QBCore is running.

Opening the menu

• Keybind: U by default
• Command: /admin
• Event: TriggerEvent("admin:toggleMenu", true)

Interface

• Commands tab: every admin action, grouped and searchable, with category filters for Player, Vehicle, Utility, User and Server.
• Players tab: online players with headshots, expandable info, and quick moderation buttons.
• Quick actions sidebar: reload favorites, dev mode, copy coords, logout.

Commands come in two shapes. Buttons run in one click. Forms open a validated panel before executing, with field types for input, number, select, multi-select, checkbox, slider, and autocomplete. Toggle commands like godmode and noclip highlight green while active. Commands marked close: true dismiss the menu after running.

Built-in player commands

• Revive self, give armour, remove stress, relieve needs
• Set ped model from 800+ options in pedmodels.json
• Give weapons with ammo count
• QBCore only: give cash or bank, set job and grade, set gang and grade, give items

Vehicle tools

• Spawn from 3000+ vehicles in vehicles.json, with Mod and Delete extras
• Mod: max performance mods, turbo, xenon, custom wheels, tint via ox_lib vehicle properties
• Force engine audio using another model, or reset
• Repair, and tpv warps you into the driver seat

Utility toggles

• GodMode, NoClip, Cloak
• Increased Run Speed (1.49x run and swim), Unlimited Stamina, Superjump
• Night Vision and Thermal Vision overlays
• Teleport to marker, raw coords, or one of 80+ preset locations in teleports.json
• Timecycle modifier from 700+ options with a strength slider, plus a Clear reset

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

NoClip freecam

WASD movement with mouse look. Scroll adjusts speed, Shift is faster, Alt is slower. Ped position (and vehicle if driving) syncs with the camera. Gamepad mappings supported alongside keyboard, with on-screen instructional buttons for controls.

Moderation

Per-player quick buttons for Revive, Kill, Kick and Ban run the matching server commands with that player's ID. The commands tab also carries Kick Player (target and reason), Kick All (server-wide), and Ban Player (target, reason, ban length).

QBCore integration

When qb-core is running, the resource:

• Detects the framework in init.lua and injects extra commands if they are not already in commands.json
• Loads jobs, gangs, and items from jobs.json, gangs.json, and items.json
• Populates targets and the players tab with citizen ID, full name, job and grade, gang and grade, cash and bank
• Registers NUI callbacks JobGrades and GangGrades for dynamic grade dropdowns
• Adds a Logout quick action

Without QBCore, the players list still shows server ID and name.

Configuration

Edit these files to fit your server without touching Lua or React:

• shared/commands.json: menu entries with label, command, type, filter, favorites, args, and custom buttons
• shared/quickactions.json: sidebar shortcuts with Font Awesome icons and hover submenus
• shared/vehicles.json: ~3000 vehicle spawn names
• shared/pedmodels.json: ~800 ped models
• shared/timecycles.json: ~700 modifiers
• shared/teleports.json: 80+ named locations with coords and inside/outside type
• shared/items.json: ~225 inventory items
• shared/weapons.json, weather.json, jobs.json, gangs.json

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

Permissions

Menu command execution checks ACE via ox_lib:checkPlayerAce. Individual registered commands use restricted ACE checks (command.<commandName>). Server commands pedmodel and giveweapon require group.admin. Configure ACE principals so only staff can open and use the menu.

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 server.cfg.
4. Grant ACE permissions for the commands your staff should use.

Events and exports

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