COWMODSКаталог модов

Mod Detector Plugin

Monitors plugin message channels to detect client mods and optionally kick players using blocked mods.

Автор: Nimq2,2 тыс.6обновлён 18 окт. 2026 г.
Управление

Описание

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

CommandDescriptionPermission
/moddetectorShow helpmoddetector.admin
/moddetector reloadReload configurationmoddetector.admin
/moddetector statusShow current statusmoddetector.admin
/moddetector modsList known mod definitionsmoddetector.admin
/moddetector debugShow debug statusmoddetector.admin

Alias: /md

Permissions

PermissionDescriptionDefault
moddetector.adminAccess to admin commandsOP
moddetector.notifyReceive detection notificationsOP
moddetector.bypassBypass mod detection (won't be kicked)false

Available Mods

The following mod IDs are pre-configured in mods.yml:

IDMod NameDescription
xaeros-worldmapXaero's World MapFull world map mod
xaeros-minimapXaero's MinimapMinimap mod
jadeJadeBlock/entity information overlay
journeymapJourneyMapReal-time mapping mod
litematicaLitematicaSchematic mod (via Servux)
minihudMiniHUDHUD overlay mod (via Servux)
servuxServuxServer-side data provider
simple-voice-chatSimple Voice ChatVoice chat mod
noxesiumNoxesiumPerformance/feature mod
flashbackFlashbackReplay recording mod
appleskinAppleSkinFood/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.

Последние версии

Все версии →
release

Mod Detector Plugin 1.3.0-velocity

1.3.0-velocity
18 окт. 2026 г.26Minecraft: 1.8, 1.9, 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.3velocity
Скачать
Что нового
- Added player exemptions, history tools, rule previews, and temporary exceptions. - Expanded mod detection and fixed logging and kick issues. - Verified Minecraft 26.3 support on Velocity 4.2.0.
release

Mod Detector Plugin 1.3.0

1.3.0
18 окт. 2026 г.200Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3folia, paper
Скачать
Что нового
- Added Folia support and player exemptions. - Added history tools, rule previews, and temporary exceptions. - Expanded mod detection and fixed logging and kick issues.
release

Mod Detector Plugin 1.2.4-velocity

1.2.4-velocity
9 авг. 2026 г.124Minecraft: 1.8, 1.9, 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.2velocity
Скачать
release

Mod Detector Plugin 1.2.4

1.2.4
9 авг. 2026 г.422Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper
Скачать
Что нового
## Added - Added 99 mod and protocol definitions, bringing the built-in database to 169 definitions. - Added coverage for all 240 submitted plugin-message channels across 102 observed namespaces. - Added definitions for FTB Chunks, FTB Library, FTB Teams, JEI, VoxelMap, Emotecraft, Easy Anvils, Easy Magic, Open Parties and Claims, and many more. - Added Fabric Menu API and Pick Up Notifier patterns to their existing definitions. - Added a dependency-free mod-definition generator that accepts `discovered-channels.json`, pasted channel lists, plain text, or stdin. ## Changed - The full bundled definition database is now copied to an editable `mods.yml` in the plugin data directory when the file does not already exist. - Server owners can add definitions directly to `mods.yml` and apply them with `/md reload`. - `/md reload` now reloads both `config.yml` and `mods.yml`. - Existing external `mods.yml` files are never overwritten during plugin updates. - Invalid `mods.yml` edits keep the last successfully loaded definitions active. - Shared protocol namespaces such as `minecraft`, `forge`, and `adventure` use exact channel matches where namespace-wide wildcards could cause incorrect identification. ## Upgrade notes Replace the existing platform-specific JAR and restart the server or proxy. If no external `mods.yml` exists, one will be generated automatically. Existing configuration and definition files are preserved.
release

Mod Detector Plugin 1.2.3-velocity

1.2.3-velocity
18 янв. 2026 г.250Minecraft: 1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11velocity
Скачать
Что нового
Velocity
release

Mod Detector Plugin 1.2.3

1.2.3
18 янв. 2026 г.856Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper
Скачать
Что нового
### Added - **Per-Session Mod Tracking** - Each session now records which mods the player was using - `/md info` displays the full mod list for each session - Useful for tracking mod usage changes over time - **Delta Compression for Sessions** - Sessions use smart delta compression to minimize storage - First session stores full mod list - Subsequent sessions store only changes (`added`/`removed`) if < 3 mods changed - Large changes (3+ mods) trigger a new full snapshot - Unchanged sessions store only time data - **Enhanced `/md info` Display** - Shows `firstSeen` timestamp - Shows total playtime formatted (e.g., "1h 30m") - Sessions display reconstructed mod list with duration ### Changed - **Storage Efficiency** - Typical player with same mods across 100 sessions: ~3KB (was ~25KB) - ~88% reduction in storage for players with stable mod configurations - Backwards compatible with existing data (old sessions show as-is) ### Example Detection Entry ```json { "uuid": "f999e944-a15d-4287-bff4-34f63a97832e", "username": "PlayerName", "mods": ["Simple Voice Chat", "Jade", "Minimap"], "channels": ["unknown:channel"], "firstSeen": "2026-01-16T17:28:01Z", "lastSeen": "2026-01-18T12:00:00Z", "totalTimePlayedSeconds": 3600, "sessionCount": 4, "sessions": [ {"joinTime": "2026-01-16T17:27:59Z", "leaveTime": "2026-01-16T17:30:00Z", "durationSeconds": 121, "mods": ["Jade", "Voice Chat"]}, {"joinTime": "2026-01-17T10:00:00Z", "leaveTime": "2026-01-17T10:30:00Z", "durationSeconds": 1800, "added": ["Minimap"]}, {"joinTime": "2026-01-17T14:00:00Z", "leaveTime": "2026-01-17T14:20:00Z", "durationSeconds": 1200}, {"joinTime": "2026-01-18T12:00:00Z", "leaveTime": "2026-01-18T12:08:00Z", "durationSeconds": 479, "removed": ["Jade"]} ] } ```
release

Mod Detector Plugin 1.2.1-velocity

1.2.1-velocity
16 янв. 2026 г.22Minecraft: 1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11velocity
Скачать
Что нового
Velocity
release

Mod Detector Plugin 1.2.1

1.2.1
16 янв. 2026 г.43Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper
Скачать
Что нового
### Added - **Session Tracking** - Tracks `totalTimePlayedSeconds` across all sessions - Records `sessionCount` for each player - Maintains `sessions` array with join/leave times and duration for each session - **Clickable Player Names** - Player names in `/md players` are now clickable - Click to run `/md info <player>` automatically - Hover text shows "Click to view channels" ### Changed - **Simplified Action Config** - Replaced `action: kick/log/both` with simple `kick: true/false` - Detections are now ALWAYS logged regardless of kick setting - Cleaner config, same functionality - **Smarter Detection Logging** - Only creates new JSON entry when player's modlist changes - Returning players with same mods just add session info to existing entry - Reduces file size and improves readability - **Separated Mods and Channels** - `mods` field now contains resolved mod names (e.g., "Simple Voice Chat") - `channels` field now only contains unrecognized/unknown channels - `/md info` command updated to show both sections separately - **Internal Improvements** - Replaced manual JSON parsing with Gson library - Atomic file writes (write to .tmp, then move) prevents corruption - Batched I/O with 30-second flush interval reduces disk writes - Memory cleanup task removes stale player data every 5 minutes - Proper shutdown handling ensures pending writes are flushed ### Fixed - Console no longer shows `TextComponentImpl{...}` blobs for admin notifications ### Example Detection Entry ```json { "uuid": "f999e944-a15d-4287-bff4-34f63a97832e", "username": "PlayerName", "mods": ["Simple Voice Chat", "Noxesium", "AppleSkin", "Fabric API"], "channels": ["civ:handshake", "civ:class_xp"], "firstSeen": "2026-01-16T17:28:01Z", "lastSeen": "2026-01-16T17:32:04Z", "totalTimePlayedSeconds": 243, "sessionCount": 2, "sessions": [ {"joinTime": "2026-01-16T17:27:59Z", "leaveTime": "2026-01-16T17:28:01Z", "durationSeconds": 2}, {"joinTime": "2026-01-16T17:29:20Z", "leaveTime": "2026-01-16T17:32:04Z", "durationSeconds": 241} ] } ```
release

Mod Detector Plugin 1.2.0-velocity

1.2.0-velocity
16 янв. 2026 г.22Minecraft: 1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11velocity
Скачать
Что нового
Velocity
release

Mod Detector Plugin 1.2.0

1.2.0
16 янв. 2026 г.25Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper
Скачать
Что нового
### Added - **Log All Channels Mode** - New `log-all-channels` config option to log ALL channel registrations to file - Tracks every mod channel a player registers, not just blocked ones - No console logging for better performance - **`/md info <player>` Command** - View all registered channels for a specific player - Shows current session channels and historical data - Color-coded output: red = blocked, green = allowed - Displays resolved mod names alongside raw channel strings - **`/md discovered` Command** - Lists all unique channels ever discovered on the server - Useful for documentation and discovering new mods - Persists across server restarts - **Discovered Channels File** - New `discovered-channels.json` file tracks all unique channels ever seen - JSON array format for easy parsing - Automatically updated when new channels are registered - **Smart Mod Name Resolution** - Channel-to-mod resolution now works for ALL mods in `mods.yml`, not just blocked ones - Detection logs show pretty mod names (e.g., "Simple Voice Chat" instead of "voicechat:state") - Unknown channels remain as raw strings for identification ### Changed - **Consolidated Player Entries** - `detections.json` now uses one entry per player (updated in place) - Multiple channels from the same mod are grouped together - Format changed from `"channels"` to `"mods"` array with resolved names - **`/md players` Command** - Now shows all registered channels when `log-all-channels` is enabled - Displays channel count per player - Added hint to use `/md info <player>` for details - **`/md status` Command** - Now shows `Log All Channels` setting status - **Help Command** - Updated to show all new commands - Commands now displayed with `/md` shorthand ### Example Detection Entry ```json {"uuid":"f999e944-a15d-4287-bff4-34f63a97832e","username":"PlayerName","mods":["AppleSkin","Simple Voice Chat","Noxesium","Flashback","civ:class_xp"],"lastSeen":"2026-01-16T12:00:00Z"} ``` ### Example Discovered Channels ```json [ "xaerominimap:main", "voicechat:state", "noxesium-v2:server_info", "fabric:registry/sync" ] ```