Tutorial / Admin panels > Utilities

Bans

See every ban made with the toolbox, unban players, and ban any SteamID, including players who are offline.

What it does

Bans lists every ban made with the toolbox, from Player Manager, chat commands, the warning ladder or this panel. You can lift a ban, or ban a SteamID directly, even when that player is offline.

Toolbox bans are saved in data/kgx_admin_toolbox/bans.json and checked when a player connects. Temporary bans therefore survive server restarts too. Expired bans are removed automatically.

Where to find it

Q menu > KGX's Admin Toolbox > Utilities > Bans.

Banning from the Player Manager or with !ban also needs this tick. Bans made here are written to the player's history, online or not. Toolbox admins can use it. Players can get it through Settings > Player Access with the Bans (view, add, unban) tick.

The panel

Ban list
Item What it does
Ban list Columns Name, SteamID, Until and Reason, newest first. Until shows a date and time, or permanent.
Select a ban The line below shows the name, SteamID, who banned them, when, and the reason.
Right-click > Unban (name) Asks to confirm, then lifts the ban.
Right-click > Copy SteamID Copies the SteamID.
Ban by SteamID
Option What it does Default Range
SteamID box The SteamID to ban, like STEAM_0:1:12345678. Empty
Minutes (0 = permanent) Ban length. 60 0-43200
Reason Shown to the player when they try to join. Up to 120 characters. "Banned by an admin" when empty
Ban this SteamID Asks to confirm, then bans. A player who is online is kicked.
Refresh Reloads the list.

How to use it

Ban someone who already left
  1. Find their SteamID, for example in Admin Notes, Reports or the player's history.
  2. Open Utilities > Bans and paste it into the SteamID box.
  3. Set Minutes (0 = permanent) and type a Reason.
  4. Press Ban this SteamID and confirm with Ban.
Lift a ban
  1. Open Utilities > Bans.
  2. Right-click the ban and pick Unban (name).
  3. Confirm with Unban. The player can join again right away.

Settings and commands

Command Who What it does
kgxat_unban <SteamID> Server console or superadmins Lifts a ban. Use it if someone, even the owner, was banned by mistake.
!ban <name> <minutes> [reason] Player Manager users, in chat, while kgxat_chat_commands is on Bans an online player. 0 minutes = permanent.

Tips and limits

  • A SteamID typed as STEAM_1:... is saved as STEAM_0:..., the form the join check uses.
  • A ban made by a superadmin can only be lifted by a superadmin.
  • Rank immunity also applies to offline bans. A SteamID last seen as a superadmin can only be banned by a superadmin. One last seen as an admin can only be banned by a superadmin while kgxat_immunity is on.
  • Bans are also sent to the engine ban list. Permanent ones are written to it.
  • The banned player sees "You are banned permanently" or "until (date)", plus the reason.
  • Bans and unbans are written to the Action Log.

Back to Admin panels

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