适用于 Minecraft 的 Fabric 模组,允许服务器管理员控制客户端在连接时可以使用哪些模组。
概述
客户端和服务器均需安装。 客户端会将其模组列表发送给服务器,服务器会在允许连接前根据配置规则进行验证。
安装
- 下载模组 JAR 文件
- 将其放入
mods 文件夹中(客户端和服务器端都需要)
- 启动 Minecraft/服务器
- 配置服务器设置(见下文)
快速开始
- 生成白名单:让一个安装了合规模组的客户端运行
/serverprecheck build whitelist,将模组列表复制到剪贴板
- 配置:编辑服务器上的
config/server_precheck-config.json
- 选择模式:将
USE_WHITELIST_ONLY 设置为 true(白名单模式)或 false(黑名单模式)
- 可选:将玩家 UUID 添加到
EXEMPT_PLAYERS 以绕过检查
配置
验证模式
黑名单模式(默认,USE_WHITELIST_ONLY = false)
- 允许除
CLIENT_MOD_BLACKLIST 中列出的模组之外的所有模组
- 默认黑名单:
aristois, bleachhack, meteor-client, wurst
白名单模式(USE_WHITELIST_ONLY = true)
- 仅允许
CLIENT_MOD_WHITELIST 中列出的模组
- 为精选整合包提供更严格的控制
关键配置选项
| 选项 |
类型 |
描述 |
USE_WHITELIST_ONLY |
Boolean |
false = 黑名单模式,true = 白名单模式 |
CLIENT_MOD_NECESSARY |
Array |
加入服务器必需的模组(默认:["server_precheck"]) |
CLIENT_MOD_WHITELIST |
Array |
白名单模式下允许的模组 |
CLIENT_MOD_BLACKLIST |
Array |
黑名单模式下禁止的模组 |
EXEMPT_PLAYERS |
Array |
绕过所有检查的玩家 UUID |
MODPACK_NAME |
String |
在断开连接消息中显示的名称 |
CUSTOM_DISCONNECT_MESSAGE |
String |
覆盖默认的断开连接消息 |
消息自定义选项(MSG_HEADER, MSG_UNAUTHORIZED_HEADER, MSG_MISSING_HEADER 等)支持 i18n 翻译键。
客户端命令
| 命令 |
描述 |
/serverprecheck list |
列出所有已安装的模组 |
/serverprecheck count |
显示已安装模组的数量 |
/serverprecheck build whitelist |
将模组列表复制到剪贴板以供配置使用 |
实用工具
查找模组 ID:打开模组的 JAR 文件 → fabric.mod.json → 查找 "id" 字段
查找玩家 UUID:使用 NameMC 或检查服务器日志
从日志获取模组列表:检查 .minecraft/logs/latest.log 中的以下内容:
Server Pre-Check vx.x.x from the client! Modlist: ["fabric-api", ...]
示例配置
{
"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"]
}
问题反馈
请在此处报告所有问题 here
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
评论 0
登录后参与评分
还没有评论,来抢沙发吧