Logo
MINECRAFTBIBLE
Items
Items

All game items

Blocks
Blocks

Building blocks

Mobs
Mobs

Creatures & monsters

Biomes
Biomes

World biomes

Structures
Structures

Generated structures

Recipes
Recipes

Crafting guides

Advancements
Advancements

Achievements

Loot Tables
Loot Tables

Drop rates

Tags
Tags

Item groupings

All Versions
View all data →
Capes
Cape ArchiveNEW

Browse rare Minecon capes, OptiFine capes, and custom capes from players worldwide

Browse

Player Database
Player DatabasePopular

Search any player

Skin Browser
Skin Browser

Browse & download skins

Cape Gallery
Cape GalleryNEW

Minecon & OptiFine capes

Seed Vault
Seed Vault

Curated seeds

Learn

Guides
GuidesNew

Tutorials & tips

Blog
Blog

News & updates

Community

Community Hub
Community HubHub

Posts, discussions & more

All Versions
View community →
Seed Analyzer
Seed Analyzer

World seed analysis

Loot Explorer
Loot Explorer

Drop rates

Crafting Calculator
Crafting Calculator

Material planning

Enchant Calculator
Enchant Calculator

Probability math

Redstone Lab
Redstone Lab

Signal timing

Trading Profit
Trading Profit

Villager ROI

All Versions
View all tools →
Mods
Mods

Browse all mods

Plugins
Plugins

Server plugins

Resource Packs
Resource Packs

Textures & sounds

Shaders
Shaders

Visual enhancements

Datapacks
Datapacks

World logic

Scanner
Mod Intelligence

Scan & analyze any mod

All Versions
View all mods →
Loading...
IntroductionIntroductionVersion HistoryVersion HistoryGuidesGuidesBlog & NewsBlog & News
ItemsItemsBlocksBlocksMobsMobsRecipesRecipesBiomesBiomesStructuresStructuresAdvancementsAdvancementsLoot TablesLoot TablesTagsTags
ModsModsPluginsPluginsResource PacksResource PacksShadersShadersDatapacksDatapacks

MinecraftBible

The Ultimate Wiki

Logo
MINECRAFTBIBLE

The ultimate Minecraft reference. Every item, block, mob, and recipe documented with precision.

Community

  • Player Database
  • Skin Browser
  • Cape Gallery
  • Community Hub
  • Seed Vault

Database

  • Items
  • Blocks
  • Mobs
  • Recipes
  • Biomes
  • Structures

Tools

  • Seed Analyzer
  • Mod Intelligence
  • Crafting Calculator
  • Enchant Calculator

Mods & Packs

  • Mods
  • Plugins
  • Resource Packs
  • Shaders
  • Datapacks

© 2026 MinecraftBible. Not affiliated with Mojang or Microsoft.

PrivacyTermsContact
Mod Detector Plugin
PluginGPL-3.0-or-later

Mod Detector Plugin

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

174
Downloads
1
Followers
6 months ago
Updated
📦
11
Versions
managementpapervelocity
Download Latestv1.2.3-velocityView on Modrinth

📖About Mod Detector Plugin

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.

👥 Team & Contributors

Nimq
NimqOwner

⚙️ Compatibility

Environment
🖥️ Server-side
Loaders
papervelocity
Minecraft Versions
1.81.8.11.8.21.8.31.8.41.8.51.8.61.8.7+62 more

🔗 Links

Modrinth Page