Admin work without memorising commands

A new staff member should not need a cheat sheet. This free panel, built on React and Mantine 7, puts every admin action in one searchable list. Commands are defined in JSON, favorites are saved to KVP, and more tools unlock when QBCore is running.

Opening it

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

The three parts of the screen

Commands tab. Every action, grouped and searchable, with filters for Player, Vehicle, Utility, User and Server.

Players tab. Online players with headshots, expandable information and quick moderation buttons.

Quick actions sidebar. Reload favorites, dev mode, copy coords and logout.

Two kinds of command

• Buttons run with one click.
• Forms open a validated panel first. Field types include input, number, select, multi select, checkbox, slider and autocomplete.

Toggles such as godmode and noclip turn green while active. Commands marked close: true close the menu after running.

Player commands

• Revive self, give armour, remove stress, relieve needs
• Set a ped model from 800+ options
• Give weapons with an ammo count
• With QBCore: give cash or bank money, set job and grade, set gang and grade, give items

Vehicle tools

• Spawn from 3000+ vehicles, with Mod and Delete extras
• Mod applies max performance mods, turbo, xenon, custom wheels and tint through ox_lib vehicle properties
• Force the engine audio of another model, or reset it
• Repair, and tpv to warp into the driver seat

Utility toggles

• GodMode, NoClip and Cloak
• Increased run speed (1.49x run and swim), unlimited stamina and superjump
• Night vision and thermal vision
• Teleport to a marker, to raw coords or to one of 80+ preset locations
• A timecycle modifier from 700+ options with a strength slider and a Clear reset

When the resource stops, toggles such as godmode, speed, visibility, vision and timecycle reset automatically.

Freecam

Move with WASD and look with the mouse. Scroll changes speed, Shift is faster and Alt is slower. The ped, and the vehicle if you are driving, follows the camera. Gamepads are supported, with on screen button prompts.

Moderation

Each player has quick buttons for Revive, Kill, Kick and Ban. The commands tab also has Kick Player with a reason, Kick All and Ban Player with a reason and a length.

With QBCore running

• The framework is detected in init.lua and extra commands are injected if they are missing from commands.json.
• Jobs, gangs and items load from jobs.json, gangs.json and items.json.
• The players tab shows citizen ID, full name, job and grade, gang and grade, cash and bank.
• NUI callbacks JobGrades and GangGrades fill the grade dropdowns.
• A Logout quick action is added.

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

Configuration files

You can fit the panel to 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: about 3000 vehicle spawn names
• shared/pedmodels.json: about 800 ped models
• shared/timecycles.json: about 700 modifiers
• shared/teleports.json: 80+ named locations with coords and an inside or outside type
• shared/items.json: about 225 inventory items
• shared/weapons.json, weather.json, jobs.json, gangs.json

The UI is pre built under web/build/. If you edit the React source, rebuild with npm install and npm run build inside web/.

Permissions

Menu command execution checks ACE through ox_lib:checkPlayerAce. Individual registered commands use restricted ACE checks in the form command.<commandName>. The server commands pedmodel and giveweapon require group.admin. Set up ACE principals so that only staff can open and use the menu.

Dependencies

• ox_lib, required: callbacks, notifications, dialogs, vehicle properties and clipboard
• oxmysql, required: server script dependency
• qb-core, optional: unlocks player data, jobs, gangs, items and extra commands

Installation

1. Place ag-menu in your resources folder.
2. Make sure ox_lib and oxmysql start before it.
3. Add ensure ag-menu to server.cfg.
4. Grant ACE permissions for the commands your staff should use.

Events and callbacks

• admin:toggleMenu, client: open or close the menu with a boolean
• admin:server:RemoveStress, server: QBCore stress reset
• admin:server:RelieveNeeds, server: QBCore hunger and thirst reset
• ag:setPedModel, client: apply a ped model from the 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.