xoxo-AntiCheat

Minecraft 版本： 1.20.5 1.20.6

平台： bukkit bungeecord paper spigot

标签： game-mechanics technology

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.

More subcommands are planned for future releases.

? Installation

1. Download the latest .jar from the Releases page
2. Drop it into your server's plugins/ folder
3. Restart your server
4. 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

⚠️ 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
• [x] Expanded /xoxo command (view flags, manage bans, reload config)
• [ ] Per-check enable/disable in config
• [ ] Flag logging to file / database
• [ ] Rubberband misfire fix for edge-case jumps
• [x] 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.