Mr.Lee 页面横幅
个人博客,记录代码、项目与生活。

ModSync:轻量、可靠的 Minecraft 客户端模组同步更新系统

  • HOME
  • 随笔
  • ModSync:轻量、可靠的 Minecraft 客户端模组同步更新系统

对于 Minecraft 服主来说,维护包含几十甚至上百个模组(Mod)的整合包服务器,最头疼的往往不是服务端调试,而是客户端模组的同步与更新。

每次新增修补 Mod、更新前置库,如果直接给玩家重新发几百兆的整合包压缩包,不仅传输慢,玩家解压覆盖还容易遗留旧版本 jar、丢失本地优化配置或引发配置文件冲突。

为此,我开源了 ModSync —— 一个专为 Minecraft 中小型服务器设计的轻量级客户端模组同步更新系统。


核心特性

  • 零轮询、不打扰:客户端模组零后台静默轮询、无开机强行弹窗,仅在玩家主动点击更新时与服务端进行快速 SHA-256 比对,绝不影响日常游戏启动与流畅度。
  • 精确哈希增量比对 (SHA-256):基于 SHA-256 全文哈希比对,自动识别新增、修改与被删除的模组,支持文件变动二次核对与防误删机制。
  • 保护玩家自定义 Mod:智能区分服务端基准模组与玩家自行添加的客户端本地 Mod(如光影/材质/FPS优化/输入法修复等),更新同步时不会抹除玩家自己的客制化配置。
  • 一键动态生成更新器:服务端在内存中流式生成对应端点的客户端 updater JAR,无需在生产环境配置复杂的 Gradle 构建环境,玩家放入 mods 文件夹即可直接使用。
  • 轻量 Docker 一键部署:后端内置响应式 WebUI,支持可视化扫描、文件变动预览与发布;提供自动化 Shell 部署脚本,开箱即用。


界面与实际效果展示

1. 服务端 WebUI 管理后台

ModSync 服务端 WebUI 仪表盘

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


2. 客户端游戏内更新界面

游戏主菜单整合包更新入口

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

模组更新与检查界面

增量变动明细与安全比对

点击检查更新后,系统会自动显示缺失与变更的模组明细,并区分“常规更新(补充缺失并保留玩家本地 Mod)”与“修复模式(强制对齐基准模组)”,方便玩家一键操作。


快速开始

项目已在 GitHub 开源,欢迎体验与 Star:

服务端一键部署(Linux)

gitclonehttps://github.com/Jees996/mc-modsync.git
cdmc-modsync/deploy
bashinstall.sh

根据提示输入 WebUI 密码与服务端监听端口,即可快速在 Linux / Docker 环境下完成搭建。

— 本文由 AI 助手代笔

已读 0
评论
!
弱匿名说明:依据《中华人民共和国个人信息保护法》《中华人民共和国网络安全法》《互联网跟帖评论服务管理规定》等相关规定,本站会在评论提交时记录必要的安全日志,包括昵称、IP 地址、浏览器标识和提交时间,仅用于反垃圾、滥用排查、安全审计及依法配合有权机关处理,不会公开展示。请友善表达,避免发布违法、侵权或攻击性内容。