Hawk Anticheat (MC 1.7.10 & 1.8.8) - Hawk Anticheat - 老版本反作弊插件

Hawk 是一款面向 Spigot 服务器的反作弊插件，旨在验证并确保玩家的行为符合原版 Minecraft 的逻辑规则。它专注于支持较旧但仍流行的 Minecraft 版本（如 1.7.10），并提供强大的作弊检测功能。

💡重要声明

Hawk 不 且 永远不会 支持 Minecraft 1.9 及以上版本。

> 此项目已不再积极开发。我尚未找到继续开发的动力，并决定继续我的生活。对于可能带来的任何不便，我深表歉意。

❓什么是 Hawk Anti-Cheat？

Hawk 是一款 Spigot 服务器的反作弊插件。它试图验证并强制玩家的行为遵循原版 Minecraft 的逻辑。此外，它还尝试检测某些形式的输入伪造。

✨为什么选择 Hawk？

• 专注于支持旧版 Minecraft（如 1.7.10），为这些版本提供全面的反作弊解决方案。
• 发现绕过漏洞将成为最高优先级的修复任务。
• 包含 29 个检测模块，覆盖战斗、交互、移动和协议层面的恶意利用。
• 检查仅观察玩家行为并收集统计数据，不会通过生成 NPC 或施加击退等方式干扰游戏体验。

⭐核心特性

网络级检查

• 默认在网络线程上执行检查，实现精确检测且不显著增加主线程负载。高流量时不会降低 TPS。

异步检查能力

• 可为追求性能的用户在独立线程上运行，与网络线程分离。虽然这会失去实时阻止作弊的能力，但对流量极高的服务器有益。

无依赖

• 完全无需任何依赖，直接利用 Netty 和 NMS 代码。告别 ProtocolLib。

免费开源

• 完全免费、开源，并采用 GPLv3 许可证。您可以自由修改或为项目做贡献。

简单而强大的框架

• 框架允许开发者轻松实现新检查并利用强大的工具。

移动检查

• 严格的移动检查，阻止 B-Hop、Y-Port、穿墙等常见反作弊绕过手段。

战斗检查

• 出色的战斗作弊检测。除了阻止大多数战斗作弊，还能在不使用 NPC 或机器学习的情况下，一分钟内检测到基础的触发器和自瞄，几秒内检测某些客户端的杀戮光环。

鼠标记录功能

• 记录并绘制玩家鼠标移动轨迹，帮助管理员手动识别战斗作弊者。

详细配置

• 提供高度自由的配置，可启用/禁用检查、编辑具体数值、修改提示信息和惩罚执行方式。

BungeeCord 支持

• 通过 HawkAlertsBungee 可将 Hawk 的违规标记转发给 BungeeCord 网络中其他 Spigot 服务器的管理员。

SQL 支持

• 支持将日志记录到 SQL 数据库服务器，便于多服务器网络更高效地追踪违规行为。

🎮检测或阻止的作弊类型

移动类

• Speed
• Tickrate
• Fly
• Glide
• NoSlowDown
• Jesus
• Packet sneak
• Phase
• Spider
• Blink
• V-Clip
• Scaffold
• Anti-velocity
• NoFall
• Strafe
• Omnidirectional sprint

交互类

• Nuker
• GhostHand
• 任何其他穿墙或视线外交互的作弊
• Usage Speed

战斗类

• Reach
• Angle
• High CPS
• Forcefield
• Fast Bow
• Killaura
• Criticals
• Aimbot（一定程度）

🔧命令与权限

命令

• /hawk - 显示菜单和 GUI
• /hawk kick <player> <reason> - 踢出玩家（推荐用于自动踢出）
• /hawk talerts - 切换警报接收
• /hawk mouserec <player> [duration in seconds] - 记录玩家的鼠标移动
• /hawk reload - 重载配置和模块
• /hawk unmute - 解除被 Hawk 禁言的玩家
• /hawk unban - 解除被 Hawk 封禁的玩家

权限

• hawk.admin - 绕过踢出和封禁
• hawk.cmd - 使用 /hawk 命令
• hawk.cmd.* - 使用所有管理命令
• hawk.cmd.<command name> - 使用特定管理命令
• hawk.alerts - 接收警报
• hawk.bypass.<check> - 绕过特定检查
• hawk.bypass.* - 绕过所有检查
• hawk.gui - 访问图形用户界面

🔧开发者相关

目前 Hawk 没有正式的“API”，但开发者仍可以与反作弊代码进行交互。请注意，已实现的代码可能在不同版本间无预警地变更（类似于 NMS 代码）。

