功能
每一节先说能拿它做什么,细节点开看。这里写的功能,稳定版 v3.2.2 里都有。
服务端核心
十二种服务端核心都能直接建,从原版到模组服、插件服和群组代理。
- 原版:Vanilla。插件服:Paper、Purpur、Leaves、Folia。模组服:Fabric、Forge、NeoForge。模组和插件都能用:Mohist、Banner。群组代理:Velocity、Waterfall。
- Minecraft 版本从 1.12.2 起,包括按年份编号的 26.x。版本列表从官方清单读取,以后出的新版本也会出现。
版本与 Java
Java 不用自己装。MineDeck 按游戏版本挑对的那一个,电脑里有就直接用,没有就下载一份只给自己用。
- 常见的对应关系:1.17 以前用 Java 8,1.17 用 16,1.18 到 1.20.4 用 17,1.20.5 到 1.21 用 21,26.1 及以后用 25。实际以这个游戏版本自己写明的要求为准。
- 下载的 Java 放在程序目录里,不改系统环境变量,也不影响你已经装好的 Java。
- 每台服务器可以在「内存 / 启动」里换 Java。整合包里的模组要求更高的 Java 时会提示,但不拦着你启动。
更多细节
- 启动时在后台扫描本机已装的 Java:注册表、JAVA_HOME、PATH 和常见安装目录。
- 下载顺序:清华 TUNA 的 Adoptium 镜像,然后 Adoptium 官方,然后 Mojang 官方运行时。前两级的地址是固定的,不受「下载源」设置影响。
- 可以在「设置 → Java 运行时」里重新扫描,或者指定一个本机的 java.exe 加入列表。
创建与安装
选核心、选版本、勾选 EULA、点创建,剩下的它自己做完。
- 向导里依次选核心、版本、构建,再填内存、端口、难度和游戏模式。正版验证默认关着,允许飞行默认开着。
- 下载优先走国内镜像,镜像不可用再换官方源。一个源失败就换下一个,最多试 3 轮,下完会校验文件。
- 安装 Forge、NeoForge 时让安装器走镜像,失败了自动再跑,最多跑 3 次。
- 关掉 MineDeck 时,正在跑的服务器和隧道一起停,不会有 Java 进程留在后台。
更多细节
- Paper、Purpur、Leaves、Folia、Mohist、Banner、Velocity、Waterfall 没有国内镜像,直接连各自的官方地址。
- 下载源可以在「设置 → 下载与网络」里选自动、镜像或官方。
- 低于 1.18.1 的服务器会自动加上 log4shell 的缓解参数。
- 启动服务器时会清掉 JAVA_HOME 这类环境变量,免得用到别的 Java。
- 启动前检查端口有没有被占用。停止时先发 stop,约 30 秒还没退出就强制结束。
- 每台服务器的文件夹里有一份和界面等效的 run.bat,可以手动开服。
- 任务日志过长时,开头的 40 行会留着。旧版 Forge 安装器什么都没装却报告成功的情况,会被当成失败继续重试。
整合包导入
Modrinth 和 CurseForge 的整合包可以直接导入成一台服务器。
- Modrinth 的 .mrpack 直接导入:核心、版本和加载器从包里识别,只给客户端用的文件会跳过。
- CurseForge 的 zip 也能导入。填上你自己的 CurseForge API Key 以后才能自动下载里面的文件;没填时照常导入,那些文件要自己补。
- 以前只要有一个文件的下载地址不在允许的站点里,或者没有校验值,整个整合包就导不进来。现在这些文件列在任务页的「待决文件」里,每个自己选:「跳过」「用本地文件代替」,或者「信任站点并下载」。
更多细节
- 上传上限 4 GiB。
- CurseForge 的 Key 用 Windows DPAPI 加密保存,界面和 API 都不把明文发回去。
- CurseForge 清单里的文件按类别放置:模组进 mods,资源包进 resourcepacks,光影进 shaderpacks,数据包进 datapacks。
- 导入表单可以填「本地来源目录」,待决文件在这个目录里有同名的,会自动拿过来。
- 待决文件要在这次运行里处理完。关掉 MineDeck 再打开,任务页上的清单就没有了,只剩服务器文件夹里的文本清单。
- CurseForge 上的整合包多数是给客户端用的,照清单装出来的服务器可能一开就崩。大型整合包的作者一般另外提供 Server Pack,用那个更稳。
接管已有服务器
以前自己开的服务器,选它所在的文件夹,就能收进来一起管理。不用重新建,文件也不搬。
- 核心、版本、启动文件、原来分的内存和端口会自动认出来。
- 文件留在原地。原来的启动脚本会先留一份备份。
- 删除服务器时选了不删文件夹的,只是把它移出列表,以后还能再接管回来。
更多细节
- 原来没同意 EULA 的,要在表单里勾选才会写 eula.txt。
- 任务失败时,这次动过的文件恢复原样。
- 会拒绝的位置:整个磁盘、MineDeck 的程序目录、缓存和运行时目录、和备份目录重叠的文件夹、已经在列表里的文件夹。
- 原来启动脚本里另外写的 JVM 参数不会自动带过来,识别页会提示。外置登录这类靠 -javaagent 的,接管后要在「内存 / 启动」里补上。
- 接管只登记被接管的这一个文件夹,旁边的服务器不会跟着出现在列表里。
交接包
把一台服务器整个打成一个文件,交给另一台电脑上的 MineDeck 接着开。
- 服务器停着的时候,在卡片菜单里点「交接给其他电脑…」,生成一个 .mdpack 文件,微信、网盘都能发。
- 对方在「新建服务器」里选「导入交接包」,填名称和端口,装完就能启动。
- 包里有存档、配置、模组、插件、白名单和管理员名单。日志和崩溃报告不带;服务端核心默认不带,导入时重新下载。
- 给收包的人:包里的模组和插件会在你的电脑上运行,只导入信得过的人给的包。
- 给打包的人:配置文件是原样进包的,里面写着的密码也会一起交出去,在别处也用着的先改掉。
更多细节
- 两种用途:交给下一任服主接着开,或者发给朋友让他照着开一台。包里的文件相同,对方看到的说明不同。
- 勾上「完整模式」就连服务端核心一起打包,包会大不少。
- 原来的 JVM 参数、定时任务、崩溃自动重启、游戏内 AI、AI 伙伴和音乐共享不会带过去,原来开着的 RCON 会先关掉。
- 上传上限 8 GiB。存档超过这个数的,把整个文件夹拷过去,用「接管已有服务器」收进来。
- 包里还有封禁名单(里面有 IP 地址)。代理端会带上它自己的配置,包括 Velocity 的转发密钥。
模组与插件
在 MineDeck 里就能搜模组和插件,按你的核心挑能用的,直接装进服务器。
- 非原版的服务器有「资源」标签:在 Modrinth 上搜索,装到 mods 或 plugins。模组会按游戏版本过滤。
- 购物车:把想要的模组或插件先放进购物车,前置自动补齐,一次装好。新建向导里也可以先挑。
更多细节
- 插件不卡游戏版本,只按核心过滤。
- 只在客户端用的模组不会放进购物车;服务器里已经有的不重复装;下载后要对上 Modrinth 给的校验值。
- 可以点「检查依赖」看缺哪些必装前置。不检查,安装时也会一起装上。
- AI 助手可以帮着搜、帮着往购物车里放。真正安装时它只能提出来,你点了确认才装。
- 查看模组清单、启用或禁用某个模组、改模组的配置文件,这几样是给 AI 助手和 MCP 工具用的,界面上没有单独的入口。
运行、控制台与配置
日志、命令和配置都在一个窗口里,不用翻文件。
- 控制台:实时日志,警告和错误标颜色,可以过滤。命令有历史,常用命令和在线玩家名按 Tab 补全。
- 「常用设置」把 server.properties 里的 78 项分成 7 组,每项有中文名和说明,要重启才生效的会标出来。
- 服务器介绍(MOTD)可以选颜色并预览。
更多细节
- 老整合包出现乱码时,控制台可以在 GBK 和 UTF-8 之间切换。
- 「全部配置」列出 server.properties 里现有的全部键值,可以按中文名或键名搜索。
- Minecraft 1.21.9 及以后,已经改成游戏规则的项(比如 PVP、命令方块)在服务器开着的时候切换,立即生效。
- 「内存 / 启动」里调内存,下限 1024 MB,可以另外加 JVM 参数。
玩家
谁在线、谁有权限,在界面上点几下就能改。
- 看在线玩家,以及白名单、管理员、封禁三份名单。
- 加入或移出白名单,设为 OP,踢出,封禁或解封。
更多细节
- 服务器开着时走控制台命令,关着时直接改名单文件。踢人要服务器正在运行。
- 离线模式的 UUID 会自动算好。
备份与定时任务
世界可以随时备份和还原,也可以每天定时做。
- 立即备份、还原、删除。服务器开着的时候也能备份。
- 每天定时重启、执行一条命令,或者备份。
- 崩溃后自动重启默认关着。打开以后先等 10 秒,再等 30 秒,再等 60 秒,连续 3 次仍起不来就停止。
更多细节
- 备份的只是世界,不包括模组、插件和配置。
- 默认每台服务器保留 10 份,可以改成 1 到 1000。这个份数是全局设置,改了所有服务器一起变。
- 还原要先停服。还原之前会自动把当前的世界再备份一份。
内网穿透
朋友不在同一个网络也能连进来:加一条隧道,把公网地址发给他。
- 支持 OpenFrp、樱花穿透,也可以填你自己的 frps。
- 隧道可以绑定到某台服务器,跟着它一起启动。公网地址在页面上复制,有域名时优先显示域名。
更多细节
- OpenFrp 和自建 frps 用的客户端会自动下载。樱花穿透的客户端要按提示自己下载一次,放进指定的目录。
- 凭据用 Windows DPAPI 加密保存。换过电脑或 Windows 用户以后要重新填。
- 隧道分游戏和语音两种用途。语音隧道的公网地址会写进服务器的 voice_host;你自己填过别的值时不覆盖。
- 隧道启动失败的原因写在隧道卡片上,日志可以在界面里看。
窗口与外观
一个普通的 Windows 窗口,可以缩到托盘,可以开机自启,配色能换。
- 关掉窗口可以缩到系统托盘,服务器继续运行。可以开机自动启动,启动后直接进托盘。
- 7 套配色,每套都有浅色和深色,也可以跟随系统;另外有 8 种强调色。
- 服务器和备份可以改存到别的盘。
更多细节
- 界面在 WebView2 窗口里。电脑上没有 WebView2 时,用系统默认浏览器打开。
- 默认端口 27333,被占用时改用随机端口。
- 开机自启只写当前用户的启动项,不需要管理员权限。
- 后台任务在切页或刷新以后,还能从任务列表找回进度。
局域网与 API
手机和别的电脑也能管服务器。想接别的程序,有 API 和 Webhook。
- 打开「允许局域网访问」并设一个访问密码,重启 MineDeck 以后,同一局域网里的设备可以打开管理页面。
- 有本地 HTTP API。服务器启动、停止、崩溃、玩家进出、备份完成、隧道上下线这些事件,可以推送到你填的地址。
更多细节
- 访问密码在本机以 bcrypt 保存。
- 选择文件夹、打开目录、改 AI 设置这类操作只接受本机请求,局域网里的设备做不了。
- 更新:在「设置 → 更新与关于」里检查并应用。更新之前要先停掉所有服务器。
- 下载新版本时先试国内能用的加速地址,再直连 GitHub,下完要和发布页上的 SHA-256 一致。
- 用着稳定版不会收到测试版的更新提示,测试版之间也不会自动更新。装着测试版的人,等同一版号的正式版发布以后可以直接更新过去。
AI(可选)
接上你自己的 API Key 以后,可以让 AI 帮着看日志、回答玩家、带着伙伴干活。不配置就不联网。
- 应用内助手:先读日志、配置和崩溃报告再回答。要改配置、换 Java 或重启,会先给一张确认卡片,你点了才执行。
- 游戏内 AI:玩家在聊天里说 @AI 加问题就能问。你勾选的玩家可以让它执行白名单里的命令,op、execute 这类不会执行。
- AI 伙伴:NeoForge 1.21.1 或 Forge 1.20.1 的服务器里可以放 AI 伙伴,在聊天里叫它跟随、采集、打怪、送东西。
更多细节
- 两种协议:OpenAI 兼容和 Claude。预设有 DeepSeek、通义千问、Kimi、智谱、小米 MiMo、OpenAI、Claude、Ollama(本机),也可以填自定义地址。
- Key 加密保存在这台电脑上。费用按公开价格估算,每个功能可以设每天的 token 额度。
- 发给模型的内容会先替换掉 Windows 用户名、局域网地址和密钥,可以看实际发出去的原文。
- 游戏内 AI 默认每人每天 60 次。每次开服后第一次有人提问时,会告诉所有人问题会发给哪家服务商。
- 伙伴可以划禁挖区域、指定不许打的生物。好友的客户端要装伙伴模组,下载页有。
- 打开局域网访问以后,局域网里登录的设备默认也能用 AI 助手,花的是你的额度,可以在设置里关掉。
- MCP 接口:默认关着。打开以后,支持 MCP 的 AI 工具可以连上来查状态、读日志;要改东西只会先提出来,你在 MineDeck 里确认后才执行。只接受本机连接,要带令牌。
界面截图
音乐共享
把你电脑上正在放的音乐,放给服务器里的每个人听。不需要 AI。
- 声音经 Simple Voice Chat 传给服务器里的人,每个人可以在语音设置里单独调小或静音。
- Windows 11 上可以只录你选的那个音乐程序,不会录进游戏声音和语音。Windows 10 只能录整机的声音。
报错横幅与操作记录
服务器起不来时,控制台顶上直接告诉你原因,不用自己翻日志,也不需要 AI。
- 能认出 13 类常见原因,比如缺少前置模组、把客户端模组放进了服务器、装错加载器、端口被占、内存不够、没同意 EULA。
- 接了 AI 的话,可以点「让 AI 分析」。
还有问题?看帮助与常见问题 →去下载 →
截图拍摄于 v2.9.0-beta.1,不包含测试版新增的界面。






