Donut anticheat

🍩 DonutAntiCheat v1.0.0 — Paper 1.21.11

Big-server grade anticheat, themed gold-on-black for Donut SMP. Real-time detection, staff tooling, Discord integration, and rank-aware alerts — all fully configurable, nothing hardcoded.

🛡️ CHECKS

⚔️ Combat - KillAura Inhuman attack angles / multi-target hits per second ⚔️ Combat - Reach Hitting targets beyond legit combat range 🏃 Movement - Speed Horizontal speed exceeding the legit cap 🕊️ Movement - Flight Sustained airtime with no legitimate cause 🎒 Inventory - FastInventory Inhuman click speed in menus/chests ⛏️ World - Nuker Breaking blocks faster than physically possible 🧱 World - FastPlace Placing blocks faster than physically possible

Every check has its own toggle, tuning values, and independent punishment ladder (⚠️ WARN → 🔇 MUTE → 👢 KICK → ⛔ BAN), each with configurable thresholds, durations, and reasons.

🎮 COMMANDS

/donutac (alias: /dac, /anticheat) — main admin hub reload 🔄 reload config live, no restart banhistory <player> 📜 opens a gold-themed chest GUI of a player's full ban history unban <player> ✅ pardon an active ban stats <player> 📊 live per-check violation levels for an online player

/sus 🕵️ — live suspicious-players watchlist

• Shows every online player currently carrying a violation level > 0
• Sorted worst-first, color-coded 🟡→🟠→🔴 by severity tier
• Displays each player's LuckPerms rank next to their name, if LuckPerms is installed

/offend <player> <reason> 🚩 — manual offense log

• For things checks can't catch: chat abuse, griefing reports, scamming, disrespect, ban-evasion tips, etc.
• Reason presets are configurable in config.yml, but staff can type a custom reason too
• Broadcasts to staff with donutac.alerts, fires a Discord embed, and saves permanently to offenses.yml

/offend history <player> 📖 — pull up everything logged against a player, most recent first

📣 DISCORD WEBHOOK INTEGRATION

Flip discord.enabled: true in config.yml, drop in your webhook URL, and get real-time embeds for: 🔨 Bans player, check, reason, duration, ban ID, who banned them 👢 Kicks player, check, violation level 🔇 Mutes/Warns player, duration, reason ⚡ Live Alerts every single flagged violation as it happens, with ping 🚩 Manual Offenses everything logged via /offend

Every event type has its own on/off switch, so you can route bans to one channel and dial down alert noise separately. All webhook calls run fully async — zero TPS impact, even under heavy alert volume.

👑 LUCKPERMS INTEGRATION

• Soft dependency — works perfectly with or without LuckPerms installed
• If detected: shows each player's primary group/rank in /sus, /donutac stats, and Discord embeds
• If not detected: everything still works exactly the same, just without the rank tag — no errors, no crashes

⚙️ FULLY CONFIG-DRIVEN

Everything lives in config.yml — zero hardcoded values: 🏷️ Server name & appeal link (used via %server%/%appeal% placeholders everywhere) 🎨 Prefix, violation-level labels & colors (gold → red escalation) 🧮 Per-check thresholds, sensitivities, and punishment ladders 🔗 Discord webhook URL, bot username/avatar, per-event toggles 📝 Offense reason presets

💾 DATA PERSISTENCE

bans.yml - full ban history, survives restarts, powers the ban-history GUI offenses.yml - every manual /offend entry, permanent paper trail