FiveM Admin Menu & Permissions — Quasar Framework (qs-core) | Quasar Store

FiveM Admin Menu & Permissions — Quasar Framework (qs-core) | Quasar Store | Quasar Store

add_principal group.admin group.user
add_ace group.admin command allow        # every command, including command.qs and command.adminkeys
add_ace group.admin command.quit deny    # but not quit

# qs-core manages groups at runtime (/setgroup) - keep these four lines
add_ace resource.qs-core command.add_ace allow
add_ace resource.qs-core command.remove_ace allow
add_ace resource.qs-core command.add_principal allow
add_ace resource.qs-core command.remove_principal allow

What	Permission checked
qs-core admin commands (`/car`, `/revive`, `/ban`…)	`command.qs` on the player
Admin menu on F6 (`qs-admin`)	`Config.Permission` in `qs-admin/config.lua`, default `command.qs`
`/setgroup`, `/removegroup`	`command.qs`, or the server console
`/clothing` (`qs-clothing`)	`command.qs`
`/adminkeys` (`qs-corevehiclekeys`)	`command.adminkeys`
ESX and QBCore permission checks	See Permission checks for scripts below

When you deploy with the Quasar Framework recipe, txAdmin writes your admin identifiers into server.cfg as members of group.admin. Nothing to do: log in and press F6.

Add a line per admin, with their FiveM or license identifier, and restart the server:

bash

add_principal identifier.fivem:1234567 group.admin
add_principal identifier.license:abcdef0123456789 group.admin

From the server console, or in game as an admin, with the player's server id:

bash

setgroup 12 admin

The group is saved in the database and applied every time the player connects, on every character. No restart needed.

Command	Arguments	What it does
`/setgroup`	`<id> <group>`	Saves the group for the player's license in the `player_groups` table and adds them to `group.<group>` right away. Their previous group is removed first, so a demotion takes effect immediately. The player sees "You have been set to group: …".
`/removegroup`	`<id>`	Deletes the saved group and removes them from it right away. The player sees "Your admin group has been removed."

Check	Result
Server console, or no permission asked	Allowed
`'user'`	Always allowed
Any `perm`	Allowed if the player has the ACE `perm`, `qbcore.<perm>` or `group.<perm>`
`'admin'`, `'god'` or `'mod'`	Also allowed for anyone in `group.admin` or with the `command` ACE
A list `{ 'admin', 'mod' }`	Allowed if any entry passes

Action	Fields	What it does
Goto	—	Teleports you to the player, facing the same way. The menu closes.
Bring	—	Teleports the player to you.
Spectate	—	Moves you next to the player, makes you invisible, invincible and frozen, and puts you in spectator mode on them. Backspace or Esc stops; it also stops if the player leaves. You stay where spectating started. The menu closes.
Freeze / Unfreeze	—	Locks or releases the player in place. They see "You have been frozen" / "You have been unfrozen".
Heal	—	Full health and 100 armour, and clears blood.
Revive	—	Gets a downed player back up.
Kill	—	Puts the player in the downed state.
Kick	Reason	Drops the player with the message "Kicked:" followed by the reason, or "Kicked by an admin" without one.
Ban	Reason, minutes	Bans and drops the player. 0 minutes = permanent. See Bans below.
Set Job	Job name, grade	Sets the player's job and grade.
Set Group	Group list	Runs `/setgroup` with the chosen group: `user`, `mod`, `admin`, `superadmin` (`Config.Groups`).
Money	Account, amount	Add or Remove money on `cash`, `bank` or `black_money`.
Give Item	Item name, count	Gives the item through the inventory (count 1 if empty).
Give Weapon	`WEAPON_…`, ammo	Gives a native GTA weapon with that ammo (250 if empty). It is not an inventory item and is not saved; to give a weapon the player keeps, use Give Item with its item name, such as `weapon_pistol`.

Action	What it does
Noclip	Closes the menu and toggles noclip. See Noclip below.
Godmode	Toggles invincibility for yourself (ON / OFF).
Invisible	Toggles your character's visibility (ON / OFF).
TP to Waypoint	Closes the menu and teleports you to your map waypoint, with your vehicle if you are driving.
Fix Vehicle	Fully repairs the vehicle you are in.
Delete Vehicle	Deletes the vehicle you are in, or the closest one within 6 m.
Clear Area	Removes vehicles and objects within 30 m of you.
Spawn Vehicle	Spawns the model you type, after clearing the vehicles in the way, puts you in the driver seat and gives you the keys. See Vehicles.

Action	What it does
Announcement	Shows your message as a banner on every player's screen for 8 seconds.
Weather	One button per preset in `Config.Weathers`: `CLEAR`, `EXTRASUNNY`, `CLOUDS`, `OVERCAST`, `RAIN`, `THUNDER`, `CLEARING`, `FOGGY`, `SMOG`, `SNOW`, `BLIZZARD`, `XMAS`. Blends over 5 seconds.
Time	Sets the clock to the hour and minute you type (12:00 if empty).
Online	Number of players with a loaded character.

Option	Default	What it does
`Config.Permission`	`'command.qs'`	ACE needed to open the menu and run its actions.
`Config.OpenKey`	`'F6'`	Default key of the `/admin` mapping.
`Config.Webhook`	`''`	Discord webhook for action logs (`''` = off).
`Config.Groups`	`{ 'user', 'mod', 'admin', 'superadmin' }`	Groups offered by Set Group.
`Config.Weathers`	12 presets	Buttons in the Weather section.

