Skip to content

Releases

v3.2.2

Choose a tag to compare

@github-actions github-actions released this 18 Nov 02:45

这是 MineDeck v3.2.2,一个小版本。v3.2.1 的发布说明末尾有一节「已经查到、下一版修的」,写了三个问题,这一版都修了,另外修了七个小问题。没有新功能。

开 1.7 到 1.11.2 服务器的,请尽快升级。 v3.2.1 说明里写的是「推断 log4shell 防护可能没起作用」,这次实测证实了:照 v3.2.1 给这段版本的设置起 1.8.9 原版和 Forge 1.7.10 的服务器,在控制台发一句带 ${jndi:...} 的话,服务器都会去连那句话里写的地址,也就是防护没有起作用。升到 3.2.2 以后,已经建好、启动参数里引用着旧配置的这些服务器,会自动换上 Mojang 给这段版本的配置,下次从 MineDeck 里启动时生效。

怎么升级

用着 v3.2.1 或 v3.2.0 的,打开「设置 → 更新与关于」,点「检查更新」,查到新版本以后点更新就能升到 3.2.2。服务器、Java、设置、隧道和 AI Key 都会接着用。更新前先停掉正在运行的服务器。

用着 v3.1.1、v3.1.2 或者 3.2.0 测试版的,也能在程序里直接升到 3.2.2:3.2.0 的 beta.3 到 beta.5 不管更新渠道选的是哪个都查得到,beta.1、beta.2 和 3.1.x 只看正式版,3.2.2 就是正式版,也查得到。

从 v3.1.0 及更早的版本升级时,换程序的是旧版本自己带的更新脚本,它有两种情况换不成,新版本这时已经下载好、放在旁边。处理办法见 v3.2.0 的发布说明「已知情况 → 升级和更新」的第一条。

从 v2.6.1 及更早的版本升级(那时的程序叫 AutoMCHUB.exe),自动更新找不到改名后的文件,请手动下载 MineDeck.exe 放进原来的文件夹。旧的开机自启项会被删掉,需要的话在「设置 → 启动与托盘」里重新打开。

修了什么

