FakeModBlocker
A lightweight, fully customizable, and cross-version friendly mod detection plugin that monitors plugin message channels to identify mods such as Xaero's World Map, Replay Mod, and mod loaders like Fabric and Forge.

NEW:
FakeModBlocker now includes an optional advanced sign translation detection module for additional mod detection on supported server implementations.

✨ Features
✔ Lightweight — no unnecessary overhead
✔ Fully customizable behavior and messages via messages_xx.yml
✔ Supports HEX color codes on 1.16+ servers (&#00ffcc)
✔ No dependencies — just drop the jar in your plugins folder
✔ Works across a wide range of server versions (1.8 – 1.21.11+)
✔ Multi-language support (en, cn, or your own language file)
✔ Supports /modblocker reload
✔ Supports Spigot / Paper / Purpur / Folia / PandaSpigot
✔ Optional sign translation key detection module for extra mod detection

What FakeModBlocker Detects
FakeModBlocker primarily detects clients or mods that register known plugin message channels, for example:

fml:hs → Forge
fabric:registry/sync → Fabric
xaeroworldmap → Xaero's World Map

You can also define your own custom channels in the config.

Detection Methods
1️⃣ Plugin Channel Detection
This is the main detection method.

When a player joins, FakeModBlocker checks the plugin message channels that the client registers.
Many mod loaders and mods automatically register channels that can be detected by the server.

2️⃣ Optional Sign Translation Detection
FakeModBlocker also provides an optional advanced detection module.

It works by opening a sign editor with translation keys and checking whether the client translates them, which may reveal the presence of certain mods.

Possible actions:

NOTICE
KICK
BAN
IGNORE

⚠ This feature requires server support for the sign editor API.
If the current server implementation does not support it, FakeModBlocker will automatically skip this module safely.

⚠ Limitations
FakeModBlocker is not a full mod detection or anti-cheat system.

Limitations include:

✘ Cannot detect every mod or hacked client
✘ Some clients can hide their plugin channels
✘ Only works if the client exposes detectable behavior
✘ Not designed to replace an anti-cheat plugin

⚙ Requirements
FakeModBlocker is compiled using Java 21.
Java 21 or newer is required to run this plugin.

Tested Environments
The plugin has been tested on:

• Spigot 1.8.8
• PandaSpigot 1.8.8
• Paper 1.21.x
• Folia 1.21.4/1.21.11

Other versions and forks may also work, but full compatibility cannot be guaranteed.

The plugin is designed to theoretically support 1.8 – 1.21.x servers.

⚠ Do not rename the plugin jar file, otherwise the plugin may fail to enable.

Installation

1. Put the .jar file into the plugins/ folder
2. Start the server once to generate configuration files
3. Edit config.yml and the language files
4. Run /modblocker reload to apply changes
5. Adjust the predefined mod rules in config.yml if needed

Commands

/modblocker reload
Reloads configuration and language files
Permission: fakemodblocker.admin

/modblocker check <player>
Shows plugin/mod channel information of a player
Permission: fakemodblocker.admin

Permissions

fakemodblocker.admin
Allows use of reload and check commands

fakemodblocker.bypass
Completely bypasses all detection

fakemodblocker.kickbypass
Prevents the player from being kicked,
but detected channels will still be logged

❓ FAQ
Q: Can this detect hacked clients like Vape or LiquidBounce?
A: No.
Many hacked clients intentionally avoid registering detectable plugin channels.

FakeModBlocker is mainly designed to detect mod loaders and some mods, not hacked clients.

Q: Is this an anti-cheat plugin?
A: No.
FakeModBlocker is a mod presence detector, not a cheat detection system.

Q: How does it work?
A: FakeModBlocker checks which plugin message channels a client registers when joining the server.

Many mods and mod loaders automatically register channels, which allows the plugin to detect them.

On supported servers, FakeModBlocker can also use sign translation key detection as an additional detection method.

Q: Does the sign detection work on every version?
A: No.

The sign detection module depends on public sign editor API support.
If the server implementation does not support it, FakeModBlocker will automatically skip that module.
————————————————————
⭐ Support

If you like this plugin:
⭐ Leave a star on GitHub
⭐ Leave a 5-star review on Spigot

Bug Reports
Please do NOT report bugs in the review section.

Instead:
• Open an issue on GitHub
• Use the Discussion section
• Contact via Discord
https://discord.gg/sWyVjUMu