Command	Arguments	What it does
`/setjob`	`<id> <job> [grade]`	Sets a player's job; grade defaults to 0.
`/addmoney`	`<id> <account> <amount>`	Adds money to `cash`, `bank` or `black_money`.
`/removemoney`	`<id> <account> <amount>`	Removes money from an account.
`/giveitem`	`<id> <item> [count]`	Gives an item; count defaults to 1.
`/revive`	`[id]`	Revives a player, or yourself.
`/kill`	`[id]`	Sets a player's (or your) health to 0, which puts them in the downed state.
`/freeze`	`<id>`	Freezes or unfreezes a player (toggle).
`/god`	—	Toggles god mode on yourself.
`/announce`	`<message>`	Sends a notification to every player for 8 seconds.
`/car`	`<model>`	Spawns a vehicle, puts you in it and gives you the keys.
`/dv`	—	Deletes the vehicle you are in, or the closest one within 5 m.
`/coords`	—	Shows your position as `vec4(x, y, z, heading)` on screen and in F8 — handy for configs.
`/tp`	`<x> <y> <z>`	Teleports you to coordinates.
`/goto`	`<id>`	Teleports you to a player.
`/bring`	`<id>`	Teleports a player to you.
`/tpm`	—	Teleports you (and your vehicle) to your map waypoint, finding the ground.
`/noclip`	—	Toggles noclip.
`/kick`	`<id> [reason]`	Drops a player (default reason "Kicked by an admin.").
`/ban`	`<id> [minutes] [reason]`	Bans a player; `0` or no minutes = permanent.
`/unban`	`<license>`	Lifts every ban on a `license:` identifier.
`/setgroup`	`<id> <group>`	Saves and applies a permission group.
`/removegroup`	`<id>`	Removes the saved group.

Command	Resource	Permission	What it does
`/admin` (F6)	`qs-admin`	`command.qs`	Opens the admin menu.
`/adminkeys [id]`	`qs-corevehiclekeys`	`command.adminkeys`	Gives the keys of the vehicle you are in to you or a player.
`/clothing`	`qs-clothing`	`command.qs`	Opens the clothing editor on yourself.

Option	Logs
`Config.Webhooks.admin`	`/setjob`, `/addmoney`, `/removemoney`, `/kick`, and every ban made with `/ban` or by scripts.
`Config.Webhooks.money`	`/givemoney` between players.

Key	Action
W / S / A / D	Move forward, back, left, right (forward follows where you look).
Q / E	Up / down.
Mouse	Look around.
Mouse wheel	Speed up / down (0.5 to 20).
Mouse wheel click	Reset speed to 1.
Left Shift / Left Alt / Left Ctrl (hold)	2× / 4× / 0.25× speed.

bash

/ban 12 0 Cheating          # permanent
/ban 12 1440 Toxic in OOC   # 24 hours

Always write the minutes before the reason. Anything that is not a number in that position counts as 0 (permanent), and the reason then starts at the next word.

F6 → Players, select the player, fill Reason and Minutes (0 = permanent) and press Ban.

Minutes	Ban	Expires column
`0`	Permanent	`NULL`
Any positive number	Temporary	Now + minutes

Column	Content
`id`	Ban number.
`license`	`license:` identifier of the banned player.
`name`	FiveM name at the time of the ban.
`reason`	Reason.
`banned_by`	Admin's character name (menu), the admin's server id (`/ban`, `0` for the console), `Anti Cheat`, or the name a script passes.
`expires`	End of the ban, `NULL` for permanent.
`created`	When the ban was made.

Find the license

List the latest bans in your database:

sql

SELECT id, license, name, reason, expires FROM bans ORDER BY id DESC LIMIT 20;

Run /unban
From the server console or in game, with the full identifier including license::
bash
```
unban license:abcdef0123456789
```
Every ban row for that license is deleted and the player can join straight away.

Option	Default	What it does
`Config.EnableBans`	`true`	Checks bans when players connect. With `false`, nobody is rejected (the `/ban` command still records the ban and kicks the player).

IsPlayerBanned / AddBan / RemoveBan / ExploitBan (server exports)

lua

local banned, reason = exports['qs-core']:IsPlayerBanned(source)      -- or a 'license:...' string
exports['qs-core']:AddBan(targetSource, 60, 'Exploiting', 'MyScript')  -- minutes, reason, banned_by
exports['qs-core']:RemoveBan('license:abcdef0123456789')
exports['qs-core']:ExploitBan(targetSource, 'money exploit')         -- permanent, banned_by = Anti Cheat

AddBan and ExploitBan drop the player and log to Config.Webhooks.admin. QBCore scripts reach the same functions through QBCore.Functions.IsPlayerBanned and the qb-core ExploitBan export.

txAdmin	With Quasar Framework
Admins	The recipe adds your txAdmin admin identifiers to `group.admin`, so you have every Quasar Framework admin command and the F6 menu from the first login.
Heal (one player)	Also revives: a downed player gets back up.
Heal all	Revives every player with a loaded character.
Kick, warn, ban	Work as usual. txAdmin bans are stored by txAdmin, separately from the `bans` table: lift them in txAdmin, not with `/unban`.
In-game menu	Keeps working alongside the F6 menu. Vehicles spawned from txAdmin's menu come without keys: use `/adminkeys` while sitting in them, or spawn with `/car` or F6, which give keys.

Administration

Administration

Permissions: how admin rights work#

Making someone an admin#

Groups: /setgroup and /removegroup#

Permission checks for scripts#

Admin menu on F6 (qs-admin)#

Players tab#

Self tab#

Server tab#

Admin menu logs#

Admin menu configuration#

Admin commands#

Command logs#

Noclip#

Bans#

Banning a player#

Temporary and permanent bans#

What a banned player sees#

The bans table#

Unbanning a player#

Find the license

Run /unban

Ban settings#

txAdmin integration#

Theme and colour tools#

Troubleshooting#