Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Creators
Details
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.