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

1. Download the latest release JAR
2. Place it in your server's plugins/ folder
3. Restart your server
4. 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.