Tutorial / Settings

Anti-Cheat

Server-side checks for speed, flying, noclip, teleports, aim snaps and net spam, with strikes, a live list, scans and optional kicks.

What it does

Anti-Cheat runs checks on the server and gives a strike for each hit. It looks for speed on the ground, flying, noclip while noclip is off for that player, teleport jumps, aim snaps while shooting and net message spam. It is off by default (kgxat_ac 0).

A strike is written to the Action Log, Discord logs and the player's history, and shown to admins. You can also kick a player automatically after a set number of strikes. Each kind of check gives at most one strike every 10 seconds per player.

These checks are heuristics. Jetpacks, sprint mods and other movement addons can trigger them, so start with kicks off and watch the live list. Teleports and noclip set by any addon's Lua (the toolbox, ULX, DarkRP and others) and map teleporters are never counted. Client-side cheats that do not change what the server sees, such as wallhacks or ESP, cannot be detected.

The page also holds the toolbox net budget (kgxat_net_budget). It limits how many toolbox net messages one player may send per second and works even with the anti-cheat off. v3.6.21.6: with KGX Core installed it is the same setting as kgx_net_budget, and the limit counts every KGX addon's messages from that player together (the toolbox's 100 is kept when Core is added).

Where to find it

Q menu > KGX's Admin Toolbox > Settings > Anti-Cheat.

  • Only superadmins can change the settings. Other viewers see "Only superadmins can change these settings." and the controls are greyed out.
  • The live list, Scan now, and the strike commands work for toolbox admins.
  • Server console: kgxat_acscan prints the scan report.

The panel

Checkboxes apply as soon as you tick them. Sliders only apply when you press Apply the numbers above.

General
Option What it does Default
Anti-cheat on Turns every check on or off. With it off, nothing is checked. Off
Also check toolbox admins (off: admins are skipped) Checks toolbox admins too. Off
Tell admins about every strike Sends every strike to the admins online. On
Kick at this many strikes (0 = never) Kicks the player at this strike count. Range 0-50. 0
Checks
Option What it does Default
Speed: faster than allowed on the ground Flags running faster than allowed for 1.5 seconds. On
Too fast = run speed times How many times the player's run speed counts as too fast. Range 1.2-5. 1.6
Flying: in the air without falling Flags staying in the air without falling. On
Seconds in the air Seconds in the air before it counts as flying. Range 2-30. 5
Noclip while noclip is off for them (sbox_noclip, RP and Build mode rules) Flags noclip a player may not use right now. On
Teleport jumps nothing made Flags jumps across the map that no addon or map teleporter made. On
Units within a quarter second Distance moved in a quarter second that counts as a teleport. Range 500-10000. 1500
Aim snaps while shooting Flags fast view turns while holding fire. On
Degrees in one tick Turn in one tick that counts as a snap. Range 20-180. 60
Snaps within 10 seconds Snaps within 10 seconds that make a strike. Range 2-20. 4
Net message spam Flags a player who sends too many net messages. On
Messages per second Net messages per second from one player that count as spam. Range 50-5000. 300
Ignore messages above the limit (can break addons that send a lot at once) Drops messages above the limit for the rest of that second. Off
Toolbox messages per player per second (0 = no limit) Toolbox net budget. Only the toolbox's own messages count. Range 0-1000. 100
Apply the numbers above Sends every slider value to the server. -
Live

The list updates every second while it is visible. The line above it reads "Anti-cheat ON - live, every second." or tells you the anti-cheat is off.

Column What it shows
Player Name. "(skipped)" means the player is not checked (an admin).
Speed Speed in units per second.
Air s Seconds off the ground.
Net/s Net messages per second.
Snaps Aim snaps while shooting in the last 10 seconds.
Noclip "yes" while the player is in noclip.
Strikes Strike count.
Last flag The last strike's kind and detail.

Rows with strikes are red. Grey rows are skipped players.

Right-click a row for Strike history (the last 20 strikes), Clear strikes and Copy SteamID.

Button What it does
Scan now (report of every player) Runs one movement check on everyone and opens a report window. The report is also printed to your console.
Clear every strike Asks to confirm, then clears every player's strikes.
Test
Button What it does
Net spam test: send a burst of messages from me Sends the spam limit plus 20 messages from you. You only get a strike if admins are checked or you are not one.

You can also test with the Test Dummy: Shift + right-click a dummy > Act like a cheater.

How to use it

Turn the anti-cheat on safely
  1. As a superadmin, open Settings > Anti-Cheat.
  2. Tick Anti-cheat on. Leave Kick at this many strikes (0 = never) at 0.
  3. Play normally for a while and watch the live list and the strike messages.
  4. If a movement addon causes false strikes, raise its threshold or untick that check, then press Apply the numbers above.
  5. When you trust the results, set a kick count and press Apply the numbers above.
Test each check with a Test Dummy
  1. Tick Anti-cheat on.
  2. Spawn a Test Dummy in an open area. Shift + right-click it > Act like a cheater.
  3. Pick speed, flying, teleport, noclip or aim snaps. Within seconds the dummy gets a strike and its row turns red.
  4. Pick Play fair again to stop.

Noclip without asking only gives a strike when sbox_noclip is 0. If you set a kick count, the dummy is removed at that strike count.

Get a report of every player
  1. Press Scan now (report of every player).
  2. The window lists which checks are on, whether admins are checked and the kick count.
  3. Players with 3 or more strikes show as BAD, fewer as WARN, with their last 5 strikes.
  4. A line also names any other addon that already wrapped net messages (another anti-cheat or net limiter).

Settings and commands

Setting Default Range
kgxat_ac 0 0-1
kgxat_ac_admins 0 0-1
kgxat_ac_notify 1 0-1
kgxat_ac_kick 0 0-50
kgxat_ac_speed 1 0-1
kgxat_ac_speed_factor 1.6 1.2-5
kgxat_ac_fly 1 0-1
kgxat_ac_fly_time 5 2-30
kgxat_ac_noclip 1 0-1
kgxat_ac_teleport 1 0-1
kgxat_ac_teleport_dist 1500 500-10000
kgxat_ac_aim 1 0-1
kgxat_ac_aim_angle 60 20-180
kgxat_ac_aim_count 4 2-20
kgxat_ac_net 1 0-1
kgxat_ac_net_rate 300 50-5000
kgxat_ac_net_drop 0 0-1
kgxat_net_budget 100 0-1000
Command What it does
kgxat_acscan Server console only. Prints the scan report.

Tips and limits

  • Players are not checked while dead, in a vehicle, held by a physgun, spectating, parented to something, or for a short grace time after spawning or a Lua teleport.
  • Speed is not checked while standing on a moving object or in deep water.
  • A speed strike needs 1.5 seconds over the limit. The limit is run speed times the factor, plus 50.
  • Admins are always allowed to noclip, so they never get a noclip strike.
  • The anti-cheat's SetPos, SetMoveType and net hooks are only in place while kgxat_ac is 1. Turning it off takes them out, no restart needed.
  • Ignore messages above the limit can break addons that send many messages at once. Leave it off unless you need it.
  • The toolbox net budget drops extra toolbox messages and logs it at most once a minute per player.
  • Strikes are kept on the player for the current session only.

Back to Settings

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