FakeModBlocker
Lightweight & Cross-Version Mod Detection Plugin (1.8 – 26.1+)FakeModBlocker is a lightweight, highly configurable mod detection plugin designed to identify common mod loaders and mods by analyzing plugin message channels and optional client behavior.
It supports a wide range of server platforms and versions, making it ideal for networks running mixed environments.
GitHub: https://github.com/LostUmbrella58/FakeModBlocker
Key Features
✔ Lightweight & Efficient
No unnecessary overhead. Designed to run safely even on large servers.
✔ Cross-Version Support (1.8 – 26.1+)
Works on legacy servers and modern platforms including Paper and Folia.
✔ Fully Customizable
Configure detection rules, punishments, and messages via config.yml and language files.
✔ Multi-Language Support
Supports multiple languages (English, Chinese, or custom translations).
✔ HEX Color / MiniMessage Support
Supports modern HEX colors (�ffcc) on compatible server versions.
✔ No Dependencies Required
Drop the plugin into your /plugins folder — no external plugins needed.
✔ Flexible Punishment System
Supports multiple actions:
- NOTICE
- KICK
- BAN
- IGNORE
✔ Advanced Detection Module (Optional)
Includes an optional sign translation detection system for enhanced detection on supported servers.
Detection Methods
Plugin Message Channel Detection (Primary)
FakeModBlocker detects mods based on plugin message channels registered by the client.
Examples:
- fml:hs → Forge
- fabric:registry/sync → Fabric
- xaeroworldmap → Xaero's World Map
Optional Sign Translation Detection (Advanced)
An advanced detection method available on supported server implementations.How it works:
- Opens a virtual sign editor for the player
- Sends translation keys
- Checks if the client translates them correctly
⚠ Automatically disabled if the server does not support the required API
⚠ Safe fallback — will not break on unsupported versions
⚙ Supported Platforms
✔ Spigot✔ Paper
✔ Purpur
✔ Folia
✔ PandaSpigot
Tested Environments
- Spigot 1.8.8
- PandaSpigot 1.8.8
- Paper 1.21+
- Folia 1.21.4 / 1.21.11
⚠ Limitations
FakeModBlocker is not an anti-cheat plugin.✘ Cannot detect all mods or hacked clients
✘ Some clients may hide plugin channels
✘ Only detects mods that expose identifiable behavior
✘ Not intended to replace anti-cheat systems
⚙ Requirements
✔ Java 21 or higher
Installation
- Put the .jar file into your /plugins/ folder
- Start the server once to generate configuration files
- Configure config.yml and language files
- Run /modblocker reload
Commands
/modblocker reload
Reloads configuration and language files
Permission: fakemodblocker.admin
/modblocker check <player>
Displays detected plugin channels for a player
Permission: fakemodblocker.admin
Permissions
- fakemodblocker.admin → Access to commands
- fakemodblocker.bypass → Completely bypass detection
- fakemodblocker.kickbypass → Prevents kicks but still logs detection
FAQ
Q: Can this detect hacked clients like Vape or LiquidBounce?
A: No. These clients usually hide their channels and avoid detection.
Q: Is this an anti-cheat plugin?
A: No. It only detects mod presence, not cheating behavior.
Q: Does it work on all versions?
A: Core detection works across most versions.
Advanced sign detection only works on supported server implementations.
🖼 Screenshots / Preview
Bug Reports
Do NOT report bugs in reviews.Please use:
- GitHub Issues
- Discord
Important Notes
⚠ Do NOT rename the plugin .jar file
⚠ Renaming may prevent the plugin from enabling properly
