Mod Detector Plugin
Monitors plugin message channels to detect client mods and optionally kick players using blocked mods.
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.
