摘要
感谢您选择我们的 Mod 白名单模组来保护您的服务器免受客户端黑客模组的侵害。让我介绍一下它的工作原理以及您可以做什么。
这个模组在客户端和服务器端分别运行：
- 在客户端，它收集所有模组的标识符（"mod_id"），加密后发送到服务器。
- 在服务器端，它会检查尝试连接服务器的玩家是否安装了黑客模组，或者是否没有安装任何必要的模组以避免问题。
但两端都需要安装。如果没有：
- 安装在客户端但未安装在服务器端。客户端玩家仍然可以进入服务器并游玩，但这个模组无法保护您的服务器免受黑客攻击。
- 安装在服务器端但未安装在客户端。客户端玩家将不被允许进入服务器，并收到消息 "multiplayer.disconnect.modwhitelist.packetcorruption"。
将模组添加到白名单和黑名单
配置文件位于 "/config/mod_whitelist-config.json"。如果您想将模组添加到白名单或黑名单，请阅读以下指南。
首先，您应该找到模组的标识符（modid），一个简单的方法是使用压缩软件（例如 WinZip、好压、7-Zip）打开 jar 文件，打开 "fabric.mod.json" 并查看键 "id" 的值是什么。例如，Mod Whitelist 模组的 modid 是 "mod_whitelist"。
然后，如果您希望客户端玩家安装它，请将其添加到 CLIENTMODNECESSARY 字段。默认情况下，它是黑名单模式，因此如果您不希望客户端玩家安装它，可以将其添加到 CLIENTMODBLACKLIST 字段。如果您想改用白名单模式，请将 USEWHITELISTONLY 设置为 true，并将所有白名单模组的 modid 添加到 CLIENTMODWHITELIST 字段。
此外，如果 USEWHITELISTONLY 为 true，CLIENTMODBLACKLIST 字段在服务器运行时将被忽略。而如果 USEWHITELISTONLY 为 true，CLIENTMODWHITELIST 字段将被忽略。
您可能会看到，如果安装了 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 并发布您的问题和日志，如果您发现此模组有任何问题。
