Tutorial / Basics
C Menu and the ATB Window
Hold C for the ATB window of quick admin functions, and right-click anything in the C menu for the toolbox's ATB options.
What it does
The toolbox adds two things to the C menu (the context menu you get by holding C). The first is the ATB icon, which opens a window of quick functions. The second is an ATB entry when you right-click a player or entity.
Admins get the full window: buttons for themselves, the server and the players. Non-admins get a smaller version with their own shortcuts, such as jobs, backpack and third person.
The right-click ATB submenu is for admins. It lists what the toolbox can do to the thing you clicked, so you do not need to switch tools.
Where to find it
Hold C and click the ATB icon on the C menu desktop. The console command kgxat_atb opens the same window without the C menu.
Who can use it:
- The admin window and the right-click ATB options need toolbox admin rights and
kgxat_cmenu 1(the default). - Players without admin rights get the player version of the window.
- Settings > Tool Visibility can hide the window or the right-click options for some or all players.
The ATB window
The window title is ATB - quick admin functions for admins and ATB for players. You can resize it. It remembers the last tab you used.
Me (admins)
| Button | What it does |
|---|---|
| Incognito (play as a normal player) | Asks for a name and model, then you play as a normal player until you leave incognito |
| Leave incognito | Gives your rank and name back (shown only while incognito) |
| God mode on / off | Toggles god mode on yourself |
| Noclip on / off | Toggles noclip on yourself |
| Cloak on / off | Toggles invisibility on yourself |
| Full health and armor | Sets your health and armor to full |
| Respawn where I stand | Respawns you at your current spot, facing the same way |
| Give me the physgun, tool gun and camera | Gives you any of the three you are missing |
| Third person on / off | Same as kgxat_thirdperson |
| Admin vision on / off | Same as kgxat_vision_toggle |
| Stop spectating | Shown only while you spectate |
| Open the hub (F3) | Opens the server hub |
| Treasury (v3.6.21.3) | Opens the server treasury window; shown while the economy and the treasury are on |
| Phone Book (v3.6.21.3) | Opens the phone book; shown while it is on |
| Mail (v3.6.21.3) | Opens your mail; shown while mail is on |
| Match: pick your class / Match: buy menu | Shown only in a Game Modes match that has class picking or a buy menu |
Server (admins)
| Button | What it does | Asks first |
|---|---|---|
| Clean up the map | Removes everything spawned and resets the map | Yes |
| Remove every player's props | Props players spawned; permanent and saved things stay | Yes |
| Freeze every prop / Unfreeze every prop | Freezes or unfreezes all props | No |
| Remove NPCs | Removes the NPCs | Yes |
| Remove corpses and gibs | Clears corpses and gibs | No |
| Clear decals (blood, bullet holes, sprays) | Clears decals for everyone | No |
| Stop every sound | Stops all sounds | No |
| Respawn the dead | Respawns dead players | No |
| Revive the dead where they died (v3.6.21.3) | Brings dead players back where they died, with their weapons and ammo | No |
| Freeze every player / Unfreeze every player | Freezes or unfreezes every player except you | Freeze: yes |
| Bring everyone to me | Teleports every player to you | Yes |
| Scan everything (perma, saved, doors...) | Runs kgxat_scanall (superadmins) |
No |
| Cheats on / off (sv_cheats) | Switches sv_cheats; shown to superadmins only |
Yes |
The buttons that match Server Tools actions (clean up, freeze, NPCs, corpses, sounds, respawn, players, bring) also need Server Tools access. Without it you get "Server Tools are not allowed for you."
Players (admins)
A list with the columns Player, Rank and Status. Status shows dead, frozen, jailed, cloaked or AFK.
Right-click or double-click a player for everything the Player Manager does. Click Refresh at the bottom to update the list.
Me (players)
| Button | What it does |
|---|---|
| Leave incognito | Shown only to an admin who is incognito |
| Third person on / off | Toggles third person |
| My look (citizen model and colors) | Opens the citizen look window (kgxat_look) |
| Jobs | Opens the jobs menu (kgxat_jobs) |
| Backpack | Opens your backpack (kgxat_backpack_open) |
| Stop the music | Stops music started by logic (kgxat_stopmusic) |
| Open the hub (F3) | Opens the server hub |
| Treasury | Shown to jobs with the Treasury ability (a Mayor) while the treasury is on |
| Phone Book / Mail | Shown while each is on |
| Match: pick your class / Match: buy menu | Shown only in a match that has them |
Each of these buttons can be hidden from players, or shown only to some ranks, jobs or license holders, in Settings > Tool Visibility (the entries "ATB button: ..."). Admins always see every button and the window itself, also while incognito (v3.6.21.3).
Settings
This window and the right-click menu (only you): these options are saved on your computer.
| Option | What it does | Default |
|---|---|---|
| Right-click things in the C menu for ATB options (admins) | kgxat_cmenu_props |
on |
| Right-click ATB menu: also 'Open its tool' (admins) | kgxat_cmenu_tool |
on |
| Ask before risky things (clean up, remove for good, bring everyone...) (admins) | kgxat_cmenu_confirm |
on |
| Close this window after a button | kgxat_cmenu_close |
off |
| Open on the tab | kgxat_cmenu_tab: Me, Server, Players or Settings (players: Me or Settings) |
Me |
| Third person: also while sitting | kgxat_tp_seats |
on |
HUD shortcuts (only you) (v3.6.21.3): see below.
| Option | What it does | Default |
|---|---|---|
| Show my HUD shortcuts | kgxat_atb_hud |
on |
| Mode | kgxat_atb_hud_mode: Use (a click runs it) or Move (drag them, right-click to remove) |
Use |
| Shown | kgxat_atb_hud_show: Always or Only while I hold C |
Always |
| Show their names | kgxat_atb_hud_names; off: only icons |
on |
| Size | kgxat_atb_hud_size, 24-64 |
32 |
| Remove all my HUD shortcuts | Asks first |
Server (superadmins change these): admins see this section, and only superadmins can change it.
| Option | Setting |
|---|---|
| Admins get the ATB window and right-click options | kgxat_cmenu |
| Block the spawn menu for players | kgxat_block_spawnmenu |
| Block the C menu for players | kgxat_block_contextmenu |
| Admins can pick up players with the physgun | kgxat_physgun_players |
| Spawn protection | kgxat_spawn_protect |
| Every player can use third person | kgxat_thirdperson_all |
| Players see the ATB spawn menu tab | kgxat_atb_menu_players |
| Chat commands (!look, !jobs...) | kgxat_chat_commands |
| Prop protection | kgxat_pp |
| Tell admins about every admin action | kgxat_notify_admins |
Everything else is in Q menu > KGX's Admin Toolbox > Settings.
HUD shortcuts (v3.6.21.3)
Put any ATB button on your screen as a shortcut:
- Hold C and open the ATB window.
- Drag a button out of the window and let go where you want it. (Or right-click the button > Add to my HUD.)
- The shortcut stays on your screen. Hold C to click it; it runs the same as the button (risky ones still ask first).
Each button can be on your HUD once: dropping it again moves it. Without C held the shortcuts are only drawn; while you hold C they are buttons you can click, drag (Move mode) and right-click.
Right-click a shortcut for Run it, Move mode / Use mode, Remove this shortcut and Remove all my shortcuts. In Move mode, drag shortcuts around; they have a yellow border. Up to 24 shortcuts, saved on your computer (data/kgx_admin_toolbox/atb_hud.json) for every server. A shortcut you cannot use right now (an admin button after you stop being admin, a button hidden from you) is hidden until you can, and greyed out while you hold C. Console: kgxat_atb_hud_toggle switches the mode, kgxat_atb_hud_clear removes them all.
Right-click > ATB
A Treasury Node also offers Open the treasury (v3.6.21.3).
Hold C, right-click a player or entity, and open ATB. The submenu starts with the name of what you clicked.
On a player you get the same list as the Player Manager's right-click menu. It runs from Go to and Bring, through the toggles, Money, Backpack and warnings, to Slay..., Kick..., Ban... and Copy SteamID.
On yourself, Kick..., Ban..., Go to, Bring, Spectate and Warn... are left out. The spawn menu block and blind are offered only to switch them off.
On an entity:
| Option | What it does |
|---|---|
| Freeze / Unfreeze | Freezes or unfreezes it |
| Go to it | Teleports you next to it |
| Bring it in front of me | Moves it in front of you |
| Make permanent / Not permanent any more | Shown depending on its current state |
| Unbreakable on / off | Toggles unbreakable |
| Access (server owned, ranks / jobs)... | Opens its Access window (doors, keypads, buttons, chairs, cameras, permanent entities) |
| Set on fire / Put out | Ignites it for 10 seconds, or extinguishes it |
| Full health | NPCs and nextbots only |
| Inspect (live info) | Starts the Inspector's live info |
| Remove | Removes it; toolbox things are refused |
| Remove for good (toolbox things with their saved data, permanent and map things) | Removes it and its saved data; asks first |
| Open its tool | Switches your tool gun to the toolbox tool for it |
| Owner: plus the owner's name | The Player Manager list for its owner |
| Copy model / Copy class | Copies to your clipboard |
How to use it
Clean up the map from the C menu
- Hold C and click the ATB icon.
- Open the Server tab.
- Click Clean up the map and answer Yes.
Remove a toolbox entity for good
- Hold C and right-click the store, container or other toolbox thing.
- Open ATB and pick Remove for good (toolbox things with their saved data, permanent and map things).
- Answer Yes. Its saved data is deleted too.
Make the window open on the Players tab
- Open the ATB window and go to Settings.
- Set Open on the tab to Players.
- Tick Close this window after a button if you want it out of the way after each click.
Settings and commands
| Setting or command | What it does | Default |
|---|---|---|
kgxat_cmenu |
Server: 1 = admins get the ATB window and the ATB right-click options | 1 |
kgxat_atb |
Console: opens the ATB window outside the C menu | - |
The client options (kgxat_cmenu_props, kgxat_cmenu_tool, kgxat_cmenu_confirm, kgxat_cmenu_close, kgxat_cmenu_tab) are in the window's Settings tab above.
Tips and limits
- Remove refuses toolbox things such as stores and containers: use Remove for good. Permanent and map things removed with Remove come back after the next cleanup or restart.
- Open its tool needs a tool gun. Without one you get "You have no tool gun."
- Every action from the window and the submenu is logged and shown like any other toolbox action.
- An incognito admin sees the player window, but can still use Leave incognito there.
- With
kgxat_block_contextmenu 1, players whose spawn menu is blocked also lose the C menu. Jailed players always lose it. - Hold C also lets you click toolbox windows that stay on screen, such as the Inspector's live info.