
服务器预检查
一个Minecraft的Fabric模组,允许服务器管理员控制客户端在连接时可以安装哪些模组。支持对单个用户及其模组进行精细控制。
适用于 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 |
布尔值 | false = 黑名单模式,true = 白名单模式 |
CLIENT_MOD_NECESSARY |
数组 | 加入所需的模组(默认:["server_precheck"]) |
CLIENT_MOD_WHITELIST |
数组 | 白名单模式下允许的模组 |
CLIENT_MOD_BLACKLIST |
数组 | 黑名单模式下禁止的模组 |
EXEMPT_PLAYERS |
数组 | 绕过所有检查的玩家 UUID |
MODPACK_NAME |
字符串 | 在断开连接消息中显示 |
CUSTOM_DISCONNECT_MESSAGE |
字符串 | 覆盖默认的断开连接消息 |
消息自定义选项(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"]
}
问题
请在此报告所有问题
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。