BS-AntiCheat

✨ Why BSAntiCheat?

• 🧊 Folia-ready — runs natively on Folia and Paper from the same jar (verified against a real Folia server).
• 🎯 Calm by default — the fiddly, false-positive-prone heuristics ship off; the reliable checks are on. No flag-storm on day one.
• 🔧 Fully calibratable — 25+ thresholds tunable live with /bsac reload, no restart.
• 📡 Transaction-based lag compensation — real ping/pong round-trip timing, not the coarse getPing(), so high-ping players aren't punished.
• 🪶 Tiny — ~355 KB, no bundled bloat.
• 🌍 Bedrock & legacy aware — auto-exempts Geyser/Floodgate and (opt-in) ViaVersion clients whose physics differ.

🛡️ What it detects

Movement is checked every tick (no sampling), ground state is server-authoritative (not the spoofable client flag), and grace windows handle knockback, teleports, joins and elytra landings so normal play stays clean.

⚙️ Enforcement

A violation-level (VL) system with decay drives configurable punishment tiers — run any console commands (warn, kick, ban, custom) at VL thresholds, with optional setback. Ships in report-only mode; flip the switch when you're ready.

🔌 Requirements

• Paper or Folia 1.21.x
• PacketEvents — required for the packet-level checks (AutoClicker, BadPackets, Timer, Crasher, PacketFlood) and lag-transaction system. Everything else works without it.

Optional: LuckPerms (group whitelist), PlaceholderAPI, Geyser/Floodgate, ViaVersion.

🚀 Quick start

1. Drop the jar in plugins/ (plus PacketEvents).
2. Start the server.
3. Tune config.yml, apply with /bsac reload, and enable punishments when you're happy.

Calibrate for your server: set debug_mode: true, keep punishments off, watch the debug values while playing, tune anticheat.thresholds.*, then reload. Done.

📋 Commands & permissions

/bsac, /movealerts, /xrayalerts, /acsilent, /acwhitelist, /xrayores — admin/manage permissions, all with aliases. PlaceholderAPI: %bsanticheat_total%, %bsanticheat_vl_<check>%.

Actively developed. Prediction-level combat detection and reworked opt-in heuristics are on the roadmap. Feedback and bug reports welcome!