Compatibility
Minecraft: Java Edition
Platforms
Links
Tags
Creators
Details
âĻ 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
| Category | Checks |
|---|---|
| Movement | Speed, Fly, Hover, Teleport, GroundSpoof, Elytra/Riptide speed |
| Combat | Reach, KillAura (angle + multi), AimSnap, Criticals, AutoBlock |
| World | Nuker, FastPlace, Scaffold, FastBreak |
| Vehicle | Boat-Fly, per-type vehicle speed |
| Packet | AutoClicker, BadPackets, Timer, crash protection, packet-flood |
| XRay | ore thresholds, ore/stone ratio, rare-ore combos, restricted zones |
| Inventory (opt-in) | InventoryMove, ChestStealer, FastUse, BowSpam, AutoTotem |
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
- Drop the jar in
plugins/(plus PacketEvents). - Start the server.
- 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!