v3.2.1 里「已经查到、下一版修的」三条

  • 1.7 到 1.11.2 的服务器,log4shell 防护换成了 Mojang 给这段版本的那份配置(log4j2_17-111.xml)。以前这段版本用的是 Mojang 给 1.12 到 1.16.5 的那份,这段版本自带的 log4j 太老,认不得它。
    • 以后接管、导入这段版本的服务器,直接用新配置。
    • 已经建好的,只要启动参数里引用着旧配置、MineDeck 认得出它的版本,打开 MineDeck 以后就会在后台下载新配置,核对过 Mojang 给的校验值,再把引用旧配置的那一条换掉,别的参数一条不动,run.bat 也跟着重写(重写不成时控制台里会说),下次从 MineDeck 里启动时生效。服务器正开着时也照样换,这一次运行还是旧的,重启以后生效。
    • 没联网、下载不成时什么都不改,服务器照旧用原来的配置开,和以前一样,控制台里会说一声。之后每次启动这台服务器,都会在后台再试一次。
    • 新配置会把带 ${ 的消息整条丢掉,所以这段版本的服务器上,聊天或命令里带这种写法的那一句,不会出现在控制台和日志里。这是 Mojang 这份配置本来的做法。
    • 换下来的旧配置文件 log4j2_112-116.xml 留在服务器文件夹里,不删:你自己的启动脚本可能还在用它。服务器文件夹里原来就有一份 log4j2_17-111.xml、内容和官方的不一样的,会被换成官方那份。
    • 1.7 以前的正式版还没用 log4j,不再给它们加这两条参数。1.12 以后的版本照旧。
  • 待装清单的文件读不出来时,不再当成空清单。 清单存在 MineDeck 文件夹的 data\modcart\cart.json 里。MineDeck 打开时它在、却读不出来(比如正被杀毒软件或同步盘占着),或者内容坏了,清单和暂存在 MineDeck 里的本地模组都原样留着;这段时间不能往清单里加、移除或安装,清单的位置会说明原因,带一个「重试」。读出来以后不用重启就恢复正常。
    • 有一处做法变了:内容坏了的清单文件,以前会被改名成 cart.json.bad,然后从空清单开始;现在会一直挡着,等你修好。报错里会写坏在哪儿(能定位的写大概第几行),可以用记事本修,记事本存出来的格式也认。不想修的话,把这个文件改名挪走,就会从空清单开始;这时暂存在 MineDeck 里的本地模组,下次打开 MineDeck 时会被清掉,电脑上原来那份不受影响。
  • frpc 解压到一半出错,不再留下半截的程序。 解压时先写成临时文件,全部写完、核对过再换成正式的名字,中途出错时,这次写出来的会删掉;文件夹里原有的同名文件不再被覆盖。OpenFrp 的下载缓存按版本存,解压失败时连缓存的压缩包一起删掉,下次重新下载。OpenFrp 给的下载地址只认 https 的(不是 https 的那几个跳过,一个都不剩才报错),下载时的跳转也只跟 https 的。
    • 以前的版本解压失败留下的半截 frpc,这一版还会照用。隧道一直启动失败的,删掉 MineDeck 旁边 runtimes\frpc\openfrp 文件夹里的 frpc exe(自定义 frps 的在 runtimes\frpc\custom),再启动隧道,会重新下载(有同一版本的缓存时直接重新解压)。

七个小问题

  • 手改 tunnels.json、把里面的 seq 改小以后,新加的隧道会和已有的撞号。现在读隧道列表时会接着已有的最大编号往下排;以前已经撞了号的不会自动分开。
  • 导入不带外层文件夹的现成服务端压缩包时,任务标题和返回的包名是一串随机数字,现在用上传时的文件名。服务器的名字照旧是你填的那个。
  • AI 助手的回复太长、已经开始输出以后被截断时,以前说「回复中途断开了」,现在说回复内容过多,请缩小问题范围。
  • 整个上传请求在 64 MiB 以内的,以前也会因为系统临时文件夹所在的盘空间不够被拒收,其实这么小的不往那个盘上写,现在不再查它。更大的被这个盘拒收时,报错里写明是系统临时文件夹所在的盘,能取到盘符的带上盘符。
  • 导入整合包在最后一步失败或者被取消以后,任务页上不再挂着「几个文件待处理」和相关的提醒。
  • 装 AI 伙伴的模组和它的前置、写进服务器的 mods 文件夹失败时,报错会提示「可能正被服务器占用,停服后再试」;盘满、内容核对不上、取消时照旧报原来的原因。
  • 两处说明写错了:接口说明漏了换地图记录里的 stagedBytes;地图导入的使用说明里取消的入口说得不对,换地图要在「换地图」那一页取消。

给 AI 助手、MCP 和自己调接口的人

  • 待装清单的操作:清单文件在、却读不出来时,查看、加入和移除、清空、添加和移除本地文件、检查前置、安装的预览和执行都会被拒绝。直接调 HTTP 接口的回 503 和一句提示,MCP 里是这次工具调用出错(isError);以前会返回一张空清单。在 Modrinth 搜索(modcart.search)不受影响。
  • 保存启动参数(instance.settings.set 带 extraJvm):和以前一样,MineDeck 会按版本补上该有的 log4shell 防护参数;1.7 到 1.11.2 补的是新配置那一条(服务器文件夹里有这份文件时)。

接口的详细说明见 docs/设计与参考/API.md。

下载哪个文件

文件 给谁
MineDeck.exe 开服的人。放进一个单独的空文件夹,双击运行;已经在用旧版本的,换掉原来的那个。
minedeck-companion-neoforge-1.21.1-0.2.1.jar 用了 AI 伙伴的 NeoForge 1.21.1 服上的好友:放进客户端的 mods 文件夹
minedeck-companion-forge-1.20.1-0.2.1.jar 同上,Forge 1.20.1 的服
SHA256SUMS 校验和,自动更新会用到,一般不用管

伙伴模组还是 0.2.1,和 v3.2.1 的是同一份,已经装过的好友不用换。

这一版实际试过的

  • 自动测试:在最终代码上,Go 测试 42 个包全部通过,代码检查(go vet)没有提醒;界面交互测试 264 条、界面原型自检 162 个场景全部走通。删文件和清单读不出来时的那几处保护,写代码的一方逐条反着试过,合并时又抽了几处再试:把对应的代码改回去,相关的用例都会失败。
  • log4shell 实测:用 Java 8 和官方服务端,在本机起了一个只监听 127.0.0.1 的端口,在服务器控制台发 say ${jndi:ldap://127.0.0.1:<端口>/x},看那个端口有没有被连。1.8.9 原版和 Forge 1.7.10 用旧配置时各被连了 2 次,换成新配置以后 0 次,控制台照常输出,「启动完成」照常认出来;1.12.2 原版和 Paper 1.16.5 照旧用原来的配置,没被连。最后用发版的那条命令编出来的程序,在两台摆成旧版样子的服务器(1.8.9 和 1.12.2)上又走了一遍:没联网时什么都不改,服务器照旧能开,旧配置下照样被连了 2 次;联网以后,1.8.9 那台在 MineDeck 打开后自动换上了新配置,旧文件留着,起服以后「启动完成」照常认出来,一次都没被连;1.12.2 那台没被动,也没被连。
  • 复审:最要紧的三条,Codex(GPT-6-Astra,max 档,只读)看了两遍。第一遍看整支改动,指出三处,都改了:换下来的旧配置文件会被删掉,可它可能还在被你自己的启动脚本用着;启动脚本读不出来时也照删;MineDeck 所在文件夹的名字里带方括号时,清理 frpc 解压残留会删到旁边别的文件夹里的东西。第二遍只看这次修改,结论是可以合。另外七个小问题是 Gemini 写的,由 Claude 读过一遍。这份发布说明请 Codex(GPT-6.2-Astra,max 档,只读)对着代码核对过,指出的说得不准和漏写的地方都改了。

还没实测过的

  • log4shell:Spigot、别的 Paper 1.8.8 构建和别的 1.7 到 1.11.2 的 Bukkit 系服务器没试过;换配置只在摆成旧版样子的服务器上试过,没走接管和导入。
  • 待装清单:没拿真的杀毒软件或同步盘去占着清单文件,用的是在测试里独占这个文件的办法;没有读取权限的那种没单独测过。
  • frpc:没从 OpenFrp 真的下载一次(下载地址只认 https 以后);自定义 frps 没拿真的 frp 发行包解压过。
  • 七个小问题只有自动测试,没在真窗口里试;伙伴模组写进 mods 时盘满的那种没单独测过。
  • v3.2.1、v3.2.0 发布说明里写的那些照旧没实测,见 v3.2.1 的发布说明和 v3.2.0 的发布说明。

已知情况

  • Paper 1.8.8(试的是 build 445):套上 Mojang 的日志配置以后(v3.2.1 用的那份和这一版换上的这份都一样),控制台在「Loading libraries」之后就没有输出了,MineDeck 认不出启动完成,服务器其实已经起来了(它自己的日志里有 Done)。v3.2.0 起就是这样,还没定怎么改。这个构建自己修过 log4shell,不加 Mojang 的配置也没被连。别的 1.7 到 1.11.2 的 Bukkit 系构建没试过,可能也这样。
  • 当初防护配置没下载成的 1.7 到 1.16.5 服务器(建的时候没联网),这一版不会自动补上,MineDeck 的这层防护还是没加上。开这类服务器、又开了内网穿透让外人进来的,请只让信得过的人进。
  • 待装清单读不出来的那段时间:删掉一台服务器,读出来以后清单里还留着那台服务器的记录,之后再建一台同名的会看到它;工具箱「导出 Modrinth 整合包」选「自己挑模组」时会说清单是空的,文件修好以后,先打开一次待装清单,导出才恢复。
  • 从电脑添加模组时,查不到那个盘还剩多少空间(少数网络盘、特殊的挂载方式),待装清单的位置也会显示「无法显示待装清单」,其实清单没事:点「重试」就恢复,那个文件为什么没加进去,看它旁边的提示。
  • OpenFrp 查版本的那一步和自定义 frps 的下载,跳转还不限 https。自定义 frps 下载下来的文件会核对官方的校验值。
  • v3.2.1 已知情况里的几条照旧,见 v3.2.1 的发布说明。它末尾「已经查到、下一版修的」三条,以及 v3.2.0 已知情况里小文件被临时盘拒收、导入任务标题是一串数字、AI 回复太长说成断开这三条,这一版都修了。

遇到问题,欢迎在 GitHub 上提 Issue,写清楚做了什么、看到了什么。不要贴出 API Key 和各种令牌。

Full Changelog: v3.2.1...v3.2.2

v3.2.1

Choose a tag to compare

@github-actions github-actions released this 17 Nov 15:11

这是 MineDeck v3.2.1,一个小版本。v3.2.0 的「已知情况」里写过:同一处设置在两个窗口里同时开着时(比如电脑上的 MineDeck 窗口和手机上的管理页),后保存的一边会把另一边刚存的改回原样,一共十处。这一版把这十处都修了,顺带修了同一轮复审记下的两个小问题。没有新功能。

怎么升级

用着 v3.2.0 的,打开「设置 → 更新与关于」,点「检查更新」就能升到 3.2.1。服务器、Java、设置、隧道和 AI Key 都会接着用。更新前先停掉正在运行的服务器。

用着 v3.1.1、v3.1.2 或者 3.2.0 测试版的,也能在程序里直接升到 3.2.1:3.2.0 的 beta.3 到 beta.5 不管更新渠道选的是哪个都查得到,beta.1、beta.2 和 3.1.x 只看正式版,3.2.1 就是正式版,也查得到。

从 v3.1.0 及更早的版本升级时,换程序的是旧版本自己带的更新脚本,它有两种情况换不成,新版本这时已经下载好、放在旁边。处理办法见 v3.2.0 的发布说明「已知情况 → 升级和更新」的第一条。

修了什么

两个窗口同时开着同一处设置时,现在只存这一页改过的那几项,后保存的一边不会再把另一边刚存的改回去。两边改了同一项的,以后存的为准。具体是这十处:

  • 服务器的「设置 → 启动与内存」:内存和 JVM 参数各存各的,只存这一页改过的那一样。
  • 服务器的「定时任务」:崩溃自动重启拨过才存;任务一条一条地加、删,另一边刚加的任务不会被删掉,刚删的也不会加回来。
  • 隧道的「编辑」:只存这次改过的名称、绑定的服务器、跟随启动;一样都没改就直接关掉。
  • 隧道的「清除凭据」:只清凭据,别的不动。
  • AI 伙伴的禁挖区域:一个一个地加、删、改,改就是删掉原来那个、再加上改好的。两边加了同名的区域,后加的一边会提示已经有了。
  • 工具箱「导出 Modrinth 整合包」的草稿:只存改过的几格。自动保存一次只发一个,前一次还没存完时又改的,等它存完再接着存;这时整页刷新或关掉页面,没来得及发的那份也会当场发出去。
  • 「设置 → 手机远程管理」改访问密码:只存密码,不再连开关一起存。以前另一边刚关掉了远程管理,这边一改密码,又会把它打开(重启 MineDeck 以后生效)。
  • 只能在这台电脑上改的三处,开着两个本机页面时也一样修了:
    • AI 设置里的自填单价:一条一条地加、删。
    • 游戏内 AI 的「能让 AI 执行命令的玩家」:一个一个地授权、收回。以前一边刚收回了谁,另一边给别人授权时会把那个人又授权回去。
    • AI 设置里的服务商:服务商、接口地址、模型、Key 这几项互相牵连,合不到一起,所以这一处不合并。别的窗口刚改过时,这一页保存会被拦下、什么都不改,弹窗请你重新读取最新的设置再改。

两个小问题:

  • 服务器「设置 → 常用」里原来文件里没有的项(比如资源包链接),在同一页里填上、保存,再清空、保存,以前提示已保存,文件里却还留着刚才填的值。现在清空也会存进去。
  • 添加隧道时凭据太短的那句提醒,原来写「6 个字符」,实际是按字节算的,改成了「不到 6 个字节(字母和数字一个算一个,汉字一个算三个)」。

给 AI 助手、MCP 和自己调接口的人

为了「只存改过的」,几个操作的参数跟着变了。界面不用管,AI 助手、MCP 客户端和自己写脚本调接口的请留意:

  • 改定时任务(instance.policies.set):crashRestart、schedules 不传就是不改。以前不传等于关掉崩溃重启、清空任务表。新加了 addSchedules、removeSchedules,按条加、删。
  • 修改隧道(tunnel.update):只改传了的项,没传的沿用存着的,不再收 publicAddr。以前是整份替换。
  • AI 服务商(ai.provider.set):读设置时 provider 里多了一个 rev。保存时带上它,别处改过就回 409、什么都不改;不带照旧不检查。
  • 自填单价(ai.prices.set)加了 addPrices、removePrices,prices 不再必填;伙伴设置(companion.settings.set)加了 addZones、removeZones;游戏内 AI(gameai.set)加了 addAllowed、removeAllowed;工具箱草稿(toolbox.mrpack.draft.save)只改传了的字段。原来整份传的写法(prices、zones、allowed、整份草稿)照旧能用。

接口的详细说明见 docs/设计与参考/API.md。

下载哪个文件

文件 给谁
MineDeck.exe 开服的人。放进一个单独的空文件夹,双击运行;已经在用旧版本的,换掉原来的那个。
minedeck-companion-neoforge-1.21.1-0.2.1.jar 用了 AI 伙伴的 NeoForge 1.21.1 服上的好友:放进客户端的 mods 文件夹
minedeck-companion-forge-1.20.1-0.2.1.jar 同上,Forge 1.20.1 的服
SHA256SUMS 校验和,自动更新会用到,一般不用管

伙伴模组还是 0.2.1,和 v3.2.0 的是同一份,已经装过的好友不用换。

这一版实际试过的

  • 自动测试:在最终代码上,Go 测试 42 个包全部通过,代码检查(go vet)没有提醒;界面交互测试 263 条、界面原型自检 162 个场景全部走通。这一版新加的用例(「两个窗口」一组十几条,以及 Go 里的合并、加锁和过期拦下)逐条反着试过:把对应的代码改回去,它们都会失败。
  • 真窗口:用发版那条命令编出来的程序,在一份测试副本里打开真窗口,用脚本代替人手试了六处:手机远程管理改密码、启动与内存、定时任务、隧道的编辑、AI 服务商被拦下、工具箱草稿。每一处都是页面先打开,再用程序自己的接口模拟另一个窗口存一项,然后在页面上改另一项、保存,最后读回来:另一个窗口存的那项都还在。AI 服务商那一处被拦下、什么都没改,重新读取以后显示的是另一个窗口存的。窗口里没有脚本报错。只在一块 100% 缩放的屏幕上试过。
  • 复审:Codex(GPT-6-Astra,max 档,只读)看了三遍。前两遍看整支改动,指出的三处都改了:AI 服务商保存以后拿到的可能是另一个窗口的版本号;草稿第一次还没存完又改回原样,会漏存;排着没发的修改碰上整页刷新会丢。第三遍只看最后那处修改,结论是可以发,另记了三条草稿的边角情况,写在下面的「已知情况」里。

还没实测过的

  • 两台真的设备同时开着:真窗口那一轮是一个窗口加脚本,没拿手机和电脑两边真的同时点。
  • AI 伙伴的禁挖区域、游戏内 AI 的授权名单、自填单价、隧道的清除凭据这四处没在真窗口里试,只有自动测试。
  • **工具箱草稿「整页刷新时当场发出去」**那一层只在测试用的 Chromium 里试过。程序被直接关掉时,本机的后端跟着退出,正在存的不一定存得上,这和 v3.2.0 一样。
  • 参数变了的那几个操作(定时任务、修改隧道等)没拿真的 MCP 客户端或 AI 提案走一遍,只有自动测试。
  • v3.2.0 发布说明里写的那些(真实账户、真实 AI Key、用游戏客户端进服等)照旧没实测,见 v3.2.0 的发布说明。

已知情况

  • 几处整段保存的单个输入框:AI 伙伴「攻击时不许打的生物」、游戏内 AI 触发前缀的别名、音乐共享的排除名单,以及第一次打开时的引导。它们本身就是一项,两个窗口都改了时,以后存的为准。
  • 点了保存、还没存完的那一两秒里接着输入的内容,可能被清掉:改访问密码、添加自填单价、隧道的编辑框、禁挖区域的编辑框、游戏内 AI 授权的输入框是这样。v3.2.0 就这样。
  • 工具箱的整合包草稿,保存还没完成时马上刷新或关掉页面:极少数时候,最后改的那一格没存上,或者被改回前一刻的样子;两个窗口同时改同一格时,也可能是先存的那边留下。v3.2.0 也有同类情况。
  • AI 助手改启动参数时,确认卡片里列的 JVM 参数不含 MineDeck 会自动补上的 log4shell 缓解参数,实际存进去的会带上。
  • v3.2.0 已知情况里的别的几条照旧,见 v3.2.0 的发布说明;其中「两个窗口同时改设置」那一节和「常用」里清空不生效那一条,这一版修了。

已经查到、下一版修的

  • 1.7 到 1.11.2 的服务器,log4shell 漏洞的防护可能没起作用:MineDeck 给这段版本用的是 Mojang 给 1.12 到 1.16.5 的那份日志配置,Mojang 给 1.7 到 1.11.2 的是另一份。我们推断这段版本自带的 log4j 太老,认不得现在加的防护,还没实测。在修好之前,开这段版本的服务器、又开了内网穿透让外人进来的,请只让信得过的人进。
  • 待装清单的文件在启动那一刻读不出来时(比如正被杀毒软件或同步盘占着),清单会被清空,暂存在 MineDeck 里的本地模组也会被删掉。这是读代码看出来的,还没复现过。电脑上原来那份模组文件不受影响,重新从电脑添加就行。
  • OpenFrp 的 frpc 解压到一半出错时(比如盘快满了),会留下半截的程序,以后启动这条隧道一直失败。碰上的话,删掉 MineDeck 旁边 runtimes\frpc\openfrp 文件夹里的 exe 和 cache\frpc 文件夹里的 openfrp-frpc.zip,再启动隧道,会重新下载。

遇到问题,欢迎在 GitHub 上提 Issue,写清楚做了什么、看到了什么。不要贴出 API Key 和各种令牌。

What's Changed

  • 两个窗口同时开着同一处设置,后存的一边不再把另一边刚存的改回去(剩下的十处) by @Trasperioooooon in #30

Full Changelog: v3.2.0...v3.2.1

v3.2.0

Choose a tag to compare

@github-actions github-actions released this 17 Nov 05:05

这是 MineDeck v3.2.0 正式版。

和 v3.1.2 比,这一版加了几样东西:拿一张已有的地图开服、给服务器换地图;在 MineDeck 里连上 OpenFrp 和樱花的账户;AI 助手的排版和对各家服务商的兼容;左侧栏的「工具箱」;检查更新时可以选「稳定版」还是「最新版」。界面按一次可用性走查的结果整理了一遍,「仅本机」的判定收紧了,下载、备份、上传这些写磁盘的地方也加固了一遍。这些在 v3.2.0-beta.1 到 beta.5 里陆续发过测试版,下面合在一起说,每一项更细的说明见 beta.1、beta.2、beta.3、beta.4、beta.5 的发布说明。

怎么升级

用着 v3.1.2 或 v3.1.1 的,打开「设置 → 更新与关于」,点「检查更新」就能直接升到 3.2.0。服务器、Java、设置、隧道和 AI Key 都会接着用:它们都存在程序所在的文件夹里,换程序不用动它们。更新前先停掉正在运行的服务器,有服务器开着时不会更新;保险起见,可以先把整个 MineDeck 文件夹备份一份。要手动替换 MineDeck.exe 的,先完全退出 MineDeck(在托盘图标上右键退出),再替换。

从 v3.1.0、v3.0.0 或者 3.1.0 测试版也可以在程序里直接升。只是这时换程序的是旧版本自己带的更新脚本,它有两种情况换不成;新版本这时已经下载好、放在旁边,处理办法见下面「已知情况」的第一条。

用着 3.2.0 测试版的:

  • beta.3、beta.4、beta.5:不管更新渠道选的是「稳定版」还是「最新版」,检查更新都能查到 3.2.0,直接升。
  • beta.1、beta.2:这两版检查更新只看正式版。3.2.0 就是正式版,也能直接查到、直接升,不用再手动换程序。
  • 没选过更新渠道的,升到 3.2.0 以后按稳定版查,只提示正式版。还想接着试以后的测试版,到「设置 → 更新与关于」里选「最新版」。
  • 用过 beta.1 到 beta.3、又把服务器里的文件设成过只读的:那几版保存只读文件时会报成功、其实没存上,文件夹里可能多出一个名字是原文件名后面跟着一串乱码的文件。怎么查、怎么处理,见 beta.4 的发布说明 里「请留意」那一段。没设过只读的不会碰上。

用已有的地图开服、换地图

手里有一张 Java 版的地图(下载来的冒险、空岛地图,自己单人玩了很久的存档,朋友发来的旧服世界),现在可以直接拿它开服,或者把服务器正在用的地图换成它,换了以后还能换回来。完整的说明在《用已有的地图开服、换地图》,这里说要点。

  • 拿地图开一台新服务器:在「新建服务器」里选「用已有地图开服」,先选地图。MineDeck 读出地图最后是用哪个版本存的、用过什么核心,替你预选同样的版本和合适的核心,不会自作主张换成最新版。地图在服务器建好之前放进去,放不进去整台就不建。
  • 给现有的服务器换地图:服务器详情的「世界与备份 → 换地图」,点「导入并替换当前地图」。在这台电脑上可以直接选地图文件夹;别的设备上用网页打开的,上传地图的 ZIP(最大 8 GB)。服务器开着时勾「停服并导入」,MineDeck 会让服务器自己存盘退出,等不到它停下就放弃,一个文件都不换。
  • 先看预览再动手:预览里写着地图的版本和服务器的版本、找到了哪些维度、带了哪些数据包和资源包、有没有用过模组的迹象、会换掉哪些文件夹。红色的是不能导入的原因,黄色的要勾「我已了解」才能继续。地图建议改的设置(难度、默认游戏模式这些)默认不改,你勾了才改。
  • 旧地图一个文件都不删:换的时候,原来的地图连同下界、末地整体移进「恢复点」。「换地图」页下面列着每次导入留下的恢复点,点「恢复导入前的地图」就能换回去。恢复点不会被备份轮换挤掉,一直留到你手动删除。
  • 换到一半出了问题会自动退回:换图的时候 MineDeck 被关掉或者电脑断电,下次打开时它会先把这台服务器恢复到换图之前,恢复好之前这台服务器不能启动。
  • 版本对不上:地图比服务器新的不能导入,请新建一台和地图同版本的服务器;地图比服务器旧的可以导入,但要确认,服务器第一次启动时会把这份副本升级成新格式。
  • 认得出不是地图的东西:基岩版存档、建筑蓝图、资源包、数据包、整合包、交接包,会告诉你它是什么、该去哪;.rar、.7z 和加了密码的压缩包请先解开。

这一版不做的:不会改写玩家文件(单人存档转服务器时,背包接不接得上取决于主人用什么账号进服,预览里有说明);地图带的资源包不会自动发给玩家;世界文件夹本身是链接的服务器不支持换地图;多世界插件建的其他世界不会动。

OpenFrp 和樱花的账户

这一部分由 awaxiaoyu 贡献。

  • 「内网穿透」页的「平台账户」里,可以连上自己的 OpenFrp 账户(在浏览器里授权,MineDeck 不收账号密码)或者樱花的账户(粘贴访问密钥),看账户、流量和平台上的隧道。
  • 可以在 MineDeck 里直接到平台上新建隧道(TCP 或 UDP),建好就导进来;平台上已有的隧道也能导进来。樱花建隧道时可以勾「这是公开服务器」,勾了只列公开服专用的节点:这是樱花的规定,用错节点会被封号。
  • 签到和购买都是打开官网,MineDeck 不代签、不代下单。
  • 账户的凭据加密保存在这台电脑上。连接账户、签到、建隧道、导入隧道只能在运行 MineDeck 的这台电脑上做,局域网里别的设备打开时只能看。断开账户只清掉凭据,已经导入的隧道不动。

AI 助手

  • 回复的排版:标题分级显示;表格、列表、勾选框、删除线、斜体按 Markdown 的样子显示;代码块保留语言,带复制按钮,还没写完的代码块会标出来,不再把前面的段落吞掉。回复不渲染图片,链接只认 http 和 https。
  • 思考内容:模型给出的思考过程会转发出来,默认折叠着。
  • 面板可以拖宽,宽度记在这台设备上。
  • 选模型:模型框可以手填,也可以点箭头拉取服务商的模型列表、在里面搜。服务商不提供模型列表时,退回预设里的建议模型。
  • 兼容更多服务商:OpenAI 兼容的服务商可以选鉴权方式;需要每一轮都把思考内容带回去的服务商(比如 DeepSeek)现在能正常连续调用工具;Key 和地址对不上时会提醒。新加了小米 MiMo 的预设。
  • 测试连接会多走一轮工具调用,能提前发现「第一轮能过、交回工具结果就报错」的服务商。
  • 报错分得更细:额度用完、请求太频繁、Key 不对、地址不对分开说。

工具箱

左侧栏「内网穿透」下面多了一项「工具箱」,放和朋友一起玩时用得上的小工具。两个工具都不改任何服务器里的文件。生成的文件可以直接下载;在运行 MineDeck 的这台电脑上,也可以顺手存到一个文件夹里。

  • 离线皮肤包:离线模式的服务器上,大家都顶着默认皮肤。把朋友们的皮肤 PNG 放进来,MineDeck 按每个人的玩家名算出游戏会给他用哪一个默认皮肤,把皮肤图换进去,打成一个资源包。每个朋友把这个资源包放进自己客户端的 resourcepacks 文件夹并启用,就能看到彼此的皮肤。也可以不按玩家名、按顺序替换。支持 1.8 及以后的版本,老的 64×32 皮肤会自动扩成现在的格式。
    • 默认皮肤的位置是游戏按玩家名定死的:1.19.3 起有 18 个,更早只有 Steve 和 Alex 两个。人一多,两个人撞进同一个位置的机会不小(5 个人大约四成),撞上了只能二选一,页面上会标出来让你选。手臂是粗是细也是游戏按玩家名定的,资源包改不了,对不上的看起来会有点别扭。
    • 想让服务器自动把资源包推给进服的人,要自己把它放到网上能直接下载的地方,再在服务器的「设置 → 全部配置」里填 resource-pack 和 resource-pack-sha1(生成时附带了 SHA-1)。工具箱不会改服务器的配置。
  • 导出整合包(Modrinth 的 .mrpack 格式):从已有的模组服务器导出它的模组(可以选带上 config 文件夹),或者自己挑模组,MineDeck 找齐必装的前置。导出的文件用 Modrinth App、Prism、HMCL、PCL2 这些启动器都能一键安装。
    • Modrinth 上能找到的模组只写下载地址,朋友安装时从官方下载;找不到的(自己改过的、只在别处发布的)整个打进包里,分享前请留意原作者是否允许转发。
    • config 文件夹默认不带。勾上的话,看起来放着密码、令牌、密钥、数据库的配置文件会尽量挑出来不打进包,预览里列出跳过了哪些;认不出的写法难免有,打进去的配置文件也都列在预览里,发之前请看一眼。
    • 自己挑的这份清单是工具箱自己的,和新建服务器时挑的模组分开,只在客户端用的模组(小地图、光影加载器之类)也能挑。音乐共享用的语音桥模组只在服务端用,不会打进包;AI 伙伴模组朋友的客户端要装,照常带上。

更新渠道

「设置 → 更新与关于」里可以选「稳定版」或「最新版(包括测试版)」。稳定版只提示正式版;最新版连测试版一起提示,按版本号挑最新的。没选过时,用着正式版按稳定版查,用着测试版按最新版查。不会提示比你现在用的更旧的版本:用着测试版又选了稳定版,在下一个正式版出来之前不会有更新提示。不管哪个渠道,下载的程序都要和官方发布的 SHA256SUMS 对得上才会换上。

界面:按可用性走查整理了一遍

服务器详情页的标签从十几个收成七个,连接地址、启动失败的原因、端口被占这些「出了事要马上看到」的信息放到了页头上;新建、导入的流程补上了取消、返回修改和没装上的文件的后续处理;各处的叫法统一了一次。

服务器详情页

  • 标签收成七个:控制台、玩家、世界与备份、插件 / 模组、定时任务、设置、扩展。原来的「地图」并进了「世界与备份」,叫「换地图」;「资源」和「待装清单」合成一页,上面是已安装的,下面是热门、搜索和从电脑添加;「常用设置」「内存 / 启动」「全部配置」收进「设置」,分别叫「常用」「启动与内存」「全部配置」;游戏内 AI、AI 伙伴、音乐共享收进「扩展」。旧的书签和链接会自动跳到新位置。
  • 连接地址在页头和服务器卡片上:同一个局域网里的朋友要填的 IP:端口,点一下就能复制。不在同一个网络的朋友,还是用内网穿透的隧道。
  • 出了事放在页头:上次启动失败的原因、整合包里没装上的文件、Java 找不到了(比如把服务器从别的电脑拷过来)、模组要求更高版本的 Java,有就一直显示在页头的提示区,事情解决了才消失,切到别的页再回来也还在。报错提示落在提示区的下面,不挡「改端口」「去换 Java」这些按钮;开服没成功、原因是找不到 Java 或者端口被占时,提示上直接给「去换 Java」或「改端口」。
  • 端口被占了会说清是谁:被 MineDeck 里另一台服务器占着时,直接说是哪一台,并给「改成 N 并启动」;被别的程序占着时给「改端口」,带你去设置里的端口那一项。
  • 加了「重启」按钮;改了需要重启才生效的设置,保存后的提示和设置项旁边的标注说法一致。
  • 服务器信息集中在「设置 → 启动与内存」页顶:核心、版本、端口、Java、服务器文件夹,能复制、能打开。「打开文件夹」菜单里多了「备份」。
  • 备份页写明现在的世界从哪来:用已有地图新建的、换过地图的,写导入时的来源和时间;换回过的写换回了;从备份还原过的写是哪一份。改过备份存放位置的,写明另有几份旧备份还在原来的哪个文件夹,列表里那几份标着「在原来的文件夹」,照常能还原、能删。
  • 还原备份:还原前要做什么、会不会影响正在运行的服务器,确认框里一次说清。

新建、导入和接管

  • 「新建服务器」页有五种方式,「用已有地图开服」单独成了一张卡片。
  • 默认端口避开被占着的:新建、导入整合包、用已有地图开服时,默认端口被 MineDeck 里别的服务器、或者这台电脑上别的程序占着的话,换成下一个空着的,端口框下面写明换了、被谁占着;手填的端口被占着会提示一句,不拦你。接管已有服务器时,端口和 MineDeck 里别的服务器撞了的,换成空着的并写明,确认接管时写回它的 server.properties;被别的程序占着的只提示、不换(多半是原来那台服务器还开着,先把它停掉)。查的是系统里正在监听的端口,不会让防火墙弹窗。
  • 整合包里没装上的文件会一直留着:以前要在那一次运行里处理完,关了程序就找不回来。现在服务器详情页头会一直提示有几个整合包文件没装上,点开能逐个处理,跳过的以后也能在插件 / 模组页再处理。
  • 可以取消、可以返回修改:新建服务器、导入整合包、导入现成服务端可以在任务页取消,会等半成品清理完再结束,显示「已取消」,不当成失败;点「返回修改」回到原来的表单,填过的都还在。换地图取消了也显示「已取消」,并写明没有替换任何文件。任务页上正在进行的、出了问题的排在前面,做完的折起来。
  • 选构建版本默认收进「高级」;选插件这一步能跳过;同意 EULA 的开关不会被底部的按钮挡住。

删除、弹窗和提示

  • 删除服务器默认只「移出列表」,文件夹留着(见下面「升级以后要留意的」)。移出接管来的服务器时,会说清楚 MineDeck 在那个文件夹里留下了哪些文件。
  • 弹窗里报错时,填好的内容不会丢;弹窗叠着开时,Esc 只关最上面那一层。
  • 报错提示至少停留 20 秒,鼠标停在上面或打开了详情时不会消失。

内网穿透和设置

  • 隧道可以编辑:名称、绑定的服务器、跟随服务器启动都能改;凭据留空就沿用原来的,换了服务商或服务器地址才要重新填。隧道卡片上信息更全。
  • 内网穿透页顶写明:同一个局域网的朋友不用隧道,直接用服务器页上的连接地址。「添加隧道」和「平台账户」是什么关系也写清楚了。
  • 设置里原来的「远程访问」改叫「手机远程管理」,说的是用手机或别的电脑的浏览器打开 MineDeck 的管理页,和朋友进游戏的地址无关。
  • 「设置 → AI」页顶说明三样 AI 各是什么:标题栏上的「AI 助手」、服务器里的「游戏内 AI」、陪玩的「AI 伙伴」。
  • 「点关闭按钮时缩到托盘」开关的说法改清楚了,第一次缩到托盘时会提示一次;侧栏底部加了「退出 MineDeck」。
  • 导出交接包时,选的文件夹不存在可以「新建并导出」。存放位置改了以后可以撤销。
  • 工具箱「导出整合包」读不出存好的草稿时,页面上常驻一条说明,带「重新读取」。

正式版前又改的几处

  • 页头的主按钮跟着状态走:服务器详情页的页头,停着时绿色的主按钮是「启动」,运行中、启动中时是「停止」。以前运行中仍把点不了的「启动」画成绿色主按钮。点不了的主按钮改成了灰色。
  • 窗口很矮时,命令框留在窗口里:窗口很矮时(最小窗口 1024×576,或者笔记本屏幕放大以后差不多这么矮),控制台的日志区让出位置,输入命令的框不会被挤到窗口外面,快捷键提示收起来;页头的提示条多、放不下时,整页照常能往下滚到命令框。
  • 真的复制成功才说「已复制」:剪贴板写不进去时,以前也会提示「已复制」。现在写不进去就弹出「请手动复制」的框,里面是完整原文、已经选中:电脑上按 Ctrl+C,手机上长按选中的文字再拷贝。用手机经局域网打开管理页时比较常见。
  • 能复制的多了:「设置 → 手机远程管理」里,放行防火墙的那条命令和管理页地址都有了复制按钮,复制的是完整原文,不带旁边的说明文字,也不含访问密码。隧道卡片上的报错原文加了「复制原文」。
  • AI 助手面板不再盖住启动、停止:窗口够宽时(让出面板的位置以后,主区还有 720 像素宽),面板打开时主区让到左边,详情页的启动、停止按钮露在面板左侧。窗口不够宽、或者把面板拖得很宽时,面板照旧浮在主区上面,主区的版面不变。
  • 深色的「方块」配色里,卡片的边框更清楚;服务器列表的搜索框变宽了。

「仅本机」收紧了

  • 算本机要两样都有:连接来自这台电脑,并且带着这次启动的令牌(MineDeck 自己的窗口和启动地址里带着)。以前只看连接是不是来自这台电脑,经本机的隧道程序转发进来的请求也会被当成本机。这样一来有一种用法会变,见下面「升级以后要留意的」第一条。
  • 隧道不能指向 MineDeck 自己的网页端口,也见「升级以后要留意的」。
  • 操作记录里的凭据遮得更全了;隧道日志里也会遮掉这次启动用的凭据。

写磁盘的地方加固了

  • 同一个磁盘上的大活排队做:复制地图、备份、解包这类大量写文件的操作,落在同一个磁盘上时排队进行,开始前和过程中都会看磁盘还剩多少。磁盘剩余不到 256 MB 时,下载和备份会直接告诉你空间不够。
  • 上传(地图、整合包、交接包、本地模组):30 秒没有收到新数据会停下并提示重新上传;超过上限的当场拒绝,不用等传完。
  • 打开压缩包之前先看它申报的大小:包尾写着几百万个文件的压缩包会直接拒掉,不会先按这个数去要内存。导入、还原备份、下载来的 Java 和 frpc 都过这一道。
  • 还原之前先检查备份:压缩包能不能打开、里面的路径对不对,检查没过不会动现有的世界。

正式版前修的

下面这些是 v3.1.2 里也有、在测试版期间修掉的。测试版自己带进来、后来又修掉的问题,这里不列,见各测试版的发布说明。

  • 隧道卡片上的公网地址不会再显示成 ext.go:37。OpenFrp、樱花的隧道启动以后,卡片上的公网地址以前有时不是能连的地址,而是 ext.go:37 这样的一串,那是 frpc 日志里标注程序位置的一小段。现在会跳过这类内容,取这一行里真正的地址;地址后面紧跟着别的字符时,端口也不会被截错。域名和 IP 都出现时照旧优先用域名。
  • 隧道配置读不出来时,不会再把原来的隧道盖掉。以前 MineDeck 启动时,tunnels.json 要是刚好被别的程序占着(杀毒软件、同步盘),或者文件坏了,隧道页会显示成一条隧道都没有;这时再添加一条,原来的隧道和保存的凭据就全没了。现在读不出来时,隧道页会直接说明原因,读出来之前不能添加、修改、删除或启动隧道,原文件不动;占用放开或者文件修好以后会自动恢复,不用重启。
  • 隧道配置写不进磁盘时会告诉你。以前磁盘满了、文件被设成只读的时候,添加隧道显示成功,重启以后却不见了。现在会提示这次没有保存。在平台上已经建好、只是本机没存上的那一条,会提醒你去「导入」,不要再创建一次。
  • 26.1 起的服务器,改了难度重启以后会生效了。以前改了游戏里不变:从 26.1 开始,游戏把难度存进了世界数据,服务端只在新建世界时读一次 server.properties 里的难度,以后改设置不再起作用。现在 26.1 及以后的服务器开好以后,MineDeck 会按设置里的难度补一条 difficulty 命令,控制台里能看到这一句。极限模式的世界游戏锁在困难,不发这条命令。这带来一处变化,见下面「升级以后要留意的」。
  • 便携 Java 装到一半中断的,下次会重新装。以前只要 bin\java.exe 在,就算这套 Java 装好了;下载或解压到一半被打断(磁盘满了、程序被关掉),留下的半截会被直接拿去开服,报的是 Java 自己的错误,也不会重新下载。现在开始装之前先放一个「还没装完」的记号(runtimes\java-N.incomplete),整套装完才拿掉,记号还在的下次会重装;解压失败时把解出来的一半删掉;一开始就按解开以后的总大小查磁盘空间,放不下就不动原来的文件夹。以前装好的 Java 照旧能用。
    • 以前就装坏的那一份没有记号,MineDeck 认不出来。如果你碰到过开服时 Java 报一串看不懂的错、怎么重试都一样,可以看看 MineDeck 文件夹里的 runtimes,把那个版本的 java-N 文件夹删掉,下次开服会重新下载。
  • 整合包导入完成之前不出现在服务器列表里。以前导入还没做完,列表里就有了一台看着建好了、其实文件还没放全的服务器。现在导入失败时,半成品也会清掉。
  • 保存设置和配置文件时程序被打断,不会留下写了一半的文件。
  • 两个窗口同时开着同一台服务器的设置,「常用」「全部配置」不会再把另一边刚存的改回去。以前这两页保存时把整页的值都写回 server.properties:电脑上改了难度并保存,手机上早就开着的设置页再改人数、保存,难度就被改回原样。现在只写这一页改过的项,两边改了同一项的,以后存的为准。别的几处还会这样,见「已知情况」。

升级以后要留意的

  • 在这台电脑的浏览器里不带令牌打开 MineDeck、用访问密码登录,现在只有局域网会话的权限。 以前这样算本机;现在选文件夹、改 AI 设置这类「仅本机」的操作会被拒,要回到 MineDeck 的窗口里做,或者用带令牌的启动地址打开。局域网里别的设备和 MineDeck 自己的窗口,用法不变。
  • 隧道不能指向 MineDeck 自己的网页端口。 自定义 frps 隧道的本地端口如果是 MineDeck 这次的网页端口,新增、修改、启动都会拒绝,以前存下的这种隧道也启动不了。隧道该指向游戏服务器的端口。
  • 删除服务器默认只「移出列表」。 文件夹留着,提示里写出文件夹的位置并能直接打开;要连文件一起删,得另外选上。
  • 新建服务器时白名单默认关着。 26.3 起的服务端自己生成配置时默认开白名单、名单又是空的,以前按默认值开出来的服务器,朋友进不来。现在新建、导入整合包、用已有地图开服的表单上有「只允许白名单里的玩家进入」的开关,默认关,旁边写明了。接管已有服务器沿用它原来的设置。
  • *...
Read more

v3.2.0-beta.5

v3.2.0-beta.5 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 16 Nov 13:30

这是测试版,给自己和好友试用、找问题的,可能还有毛病。

  • 用着 v3.2.0-beta.3 或 beta.4 的,「设置 → 更新与关于」里没选过更新渠道、或者选的是「最新版」,检查更新就能直接换到这一版。选了「稳定版」的看不到它。
  • 从 v3.2.0-beta.2 或更早的版本换过来,要手动换一次程序。 那些版本检查更新时只看正式版,看不到测试版。请先关掉 MineDeck,下载下面的 MineDeck.exe,换掉原来文件夹里的那一个。服务器、设置和隧道都存在那个文件夹里,不用动。
  • 正式版会是 v3.2.0。

这一版只修问题,没有新功能,界面没有变化。前几次发版时自动测试常常要重跑几遍才通过,这次把历次失败逐一查清了:多数是测试自己的毛病,也有几处是程序里真的问题。顺着这次排查,又把 beta.1 里一次大改动重新逐行读了一遍,找出两处会影响到你的问题,一起修了,见「修复」。

修复

  • 定时备份碰上服务器正在启动、停止或重启,这一天就没有备份(beta.1 起)。beta.1 给备份加了两道保护:服务器正在启动或停止时不备份;备份途中服务器停止或重启过,这一份作废。手动备份碰上了会提示你重试,定时备份却只在控制台留一行字,不再试。于是把定时备份和定时重启排在同一分钟、世界又大到一分钟压不完的,或者把备份排在重启后一两分钟、服务器还没启动完的(带模组的服常常要几分钟),每天都做不成备份,自己还不一定看得见。现在定时备份因为这个原因没做成时,会等服务器启动完或停稳(最多等 15 分钟)再备份,最多再试两次,控制台里写明这一次为什么没做成、正在等。别的原因失败的不重试。
    • 手动备份不变。只有一处变化:服务器开着时备份,压缩途中有人点了停止的,这一份现在也作废,提示重新备份(以前会照样保存一份)。
  • 便携 Java 装到一半中断的,下次会重新装(beta.1 起)。以前只要 bin\java.exe 在,就算这套 Java 装好了。beta.1 给解压加了磁盘余量检查,盘上只剩两三百兆时,可能解到一半因为空间不够停下,留下一个有 java.exe、别的却不全的半截。腾出空间以后,这半截会被直接拿去开服,报的是 Java 自己的错误,看不出是没装完,也不会重新下载,只能手动删掉 runtimes\java-N 文件夹。现在开始装之前会先放一个「还没装完」的记号(runtimes\java-N.incomplete),整套装完才拿掉,记号还在的下次会重装;解压失败时把解出来的一半删掉;一开始就按解开以后的总大小查磁盘空间,放不下就不动原来的文件夹。以前装好的 Java 照旧能用。
    • 如果你碰到过开服时 Java 报一串看不懂的错、怎么重试都一样,可以看看 MineDeck 文件夹里的 runtimes,把那个版本的 java-N 文件夹删掉,下次开服会重新下载。
  • 几处极短的先后顺序问题,人手几乎点不出来,一起改了:AI 伙伴刚连上的一瞬间,伙伴页显示已连上、却还没有模组版本;导入交接包失败以后,用同一个名字马上重试,偶尔被回「正在创建中」;换地图时刚读完压缩包的内容就取消,上传的文件偶尔删不掉。

下载哪个文件

文件 给谁
MineDeck.exe 开服的人。放进一个单独的空文件夹,双击运行;已经在用旧版本的,换掉原来的那个。
minedeck-companion-neoforge-1.21.1-0.2.1.jar 用了 AI 伙伴的 NeoForge 1.21.1 服上的好友:放进客户端的 mods 文件夹
minedeck-companion-forge-1.20.1-0.2.1.jar 同上,Forge 1.20.1 的服
SHA256SUMS 校验和,自动更新会用到,一般不用管

伙伴模组和之前的是同一份,已经装过的不用换。

这一版实际试过的

  • 发版前在最终代码上跑了一遍全部测试:后端的测试全过;界面的交互用例 244 条全过;界面原型的 162 个场景都能走通。
  • 自动测试的历次失败:从 10 月底到这一版之前,一共 25 次、17 种。每一种都查到了原因:6 种是程序里的真问题(4 种之前的版本已经修了,2 种这一版修),11 种是测试自己的毛病,比如测试里偷偷连了外网、时间卡得太紧、没等后台的活做完。测试的毛病都改掉了,改过的测试在自动测试的机器上连跑了几遍到十几遍,都过。
  • 上面「修复」里的每一处,都先想办法让问题每次都出现(比如人为把中间那一步拖慢),确认改之前会出错、改之后不会。
  • 改动由 Claude 复审:一位 Claude 评审员读了这次的全部改动,提的建议都核实后改了;复审以后补改的部分,发版前又由另一个 Claude 会话逐处读过。
  • 定时备份和便携 Java 这两处只在测试里验证过,没有在真的快满的磁盘上、真的服务器定时重启时试过。

还没测到的,请帮忙留意

  • 这一版的两处修复见上一节最后一条。要是你的服务器设了定时备份和定时重启,请过一两天看看备份文件夹里每天有没有新的备份。
  • beta.4 那几处界面改动(备份页页顶、新建时的端口预查、报错提示的位置、工具箱草稿读不出来的提示)仍然没有在真窗口里走过。
  • 以前列的几样照旧没测到:工具箱生成的资源包和整合包没有用真的游戏客户端、启动器加载过;OpenFrp、樱花的真实账户、真实的 AI Key、用游戏客户端进服(导入的地图、白名单、朋友能不能连上)仍然没有试过;第一次缩到托盘时的系统通知没在真窗口里看过;被杀毒软件、同步盘真的占着文件的情况没有制造过。

已知情况

这次重读 beta.1 的那次大改动,还找出几处没有在这一版改的,先写在这里:

  • 同一个盘上正在做很久的备份、还原或换地图时,新建服务器(要解压 Java)、第一次启动隧道(要解压 frpc)、添加本地模组,会停下来排队等前面的做完,期间取消不了,界面上也没有「在排队」的提示。
  • 程序被强行结束或断电时,正在下载、复制、保存的临时文件(名字以 .minedeck- 开头)会留下,不会自动清理。反复强退的话,下载到一半的 Java 包、服务端文件会占着空间,可以手动删掉。
  • C 盘(系统临时文件夹所在的盘)只剩一两百兆时,上传很小的文件(比如一个几兆的模组)也会被拒收,报错里没说是哪个盘不够。
  • 导入现成服务端压缩包(文件直接放在最外层的那种)时,任务标题显示成一串数字,比如「导入服务端 3045782611」。
  • AI 的回复长到超过上限时,如果已经开始输出,界面上可能说成「回复中途断开了」,真正的原因在「复制原文」里。

下面这些是 beta.4 就写过的,照旧:

  • 新建时预查端口查不出 Windows 保留的端口段。Hyper-V、WSL、Docker 这类会成段保留端口,被保留的端口预查时看着是空的,开服时照旧报「用不了」,页头照旧给「改端口」。
  • 新建的表单打开时查过的默认端口(包括自动换成的那一个),表单开着期间被别的程序占上的话,不会再提示,开服时才会报。
  • 备份页页顶「现在的世界从哪来」靠的是「换地图」里的记录,记录删掉以后只能说没有记录。新建向导和「换地图」页里,地图仍显示存档里的名字(多半是 world)。
  • 报错提示的位置:窗口比较窄(800 像素宽上下)时打开报错的「详情」,提示会盖住弹窗右边一截;窗口很矮、提示退回标题栏下方时,会盖住页头右边的启动这几个按钮;提示落在提示区下面时,会挡住标签栏右端的一两个标签;好几条提示叠在一起、比整个窗口还高时,下面的几条会出屏幕。提示 20 秒后自己走,鼠标停在上面时不走。
  • 一个以前就有、要别的程序配合才碰得上的竞态:MineDeck 核对完服务器里的文件夹在哪、真正去读写之前的那一瞬间,要是别的程序正好把这个文件夹换成了指到服务器外面的目录联接,读写配置、补没装上的文件时有可能动到服务器外面。以后的版本把这几处改成按已经核对过的文件夹来操作。
  • 在 MineDeck 里保存设置以后,设成只读的 server.properties 这类文件不再是只读的;还想让服务端改不了它,要再设一次只读。
  • 存放位置的「撤销」不是完全撤销:选错了文件夹再撤销,那个文件夹仍会留在扫描列表里。
  • 原版服务器上,导入整合包时跳过的文件在界面上找不回来(原版没有插件 / 模组页)。
  • 接管已有服务器时,如果它的端口和别的服务器撞了,MineDeck 会改它 server.properties 里的 server-port(只改这一项,界面上会说明)。
  • 启动时后台检查更新,日志里不写用的是哪个渠道。选了更新渠道以后,要程序启动时自己去查,还得打开同一页上的「启动时静默检查更新」。
  • 26.1 及以后的服务器,如果以前在游戏里用命令改过难度,第一次用 beta.3 及以后的版本开服时,难度会改回「设置」里写的那个。想保留游戏里的难度,先到这台服务器的「设置 → 常用」里把难度改成一样的。
  • 给服务器换一个要现下的 Java 时,下载还没完就重新打开这台服务器的「设置 → 启动与内存」再保存一次,会再建一个下载任务(不会重复下载文件)。
  • 检查更新比较版本号时,预发布那一段(beta、rc 这些)不分大小写。MineDeck 自己的版本号都是小写,碰不到。
  • beta.1、beta.2 发布说明里「已知情况」的其余各条仍然适用。

遇到问题,欢迎在 GitHub 上提 Issue,写清楚做了什么、看到了什么。不要贴出 API Key 和各种令牌。

What's Changed

  • CI 失败排查:伙伴连接、导入占位、便携 Java 半截、定时备份的修复,测试不再连外网和掐表 by @Trasperioooooon in #29

Full Changelog: v3.2.0-beta.4...v3.2.0-beta.5

v3.2.0-beta.4

v3.2.0-beta.4 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 16 Nov 05:32

这是测试版,给自己和好友试用、找问题的,可能还有毛病。

  • 用着 v3.2.0-beta.3 的,「设置 → 更新与关于」里没选过更新渠道、或者选的是「最新版」,检查更新就能直接换到这一版。选了「稳定版」的看不到它。
  • 从 v3.2.0-beta.2 或更早的版本换过来,要手动换一次程序。 那些版本检查更新时只看正式版,看不到测试版。请先关掉 MineDeck,下载下面的 MineDeck.exe,换掉原来文件夹里的那一个。服务器、设置和隧道都存在那个文件夹里,不用动。
  • 正式版会是 v3.2.0。

和 v3.2.0-beta.3 比,这一版修了一个 beta.1 起就有的问题:服务器里的文件设成只读时,保存设置会报成功,其实没存上,见「修复」。另外把 beta.3 那次走查记下、当时没来得及改的几处改了:备份页说清现在的世界从哪来,改过备份存放位置以后不再让人以为备份丢了,新建服务器时预先避开被别的程序占着的端口,报错提示不再盖住修复按钮。

修复

  • 服务器里的文件设成只读时,保存报成功却没存上(beta.1、beta.2、beta.3 都有,正式版 v3.1.2 没有)。比如有人把 server.properties 设成了只读、不想让服务端改它,在 MineDeck 里改设置保存,会提示保存成功,文件其实没变;同一个文件夹里还会多出一个名字带乱码的文件,里面是这次想存的内容。偶尔会直接报「文件名语法不对」。原因是替换只读文件时传给系统的新名字少了结尾的空字符,系统把名字后面碰巧不是零的内存也当成了名字。现在名字后面补上了结尾,替换只读文件以后还会核对一次新文件确实换到了原来的位置,对不上就报错,不再报成功。和 beta.1 起一样,在 MineDeck 里保存以后,换上的文件不再是只读的;还想让服务端改不了它,要再设一次只读。
    • 请留意:用过 beta.1 到 beta.3、又把服务器里的文件设成过只读的,请看一眼那个只读文件所在的文件夹(多半是服务器文件夹,server.properties 就在那一层),有没有名字是原来的文件名后面跟着一串乱码的文件。那是当时没存上的内容。先到这台服务器的「设置」里看看设置是不是你想要的,没问题就可以把那个文件删掉。没设过只读的不会碰上这个问题。

改进

  • 备份页页顶说清现在的世界从哪来。用已有地图新建的、换过地图的服务器,「世界与备份 → 备份」页顶以前一律写「服务器自己的世界」。现在写导入时的来源(文件夹或压缩包的名字)和导入时间;换过地图又换回来的,写换回了;旁边有到「换地图」的链接。从备份还原过的照旧写是哪一份备份。换地图的记录删掉以后就查不出导入过,这时写「没有从备份还原过,「换地图」里也没有导入记录」。
  • 改过备份存放位置以后,说清旧备份在哪。以前的备份留在原来的文件夹里,照常列出来、能还原能删,以前页面上不说,点「打开」看到新文件夹是空的,容易以为备份丢了。现在「备份放在」改叫「新的备份放在」,下面写明另有几份是改存放位置以前做的、还在原来的哪个文件夹,在这台电脑上可以直接打开那个文件夹;列表里那几份标着「在原来的文件夹」。
  • 新建服务器时预先避开被别的程序占着的端口。新建、导入整合包、用已有地图开服时,默认端口(一般是 25565)被这台电脑上别的程序占着的话,换成下一个空着的,端口框下面写明换了、被哪个程序占着。手填的端口,停手以后查一次,被占着就提示一句,不拦着你。查的办法是读系统里正在监听的端口,不去试着占一下端口,所以不会让防火墙弹窗。接管已有服务器时只提示、不换:多半是原来那台服务器还开着,提示里会让你先把它停掉。
  • 报错提示不再盖住修复按钮。服务器详情页上,右上角的报错提示改落在页头提示区的下面,不再挡住「改端口」「去换 Java」这些按钮;窗口太矮放不下时,退回页头下面或标题栏下方,保证整条看得见。开服、重启没成功、原因是找不到 Java 或者端口被占时,提示上和「详情」弹窗里都直接给「去换 Java」或「改端口」。
  • 工具箱「导出整合包」读不出存好的草稿时有提示。以前这种时候不自动保存(免得盖掉存好的),但页面上什么都不说。现在页面上常驻一条说明,带「重新读取」:读出来以后表单换成存好的那份,读失败期间改的不保留。

下载哪个文件

文件 给谁
MineDeck.exe 开服的人。放进一个单独的空文件夹,双击运行;已经在用旧版本的,换掉原来的那个。
minedeck-companion-neoforge-1.21.1-0.2.1.jar 用了 AI 伙伴的 NeoForge 1.21.1 服上的好友:放进客户端的 mods 文件夹
minedeck-companion-forge-1.20.1-0.2.1.jar 同上,Forge 1.20.1 的服
SHA256SUMS 校验和,自动更新会用到,一般不用管

伙伴模组和之前的是同一份,已经装过的不用换。

这一版实际试过的

  • 发版前在最终代码上跑了一遍全部测试:后端的测试全过;界面的交互用例 244 条全过(beta.3 是 241 条,这一版加了 3 条);界面原型的 162 个场景都能走通。
  • 只读文件的问题:这个问题平时很难碰上,要程序里分配过不少内存以后才会出现,原来那条保存用例只在 CI 上偶尔挂过一次。查的时候在替换后面加了核对,把整组测试连着跑,立刻大量报错、报出新文件被改成了带乱码的名字。现在另加了一条每次都能稳定复现的用例,专门检查名字后面的结尾空字符,去掉它这条用例就挂;原来那条保存用例也加了一项:只读文件换完以后,文件夹里只能有原来那一个文件。另外用这一版编出来的程序实际开起来,对一台服务器里设成只读的 server.properties 连着保存三次,每次内容都换上了,文件夹里没有多出别的文件。
  • 改动都经过另一方复审:Claude 写的修改交给 Codex 看过。只读文件那处看了两遍,第二遍没有发现要改的问题。走查的这几处看了两遍,找出的问题都改了;最后一次修改改完以后,发版前又请它单独看了一遍,没有要挡发版的问题,记下的小问题写在「已知情况」里。
  • 界面上的这几处改动,是在仿真的后端上用不同大小的窗口看过、跑过用例的,没有编出程序在真窗口里走一遍。界面用到的几项数据(端口被别的程序占着、备份在哪个文件夹、换地图的记录),和真后端的字段逐一对过。

还没测到的,请帮忙留意

  • 上面「改进」里的几处没有在真窗口里走过,见上一节。
  • beta.3 列的几样照旧没测到:工具箱生成的资源包和整合包没有用真的游戏客户端、启动器加载过;OpenFrp、樱花的真实账户、真实的 AI Key、用游戏客户端进服(导入的地图、白名单、朋友能不能连上)仍然没有试过;第一次缩到托盘时的系统通知没在真窗口里看过;被杀毒软件、同步盘真的占着文件的情况没有制造过。

已知情况

  • 新建时预查端口查不出 Windows 保留的端口段。Hyper-V、WSL、Docker 这类会成段保留端口,被保留的端口预查时看着是空的,开服时照旧报「用不了」,页头照旧给「改端口」。
  • 新建的表单打开时查过的默认端口(包括自动换成的那一个),表单开着期间被别的程序占上的话,不会再提示,开服时才会报。
  • 备份页页顶「现在的世界从哪来」靠的是「换地图」里的记录,记录删掉以后只能说没有记录。新建向导和「换地图」页里,地图仍显示存档里的名字(多半是 world)。
  • 报错提示的位置:窗口比较窄(800 像素宽上下)时打开报错的「详情」,提示会盖住弹窗右边一截;窗口很矮、提示退回标题栏下方时,会盖住页头右边的启动这几个按钮;提示落在提示区下面时,会挡住标签栏右端的一两个标签;好几条提示叠在一起、比整个窗口还高时,下面的几条会出屏幕。提示 20 秒后自己走,鼠标停在上面时不走。
  • 一个以前就有、要别的程序配合才碰得上的竞态:MineDeck 核对完服务器里的文件夹在哪、真正去读写之前的那一瞬间,要是别的程序正好把这个文件夹换成了指到服务器外面的目录联接,读写配置、补没装上的文件时有可能动到服务器外面。这一版不改,以后的版本把这几处改成按已经核对过的文件夹来操作。
  • 存放位置的「撤销」不是完全撤销:选错了文件夹再撤销,那个文件夹仍会留在扫描列表里。
  • 原版服务器上,导入整合包时跳过的文件在界面上找不回来(原版没有插件 / 模组页)。
  • 接管已有服务器时,如果它的端口和别的服务器撞了,MineDeck 会改它 server.properties 里的 server-port(只改这一项,界面上会说明)。
  • 启动时后台检查更新,日志里不写用的是哪个渠道。选了更新渠道以后,要程序启动时自己去查,还得打开同一页上的「启动时静默检查更新」。
  • 26.1 及以后的服务器,如果以前在游戏里用命令改过难度,第一次用 beta.3 或这一版开服时,难度会改回「设置」里写的那个。想保留游戏里的难度,先到这台服务器的「设置 → 常用」里把难度改成一样的。
  • 给服务器换一个要现下的 Java 时,下载还没完就重新打开这台服务器的「设置 → 启动与内存」再保存一次,会再建一个下载任务(不会重复下载文件)。
  • 检查更新比较版本号时,预发布那一段(beta、rc 这些)不分大小写。MineDeck 自己的版本号都是小写,碰不到。
  • beta.3「已知情况」里的这四条这一版改掉了:用存档新建或换过地图的服务器备份页页顶的说法、改了备份存放文件夹以后不提醒、工具箱读草稿失败没有提示、新建时不预先检查端口。其余各条都抄在上面。beta.1、beta.2 发布说明里「已知情况」的其余各条仍然适用。

遇到问题,欢迎在 GitHub 上提 Issue,写清楚做了什么、看到了什么。不要贴出 API Key 和各种令牌。

What's Changed

  • 替换只读文件时报成功却没存上:改名参数补上结尾的空字符 by @Trasperioooooon in #27

Full Changelog: v3.2.0-beta.3...v3.2.0-beta.4

v3.2.0-beta.3

v3.2.0-beta.3 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 15 Nov 20:25

这是测试版,给自己和好友试用、找问题的,可能还有毛病。

  • 从 v3.2.0-beta.2 或更早的版本换过来,要手动换一次程序。 那些版本检查更新时只看正式版,看不到这个测试版。请先关掉 MineDeck,下载下面的 MineDeck.exe,换掉原来文件夹里的那一个。服务器、设置和隧道都存在那个文件夹里,不用动。
  • 从这一版起,「设置 → 更新与关于」里可以选更新渠道:「稳定版」只提示正式版,「最新版」连测试版一起提示。没选过的话,用着测试版就按最新版查,以后的测试版可以直接在程序里更新。
  • 正式版会是 v3.2.0。

和 v3.2.0-beta.2 比,这一版按一次可用性走查的结果把界面整理了一遍:服务器详情页的标签从十几个收成七个,连接地址、启动失败的原因、端口被占这些「出了事要马上看到」的信息放到了页头上;新建、导入的流程补上了取消、返回修改和没装上的文件的后续处理;各处的叫法统一了一次。另外新加了两样东西:左侧栏的「工具箱」,和检查更新时选「稳定版」还是「最新版」。还修了一个 26.1 起的服务器上改难度不生效的问题,见「修复」。

新功能

工具箱

左侧栏「内网穿透」下面多了一项「工具箱」,放和朋友一起玩时用得上的小工具。这一版有两个:

  • 离线皮肤包。离线模式的服务器上,大家都顶着默认皮肤。把朋友们的皮肤 PNG 放进来,MineDeck 按每个人的玩家名算出游戏会给他用哪一个默认皮肤,把皮肤图换进去,打成一个资源包。每个朋友把这个资源包放进自己客户端的 resourcepacks 文件夹并启用,就能看到彼此的皮肤。也可以不按玩家名、按顺序替换默认角色的外观。老的 64×32 皮肤会自动扩成现在的格式。
    • 默认皮肤的位置是游戏按玩家名定死的:1.19.3 起有 18 个,更早的版本只有 Steve 和 Alex 两个。人一多,两个人撞进同一个位置的机会不小(5 个人大约四成),撞上了只能二选一,页面上会标出来让你选。
    • 游戏还按玩家名定了手臂是粗的还是细的,资源包改不了这一点:手臂粗细和皮肤对不上的,看起来会有点别扭。
    • 支持 1.8 及以后的版本。老的 64×32 皮肤按游戏客户端处理下载皮肤的规则扩成新格式,帽子那一层如果整块涂满了,会清成透明。
    • 生成的资源包附带 SHA-1。想让服务器自动把资源包推给进服的人,要自己把它放到网上能直接下载的地方,再在服务器的「设置 → 全部配置」里填 resource-pack 和 resource-pack-sha1;工具箱不会改服务器的配置。
  • 导出整合包(Modrinth 的 .mrpack 格式)。两种用法:从已有的模组服务器直接导出它的模组,可以选带上 config 文件夹;或者自己挑模组,MineDeck 找齐必装的前置。导出的文件用 Modrinth App、Prism、HMCL、PCL2 这些启动器都能一键安装。
    • Modrinth 上能找到的模组只写下载地址,朋友安装时从官方下载;找不到的(自己改过的、只在别处发布的)整个打进包里,分享前请留意原作者是否允许转发。
    • 自己挑模组时,只在客户端用的模组(小地图、光影加载器之类)也能挑,包里会标明服务器不用装。这份清单是工具箱自己的,和新建服务器时挑的模组分开,不会被装进任何服务器。
    • config 文件夹默认不带。勾上的话,看起来放着密码、令牌、密钥、数据库的配置文件(比如聊天机器人的令牌、权限插件的数据库设置)会尽量挑出来不打进包,预览里列出跳过了哪些;认不出的写法难免有,打进去的配置文件也都列在预览里,发之前请看一眼。
    • MineDeck 自己装进服务器的语音桥模组(音乐共享用)只在服务端用,不会打进包;AI 伙伴模组朋友的客户端要装,照常带上。

两个工具都不改任何服务器里的文件。生成的文件可以直接下载;在运行 MineDeck 的这台电脑上,也可以顺手存到一个文件夹里。

更新渠道

「设置 → 更新与关于」里可以选「稳定版」或「最新版(包括测试版)」。稳定版只提示正式版;最新版连测试版一起提示,按版本号挑最新的。不会提示比你现在用的更旧的版本:用着测试版又选了稳定版,在下一个正式版出来之前不会有更新提示。不管哪个渠道,下载的程序都要和官方发布的 SHA256SUMS 对得上才会换上。

服务器详情页

  • 标签收成七个:控制台、玩家、世界与备份、插件 / 模组、定时任务、设置、扩展。原来的「地图」并进了「世界与备份」,叫「换地图」;「资源」和「待装清单」合成一页,上面是已安装的,下面是热门、搜索和从电脑添加;「常用设置」「内存 / 启动」「全部配置」收进「设置」,分别叫「常用」「启动与内存」「全部配置」;游戏内 AI、AI 伙伴、音乐共享收进「扩展」。旧的书签和链接会自动跳到新位置。
  • 连接地址在页头和服务器卡片上:同一个局域网里的朋友要填的 IP:端口,点一下就能复制。不在同一个网络的朋友,还是用内网穿透的隧道。
  • 页头有一块提示区:上次启动失败的原因、整合包里没装上的文件、Java 找不到了、模组要求更高版本的 Java,有就一直显示在这里,事情解决了才消失,不再是右上角几秒钟就不见的提示。
  • 启动失败的原因留着:服务器起不来时,原因写在页头和卡片上,切到别的页再回来也还在。
  • 端口被占了会说清是谁:被 MineDeck 里另一台服务器占着时,直接说是哪一台,并给「改成 N 并启动」;被别的程序占着时给「改端口」,带你去设置里的端口那一项。新建服务器、导入、接管时默认的端口会避开已经在用的。
  • 加了「重启」按钮;改了需要重启才生效的设置,保存后的提示和设置项旁边的标注说法一致。
  • 设置类的页面都用底部的保存条,Java 的选择也在保存条里一起保存;定时任务点「添加」先进草稿,保存了才算数。
  • 服务器信息集中在「设置 → 启动与内存」页顶:核心、版本、端口、Java、服务器文件夹,能复制、能打开。「打开文件夹」菜单里多了「备份」,备份页写明备份存在哪。
  • Java 路径失效时会提醒(比如把服务器从别的电脑拷过来),卡片和页头都会说,Java 下拉里那一项标「找不到」。
  • 还原备份:还原前要做什么、会不会影响正在运行的服务器,确认框里一次说清。服务器开着时点「还原」,会先保存世界、停服再还原,还原完不会自动开服。
  • 有人在线时停服、重启会先问一句。

新建、导入和接管

  • 新建服务器时白名单默认关闭,并且写明了。26.3 起的服务端默认会开白名单,以前不说一声就会把朋友挡在外面。
  • 新建页有五种方式,「用已有地图开服」单独成了一张卡片。
  • 导入整合包时没装上的文件会留在服务器上:以前要在那一次运行里处理完,关了程序就找不回来。现在服务器详情页头会一直提示「有 N 个整合包文件没装上」,点开能逐个处理,跳过的以后也能在插件 / 模组页再处理。
  • 任务页:正在进行的、出了问题的任务排在前面,做完的折起来。新建、导入整合包、导入现成服务端可以取消,取消后显示中性的「已取消」,不再当成失败;点「返回修改」回到原来的表单,填过的都还在。
  • 换地图取消了也显示「已取消」,并写明没有替换任何文件。
  • 选构建版本默认收进「高级」;选插件这一步能跳过;同意 EULA 的开关不会被底部的按钮挡住。

删除、弹窗

  • 删除服务器默认只「移出列表」,文件夹留着,提示里写出文件夹的位置并能直接打开;要连文件一起删得另外选。移出接管来的服务器时,会说清楚 MineDeck 在那个文件夹里留下了哪些文件。
  • 弹窗里报错时,填好的内容不会丢;弹窗叠着开时,Esc 只关最上面那一层。
  • 报错提示至少停留 20 秒,鼠标停在上面或打开了详情时不会消失。

内网穿透和设置

  • 隧道可以编辑:名称、绑定的服务器、跟随服务器启动都能改;凭据留空就沿用原来的,换了服务商或服务器地址才要重新填。隧道卡片上信息更全。
  • 内网穿透页顶写明:同一个局域网的朋友不用隧道,直接用服务器页上的连接地址。「添加隧道」和「平台账户」是什么关系也写清楚了。
  • 设置里原来的「远程访问」改叫「手机远程管理」,说的是用手机或别的电脑的浏览器打开 MineDeck 的管理页,和朋友进游戏的地址无关。
  • 「设置 → AI」页顶说明三样 AI 各是什么:标题栏上的「AI 助手」、服务器里的「游戏内 AI」、陪玩的「AI 伙伴」。
  • 「点关闭按钮时缩到托盘」开关的说法改清楚了,第一次缩到托盘时会提示一次;侧栏底部加了「退出 MineDeck」。
  • 导出交接包时,选的文件夹不存在可以「新建并导出」。存放位置改了以后可以撤销。

修复

  • 26.1 起的服务器,改了难度重启以后游戏里不变。从 26.1 开始,游戏把难度存进了世界数据,服务端只在新建世界时读一次 server.properties 里的难度,以后改设置不再起作用(Paper 26.3 上实测如此)。现在 26.1 及以后的服务器开好以后,MineDeck 会按设置里的难度补一条 difficulty 命令,控制台里能看到这一句。和 26.1 以前一样,以设置里的为准:在游戏里用命令改的难度,下次开服会改回设置里的。极限模式的世界游戏锁在困难,不发这条命令。
  • 插件服上装插件时说成了「模组」:待装清单的标签和安装日志现在说「插件」。
  • 整合包里没装上的文件只剩跳过的时,面板以前打绿勾写「都处理完了」,现在写「跳过了 N 个文件,它们没有装上」。
  • 几处少见的先后顺序问题(Codex 复审时找出来的):删除模组时按文件实际落在哪里核对,mods、plugins 是指到服务器外面的联接时拒绝删;隧道正在启动时不能改、删它;换地图收尾时先存好服务器信息再放手,中间「移出列表」的服务器不会被写回来;保存途中又改的设置继续算未保存;导入整合包、新建服务器的请求还没回来就切到别的页面,不再误报失败,「返回修改」填过的也都在。
  • AI 回复的大小上限改成按实际内容算。beta.1 起是按收到的原始数据算 8 MiB,带很长思考过程的模型可能误碰上限;现在按解码以后的正文和思考内容算,原始数据另设一个宽得多的兜底上限。
  • 处理没装上的文件时不再长时间占着锁:从网上下载放到锁外面,只在真正写进服务器的那一下加锁,下载慢时不会挡住这台服务器别的操作。
  • 隧道凭据很短时会提醒:短于 6 个字符的凭据,日志里含它的行会整行隐藏,填写和编辑隧道时会先说一声。
  • 公网地址后面紧跟着别的字符时,端口不会被截错。
  • 隧道配置读不出来时,音乐共享页的说法改对了,不再显示成「没有语音隧道」。
  • 保存文件时取锁的方式改了一处细节,路径写法不同但指向同一个文件时不会拿到两把锁。

下载哪个文件

文件 给谁
MineDeck.exe 开服的人。放进一个单独的空文件夹,双击运行;已经在用旧版本的,换掉原来的那个。
minedeck-companion-neoforge-1.21.1-0.2.1.jar 用了 AI 伙伴的 NeoForge 1.21.1 服上的好友:放进客户端的 mods 文件夹
minedeck-companion-forge-1.20.1-0.2.1.jar 同上,Forge 1.20.1 的服
SHA256SUMS 校验和,自动更新会用到,一般不用管

伙伴模组和之前的是同一份,已经装过的不用换。

这一版实际试过的

  • 发版前在最终代码上跑了一遍全部测试:后端的测试全过;界面的交互用例 241 条全过;界面原型的 162 个场景都能走通。
  • 两位 AI 扮演的盲测员(第一次用的人、隔一阵子回来用的人)用编出来的程序在真窗口里各按任务单走了一遍,13 项和 14 项全部做完。回来用的那一位还把一台服务器的世界换成另一张地图、开服确认、再换回了原来的。走查找出来的问题,便宜的这一版改了(上面「修复」里难度那条就是这样发现的),没改的写在下面「已知情况」。
  • 改动都经过另一方复审:Claude 写的部分交给 Codex 审了五遍,先审这一版的全部改动,之后每改一轮再看改过的部分。找出的问题,除了下面「已知情况」里写的几条,都改了;最后一遍另记下一条以前就有的竞态(要别的程序正好在 MineDeck 核对完路径、真正动文件之前,把文件夹换成指到外面的目录联接),留到以后的版本。工具箱是 Gemini 写的,由 Claude 复审、修了两轮,也在 Codex 审的范围里。
  • 1.12.2 服务器运行中做备份:用编出来的程序真开了一台原版 1.12.2,备份时服务端依次关自动保存、保存、存好、再打开自动保存,MineDeck 认出了「存好」那一句,1 秒多就拿到了备份。beta.1 列在「没测到」里的这一条现在测过了。
  • 端口冲突:真开了两台同端口的原版 1.20.1,第二台的报错点名了第一台,点「改成 N 并启动」(N 是下一个空着的端口)以后开了起来。
  • 难度:Paper 26.3 的服务器改了设置里的难度再重启,改之前的版本重启以后游戏里还是原来的难度。用发布页上下载的这一版程序再试:改成简单、开服,服务端回了「难度已设为简单」,再查也是简单。Fabric 1.21.11(26.1 以前的版本)改了设置本来就生效,这类版本 MineDeck 不补命令,实测也没有多发。
  • 更新渠道:用编出来的程序对真的 GitHub 查过,没选过时按最新版查到了测试版,改成稳定版查到了正式版。
  • 工具箱:用编出来的程序走过两个工具,生成的资源包和整合包解开核对过内容;导出的整合包用 MineDeck 自己的整合包导入读回来过。

还没测到的,请帮忙留意

  • 工具箱生成的资源包和整合包没有用真的游戏客户端、启动器加载过。资源包的格式和默认皮肤的位置是按游戏的规则和 Minecraft Wiki 写的;整合包的格式是按 Modrinth 的规范写的。老的 64×32 皮肤扩成新格式的那几步,是照着社区整理的游戏代码说明写的,没有和游戏本身的代码逐条对过。
  • OpenFrp、樱花的真实账户、真实的 AI Key、用游戏客户端进服(导入的地图、白名单、朋友能不能连上)仍然没有试过。
  • 第一次缩到托盘时的系统通知只在测试里确认发出了,没在真窗口里看过它的样子。
  • 被杀毒软件、同步盘真的占着文件的情况没有制造过。

已知情况

  • 存放位置的「撤销」不是完全撤销:选错了文件夹再撤销,那个文件夹仍会留在扫描列表里。
  • 原版服务器上,导入整合包时跳过的文件在界面上找不回来(原版没有插件 / 模组页)。
  • 接管已有服务器时,如果它的端口和别的服务器撞了,MineDeck 会改它 server.properties 里的 server-port(只改这一项,界面上会说明)。
  • 启动时后台检查更新,日志里不写用的是哪个渠道。选了更新渠道以后,要程序启动时自己去查,还得打开同一页上的「启动时静默检查更新」。
  • 26.1 及以后的服务器,如果以前在游戏里用命令改过难度,换到这一版以后第一次开服,难度会改回「设置」里写的那个。想保留游戏里的难度,先到这台服务器的「设置 → 常用」里把难度改成一样的。
  • 用存档新建的、或者换过地图的服务器,「世界与备份 → 备份」页顶仍写「服务器自己的世界」;地图是从哪来的,要看「换地图」页。
  • 改了备份存放文件夹以后,以前的备份留在原来的文件夹里,备份页暂时不会提醒这一点。
  • 给服务器换一个要现下的 Java 时,下载还没完就重新打开这台服务器的「设置 → 启动与内存」再保存一次,会再建一个下载任务(不会重复下载文件)。
  • 工具箱「导出整合包」页读存好的草稿时要是读不出来(比如文件正被别的程序占着),这一次不会自动保存,免得盖掉存好的,但页面上没有提示。
  • 检查更新比较版本号时,预发布那一段(beta、rc 这些)不分大小写。MineDeck 自己的版本号都是小写,碰不到。
  • 新建服务器时不会预先检查端口有没有被别的程序占着(MineDeck 自己的服务器会避开),开服时才报;报错旁边的「改端口」能直接带你去改。
  • beta.1 里「AI 的一次回复有大小上限(8 MiB,按原始数据算)」这一条已经改掉(见上面「修复」);「待决文件要在这次运行里处理完」也不再适用,没装上的文件会一直留到你处理。beta.1、beta.2 发布说明里「已知情况」的其余各条仍然适用。

遇到问题,欢迎在 GitHub 上提 Issue,写清楚做了什么、看到了什么。不要贴出 API Key 和各种令牌。

What's Changed

  • 算锁键不再打开要被替换的文件(没进 v3.2.0-beta.2,还差一轮复审) by @Trasperioooooon in #26

Full Changelog: v3.2.0-beta.2...v3.2.0-beta.3

v3.2.0-beta.2

v3.2.0-beta.2 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 15 Nov 05:48

这是测试版,给自己和好友试用、找问题的,可能还有毛病。

  • 这一版只修问题,没有新功能。v3.2.0 这一轮的新功能(换地图、OpenFrp 和樱花的账户、AI 助手的改进)和注意事项,见 v3.2.0-beta.1 的发布说明。
  • 测试版之间不会自动更新。用着 v3.2.0-beta.1 的,请先关掉 MineDeck,下载下面的 MineDeck.exe,换掉原来文件夹里的那一个。服务器、设置和隧道都存在那个文件夹里,不用动。用着 v3.1.2 的同样不会收到这一版的更新提示。
  • 正式版会是 v3.2.0,装了测试版的人到时能在「设置 → 更新与关于」里直接更新。

和 v3.2.0-beta.1 比,这一版修了内网穿透的三个问题,还有保存文件时偶尔报错的一个问题。

内网穿透

  • 公网地址显示成 ext.go:37。OpenFrp、樱花的隧道启动以后,卡片上的公网地址有时不是能连的地址,而是 ext.go:37 这样的一串。那是 frpc 日志里标注程序位置的一小段,被 MineDeck 当成了地址,v3.1.2 也有这个问题。现在会跳过这类内容,取这一行里真正的地址。域名和 IP 都出现时照旧优先用域名。
  • 隧道配置读不出来时,不会再把原来的隧道盖掉。以前 MineDeck 启动时,tunnels.json 要是刚好被别的程序占着(杀毒软件、同步盘),或者文件坏了,隧道页会显示成一条隧道都没有;这时再添加一条,原来的隧道和保存的凭据就全没了。现在读不出来时,隧道页会直接说明原因,读出来之前不能添加、修改、删除或启动隧道,原文件不动。占用放开或者文件修好以后会自动恢复,不用重启。
  • 隧道配置写不进磁盘时会告诉你。以前磁盘满了、文件被设成只读的时候,添加隧道、从平台导入或创建隧道都显示成功,重启以后却不见了。现在会提示这次没有保存。在平台上已经建好、只是本机没存上的那一条,会提醒你去「导入」,不要再创建一次。

保存设置和配置文件

  • 偶尔报「替换文件失败:Access is denied」。几处同时保存同一个文件(比如 server.properties),或者文件正好被别的程序读着,保存有很小的概率失败,再点一次才成功。这是 v3.2.0-beta.1 换保存方式时带进来的。现在碰上这种情况会隔一会儿再试,最多约半秒,还不行才报错。

下载哪个文件

文件 给谁
MineDeck.exe 开服的人。放进一个单独的空文件夹,双击运行;已经在用测试版的,换掉原来的那个。
minedeck-companion-neoforge-1.21.1-0.2.1.jar 用了 AI 伙伴的 NeoForge 1.21.1 服上的好友:放进客户端的 mods 文件夹
minedeck-companion-forge-1.20.1-0.2.1.jar 同上,Forge 1.20.1 的服
SHA256SUMS 校验和,自动更新会用到,一般不用管

伙伴模组和 v3.1.x、v3.2.0-beta.1 的是同一份,已经装过的不用换。

这一版实际试过的

  • 自动测试:Go 测试在 Windows 上全部通过(41 个包),带竞态检测再跑一遍也全部通过;界面交互测试 183 条、界面原型 119 个场景在仿真后端上走通。
  • 保存文件:几路同时保存同一个文件的测试连跑 150 遍,保存这部分的全部测试连跑 100 遍,没有再出现「Access is denied」。
  • 隧道配置读不出来:用编出来的程序实际试了三种情况,文件坏了一半、文件被别的程序占着、没有这个文件。前两种,隧道列表都报出了原因,添加隧道被拒绝,原文件没有被动过;把文件修好或者把占用放开以后,不用重启,原来的隧道回来了,再加一条,新旧两条都在。
  • 公网地址:用三十来种照着 frpc 的写法造出来的日志行测过,包括带程序位置的、域名和 IP 同在一行的、IPv6 的。
  • 这一版的改动请别家模型(Codex)做过只读复审,三处修复的结论都是可以发。
  • 发版前在一台 Windows 11 上用编出来的程序做了基本核对:程序报的版本号对,不开窗口启动以后首页能打开;端口被别的程序占着时点启动会马上提示,放开以后真的开起一台 Paper 1.20.1 服务器,再停掉。

还没测到的,请帮忙留意

  • 公网地址的修复没有用真实的 OpenFrp、樱花账户验证过。手头没有真实的隧道日志,修复是按 frpc 的日志写法做的,测试用的是照着写的日志行。如果卡片上的公网地址还是不对,请把隧道日志里带地址的那几行发给我们,凭据记得遮掉。
  • 真的被杀毒软件、同步盘占着 tunnels.json 的情况没有制造过,测试里是程序自己把文件占住,系统报的是同一种错。
  • 保存时文件被别的程序占着,同样是程序自己占住来测的。半秒够不够等过真实的杀毒扫描,没有实测数据。
  • v3.2.0-beta.1 发布说明里「还没测到的」那几条(地图导入在真窗口里完整走一遍、导入以后用游戏客户端进服、真实的 AI Key 等)仍然没有测。

已知情况

  • 隧道配置读不出来的时候,音乐共享页仍然显示「没有语音隧道」。只是说法不准,不会改动任何配置;隧道页上的说明是对的。
  • 文件一直被别的程序占着时,报错会比以前晚约半秒。比如服务器开着的时候替换一个正在用的模组文件。
  • v3.2.0-beta.1 发布说明里「已知情况」的各条仍然适用。

遇到问题,欢迎在 GitHub 上提 Issue,写清楚做了什么、看到了什么。不要贴出 API Key 和各种令牌。

What's Changed

Full Changelog: v3.2.0-beta.1...v3.2.0-beta.2

v3.2.0-beta.1

v3.2.0-beta.1 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 14 Nov 09:03

这是测试版,给自己和好友试用、找问题的,可能还有毛病。

  • 请放进一个新的空文件夹里运行。要拿已有的服务器试,先把整个服务器文件夹备份一份;这一版新加的「换地图」会搬动世界文件夹,更要先备份。
  • 用着 v3.1.2 的不会收到这个版本的更新提示,要试的话手动下载下面的 MineDeck.exe。
  • 正式版会是 v3.2.0,装了测试版的人到时能在「设置 → 更新与关于」里直接更新。

和 v3.1.2 比,这一版加了三样东西:拿一张已有的地图开服、给服务器换地图;在 MineDeck 里连上 OpenFrp 和樱花的账户;内置 AI 助手的显示和对各家服务商的兼容。另外收紧了「仅本机」的判定,下载、备份、上传这些写磁盘的地方也整个加固了一遍。

用已有的地图开服、换地图

手里有一张 Java 版的地图(下载来的冒险、空岛地图,自己单人玩了很久的存档,朋友发来的旧服世界),现在可以直接拿它开服,或者把服务器正在用的地图换成它,换了以后还能换回来。完整的说明在《用已有的地图开服、换地图》,这里说要点。

  • 拿地图开一台新服务器:在「新建服务器」里选「用已有地图开服」,先选地图。MineDeck 读出地图最后是用哪个版本存的、用过什么核心,替你预选同样的版本和合适的核心。地图在服务器建好之前放进去,放不进去整台就不建。
  • 给现有的服务器换地图:服务器详情的「地图」页,点「导入并替换当前地图」。在这台电脑上可以直接选地图文件夹;别的设备上用网页打开的,上传地图的 ZIP(最大 8 GB)。
  • 先看预览再动手:预览里写着地图的版本和服务器的版本、找到了哪些维度、带了哪些数据包和资源包、有没有用过模组的迹象、会换掉哪些文件夹。红色的是不能导入的原因,黄色的要勾「我已了解」才能继续。
  • 旧地图一个文件都不删:换的时候,原来的地图连同下界、末地整体移进「恢复点」。「地图」页下面列着每次导入留下的恢复点,点「恢复导入前的地图」就能换回去。恢复点一直留到你手动删除。
  • 换到一半出了问题会自动退回。换图的时候 MineDeck 被关掉或者电脑断电,下次打开时它会先把这台服务器恢复到换图之前,恢复好之前这台服务器不能启动。
  • 版本对不上:地图比服务器新的不能导入,请新建一台和地图同版本的服务器;地图比服务器旧的可以导入,但要确认,服务器第一次启动时会把这份副本升级成新格式。
  • 认得出不是地图的东西:基岩版存档、建筑蓝图、资源包、数据包、整合包、交接包,会告诉你它是什么、该去哪;.rar、.7z 和加密的压缩包请先解开。

这一版不做的:不会改写玩家文件(单人存档转服务器时,背包接不接得上取决于主人用什么账号进服,预览里有说明);地图带的资源包不会自动发给玩家;世界文件夹本身是链接的服务器不支持换地图;多世界插件建的其他世界不会动。

OpenFrp 和樱花的账户

这一部分由 awaxiaoyu 贡献。

  • 在「内网穿透」页的「平台账户」里可以连上自己的 OpenFrp 账户(远程授权)或者樱花的账户(访问密钥),看到账户概览,手动签到,跳到官网的购买入口。
  • OpenFrp 的隧道可以直接在 MineDeck 里创建,也可以把平台上已有的隧道导进来。
  • 账户的凭据加密保存在这台电脑上。连接账户、签到、建隧道这类会改动账户的操作只能在运行 MineDeck 的这台电脑上做,局域网里别的设备做不了。

内置 AI 助手

  • 回复的排版:标题分级显示;表格、列表、勾选框、删除线、斜体按 Markdown 的样子显示;代码块保留语言,带复制按钮,还没写完的代码块会标出来,不再把前面的段落吞掉。回复不渲染图片,链接只认 http 和 https。
  • 思考内容:模型给出的思考过程会转发出来,默认折叠着。
  • 面板可以拖宽,宽度记在这台设备上。
  • 选模型:模型框可以手填,也可以点箭头拉取服务商的模型列表、在里面搜。服务商不提供模型列表时,退回预设里的建议模型。
  • 兼容更多服务商:OpenAI 兼容的服务商可以选鉴权方式;需要每一轮都把思考内容带回去的服务商(比如 DeepSeek)现在能正常连续调用工具;Key 和地址对不上时会提醒。新加了小米 MiMo 的预设。
  • 测试连接会多走一轮工具调用,能提前发现「第一轮能过、交回工具结果就报错」的服务商。
  • 报错的短句分得更细:额度用完、请求太频繁、Key 不对、地址不对分开说。

「仅本机」收紧了

  • 算本机要两样都有:连接来自这台电脑,并且带着这次启动的令牌(MineDeck 自己的窗口和启动地址里带着)。以前只看连接是不是来自这台电脑,经本机的隧道程序转发进来的请求也会被当成本机。
  • 会变的只有一种用法:在主机自己的浏览器里不带令牌打开 MineDeck、用访问密码登录。以前这样算本机,现在只有局域网会话的权限,选文件夹、改 AI 设置这类「仅本机」的操作要回到 MineDeck 的窗口里做。局域网设备和 MineDeck 自己的窗口用法不变。
  • 隧道不能指向 MineDeck 自己的网页端口:自定义 frps 隧道的本地端口如果是 MineDeck 这次的网页端口,新增、修改、启动都会拒绝。
  • 操作记录里的凭据遮得更全了;隧道日志里也会遮掉这次启动用的凭据。

其他改动

  • 新建服务器、导入整合包可以取消:任务页上有「取消创建」,会等半成品清理完再结束。已经开始登记的最后一步不能取消。
  • 整合包导入完成之前不出现在服务器列表里,不会再有一台看着建好了、其实文件还没放全的服务器。导入失败时半成品会清掉。
  • 待决文件只能补进 mods、plugins、config、resourcepacks、datapacks 这类普通文件夹;世界和 server.properties 请走「地图」页和设置页。
  • 备份:同一台服务器的两次备份排队做;服务器在热备的过程中重启了,这次备份会作废、不留半份。还原之前先检查压缩包能不能打开、里面的路径对不对,检查没过不会动现有的世界。
  • 磁盘:复制地图、备份、解包这类大量写文件的操作,落在同一个磁盘上时排队进行,开始前和过程中都会看磁盘还剩多少。磁盘剩余不到 256 MB 时,下载和备份会直接告诉你空间不够。
  • 上传(地图、整合包、交接包、本地模组):30 秒没有收到新数据会停下并提示重新上传;超过上限的当场拒绝,不用等传完。
  • 打开压缩包之前先看它申报的大小:包尾写着几百万个文件的压缩包会直接拒掉,不会先按这个数去要内存。导入、还原备份、下载来的 Java 和 frpc 都过这一道。
  • 保存设置和配置文件时,两个窗口同时改不会再互相盖掉;程序被打断时不会留下写了一半的文件。

下载哪个文件

文件 给谁
MineDeck.exe 开服的人。放进一个单独的空文件夹,双击运行。
minedeck-companion-neoforge-1.21.1-0.2.1.jar 用了 AI 伙伴的 NeoForge 1.21.1 服上的好友:放进客户端的 mods 文件夹
minedeck-companion-forge-1.20.1-0.2.1.jar 同上,Forge 1.20.1 的服
SHA256SUMS 校验和,自动更新会用到,一般不用管

伙伴模组和 v3.1.x 的是同一份,已经装过的不用换。

这一版实际试过的

  • 自动测试:Go 测试在 Windows 上全部通过(41 个包),带竞态检测再跑一遍也全部通过;界面交互测试 180 条、界面原型 117 个场景在仿真后端上走通(交互测试里有一条要连外网,头一次没连上,单独重跑通过)。
  • 换地图用真实的服务端试过:原版和 Paper 的 1.21.11、26.3,旧的世界布局、新的世界布局、跨版本升级三组,每一组都真的把服务器开起来,在主世界、下界、末地核对方块,再换回去核对,一共 50 项全部通过。
  • 这一版的改动请别家模型(Codex)做过三轮复审,查出来的问题都改了;改的地方逐条反着试过,把修复撤掉,对应的测试会失败。
  • 发版前在一台 Windows 11 上用编出来的程序做了基本核对:程序报的版本号对,不开窗口启动以后首页能打开。

还没测到的,请帮忙留意

  • 地图导入没有在 MineDeck 的窗口里完整点过一遍。界面测试用的是浏览器加仿真后端,真实服务端测试走的是接口。选文件夹、上传大地图、预览、确认、恢复点这些步骤,在真窗口里的样子请帮忙看看。
  • 导入以后用游戏客户端进服没有试过,只在服务端控制台核对了方块。
  • OpenFrp、樱花的真实账户没有试过,测试用的都是仿真的接口。
  • 真实的 AI Key 没有试过,各家服务商的兼容是按官方文档和录下来的样本测的。
  • 真的断电、真的把磁盘写满没有试过,对应的处理是用故障注入测的。
  • 1.12.2 的服务端没有试过热备份。

已知情况

  • AI 的一次回复有大小上限(8 MiB,按收到的原始数据算)。带很长思考过程的模型,一次回复有可能碰到上限,这时这一轮会停下并提示「回复内容过多」。碰到了请告诉我们用的是哪家的哪个模型。
  • 隧道的凭据短于 6 个字符时,日志里凡是包含它的行会整行换成「日志含凭据,已隐藏」。凭据特别短的话,会有不少不相干的行被隐藏,排查问题时不方便。
  • 查不出剩余空间的磁盘(少数网络盘、特殊的挂载方式):地图导入会多一条要你确认的事项;上传地图会被拒绝,请改成在这台电脑上直接选文件夹。下载和备份照常。
  • 备份的文件名变长了,时间后面多了一串数字,是为了让同一秒里的两次备份不重名。
  • 整合包导入到一半时程序被关掉,会在存放位置里留下一个文件夹,不出现在列表里,可以直接删掉。
  • 没有数字签名:第一次运行时,Windows 可能提示「Windows 已保护你的电脑」,点「更多信息 → 仍要运行」。
  • v3.1.0 发布说明里「已知情况」的其余几条(交接包和整合包的大小上限、CurseForge 整合包多数是给客户端用的、待决文件要在这次运行里处理完等)仍然适用,见 v3.1.0 的发布说明。

遇到问题,欢迎在 GitHub 上提 Issue,写清楚做了什么、看到了什么。不要贴出 API Key 和各种令牌。

What's Changed

  • 接入 OpenFrp 和 SakuraFrp 账户控制台 by @awaxiaoyu in #13
  • 地图导入:用已有的 Java 版世界开服或替换当前地图(草稿) by @Trasperioooooon in #18
  • 修复内置 AI 助手的渲染、模型和兼容服务商 by @Trasperioooooon in #19
  • 「仅本机」要带本次启动的令牌,隧道不许指向网页端口,操作记录脱敏补漏 by @Trasperioooooon in #20
  • 按合并后的两份 Codex 复审修:地图导入的恢复、并发、取消和资源上限等 by @Trasperioooooon in #21

Full Changelog: v3.1.2...v3.2.0-beta.1

v3.1.2

Choose a tag to compare

@github-actions github-actions released this 13 Nov 11:49

这是 MineDeck v3.1.2,一个小版本:修了 OpenFrp 隧道第一次启动时下不了 frpc 的问题,下载失败时的提示也写得更明白。没有新功能,界面没有变化。

怎么升级

用着 v3.1.1 的,打开「设置 → 更新与关于」,点「检查更新」就能升到 3.1.2。服务器、Java、设置和 AI Key 都会接着用。更新前先停掉正在运行的服务器。

从 v3.1.0、v3.0.0 或者 3.1.0 测试版也可以直接升到 3.1.2。只是这时换程序的是旧版本自己带的更新脚本,它有两种情况换不了程序,处理办法和升到 3.1.1 时一样,见 v3.1.1 的发布说明 最后的「已知情况」。

修了什么

  • OpenFrp 隧道第一次启动时下不了 frpc:OpenFrp 的下载源前面有一层机器人防护,它把 MineDeck 的下载请求当成了机器人,回的是 HTTP 567。于是还没下过 frpc 的电脑上,第一次启动 OpenFrp 隧道会停在「下载 OpenFrp frpc 失败」。现在这一处下载换了一种握手方式(只用 TLS 1.3),写这处修复时对着线上试过,这样能下回来。以前已经下好 frpc 的电脑不受影响,本来就不会再下一次。
  • 下载失败时说清是哪一种:不管下的是什么,几个下载源都试过还是不行的时候,报错里每个源的状态码后面会带一句原因。567 写「被源站 CDN 的机器人防护拦截」,403 写「源站拒绝访问:可能是机器人防护、链接失效或没有权限」,520 到 524 写「源站故障或超时」,404 写「该源没有这个文件」。别的状态码照旧只写数字。
  • OpenFrp 的 frpc 实在下不来时,告诉你怎么手动放:报错里会写上自己去 OpenFrp 下载 frpc_windows_amd64.zip,把压缩包里的 frpc_windows_amd64.exe 放进哪个文件夹(MineDeck 旁边的 runtimes\frpc\openfrp,程序会先把它建好),放好以后再点一次启动就行。

另外清掉了程序里两条一直挂着的代码检查提醒(窗口去标题栏和最小窗口那两处),只是换了一种写法,窗口的表现没有变。

下载哪个文件

文件 给谁
MineDeck.exe 开服的人。放进一个单独的文件夹,双击运行。
minedeck-companion-neoforge-1.21.1-0.2.1.jar 用了 AI 伙伴的 NeoForge 1.21.1 服上的好友:放进客户端的 mods 文件夹
minedeck-companion-forge-1.20.1-0.2.1.jar 同上,Forge 1.20.1 的服
SHA256SUMS 校验和,自动更新会用到,一般不用管

伙伴模组和 v3.1.0、v3.1.1 的是同一份,已经装过的不用换。

这一版实际试过的

  • 自动测试:Go 测试在 Windows 上全部通过,代码检查(go vet)没有任何提醒,以后每次提交 CI 都会跑这项检查。这一版加的测试逐条反着试过,把对应的代码改坏它们会失败:frpc 的下载没走新的握手方式、握手不止报 TLS 1.3、失败时没建好文件夹、窗口那两处把系统给的地址取错。窗口那两处换写法前后程序的行为是一样的,测试分不出新旧写法,守着写法的是代码检查。
  • OpenFrp 下载:自动测试用假的下载源验了被 567 拦下时报错里有原因和手动的办法,也验了这一处下载确实只用 TLS 1.3 握手。这些都不连 OpenFrp。真的去 OpenFrp 的下载源下一次 frpc,是写这处修复的时候试的,能下回来;发版前的这一轮检查没有再联网下一次。
  • 窗口:用发版那条命令编出来的程序打开真窗口,和正式版 3.1.1 逐项对照着量了一遍,两边的数字完全一样。量的是三件事:没有系统自带的标题栏,窗口内容从窗口顶边开始;最大化以后内容正好铺满屏幕的工作区,不露出系统标题栏,也不裁掉 MineDeck 自己的顶栏;把窗口缩到 400×300,它停在 1024×576 不再变小。窗口是脚本摆弄的,不是人手拖的;只在一块 100% 缩放的屏幕上试过。
  • 从 v3.1.1 在程序里点更新到 3.1.2,是 3.1.1 修好的那份更新脚本第一次真的换程序,要等发版以后才能实测。
  • 复审:两处改动由另一个 Claude 会话做了只读复审,没有查出必须改的问题。它提的建议里改了四条:403 的说法留了余地,下载失败时先建好放 frpc 的文件夹,给下载走哪种握手补了测试,CI 加了代码检查。握手失败时退回原来的方式再试一次,这条没有做。

已知情况

  • OpenFrp 的下载以后可能又被拦:这次的修复靠的是下载源的机器人防护眼下认哪种握手,对方哪天换了规则,下载会重新失败。那时照报错里写的办法手动放一次 frpc 就能接着用,也欢迎来提 Issue。
  • 网络出口不支持 TLS 1.3 时,OpenFrp 的 frpc 下不了:少数公司网络、代理或者杀毒软件的「HTTPS 扫描」只支持到 TLS 1.2,经过它们时这一处下载会握手失败。办法同上,手动放一次。别的下载不受影响。
  • 从 3.1.0 及以前的版本升级时可能换不了程序,以及和 v3.1.0 相同的几条,见 v3.1.1 的发布说明 和 v3.1.0 的发布说明。

遇到问题,欢迎在 GitHub 上提 Issue,写清楚做了什么、看到了什么。不要贴出 API Key 和各种令牌。

What's Changed

Full Changelog: v3.1.1...v3.1.2

v3.1.1

Choose a tag to compare

@github-actions github-actions released this 13 Nov 01:41

这是 MineDeck v3.1.1,修了 v3.1.0 里的几个问题,另外收紧了几处安全上的细节,没有新功能。

怎么升级

用着 v3.1.0、v3.0.0 或者 3.1.0 测试版的,打开「设置 → 更新与关于」,点「检查更新」就能升到 3.1.1。服务器、Java、设置和 AI Key 都会接着用。更新前先停掉正在运行的服务器。

有一件事要先知道:点了更新以后,换程序的是旧版本自己带的更新脚本。v3.1.0 和以前的这个脚本有毛病,有两种情况换不了程序(见最后「已知情况」第一条),从这些版本升到 3.1.1 时还可能碰上,照那里的办法处理就行。3.1.1 自己的更新脚本已经修好,以后从 3.1.1 往后升级就不会了。

修了什么

  • 点了更新换不了程序:以前的更新脚本把程序所在的文件夹直接写进脚本,中文系统读这份脚本时,中文路径会变成乱码;开机自动启动的 MineDeck,当前目录又不在自己的文件夹里,于是程序换不了,关掉以后也不会再打开。文件夹名字里有 % 也会这样。电脑的 PATH 里要是有别的 find 程序排在系统自带的前面,脚本不等旧程序退出就去换,同样换不成。现在这几种情况都能换好。实在换不成(比如杀毒软件一直锁着文件),会把旧版本重新打开,不会什么都没有;旧程序一直没退出的话,也不会再打开第二个。
  • 窗口版里的外部链接用你自己的浏览器打开:以前点 EULA、申请 CurseForge Key、openfrp.net 这些链接,弹出来的是 WebView2 自带的简易窗口,用不了自己浏览器里的密码管理器、扩展和登录状态。现在交给系统默认浏览器,Ctrl 点、中键点也一样。从局域网用浏览器打开 MineDeck 时照旧。
  • 窗口版里把文件或链接拖进窗口,不会再另开小窗:以前把文件或网页链接拖到窗口里(待装清单以外的地方),WebView2 会另开一个自带的简易窗口把它打开,和以前点外部链接时弹出来的是同一种小窗。现在没地方接的拖放一律不让放,松手没有反应。待装清单的「从电脑添加」照旧能把 jar 拖进去,输入框照旧能拖进文字。
  • 端口被占着时马上提示:以前别的程序只占着 0.0.0.0、127.0.0.1 这类地址上的同一个端口时,MineDeck 查不出来,点「启动」照样起服务器,要等服务器自己报错。现在照服务端绑端口的办法查,被占着就直接说「端口 25565 被别的程序占着」。崩溃自动重启和定时重启碰上端口还没放开,会先等几秒,不再连着撞三次。
  • 自定义 frps 的凭据能清掉:存过 token 的自定义 frps 隧道,卡片上多了「清除凭据」,清掉以后启动不带 token。以前只能删掉隧道重建。
  • run.bat 里的感叹号:有人在注册表里给 cmd 全局打开了延迟展开的话,手动双击 run.bat 时,名字和参数里成对的感叹号之间的字会被换掉。现在不会了。

几处安全加固

都是 v3.1.0 正式版前检查时记下、说好下个版本收掉的,前提都比较少见。

  • 读写配置不会顺着目录联接跑到服务器文件夹外面:服务器文件夹里有指到外面的目录联接或符号链接时,经过它的配置文件,在 MineDeck 里读不了也改不了。以前这一步查不清就放行了。
  • 换 AI 服务商时写盘失败,不会把旧 Key 发到新地址:设置和 Key 要么一起生效,要么都不生效。
  • 局域网登录的设备看不到完整的 Webhook 地址:只显示地址的开头,后面常带着令牌的部分藏起来了,要改就整个重填。本机照旧看完整的地址。
  • 导入时统一检查 Windows 文件名:现成服务端压缩包、整合包和交接包里,CON.txt、COM1.log 这类设备名,结尾是点或空格的名字,不再收下。只差大小写的两个文件在 Windows 上是同一个,以前后一个悄悄盖掉前一个,现在会写进任务日志。

首次启动协议的两处措辞

第一次打开 MineDeck 时看到的《用户协议与免责声明》改了两处说法:开头的「开源、非营利」改成「开源、免费」;「非官方产品」一条里的「本工具由社区独立开发」改成「本工具为独立开源项目(由随迹提供维护支持)」。别的内容没有动,已经同意过的不会再弹出来。

升级以后要留意的

  • 服务器文件夹里用目录联接把 config 或 world 挪到了别的盘的,经过联接的配置文件在 MineDeck 里读不了也改不了,要直接去那个文件夹里改。
  • 交接包里有 CON.txt 这类名字的,整个包导入不进来。这类名字在 Windows 11 上建得出来,3.1.0 在这种电脑上导出的包里可能有。在原来的电脑上把那个文件改个名字,再导出一次就行;3.1.1 导出时会把这类文件留在包外,写进剔除清单。
  • 从局域网打开「通知与集成」时,Webhook 地址只显示开头。
  • 端口被占着时,「启动」直接报错,不再先起服务器。

下载哪个文件

文件 给谁
MineDeck.exe 开服的人。放进一个单独的文件夹,双击运行。
minedeck-companion-neoforge-1.21.1-0.2.1.jar 用了 AI 伙伴的 NeoForge 1.21.1 服上的好友:放进客户端的 mods 文件夹
minedeck-companion-forge-1.20.1-0.2.1.jar 同上,Forge 1.20.1 的服
SHA256SUMS 校验和,自动更新会用到,一般不用管

伙伴模组和 v3.1.0 的是同一份,已经装过的不用换。

这一版实际试过的

  • 自动测试:Go 测试在 Windows 上全部通过,界面交互测试全部走通。每一处修复都反着验过:把修复改回去,对应的测试会失败。
  • 更新:用这一版的代码编了一个「3.0.9」,放在名字带中文和 % 的文件夹里,从 System32 启动(和开机自启一样),PATH 里放着 Git 自带的 find,点更新,换成了线上的 v3.1.0 并自己打开;更新脚本在 936 代码页下也换得成。从 v3.1.0 点更新到 3.1.1 这条路,发版以后再实测。
  • 端口检查:和 Java 17 实际绑端口的结果对照了六种占法,都一致。
  • 窗口版:用发版那条命令编出来的程序打开真窗口,照手测清单用脚本走了一遍。鼠标点击和拖放是通过 WebView2 的调试端口送进窗口的,不是人手点的。
    • 外部链接:openfrp.net 用左键、Ctrl 点、Shift 点、中键各点一次,加上新建向导里的 EULA、CurseForge 的「免费申请」和添加隧道时 OpenFrp 的链接,每一次都由系统默认浏览器(Chrome)打开,没有弹小窗。字体许可的两个文件是 MineDeck 自己的地址,照旧在小窗里显示。
    • 「清除凭据」:先弹确认框,点取消什么都不变,确认以后凭据清掉、按钮消失。
    • 端口:别的程序占着 127.0.0.1 上的同一个端口时,点「启动」马上报错,服务器没有起来;放开以后服务器正常起来,再停掉。
    • 拖放:和正式版 3.1.0 做了对照。3.1.0 上链接和文件拖进来会另开小窗,这一版松手没有反应;jar 照旧能拖进待装清单,文字照旧能拖进输入框。
    • 没做的:没有用鼠标从资源管理器或浏览器里真的拖一次,拖着的时候光标是什么样子也没有看;右键点链接没有试。
    • 协议的措辞是最后才合进来的。合进来以后重新编了一次,在全新的文件夹里打开窗口看过首次启动的协议,是新措辞;端口、清除凭据、拖放和一个外部链接也在这份程序上重跑了一遍。
  • 复审:更新脚本、外部链接、端口检查和四处加固,另请 Gemini 4 Argon 分五份做了只读复审,它提的意见里站得住的都改了,其余几条记在交接说明里;清除凭据由 Claude 逐行审过。

已知情况

  • 从 3.1.0 及以前的版本升级时,可能换不了程序:换程序的是旧版本的更新脚本,它在两种情况下换不成。一种是 MineDeck 装在名字里有中文(或者别的非英文字符)的文件夹里,而这次的 MineDeck 是开机自动启动的:点了更新以后程序关掉,就不会再打开,也没有提示。另一种是电脑的 PATH 里有别的 find 程序排在系统自带的前面(装过 MSYS2、Cygwin 一类工具的电脑可能这样):程序会重新打开,但还是旧版本。两种情况下,新版本都已经下载好、校验过,放在 MineDeck.exe 旁边,叫 MineDeck.new.exe,服务器和设置都不受影响。第一种情况,双击 MineDeck.exe 打开,再点一次更新就行。两种情况都可以手动换:先退出 MineDeck(在托盘图标上右键退出),把 MineDeck.exe 删掉,再把 MineDeck.new.exe 改名成 MineDeck.exe。
  • 和 v3.1.0 相同的几条(交接包和整合包的大小上限、客户端整合包、待决文件只在这次运行里有效、没有数字签名等)见 v3.1.0 的发布说明。

遇到问题,欢迎在 GitHub 上提 Issue,写清楚做了什么、看到了什么。不要贴出 API Key 和各种令牌。

What's Changed

Full Changelog: v3.1.0...v3.1.1