Introduction
IdBan is a server-side moderation mod for Minecraft that detects and blocks specific client-side mods by identifying their translation keys.
It allows server owners to enforce mod restrictions without requiring client installation or intrusive scanning — detection is performed using built-in game UI translation behavior.
Features:-
Detects client-side mods using translation key probing
Automatically kicks players running disallowed mods
Fully configurable detection and ban system
Supports mod ID bans, keyword detection, and translation probes
Works with any mod that has custom translations
Server-side only (no client install required)
How It Works
Minecraft allows UI text (chat, signs, bossbars, item names, etc.) to be defined using: Translation keys Keybind placeholders The client replaces these placeholders with localized or configured values before sending data back to the server. Detection Method The server sends the player an interface element (such as a sign or anvil rename field) containing a translation key.
Example: sodium.option_impact.low
If the player has the corresponding mod installed:
sodium.option_impact.low → Low
If the mod is not installed:
sodium.option_impact.low → sodium.option_impact.low
By checking whether the placeholder was replaced, the server can determine whether the mod exists on the client.
This works because:
- Mods register their own translation keys
- The client automatically resolves them
- The server receives the resolved value
