Mod Whitelist

简介

感谢你选择我们的 Mod Whitelist 模组来保护服务器免受客户端作弊模组的影响。下面为你介绍它的工作原理以及你可以进行的操作。

此模组在客户端和服务器端分别运行：

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

但客户端和服务器端都必须安装此模组。否则：

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

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

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

首先，你需要找到模组的标识符（modid）。一种简单的方法是使用压缩软件（例如 WinZip、HaoZip、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 后，模组列表中会包含相当多的 modid。你可以在安装了此模组的客户端上打开“.minecraft/logs/latest.log”，找到以下格式的日志行，以便更轻松地手动收集模组列表：

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

问题追踪

如果你发现此模组有任何问题，请访问 https://github.com/Viola-Siemens/Mod-Whitelist/issues，提交问题并附上日志。