ClientID
A mod-plugin pair that allows server owners to see client mod lists and ban any mod.
Screenshots
About this Mod
ClientID is a mod-plugin pair that allows server owners to view the mod and resource pack lists of all joining players and ban specific mods/packs from entering the server.
In order to be used, the plugin must be installed on the server, and the mod must be installed on the client.
The mod list can be changed via the config in the server.
Properties and what they do are listed here:
requireMod: If enabled, all players who join will be required to have ClientID installed (default: TRUE)
keywordBans: Any keywords in this list will be checked against player mod lists and, if a keyword is contained in one of the player's mods, they will be kicked.
blacklist: A list of specific mod IDs to be banned
whitelist: A list of mod IDs that bypass keywordBans and blacklist and are allowed to be used even if one of those two lists contains a ban for it.
playerBypass: A list of usernames of players that are allowed to join even if they don't have ClientID or have a banned mod installed.
reversePlayerBypass: Changed playerBypass from a whitelist into a blacklist, so all players in the list will be required to have ClientID, while all players outside it will not.
disablePieChart: Disallows clients from opening the pie chart
If requireMod is enabled, when a player joins, then until they are confirmed to have the mod installed by the server, they will be unable to perform any actions, including taking damage.
Should you find any problems, please report them to the linked issue tracker with logs and a description of the issue.
For Geyser users, Bedrock players may join, but no checks will be performed on them.
This is designed to be a preventative for a majority of hackers and is not a foolproof solution. It is highly recommended to use an anticheat in tandem with ClientID to increase your server's safety further.
THIS IS CURRENTLY ONLY FOR SPIGOT/PAPER/ETC AND FABRIC.
THE FUTURE
This mod will no longer be receiving feature updates. It will continue to be updated to newer versions, but no new features will be added.
Consequently, the mod's source code is now licensed under the GNU GPL 3.0 license to allow the community to make and distribute further open-source changes.
Available Versions
How to Install ClientID on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (26.1.2).
Install Mod
Open the mod browser in the dashboard and search for "ClientID". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
26.1.2, 26.1.1, 26.1 (+13 more)
Server-side
✗ UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
ClientID server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.1.2). You can switch loaders with one click in the panel.
Is ClientID compatible with fabric and folia and paper and purpur and spigot?
ClientID officially supports fabric, folia, paper, purpur, spigot for Minecraft 26.1.2, 26.1.1, 26.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with ClientID – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if ClientID consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install ClientID with just one click on your server.