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.
