CheckHacks

插件

· 作者 Branduzzo

使用“签名翻译漏洞”检测服务器上的客户端模组和作弊客户端。

0 本站下载 0 关注 更新于 1 天前

最新 1.3.2 · 26.3 · Bukkit / Folia

一键开服(送7天)

通过模组追踪黑客。100% 服务端,无需客户端模组。

它利用了告示牌翻译漏洞(MC-265322),与 DonutSMP 用来抓捕作弊者的技巧相同。一个虚拟告示牌会被发送在玩家上方或下方,并在同一刻内打开并关闭编辑器,而不会在世界中放置真实的告示牌。


🆕 1.3.2 新增内容

  • 隐形告示牌探测 - 假告示牌放置在玩家上方或下方的空中,远离正常视野,并且编辑器会在同一刻内关闭。这消除了以往导致 GUI 可见的一刻延迟。
  • 更快的扫描 - between-sign-ticks 现在默认为 1 而不是 5。使用 DoubleCheck 进行完整检查现在只需几秒钟即可完成。
  • Minecraft 26.3 和 1.21.x 打包在同一个 jar 中 - 在 26.x 版本上,虚拟告示牌通过 PacketEvents 2.14 发送;在 1.21.x 上,相同的包通过小型 NMS/Netty 桥接器发送。不会放置真实的告示牌方块,编辑器会在同一刻内打开并关闭。
  • 内置 PacketEvents - 您不需要单独安装它。在 26.x 上,它需要随服务器提供的 Adventure 版本;1.21.x 桥接器没有外部依赖。
  • 规则是通用的 - 任何模组都可以拥有 command-rules 条目,result: ANY 匹配所有结果,并且可以从 Web 编辑器创建、编辑和删除规则。
  • 配置合并器 - 新键和新默认检测会添加到现有文件中,而不会触碰您的值。command-rules 由用户拥有,永远不会被重新添加。
  • Material 3 Web 编辑器 - 新的 Material 3 界面,包含浅色和深色主题,以及与服务端前缀匹配的黄色/绿色 CheckHacks 配色板,还有 Rules 页面和 Settings 页面,用于写入 config.yml 和 checkhacks.yml。
  • /chalerts 有三种状态 - all、only-detected 和 off。使用 alerts.default-mode 设置默认值。
  • Components V2 已修复 - Webhook 现在发送 ?with_components=true 并读取真实的 Discord 错误,因此 HTTP 400 错误已消失。
  • 玩家众多时更快 - 缓存反射、缓存告示牌组件、单个 webhook 队列、异步数据库写入和不可变配置快照。

❓ 那么 CheckHacks 是什么?

CheckHacks 是一个服务端反作弊插件,可以在玩家无需安装任何内容的情况下判断他们正在运行哪些模组。它是通过利用告示牌翻译漏洞(MC-265322)来实现的。

实际操作流程如下:

  1. 您启动检查,或者当有人加入或您的反作弊系统标记他们时自动开始
  2. 插件选择玩家上方或下方的空气方块,并向该位置发送一个虚拟告示牌,而不改变世界
  3. 在该告示牌上写入特殊的翻译键
  4. 他们的客户端打开告示牌编辑器,服务器在同一刻内关闭它
  5. 我们读取他们客户端返回的内容,并还原原始的客户端方块

每个模组都会注册自己的翻译键,因此原版客户端和模组客户端会有不同的响应。这种差异告诉我们确切安装了什么。

👀 加入扫描在地形加载期间运行并保持隐形。在游戏内扫描在正常情况下也是隐形的,因为编辑器会在同一刻内打开并关闭;在严重卡顿的客户端上,仍然可能出现一帧闪烁。

💡 一个告示牌最多可以检查 3 个模组。如果您有更多,我们只是依次发送它们。您可以自行设置延迟。


✨ 功能

