Tutorial / Settings

HUD & Hub

Set up the toolbox HUD, the header bar, look-at details and the F3 server hub, with text tokens and presets.

What it does

HUD & Hub controls what players see on screen and in the F3 server hub. The toolbox HUD replaces the game's health, armor and ammo with a card at the bottom left and ammo at the bottom right. You can add up to 3 custom values to the card, a header bar at the top of the screen, and details shown when you look at a player.

The server hub opens with F3 or !hub. It has up to 12 tabs, from the scoreboard to an Admin tab. You set its title, color, tabs, store, key list, help text and links here.

Texts use tokens such as {name} or {wallet}, filled in for each player. The settings are saved for every map. Presets save a whole setup by name and load it on any map.

Where to find it

Q menu > KGX's Admin Toolbox > Settings > HUD & Hub.

  • Only superadmins can change these settings. Others see the first options greyed out and "Only superadmins can change these settings."
  • Players open the hub with F3, !hub or kgxat_hub [tab].

The panel

General

These save as soon as you change them.

Option What it does Default
Toolbox HUD Off (the game's HUD), In RP mode or Always. Always
HUD card shows the live character model Shows your animated player model on the card. On
Looking at a player shows their details Shows the look-at lines above a player you aim at. On
F3 opens the server hub (also !hub) Turns the hub on or off. On
Hub has an Admin tab for toolbox admins Adds the Admin tab for toolbox admins. On
Version line at the bottom right (toolbox | server version | each player's game build) A small, faint line at the bottom right of every player's screen, e.g. "KGX's Admin Toolbox v3.6.12.1 | Server v1.4 | Game 2026.10.01 (x86-64)". The last part is that player's own Garry's Mod build and branch ("main" for the default branch), useful when something works for one player and not another. Each player can hide it in Settings > Display (themes). On
Server version shown in that line Your server's own version (letters, numbers, dots, dashes, up to 32 characters; a version starting with a number gets a "v"). Empty shows the server's Garry's Mod version. Press Apply. Empty
Hub

Everything from here down is saved with SAVE HUD & HUB.

Option What it does Default
Hub title Window title, up to 40 characters. Server Hub
Color mixer The hub's accent color. 70, 130, 200
Tab checkboxes Untick a tab to hide it. One per tab: Scoreboard, Players, Jobs, Server stats, Match stats, Loadouts (v3.6.15, not in RP: your loadout and a button for the loadout screen), Server store, Shipments, Mail, Key binds, Help & tips, Links, Admin. All on
name (under each tab) A new name for that tab, up to 24 characters. Empty keeps the default name. Empty
Server store (a store made with Economy > Store Maker) The store the Server store tab sells from. (the built-in Server Store: licenses and basics)
or the store's id Type a store id instead of picking one. Empty
Key binds (one per line: KEY = what it does): The Key binds tab. Up to 2000 characters. The default key list
Key binds: put the default list back (every player key) Fills in the default key list. -
Help & tips (a line starting with # is a section title): The Help & tips tab. Up to 8000 characters. A short getting-started text
Links (one per line: Title | https://...): Buttons on the Links tab. Up to 1500 characters. Two example links
HUD card: up to 3 custom values
Option What it does Default
Value 1 label to Value 3 label The label of each extra line, up to 24 characters. Tokens work. Empty
Value 1 to Value 3 The value of each extra line, up to 80 characters. Tokens work. Empty

A row with both label and value empty is not shown.

Header (top of the screen)
Option What it does Default
Show the header Shows a bar at the top of the screen. Off
Left, Middle, Right The three texts of the bar, up to 80 characters each. The RP preset
Header preset: RP Fills in {servername}, {job} | {wallet} and {time} - {players}/{maxplayers} online. -
Header preset: Scriptable ({x:header1..3} from Lua) Fills in {x:header1}, {x:header2} and {x:header3}. -
Look-at details
Option What it does Default
Everyone sees (one line each): Lines shown above a player you aim at. Up to 300 characters. {name} and {job} - {rank}
Admins also see: Extra lines for toolbox admins. Up to 300 characters. {health} HP {armor} armor and {steamid} played {playtime}
Save and presets
Option What it does
SAVE HUD & HUB Saves everything above and sends it to every player.
Open the hub Opens the hub so you can check it.
Preset list Right-click a preset: Load (replaces the current settings) or Delete. v3.6.15: the two [Built-in] presets come first and cannot be deleted.
Preset name Name for a new preset, up to 40 characters.
Save the saved settings as this preset Saves the settings as they are saved now, not unsaved edits.
Put everything back to default... Asks to confirm, then resets the HUD & Hub settings.
Built-in presets (v3.6.15)

For arena servers (Game Modes with a hub). Loading one also sets Toolbox HUD to Always.

Preset What it sets
[Built-in] PVP (arena) Title Arena, gold accent. Hides Jobs, Server store, Shipments and Mail. Card: Level {level}, Loadout {loadout}, Credits {credits}. Header on: {servername}, {match}, {next}. Key binds and Help for the hub, matches, loadouts and progress. Look-at: name, level and badge.
[Built-in] PVE (waves) Title Survival, green accent. The same tabs and header. Card: Points {matchmoney}, Level, Loadout. Help for survival matches with points.

Text tokens

Use these in the custom values, the header and the look-at lines. In look-at lines they describe the player you aim at.

Token Shows
{name} Player name.
{job} The player's job (RP: the job or Unemployed; DarkRP and other gamemodes: their team). v3.6.17: on arena servers (a hub, Next match on, or a match running) PVP player or PVE player (the match running or played last); Build / PvP servers: Builder or PvP; else Player. Never "Unassigned". The hub's scoreboard Job column shows the same.
{rank} User group.
{health} Health.
{maxhealth} Maximum health.
{armor} Armor.
{wallet} Wallet money. Only for yourself; "?" for others.
{bank} Bank money. Only for yourself; "?" for others.
{playtime} Time played.
{kills} Kills.
{deaths} Deaths.
{ping} Ping.
{steamid} SteamID.
{players} Human players online.
{maxplayers} Player slots.
{servername} Server name.
{map} Map name.
{time} Local time, HH:MM.
{date} Date, YYYY-MM-DD.
{mode} Server mode: Sandbox, Build / PvP or RP.
{level} v3.6.15: Match stats level (1 and up).
{loadout} v3.6.15: the loadout the player spawned with, or "-".
{matchmoney} v3.6.15: match money (buy menu, paid loadouts; points in survival modes).
{team} v3.6.15: the player's team in the match, or empty.
{match} v3.6.15: the match and its phase ("Team Deathmatch - Live"), or Hub / No match.
{next} v3.6.15: the next match and when (Game Modes > Next match).
{credits} v3.6.16: match credits (Settings > Armory).
{x:wave} v3.6.17: the wave of the Waves (PVE) match running, or "-".
{nw:Name} A networked value of the player (string, else number).
{gnw:Name} A global networked value (string, else number).
{x:Name} Text from Lua: hook.Add("KGXAT_HUDToken", ..., function(name, ply) return text end).

An unknown token is shown as typed.

How to use it

Add a header bar
  1. Open Settings > HUD & Hub and tick Show the header.
  2. Press Header preset: RP, or type your own Left, Middle and Right texts with tokens.
  3. Press SAVE HUD & HUB.
Customize the hub
  1. Change Hub title and pick an accent color.
  2. Untick tabs you do not use. Type a new name under a tab to rename it.
  3. Edit Help & tips with # lines as section titles, and Links as Title | https://....
  4. Press SAVE HUD & HUB, then Open the hub to check it.
Keep a setup for another map or event
  1. Save your settings with SAVE HUD & HUB.
  2. Type a Preset name and press Save the saved settings as this preset.
  3. Later, right-click the preset > Load (replaces the current settings).

Settings and commands

Setting or command What it does Default
kgxat_hud Server: 0 = off, 1 = in RP mode, 2 = always. 2
kgxat_hud_model Server: 1 = live character model on the card. 1
kgxat_look_details Server: 1 = look-at details. 1
kgxat_hub Server: 1 = F3 and !hub open the hub. 1
kgxat_hub_admin Server: 1 = Admin tab for toolbox admins. 1
kgxat_version_text Server: 1 = the version line at the bottom right. 1
kgxat_server_version Server: the server version in that line (empty = Garry's Mod version). Empty
kgxat_version_text_show Each player: 1 = show the version line. 1
kgxat_hud_enable Client: 0 hides the toolbox HUD for yourself. 1
kgxat_hub [tab] Opens the hub. Tabs: scoreboard, players, jobs, stats, store, keys, help, links, admin. -
!hub Chat: opens the hub. -
kgxat_hud_debug Prints why the toolbox HUD draws or not. -

Tips and limits

  • Settings are saved in garrysmod/data/kgx_admin_toolbox/hub.json, presets in hub_presets.json. At most 32 presets.
  • Some tabs also need their feature: Jobs needs toolbox jobs, Server store needs the economy, Mail needs mail on, and Shipments needs shipments and a seller.
  • The Key binds tab also lists each player's own toolbox keys from Settings > Keybinds.
  • Links only become buttons when they start with http:// or https://.
  • Look-at details show within 300 units. Cloaked players are hidden from non-admins.
  • Pressing F3 again closes the hub.

Back to Settings

Type to search every tool, panel, setting, FAQ answer and release.