获取插件实例

Hawk hawkPlugin = (Hawk)Bukkit.getPluginManager().getPlugin("Hawk");

获取实例后，您可以探索类底部附近的 getter 方法以使用各种有用的方法和模块。

• 源代码链接：Hawk.java
• 可用的 Bukkit 事件：bukkit 事件目录

🔧安装与要求

安装步骤

• 下载后，将 jar 文件放入服务器根目录的 plugins 文件夹。
• 启动或重载服务器以启用 Hawk Anti-Cheat。
• 如有需要，修改 plugins/Hawk/config.yml 中的配置。重启或重载服务器以应用更改。

要求

• Java 8 或更高版本
• Spigot 1.7.10 或 1.8.8

💡不兼容项

Hawk Anti-Cheat 可能与以下情况不兼容：

• 网络修改
• 在 Hawk 于通道管道中的位置之前，拦截和修改入站数据包。
• 在 Hawk 于通道管道中的位置之后，拦截和修改出站数据包。
• 发送数据包使客户端与服务器不同步（例如假实体、假方块等。若玩家尝试与之交互，会触发误报）。
• 其他反作弊插件
• 任何非 1.7.X 和 1.8.X 版本的 Minecraft 客户端
• 因此强烈不建议使用 ProtocolSupport、ViaVersion 等。
• 客户端游戏逻辑修改
• 修改客户端的移动或与地形、实体的交互。
• 服务器过载（TPS 平均值低于 20）或客户端过载（FPS/TPS 低于 20）
• 服务器与客户端连接质量差

❓常见问题解答

如何编辑检查配置？

所有检查的配置都在 Hawk 文件夹的 checks.yml 文件中。每个检查至少有几个选项。以 Inertia 检查为例：

inertia:
  enabled: true
  cancelThreshold: 0
  flagThreshold: -1
  vlPassMultiplier: 0.995
  flagCooldown: 5000
  punishCommands: []

• enabled (布尔值)：启用/禁用检查。
• cancelThreshold (整数)：玩家达到此最低违规等级 (VL) 时，检查将丢弃玩家的动作。设为 -1 以禁用。
• flagThreshold (整数)：玩家达到此最低 VL 时，检查将向管理员发送警报。
• vlPassMultiplier (浮点数)：玩家通过检查时，其 VL 乘以的值（应在 0 到 1 之间，使 VL 指数衰减）。
• flagCooldown (整数)：检查发送关于玩家的警报前必须等待的最短时间间隔（毫秒），用于减少聊天刷屏。
• punishCommands (字符串列表)：包含要执行的命令列表。某些检查可能有额外的配置选项。

如何设置 Hawk 在违规时执行命令？

在 checks.yml 文件中，每个检查都有一个名为 punishCommands 的字符串列表。每个条目由冒号分隔为三部分：违规等级 : 延迟秒数 : 要运行的命令。

以飞行检查为例

fly:
  enabled: true
  cancelThreshold: 0
  flagThreshold: 0
  vlPassMultiplier: 0.995
  flagCooldown: 0
  punishCommands:
    - "10:0:msg %player% stop hacking"
    - "20:0:kick %player%"

您可以使用占位符，如 %player%、%tps%、%vl% 和 %check%。

如何设置封禁/惩罚波？

Hawk 提供了一个名为“惩罚调度器”的功能。可以使用命令 /hawk punish 访问。您可以在 config.yml 中配置它。示例配置：

punishmentScheduler:
  enabled: true
  command: ban %player% %reason%
  defaultReason: Illegal game modification
  schedule: 'SUNDAY * 32'
  ignoreIfServerOverloaded: true
  pingThreshold: -1
  requireAuthorization: false
  autoSave: true

• requireAuthorization：启用后，强制管理员在 Hawk 惩罚玩家前运行 /hawk punish authorize <player>。
• schedule：系统运行的时间表。第一个参数是星期几，第二个是小时 (0-23)，第三个是分钟 (0-59)。使用 * 表示任意值。在此例中，系统将在每个星期日的每个小时的第 32 分钟运行。

🔧支持与反馈

• 演示视频：请查看原帖或相关链接。
• 问题、支持、错误报告和讨论：请通过私信、讨论帖、Discord（点击下方标志加入）或 GitHub 提交问题与我联系。
• 欢迎发表评论。如需支持，请通过上述方式联系。请不要在评论中发布错误信息，包含错误的评论令人困扰，并可能被版主移除。