🔍 检测

  • 完全在服务器端运行,你的玩家无需下载任何内容
  • 假告示牌放置在玩家上方或下方的空气中,而不是在其正常视线范围内
  • 编辑器在同一刻(tick)内打开并关闭,因此告示牌无法被阅读
  • 三种模式:METEOR、TRANSLATE、KEYBIND,每个模组会自动使用正确的模式
  • 如果有人启用了漏洞保护,他们会显示为 PROTECTED,而不是被错误地标记为干净(并非所有模组都适用此规则)
  • 如果有人完全不响应,他们也会被标记为 PROTECTED。他们可能正在屏蔽数据包
  • DoubleCheck 系统会对每个 DETECTED 或 PROTECTED 的结果进行二次扫描复查,从而减少误报
  • 开箱即用的更多检测 - Trouser Streak、Trouser Streak NewerNewChunks/AnHero、Ui Utils、SeedCrackerX、Simple World Downloader、Glazed、Litematica、Item Scroller、Xaero's Minimap、Baritone、LiquidBounce、Wurst 等均在下方表格中列出
  • 更少的误报 - 响应解析器处理空回复和 key + letter 的边界情况,并且针对 METEOR、TRANSLATE 和 KEYBIND 分别检查防漏洞逻辑。对 Bedrock、Geyser 和 Floodgate 的跳过也更可靠
  • 你可以在 checkhacks.yml 中添加自定义模组以进行检测
  • 如果 Bedrock 玩家的名称以你设置的前缀(如 . 或 *)开头,则会自动跳过

⚡ 自动化

  • 加入时自动检查,可配置延迟,并提供仅首次加入时运行的选项
  • 自动语言检查同理,同样提供仅首次加入时运行的选项
  • 直接挂钩到 Grim, Vulcan, Spartan 和 Matrix。如果它们标记了某人,我们会立即检查该玩家。
  • 每位玩家独立的冷却时间,避免自动检查造成刷屏
  • 你可以为普通检查、加入检查和反作弊检查设置不同的作弊列表
  • 当有人被 DETECTED、PROTECTED 或判定为干净时,执行你自己的命令;此外还支持按模组设置的 command-rules 并附带结果过滤器
  • command-rules 接受任何模组 ID 以及 result: ANY、DETECTED、NOT_DETECTED、PROTECTED 或 SKIPPED。全局命令会获得一个逗号分隔的所有被标记作弊的列表
  • 命令占位符:%player%、%hack%、&hack&、{hack}。如果找到两个作弊,&hack& 将变为 Meteor, Wurst;tempban %player% 7d Hack &hack& 可按预期工作

