🛡️ GuardAC — 适用于 1.21 和 26.x 的轻量级反作弊
GuardAC 是一款针对运行 Minecraft 1.21 – 1.21.11 以及 26.1 – 26.3 版本的 Paper、Spigot、Bukkit、Purpur 和 Leaf 服务器的 24 项检测反作弊插件。它涵盖战斗、移动、世界和物品栏作弊,并能阻止 Meteor 风格的战锤秒杀。
- 📦 一个小型 jar 包(约 90 KB)适用于所有服务器类型,无需 ProtocolLib、NMS 或任何依赖。
- ⚡ 轻量且感知延迟。 它自行测量 TPS,并在延迟期间暂停移动检测。在实际性能分析中,它仅占用约 0.2% 的服务器线程。
- 🆕 支持 26.x。 同一个 jar 包可在 1.21 (Java 21) 和 26.1 – 26.3 (Java 25) 上运行。它能识别长矛(更远的攻击距离、冲刺和冲锋)、开心恶魂、新坐骑、风弹以及战锤。
- 🎯 使用真实的玩家数据。 移动速度、攻击范围、方块挖掘范围和步高均来自玩家的真实属性,因此药水、灵魂疾行附魔、物品和技能插件(如 AuraSkills)会自动被允许。
🔍 24 项检测
⚔️ 战斗
| 检测项 |
捕获行为 |
| Reach |
从过远距离进行攻击(已补偿延迟,尊重长矛的攻击距离) |
| KillAura |
攻击玩家视野外的目标,或在单个游戏刻内攻击多个目标 |
| MaceKill |
伪造坠落战锤砸击。只有当攻击者确实发生了坠落时,砸击才有效 |
| AutoClicker |
点击过快,或点击间隔过于规律,不像人类操作 |
| Velocity |
抗击退:受到攻击或推动后不移动 |
| AutoTotem |
在图腾激活后的几个游戏刻内,副手立即出现新的图腾 |
🏃 移动
| 检测项 |
捕获行为 |
| Speed |
加速外挂和 bhop(连续跳跃加速) |
| Fly |
飞行、悬停、空中行走 |
| NoFall |
声称在半空中处于地面状态以避免坠落伤害 |
| Step |
不跳跃直接垂直走上方块 |
| Spider |
不使用梯子、藤蔓或脚手架攀爬墙壁 |
| Jesus |
在水或熔岩上行走 |
| NoSlow |
进食、持盾格挡或拉弓时保持全速移动 |
| Timer |
加快游戏时钟速度 |
| ElytraFly |
在没有火箭助推的情况下利用鞘翅攀爬或悬停 |
| InventoryMove |
打开箱子或菜单时移动 |
| BadRotation |
不可能实现的头部角度 |
⛏️ 世界和物品栏
| 检测项 |
捕获行为 |
| FastBreak |
挖掘速度快于工具、附魔和效果所允许的速度(包括 Nuker、FastMine) |
| BlockReach |
挖掘或放置超出攻击范围的方块 |
| Scaffold |
不看准方向放置方块 |
| FastPlace |
放置方块速度快于人类点击速度 |
| XRay |
当有人几乎未挖掘石头却找到稀有矿脉时,通知管理员 |
| FastEat |
进食速度快于正常水平 |
| FastInventory |
快速偷取箱子、自动整理物品栏、自动穿戴盔甲 |
MaceKill 工作原理
战锤砸击的伤害取决于攻击者坠落的距离,而服务器依据玩家游戏客户端告知的数据来判断坠落高度。作弊软件会通过一两条消息向服务器谎称“我坠落了 20 格”,然后发起攻击。而真实的 20 格坠落大约需要 24 个游戏刻的重力时间。GuardAC 会检查攻击者是否真的在空中,并且滞空时间是否足以支撑其所声称的坠落高度。如果不符合,则该攻击将被取消。
🧯 误报防护
- 安全更新: 尚未在
config.yml 中启用的检测项以 仅警报模式 运行。更新 GuardAC 绝不会导致玩家突然被踢出或封禁。
- 基岩版 (Geyser) 玩家 会被自动检测,并跳过基于准星指向的检测项。
- 永不检测: 创造模式和旁观模式玩家,以及拥有
guardac.bypass 权限的玩家。
- 允许的移动情况: 飞行、鞘翅、激流、乘坐坐骑、游泳、攀爬、漂浮和缓慢下落。液体、蛛网、脚手架、粉雪和气泡柱不会触发移动违规。
- 宽限期: 加入、重生、传送、被击退、爆炸、风弹和长矛冲刺后的一段时间内给予宽容。
- 插件破坏的方块(如 3x3 镐子、矿脉矿工)永远不会被计为 FastBreak。
- 违规等级随时间下降,因此单次异常标志不会对任何人造成惩罚。
⚖️ 玩家触发标志后的处理流程
- 警报: 管理员会在聊天框看到提示,同时记录到控制台和
violations.log 文件中。
- 干扰: 移动会被拉回,可疑的攻击、方块破坏、放置和进食行为会被取消。
- 惩罚: 达到配置的违规等级时,执行该检测项对应的命令(默认为踢出)。
可选的惩罚阶梯
开启此功能以逐步升级惩罚,例如 14 天 → 30 天 → 永久封禁 + IP 封禁。每一步都是你选择的控制台命令,因此可与 EssentialsX、LiteBans 或原版封禁系统配合使用。每个玩家的违规历史都会被保存,并在重启后保留。
💬 命令
快捷方式:/gac、/anticheat
| 命令 |
描述 |
/guardac alerts |
开启或关闭你自己的警报显示 |
/guardac status |
查看服务器 TPS 及当前启用的检测项 |
/guardac vl <player> |
查看某玩家的违规等级 |
/guardac reset <player> |
清除某玩家的违规等级 |
/guardac offenses <player> |
查看某玩家的惩罚历史(支持离线查询) |
/guardac resetoffenses <player> |
清除某玩家的惩罚历史 |
/guardac reload |
重新加载配置文件 |
🔑 权限
| 权限节点 |
默认值 |
描述 |
guardac.admin |
OP |
所有命令(包括警报控制) |
guardac.alerts |
OP |
接收作弊警报 |
guardac.bypass |
无 |
跳过所有检测 |
📥 安装
- 将
GuardAC-1.0.0.jar 放入你的 plugins 文件夹。
- 重启服务器。
- 调整
plugins/GuardAC/config.yml 中的配置,并运行 /guardac reload。
💡 提示: 在前几天,将所有 max-vl 设置为 0。这样只会收到警报,你可以在任何人被踢出之前根据服务器情况调整限制阈值。
⚠️ 须知
- 基于常规事件,而非网络数据包。 GuardAC 通过服务器的常规事件运行,这使得它非常轻量。虽然某些顶级的基于数据包层面的反作弊可以捕获更多类型的作弊行为(例如 Blink、Backtrack 和高级 Timer 绕过),但 GuardAC 专注于核心检测。
- 有些作弊手段任何反作弊都无法直接阻止,因为它们仅改变作弊者所看到的内容:ESP(透视)、追踪线、自由视角(freecam)和箱子透视。对于 X-ray(透视挖矿),请同时开启 Paper 内置的 anti-xray 功能。GuardAC 的 XRay 检测会根据挖掘行为发出警告。
这是首个发布版本。如果您发现误报,请从 violations.log 中复制警告文本并提交报告。
© 2026 KhangPlayMusic. All rights reserved. Free to use on any server. Please don't re-upload or resell it.
🛡️ GuardAC — lightweight anti-cheat for 1.21 and 26.x
GuardAC is a 24-check anti-cheat for Paper, Spigot, Bukkit, Purpur and Leaf servers running Minecraft 1.21 – 1.21.11 and 26.1 – 26.3. It covers combat, movement, world and inventory cheats, and it stops Meteor-style mace one-shots.
- 📦 One small jar (~90 KB) for every server type, with no ProtocolLib, no NMS and no dependencies.
- ⚡ Lightweight and lag-aware. It measures TPS itself and pauses movement checks during lag. In a live profile it used about 0.2% of the server thread.
- 🆕 Ready for 26.x. The same jar runs on 1.21 (Java 21) and 26.1 – 26.3 (Java 25). It understands spears (longer reach, lunges and charges), happy ghasts, new mounts, wind charges and the mace.
- 🎯 Uses real player stats. Movement speed, attack reach, block reach and step height come from the player's actual attributes, so potions, Soul Speed, items and skill plugins like AuraSkills are allowed for automatically.
🔍 The 24 checks
⚔️ Combat
| Check |
Catches |
| Reach |
Hitting from too far away (ping-compensated, spear reach respected) |
| KillAura |
Hitting targets outside the player's view, or several targets in one tick |
| MaceKill |
Fake-fall mace smashes. A smash only counts if the attacker really fell |
| AutoClicker |
Clicking too fast, or with timing too regular to be human |
| Velocity |
Anti-knockback: not moving after being hit or pushed |
| AutoTotem |
A new totem in the off hand within a tick or two of one popping |
🏃 Movement
| Check |
Catches |
| Speed |
Speed hacks and bhop |
| Fly |
Fly, hover, airwalk |
| NoFall |
Claiming to be on the ground mid-air to avoid fall damage |
| Step |
Walking straight up blocks without jumping |
| Spider |
Climbing walls without ladders, vines or scaffolding |
| Jesus |
Walking on water or lava |
| NoSlow |
Full speed while eating, blocking or drawing a bow |
| Timer |
Speeding up the game clock |
| ElytraFly |
Climbing or hovering on an elytra without rockets |
| InventoryMove |
Walking with a chest or menu open |
| BadRotation |
Impossible head angles |
⛏️ World and inventory
| Check |
Catches |
| FastBreak |
Mining faster than the tool, enchantments and effects allow (Nuker, FastMine) |
| BlockReach |
Mining or placing blocks out of reach |
| Scaffold |
Placing blocks without looking at them |
| FastPlace |
Placing blocks faster than a person can click |
| XRay |
Alerts staff when someone finds rare ore veins while mining almost no stone |
| FastEat |
Eating faster than normal |
| FastInventory |
Chest stealers, inventory cleaners, auto-armor |
How MaceKill works
A mace smash does more damage the further the attacker fell, and the server takes the fall from what the player's game tells it. Cheats tell the server "I fell 20 blocks" in one or two messages, then hit. A real 20-block fall takes about 24 ticks of gravity. GuardAC checks that the attacker is actually in the air and has been airborne long enough for the fall they claim. If not, the hit is cancelled.
🧯 False-flag protection
- Safe updates: a check that isn't in your
config.yml yet runs in alert-only mode. Updating GuardAC can never start kicking or banning players by surprise.
- Bedrock (Geyser) players are detected automatically and skipped by checks based on where the crosshair points.
- Never checked: creative and spectator players, and anyone with
guardac.bypass.
- Movement allowed for: flying, elytra, riptide, mounts, swimming, climbing, levitation and slow falling. Liquids, cobwebs, scaffolding, powder snow and bubble columns don't cause movement flags.
- Grace periods after joining, respawning, teleporting, knockback, explosions, wind charges and spear lunges.
- Plugin-broken blocks (3x3 pickaxes, vein miners) are never counted as FastBreak.
- Violation levels drop over time, so a single odd flag never punishes anyone.
⚖️ What happens when a player flags
- Alert: staff see it in chat, and it goes to the console and
violations.log.
- Setback: movement is pulled back, and suspicious hits, block breaks, placements and eating are cancelled.
- Punishment: at the configured violation level, the check's command runs (a kick by default).
Optional punishment ladder
Turn it on to escalate punishments, for example 14 days → 30 days → permanent + IP ban. Every step is a console command you choose, so it works with EssentialsX, LiteBans or vanilla bans. Each player's offence history is saved and survives restarts.
💬 Commands
Shortcuts: /gac, /anticheat
| Command |
Description |
/guardac alerts |
Turn alerts on or off for yourself |
/guardac status |
Server TPS and which checks are on |
/guardac vl <player> |
A player's violation levels |
/guardac reset <player> |
Clear a player's violation levels |
/guardac offenses <player> |
A player's punishment history (works offline) |
/guardac resetoffenses <player> |
Clear a player's punishment history |
/guardac reload |
Reload the config |
🔑 Permissions
| Permission |
Default |
Description |
guardac.admin |
OP |
All commands (includes alerts) |
guardac.alerts |
OP |
Receive cheat alerts |
guardac.bypass |
Nobody |
Skip all checks |
📥 Installation
- Drop
GuardAC-1.0.0.jar into your plugins folder.
- Restart the server.
- Adjust
plugins/GuardAC/config.yml and run /guardac reload.
💡 Tip: for the first few days, set every max-vl to 0. You'll get alerts only, so you can tune the limits for your server before anyone is kicked.
⚠️ Good to know
- Normal events, not network packets. GuardAC works through the server's normal events, which keeps it light. The very largest packet-level anti-cheats can catch a few extra cheat types, such as Blink, Backtrack and advanced Timer bypasses.
- Some cheats can't be caught by any anti-cheat, because they only change what the cheater sees: ESP, tracers, freecam and chest ESP. For X-ray, also turn on Paper's built-in anti-xray. GuardAC's XRay check adds alerts based on mining behaviour.
This is the first release. If you see a false flag, please report it with the alert text from violations.log.
© 2026 KhangPlayMusic. All rights reserved. Free to use on any server. Please don't re-upload or resell it.
评论 0
登录后参与评分
还没有评论,来抢沙发吧