Server PreCheck

Мод Fabric

Серверный мод для Майнкрафт на Fabric: позволяет администраторам контролировать, какие моды установлены у игроков при подключении.

446 скачиваний 0 подписчиков

Оцените первым

A Fabric mod for Minecraft that allows server administrators to control which mods clients can use when connecting.

Overview

Required on both client and server. The client sends its mod list to the server, which validates it against configured rules before allowing connection.

Installation

Download the mod JAR file
Place it in your mods folder (both client and server)
Start Minecraft/Server
Configure the server settings (see below)

Quick Start

Generate your whitelist: Have a client with acceptable mods run /serverprecheck build whitelist to copy the mod list to clipboard
Configure: Edit config/server_precheck-config.json on your server
Choose mode: Set USE_WHITELIST_ONLY to true (whitelist) or false (blacklist)
Optional: Add player UUIDs to EXEMPT_PLAYERS to bypass checks

Configuration

Validation Modes

Blacklist Mode (default, USE_WHITELIST_ONLY = false)

Allows all mods except those in CLIENT_MOD_BLACKLIST
Default blacklist: aristois, bleachhack, meteor-client, wurst

Whitelist Mode (USE_WHITELIST_ONLY = true)

Only allows mods in CLIENT_MOD_WHITELIST
Stricter control for curated modpacks

Key Configuration Options

Option	Type	Description
`USE_WHITELIST_ONLY`	Boolean	`false` = blacklist mode, `true` = whitelist mode
`CLIENT_MOD_NECESSARY`	Array	Mods required to join (default: `["server_precheck"]`)
`CLIENT_MOD_WHITELIST`	Array	Allowed mods in whitelist mode
`CLIENT_MOD_BLACKLIST`	Array	Banned mods in blacklist mode
`EXEMPT_PLAYERS`	Array	Player UUIDs that bypass all checks
`MODPACK_NAME`	String	Shown in disconnect messages
`CUSTOM_DISCONNECT_MESSAGE`	String	Overrides default disconnect message

Message customization options (MSG_HEADER, MSG_UNAUTHORIZED_HEADER, MSG_MISSING_HEADER, etc.) support i18n translation keys.

Client Commands

Command	Description
`/serverprecheck list`	Lists all installed mods
`/serverprecheck count`	Shows the number of installed mods
`/serverprecheck build whitelist`	Copies mod list to clipboard for config

Utilities

Finding a Mod ID: Open the mod's JAR file → fabric.mod.json → look for the "id" field

Finding a Player UUID: Use NameMC or check server logs

Getting Mod List from Logs: Check .minecraft/logs/latest.log for:

Server Pre-Check vx.x.x from the client! Modlist: ["fabric-api", ...]

Example Configuration

{
    "MODPACK_NAME": "My Server Modpack v1.0",
    "USE_WHITELIST_ONLY": false,
    "CLIENT_MOD_NECESSARY": ["server_precheck"],
    "CLIENT_MOD_BLACKLIST": ["aristois", "bleachhack", "meteor-client", "wurst"],
    "EXEMPT_PLAYERS": ["069a79f4-44e9-4726-a5be-fca90e38cmf5"]
}

Issues

Please report all issues here