使用与排错

快速开始

# 服务端：官网（任何装了 Node 的机器都行）
node server/server.js
# → 本机 http://127.0.0.1:8080 / 局域网 http://<IP>:8080

# 客户端：启动器命令行（不需要开界面）
node client/core/cli.js doctor
node client/core/cli.js install 1.20.1
node client/core/cli.js launch 1.20.1 --user Steve

# 打包客户端并写入默认官网地址
node build/make-release.js all --server http://10.0.0.2:8080

目录结构

minecraft-launcher/
├─ server/              官网（部署单元，可整体搬到 VPS）
│  ├─ server.js         零依赖 HTTP 服务
│  ├─ config.json       端口 / 监听地址 / 对外域名
│  ├─ public/           页面
│  ├─ downloads/        安装包（.exe）
│  ├─ data/             release.json / versions.json
│  └─ logs/             访问日志
├─ client/              启动器（Electron）
│  ├─ core/             下载 / 校验 / Java / 远端清单
│  └─ ui/               界面
├─ build/               打包脚本
└─ data/                开发机上的游戏数据（1.6 GB）

客户端与服务端的分工

	服务端（官网）	客户端（启动器）
装在哪	一台常开的机器 / VPS	每个玩家的电脑
职责	发安装包、发版本元数据、告诉客户端有没有新版	下载游戏文件、装 Java、启动游戏
依赖	Node 18+	不需要 Node / Java（自带运行时）
断网时	—	照常启动游戏，退回内置元数据

设置项

项	说明
玩家名	离线账号名，1–16 字符。UUID 由 MD5("OfflinePlayer:名字") 生成
内存上限	-Xmx，默认 2048 MB；8 GB 机器建议不超过 4096
窗口尺寸	写入 --width / --height，仅对新开的游戏窗口生效
额外 JVM 参数	原样拼进命令行，例如 -XX:+UseG1GC

常见问题