AvA Anti-Cheat

插件

· 作者 nsharp-collab

一款专为 Java 服务器设计的轻量级反作弊工具,可检测飞行/移动作弊、聊天刷屏、战斗掉线及部分类型的作弊行为。

0 本站下载 0 关注 更新于 6 小时前

最新 1.9.5.5-DEV · 1.21.11 · Bukkit / Paper

一键开服(送7天)

AvAAntiCheat:简单且高效的 Minecraft 反作弊插件

AvAAntiCheat 是一款轻量级、易于使用的反作弊插件,专为运行在 Bukkit/Spigot API(即 Bukkit、Spigot、Paper、Purpur)上的 Minecraft Java 服务器设计。它有助于为玩家维持一个公平、纯净的游戏环境。

经确认,该插件兼容所有 Minecraft 1.21.X 版本。核心检测仅使用 Bukkit API,因此正常使用无需安装可选集成组件。


核心功能 / 检测项

该反作弊插件会积极监控并记录多种常见的不公平优势行为:

  • 移动类作弊: 飞行、悬停/滞空、无掉落伤害、攀爬墙壁(蜘蛛)、速度作弊、穿墙检测
  • 战斗类: 战斗断线(重启后仍保留记录)、攻击速度/自动点击、攻击序列、击退距离、视线穿透(隔墙命中)、多重命中/多重光环信号
  • 搭建类: 异常方块放置速率检测
  • 聊天滥用: 聊天刷屏
  • 模组横幅: 踢出使用被禁客户端频道/模组加入的玩家(被禁模组在配置文件中设置)
  • 硬件测试器: 对主机进行基准测试,并根据结果选择重型或轻型数学检查配置文件
  • 仅踢出玩家: 不会发出封禁,以防误报
  • 基岩版支持(可选): 如果安装了 Geyser,AvA 将使用 Geyser API 以更准确地估算基岩版玩家的延迟
  • 实验性数据包检测(可选): 如果安装了 PacketEvents,可以启用可选的数据包级别计时器/在地状态/挥动顺序探针(见下文)
  • 实验性移动模拟器: 可选的服务端移动残留日志记录(默认关闭,仅记录日志)

关于日志记录的说明: 系统采用违规计数器。即使未立即采取任何行动,检测结果也会被记录(例如,轻微飞行行为的初次违规),以便管理人员追踪重复违规者。


可选集成

这些均为软依赖。AvAAntiCheat 可在没有它们的情况下于所有 1.21.x 版本上启动并运行。

Geyser (基岩版)

  • 如果您允许基岩版玩家加入,请安装 Geyser-Spigot。
  • 当存在时,AvA 会使用 Geyser 进行基岩版玩家检测和延迟估算。
  • 当不存在时,将像往常一样使用 Java 版的延迟/Player#getPing()。

PacketEvents (实验性数据包检测)

数据包级别的钩子可能会在 Minecraft 补丁之间发生变化,因此它们不包含在 AvA 中。保持 PacketEvents 为可选状态可确保核心反作弊插件与 1.21.x 的兼容性。

  • 如果您想测试数据包检测,请单独安装 PacketEvents 插件。
  • 除非您正在测试,否则请保持 enabled-checks.packet: false(默认值)。
  • 目前,仅在 Minecraft 1.21.11 上启用数据包检测。在其他 1.21.x 构建版本上(或未安装 PacketEvents 时),钩子将保持非活动状态,而 Bukkit 检测仍会运行。
  • 在测试期间,请保持 experimental.log-only: true,以便探针记录残留数据而不进行惩罚。
  • /ac reload 会在您切换配置时重新评估数据包钩子的注册情况。

安装

安装该插件非常简单:

1. 下载插件文件

选择您偏好的方式获取 .jar 文件:

  • GitHub: 从 GitHub Releases 页面下载最新编译版本。
  • 插件网站: 从 Modrinth(或其他支持的网站)获取 .jar 文件。
  • 手动编译(针对开发者):
    • 克隆仓库:git clone https://github.com/nsharp-collab/AvAAntiCheat.git
    • 运行 Maven 命令:mvn clean package
    • 编译后的文件将位于本地 /target 目录中。

2. 服务器设置

  1. 将 AvAAntiCheat.jar 文件放入服务器的 /plugins 文件夹中。
  2. (可选) 安装 Geyser-Spigot 以支持基岩版延迟,和/或安装 PacketEvents 以进行实验性数据包检测。
  3. 重启服务器。
  4. 使用命令 /ac status 验证安装是否成功。

用法与命令

有关完整的命令列表、权限和配置选项,请参阅项目 Wiki。

[


故障排除 / 已知问题

版本号显示错误

如果 /ac status 命令或启动消息报告的 Minecraft 版本不正确(例如,文件名显示为“1.9”但提示为“1.8.8”):

  • 原因: 这通常是一个显示错误,即开发人员忘记更新插件内部配置文件中的版本号字符串。
  • 操作: 请创建一个 GitHub Issue,详细说明版本不匹配的情况。反作弊插件本身的功能对于列出的支持版本应保持正确。

实验性数据包检测处于非活动状态

如果您设置了 enabled-checks.packet: true,但在启动/重载时看到警告:

  • 确认已安装并启用了 PacketEvents。
  • 确认服务器版本为 1.21.11(其他 1.21.x 版本故意关闭数据包钩子)。
  • 无论哪种情况,核心移动/战斗/聊天检测均不受影响。

支持、问题反馈与贡献

  • 报告问题: 如果发现漏洞、崩溃或绕过行为,请在 GitHub 或 Discord 上提交详细的 Issue Ticket。
  • 贡献代码: 有关提交功能建议和拉取请求的指南,请参阅单独的 CONTRIBUTING.md 文件。
  • 疑问/服务器帮助? 如果您有任何问题或需要反作弊方面的帮助,请加入 Discord。

隐私与数据收集

AvA Anti-Cheat 重视透明度。请注意以下几点:

  • bStats 指标: 此插件使用 bStats 收集匿名使用数据(如服务器版本和活跃的反作弊模式),以帮助改进开发工作。
  • 本地日志记录: 检测结果和管理员操作会记录在插件文件夹内的 anticheat_log.txt 中。这些数据保留在您自己的服务器上,不会与开发人员共享。
  • 详细信息: 如需第三方依赖项和许可信息的完整列表,请参阅我们的 Notice.md。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源