xoxo-AntiCheat
A highly optimised AntiCheat with Tick Flags, Violation Levels (VL), auto Ban and exception List
xoxo-AntiCheat
Fast, smart, and fair — keeping your server clean.
xoxo-AntiCheat is a lightweight but powerful server-side anti-cheat plugin for Paper/Bukkit servers. Built with performance in mind, it features a novel tick-based flag queue system, instant rubberbanding, and a velocity simulation layer — so detections are accurate and false positives are kept low.
🛡️ Detection Modules
xoxo-AntiCheat employs a modular design with specialized checks across multiple categories:
⚙️ Core/Packet Checks (1)
- TimerA: Detects abnormal packet rates indicating modified clients or macros
🚶 Movement Checks (6)
- JesusA: Detects walking on water without proper support
- StepA: Detects illegitimate step heights
- FlyA: Detects flying without proper support or hovering
- JumpA: Detects abnormally high jumps
- SpeedA: Detects excessive ground speed
- NoSlowA: Detects breaking blocks too quickly while holding items
⚔️ Combat Checks (6)
- AutoClickerA: Detects automated clicking with abnormal CPS and low variance
- ReachA: Detects attacking entities beyond normal reach distance
- AimAngleA: Detects attacks when aiming significantly away from target
- NoSwingA: Detects hitting entities without swinging arm
- MultiAuraA: Detects hitting multiple distinct entities rapidly
- RotationLockA: Detects unnatural view angle locking during combat
🧱 Block Checks (5)
- FastBreakA: Detects breaking blocks faster than possible with given tools and effects
- BlockReachA: Detects breaking/placing blocks beyond normal reach
- BlockSightA: Detects breaking blocks without looking at them
- InteractReachA: Detects interacting with entities beyond normal reach
- ScaffoldA: Detects suspicious floating block placements
Total Checks Loaded: 18
⚡ Key Features
🎯 Tick Flag Queue
Most anti-cheats process one flag and move on. xoxo-AntiCheat is smarter: a player can only receive one flag per tick, but if multiple violations are detected within a single tick, they are queued and distributed across subsequent ticks. No detection is ever dropped — every violation is counted.
⚡ Instant Rubberbanding
The rubberbanding system triggers immediately upon a flag, blocking:
- Movement
- Camera rotation
- Inventory actions
Players are snapped back before they can gain any advantage.
🚨 Ban System & Auto-Ban
- Custom, readable ban messages that clearly communicate the reason to the player
- Configurable auto-ban threshold: once a player accumulates a set number of flags, they are automatically banned
📐 Velocity Level (Simulation Layer)
xoxo-AntiCheat includes a Velocity Layer - a simulation component that correctly models player physics. This ensures the anti-cheat understands what movement is legitimate before flagging, drastically reducing false positives in edge-case movement scenarios.
🔧 /xoxo Command
A built-in management command for server administrators.
| Subcommand | Description |
|---|---|
/xoxo exceptions add <player> | Add a player to the exceptions list — they will not be flagged or rubberbanded |
/xoxo exceptions remove <player> | Remove a player from the exceptions list — they will be flagged and rubberbanded again |
/xoxo exceptions get | List all players currently on the exceptions list |
/xoxo violations <player> | List all violation from the specific player |
More subcommands are planned for future releases.
📦 Installation
- Download the latest
.jarfrom the Releases page - Drop it into your server's
plugins/folder - Restart your server
- The plugin stores ban history locally. Ban durations increase with repeated offenses. To reset a player's ban history, remove their record from the generated ban data files.
🖥️ Compatibility
| Version | Status |
|---|---|
| Paper/Bukkit/Spigot 1.20.5 (Java 21) | ✅ Supported (BETA) |
| Paper/Bukkit/Spigot 1.20.6 (Java 21) | ✅ Supported |
| Paper/Bukkit/Spigot 1.21.1 | ✅ Supported (BETA) |
| Paper/Bukkit/Spigot 1.21.4 | ✅ Supported (BETA) |
| Paper/Bukkit/Spigot 1.21.10 | ✅ Supported |
| Paper/Bukkit/Spigot 1.21.11 | ✅ Supported |
| Paper/Bukkit/Spigot 26.1 | 🔜 Planned |
| Paper/Bukkit/Spigot 26.1.2 | 🔜 Planned |
⚠️ Known Issues
These are known bugs being actively investigated. Workarounds or fixes will be included in future updates.
- Rubberband misfires on certain jumps — In rare cases the rubberbanding system fires unexpectedly, causing a brief, visible stutter in player movement. This can occur when:
- Performing large/long jumps
- Jumping out of water
- Jumping frame-perfectly down the edge of a block
📈 Planned Features
- Support for Version under 1.20 and 26.1, 26.1.2
- Expanded
/xoxocommand (view flags, manage bans, reload config) - Per-check enable/disable in config
- Flag logging to file / database
- Rubberband misfire fix for edge-case jumps
- Fix for leaf/plant blocks in water false positives
🤝 Contributing
Issues and pull requests are welcome! If you encounter a false positive or a missed detection, please open an issue with as much detail as possible (server version, what the player was doing, any relevant logs).
📄 License
MIT — free to use, modify, and distribute.
💙 Support
If you find xoxo-AntiCheat useful, consider starring the repository or contributing to help keep development going!
xoxo-AntiCheat — because your players deserve a fair server.