ModsFinder

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.

FabricClient and serverMIT LicenseOpen source1.21.11

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

  1. Blacklist mode

    Blocks a set of client mods while allowing everything else, which is the default configuration.

  2. Whitelist mode

    Accepts only the mods on the whitelist, which suits curated modpacks that need stricter control.

  3. Generated whitelist

    The serverprecheck build creates a whitelist from the mods a client currently runs and copies it to the clipboard.

  4. Exempt players

    Player UUIDs in the exempt players list bypass the mod checks, so individual users can connect regardless of their mods.

  5. 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.

1.21.111.0.0
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Questions

Does Server PreCheck need to be installed on both sides?

Yes. Servers that run it need every player to install it too.

How does a server administrator build a whitelist?

Start the client with only the acceptable mods installed and run the serverprecheck build. The mod list is generated and copied to the clipboard, ready to paste into the whitelist configuration.

How can a mod ID be found for the configuration?

Open the mod's JAR file and read the id field in its fabric.mod.json file.

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.
RealTrashy, on the Modrinth page

Official listing

Owner
RealTrashy
Published
2026-01-30
Updated on Modrinth
2026-01-30
Facts verified
2026-10-15