同步桥

同步桥

直接从服务器同步所需模组和客户端资源。

管理

ModSync 是一个 Forge 1.20.1 模组,允许 Minecraft 服务器在运行期间向连接的玩家分发所需的模组和客户端内容。

ModSync 不会向玩家发送单独的整合包链接并要求他们手动重新安装所有内容,而是将客户端与服务器清单进行比对,下载缺失的文件,移除过时的受管理文件,并且仅在确实需要重启时才引导玩家完成重启步骤。

功能特性

  • 从活动服务器 mods 文件夹同步服务器所需的模组。
  • 从专用同步仓库分发客户端内容,例如资源包、光影包、配置文件和可选客户端文件。
  • 使用 SHA-256 哈希校验下载的文件。
  • 清理过时的受管理文件,而不会盲目删除本地替换的内容。
  • 支持加入前同步和登录后握手验证。
  • 支持直接内嵌 HTTP 投递或反向代理部署。

为真实服务器而设计

ModSync 面向私有服务器、精选社区和模组环境,这些场景中服务器所有者希望对客户端实际运行的内容进行更严格的把控。

近期稳定性改进包括:

  • 更安全地处理大型或缓慢的远程文件主机
  • 当清单仍指向不可达的公共下载基础 URL 时提供回退
  • 加入前同步后更可靠的专用服务器握手行为
  • 客户端 ModSync jar 的分阶段自更新支持
  • 更严格的数据包和清单校验,避免出现格式错误的同步状态

支持的内容布局

服务器模组直接从服务器 mods 目录同步。

额外的客户端内容可以从专用同步仓库同步,例如:

  • resourcepacks
  • shaderpacks
  • configs
  • optional_client

环境要求

  • Minecraft 1.20.1
  • Forge 47.4.18 或更高版本
  • Java 17

说明

  • ModSync 不是通用的 CurseForge 整合包安装器。它是面向 Forge 服务器的服务器驱动同步层。
  • 该项目专注于受控同步、安全的清理行为以及在活动服务器上的实际部署。
  • 源代码仓库和发布历史由项目所有者维护。