MCGuard Anticheat

插件

· 作者 fmrcryptx

这是一款自定义制作的反作弊系统!它拥有强大的 13 项功能,能够高效地完成其职责!

0 本站下载 0 关注 更新于 2 个月前

最新 1.0.0 · 1.20.6 · Bukkit / Folia

一键开服(送7天)

McGuard (插件)

一款轻量级的、基于事件的 Bukkit 系列服务端反作弊。 一个 jar 包即可运行于 CraftBukkit、Spigot、Paper、Purpur、Pufferfish、Folia,以及混合核心(Arclight、Mohist)。无需 mixins,无需数据包拦截,无需 NMS —— 玩家使用未修改的客户端加入服务器,且在下一个版本更新时不会出现兼容性问题。


它是什么——以及诚实地说它不是什么

McGuard 响应 Bukkit 事件(移动、攻击、破坏、放置)并读取服务端权威状态——位置增量、服务端速度、服务端坠落距离、延迟。它不会像 Grim 或 Vulcan 那样逐包模拟玩家的移动数据包。

因此请明确其范围: McGuard 在细微的移动作弊检测上无法与基于数据包模拟的反作弊相媲美。但它能做的是,以低成本和稳定性捕获绝大多数服务器实际遇到的作弊行为——飞行、加速、超距、杀戮光环、自动点击器、炸矿、计时器、快速放置——并通过延迟补偿保护合法的高延迟玩家,同时在整个 Minecraft/Forge/Paper 补丁版本间保持零维护成本。它可以独立运行于中小型服务器,也可以作为廉价的第二意见和审计日志与数据包反作弊并行运行。

所有默认设置都经过调整以最小化误报。对真实玩家进行错误封禁比让作弊者多存活 30 秒对服务器的伤害更大。


13 项检测

检测项 信号 在 Bukkit 上的强度
Speed 穿过感知修改器的包络线后的水平方块/刻,受 streak 限制 强
Flight 在没有合法来源的情况下持续滞空 强
NoFall 服务端观察到大幅下落,但服务端记录的坠落距离仍约为 0 启发式
InvalidMove 无传送缓冲期的传送级位移增量 强
Reach 眼点到命中盒的距离超出原版 + 延迟奖励 强
KillAura 视角与目标角度无合法瞄准可达,连续 3 次命中 强
AutoClicker CPS 上限 且 点击节奏规律性(标准差) 强
Timer 每秒动作数超过刻率上限 强
NoSlow 进食/喝水/举盾/拉弓时全速移动 良好(Paper),仅限盾牌(Spigot)
FastPlace 每秒放置方块数超过人类速率 强
FastBreak 方块破坏速度快于优化后的合法操作所能达到 近似值
Nuker 每秒破坏大量方块 强
X-Ray 在大样本中有价值矿石的比例高得离谱 统计性

较弱的检查项(NoFall, FastBreak, X-Ray)是纯服务端反作弊的固有局限——客户端是一个黑盒。将它们保留作为可疑信号的呈现手段是有价值的,最好配合用于 X-Ray 的矿石混淆插件一起使用。


跨平台设计

  • 基于 Paper API 编译(它是 Spigot/Bukkit 的超集),因此所有事件类型均可解析。仅 Paper 调用的代码受到保护,使得该 jar 包也能在纯 Spigot 上加载。
  • 兼容 Folia。 folia-supported: true。每个玩家的状态存储在 ConcurrentHashMap 中;每个玩家的事件在其各自的区域线程上运行;惩罚在该线程上内联执行;唯一的共享状态写入(封禁列表)通过全局区域调度器路由。
  • 优雅降级。 isHandRaised()(用于 NoSlow)通过反射解析并在缺失时回退到仅盾牌模式。getPing() 被封装,以便没有该接口的平台简单地禁用延迟补偿而不是报错。启动行会打印检测到的平台和物品使用 API。

延迟补偿

反作弊误报的最大来源是信号看起来像作弊的卡顿玩家。McGuard 读取每个玩家的延迟,并在超过可配置阈值时,按比例放宽距离容忍度和杀戮光环的角度判定。默认开启;调整 latency.pingThresholdMs。


命令与权限

/mcguard(别名 /mcg, /anticheat)— 需要 mcguard.admin 权限:

  • status — 查看当前所有携带违规等级的玩家
  • vl <player> — 单个玩家的各检测项详细分解
  • reset <player> — 清除玩家的违规记录
  • exempt <player> — 切换豁免状态(测试 / 信任的工作人员)
  • checks — 列出所有检测项及其描述
  • reload — 重新读取 config.yml
权限 默认值 含义
mcguard.admin op 运行命令,接收违规警报
mcguard.bypass false 使持有者豁免所有检测项

安装

  1. 将 mcguard-<version>.jar 放入服务端的 plugins/ 文件夹。
  2. 启动服务器一次 —— 生成 plugins/McGuard/config.yml。
  3. 在正常游戏和轻度 PvP 期间观察 /mcguard status。
  4. 调整阈值,然后可选地将 violations.banEnabled 设为 true。

需要 Java 17+ 和 Minecraft 1.20.x,适用于任何基于 Bukkit 的服务器。

标志位以 CSV 格式追加到 plugins/McGuard/violations.log(timestamp,player,uuid,check,vl,detail),供外部仪表盘使用。


发布前 / 上线前

  • 首先在自己的服务器上测试,设置 violations.banEnabled: false。这些阈值只是一个起点,并非绝对真理。
  • 如果你已经运行了基于数据包的 anticheat(Grim, Vulcan),仅启用它未覆盖的检测项,或者纯粹将 McGuard 用作审计日志——不要在同一个信号上堆叠两个自动封禁系统。
  • 在上传到 CurseForge/Modrinth 之前,设置真实的许可证和问题追踪器 URL。

从源代码构建(如果你下载了源代码)

./gradlew build            # -> build/libs/mcguard-<version>.jar
./gradlew installToServer  # 同时将 jar 复制到 ../../server/plugins

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源