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
- As a superadmin, open Settings > Warning Ladder.
- Set At this many warnings to 2, pick Gag (chat) and set the minutes to 10. Press Add / replace this step.
- Add 3 = Jail for 5 minutes.
- Add 4 = Kick.
- Add 5 = Ban for 1440 minutes.
Change or remove a step
- To change a step, add a new one with the same warning count. It replaces the old one.
- To remove one, select it in the list and press Remove the selected step.
Test it
- Add 2 = gag 1 minute and 3 = jail 1 minute.
- 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_locationsis 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_kicksetting still works on its own. If both are set, both can apply.