Server PreCheck

模组

· 作者 RealTrashy

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

0 本站下载 0 关注 更新于 9 个月前

最新 1.0.0 · 1.21.11 · Fabric

一键开服(送7天)

适用于 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 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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源