Mod Detector Plugin
1.3.0-velocityMonitors plugin message channels to detect client mods and optionally kick players using blocked mods.
- Tested MC versions
- 1.10, 1.11, 1.12, 1.13, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21, 26.1, 26.2, 26.3
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.
Similar projects
Plugin →Let Me Despawn
Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.
25MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
WorldEdit
A Minecraft Map Editor... that runs in-game! With selections, schematics, copy and paste, brushes, and scripting. Use it in creative, or use it temporarily in survival.
11.6MSueta
Emotecraft
Create your own emotes in Minecraft.
7.5MSueta
Simple Tpa
A simple tpa plugin which sends requests
5.4MSueta
Common Network
Forge and Fabric Unified Networking Solution
3.9MSueta