v3.2.0-beta.3
A newer Beta release, v3.2.0-beta.5, is available →
Files
| File | Size | SHA-256 | Download |
|---|---|---|---|
| MineDeck.exeWindows app | 17.0 MB | 157a17baddf3…5a3524 |
MirrorGitHub (external link, may be slow in mainland China) |
| minedeck-companion-neoforge-1.21.1-0.2.1.jarAI companion client mod (NeoForge 1.21.1) | 120 KB | 6ea730abf361…8c690e |
MirrorGitHub (external link, may be slow in mainland China) |
| minedeck-companion-forge-1.20.1-0.2.1.jarAI companion client mod (Forge 1.20.1) | 119 KB | 06449d883601…014474 |
MirrorGitHub (external link, may be slow in mainland China) |
| SHA256SUMSSHA-256 list of all files | 1 KB | 7fe20dbcc302…efaf75 |
MirrorGitHub (external link, may be slow in mainland China) |
Release notes
Release notes are written in Chinese.
这是测试版,给自己和好友试用、找问题的,可能还有毛病。
- 从 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 https://github.com/Trasperioooooon/MineDeck/pull/26
Full Changelog: https://github.com/Trasperioooooon/MineDeck/compare/v3.2.0-beta.2...v3.2.0-beta.3