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. 服务器设置
- 将
AvAAntiCheat.jar文件放入服务器的/plugins文件夹中。 - (可选) 安装 Geyser-Spigot 以支持基岩版延迟,和/或安装 PacketEvents 以进行实验性数据包检测。
- 重启服务器。
- 使用命令
/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。
AvAAntiCheat: Simple & Effective Minecraft Anti-Cheat
AvAAntiCheat is a lightweight, easy-to-use anti-cheat plugin designed for Minecraft Java servers running on the Bukkit/Spigot API (aka Bukkit, Spigot, Paper, Purpur). It helps maintain a fair and clean environment for players.
It is confirmed to work with any Minecraft version 1.21.X. Core checks use the Bukkit API only, so installing optional integrations is not required for normal use.
Core Features / Detections
The anti-cheat actively monitors and logs several common unfair advantages:
- Movement Hacks: Flying, hover/air-time, no-fall, wall climbing (spider), speed hacks, phase detection
- Combat: Combat logging (persisted across restarts), attack speed / autoclicker, attack sequence, reach, line-of-sight (hit-through-blocks), multi-hit / multi-aura signals
- Scaffold: Abnormal block place-rate detection
- Chat Abuse: Chat spamming
- Mod Banner: Kick players who join with a banned client channel/mod (banned mods are set in the config)
- Hardware Tester: Benchmarks the host and chooses heavy vs light math check profiles
- Only Kicks Players: No bans are issued, in case of false positives
- Bedrock Support (optional): If Geyser is installed, AvA uses the Geyser API for better Bedrock ping estimates
- Experimental Packet Checks (optional): If PacketEvents is installed, optional packet-level timer / onGround / swing-order probes can be enabled (see below)
- Experimental Move Simulator: Optional server-side move residual logging (default off, log-only)
Note on Logging: The system employs a violation counter. Detections are logged (e.g., first violation for minor flying) even if no immediate action is taken, allowing staff to track repeat offenders.
Optional Integrations
These are softdepends. AvAAntiCheat starts and runs on all 1.21.x without them.
Geyser (Bedrock)
- Install Geyser-Spigot if you allow Bedrock players.
- When present, AvA uses Geyser for Bedrock player detection and ping estimation.
- When absent, Java ping/
Player#getPing()is used as usual.
PacketEvents (experimental packet checks)
Packet-level hooks can change between Minecraft patches, so they are not bundled into AvA. Keeping PacketEvents optional preserves 1.21.x compatibility for the core anti-cheat.
- Install the PacketEvents plugin separately if you want to test packet checks.
- Leave
enabled-checks.packet: false(default) unless you are testing. - For now, only enable packet checks on Minecraft 1.21.11. On other 1.21.x builds (or without PacketEvents), hooks stay inactive and Bukkit checks still run.
- Keep
experimental.log-only: truewhile testing so probes log residuals without punishing. /ac reloadre-evaluates packet hook registration when you toggle the config.
Installation
Installing the plugin is straightforward:
1. Download the Plugin File
Choose your preferred method to obtain the .jar file:
- GitHub: Download the latest compiled version from the GitHub Releases page.
- Plugin Sites: Get the
.jarfile from Modrinth (or other supported sites). - Manual Compilation (For Developers):
- Clone the repository:
git clone https://github.com/nsharp-collab/AvAAntiCheat.git - Run the Maven command:
mvn clean package - The compiled file will be in your local
/targetdirectory.
- Clone the repository:
2. Server Setup
- Place the
AvAAntiCheat.jarfile into your server's/pluginsfolder. - (Optional) Install Geyser-Spigot for Bedrock ping support and/or PacketEvents for experimental packet checks.
- Restart your server.
- Verify installation using the command
/ac status.
Usage & Commands
For a full list of commands, permissions, and configuration options, please refer to the project Wiki.
[
Troubleshooting / Known Issues
Incorrect Version Display
If the /ac status command or startup messages report an incorrect Minecraft version (e.g., "1.8.8" when the file name says "1.9"):
- Reason: This is typically a display error where the developer forgot to update the version string in the plugin's internal configuration.
- Action: Please create a GitHub Issue detailing the version mismatch. The functionality of the anti-cheat itself should remain correct for the listed supported version.
Experimental packet checks inactive
If you set enabled-checks.packet: true but see a warning at startup/reload:
- Confirm PacketEvents is installed and enabled.
- Confirm the server is 1.21.11 (other 1.21.x versions keep packet hooks off on purpose).
- Core movement/combat/chat checks are unaffected either way.
Support, Issues, and Contribution
- Reporting Issues: If you find a bug, a crash, or a bypass, please open a detailed Issue Ticket on GitHub or on Discord.
- Contributing: Guidelines for submitting feature suggestions and pull requests can be found in the separate CONTRIBUTING.md file.
- Questions/Server Help?: Join the Discord Here if you have any questions or want any help with the Anti-Cheat
Privacy & Data Collection
AvA Anti-Cheat values transparency. Please be aware of the following:
- bStats Metrics: This plugin uses bStats to collect anonymous usage data (such as server version and active Anti-Cheat mode) to help improve development.
- Local Logging: Detections and administrative actions are logged locally to
anticheat_log.txtwithin the plugin folder. This data stays on your server and is not shared with the developer. - Full Details: For a complete list of third-party dependencies and licensing information, please refer to our Notice.md.
下载 AvA Anti-Cheat
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AvA Anti-Cheat
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AvA Anti-Cheat
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AvA Anti-Cheat
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AvA Anti-Cheat
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AvA Anti-Cheat
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AvA Anti-Cheat
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AvA Anti-Cheat
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AvA Anti-Cheat
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AvA Anti-Cheat
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
DEV-[1.9.5.5] — 2026-11-17
警告:此为开发版本。 测试期间可能会出现错误和不稳定行为。
v1.9.5.5-DEV 新增内容
- 可配置的惩罚: 在
config.yml中添加了punishment-commands。当玩家超过踢出限制时,插件将执行控制台命令,而非硬编码的踢出操作。默认值仍为kick %player% %reason%。占位符包括:%player%、%uuid%、%check%、%vl%、%limit%、%reason%。配置版本已更新至第 6 版。 - 连击 / 自动攻击修复 (#14): 现在统计检测窗口内的唯一目标数量,而非目标切换次数,因此在两个实体之间交替切换(A→B→A)不再误报。
- 攻击速度: 移除了导致合法近战频繁误报的独立攻击冷却或路径选项。冷却时间仅在预测间隔看起来过快时才会增加嫌疑度。
- 距离 / 视线 (#15): 距离检测现在测量的是眼睛到受害者 AABB 最近点的距离,并在仅凭距离定罪前需要满足视角(FOV)阈值。
- 客户端品牌: 通过缓冲早期的
minecraft:brand数据包、正确解码 VarInt 长度,并在必要时回退至 Paper 的品牌 API,修复了原版(及其他)客户端显示为“未知”的问题。 - 性能: 对服务器 TPS 反射查找和 TPS 值进行了 1 秒缓存。之前的 Spark 分析显示,TPS 采样曾主导飞行检查的运行时间。
稳定版-[1.9.5]-(2026-11-3)
更改与修复:
-
添加了用于实验性数据包速率、在地面不匹配、移动和挥动顺序信号的可选 PacketEvents 检查。这些检查默认处于关闭状态,适用于 Minecraft 1.21.11,并且默认仅记录日志。
-
添加了用于实验性移动残留日志记录的可选 移动模拟器。
-
扩展了检测功能,包括悬停/无坠落、距离、穿透方块攻击、多目标战斗以及脚手架方块放置速率检查。
-
改进了移动处理逻辑和误报防护措施,包括传送和击退的宽限期,并调整了速度检测机制。
-
使战斗记录器惩罚在服务器重启后持续生效,并使战斗阻止命令可配置。
-
通过 SHA-256 验证提升了更新安全性;默认情况下自动更新已禁用。
-
重构了管理员绕过机制,改为使用
ava.bypass权限,并移除了隐藏禁用命令。 -
重构了代码结构:将庞大的主 Java 文件拆分为组织良好的独立文件。
-
修复了自动更新器错误标记版本号的问题。
-
修复了速度检查的宽限期,以更好地处理玩家延迟问题。
-
在之前的更新中,添加了一个
/ac info <玩家> <true|false (显示权限)>命令,你可以输入一个玩家的名称来获取他们的一些有用的模组信息。 -
新增智能硬件分析功能。插件现在会在启动时运行简短的性能基准测试以检测您的 CPU 性能。高性能处理器将自动采用新的严格向量数学计算,而低端或 ARM 架构主机则会回退到经典的轻量级检查模式,以确保服务器 TPS(每秒刻数)不受影响。
-
新增
/ac perf <high|light|auto>命令,允许服务器管理员手动覆盖硬件配置分析结果。 -
通过 Geyser API 原生集成对 Bedrock Edition 的支持。针对基岩版玩家,移动检测会引入轻微的宽容度缓冲,以补偿数据包转换带来的抖动,从而减少误报。
-
重写高性能模式下的速度检测(Speed check),改用时间差(Time-Delta)计算。现在它测量的是数据包之间的 elapsed time(经过时间),而不仅仅是直线距离,从而防止玩家利用卡顿积累位移进行瞬移作弊。
-
在飞行检测(Flight check)中新增向量重力预测功能。现在它会使用 Minecraft 内部的重力公式精确计算预期的 Y 轴速度,以侦测悬停和缓慢下落类作弊行为。
-
升级相位检测(Phase check),引入向量光线追踪技术,用于检测穿过墙壁的水平穿墙(H-Clip)行为,即使起始和结束方块均为空气也能识别。
-
实施严格的终端速度限制,即时拦截垂直向下穿墙(V-Clip)行为。
-
清理 Maven
pom.xml依赖项,确保插件保持轻量级,避免引入不必要的 Geyser UI 库。 -
添加了可自定义的战斗计时器 UI 位置(操作栏、Boss 条、副标题)。
完整更新日志:
DEV-[1.9.5]-PACKET (2026-11-2)
仅限测试版本 - 尚未完成且正在积极测试中。使用风险自负!
更改与修复:
- 为实验性数据包速率、落地状态不匹配、移动和挥动顺序信号添加了可选的 PacketEvents 检查。这些功能默认关闭,旨在用于 Minecraft 1.21.11,且默认仅记录日志。
- 添加了可选的移动模拟器,用于实验性移动残差日志记录。
- 扩展了检测范围,包括悬停/无掉落、攻击距离、穿透方块、多目标战斗以及脚手架方块放置速率检查。
- 改进了移动处理逻辑和误报防护机制,包括传送和击退的宽限期,并调整了速度检测。
- 使战斗日志记录的惩罚在服务器重启后持续生效,并使被禁止战斗的命令可配置。
- 通过 SHA-256 验证提高了更新安全性;自动更新现已默认禁用。
- 重构了管理员绕过机制,改用
ava.bypass权限,并移除了秘密禁用命令。
查看完整提交
仅限测试构建 — 未完成且正在积极测试中。请自行承担使用风险!
更改与修复:
- 重构代码结构:将庞大的主 Java 文件拆分为有组织的独立文件。
- 修复了自动更新器错误标记版本号的问题。
- 优化速度检查的宽限期,以更好地处理玩家延迟。
- 在之前的更新中添加了 "/ac info <player> <true|false (显示权限)>" 命令,允许你输入玩家名称并获取关于他们的有用模组信息。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