ModDetectorPlugin
一个 Paper 插件,通过插件消息通道检测和管理工作区客户端模组。服务器管理员可以配置允许或阻止的模组,并支持踢出玩家、记录检测日志或同时执行这两种操作。
功能
- 模组检测 - 自动检测注册了插件消息通道的客户端模组
- 灵活过滤 - 支持白名单或黑名单模式,实现精细控制
- 可配置动作 - 踢出玩家、记录检测日志,或两者兼有
- 已知模组数据库 - 为流行模组预配置的检测模式
- 自定义模式 - 添加带有通配符支持的自定义通道模式
- 管理员通知 - 检测到模组时实时警报
- 检测日志记录 - 将所有检测记录到文件中以供审查
- MiniMessage 支持 - 使用格式化内容的自定义踢出消息
要求
- Paper 1.21 或更高版本
- Java 21 或更高版本
安装
- 下载最新版本的 JAR 文件
- 将其放入服务器的
plugins/文件夹中 - 重启服务器
- 在
plugins/ModDetectorPlugin/config.yml中配置插件
命令
| 命令 | 描述 | 权限 |
|---|---|---|
/moddetector |
显示帮助信息 | moddetector.admin |
/moddetector reload |
重新加载配置 | moddetector.admin |
/moddetector status |
显示当前状态 | moddetector.admin |
/moddetector mods |
列出已知的模组定义 | moddetector.admin |
/moddetector debug |
显示调试状态 | moddetector.admin |
别名: /md
权限
| 权限 | 描述 | 默认值 |
|---|---|---|
moddetector.admin |
访问管理员命令 | OP |
moddetector.notify |
接收检测通知 | OP |
moddetector.bypass |
绕过模组检测(不会被踢出) | false |
可用模组
以下模组 ID 已在 mods.yml 中预配置:
| ID | 模组名称 | 描述 |
|---|---|---|
xaeros-worldmap |
Xaero's World Map | 全地图模组 |
xaeros-minimap |
Xaero's Minimap | 小地图模组 |
jade |
Jade | 方块/实体信息叠加层 |
journeymap |
JourneyMap | 实时地图模组 |
litematica |
Litematica | 蓝图模组(通过 Servux) |
minihud |
MiniHUD | HUD 叠加层模组(通过 Servux) |
servux |
Servux | 服务端数据提供者 |
simple-voice-chat |
Simple Voice Chat | 语音聊天模组 |
noxesium |
Noxesium | 性能/功能模组 |
flashback |
Flashback | 回放录制模组 |
appleskin |
AppleSkin | 食物/饥饿感 HUD 附加项 |
检测日志记录
当 track-detections: true 时,所有检测都会记录到 plugins/ModDetectorPlugin/detections.txt 文件中:
[2025-01-15 14:30:22] uuid-here | PlayerName | Xaero's World Map, Jade
工作原理
ModDetectorPlugin 监控客户端连接时注册的插件消息通道。许多客户端模组会注册通道以与服务器通信,即使服务器没有相应的插件。通过检测这些通道注册,该插件可以识别玩家正在使用的模组。
ModDetectorPlugin
A Paper plugin that detects and manages client-side mods through plugin message channels. Server administrators can configure which mods are allowed or blocked, with options to kick players, log detections, or both.
Features
- Mod Detection - Automatically detects client mods that register plugin message channels
- Flexible Filtering - Whitelist or blacklist mode for granular control
- Configurable Actions - Kick players, log detections, or both
- Known Mod Database - Pre-configured detection patterns for popular mods
- Custom Patterns - Add your own channel patterns with wildcard support
- Admin Notifications - Real-time alerts when mods are detected
- Detection Logging - Track all detections to a file for review
- MiniMessage Support - Customizable kick messages with formatting
Requirements
- Paper 1.21 or higher
- Java 21 or higher
Installation
- Download the latest release JAR
- Place it in your server's
plugins/folder - Restart your server
- Configure the plugin in
plugins/ModDetectorPlugin/config.yml
Commands
| Command | Description | Permission |
|---|---|---|
/moddetector |
Show help | moddetector.admin |
/moddetector reload |
Reload configuration | moddetector.admin |
/moddetector status |
Show current status | moddetector.admin |
/moddetector mods |
List known mod definitions | moddetector.admin |
/moddetector debug |
Show debug status | moddetector.admin |
Alias: /md
Permissions
| Permission | Description | Default |
|---|---|---|
moddetector.admin |
Access to admin commands | OP |
moddetector.notify |
Receive detection notifications | OP |
moddetector.bypass |
Bypass mod detection (won't be kicked) | false |
Available Mods
The following mod IDs are pre-configured in mods.yml:
| ID | Mod Name | Description |
|---|---|---|
xaeros-worldmap |
Xaero's World Map | Full world map mod |
xaeros-minimap |
Xaero's Minimap | Minimap mod |
jade |
Jade | Block/entity information overlay |
journeymap |
JourneyMap | Real-time mapping mod |
litematica |
Litematica | Schematic mod (via Servux) |
minihud |
MiniHUD | HUD overlay mod (via Servux) |
servux |
Servux | Server-side data provider |
simple-voice-chat |
Simple Voice Chat | Voice chat mod |
noxesium |
Noxesium | Performance/feature mod |
flashback |
Flashback | Replay recording mod |
appleskin |
AppleSkin | Food/hunger HUD additions |
Detection Logging
When track-detections: true, all detections are logged to plugins/ModDetectorPlugin/detections.txt:
[2025-01-15 14:30:22] uuid-here | PlayerName | Xaero's World Map, Jade
How It Works
ModDetectorPlugin monitors plugin message channels that clients register when connecting. Many client-side mods register channels to communicate with servers, even if the server doesn't have a corresponding plugin. By detecting these channel registrations, the plugin can identify which mods a player is using.
下载 Mod Detector Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Mod Detector Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Mod Detector Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Mod Detector Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Mod Detector Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Mod Detector Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Mod Detector Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Mod Detector Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Mod Detector Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Mod Detector Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
- 新增玩家豁免、历史记录工具、规则预览和临时例外功能。
- 扩展模组检测,并修复日志记录与踢出问题。
- 验证了在 Velocity 4.2.0 上对 Minecraft 26.3 的支持。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
ExyliaPlugins 的库。
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
一个在游戏内运行的 Minecraft 地图编辑器! 支持选区、蓝图、复制粘贴、笔刷和脚本。 可在创造模式中使用,也可在生存模式中临时使用。
插件
创建用户友好的菜单以前往不同的世界
插件
专为 Velocity 打造的自制聊天插件,功能丰富——支持跨服群组/全局/私聊消息,并集成 LibertyBans 的禁言功能。
插件
一个高度兼容、功能完善且稳定的 TPA 模组
评论 0
登录后参与评分
还没有评论,来抢沙发吧