ANTITPSU – SUS-Based Anti-Cheat for Paper 1.21.1
ANTITPSU is a lightweight anti-cheat for Paper servers built around a SUS (suspicion) points system. Failing a check doesn't instantly ban anyone: it adds SUS points, alerts your staff, and (optionally) blocks the cheat. Punishments are fully disabled by default and only happen if you enable them.
✨ Features
- SUS points system – every flag adds points that slowly decay over time
- Real blocking – movement cheats are set back, illegal hits / breaks / placements are cancelled
- Staff alerts – clickable & hoverable chat alerts showing player, hack type, SUS, ping, TPS and whether the cheat was blocked
- Punishments are opt-in – kicks/bans only run if enabled in
config.yml, per action, at a SUS threshold. Actions can count only specific checks (e.g. only combat checks) - Admin GUI – a clean chest GUI (
/antitpsu) to toggle checks, manage alerts and punishments, view logs and suspicious players - Per-player logs –
/antitpsu log <player>(GUI or chat) + daily log files - Lag friendly – lag-compensated combat checks, auto-pause on low TPS, high-ping players are skipped, grace periods after teleports / knockback / damage
- Discord webhook (optional) and client brand alerts (optional)
- Every check is configurable and can be turned off
🛡️ Checks (19)
| Category | Checks |
|---|---|
| Combat | Reach, Killaura (angle / multi-target / rate / no-swing), AutoClicker, WallHit, Aim (snap / smooth) |
| Movement | Fly (gravity / jump / hover), Speed, NoFall, Step, Timer, Phase |
| Player | BlockReach, FastBreak, FastPlace, Scaffold (+ Tower), Nuker, FastUse, InventoryMove |
| Other | BadPackets (sprint / sneak toggle spam) |
🎮 Commands
| Command | Description |
|---|---|
/antitpsu |
Open the admin GUI |
/antitpsu log <player> [chat] |
Show a player's flag log |
/antitpsu profile <player> |
Ping, client brand, SUS breakdown |
/antitpsu sus <player> |
SUS breakdown |
/antitpsu reset <player> |
Reset a player's SUS |
/antitpsu exempt <player> [minutes|off] |
Temporarily exempt a player from all checks |
/antitpsu stats |
Global statistics |
/antitpsu alerts |
Toggle your own alerts |
/antitpsu reload |
Reload the config |
Aliases: /atpsu, /atp
🔑 Permissions
| Permission | Description | Default |
|---|---|---|
antitpsu.admin |
Use the command and GUI | OP |
antitpsu.alerts |
Receive alerts | OP |
antitpsu.bypass |
Bypass all checks | false |
📦 Requirements
- Paper 1.21.1 (Paper-only – uses Paper APIs)
- Java 21
- No other plugins required
⚙️ Configuration
Everything lives in config.yml: alert format (MiniMessage), SUS decay, every check's tolerance / buffer / SUS value, setback and cancel-on-flag per check, punishments, Discord webhook and more.
Punishments are OFF by default. To enable them, set punishments.enabled: true and enable the individual action you want (kick, ban, ...).
⚠️ Notes
- ANTITPSU works with Bukkit/Paper events (no packet library), so it is a good foundation and staff-assist tool, but not a replacement for a packet-level anti-cheat on a large public server.
- Every server is different. If a check flags legit players, raise its
tolerance/buffer-limitor disable it from the GUI. - Keep punishments disabled until you've watched the alerts on your own server for a while.
🐞 Support
Found a bug or a false positive? Open an issue / leave a comment with the check name and the alert info (it's in the hover text).
