? FakeModBlocker
一款轻量级、完全可自定义且跨版本友好的模组检测插件,通过监听插件频道来识别 Xaero's World Map、Replay Mod 等模组,以及 Fabric、Forge 等已知加载器。
它还在支持的服务端实现上提供了一个可选的高级告示牌翻译键检测模块。
✨ 功能特性
✅ 轻量级 —— 零额外开销
✅ 通过 messages_xx.yml 完全自定义消息和行为
✅ 支持 1.16+ 服务器的十六进制颜色代码(例如 �ffcc)
✅ 无依赖项 —— 即插即用
✅ 广泛兼容各种服务端版本(1.8–1.21.11+)
✅ 多语言支持(en、cn 及你自己的语言)
✅ 支持重载:/modblocker reload
✅ 支持 Spigot / Paper / Purpur / Folia / PandaSpigot
✅ 在支持的服务端 API 上提供可选的高级告示牌翻译键检测
? 检测原理
FakeModBlocker 内置两个独立的检测器。了解每个检测器捕获哪种类型的模组对于正确配置至关重要:
| 检测器 | 匹配依据 | 捕获范围 |
|---|---|---|
forbiddenList |
插件频道名称,例如 xaeroworldmap、servux:tweaks |
与服务器建立插件频道的模组(大多数与服务器通信的 Forge/Fabric 模组、Xaero、基于 Servux 的模组、Axiom 等) |
extra-detections.sign-translation.mods |
客户端翻译键,例如 key.freecam.toggle |
纯客户端模组,从不打开频道——大多数作弊客户端、HUD 模组、小地图、仅绑定按键的工具类模组 |
常见错误: 将模组的显示名称放入 forbiddenList 并期望它能捕获纯客户端模组。如果模组没有注册插件频道,forbiddenList 无法检测到它——你必须在 sign-translation.mods 下添加其翻译键之一。首次启用该模组时,客户端发送的每个频道和插件消息都会打印到控制台,以便你可以从中复制真实的频道名称。
自 1.7.0 版本起,可以通过 detect.keys: [...] 为单个模组指定多个翻译键——这对于暴露多个按键绑定或键名在不同版本间发生变化的模组非常有用。
? 告示牌翻译要求
虚拟告示牌检测器需要 Player#openVirtualSign(Position, Side),该方法于 1.21.5 添加到 Paper API 中。Paper 1.21.4 及更早版本、Spigot、Pufferfish / Leaves 等服务端缺少此方法,因此该功能会在启动时自动禁用,并精确打印缺失的类或方法。基于频道的检测、PacketEvents 集成以及 Flo...
? 检测模式
1. 插件频道检测
这是主要的检测方法,在 widest range of versions(最广泛的版本范围)内有效。
它检查玩家加入时正在监听的 Plugin Message Channels(插件消息频道)。
许多模组客户端(例如 Fabric / Forge 及部分实用工具模组)会自动注册自定义频道,本插件可以检测并对此作出响应。
2. 可选告示牌翻译检测
这是一个额外的可选检测模块。
它通过打开带有特定翻译键的告示牌编辑器,并检查客户端是否对这些键进行翻译,从而揭示某些模组的 presence(存在性)。
⚠️ 此功能依赖于服务端打开告示牌编辑器的 API 支持。
如果当前服务端版本/实现不支持所需的公共 API,FakeModBlocker 将自动禁用此功能并安全跳过。
⚠️ 重要提示
⚠️ FakeModBlocker 并不能检测所有模组或作弊工具。
它仅在客户端暴露了可检测内容(如已知的插件消息频道或支持的翻译键行为)时生效。
⚠️ 不应将此插件视为完整的反作弊系统或通用模组检测器。
⚠️ 可选的告示牌翻译检测是额外的增强功能,而非主要检测系统。
这使得 FakeModBlocker 非常适合检测模组加载器的休闲使用或某些实用模组,但应不要将其视为完整的反作弊/模组屏蔽解决方案。
? 安装
- 将
.jar文件放入plugins/目录 - 启动服务器以生成配置文件
- 编辑
config.yml和你的语言文件 - 使用
/modblocker reload即时应用更改 config.yml中预配置了一些模组,你可以根据服务器规则自由修改它们
⚙️ 兼容性
- 主插件频道检测设计为广泛兼容 1.8–1.21.11+
- 可选的告示牌翻译检测需要兼容的服务端 API
- 在不支持的版本/服务端实现上,告示牌检测模块将自动禁用
- 通过兼容的调度处理支持 Folia
❓ 常见问题
Q: 这能检测像 Vape 或 LiquidBounce 这样的作弊客户端吗?
A: 不能。这些客户端通常会避免使用可检测的插件消息频道。本插件最适合用于检测 Fabric、Forge、Lunar 等模组加载器,以及在支持的服务端上某些基于可配置翻译键的模组检测。
Q: 这是一个反作弊插件吗?
A: 不是。这是一个模组存在检测器,而非作弊检测系统。
Q: 它是如何工作的?
A: 其主要方法是检查玩家加入时正在监听的 Plugin Message Channels(插件消息频道)。许多模组客户端会自动注册自定义频道,本插件可以检测到这些频道。
此外,在支持的服务端 API 上,它可以可选地使用告示牌翻译键检测来进行某些可配置的模组签名检测。
Q: 告示牌检测在所有版本上都有效吗?
A: 不是。告示牌检测模块依赖于公共告示牌编辑器 API 的支持。(抱歉我没有足够的时间测试每一个版本,但我猜它应该能在所有 Paper 服务端上工作)。如果服务端不支持,FakeModBlocker 将自动跳过该模块而不会导致插件崩溃。
? FakeModBlocker
A lightweight, fully customizable, and cross-version friendly mod detection plugin that monitors plugin channels to identify some mods like Xaero's World Map, Replay Mod, and known mod loaders such as Fabric, Forge, and more.
It also supports an optional advanced sign translation detection module on supported server implementations.
✨ Features
✅ Lightweight — zero unnecessary overhead
✅ Fully customizable messages and behavior via messages_xx.yml
✅ Hex Color Code support for 1.16+ servers (e.g. �ffcc)
✅ No dependencies — drop-in and go
✅ Works across a wide range of server versions (1.8–1.21.11+)
✅ Multi-language support (en, cn, and your own language)
✅ Reload support: /modblocker reload
✅ Spigot / Paper / Purpur / Folia / PandaSpigot support
✅ Optional advanced sign translation key detection on supported server APIs
? How detection actually works
FakeModBlocker ships two independent detectors. Knowing which one catches which type of mod is critical to configuring it right:
| Detector | Matches on | Catches |
|---|---|---|
forbiddenList |
Plugin-channel names, e.g. xaeroworldmap, servux:tweaks |
Mods that open a plugin channel with the server (most Forge/Fabric mods that talk to the server, Xaero, Servux-based, Axiom, etc.) |
extra-detections.sign-translation.mods |
Client-side translation keys, e.g. key.freecam.toggle |
Purely client-side mods that never open a channel — most cheat clients, HUD mods, minimaps, keybind-only utilities |
Common mistake: putting a mod's display name into forbiddenList and expecting it to catch a client-side mod. If the mod doesn't register a plugin channel, forbiddenList cannot see it — you must add one of its translation keys under sign-translation.mods instead. Enabl server once with the mod: every channel andplugin message the client sends is printed to console, so you can copy the real channel name from there.
Since 1.7.0, a single sign-translation.modseys** via detect.keys: [...]` — useful formods that expose several keybinds or whose key names change between versions.
? Sign-translation requirements
The virtual-sign detector needs Player#openVirtualSign(Position, Side), which was added to the Paper API in 1.21.5. Paper 1.21.4 and older, Spigot, / Pufferfish / Leaves) don't have thismethod, so the feature auto-disables at startup and prints exactly which class or method is missing. Channel-based
detection, PacketEvents integration, and Flo
? Detection Modes
1. Plugin Channel Detection
This is the main detection method and works across the widest range of versions.
It checks which Plugin Message Channels the player is listening on when they join.
Many mod clients (e.g. Fabric / Forge and some utility mods) automatically register custom channels, which this plugin can detect and respond to.
2. Optional Sign Translation Detection
This is an extra optional detection module.
It works by opening a sign editor with specific translation keys and checking whether the client translates them, which may reveal the presence of certain mods.
⚠️ This feature depends on server API support for opening sign editors.
If the current server version / implementation does not support the required public API, FakeModBlocker will automatically disable this feature and skip it safely.
⚠️ Important Notes
⚠️ FakeModBlocker does NOT detect all mods or cheating tools.
It only works when the client exposes something detectable, such as known plugin message channels or supported translation-key behavior.
⚠️ This plugin should NOT be treated as a full anti-cheat or universal mod detector.
⚠️ The optional sign translation detection is an additional enhancement, not the main detection system.
This makes FakeModBlocker ideal for detecting casual use of mod loaders or certain utility mods, but it should not be treated as a complete anti-cheat / mod-blocking solution.
? Installation
- Drop the
.jarintoplugins/ - Start the server to generate config files
- Edit
config.ymland your language file - Use
/modblocker reloadto apply changes instantly - Some mods are pre-configured in
config.yml, and you can freely modify them to match your server rules
⚙️ Compatibility
- Main plugin channel detection is designed to be broadly compatible with 1.8–1.21.11+
- Optional sign translation detection requires a compatible server API
- On unsupported versions / server implementations, the sign detection module will be disabled automatically
- Folia is supported through compatible scheduler handling
❓ FAQ
Q: Can this detect hacked clients like Vape or LiquidBounce?
A: No. Those clients often avoid using detectable plugin message channels. This plugin is best used to detect mod loaders like Fabric, Forge, Lunar, etc., and some configurable translation-key based mod detections on supported servers.
Q: Is this an anti-cheat?
A: No. This is a mod presence detector, not a cheat detection system.
Q: How does it work?
A: Its main method is checking which Plugin Message Channels the player is listening on when they join. Many mod clients automatically register custom channels, which this plugin can detect.
Additionally, on supported server APIs, it can optionally use sign translation key detection for certain configurable mod signatures.
Q: Does the sign detection work on every version?
A: No. The sign detection module depends on public sign editor API support (Sorry i don't have much time to test every single version, but it should work on every Paper server i guess). If the server does not support it, FakeModBlocker will automatically skip that module without breaking the plugin.
下载 FakeModBlocker
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 FakeModBlocker
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 FakeModBlocker
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 FakeModBlocker
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 FakeModBlocker
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 FakeModBlocker
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 FakeModBlocker
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 FakeModBlocker
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 FakeModBlocker
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 FakeModBlocker
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
修复基岩版支持
v1.10.0 — Discord 通知
✨ 新增:可选的 Discord 通知
检测事件现在可以镜像到 Discord 频道,通过 DiscordSRV 进行路由。
默认关闭,且无任何捆绑依赖。 jar 包中仅包含本插件自身的类——没有阴影 HTTP 客户端、没有 JDA、也没有额外的兆字节。与 DiscordSRV 通信的那个类仅在启用该功能 且 安装了 DiscordSRV 时才会加载,这与现有的 PacketEvents 和告示牌检测桥接机制完全一致。在未安装 DiscordSRV 的服务器上,一切保持不变。
启用方法:
discord:
enabled: true
channel: "" # "" = DiscordSRV 主频道 | 游戏内频道名称 | 原始频道 ID
然后执行 /modblocker reload 和 /modblocker discord test。
发布的内容——每项均可单独关闭:
┌───────────────────┬─────────────────────────────────────────────┐
│ 事件 │ 触发条件 │
├───────────────────┼─────────────────────────────────────────────┤
│ channel-detection │ 禁止列表中的插件频道匹配成功 │
├───────────────────┼─────────────────────────────────────────────┤
│ sign-detection │ 告示牌翻译键返回了已翻译的结果 │
├───────────────────┼─────────────────────────────────────────────┤
│ escalation │ 应用了升级阶梯的一级 │
├───────────────────┼─────────────────────────────────────────────┤
│ evade │ 告示牌检查无法完成 │
└───────────────────┴─────────────────────────────────────────────┘
一次检测对应一条消息。当升级阶梯将某次检测“升级”时,会发布升级消息,而跳过单次检测消息——你不会因为同一次登录收到两条帖子。操作为 IGNORE 的检测保持静默,除非你设置 include-ignored: true。
消息文本在 messages_<lang>.yml 下的 discord: 部分进行模板化,因此遵循你的 language: 设置,与其他内容一样。支持 Discord Markdown;Minecraft 颜色代码会自动剥离。
不会意外触发 @提及。当 discord.mention 为空时,@提及功能处于禁用状态——即使 mod 名称或踢出理由中出现了 @everyone,也会渲染为纯文本,而不会向服务器发出警报。
无性能开销。DiscordSRV 的 JDA 负责请求队列、速率限制和重试,因此本插件中没有队列或后台线程,所有调用均立即返回。缓慢或不可达的 Discord 永远不会延迟玩家加入。
? 新命令
/modblocker discord test —— 通过真实的桥接器和真实的频道解析发送测试消息,并明确告知你为何未发送成功(DiscordSRV 仍在连接 / 未找到频道 / 未安装 DiscordSRV)。
? 文档
Java 21 要求现在已在 readme 和文档网站中声明,而不仅仅是在插件页面上。
⬆️ 升级
现有的 config.yml 不会被覆盖,因此它目前尚不包含 discord: 部分。缺失该部分即表示“关闭”——不会导致任何故障。要使用该功能,请将文档中的 discord: 块复制到你自己的 config.yml 中并重新加载。语言文件不受影响:缺失的条目会回退到 jar 包中捆绑的副本,因此无需修改 messages_*.yml 即可使用新的消息模板。
⚙ 要求
保持不变——FakeModBlocker 使用 Java 21 编译。运行此插件需要 Java 21 或更高版本。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