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
- Find their SteamID, for example in Admin Notes, Reports or the player's history.
- Open Utilities > Bans and paste it into the SteamID box.
- Set Minutes (0 = permanent) and type a Reason.
- Press Ban this SteamID and confirm with Ban.
Lift a ban
- Open Utilities > Bans.
- Right-click the ban and pick Unban (name).
- 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 asSTEAM_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_immunityis 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.