狩猎者客户端模组守卫

zHunters Client Mod Guard

zHunters Client Mod Guard 是一个适用于 Minecraft 1.20.1 Fabric 的可配置模组管理与保护工具，旨在防止玩家在使用整合包或服务器不允许的客户端模组时进入单人世界或专用服务器。

服务器所有者和整合包作者可以通过 Fabric 模组 ID 或可配置的名称关键词来定义应被拦截的模组。

默认情况下，zHunters Client Mod Guard 已在其拦截列表中包含了一系列流行的小地图、世界地图和导航相关模组，为希望限制此类客户端优势的整合包提供了开箱即用的配置。

默认列表完全可自定义，可根据你的整合包或服务器规则进行编辑、扩展、缩减或完全替换。

功能

• 可配置的模组拦截 —— 定义应被阻止使用的客户端模组。
• 开箱即用的默认拦截列表 —— 默认包含多个流行的小地图、世界地图和导航相关模组。
• 模组 ID 检测 —— 直接通过 Fabric 模组 ID 拦截特定模组。
• 名称关键词检测 —— 可选择通过模组名称中的可配置关键词进行检测。
• 专用服务器保护 —— 阻止带有不允许模组的客户端加入受保护的服务器。
• 单人游戏保护 —— 在加载了不允许模组的情况下阻止玩家进入单人世界。
• 客户端验证 —— 服务器可要求连接的玩家安装 zHunters Client Mod Guard。
• 自定义消息 —— 配置玩家被拦截时显示的消息。
• 可配置日志 —— 记录检测到的被拦截模组，并可选择记录完整的客户端模组报告列表。
• 自动配置 —— 配置文件在首次启动时自动生成。
• 完全可自定义的规则 —— 移除默认拦截的模组、添加新模组或替换整个列表。

配置

配置文件位于：

config/zhunters-client-mod-guard.json

可通过 Fabric 模组 ID 或名称关键词配置被拦截的模组。

本模组附带一个默认拦截列表，包含多个小地图、世界地图和导航相关模组。

此默认列表并非强制。你可以根据整合包或服务器的需求自由移除其中的条目、添加其他模组或完全替换该列表。

单人游戏和专用服务器保护也可以分别独立启用或禁用。

其他选项允许你自定义拦截消息和日志行为。

工作原理

启用保护后，zHunters Client Mod Guard 会检查客户端上加载的模组。

如果检测到已配置的不允许模组，玩家可被阻止进入受保护的环境。

在单人游戏中，该模组可在加载被拦截模组时阻止访问世界。

在专用服务器上，服务器可以验证连接客户端报告的模组信息，并在检测到被拦截模组时拒绝连接。

服务器还可以配置为要求连接的客户端安装 zHunters Client Mod Guard。

安装

1. 安装适用于 Minecraft 1.20.1 的 Fabric Loader。
2. 安装 Fabric API。
3. 将 zHunters Client Mod Guard 放入 mods 文件夹。
4. 启动游戏或服务器一次以生成配置文件。
5. 如果你想更改被拦截的模组列表或其他设置，请编辑 config/zhunters-client-mod-guard.json。
6. 更改配置后重启游戏或服务器。

对于专用服务器保护，请在服务器和客户端上安装该模组（当启用客户端验证时）。

多人游戏

在专用服务器上使用时，zHunters Client Mod Guard 会检查连接客户端报告的模组信息。

如果检测到已配置的不允许模组，可在玩家加入服务器之前拒绝连接。

服务器所有者还可以配置该模组以要求连接的客户端安装 zHunters Client Mod Guard。

这使其适用于希望维持一致的允许客户端模组集合的整合包和私人服务器。

默认拦截列表

默认配置包含多个小地图、世界地图和导航相关模组。

这些条目仅作为起点提供，可自由修改。

zHunters Client Mod Guard 不限于地图模组 —— 任何模组都可以通过其模组 ID 或可配置的名称关键词添加到拦截列表中。

需求

• Minecraft 1.20.1
• Fabric Loader >=0.14.22
• Fabric API
• Java 17

许可证

zHunters Client Mod Guard 在 MIT 许可证下分发。

由 zClashTM 创建。