xoxo-AntiCheat
快速、智能且公平——保持你的服务器纯净。
xoxo-AntiCheat 是一款轻量但强大的 Paper/Bukkit 服务端反作弊插件。它以性能为核心构建,采用了新颖的基于刻(tick)的标志队列系统、即时回弹机制以及速度模拟层——从而确保检测准确并最大限度减少误报。
?️ 检测模块
xoxo-AntiCheat 采用模块化设计,在多个类别中设有专门的检查项:
⚙️ 核心/数据包检查 (1)
- TimerA:检测异常的发包速率,以此识别修改过的客户端或宏命令
? 移动检查 (6)
- JesusA:检测在没有适当支撑的情况下在水面上行走
- StepA:检测不合法的台阶高度
- FlyA:检测在没有适当支撑或悬停状态下的飞行行为
- JumpA:检测异常高的跳跃
- SpeedA:检测过快的地面移动速度
- NoSlowA:检测手持物品时过快的方块破坏速度
⚔️ 战斗检查 (6)
- AutoClickerA:检测具有异常 CPS(每秒点击次数)和低方差率的自动点击行为
- ReachA:检测攻击超出正常距离范围的实体
- AimAngleA:检测瞄准方向严重偏离目标时的攻击行为
- NoSwingA:检测未挥动手臂却击中实体的行为
- MultiAuraA:检测快速击中多个不同实体的行为
- RotationLockA:检测战斗中 unnatural 的视角锁定行为
? 方块检查 (5)
- FastBreakA:检测使用给定工具和效果下不可能实现的超快方块破坏速度
- BlockReachA:检测超出正常范围破坏/放置方块的行为
- BlockSightA:检测不看准方块却进行破坏的行为
- InteractReachA:检测超出正常范围与实体交互的行为
- ScaffoldA:检测可疑的悬浮方块放置行为
已加载检查总数: 18
⚡ 核心特性
? 刻标志队列
大多数反作弊插件处理一个标志后就会继续下一个。xoxo-AntiCheat 更加智能:每个玩家每刻只能接收一个标志,但如果在一刻内检测到多项违规,它们会被排队并在随后的刻中依次分发。没有任何检测会被丢弃——每一次违规都会被计入。
⚡ 即时回弹
回弹系统在收到标志后立即触发,阻止以下行为:
玩家在获得任何优势之前就会被强制拉回原位。
? 封禁系统与自动封禁
- 自定义、易读的封禁消息,向玩家清晰传达原因
- 可配置的自动封禁阈值:一旦玩家积累到设定的标志数量,将被自动封禁
? 速度层级(模拟层)
xoxo-AntiCheat 包含一个速度层——一个模拟组件,能够正确建模玩家物理运动。这确保反作弊系统在标记违规行为之前先理解哪些移动是合法的,从而大幅降低边缘情况移动场景中的误报率。
? /xoxo 命令
为服务器管理员提供的内置管理命令。
| 子命令 |
描述 |
/xoxo exceptions add <player> |
将玩家添加到例外列表——他们将不会被标记或回弹 |
/xoxo exceptions remove <player> |
从例外列表中移除玩家——他们将被重新标记和回弹 |
/xoxo exceptions get |
列出当前在例外列表中的所有玩家 |
/xoxo violations <player> |
列出特定玩家的所有违规记录 |
更多子命令计划在未来的版本中发布。
? 安装
- 从 Releases 页面下载最新的
.jar 文件
- 将其放入服务器的
plugins/ 文件夹中
- 重启服务器
- 插件会本地存储封禁历史。重复违规会导致封禁时长增加。若要重置玩家的封禁历史,请从生成的封禁数据文件中移除其记录。
?️ 兼容性
| 版本 |
状态 |
| Paper/Bukkit/Spigot 1.20.5 (Java 21) |
✅ 支持 (BETA) |
| Paper/Bukkit/Spigot 1.20.6 (Java 21) |
✅ 支持 |
| Paper/Bukkit/Spigot 1.21.1 |
✅ 支持 (BETA) |
| Paper/Bukkit/Spigot 1.21.4 |
✅ 支持 (BETA) |
| Paper/Bukkit/Spigot 1.21.10 |
✅ 支持 |
| Paper/Bukkit/Spigot 1.21.11 |
✅ 支持 |
| Paper/Bukkit/Spigot 26.1 |
? 计划中 |
| Paper/Bukkit/Spigot 26.1.2 |
? 计划中 |
⚠️ 已知问题
这些是正在积极调查的已知漏洞。修复方案或变通方法将在未来的更新中包含。
- 特定跳跃情况下回弹误触发 —— 在极少数情况下,回弹系统会意外触发,导致玩家移动出现短暂可见的卡顿。这可能发生在:
- 进行大跨度/长距离跳跃时
- 跳出水面时
- 帧完美地沿方块边缘下落时
? 计划功能
- 支持 1.20 以下版本及 26.1, 26.1.2
- 扩展
/xoxo 命令(查看标志、管理封禁、重载配置)
- 配置中针对单个检查项的启用/禁用
- 将标志日志记录到文件或数据库
- 修复边缘情况跳跃导致的回弹误触发
- 修复水中树叶/植物方块的误报问题
? 贡献
欢迎提交 Issue 和 Pull Request!如果你遇到误报或漏报的情况,请尽可能详细地打开一个 Issue(包括服务器版本、玩家当时正在做什么、以及任何相关日志)。
? 许可证
MIT — 可免费使用、修改和分发。
? 支持
如果你觉得 xoxo-AntiCheat 很有用,请考虑给仓库加星或贡献代码,以支持开发持续进行!
xoxo-AntiCheat —— 因为你的玩家值得一个公平的游戏环境。
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
.jar from 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
/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
- 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