ModGate

ModGate

ModGate - 严格的模组验证系统 🔒 强制实现完美的模组同步!带版本跟踪的 SHA-256 验证,自定义断开连接界面,零额外模组策略。自动设置,热重载,详细的工具提示。

英文描述

ModGate - 严格的模组验证系统

🔒 在服务器与客户端之间强制执行完美的模组同步!

ModGate 是一个强大的 Fabric 模组,为 Minecraft 服务器提供严格的模组验证。它确保所有连接到服务器的玩家都拥有完全正确的模组、正确的版本以及文件完整性。

✨ 主要特性

  • 🔐 严格的模组验证:使用 SHA-256 哈希验证模组完整性和版本
  • 🚫 禁止额外模组策略:玩家不能拥有服务器未批准的其他模组
  • ⚡ 强制客户端模组:未安装 ModGate 的玩家将在 10 秒后自动被踢出
  • 🎨 自定义断开连接界面:精美界面展示详细的模组状态,包括对勾、叉号及版本信息
  • 📊 版本跟踪:显示当前版本与所需版本的对比,并附带详细提示
  • 🔄 热重载:无需重启即可重新加载服务器配置
  • 📤 轻松设置:自动生成及导出/导入命令,快速完成服务器配置

🛠️ 工作原理

  1. 客户端连接:玩家加入时,ModGate 请求其模组列表
  2. 哈希验证:客户端生成所有模组的 SHA-256 哈希并发送至服务器
  3. 严格检查:服务器根据配置验证每个模组的哈希和版本
  4. 额外模组检测:任何不在服务器列表中的模组都会被标记为禁止
  5. 自定义界面:若验证失败,玩家将看到详细界面,准确显示问题所在
  6. 提示系统:将鼠标悬停在模组上可查看当前版本与所需版本及状态

📋 命令

服务器命令(OP 等级 2+):

  • /modgate reload - 重新加载配置
  • /modgate export - 将当前模组列表导出到配置文件
  • /modgate import - 从配置文件导入模组列表
  • /modgate list - 显示当前所需的模组

客户端命令:

  • /modgate-client export - 导出客户端模组列表以供服务器设置使用

⚙️ 配置格式

ModGate 使用包含版本和哈希跟踪的 JSON 配置:

[
    {
        "fabric-api": {
            "version": "0.92.2+1.21.1",
            "hash": "sha256hash..."
        }
    },
    {
        "jei": {
            "version": "15.2.0.27", 
            "hash": "sha256hash..."
        }
    }
]

🚀 快速设置

  1. 在服务器和所有客户端上安装 ModGate
  2. 在参考客户端上设置好所有需要的模组
  3. 运行客户端 - 自动生成 modgate-cli/mod_list.json
  4. 将文件复制到服务器,命名为 config/modgate_export.json
  5. 在服务器上导入:/modgate import 然后 /modgate reload
  6. 完成! 所有玩家都将根据此模组列表进行验证

💡 完美适用于

  • 需要精确模组同步的模组服务器
  • 希望防止模组不一致的服务器管理员
  • 模组公平性至关重要的竞技服务器
  • 有特定模组要求的白名单社区

🔧 技术细节

  • 依赖:Fabric API
  • 网络超时:1 秒
  • 哈希算法:SHA-256

ModGate 消除了模组版本不匹配带来的困扰,确保服务器上所有玩家获得一致的体验!


俄语描述

ModGate - 严格的模组验证系统

🔒 确保服务器与客户端之间完美的模组同步!

ModGate 是一个强大的 Fabric 模组,为 Minecraft 服务器提供严格的模组验证。它确保所有连接到服务器的玩家都拥有完全正确的模组、正确的版本以及文件完整性。

✨ 主要特性

  • 🔐 严格的模组验证:使用 SHA-256 哈希验证模组完整性和版本
  • 🚫 禁止额外模组策略:玩家不能拥有服务器未批准的其他模组
  • ⚡ 强制客户端模组:未安装 ModGate 的玩家将在 10 秒后自动被踢出
  • 🎨 自定义断开连接界面:精美界面展示详细的模组状态,包括对勾、叉号及版本信息
  • 📊 版本跟踪:显示当前版本与所需版本的对比,并附带详细提示
  • 🔄 热重载:无需重启即可重新加载服务器配置
  • 📤 轻松设置:自动生成及导出/导入命令,快速完成服务器配置

🛠️ 工作原理

  1. 客户端连接:玩家加入时,ModGate 请求其模组列表
  2. 哈希验证:客户端生成所有模组的 SHA-256 哈希并发送至服务器
  3. 严格检查:服务器根据配置验证每个模组的哈希和版本
  4. 额外模组检测:任何不在服务器列表中的模组都会被标记为禁止
  5. 自定义界面:若验证失败,玩家将看到详细界面,准确显示问题所在
  6. 提示系统:将鼠标悬停在模组上可查看当前版本与所需版本及状态

📋 命令

服务器命令(OP 等级 2+):

  • /modgate reload - 重新加载配置
  • /modgate export - 将当前模组列表导出到配置文件
  • /modgate import - 从配置文件导入模组列表
  • /modgate list - 显示当前所需的模组

客户端命令:

  • /modgate-client export - 导出客户端模组列表以供服务器设置使用

⚙️ 配置格式

ModGate 使用包含版本和哈希跟踪的 JSON 配置:

[
    {
        "fabric-api": {
            "version": "0.92.2+1.21.1",
            "hash": "sha256hash..."
        }
    },
    {
        "jei": {
            "version": "15.2.0.27", 
            "hash": "sha256hash..."
        }
    }
]

🚀 快速设置

  1. 在服务器和所有客户端上安装 ModGate
  2. 在参考客户端上设置好所有需要的模组
  3. 运行客户端 - 自动生成 modgate-cli/mod_list.json
  4. 将文件复制到服务器,命名为 config/modgate_export.json
  5. 在服务器上导入:/modgate import 然后 /modgate reload
  6. 完成! 所有玩家都将根据此模组列表进行验证

💡 完美适用于

  • 需要精确模组同步的模组服务器
  • 希望防止模组不一致的服务器管理员
  • 模组公平性至关重要的竞技服务器
  • 有特定模组要求的白名单社区

🔧 技术细节

  • 依赖:Fabric API
  • 网络超时:1 秒
  • 哈希算法:SHA-256

ModGate 消除了模组版本不匹配带来的困扰,确保服务器上所有玩家获得一致的体验!