服务器预检查

服务器预检查

一个Minecraft的Fabric模组,允许服务器管理员控制客户端在连接时可以安装哪些模组。支持对单个用户及其模组进行精细控制。

适用于 Minecraft 的 Fabric 模组,允许服务器管理员控制客户端在连接时可使用哪些模组。

概述

客户端和服务器均需安装。 客户端将其模组列表发送至服务器,服务器根据配置的规则进行验证,然后才允许连接。

安装

  1. 下载模组 JAR 文件
  2. 将其放入 mods 文件夹(客户端和服务器均需放置)
  3. 启动 Minecraft/服务器
  4. 配置服务器设置(见下文)

快速开始

  1. 生成白名单:让一个装有可接受模组的客户端运行 /serverprecheck build whitelist,将模组列表复制到剪贴板
  2. 配置:在服务器上编辑 config/server_precheck-config.json
  3. 选择模式:将 USE_WHITELIST_ONLY 设为 true(白名单)或 false(黑名单)
  4. 可选:将玩家 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"]
}

问题

请在此报告所有问题