ModDetector

插件

· 作者 ramenrrami

一个简单且支持 Folia 的 ModDetector Paper 插件,可检测玩家是否安装了模组,并在检测到后将其踢出服务器。

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

需要前置:PacketEvents

最新 ModDetector-1.0.1 · 26.1.2 · Bukkit / Folia

一键开服(送7天)

ModDetector

基于数据包层面的作弊模组检测,适用于 Minecraft 服务器。通过利用翻译键漏洞来识别不允许的客户端修改——无需任何客户端代理。


工作原理

该插件利用 Minecraft 的告示牌编辑流程来探测客户端的翻译表。如果安装了模组,它会用自己的字符串替换翻译键——从而暴露其存在。

检测流程(在连接时):

  1. 发送一个 BlockUpdatePacket 在玩家附近放置一个虚拟告示牌
  2. 发送一个 OpenSignEditorPacket,在客户端打开告示牌编辑器
  3. 发送一个 SignUpdatePacket,其中包含模组的翻译键作为告示牌文本
  4. 客户端将告示牌内容回显回来——如果值与默认回退值不同,则说明存在该模组

整个握手过程对玩家不可见,且在连接时静默发生。不会显示 GUI,检测过程中也不会发送聊天消息。


已检测的模组

以下模组开箱即用即被屏蔽。你可以在 config.yml 中扩展列表。

Mod Translation Key
Meteor Client key.meteor-client.open-gui
Item Scroller itemscroller.gui.button.config_gui.generic
Freecam key.freecam.toggle
Accurate Block Placement text.autoconfig.accurateblockplacement.title

配置

所有设置都位于 plugins/ModDetector/config.yml 中。

# 用于检测模组存在的回退值
default: "fallb"

# 检测到模组时向玩家显示的消息
# 支持 MiniMessage、现代 & 和传统 ampersand 代码
kick-message:
  - "&cYou are using a cheat mod that is not allowed on [Your Server] (%mod%!), if you join"
  - "with this again you will be banned!"

# 要检测的模组翻译键
disallowed-mods:
  "Meteor": "key.meteor-client.open-gui"
  "Item Scroller": "itemscroller.gui.button.config_gui.generic"
  "Freecam": "key.freecam.toggle"
  "Accurate Block Placement": "text.autoconfig.accurateblockplacement.title"

# 启用数据包和结果日志记录以便调试
debug: false

颜色代码支持

kick-message 字段支持所有三种 Minecraft 颜色系统:

  • MiniMessage — <red>, <#ff4455>
  • 现代 ampersand — &c, &#ff4455
  • 传统 ampersand — &c, &x&f&f&4&4&5&5

添加自定义模组

任何注册了 Minecraft 翻译键的模组都可以被检测。在模组的语言文件中找到该键(通常在 assets/<modid>/lang/en_us.json 中),并将其添加到 disallowed-mods:

disallowed-mods:
  "Your Mod Name": "your.mod.translation.key"

注意: default 字段必须设置为一个 永远不会 是有效翻译输出的字符串——默认的 "fallb" 对于原版客户端是安全的。除非你理解检测逻辑,否则不要更改它。


要求

Requirement Version
Paper / Spigot 1.19+
PacketEvents Latest
Java 17+

安装

  1. 下载并将 ModDetector.jar 放入你的 plugins/ 文件夹
  2. 下载 PacketEvents 并同样将其放入 plugins/
  3. 启动服务器——config.yml 将自动生成
  4. 编辑 config.yml 以配置踢出消息和禁止的模组
  5. 使用 /reload 重新加载或重启服务器

灵感来源于 PvPClub 的检测方法。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源