DreamingFish Updater
安全可靠，自主可控，易于部署的 Minecraft 整合包更新系统
玩家是来玩服务器的，不是来玩资源管理器的。
让玩家照常点击启动，让模组、配置与更新器自己安全到达最新状态。
下载最新版 · 使用文档 · 更新日志 · 加入 QQ 群
未来展望
梦鱼更新器最开始是我给自己的模组服务器做的，也算是我的一个 Java 练手项目。市面上已经有了 McPatch这个优秀的项目，不过我另外做一个更新器的原因其实是给自己的服务器设计一个好看的启动界面哈哈哈哈哈哈哈。
如果你不在意漂亮的界面，只是想找一个稳定、省心的更新器，我很推荐去用 McPatch，它是一个很稳定很好的更新器项目。
这个更新器作为我学习java的练手项目，开发过程中有不少 AI agent 参与，主要用的是 Codex与claudecode，ui界面部分也和 Claude Opus 5.5 一起打磨了很多。但是这个更新器绝对不是 AI 一把梭出来的 AI slop，也绝对不是许愿编程一下许愿出来的。我们自己的服务器已经用了将近三个月（bug都让玩家吃了哈哈哈哈哈）。欢迎大家多多提issue和建议，只要有空会持续更新维护。
本次发行：管理端 / 桌面 0.3.1、玩家端 0.3.2、Bootstrap 0.1.2。玩家端界面整体重新设计，服主可以编辑首页焦点图、服务器卡片、活动、内容页面和画廊；需要由服主发布玩家端程序 0.3.2，玩家才会看到新界面。Windows 桌面继续按试用范围使用；自动验收不代替真实 RTSS、安装升级和硬断电验证。参见更新日志、完整更新教程、展示内容规范与能力矩阵。
欢迎使用梦鱼更新器
梦鱼更新器是为广大 Minecraft 模组服设计的管理工具。开模组服的腐竹们应该都知道：模组出了 Bug，或者服务器崩服需要删改内容时，处理起来有多痛苦。一方面，你要清楚地告诉玩家该如何处理有问题的模组；另一方面，如果服务器有自制模组需要频繁更新，每次都让玩家手动修改，实在让人头疼。你可能还想给自己的服务器设计一个酷炫的启动客户端，在里面展示新闻、公告以及更多内容……因此，我们制作了梦鱼更新器。它是一个更新器，也可以成为你的服务器专属客户端。
梦鱼更新器是一个安全可靠、自主可控、易于部署的 Minecraft 客户端管理工具：服主可以用桌面端、Web 或可交互终端管理项目与发布，玩家端在启动前自动更新，玩家自己的模组和文件也始终保有清楚的控制权。
下载
玩家端和管理端会分别更新，版本号不一定相同。请以 GitHub 发布页面中标记的最新版为准。所有发行包都自带精简运行环境，使用者不需要另外安装 Java。
| 发行包 | 适用场景 |
|---|
| 玩家端 · Windows x64 | 随整合包交给玩家，负责启动前检查、更新与本地管理 |
| 管理端 · Windows x64 | 部署到 Windows 环境，提供管理与玩家下载服务 |
| 管理端 · Linux x64 | 部署到 Linux 环境，提供管理与玩家下载服务 |
前往 GitHub Releases 下载最新版
Windows 管理端桌面版正在本机验收，可在本机维护，也可连接远程服务器。使用与构建方式见 桌面端说明 和 构建说明。
第一次使用请打开梦鱼更新器官网文档。我们编写了超级超级超级详细的部署教程。
它能帮你省掉哪些麻烦
以前更新整合包，往往要重新压缩一整个客户端，再告诉玩家下载、解压和覆盖。遇到模组冲突或紧急修复时，还得反复解释“删哪个文件、换成哪个版本”，玩家只要漏做一步，就可能进不了服务器。
使用梦鱼更新器后，流程会简单很多：
- 你只需要维护一份作为标准的整合包目录，像平时一样添加、替换或删除文件。
- 管理端会帮你扫描出这次有哪些变化。确认列表没有问题后，点击发布即可。
- 玩家仍然照常从 PCL、HMCL 等启动器进入游戏，更新器会在启动前自动检查。
- 玩家只会下载真正发生变化的文件，不需要每次重新下载整个整合包。
- 文件替换前会先完成校验和备份；即使更新中断或失败，也会尽量恢复原来的客户端，不会留下更新到一半的状态。
- 一切完成后，Minecraft 会继续启动，玩家不需要再手动处理文件。
你也不需要维护“1.0 先升级到 1.1，再升级到 1.2”这样的补丁顺序。每次发布都会说明最新版客户端应该包含哪些内容，所以即使玩家跳过了中间几个版本，也可以直接更新到最新版本。
核心能力
| 功能 | 使用时有什么用 |
|---|
| 只更新有变化的文件 | 玩家不必反复下载整个整合包。多个文件可以同时下载，大文件中断后也能接着传。 |
| 防止文件损坏或被替换 | 玩家端会检查发布签名、文件大小和 SHA-256；文件下载损坏或内容被人替换时，不会直接安装。 |
| 更新失败可以恢复 | 新文件会先下载到临时位置，校验并备份完成后才正式替换。中途退出或安装失败时，会尽量恢复到更新前的状态。 |
| Web 与可交互终端管理 | 创建项目、管理文件、预览变化、发布与回滚、制作首次部署包等操作既可以在网页中完成，也可以在服务器终端中完成。 |
| 玩家也能管理自己的文件 | 玩家可以按电脑配置开关可选内容，把普通同步的文件改为自行管理，也可以启用、停用模组；这些选择只保存在玩家电脑上。被替换或清理的本地文件都会先进入“备份与恢复”，可在归档仍完整且当前状态允许时恢复。 |
| 玩家端程序自动更新 | 服主发布新版玩家端后，旧版会在下次启动时自动更新，不需要为了一次界面或程序升级重新分发整个整合包。 |
| 支持外部托管和 CDN | 服务器带宽不够时，可以把更新内容导出或上传到 WebDAV、OSS、S3、R2 等存储，再交给普通 HTTP 或 CDN 分发。 |
| 做成服务器专属客户端 | 可以设置服务器名称、封面、标题、副标题、主题颜色，还能添加公告、新闻、规则、玩法等自定义页面。 |
| 更新服务器离线时仍可启动 | 如果玩家上一次已经完整更新并通过检查，更新服务器临时离线时仍可使用最近一次的有效客户端；真正的文件校验错误不会被当成普通断网跳过。 |
按文件选择的三种维护方式
服主在“管理内容”页面里给每个文件或文件夹选择维护方式，不确定时保持默认的普通同步即可。
| 维护方式 | 适合什么内容 | 服主更新时 | 玩家能做什么 |
|---|
| 强制同步 | 核心模组、联机必须一致的配置 | 始终与服主一致，原副本先备份再换回；文件夹还会归档额外文件 | 不能停用或自行管理 |
| 普通同步（默认） | 大多数模组、配置和资源包 | 跟随服主更新，玩家改过的版本先备份再换回 | 可以停用模组，或把文件改为自行管理 |
| 首次提供 | 初始文件或配置模板 | 已有保留、缺失提供一次；之后不覆盖、不补回 | 自己维护或主动恢复默认 |
日常维护之外，还可以使用：
- 可选内容：将普通同步的光影、美化等分成组，由玩家自己开关；服主决定是否默认安装。强制目录不能同时包含可选内容。
- 处理问题文件：在同一个窗口选择历史问题版本，将它移出或换成准备好的正确文件；原副本先备份。当前坏版本也能直接处理，要求随以后发布保留，直到服主明确结束。
从标准目录移除文件时，只选择“移除玩家副本”或“停止维护，留给玩家”。移除副本持续有效，豁免、停用、跳过版本和后来装回的副本都先备份再移出；重新提供同一资源会结束普通移除，历史问题版本仍需明确结束。停止维护保留玩家文件，强制目录需先改为普通同步。
旧默认配置设置迁移为首次提供，旧签名发布继续按原语义执行。新规则要求至少 0.2.0 玩家端；完整说明和不同加入时间的示例见简化维护说明。
玩家端的启动流程
玩家仍然从自己熟悉的 Minecraft 启动器启动游戏。Agent 会拉起 DreamingFish 玩家端，玩家能清楚看到本次检查、下载进度、更新记录和启动状态；检查完成后，Minecraft 照常继续启动。
玩家端同时提供：
- 本次更新、更新记录与运行记录；
- 按目录或单文件管理本地内容；
- 服务器模组与玩家自选模组的独立启停；
- 服主自定义的公告、活动、玩法、规则和世界观页面；
- 与服务器风格一致的名称、封面、强调色和首页介绍。
普通同步下的本地选择不会上传到服务器。
基本使用流程
管理端可以运行在 Windows 或 Linux 服务器上，既能使用 Web 页面，也能通过可交互终端管理。
- 运行管理端并跟随首次引导完成设置。
- 创建项目，选择要管理的文件目录；玩家可以访问的更新地址可以这时填写，也可以发布前再填。
- 添加或修改
mods、config 等内容，扫描变化后创建发布。
- 发布玩家端程序，生成首次部署包，并按教程接入 PCL 或 HMCL。
- 完成一次实际启动测试后分发给玩家；以后的更新由玩家端在启动游戏前自动完成。
首次部署、远程 Web 管理、启动器参数和外部托管等具体操作，请直接跟随官网完整教程。
兼容与安全
- 玩家可以继续使用 PCL 或 HMCL，支持管理 Forge、NeoForge 和 Fabric 整合包；梦鱼更新器不会接管账号登录、游戏下载或 Java 选择。
- 正式发布带有签名，每个文件都会校验大小和 SHA-256；文件损坏或被替换时不会直接安装。
- 更新前会暂存新文件并备份旧文件，中断或失败时按持久记录恢复；冲突或恢复材料缺失会阻断并保留证据。
- Web 管理页面包含发布和文件管理权限，远程使用时请按照官网教程配置 SSH 隧道，或启用账号与 HTTPS 保护。
文档与反馈
开源许可
梦鱼更新器使用 GNU Affero General Public License v3.0 开源。你可以按照许可证使用、研究和修改代码；如果修改后通过网络向他人提供服务，请同时遵守 AGPL-3.0 的源代码公开要求。
