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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