0.2.1 管理端桌面版上线,玩家端更新界面焕新 DreamingFish Updater
梦鱼更新器

安全可靠,自主可控,易于部署的
客户端管理工具

还在让玩家手动拖动模组更新客户端?玩家是来玩服务器的还是来玩资源管理器的?使用梦鱼客户端更新工具,玩家端自动安全下载变化内容,还可以自己手动管理哪些内容受服务器控制。

部署教程
梦鱼更新器玩家端主页:欢迎来到梦屿,已是最新版本 100%,本地文件已验证
Ed25519 签名已验证发布来自你的服务器
只下载变化的文件并行下载 · 断点续传
本地文件已验证Minecraft 继续启动
玩家自选模组已保留不受服务器影响
向下滑动,看看它还能做什么
差异下载并行下载断点续传Ed25519 签名SHA-256 校验事务安装断电自动恢复一键回滚任意版本直达最新玩家端自更新外部托管与 CDN离线启动
玩家自选模组本地管理范围可选内容备份与恢复强制同步普通同步首次提供桌面版网页管理界面交互式命令行PCL · HMCLForge · NeoForge · Fabric服务器专属启动界面

玩家是来玩服务器的,
不是来玩资源管理器的。

让玩家照常点击启动,让模组、配置与更新器自己安全到达最新状态。

The update engine

爱咋删爱咋加,启动就完了

服主整理要管理的内容,玩家启动时自动检查。普通同步默认保留玩家额外添加的模组;强制内容、持续删除和问题版本按发布要求处理,其他内容可以由玩家自己维护。

了解扫描、发布与回滚
RELEASE PIPELINE目标版本 1.3
01
标准整合包目录服主维护想要发布的内容
02
扫描与确认先预览新增、修改和移除
03
可信发布形成不可变的完整目标状态
玩家启动前

只处理本机差异

  1. 01

    比较本地文件

    玩家仍然从 PCL、HMCL 等启动器进入游戏,更新器在启动前自动比较本机文件与目标版本。

  2. 02

    下载变化内容

    只下载真正发生变化的文件,不必每次重新下载整个整合包;多个文件同时下载,大文件中断后也能接着传。

  3. 03

    暂存并校验

    新文件先写入临时位置,逐一检查大小与 SHA-256,确认完整后才会进入安装。

  4. 04

    异常时恢复

    替换前先完成备份;中途退出或安装失败时恢复到更新前的状态,不会留下更新到一半的客户端。

  5. 05

    继续启动游戏

    一切完成后,Minecraft 继续启动,玩家不需要再手动处理任何文件。

玩家端正在检查更新 玩家端正在下载更新 玩家端正在完成校验 玩家端正在安装更新 更新已经完成,Minecraft 已开始启动

从任意旧版本直达最新

不管发布内容怎么增删修改,玩家端都会自动对齐最新目标状态,始终回到最新版本。

快捷回滚

发现问题时,管理端可一键回退到上一份稳定发布,快捷撤回有问题的版本。

更新器与整合包独立升级

玩家端程序可以独立自更新,渠道与整合包内容分开;模组或配置变化不必重新发布客户端程序。

安全更新

文件先校验并暂存,确认完整后再原子写入;中途断电或失败会自动恢复,避免留下半套更新。

Player-side control

让玩家轻松管理本地文件,
保留对客户端的控制权。

玩家端提供“本次更新、更新记录、运行记录、本地文件、备份与恢复、自选模组”六个详情入口。本地管理继续遵守服主设定的同步边界,同时把普通文件、目录和模组的选择留在玩家电脑上。

管理范围

按文件或目录,决定哪些普通内容继续由更新器管理。

玩家可以搜索文件或文件夹,自己选择哪些内容交给服务器更新。自己添加的模组默认保留;强制内容不能在本地关闭,已经发布的移除和问题版本要求仍会处理匹配副本。

  • 目录支持部分子项不受管理
  • 普通文件可在本机单独豁免
  • 一键恢复全部更新器管理
玩家端“本地文件 · 文件管理范围”界面:config 与 mods 目录的管理勾选
模组启停与自选模组

服务器模组和自选模组,分开管理更清楚。

玩家可以在模组列表中搜索并直接开关。服务器要求的模组会标记为“强制”;玩家自己添加的模组独立保留和管理,互不影响。

  • 必要模组停用前给出风险确认
  • 识别 Forge/NeoForge 的 modId 和 Fabric 模组 ID,模组升级或改名后仍能识别并保留你的选择
  • 一键恢复整合包默认状态
更新与本地管理
管理范围模组启停
停用必要模组可能导致游戏崩溃或无法连接服务器。更改会在本次更新完成前重新校验。
  • DreamingFish Core服务器强制同步 · mods/dreamingfish-core.jar
    强制
  • 性能优化组件整合包管理 · mods/performance-helper.jar
    整合包
  • 旧版渲染优化整合包管理 · mods/legacy-renderer.jar
    整合包
  • Xaero's Minimap玩家添加 · mods/xaeros-minimap.jar
    玩家添加

