️ Antiwhat - Lightweight Paper/Spigot Anticheat
Version: 1.0.0
Author: Troy1sh
Discord: t00fake
Tested Minecraft Versions: 1.21+

Description
Antiwhat is a powerful yet lightweight anticheat plugin designed for Paper/Spigot 1.21+ servers.

It provides strong protection against common Minecraft cheats while maintaining optimal server performance and minimizing false positives.

The system uses intelligent detection algorithms that dynamically adapt to server conditions such as TPS, ping, and legitimate gameplay mechanics.

✨ Features
Detection Modules
Module Description
Fly Detects hovering, abnormal vertical movement, and impossible upward movement spikes
Jesus Detects walking or running on water without swimming
Reach Detects attacks beyond legitimate combat distance
KillAura Detects combat automation including aim assist, instant target snapping, high CPS, and rapid target switching
AutoClicker Detects macro-based clicking patterns using statistical analysis
XRay Detects abnormal mining patterns and suspicious ore discovery rates
AutoTotem Detects unnatural totem usage speed and reaction timing
NoFall Detects fall-damage bypass behavior
Timer Detects modified client tick speed manipulation
Smart Systems
⚡ Adaptive Grace Periods
Automatically accounts for legitimate gameplay mechanics, including:
elytra flight, riptide tridents, wind charges, mace attacks, teleportation, knockback, and other valid movement/combat scenarios.

Violation Level (VL) System

• Each detection increases a violation score
• VL decays over time
• Prevents long-term false accumulation
• Ensures fair and balanced punishment logic

⚙️ Performance Aware Detection
Detection sensitivity dynamically adjusts based on:

• Server TPS
• Player ping

This ensures stable performance even under heavy load.

⚖️ Progressive Ban System

• 4 warnings within 60 minutes → automatic ban
• Ban duration: 7–30 days (fully configurable)

⚙️ Why Antiwhat?
Feature Benefit
⚡ Lightweight Minimal performance impact even on large servers
Accurate Smart detection reduces false positives
⚙️ Configurable Fully customizable checks, thresholds, and punishments
Informative Discord webhook integration for staff + public logs
User Friendly Built-in /suspect GUI system
Commands
Command Permission Description
/suspect antiwhat.suspect Open suspect GUI
/sus antiwhat.suspect Alias for /suspect
/suspect list antiwhat.suspect View flagged players
/suspect clear <player|all> antiwhat.admin Clear suspect data
/suspect unban <player> antiwhat.admin Unban a player
/antiwhat reload antiwhat.admin Reload configuration
Permissions
Permission Default Description
antiwhat.alert OP Receive real-time alerts
antiwhat.suspect OP Access suspect commands
antiwhat.admin OP Admin controls (reload, clear, unban)
antiwhat.bypass FALSE Bypass all anticheat checks
⚙️ Configuration
Webhooks

webhook:
private-url: "YOUR_WEBHOOK_URL_HERE"
public-url: "YOUR_WEBHOOK_URL_HERE"
username: "SERVERNAME"
avatar-url: ""

️ Ban System

ban:
enabled: true
warnings-before-ban: 4
time-window-minutes: 60
min-vl-for-ban: 15.0
max-ping-allowed: 300
min-tps-required: 18.0
min-days: 7
max-days: 30
reason: "Cheating detected by Anticheat join discord.gg/YOURDISCORDLINK if false ban."

Detection Toggles

checks:
fly: true
jesus: true
reach: true
killaura: true
autoclicker: true
xray: true
autototem: true
nofall: true
timer: true
meteor:
enabled: true
action: "kick"
min-days: 7
max-days: 30
kick-message: "Cheat Client detected!"

Thresholds (Example)

thresholds:
fly:
hover-ticks: 45
hover-delta-y: 0.015
min-height-from-ground: 1.0
up-spike: 1.2

⚖️ Violation Levels

vl:
fly:
alert: 12.0
decay-per-second: 1.5
reach:
alert: 14.0
decay-per-second: 1.2

⚡ Grace Periods

grace:
join-ms: 4000
teleport-ms: 2500
velocity-ms: 1500
damage-ms: 1200
glide-ms: 2000
riptide-ms: 1800

Alerts

alerts:
permission: "antiwhat.alert"
show-details: true
send-to-ops: true
send-to-permission: true
broadcast-to-all: false
send-to-console: true

⚙️ Performance

performance:
min-tps: 16.5

Storage

suspects:
keep-max: 500

Installation

1. Download Antiwhat
2. Place .jar in /plugins folder
3. Restart server
4. Edit config.yml
5. Run /antiwhat reload or restart server

⚙️ How It Works
Violation System

1. Player triggers detection
2. VL increases based on severity
3. VL decays over time
4. Alerts sent to staff
5. Ban applied after threshold reached

Webhook System

• Private Webhook: Staff logs with full details
• Public Webhook: Ban announcements only

️ Troubleshooting
Issue Solution
False positives Increase grace values
High ping bans Raise max-ping-allowed
TPS lag skips Lower min-tps
Webhook not working Verify Discord webhook URL
‍ Support
Author: Troy1sh
Discord: t00fake

For support, suggestions, or bugs → contact via Discord.