Monitors plugin message channels to detect client mods and optionally kick players using blocked mods.
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.
plugins/ folderplugins/ModDetectorPlugin/config.yml| 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
| 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 |
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 |
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
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.