试试点击开关

Desktop · Web · Terminal

Windows 用桌面版,
Linux 用终端版。

管理端分为桌面版和终端版。Windows 电脑或 Windows Server 上,推荐直接运行桌面版,解压就能用;Linux 服务器上用终端版,平时打开网页管理界面,和桌面版的界面一模一样;网页也不方便用的时候,还有交互式命令行。不管用哪种,背后都是同一个管理核心——整理文件、看清改动、点一下发布,整合包就稳稳交到玩家手里。

桌面版

Windows 电脑或 Windows Server 上推荐用它:解压就能运行,免安装,自带 Java 和管理核心。选“本机管理”直接打开工作区;也能通过管理地址或 SSH 连接服务器上的终端版,关掉窗口会收进托盘。

  • 免安装
  • Windows Server
  • SSH 连接

终端版 · 网页管理

Linux 服务器上用终端版:在终端里启动 Web 管理界面,用浏览器打开,界面和桌面版一模一样。原来的旧版界面也还在,随时可以切换。

  • 和桌面版一样
  • 旧版界面
  • SSH 隧道 · HTTPS

终端版 · 交互式命令行

网页也不方便用的时候,直接在终端里管:中文交互菜单一步步带你走完;参数式命令加上 --json,就能交给脚本或 AI agent。加密备份与恢复也在这里。

  • 交互菜单
  • 参数式命令
  • 加密备份
梦鱼更新管理 · 文件 LIVE DEMO

文件夹树与详情卡片

左边是文件夹树,右边是文件列表;双击文件打开详情卡片,路径、版本、模组 ID 和维护方式一眼看清。

导入清单,先检查再确认

文件先进私有暂存区,看清保存位置、模组版本和替换关系,确认后才写进整合包;同一个模组换版本,旧文件自动归档。

发布前核对改动

新增、更新、移除和维护设置的变化都用中文写清楚;被移除的文件逐个决定,是移除玩家副本还是留给玩家。

操作记录与撤销

导入、移出、改设置和发布都有记录。改错了可以撤销,也能一键恢复成当前发布的设置,不用凭记忆改回去。

发放与玩家端设计

部署包、玩家端程序和外部托管放在“发放”里;“玩家端设计”中间就是真实玩家端的实时预览。

快捷键与深浅色

Ctrl K 命令菜单、文件快捷键和右键菜单,深浅两套主题;活动栏可以只显示图标,也可以展开文字。

Sync policy

温和的默认同步,明确的强制边界。

管理端为每个文件或文件夹提供三种维护方式,服主可以按目录或文件灵活选择:普通同步默认尊重玩家本地内容,强制同步确保指定内容与发布版本一致,首次提供只在玩家没有时给一份,之后交给玩家自己维护。

DEFAULT默认

普通同步

适合大多数整合包内容:服务器发布什么,玩家就更新什么;玩家自己添加的文件和模组不会被删除,还能在本地决定哪些内容交给服务器管理。

  • 服主发布的内容自动同步
  • 玩家自定义文件和模组不会被删
  • 玩家可随时调整管理范围
FORCED强制

强制同步

开启后,指定范围会强制与服务器保持一致;即使玩家自己添加了模组,范围内的冲突内容也会先安全备份,再移出游戏实例。

  • 服主可按目录或单个文件指定
  • 指定内容始终跟随服务器版本
  • 玩家自加内容先备份,再安全移除
FIRST TIME一次

首次提供

适合初始文件或配置模板:玩家已有就保留,缺失时提供一次;之后不覆盖、不补回,由玩家自己维护。

  • 只在玩家没有时放一份
  • 之后归玩家所有,更新不再改动
  • 玩家可以主动恢复默认
Integrity and atomicity

先确认发布来自谁,再确认每一个字节是否正确,最后才写入实例。

DreamingFish Updater 不把“下载成功”当作“更新可信”。发布身份、对象内容、安装结果和本地路径分别校验;任何一步不满足条件,更新都不会被标记为完成。

01 / TRUSTED RELEASE发布真实性
KEY
项目绑定玩家实例预先信任项目公钥
SIG
Ed25519完整发布清单必须通过数字签名
SEQ
防重放序号、发布 ID 与清单哈希共同检查

管理端私钥只保存在服主自己的管理数据中。玩家端只持有公钥,因此公共下载服务或网络链路无法自行伪造一个可信发布。

02 / VERIFIED TRANSFER传输完整性
OBJECTsha256/8f4c…d91a
声明大小与响应范围检查SHA-256 VERIFIED
  • 每个文件对象以 SHA-256 内容哈希标识,同时校验声明大小。
  • 断点续传必须返回匹配的 Content-Range,不匹配就重新下载。
  • 下载先写入分片文件,校验通过后才提升为可安装对象。
  • 默认并行下载多个独立对象,但每个对象都单独完成完整性验证。
