MineDeck

帮助

第一次用 MineDeck,从快速开始看起。

快速开始

  1. 打开程序,在窗口里点「新建服务器」。
  2. 选核心、版本、构建,勾选 EULA,点创建。
  3. 创建完成后点启动。控制台出现 Done (...)! 时,这台服务器就开好了。
  4. 同一个局域网里的朋友,用 这台电脑的局域网 IP:端口 连接。不在同一个网络的朋友,由你在「内网穿透」里加一条隧道,绑定这台服务器并打开「跟随实例启动」,再把公网地址发给他们。
MineDeck 服务器列表:四台服务器,含 Paper、Forge、原版和 Velocity

常用入口

  • 发命令:打开服务器 → 控制台 → 底部输入框。
  • 改配置:打开服务器 → 常用设置,或全部配置。要重启才生效的项会标出来。
  • 调内存:打开服务器 → 内存 / 启动。测试版还可以在这里换 Java。
  • 手动开服:每台服务器的文件夹里有一份和界面等效的 run.bat。
  • 不开窗口运行:MineDeck.exe -nogui。默认端口 27333,可以加 -port 指定,被占用时改用随机端口。管理页面的地址和令牌打印在程序的日志输出里;发布版是窗口程序,在终端里直接运行看不到这一行,要把标准错误输出重定向到文件。
  • 给本机的 AI 工具做 stdio 桥:MineDeck.exe -mcp。要先在设置里打开 MCP 接口,并且 MineDeck 已经在运行。

常见问题

要自己装 Java 吗?

不用。电脑里已经有合适的 Java,MineDeck 会直接用。没有的话,它会按游戏版本下载一份,只给自己用,不改系统设置。

#
朋友不在同一个网络,怎么连进来?

在「内网穿透」里添加一条隧道,OpenFrp、樱花穿透或你自己的 frps 都可以。把隧道绑定到这台服务器,并打开「跟随实例启动」。开服后把公网地址发给朋友。同一个局域网里的朋友不用隧道。

#
支持哪些版本和核心?

Minecraft 1.12.2 到最新的正式版,包括 26.x。核心有 12 种,见功能页。Modrinth 的 .mrpack 和 CurseForge 的 zip 整合包可以导入。

#
服务器起不来,报错看不懂怎么办?

先看控制台顶部的报错横幅。缺前置模组、把客户端模组放进了服务器、端口被占、Java 版本不对,这些常见原因它都能直接认出来,不需要 AI。接了 AI 的话,可以点「让 AI 分析」,或者在 AI 助手里直接问。

#
AI 会不会自己改服务器?要不要另外花钱?

AI 是可选的,不配置就不联网。要用就填你自己的 API Key,费用由你选的服务商收取;MineDeck 会估算花了多少,每个功能可以设每天的用量上限。看日志、读配置它可以直接做;改配置、换 Java、重启之前会先出一张确认卡片,你点了才执行。游戏内 AI 只有你勾选的玩家能让它执行命令,而且只能是白名单里的,op 和 execute 不会执行。

#
AI 伙伴和音乐共享,好友要装什么?

AI 伙伴:好友的客户端装伙伴模组,下载页有,按服务器的加载器和游戏版本选。音乐共享:服务器和好友都装同一版本的 Simple Voice Chat;桥接模组由 MineDeck 装进服务器,好友不用装。

#
稳定版和测试版怎么选?

日常开服用稳定版。测试版是正式版发布前先放出来试的,带着还没进稳定版的新功能,可能还有毛病。有比稳定版更新的测试版时,下载页会列出来。测试版请放在单独的文件夹里,拿已有的服务器试之前先备份。测试版之间不会自动更新;等正式版发布,装着测试版的人可以在设置里直接更新过去。

#
Windows 提示「已保护你的电脑」?

MineDeck.exe 没有数字签名,第一次运行时 SmartScreen 可能拦截。点「更多信息 → 仍要运行」。可以先按下载页的方法核对 SHA-256。

#
局域网里的朋友连不上?

第一次启动某台服务器时,Windows 防火墙可能弹窗,要选「允许访问」,局域网里的朋友才能连上。

#

数据位置、搬家与卸载

  • 数据默认都在 exe 所在的文件夹里:servers、backups、runtimes(下载的 Java 和穿透客户端)、cache、logs、data,以及 config.json、secrets.json、tunnels.json 这几个文件。只有界面偏好存在 %LocalAppData%\MineDeck。
  • 搬家时把整个文件夹拷走。secrets.json 和 tunnels.json 里的密钥是按这台电脑上的这个 Windows 用户加密的,换了电脑或用户要重新填。新位置的路径和原来不一样时,用着 MineDeck 自带 Java 的服务器会提示找不到 Java,要重新指定一次:测试版在「内存 / 启动」里选;稳定版界面上没有这个入口,接了 AI 的可以让助手换。
  • 不要删 runtimes 文件夹,删了以后用着这份 Java 的服务器会启动不了。
  • 卸载:开过开机自启的,先在「设置 → 启动与托盘」里关掉;然后删掉 exe 所在的文件夹和 %LocalAppData%\MineDeck。把服务器或备份改存到了别处的,那些文件夹要另外删。

已知边界

  • 界面只有中文,程序只有 Windows 版。
  • Paper、Purpur 这些核心没有国内镜像,一般直接连官方地址就能下载。安装 Forge 和 NeoForge 时,有一部分文件仍然要从官方源取,官方源连不上时这一步可能失败。
  • 备份只包含世界,不包含模组、插件和配置。
  • 更新 MineDeck 之前要先停掉所有服务器。
  • Windows 10 上的音乐共享只能录整机的声音。
没找到答案?提交问题 →