Server PreCheck
by RealTrashy
Server PreCheck lets a server administrator decide which client-side mods may connect, by checking the mod list each client sends before the connection is allowed.
What it does
On connection, the client sends its mod list and the server validates it against rules set in the configuration. In blacklist mode, which is the default, every mod is allowed except those named in the client mod blacklist; the blacklist ships with entries for aristois, bleachhack, meteor-client and wurst. In whitelist mode, enabled by setting USE WHITELIST ONLY to true, only the mods listed in the client mod whitelist are accepted. A whitelist can be generated by running the serverprecheck build on a client that has only the acceptable mods, which copies the mod list to the clipboard.
Access can also be adjusted per player. Adding a player's UUID to the exempt players list lets that player bypass the checks. Message texts such as the header for unauthorized or missing mods can be customized, and the message keys support translation. Mod IDs are read from the fabric.mod.json file inside each mod's JAR, and player UUIDs can be looked up on NameMC or taken from the server logs.
Key features
Blacklist mode
Blocks a set of client mods while allowing everything else, which is the default configuration.
Whitelist mode
Accepts only the mods on the whitelist, which suits curated modpacks that need stricter control.
Generated whitelist
The serverprecheck build creates a whitelist from the mods a client currently runs and copies it to the clipboard.
Exempt players
Player UUIDs in the exempt players list bypass the mod checks, so individual users can connect regardless of their mods.
Customizable messages
Header and message texts for unauthorized and missing mods can be changed, and translation keys are supported.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Questions
Does Server PreCheck need to be installed on both sides?
How does a server administrator build a whitelist?
How can a mod ID be found for the configuration?
What the author says
A Fabric mod for Minecraft that allows server administrators to control which mods clients can use when connecting. Required on both client and server. The client sends its mod list to the server, which validates it against configured rules before allowing connection.
Official listing
- Modrinth page
- modrinth.com/mod/server-precheck
- Owner
- RealTrashy
- Published
- 2026-01-30
- Updated on Modrinth
- 2026-01-30
- Facts verified
- 2026-10-15
