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 Minecraft servers running Paper/Spigot 1.21+. It provides robust detection against common cheats while maintaining optimal server performance and minimizing false positives.
Protect your server with intelligent detection algorithms that adapt to your server's performance and player conditions.
✨ Features
Detection Modules
Table
Module Description
Fly Detects hovering, abnormal vertical movement, and impossible up-spikes
Jesus Detects walking/running on water surfaces without swimming
Reach Detects attacks beyond legitimate player reach distance
KillAura Detects aim assistance, instant head snapping, high CPS, and rapid target switching
AutoClicker Detects macro-like clicking patterns with statistical analysis
Smart Systems

• Adaptive Grace Periods — Automatically accounts for legitimate movement sources (elytra, riptide tridents, wind charges, mace attacks, teleportation, knockback, and more)
• VL (Violation Level) System — Violation points that decay over time, preventing false ban accumulation
• Performance Aware — Scales detection sensitivity based on server TPS and player ping
• Progressive Ban System — 4 warnings within 60 minutes → automatic 7-30 day ban (configurable!)

Why Antiwhat?
Table
Feature Benefit
Lightweight Minimal performance impact even on busy servers
Accurate Smart algorithms reduce false positives while catching real cheaters
Configurable Extensive configuration options for every check
Informative Detailed Discord webhook integration for staff monitoring and public ban announcements
User Friendly Interactive GUI for managing suspects (/suspect)
Commands
Table
Command Permission Description
/suspect antiwhat.suspect Open the interactive suspect GUI
/sus antiwhat.suspect Alias for /suspect
/suspect list antiwhat.suspect Display recent suspects in chat
/suspect clear <player|all> antiwhat.admin Clear suspect data for specific player or all
/suspect unban <player> antiwhat.admin Unban a previously banned player
/antiwhat reload antiwhat.admin Reload configuration from config.yml
Command Usage Examples
plain
Copy
/suspect # Open GUI to browse flagged players
/suspect list # See last 40 suspects in chat
/suspect clear Steve # Clear Steve's violation history
/suspect clear all # Wipe all suspect data
/suspect unban Steve # Remove ban and allow rejoin
/antiwhat reload # Apply config changes without restart

Permissions
Table
Permission Default Description
antiwhat.alert OP Receive real-time cheat detection alerts in-game
antiwhat.suspect OP Access to /suspect and /sus commands
antiwhat.admin OP Administrative commands (reload, clear, unban)
antiwhat.bypass FALSE Exempt from ALL anticheat checks (use carefully!)
⚙️ Configuration
config.yml
yaml
Copy
# Discord Webhooks
webhook:
private-url: "YOUR_WEBHOOK_URL_HERE" # Staff alerts & detailed logs
public-url: "YOUR_WEBHOOK_URL_HERE" # Public ban announcements only
username: "SERVERNAME"
avatar-url: ""

# Ban System
ban:
enabled: true
warnings-before-ban: 4 # Consecutive flags required
time-window-minutes: 60 # Reset window for warning count
min-vl-for-ban: 15.0 # Minimum violation level
max-ping-allowed: 300 # Skip ban if player ping higher
min-tps-required: 18.0 # Skip ban if TPS lower
min-days: 7 # Minimum ban duration
max-days: 30 # Maximum ban duration (randomized)
reason: "Cheating detected by Anticheat join discord.gg/YOURDISCORDLINK if it was false ban."

# Detection Toggles
checks:
fly: true
jesus: true
reach: true
killaura: true
autoclicker: true

# Detection Thresholds
thresholds:
fly:
hover-ticks: 45
hover-delta-y: 0.015
min-height-from-ground: 1.0
up-spike: 1.2
jesus:
ticks: 35
reach:
max: 3.85
hard: 4.3
killaura:
window-ms: 2500
max-cps: 20
bad-aim-dot: 0.06
bad-aim-min-distance: 2.8
bad-aim-hits: 12
max-switches: 9
autoclicker:
window-ms: 3000
min-clicks: 18
min-cps: 15.0
stddev-ms: 5.0
round-ms: 5
same-ratio: 0.85
perfect-streak: 12
max-mean-ms: 100.0

# Violation Levels
vl:
fly:
alert: 12.0
decay-per-second: 1.5
jesus:
alert: 12.0
decay-per-second: 1.3
reach:
alert: 14.0
decay-per-second: 1.2
killaura:
alert: 16.0
decay-per-second: 1.0
autoclicker:
alert: 15.0
decay-per-second: 1.1

# Grace Periods (False Positive Prevention)
grace:
join-ms: 4000
teleport-ms: 2500
velocity-ms: 1500
damage-ms: 1200
glide-ms: 2000
riptide-ms: 1800
windcharge-ms: 3500
mace-ms: 3000
trident-boost-ms: 3000

# Alert Settings
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

# Cooldowns
cooldowns:
alert-ms: 12000
flag-cooldown-ms: 3000

# Suspect Storage
suspects:
keep-max: 500

️ Installation

1. Download the latest version of Antiwhat
2. Place the JAR file in your server's plugins/ folder
3. Restart your server
4. Edit plugins/Antiwhat/config.yml to your liking
5. Run /antiwhat reload or restart to apply changes

How It Works
Violation Level (VL) System

1. Detection — Player triggers a check (e.g., flying)
2. VL Increase — Violation points added based on severity
3. Decay — VL automatically decreases over time
4. Alert — Staff notified when VL exceeds threshold
5. Ban — After 4 warnings within time window, player is banned

Webhook Integration
Private Webhook — Sends all alerts with technical details to staff channel
Public Webhook — Sends only ban announcements to public channel
Troubleshooting
Table
Issue Solution
False positives Increase grace periods in config
High ping players getting banned Increase ban.max-ping-allowed
Low TPS causing skips Lower performance.min-tps
Webhook not working Verify URL starts with https://discord.com/api/webhooks/
Support
Author: Troy1sh
Discord: t00fake
For issues, suggestions, or support, contact via Discord.