# TMCL **Repository Path**: treeblnk2014/tmcl ## Basic Information - **Project Name**: TMCL - **Description**: Tree_minecraft. 一个m c启动器。 DeepSeek帮我写的。 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-01 - **Last Updated**: 2026-11-17 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 方块启动器 CubeLauncher 一个**零依赖**的 Minecraft: Java 版启动器。后端是纯 Node.js(不用 npm install),前端是原生 HTML/CSS/JS。打开浏览器就能用,做的事情和 HMCL / PCL 的核心功能类似: - **下载游戏**:从 Mojang 官方清单拉取任意正式版 / 快照,下载客户端 jar、依赖库、原生库、资源文件(自动回退 BMCLAPI 国内镜像) - **离线账号**:本地注册 / 登录,密码 scrypt 加盐存储,UUID 与原版离线模式一致;首次启动有引导,没账号点「启动游戏」会自动弹出创建窗口 - **扫描存档**:自动找到各平台默认的 `.minecraft/saves`(macOS 是 `~/Library/Application Support/minecraft`),解析 `level.dat`(自带 NBT 解析器),读出存档名、版本、模式、最后游玩时间、截图图标 - **直接进存档**:1.20+ 用 `--quickPlaySingleplayer` 一键进入;旧版本会自动降级为打开主菜单 - **下载模组**:接 Modrinth,按加载器 + 游戏版本筛选,一键下载到 `mods/`,支持启用 / 禁用 / 删除 - **下载资源包**:同样的 Modrinth 搜索,安装到 `resourcepacks/`;读取 `pack.mcmeta` 显示名称/格式/图标,并从 `options.txt` 识别是否已启用 - **两种联机方式**: - **陶瓦联机**:一键安装 [陶瓦联机 Terracotta](https://github.com/burningtnt/Terracotta),通过它的本地 HTTP API 创建 / 加入房间,显示邀请码、成员和直连地址 - **EasyTier**:一键安装 [EasyTier](https://easytier.cn),以**无 TUN 模式**启动(不需要管理员/驱动),创建或加入虚拟网络、查看节点和延迟,并自动为加入方配置端口转发,直达房主的局域网存档 - **Java 管理**:自动探测系统 Java、HMCL / 官方启动器自带的运行时,也能直接从 Mojang 官方清单下载 Java 17/21/25 - **签名自动更新**:从 Gitee 仓库读取 Ed25519 签名的 `update-manifest.json`,校验 SHA-256 后一键下载、备份、覆盖代码并自动重启;账号、设置、存档不受影响 - **版本管理**:点版本库里的「管理」,按版本查看/启动/删除存档、启停模组、管理资源包;可以给单个版本开「独立实例目录」,存档模组互不干扰 - **多 .minecraft**:顶栏点目录名随时切换本机不同的 `.minecraft` 文件夹,自动探测 + 手动输入 - **启动动画**:点启动后全屏播放方块动画,直到游戏进程真正拉起来 - **1.1 大更**:性能模式/诊断修复、多开与运行时面板、Fabric/Quilt/Forge/NeoForge 一键安装、光影下载、联机延迟测试 - **1.2 大更**:Modrinth 整合包一键安装、游戏内 HUD(Fabric 1.21.11)、万圣节糖果彩蛋、小资源包筛选、愚人节版本、macOS .app / Windows HTA 打包 - **版本大厅**:首页先选版本;模组/资源包/光影/存档默认落到当前版本目录 - **更衣室**:上传 PNG 皮肤、衣柜管理、应用为当前版本的本地资源包 - **Android 平板**:原生 WebView 客户端(`android-tablet/`)+ 平板 PWA 清单/图标;平板连电脑启动器,管理和远程启动 - **快速建服**:选版本一键下载官方服务端、写 `eula` / `server.properties`、复制存档开服;带控制台、玩家列表、白名单/OP/踢人/封禁后台 - **微软正版登录**:设备码登录 + Xbox/XSTS/Minecraft 认证链,token 存本机;需要自备 Azure 客户端 ID 并通过 Mojang 审核 ![首页](docs/screenshots/home.png) ## 快速开始 需要 **Node.js 18+**(不需要 npm install,没有任何第三方依赖)。 | 平台 | 启动方式 | | --- | --- | | macOS | 双击 `启动.command`(首次可能需要在「系统设置 → 隐私与安全性」里允许) | | Windows | 双击 `启动.bat` | | 命令行 | `npm start` 或 `node server/index.js` | 启动后浏览器会自动打开 。端口被占用时可以 `PORT=17900 npm start`。 电脑版官网(公开下载): > 第一次使用建议顺序:**设置 → 确认游戏目录 / Java → 版本库下载一个版本 → 创建离线账号 → 首页启动**。 > 没登录账号时点「启动游戏」会直接弹出「创建离线账号」,不用先跑去找账号页。 ## 功能截图 | 存档扫描 | 模组下载 | | --- | --- | | ![存档](docs/screenshots/saves.png) | ![模组](docs/screenshots/mods.png) | | 版本库 | 陶瓦联机 | | --- | --- | | ![版本](docs/screenshots/versions.png) | ![联机](docs/screenshots/lan.png) | | EasyTier(房主) | EasyTier(加入方) | | --- | --- | | ![EasyTier 房主](docs/screenshots/easytier.png) | ![EasyTier 加入方](docs/screenshots/easytier-guest.png) | ## 两种联机方式 启动器的「联机」页有两个标签页。 ### 陶瓦联机(开箱即用,推荐) 陶瓦内置公共节点,适合大多数家庭宽带: 1. 房主进存档 → Esc →「对局域网开放」 2. 在联机页点「创建房间」,把邀请码发给朋友 3. 朋友点「加入房间」,游戏多人列表里会自动出现服务器 ### EasyTier(免管理员,可自建共享节点) [EasyTier](https://easytier.cn) 是去中心化的 P2P 组网工具。本启动器用**无 TUN 模式**调用它,所以不需要装驱动,也不需要管理员权限: 1. 装好 EasyTier 后,房主填网络名 / 密码,点「创建网络」 2. 联机页会显示房主的虚拟 IP(默认 `10.144.144.1`)、公网 IP 和在线节点 3. 房主在游戏里「对局域网开放」,把端口填到「连接游戏」里 4. 加入方填同一个网络名 / 密码后启动;如果双方都在 NAT 后,要在「共享节点 / 对方地址」里填同一个共享节点或房主的公网地址 5. 加入方在「连接游戏」里填房主虚拟 IP + 游戏端口,点「添加端口转发」,然后在游戏里添加服务器 `127.0.0.1:25565` > EasyTier 官方没有长期稳定的公共共享节点(社区列表曾多次下线),所以启动器**不预置**共享节点。没有公网 IP、路由器又不支持 UPnP 时,可以: > - 让有公网的朋友直接给 `tcp://公网IP:11010`; > - 或者自建一个共享节点:在任意有公网的主机上不带参数运行 `easytier-core` 即可; > - 实在没有条件就用上面的陶瓦联机。 ## 启动器更新(Gitee) 启动器内置了从 Gitee 拉取更新的能力。它会读取当前项目的 git remote 作为**建议仓库**,但需要你在设置里确认后才会启用(避免误拉整个 workspace)。 ### 让更新源可用 1. 在 Gitee 新建一个仓库(本项目用的是 [treeblnk2014/tmcl](https://gitee.com/treeblnk2014/tmcl)),把 `mc-launcher` 目录作为仓库根目录推上去(`.data/` 已经在 `.gitignore` 里,不会被推) 2. 打开 **设置 → 启动器更新**,填 `owner/repo`(本机已填好 `treeblnk2014/tmcl`),点「保存并检查」 (如果检测到 git remote,输入框下面会直接提示这个地址) 3. 之后每次启动会自动检查;发现新版本时右上角会出现金色的「更新 x.y.z」按钮 ```bash cd mc-launcher git init git add . git commit -m "CubeLauncher 1.0.0" git remote add origin https://gitee.com/treeblnk2014/tmcl.git git push -u origin main ``` ### 更新是怎么判断的 启动器只接受**带签名的更新清单**,不再直接相信 Gitee API 的 release/tag/commit: | 项目 | 要求 | | --- | --- | | 清单 | 仓库根目录 `update-manifest.json`,包含版本、下载地址、SHA-256 和 Ed25519 签名 | | 版本 | 清单里的 `version` 必须大于本地 `package.json` 的 version | | 地址 | 只允许 `https://gitee.com///` 下的 archive / release 资产 / raw 文件 | | 完整性 | 下载后校验清单里的 SHA-256;不一致直接拒绝 | | 签名 | 公钥固定在 `server/update-verify.js`;签名不对、清单缺失都拒绝更新 | > 这样即使 Gitee 仓库或 API 被投毒,攻击者没有发布者的 Ed25519 私钥,也无法让启动器执行任意代码。 ### 发布签名更新 第一次发布时生成一对密钥(私钥只留在本机,权限 600): ```bash node tools/update-keygen.mjs # 私钥默认写到 ~/.cube-update-key.json # 把打印出来的 publicX 填进 server/update-verify.js 的 PUBLIC_KEY_X ``` 之后每次发版: ```bash # 1. 改 package.json 版本并提交、push # 2. 用 Gitee 的源码包或本地导出包计算 SHA-256,生成签名清单 node tools/sign-update.mjs --version 1.4.3 --ref main --commit \ --file ~/Downloads/tmcl-1.4.3.zip --notes "更新说明" # 3. 提交 update-manifest.json 并 push git add update-manifest.json git commit -m "release 1.4.3" git push ``` 清单里的 `downloadUrl` 默认指向 `https://gitee.com//repository/archive/.zip`。Gitee 的 archive 接口有风控时,可以把打包好的 ZIP 放进仓库的 `updates/` 目录,用 `--url https://gitee.com//raw//updates/` 指向 raw 文件;仍然只允许 `gitee.com` 域名、且必须签名。 ### 更新过程 1. 读取签名清单并校验 Ed25519 签名 2. 下载清单里的 `.zip`,先校验 SHA-256 3. 解压后自动查找包含 `package.json`(name=`cube-launcher`)、`server/`、`web/` 的目录(支持仓库根或 `mc-launcher/` 子目录) 4. 把当前的 `server/`、`web/`、`docs/`、`package.json` 等备份到系统数据目录的 `updates/backup-<时间>/` 5. 覆盖新文件(**绝不碰系统数据目录和 `.minecraft`**) 6. 提示「重启生效」→ 自动重启本地服务 → 页面自动刷新 更新失败的写入会自动回滚到备份。想手动回滚,把数据目录 `updates/backup-*` 里的内容拷回项目根目录即可。 > 注意:没有签名清单时启动器会明确拒绝自动更新,而不是降级为不校验。发布前请先跑一遍 `node tools/sign-update.mjs` 并在本地验证。 ## 版本管理、多目录与启动动画 - 版本库每行有「管理」:概览 / 存档 / 模组 / 资源包四个 tab - 默认用全局 `saves`、`mods`、`resourcepacks`;存档会按版本过滤(`level.dat` 里的版本名对得上才显示) - 勾选「独立实例目录」后,这个版本改用 `versions//instance` 当 gameDir,存档、模组、资源包完全隔离;不会自动搬走已有的全局数据 - 顶栏点 `minecraft` 那个按钮可以切换任意 `.minecraft` 根目录,切换后整个界面刷新 启动时有一个全屏方块动画,API 返回/报错后自动收起,避免点了没反应。 ## 1.1 新增:优化、诊断、多开与加载器 ### 性能模式 设置 → 性能与启动优化,三档: | 模式 | 内存 | 渲染距离 | 特点 | | --- | --- | --- | --- | | 流畅 | 2 GB | 6 | 关云/实体阴影,最低画质,适合低配 | | 均衡 | 4 GB | 10 | 默认推荐 | | 高画质 | 6 GB | 16 | 开云/阴影,Fabulous 画质 | 会同时写 `.minecraft/options.txt` 和启动器内存/JVM 参数;进游戏后仍可手动调。旁边有「清理缓存」,删旧日志、崩溃报告和残留 `.part` 下载文件。 ### 诊断与修复 版本详情 → 概览 → 诊断与修复: - 检查版本 json、客户端 jar、libraries、assets 资源、Java 版本、最近崩溃报告 - 「一键修复」会重新下载缺失文件(已存在的跳过) - 启动崩溃后会给一句排查建议(内存不足、GC 冲突、模组 Mixin、Java 版本、原生库等) ### 多开与运行时菜单 - 同一个启动器可以同时开多个 Minecraft 窗口,互不干扰 - 顶栏出现「运行中 N」按钮;点开或按 `Ctrl/Cmd + F` 打开运行时面板 - 面板显示每个窗口的版本、PID、运行时长、内存(RSS)、CPU,可看日志、结束单个/全部 - 这是**启动器侧**的运行面板;游戏内叠加层需要额外 mod,暂未内置 ### 一键装加载器 版本库 → 安装加载器:选 Minecraft 版本 + Fabric / Quilt / Forge / NeoForge + 加载器版本,启动器会下载官方 installer 并执行。Fabric/Quilt 会顺带下载对应原版;Forge/NeoForge 走官方 installer,网络慢时会久一点。 ### 光影 侧边栏「光影」页从 Modrinth 搜索并下载光影到 `shaderpacks/`。Fabric 需要 Iris,Forge 需要 Oculus,进游戏后在「视频设置 → 光影」选择。 ### 联机诊断 联机页底部可以填房主地址和端口测 TCP 延迟,并显示陶瓦/EasyTier/Java 版本。 ## 版本大厅与版本内操作 首页现在是版本大厅: - 列出所有可玩版本,点卡片选择;选中的版本会记住(`activeVersion`) - 选择时自动开启「独立实例目录」,避免模组/存档串版本 - 当前版本面板直接进入:存档、模组、资源包、光影、整合包、版本详情 - 模组页、资源包页、光影页的「安装到」默认就是当前版本 - 保存/启动/存档扫描也以当前版本为准 - 装整合包会自动切到新整合包版本 ## 更衣室 侧边栏「更衣室」: - 上传 64×64 / 64×32 / 128×128 PNG 皮肤 - 经典 / 纤细模型 - 衣柜里切换当前皮肤 - 「应用到版本」会把皮肤写进当前版本的 `resourcepacks/CubeLauncherSkin` 并自动启用 - 离线账号没有 Mojang 皮肤接口,所以这是**本地资源包**方案;正版账号请用官方启动器上传皮肤 ## 1.2 新增:整合包、HUD、彩蛋和打包 ### 整合包一键安装 侧边栏「整合包」搜索 Modrinth,选版本后会: 1. 下载 `.mrpack` 2. 按 `modrinth.index.json` 自动装 Fabric / Quilt / Forge / NeoForge 对应版本 3. 下载全部模组/资源/光影(带 sha1 校验) 4. 解压 `overrides` / `client-overrides` 5. 建独立实例目录,不污染其它版本 已实测安装 Fabulously Optimized 1.21.8(46 个文件)并成功完成。装完会直接跳到版本详情。 ### 游戏内 HUD 版本详情(Fabric 1.21.11)多了一个「游戏内 HUD」按钮。装好后进游戏: - 左上角显示 FPS / 内存 / 坐标 - `Ctrl/Cmd + F` 隐藏/显示 - 如果版本里没有 Fabric API,会顺手补上 HUD 是独立的小 mod(`server/assets/cubehud-1.21.11.jar`),只支持 Fabric 1.21.11;Forge/NeoForge 版本暂时用启动器侧的运行时面板。 ### 万圣节糖果彩蛋 侧边栏底部有糖果罐。点「抓一把糖」攒到 **10000 颗**,启动器会变成南瓜金主题;进度保存在浏览器 localStorage,重启也记得。 ### 小资源包 / 愚人节 / 打包 - 资源包页新增「小包」:自动挑 5MB 以下的热门资源包 - 4 月 1 日版本库顶部会出现「愚人节特供」,可直接装 `23w13a_or_b` / `26w14a` / `3D Shareware` - `打包.command` 会生成 `dist/CubeLauncher.app`(macOS)和 `dist/CubeLauncher.hta`(Windows),自动检测当前项目路径并调用原有的启动脚本;目标机器需要 Node.js 18+ ## Android 平板客户端 `android-tablet/` 是一个 Android Studio 工程:原生 Activity + WebView 承载完整启动器 UI。 - 平板和电脑同一 Wi-Fi,电脑先启动 CubeLauncher - App 里填 `http://电脑IP:17890`,例如 `http://192.168.1.10:17890` - 长按页面或顶部「切换」改地址;支持横竖屏 - 它不包含 JRE,不能在平板本地跑 Java 版;本地跑请用 PojavLauncher - 构建:Android Studio 打开 `android-tablet`,Sync 后 Run;详见 `android-tablet/README.md` Web 端也补了 `manifest.webmanifest` 和平板触屏样式,浏览器「添加到主屏幕」后接近全屏 App。 ## 快速建服与后台管理 侧边栏「服务器」页可以在本机开一个官方服务端: 1. 选一个已安装的原版版本(NeoForge/Fabric 修改版没有官方 server jar,会提示) 2. 填名字、端口、内存、MOTD,可选「用某个存档当世界」 3. 点「创建并配置」:会自动下载 `server.jar`、写 `eula=true` 和 `server.properties` 4. 启动后进入「后台管理」:实时控制台、在线玩家、`list`/`say` 等任意命令,以及白名单、OP、踢人、封禁快捷按钮 正版验证默认关闭(离线账号也能进);需要正版验证时勾上。服务器地址显示为局域网 IP + 端口。 ## 微软正版登录 「账号 → 微软正版」支持设备码登录,流程是: ``` 微软设备码 → Xbox Live → XSTS → Minecraft Services → 玩家档案 ``` token 只写在本机数据目录,`accounts.json` 权限 600,不经过第三方服务器。 > 和所有第三方启动器一样,这需要一个自己的 **Azure 应用客户端 ID**,并且要通过 Mojang 的 App ID 审核: > 1. portal.azure.com → 应用注册 → 仅个人 Microsoft 账户 > 2. 认证 → 允许公共客户端流:是 > 3. 复制客户端 ID 填到账号页 > 4. 到 提交审核 > > 审核通过前,登录会卡在 Minecraft 认证并提示「Mojang 还没有批准这个 Azure 应用」。这不是启动器能绕过的限制。 ## 数据存在哪 | 平台 | 数据目录 | | --- | --- | | macOS | `~/Library/Application Support/CubeLauncher` | | Windows | `%APPDATA%\CubeLauncher` | | Linux | `$XDG_DATA_HOME/cube-launcher`(默认 `~/.local/share/cube-launcher`) | 账号、设置、服务器、更新备份、日志都在这里;第一次升级时会把项目里的旧 `.data` 自动拷过去(旧目录保留)。可以用 `CUBE_DATA_DIR` 环境变量覆盖。 ## 它是怎么工作的 ``` 浏览器 UI (web/) │ fetch /api/* ▼ Node HTTP 服务 (server/index.js) ├── auth.js 本地账号:scrypt 加盐,离线 UUID ├── mojang.js Mojang 版本清单 / 版本 JSON / 资源索引 ├── installer.js 版本安装:jar + libraries + natives + assets ├── launcher.js 拼启动参数(JVM/游戏参数、规则、占位符)并 spawn ├── java.js 探测 Java、下载官方 JRE(java-runtime-*) ├── saves.js saves 扫描 + 图标 + 备份/删除 ├── nbt.js 手写 NBT 解析器(level.dat) ├── mods.js Modrinth 搜索 / 安装 / 启停 ├── resourcepacks.js 资源包搜索 / 安装 / 元数据读取 ├── terracotta.js 陶瓦联机:下载、进程、HTTP API 轮询 ├── easytier.js EasyTier:下载、无 TUN 组网、节点/端口转发 ├── zip.js 手写 ZIP 读取(解压 natives) └── net.js 下载(校验 sha1/size、并发池、镜像回退) ``` 游戏目录、`libraries/`、`assets/` 都是标准结构,和 HMCL / PCL / 官方启动器**共用同一份文件**,不会另起一套。 ### 关键实现细节 - **版本清单**:`piston-meta.mojang.com/mc/game/version_manifest_v2.json`,本地缓存 6 小时;版本 JSON 去掉 BOM 再解析。 - **规则系统**:完整实现 `rules`(os.name / os.arch / os.version / features),所以 macOS ARM、Windows、Linux 的库和原生库都能正确挑选。 - **启动参数**:同时支持新格式 `arguments.game/jvm` 和旧格式 `minecraftArguments`,处理 `default-user-jvm`、`-XstartOnFirstThread`(macOS 旧版 LWJGL2)、`quickPlaySingleplayer`。 - **下载可靠性**:先写 `.part`,按 `sha1 + size` 校验后改名;失败自动重试,官方源失败自动切 BMCLAPI。 - **存档大小**:新版本世界把地形放在 `dimensions/`,所以递归统计整个存档目录。 - **陶瓦联机**:优先复用已有实例(读 `~/terracotta/terracotta.lock` 的端口),否则用 `terracotta --hmcl ` 启动并轮询 `/state` 状态机。 - **EasyTier**:用 `--no-tun` 跑,所以不需要 root / 管理员 / 虚拟网卡;加入方通过 `easytier-cli port-forward` 把本地 25565 映射到房主虚拟 IP,游戏里连 `127.0.0.1:25565` 即可。启动器重启后还能通过持久化的 RPC 端口接管之前启动的实例。 ## 数据与隐私 - 所有数据都在本机:账号 `accounts.json`、配置 `config.json`、日志 `logs/latest.log`,位于系统应用数据目录(见「数据存在哪」)。 - 服务只监听 `127.0.0.1`,不对外网开放,也没有任何遥测。 - 联网只发生在:Mojang(版本/JRE/资源)、Modrinth(模组)、陶瓦联机 Releases(下载联机组件)。 - 离线账号只能进离线模式服务器;要进正版服务器、显示皮肤,用「账号 → 微软正版」登录(需要自备 Azure 客户端 ID 并通过 Mojang 审核)。 ## 设置项 | 设置 | 说明 | | --- | --- | | 游戏目录 | 留空 = 按平台自动探测;也可以手动指定任意 `.minecraft` | | Java 路径 | 留空 = 按版本 `javaVersion.majorVersion` 自动挑最合适的 | | 最大内存 | 512–32768 MB,默认 4096 | | 额外 JVM 参数 | 比如 `-XX:+UseG1GC`,会插到 `-Xmx` 之后 | | 陶瓦下载源 | Gitee 镜像(国内快)/ GitHub | | 附加公共节点 | 传给陶瓦的 `public_nodes`,一般不用填 | | Gitee 更新仓库 | `owner/repo`;检测到 git remote 会给出建议,需要点保存才会启用 | | 自动检查更新 | 关闭后不主动请求 Gitee,仍可在设置里手动检查 | ## HTTP API 速查 | 方法 | 路径 | 作用 | | --- | --- | --- | | GET | `/api/bootstrap` | 启动所需全部状态(目录、账号、Java、联机、统计) | | POST | `/api/settings` | 修改设置 | | POST | `/api/auth/register` / `login` / `logout` | 本地账号 | | GET | `/api/versions?type=release` | Mojang 版本列表(合并本机安装状态) | | GET | `/api/versions/installed` | 已安装版本 | | POST | `/api/versions/:id/install` | 安装版本(`{assets:true}`),返回 job | | GET | `/api/versions/:id/command` | 预览启动命令(调试用,不启动) | | GET | `/api/jobs/:id` | 下载/安装进度 | | GET | `/api/saves` | 扫描存档(含图标 base64) | | POST | `/api/saves/backup` / `delete` / `open` | 存档操作 | | POST | `/api/launch` | 启动游戏(可带 `saveFolder` 直接进存档) | | GET | `/api/mods/search` / `POST /api/mods/install` | Modrinth 搜索与安装 | | GET/POST | `/api/resourcepacks/search`、`install`、`installed`、`open` | 资源包搜索 / 安装 / 列表 | | GET | `/api/versions/:id/detail` | 版本详情(存档 / 模组 / 资源包 / 实例状态) | | POST | `/api/versions/:id/instance` | 开关独立实例目录 | | GET/POST | `/api/servers`、`/api/servers/:id/start`、`stop`、`command` | 快速建服 / 后台管理 | | POST | `/api/auth/microsoft/start`、`poll`、`cancel` | 微软正版设备码登录 | | GET/POST | `/api/loaders/versions`、`install` | 加载器版本列表 / 安装 | | GET/POST | `/api/perf/presets`、`apply` | 性能模式 | | POST | `/api/maintenance/clean` | 清理缓存 | | GET/POST | `/api/versions/:id/diagnose`、`repair` | 版本诊断 / 修复 | | GET/POST | `/api/shaders/search`、`install`、`installed` | 光影 | | GET | `/api/launch/stats/:id` | 运行时内存/CPU | | GET | `/api/net/ping` | TCP 延迟 | | GET/POST | `/api/modpacks/search`、`versions`、`install`、`installed` | 整合包 | | POST | `/api/versions/:id/hud` | 安装游戏内 HUD | | GET | `/api/resourcepacks/small` | 5MB 以下资源包 | | GET/POST | `/api/lan`、`/api/lan/install`、`start`、`host`、`join`、`reset`、`stop` | 陶瓦联机 | | GET/POST | `/api/easytier`、`install`、`start`、`stop`、`forward`、`forward/remove` | EasyTier 联机 | | GET/POST | `/api/update/check`、`/api/update/apply`、`/api/update/restart` | 从 Gitee 检查 / 应用更新并重启 | | POST | `/api/java/install` | 下载 Mojang Java 运行时(`java-runtime-delta/epsilon` 等) | 任务型接口统一返回 `{job}`,轮询 `/api/jobs/:id` 拿 `{status, percent, done, total, bytes, current}`。 ## 排错 | 现象 | 处理 | | --- | --- | | 「这个版本需要 Java X,当前只有 Java Y」 | 设置 → 下载对应 Java,或手动指定路径 | | 启动后立刻退出、日志里 `UnsupportedClassVersionError` | Java 版本太旧,同上 | | 没有声音 / 文字是方块 | 安装时没勾「下载资源文件」,重新下载一次该版本 | | 下载很慢 / 卡住 | 启动器会自动回退 BMCLAPI;仍不行就检查代理 | | 陶瓦「无法连接房主」 | 房主必须**先进入存档并「对局域网开放」**,再点创建房间 | | 端口 17890 被占用 | `PORT=17900 npm start` | | macOS 双击 `启动.command` 没反应 | `chmod +x 启动.command`,或在终端里执行 | ## 已知限制 - 只支持**原版版本安装**;Fabric / Forge / NeoForge 加载器需要先用别的安装器装好(本启动器能识别并启动它们)。 - 微软正版登录、皮肤、服务器列表管理、整合包导入还没做。 - 1.6 及更早的版本需要对应旧版 Java(8),启动器不会自动帮你装 Java 8。 - 陶瓦联机的房间功能依赖对方也使用支持陶瓦的联机方式;公共节点偶发拥堵属于正常现象。 - EasyTier 本身不提供公共中继:双方都在 NAT 后且没有共享节点时,虚拟网络能建立但互相看不到,需要按上面的说明补一个共享节点或公网地址。 - 自动更新需要你自己有一个可访问的 Gitee 仓库并把代码推上去;Gitee 匿名 API 有调用频率限制,检查结果会缓存 30 分钟。 - 微软正版登录必须使用**你自己注册的 Azure 客户端 ID**,并等待 Mojang 审核;启动器不内置任何人的客户端 ID。 - 快速建服只支持带官方 `downloads.server` 的版本(原版/部分整合版),NeoForge/Fabric 修改版需要先用对应安装器生成服务端。 - 整合包安装依赖 Modrinth CDN 和外链下载;被墙/超时会显示任务日志。 - HTA/.app 只是启动壳,不内置 Node 运行时;目标机器需要先装 Node.js 18+。 - 运行时菜单是启动器侧面板;游戏内 HUD 由 `cubehud-1.21.11.jar` 提供,目前只支持 Fabric 1.21.11。 - Forge/NeoForge 安装器需要访问对应 maven(已加 BMCLAPI 镜像),网络不通时会失败并显示安装器日志。 ## 致谢与许可 - 版本 / 资源 / Java 运行时来自 [Mojang](https://www.minecraft.net),请遵守 Minecraft EULA,仅用于你拥有的游戏副本。 - 模组数据来自 [Modrinth](https://modrinth.com)。 - 联机能力来自 [陶瓦联机 Terracotta](https://github.com/burningtnt/Terracotta) © burningtnt,AGPL-3.0。本启动器**未修改**其二进制,仅通过其本地 HTTP API 交互(符合其 AGPL 例外条款),并在界面中保留了版权标识。 - [EasyTier](https://easytier.cn) © EasyTier contributors,Apache-2.0。本启动器只调用其 `easytier-core` / `easytier-cli`,未修改其程序。 - 本项目代码以 MIT 许可证发布,见 [LICENSE](LICENSE)。 ## 内测站(Cloudflare Pages) `beta-site/` 是带内测码 + 队列验证的 Cloudflare Pages 项目: - 内测码由 `BETA_TOKENS` 环境变量提供(逗号分隔,首个默认 `133234`) - 输入内测码后,从该号开始按顺序点队列(默认 4 位,`BETA_QUEUE_STEPS` 可调) - 队列和会话都是 HMAC 签名 Cookie,会话 7 天 - 必须有 `BETA_SECRET`(至少 32 位随机串),否则返回 503 - 下载已签名 APK;PojavLauncher 只走官方 GitHub(154MB 超过 Pages 单文件 25MB 限制) 本地下载入口(8088)已关闭,不再从本机分发 154MB 的 Pojav APK 或打包 ZIP。部署见 `beta-site/README.md`。