v3.1.0-beta.4
A newer Beta release, v3.2.0-beta.5, is available →
Files
| File | Size | SHA-256 | Download |
|---|---|---|---|
| MineDeck.exeWindows app | 14.5 MB | 507282680e39…8ad36c |
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 | 31128b1d5f1d…618de4 |
MirrorGitHub (external link, may be slow in mainland China) |
Release notes
Release notes are written in Chinese.
这是测试版,给自己和好友试用、找问题的,可能还有毛病。
- 请放进一个新的空文件夹里运行。要拿已有的服务器试,先把整个文件夹备份一份。
- 测试版之间不会自动更新:从 beta.1、beta.2、beta.3 升级要手动下载新的
MineDeck.exe,替换掉原来的。用着 v3.0.0 的不会收到这个版本的更新提示。- 正式版会是 v3.1.0,装了测试版的人到时能在「设置 → 更新与关于」里直接更新。
这一版主要是界面和文字:试用 beta.2 时提的几条界面问题改了,界面上的文字整个重写了一遍,报错的样子也换了。另外修好了 OpenFrp 的 frpc 下载,导入整合包能认更多种压缩包。beta.1 到 beta.3 的内容见 v3.1.0-beta.1、beta.2、beta.3 的发布说明。
界面
- 选文件夹不再冒出黑窗口。 以前点「浏览」「更改…」会先闪出一个命令行窗口,把它关掉界面还会报错。现在用的是 Windows 自带的选文件夹窗口,标题是中文,挂在 MineDeck 的窗口上。
- 窗口最小 1024×576,再拖小也不会把页面挤乱。
- 新建服务器的四种方式排成两组一样大的卡片:「从零创建」「导入整合包」,「导入交接包」「接管已有服务器」。首页没有服务器时,主按钮直接进「从零创建」。
- 「购物车」改叫「待装清单」。 选模组这一步分成两栏:左边一打开就是当前核心和版本下的热门模组(按下载量,可以按类别筛、往下翻),右边是待装清单。自己下载的 jar 可以「从电脑添加」,装的时候一起放进去,前置模组照样自动检查。
- 内网穿透页的添加表单挪到了列表上面。
- 界面上的文字重写了一遍:统一说「服务器」「文件夹」,去掉了绕弯子的说法。常用设置和全部配置里有十来项的说明也重写了,motd 的中文名统一叫「服务器介绍」。
报错
- 报错先说没做成什么,比如「无法启动服务器」。后端给的原因是一句看得懂的中文时,接在后面一起显示:「无法启动服务器:端口 25565 已被其他程序占用……」。原因里带着文件路径、英文的系统报错时,正文只写结论,完整的原文点「详情」就能看到、能复制。
- 页面上的报错框(比如服务器列表拿不到时)是一句结论加一个「复制报错信息」按钮,原文一字不少,发给别人帮忙看时直接粘贴。
- AI 服务商的报错直接说原因:「连接失败:Key 不对或已失效」「账户余额不足」这类,状态码和服务商的原话在复制出来的原文里。
- 启动时的几句报错说清楚了:服务器已经在运行、正在启动或正在停止时又点启动,会直接说是哪种情况;找不到这台服务器用的 Java 时,直接说去「内存 / 启动」里重新选一个。
内网穿透
- OpenFrp 的 frpc 下载不下来的问题修好了。 以前拼出来的下载地址不对,几个下载源都是 404,Windows 上用 OpenFrp 一直装不上 frpc。多个下载源都失败时,报错会按下载源列出各自的原因。
- frpc 被杀毒软件拦下或删掉时,会说清楚。 frp 这类内网穿透程序常被杀毒软件当成风险软件(Windows 自带的防护会报
PUA:Win32/FRProxy之类),以前只看到一句英文的系统报错。现在隧道卡片上会说「frpc 被杀毒软件拦下了」或「frpc 不见了,多半是被杀毒软件删掉了」,告诉你到 Windows 安全中心的「保护历史记录」里允许或还原它(别的杀毒软件到它的隔离区里恢复),以及 frpc 在哪个文件夹。
导入整合包
- 清单套了一层文件夹的整合包能导入了。 以前只认压缩包最外层的
modrinth.index.json或manifest.json,作者把整合包文件夹再压一层(整合包名/manifest.json)就报「无法识别」。现在套一层也认。 - 作者给的现成服务端压缩包可以直接导入。 压缩包里没有整合包清单,但有
mods、plugins、server.properties或服务端 jar,就直接解压成一台新服务器,不重新下载核心。所以核心得已经在包里:Forge、NeoForge 要带着装好以后的libraries文件夹,Fabric、Paper、原版等要带着服务端 jar。核心和版本用「接管已有服务器」的办法识别,认不出来会说明缺什么。- 整合包作者另外提供的 Server Pack 不一定能直接导入。 不少 Server Pack(Forge、NeoForge 的尤其多)只带模组、配置和一个启动脚本,有的再加一个加载器的安装器,第一次运行脚本时才去装加载器。这种包导入时会被拒绝,提示「看着像现成服务端,但没认出核心和版本」;解压以后直接用「接管已有服务器」也认不出。可以先解压,运行包里的启动脚本把加载器装好(脚本一般要用电脑上装好的 Java),再用「接管已有服务器」选中那个文件夹;也可以在 MineDeck 里「从零创建」一台同样版本的 Forge 或 NeoForge,再把包里的
mods、config这些文件夹拷进去。 - 压缩包里已经有
server.properties的,只改端口,正版验证和允许飞行沿用包里的,导入页上的这两项不起作用(要改到「常用设置」里改)。这样原来正版验证的服务器不会被改成离线,玩家的背包、白名单、管理员都对得上。 - 1.12 到 1.16.5 的老服务器和新建时一样,加上 log4shell 漏洞的防护。
- 包里原来的启动脚本(
run.bat、user_jvm_args.txt)不采用,内存按导入页上填的;只写在原来启动脚本里的 JVM 参数要自己到「内存 / 启动」里加。 - 解压出来的服务器算 MineDeck 新建的:删除时文件夹会一起删(你手里的原压缩包不受影响)。
- 整合包作者另外提供的 Server Pack 不一定能直接导入。 不少 Server Pack(Forge、NeoForge 的尤其多)只带模组、配置和一个启动脚本,有的再加一个加载器的安装器,第一次运行脚本时才去装加载器。这种包导入时会被拒绝,提示「看着像现成服务端,但没认出核心和版本」;解压以后直接用「接管已有服务器」也认不出。可以先解压,运行包里的启动脚本把加载器装好(脚本一般要用电脑上装好的 Java),再用「接管已有服务器」选中那个文件夹;也可以在 MineDeck 里「从零创建」一台同样版本的 Forge 或 NeoForge,再把包里的
- 导入失败时,提示里先说一句人话,比如「无法导入整合包:没认出这个压缩包,既没有整合包清单,也看不出是服务端」,怎么办的长说明点「详情」看。
其他修复
- 导入交接包失败时,先把装了一半的文件夹清理干净,再显示失败。以前偶尔会出现失败框写着「已经清理干净,可以重试」、文件夹其实还没删完的情况。
这一版实际试过的
- 自动测试:Go 测试全部通过;界面交互测试 126 条、界面原型 107 个场景,在仿真后端上全部走通。
- OpenFrp 的 frpc 下载:在一台 Windows 11 上按程序的真实代码走了一遍接口和三个下载源,能下到真的 frpc 并解压出来。
- frpc 被杀毒软件拦下:用杀毒软件的标准测试串让 Windows 自带的防护真的拦了一次,隧道报出来的是那句中文说明。
- 导入现成服务端压缩包:用编出来的程序走了一遍接口,一个套了一层文件夹的 Paper 服务端压缩包导入成功,正版验证保留原样、端口改成了导入页填的,包里的启动脚本和 MineDeck 自己的登记文件没有被采用;一个什么都不是的压缩包,报出来的是那句人话。另外用测试代码造了只带启动脚本的、只带 Forge 安装器的服务端压缩包,都在识别这一步被拒绝。用的都是造出来的压缩包,没有拿真的 Server Pack 开服进游戏。
- 选文件夹的窗口、最小窗口:在真程序里试过,选文件夹挂在主窗口上、开着时主窗口不能点,窗口拖到最小停在 1024×576。
- 代码由别家模型交叉审过:界面优化由 Gemini 审过,文案和报错这一轮由 Codex 审了四轮,导入现成服务端这一块由 Claude 的独立评审员审过、修改后又交 Codex 审了一轮,找出的问题都改了。
请重点帮忙试这些
- 真的 Server Pack:拿 CurseForge 或 Modrinth 上整合包作者给的服务端压缩包,在「导入整合包」里导一个。带着装好的加载器的,看认出来的核心和版本对不对、能不能开起来、进游戏世界和模组在不在;只带启动脚本的会被拒绝(见上面「导入整合包」),看提示能不能让你明白下一步怎么做。Forge、NeoForge、Fabric 的都想试。
- 在真实的窗口里把新界面走一遍:这一版界面改动多,原生窗口里还没人从头到尾看过。看到读着别扭的文字、对不齐的地方,请截图告诉作者。
- 碰到报错时,提示里那句话是不是说清楚了是哪一步没做成;点「详情」或「复制报错信息」拿到的原文全不全。
- 待装清单的「从电脑添加」,以及热门清单的类别和翻页。
- 用 OpenFrp 开隧道,以及 Windows 安全中心拦下 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.0.0、beta.1 到 beta.3 的是同一份,已经装过的不用换。
已知情况
和 beta.2 相同的几条见 v3.1.0-beta.2 的发布说明里的「已知情况」(交接包不能超过 8 GB;CurseForge 上的整合包多数是给客户端用的,装出来的服务器常常开不起来)。这一版新增的:
- 整合包和现成服务端压缩包:包装文件夹只认一层;整包里只能有一处整合包清单;几个文件夹都像服务端时不猜,会让你只打包一台。Quilt 仍不支持。服务端的版本如果只写在
logs/latest.log里,这次认不出来,用「接管已有服务器」自己填。 - 只带启动脚本的 Server Pack 导不进来,怎么绕过去见上面「导入整合包」。被拒绝时「详情」里的说明只叫你改用「接管已有服务器」,还没提要先运行启动脚本装好加载器,而加载器装好以前接管同样认不出。beta.2 发布说明里「下载 Server Pack、解压以后接管」那条,也要先把加载器装好。
- 报错的长说明:后端给的原因带着文件路径、英文的系统报错,或者超过 60 个字时,提示里只写结论,原因要点「详情」看。隧道卡片上的失败原因照旧整句显示。
- 常用设置里 1.21.9 以上的几个游戏规则开关(命令方块、PVP、下界、刷怪):开关的初始状态按
server.properties里的旧值显示,不看服务器当前的游戏规则。文件里没有这一项时,命令方块会显示成关,其实游戏里默认是开。
发现问题请在 GitHub 上提 Issue,或者直接告诉作者。不要贴出 API Key 和各种令牌。
What's Changed
- Rewrite README in Chinese and add an English version by @Trasperioooooon in https://github.com/Trasperioooooon/MineDeck/pull/9
- 修复 Windows 下载 OpenFrp frpc 失败(改用 latest_full) by @Trasperioooooon in https://github.com/Trasperioooooon/MineDeck/pull/11
- 界面和文案优化:选文件夹不再冒黑窗、最小窗口、新建页与内网穿透布局、选模组的热门清单和本地模组、界面文案重写,附界面原型 by @Trasperioooooon in https://github.com/Trasperioooooon/MineDeck/pull/12
- 导入整合包时识别套层清单和现成服务端压缩包 by @Trasperioooooon in https://github.com/Trasperioooooon/MineDeck/pull/14
Full Changelog: https://github.com/Trasperioooooon/MineDeck/compare/v3.1.0-beta.3...v3.1.0-beta.4