Atomic installation

安装不是边下边覆盖,而是一份可以恢复的事务。

真正改动实例前,系统先备份本轮涉及的文件与可信元数据,并写入事务日志。替换完成后重新校验目标状态;只有校验、元数据保存和归档都完成,事务才会进入已提交状态。

1BACKED_UP备份旧文件与发布元数据
2COMMITTING临时文件落盘并替换目标
3VERIFYING重新验证已安装文件
4COMMITTED保存可信状态并清理事务
意外断电、进程退出或安装失败下次启动先读取事务日志;未完成提交时恢复备份,恢复失败则明确阻止继续启动,而不是假装更新成功。

原子文件替换

内容先写入同目录临时文件、强制刷新到磁盘,再使用原子移动替换;文件系统不支持时退回安全替换路径。

路径安全

拒绝绝对路径、..、Windows 保留名、大小写冲突和符号链接穿越,发布文件不能逃离实例目录。

并发与运行锁

同一实例只允许一个更新任务;Minecraft 正在使用实例时,不执行提交或未完成事务恢复。

离线边界

网络不可用时只复用最近一次已验证安装。签名、哈希、路径或事务错误不会被伪装成普通断网。

关于 HTTP 与 HTTPS

公共文件源可以部署在 HTTP 或 HTTPS 上。内容真实性与完整性由 Ed25519 签名和 SHA-256 校验独立保证:被篡改、截断或替换的清单与文件不会进入安装流程。正式公网环境仍建议使用 HTTPS,以额外保护访问地址、请求元数据和网络隐私。

阅读安全、离线与事务恢复细节
A launcher experience for your server

更新能力之外,也能成为服务器自己的启动界面。

下方是四种自定义主题示例,发行包不会自动绑定示例服务器。项目名称、副标题、封面、强调色、服务器介绍与启动状态可以统一呈现。它与玩家已有的 Minecraft 启动器配合,不接管账号、游戏安装或实例管理。

了解玩家端与启动器接入
梦屿主题的玩家端主页 机巧方舟主题的玩家端主页 橡木原野主题的玩家端主页 余烬防线主题的玩家端主页
项目名称与副标题让玩家一眼认出你的服务器
封面与强调色每个项目都能拥有独立视觉
服务器介绍栏目展示玩法、世界观与加入方式
启动状态与更新信息品牌展示不影响更新主流程
News and storytelling

在玩家启动前,展示公告、活动、玩法与世界观。

首页可以展示最新文章摘要,新闻页继续浏览完整列表。维护公告、活动预告、版本说明、服务器介绍和世界观长文都可以使用 Markdown 独立维护。

玩家端新闻页:初识梦屿:灯还亮着
最新新闻 · 2026.07.30

初识梦屿:灯还亮着

把服务器的世界、角色与故事放进玩家真正会看到的位置,而不是埋在群公告里。

首页展示摘要,点击阅读完整文章
维护公告清晰说明停服时间、影响范围和恢复进度适合运营通知
活动与版本发布新玩法、赛季、活动预告和更新说明适合持续运营
世界观与介绍用 Markdown 编写长文,把服务器设定完整呈现适合沉浸式服务器
内容独立维护标题、日期、摘要和正文分离,新增文章不需要修改界面代码适合长期更新
And more

部署与运行,也替你想好了。

玩家端程序自动更新

服主发布新版玩家端后,旧版会在下次启动时自动更新,不需要重新分发整个整合包。

外部托管与 CDN

带宽不够时,可以把更新内容导出或上传到 WebDAV、OSS、S3、R2 等存储,交给 HTTP 或 CDN 分发。

更新服务器离线时仍可启动

上一次已完整更新并通过检查时,可以继续使用最近一次的有效客户端。

继续使用 PCL 或 HMCL

不接管账号登录、游戏下载或 Java 选择,玩家照常从熟悉的启动器进入游戏。

Forge · NeoForge · Fabric

支持管理三种主流加载器的整合包,按模组身份识别玩家的选择。

不需要另外安装 Java

所有发行包都自带精简运行环境,下载解压即可使用。

桌面版与终端版

Windows 用桌面版,Linux 用终端版的网页管理界面,两边界面一模一样;交互式命令行适合已经在服务器上整理好的文件。

AGPL-3.0 开源

代码公开,可以自由使用、研究和修改;欢迎提交 Issue 交流问题与想法。

从一份标准整合包开始。

完整教程同时覆盖桌面版和终端版,从管理端安装一直写到玩家首次启动验证。

玩家端 Windows x64管理端 Windows / Linux x64管理端桌面版 Windows x64管理端桌面版 Windows x64管理端桌面版 Windows x64自带运行环境,无需安装 Java 下载最新版