模组白名单

概述

感谢您选择我们的 Mod 白名单模组来保护您的服务器免受客户端作弊模组的侵扰。让我介绍一下它的工作原理以及您可以进行哪些操作。

该模组在客户端和服务器端分别独立运作：

• 在客户端，它会收集所有模组的标识符（“mod_id”），将其加密后发送至服务器。
• 在服务器端，它会检查尝试连接服务器的玩家是否安装了作弊模组，或是否未安装任何必要模组以避免问题。

但两端都必须安装。如果未同时安装：

• 仅客户端安装而未在服务器端安装。客户端玩家仍然可以进入服务器并游玩，但此模组无法保护您的服务器免受作弊行为的侵扰。
• 仅服务器端安装而未在客户端安装。客户端玩家将不被允许进入服务器，并会收到消息“multiplayer.disconnect.mod_whitelist.packet_corruption”。

将模组添加到白名单和黑名单

配置文件位于“<服务器目录>/config/mod_whitelist-config.json”。如果您想将模组添加到白名单或黑名单，请阅读以下指南。

首先，您需要找到模组的标识符（modid），一个简单的方法是使用压缩软件（例如 WinZip、好压、7-Zip）打开 jar 文件，再打开“fabric.mod.json”，查看键“id”的值。例如，Mod Whitelist 模组的 modid 是“mod_whitelist”。

然后，如果您希望客户端玩家安装它，请将其添加到 CLIENT_MOD_NECESSARY 字段。默认情况下，该模组为黑名单模式，因此如果您不希望客户端玩家安装它，可以将其添加到 CLIENT_MOD_BLACKLIST 字段。如果您希望改用白名单模式，请将 USE_WHITELIST_ONLY 设置为 true，并将所有白名单 modid 添加到 CLIENT_MOD_WHITELIST 字段。

此外，如果 USE_WHITELIST_ONLY 为 true，则 CLIENT_MOD_BLACKLIST 字段在服务器运行时会被忽略。反之，如果 USE_WHITELIST_ONLY 为 false，则 CLIENT_MOD_WHITELIST 字段会被忽略。

您可能会注意到，如果安装了 fabric-api，modlist 中会包含大量 modid。您可以运行一个安装了此模组的客户端，打开“.minecraft/logs/latest.log”，您会看到以下格式的行，以便简化手动收集 modlist 的过程：

Mod Whitelist vx.x.x from the client! Modlist: ["fabric-api", "fabric-api-base", ...]

问题追踪

如果您发现此模组存在任何问题，请访问 https://github.com/Viola-Siemens/Mod-Whitelist/issues 并提交您的问题和日志。