MineDeck

v2.9.0-beta.2

BetaSame day as the previous releaseMineDeck.exe · 13.4 MB

A newer Beta release, v3.2.0-beta.5, is available →

Files

FileSizeSHA-256Download
MineDeck.exeWindows app 13.4 MB 7b807cfcc8ce…6e9752 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 9050d0bf3901…afd8a0 MirrorGitHub (external link, may be slow in mainland China)

Release notes

Release notes are written in Chinese.

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

  • 请放进一个新的空文件夹里运行。要拿已有的服务器试,先把整个文件夹备份一份。
  • 测试版之间不会自动更新:从 beta.1 升级要手动下载新的 MineDeck.exe,替换掉原来的。
  • 正式版会是 v2.9.0,装了测试版的人到时能在「设置 → 更新与关于」里直接更新。

下面是和 beta.1 相比的变化。beta.1 新加的功能(AI 接入、应用内 AI 助手、报错横幅、游戏内 AI、音乐共享、AI 伙伴、界面 v5)见 v2.9.0-beta.1 的发布说明。

新功能:MCP 接口

MCP 是 AI 工具调用外部程序的通用协议。打开以后,这台电脑上的 Claude Desktop、Cherry Studio、Cursor、VS Code 这些 AI 工具就能直接使用 MineDeck。

  • 怎么用:在「设置 → AI(可选)→ MCP 接口」打开开关,点「复制配置…」,选你用的工具,按说明粘贴进去。默认是关着的。
  • AI 工具能做什么:查服务器状态、看日志和配置这类操作直接执行。改配置、重启服务器这类操作只会提出请求,MineDeck 会弹出提示,在「AI 助手」面板顶上出现确认卡片,你点了确认才执行。只能由人操作的功能,外部 AI 工具看不到。
  • 安全:只接受这台电脑上的连接,要带访问令牌。令牌加密保存,可以随时重置。发给 AI 工具的内容和应用内助手一样先脱敏,看不到 Windows 用户名和局域网 IP。
  • 不需要 MineDeck 自己的 AI Key:用的是那个 AI 工具自己的模型。

AI 伙伴:伙伴模组 0.2.1

  • 不再淹死:停下来的伙伴站在水里,会像普通生物一样浮上来,以前过半分钟左右会淹死。
  • 给东西时说实话:按实际交出的个数报结果。一个都没给出去时说「失败了」,并写明原因,比如对方不在同一个维度、背包里没有;只给了一部分时说「没做够」。以前一律报「做完了」。
  • 重启后马上列出伙伴:重启服务器以后,「伙伴」标签一连上就列出存档里的伙伴,以前要等两秒左右。

升级:

  • 服务器上的伙伴模组:在「伙伴」标签里点「安装」,会换成 0.2.1,要先停服。
  • 好友的客户端:把伙伴模组换成 0.2.1(见下面的附件),版本要和服务器的一样。版本不一样时,Forge 1.20.1 的多人游戏列表里会显示红色的「不兼容」标记,但实际能进服。

其他

  • 修复: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校验和,自动更新会用到,一般不用管

怎么测、怎么反馈

  • 测试清单:测试计划。测过 beta.1 的,这次重点测 J 组「MCP 接口」,以及 H 组里写着「0.2.1 起」的几条。
  • 给好友看的:好友测试指南。
  • 反馈:发现问题,按测试计划里的「反馈格式」写好,发给房主,或者在 GitHub 上提 Issue。不要贴出 API Key 和 MCP 的访问令牌。

已知情况

  • 没有数字签名:第一次运行时,Windows 可能提示「Windows 已保护你的电脑」,点「更多信息 → 仍要运行」。
  • 国内下载:AI 伙伴依赖的 PlayerEngine 和 Architectury API 从 Modrinth 下载,AI 的价格数据从 GitHub 下载,国内网络可能慢或下载不了。下载速度的问题放到正式版之前统一处理。
  • Windows 10 上的音乐共享:只能录整机的声音,会把游戏声音也录进去,开始前会提醒。
  • MCP 接口还没在真 Windows 上和真的 AI 工具一起测过:
    • 在云端是用官方的客户端库,对 wine 里跑的 MineDeck 测的。
    • Cursor 的配置写法还没核实。
    • Claude Desktop 启动 MineDeck.exe -mcp 时会不会有短暂的转圈光标,要在真机上看。
  • AI 伙伴:MineDeck 和伙伴模组在云端的无头服务器上联调全部通过,但还没和玩家的正式客户端、真实的 AI Key 一起测过。
  • 游戏内 AI 和音乐共享:云端只用假的服务器测过。

Full Changelog: https://github.com/Trasperioooooon/MineDeck/compare/v2.9.0-beta.1...v2.9.0-beta.2