对于 Minecraft 服主来说,维护包含几十甚至上百个模组(Mod)的整合包服务器,最头疼的往往不是服务端调试,而是客户端模组的同步与更新。
每次新增修补 Mod、更新前置库,如果直接给玩家重新发几百兆的整合包压缩包,不仅传输慢,玩家解压覆盖还容易遗留旧版本 jar、丢失本地优化配置或引发配置文件冲突。
为此,我开源了 ModSync —— 一个专为 Minecraft 中小型服务器设计的轻量级客户端模组同步更新系统。
核心特性
- 零轮询、不打扰:客户端模组零后台静默轮询、无开机强行弹窗,仅在玩家主动点击更新时与服务端进行快速 SHA-256 比对,绝不影响日常游戏启动与流畅度。
- 精确哈希增量比对 (SHA-256):基于 SHA-256 全文哈希比对,自动识别新增、修改与被删除的模组,支持文件变动二次核对与防误删机制。
- 保护玩家自定义 Mod:智能区分服务端基准模组与玩家自行添加的客户端本地 Mod(如光影/材质/FPS优化/输入法修复等),更新同步时不会抹除玩家自己的客制化配置。
- 一键动态生成更新器:服务端在内存中流式生成对应端点的客户端 updater JAR,无需在生产环境配置复杂的 Gradle 构建环境,玩家放入
mods文件夹即可直接使用。 - 轻量 Docker 一键部署:后端内置响应式 WebUI,支持可视化扫描、文件变动预览与发布;提供自动化 Shell 部署脚本,开箱即用。
界面与实际效果展示
1. 服务端 WebUI 管理后台

服主可在后台直观查看发布状态、模组总数及文件大小,一键选择客户端加载器模板(支持 Forge 1.20.1 & NeoForge 26.1.2)并生成客户端专属更新器。
2. 客户端游戏内更新界面

更新器以模组形式深度集成在客户端主菜单中,玩家只需点击右下角的 「整合包更新」 按钮即可发起同步。


点击检查更新后,系统会自动显示缺失与变更的模组明细,并区分“常规更新(补充缺失并保留玩家本地 Mod)”与“修复模式(强制对齐基准模组)”,方便玩家一键操作。
快速开始
项目已在 GitHub 开源,欢迎体验与 Star:
- GitHub 仓库:Jees996/mc-modsync
- 最新 Release:ModSync v0.2.0
服务端一键部署(Linux)
gitclonehttps://github.com/Jees996/mc-modsync.git
cdmc-modsync/deploy
bashinstall.sh
根据提示输入 WebUI 密码与服务端监听端口,即可快速在 Linux / Docker 环境下完成搭建。
— 本文由 AI 助手代笔