Tutorial / Settings

Warning Ladder

Automatic punishments (gag, mute, jail, kick or ban) when a player reaches a set number of warnings.

What it does

The Warning Ladder punishes players automatically as their warnings add up. Each step says what happens at a warning count: gag, mute, jail, kick or ban, for a number of minutes.

A step runs once, at the moment the player reaches that count. Warnings come from Player Manager > Warn... and the !warn chat command. The ladder is saved on the server and used on every map.

Where to find it

Q menu > KGX's Admin Toolbox > Settings > Warning Ladder.

  • Toolbox admins can see the ladder.
  • Only superadmins can change it. Others see "Only superadmins can change the ladder." and the buttons are greyed out.

The panel

The list shows the current steps.

Column What it shows
Warnings The warning count that triggers the step.
Then The punishment.
Minutes How long it lasts. "-" means 0.
Option What it does Default
At this many warnings The warning count for the new step. Range 1-30. 3
Do this Gag (chat), Mute (voice), Jail, Kick or Ban. Gag (chat)
For minutes (0 = until removed / permanent) How long the gag, mute, jail or ban lasts. Range 0-10080. 30
Add / replace this step Saves the step. A step with the same count is replaced. -
Remove the selected step Removes the step selected in the list. -

The punishments

Punishment What happens Minutes 0
Gag (chat) The player cannot use chat. Until removed
Mute (voice) The player cannot use voice chat. Until removed
Jail The player is jailed. A dead player is respawned first. Until removed
Kick The player is kicked 3 seconds later. Minutes are not used. -
Ban The ban is recorded and the player is kicked 3 seconds later. Permanent

The kick or ban message reads "Too many warnings (count). Last: (reason)".

How to use it

Build a ladder
  1. As a superadmin, open Settings > Warning Ladder.
  2. Set At this many warnings to 2, pick Gag (chat) and set the minutes to 10. Press Add / replace this step.
  3. Add 3 = Jail for 5 minutes.
  4. Add 4 = Kick.
  5. Add 5 = Ban for 1440 minutes.
Change or remove a step
  1. To change a step, add a new one with the same warning count. It replaces the old one.
  2. To remove one, select it in the list and press Remove the selected step.
Test it
  1. Add 2 = gag 1 minute and 3 = jail 1 minute.
  2. Warn a bot three times. It is gagged at the second warning and jailed at the third.

Settings and commands

Setting or command What it does Default
kgxat_warn_kick Kicks a player at this many warnings, separate from the ladder. Range 0-50 (0 = off). Set in Settings > Server Settings (Kick at warnings (0 = off)). 0
!warn <name> <reason> Chat command that adds a warning. -
garrysmod/data/kgx_admin_toolbox/ladder.json Where the ladder is saved. -

Tips and limits

  • Each warning count can have one step. Steps are sorted by count.
  • A step only runs when the count is reached exactly. Clearing a player's warnings starts them from zero again.
  • Kick and ban steps skip bots.
  • A jail step takes the player to a jail location (Functions > Jail) when kgxat_jail_locations is 1 and the map has one. Otherwise they are jailed where they stand.
  • Ladder actions are written to the Action Log. In Discord Logs, bans count as bans, kicks as kicks, and gags, mutes and jails as warnings.
  • The older kgxat_warn_kick setting still works on its own. If both are set, both can apply.

Back to Settings

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