🔄 自动更新器

  • 启动时,我们会在后台检查 https://github.com/branduzzo/CheckHacks/releases/latest。如果你处于离线状态,我们只会跳过检查,控制台不会发送任何垃圾信息
  • 如果发现更新的 vX.Y.Z 版本,拥有 checkhacks.update 权限的玩家在加入时会看到一条消息:CheckHacks 1.3.2 is available! Click here to download. 该消息已在所有 messages/*.yml 文件中翻译完毕
  • 如果他们点击链接,系统将运行 /checkhacksupdate,将 CheckHacks-X.Y.Z.jar 下载到 plugins/ 目录,备份或删除旧 jar 包,并提示 Download completed! Restart the server
  • 你需要 checkhacks.update 权限才能查看消息并运行该命令。它已包含在 checkhacks.* 中,因此服务器管理员默认拥有此权限

⚡ 性能

  • 比 1.3.0 之前的调度程序快约 3 倍:告示牌的处理效率更高,且 between-sign-ticks 默认值为 1
  • SQLite with WAL,单个数据库连接,缓存的消息和缓存的反射对象,异步 Webhook 和异步数据库写入
  • 不可变配置快照,防止重载导致正在进行的检查中途更改
  • 针对 1.21.4 及以上版本 的 NMS 修复,使旧版桥接保持兼容,无需额外设置

📢 警报与结果

  • 结果发送给所有拥有 checkhacks.alerts 权限的玩家,任何人都可以通过 /chalerts 切换显示
  • 如果你启动了检查但没有警报权限,你仍会在私聊中收到结果,以免遗漏
  • 每一行都会告诉你模组名称及发生的情况:DETECTED、NOT_DETECTED、PROTECTED、SKIPPED
  • 我们还会显示是谁启动了检查以及原因,例如手动检查、加入检查或反作弊标记

🌐 Web 和 Discord

  • 内置 SQLite。每次扫描都会被保存,你无需进行任何设置
  • Web 编辑器直接在服务器上运行。你可以浏览历史扫描记录、查询玩家并从浏览器发起新的检查
  • 登录使用来自 /cheditor 的一次性令牌,无需记住密码
  • 两个独立的 Discord Webhook,一个用于作弊检查,一个用于语言检查,均启用 Components V2 开关
  • discord.use-components-v2: true 会发送带有强调色、Text Display 方块、分隔线和时间戳页脚的整洁 Container(flags: 32768)。设置为 false 则使用经典嵌入样式
  • 我们现在读取 Discord 的真实错误响应并发送 ?with_components=true,从而消除旧的 HTTP 400 错误
  • 可用的 Webhook 占位符:&name& &checker& &reason& &hacks& &results& &lang&

🎨 自定义

  • 配置文件清晰分离:config.yml 用于常规设置,checkhacks.yml 用于模组,checklang.yml 用于语言
  • doublecheck: true 运行第二次确认扫描;detect-flag.anticheats 允许独立启用 Grim、Vulcan、Spartan 和 Matrix
  • 每条消息都在其单独的文件中,你只需在配置中修改一行即可切换语言
  • 所有内容均支持 MiniMessage、自定义前缀和 PlaceholderAPI
  • 包含 9 种语言以及所有更新器字符串:update-available、update-downloading、update-complete、update-restart-required、update-failed、update-no-update
🌍 Languages included (click to expand)

en.yml · it.yml · de.yml · es.yml · fr.yml · pt.yml · br.yml · ru.yml · lolcat.yml · uwu.yml


🔍 Detected Mods

模组 模式
Meteor Client METEOR
LiquidBounce TRANSLATE
Freecam KEYBIND
Wurst Client (-1.21) KEYBIND
Aristois TRANSLATE
XRay (Fabric) KEYBIND
ChestESP KEYBIND
KillAura (Fabric) KEYBIND
AutoFish KEYBIND
Lumina KEYBIND
AutoSwitch KEYBIND
BleachHack TRANSLATE
Coffee Client TRANSLATE
World Downloader TRANSLATE
AutoClicker (Fabric) TRANSLATE
AntiAFK TRANSLATE
Baritone TRANSLATE
Auto Clicker (p1k0chu) KEYBIND
Trouser Streak TRANSLATE
Trouser Streak (NewerNewChunks) TRANSLATE
Trouser Streak (AnHero) TRANSLATE
Ui Utils TRANSLATE
SeedCrackerX TRANSLATE
Simple World Downloader TRANSLATE
Glazed TRANSLATE
Litematica TRANSLATE
Item Scroller TRANSLATE
Xaeros Minimap TRANSLATE

➕ 希望我们添加某个模组?加入我们的 Discord 并打开工单,我们会处理。


🎬 展示

▶️ 点击缩略图在 YouTube 上观看(3:13)。


⌨️ 命令

命令 功能
/checkhacks <player> 检查你配置的所有模组
/checkhacks <player> meteor-client,freecam 仅检查你列出的模组
/checklang <player> 尝试通过告示牌判断其客户端语言
/checklang <player> en_us,it_it 仅检查这些语言
/cheditor 给你一个一次性链接以访问网页编辑器
/chalerts 循环切换警报:all -> only-detected -> off (也支持 /checkalerts、/alerts 或 /chalerts only-detected)
/checkhacksupdate 获取 GitHub 上的最新 CheckHacks 版本 (需要 checkhacks.update 权限) - 只需点击更新消息即可
/chreload 重新加载所有配置,无需重启服务器

🔑 权限

权限 用途
checkhacks.check 允许你运行作弊检测
checkhacks.checklang 允许你运行语言检测
checkhacks.reload 允许你重新加载配置
checkhacks.alerts 允许你接收警报并切换它们的状态
checkhacks.editor 允许你创建网页编辑器的令牌
checkhacks.update 允许你查看更新通知并运行 /checkhacksupdate
checkhacks.* 授予以上所有权限

⚙️ 配置

plugins/CheckHacks/
├── config.yml          # 常规设置、alerts.default-mode、Discord、网页编辑器
├── checkhacks.yml      # 作弊检测、自定义模组列表、detect-flag、command-if-*、command-rules、doublecheck、matrix
├── checklang.yml       # 语言检测 + discord.use-components-v2
├── messages/
│   ├── en.yml          # 英文消息以及所有 update-* 键
│   ├── it.yml          # 意大利文
│   └── ...             # de, es, fr, br, ru, lolcat, uwu
└── database.db         # 扫描历史,它会自动生成

你实际会用到的内容

# config.yml and checklang.yml
discord:
  use-components-v2: true # false 给你经典嵌入框,true 给你新的 Components V2 容器
alerts:
  default-mode: "all" # all, only-detected 或 off

# checkhacks.yml
detect-flag:
  anticheats: { grim: true, vulcan: true, spartan: true, matrix: true }
doublecheck: true
timeout-ticks: 200
between-sign-ticks: 1 # 1 是最快;仅在服务器需要时增加此值
command-if-positive: { enabled: false, command: "tempban %player% 14d Cheating &hack&" }
command-rules:
  meteorclient1: { mod: meteorclient, result: DETECTED, command: "tempban %player% 31d Meteor &hack&" }
  freecam1: { mod: freecam, result: ANY, command: "alert %player% freecam" }
# mod 可以是任何作弊 ID,result 可以是 ANY, DETECTED, NOT_DETECTED, PROTECTED 或 SKIPPED
# 你可以使用 %player%, %hack%, &hack&, {hack}, {player} - 它们都有效
  • detect-flag.anticheats.matrix: true 启用 Matrix 钩子;Grim、Vulcan 和 Spartan 在旁边有各自的开关
  • doublecheck 会重复执行一次任何 DETECTED 或 PROTECTED 的批量检测,这在繁忙的服务器上很有用
  • discord.use-components-v2 在 Components V2 容器和经典嵌入框之间切换
  • command-rules 可以从网页编辑器完全编辑,因此你不必为了针对特定模组的惩罚而修改 YAML

🖥️ 网页编辑器

网页编辑器直接运行在你的服务器上,你不需要将其托管在其他地方。

  • 📊 浏览所有的旧扫描记录和结果
  • 👤 查找你之前检查过的玩家
  • ▶️ 直接从浏览器启动新的检测
  • 🌍 同时检查语言检测结果
  • 📜 创建、编辑和删除命令规则,无需触碰 YAML
  • ⚙️ 更改警报、检测和 Discord 设置
  • 🔐 它被锁定在一次性令牌之后,来自 /cheditor,因此没有共享密码

⚠️ 注意

模组开发者可以随时修补他们的客户端并试图阻止这种技巧。如果他们这样做,对该特定客户端的检测可能会暂时失效。我们会持续追踪补丁,寻找绕过方法,并在模组推出时添加新的检测。

这是一场猫鼠游戏,而不是一次性修复。


☕ 支持我

CheckHacks 将永远免费。如果它帮助你的服务器免受作弊者侵害,并且你想表示感谢,你可以在 PayPal 上请我喝咖啡。每一笔捐赠都能让这个项目继续下去,并帮助我在那些模组补丁面前保持领先。


📜 致谢与支持

由 Branduzzo 制作。

需要帮助、想要请求功能或需要添加模组?来 Discord 逛逛:


如果 CheckHacks 正在帮助你的服务器,请在仓库中留下一个 ⭐,这意义重大!

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源