这是 AuroraLauncher 的 C++ 重写工程,当前是 Windows-first 的启动核心,不是 HMCL/Java 版的完整功能等价实现。CLI 覆盖核心与模组/整合包功能,GUI 提供莫奈色块主页(左栏大版本号与启动按钮、主卡最近游玩、通栏年度日历)、全页式实例选择、实例设置(概览设置/日志,含实例/存档/模组/日志文件夹快捷方式)、下载页(顶栏第四页)与启动器设置(启动/外观/下载/关于四组),两者调用同一套核心模块。下载页分游戏版本、整合包、资源包、光影四类:游戏版本来自 Mojang 官方清单,其余来自 Modrinth 搜索与版本列表;资源包/光影写入所选实例的 resourcepacks/shaderpacks,整合包自动创建实例并安装加载器与游戏文件。搜索与安装在后台线程执行,界面右下角浮层显示阶段与单文件字节进度,完成后刷新实例列表;文件按 SHA-1 校验,临时目录安装整合包后自动清理。实例选择与实例设置沿用 PCL2 CE 的信息结构;主页按用户设计稿重排(左栏版本 + 主卡 + 底卡),视觉为大色块与莫奈取色,色系收在蓝绿家族(雾绿、青灰、粉蓝与深青,玫红只留给运行/停止与错误),默认不使用描边或投影;页面切换用 View Transitions 让左栏、主卡与标题栏在启动/实例/下载/设置/实例设置之间连续形变,并按顶栏顺序给旧页与新区块加方向位移;实例设置与启动器设置的内部页签、下载页的分类切换也各有方向性动画,关闭页面动画后全部降为瞬时。界面提供跟随系统/浅色/深色三种主题与「色块 / 柔和边界」两种卡片风格(保存在本机),环境背景与主卡颜色随当前实例的加载器取色,色板取自各加载器图标(原版草绿/泥土、Fabric 米色、Quilt 紫、Forge 炭灰、NeoForge 橙)。外观里可上传本机图片作背景(只存 localStorage,不上传):缩到长边 1600 的 JPEG,用 48×48 直方图取 4 个主色,窗口氛围与卡片随之着色;背景模糊 0–30px、卡片磨砂 0–40px 各有一档滑杆,卡片磨砂为 0 时回到取色纯色。启动器设置还提供窗口尺寸、附加 JVM/游戏参数、启动后最小化、下载重试与额外镜像、页面动画开关,以及游戏目录/配置目录的直接打开。窗口为无边框自绘,保留 4px 缩放入口并去掉了 Win11 的白色 DWM 边框。
原 Java 工程和未提交的 JFoenix 移除/UI 迁移工作已完整归档,未直接删除:
- 归档目录:
D:\AuroraLauncher-archive\2026-10-26\ - 完整快照:
AuroraLauncher-full-2026-10-26.zip- SHA-256:
C3FE3143C0076117BBF98A5D7259342AA1807E46FFAB7C70875040C55579129E
- SHA-256:
- Git 历史:
HMCL-main.git.bundle- SHA-256:
39783AF633172DF5DDF4453CF7BF0778D3EDBAF707D3B3ACD260DA9FF3362FC9
- SHA-256:
- 移出工作区的源码:
D:\AuroraLauncher-archive\2026-10-26\HMCL-main
归档校验结果:ZIP 条目数与源文件数一致(40,415),所有条目的未压缩大小一致,关键文件已做 SHA-256 对比。
已执行:
- Debug 和 Release 构建通过,
ctest15 个测试目标全部通过(核心、HTTP、加载器、版本清单、认证、Java 安装、Forge/NeoForge、Modrinth、模组管理、CurseForge、资源包、整合包、PCL、活动记录、下载目录)。 - 现场联网验证:Mojang 版本清单
version latest、Fabric loader 列表(经 BMCLAPI 镜像)、Forge promotions 和 NeoForge 版本列表(forge list forge|neoforge 1.21.1,经 BMCLAPI 元数据镜像,约 0.6 秒)。 - Modrinth 现场验证:
mod search sodium经 MCIM API 镜像返回结果;mod install sodium下载并校验 SHA-1;mod install sodium-extra自动解析并识别已安装的 Sodium 依赖。 - 模组管理现场验证:
mod list、mod disable/enable往返成功;mod update对旧版 Sodium 报告 0.8.13 可用,--apply下载、校验并替换旧 JAR,再查为 up to date。 - CurseForge:API 请求、
x-api-key请求头和 403 映射已实测;MurmurHash2 fingerprint(去 0x09/0x0A/0x0D/0x20,seed 1)和/v1/fingerprints/432批量匹配已用固定向量测试,curseforge update的匹配/替换流程已用注入响应测试。真实搜索/安装需要用户自己的 CurseForge API key,尚未用有效 key 现场跑通。 - 资源包现场验证:
resourcepack list/enable/disable在临时目录往返成功,options.txt的其他选项与 CRLF 行尾保持不变;pack.mcmeta(含supported_formats/min_format/max_format)、pack.png、1.13 前后 options 格式和incompatibleResourcePacks同步已有测试。 - 整合包现场验证:自建
.mrpack(真实 Sodium 文件 URL + SHA-1)安装成功,客户端 overrides 覆盖普通 overrides,重复安装刷新未修改文件;另用空包实测 Fabric 加载器自动安装并生成versions/<id>/<id>.json(--no-game,未下载完整游戏)。升级保留用户修改、保留用户删除、删除新包移除的 overrides、失败时从备份恢复,以及 CurseForge 删除新 manifest 中不存在的旧文件,均已用测试验证。 - PCL 实例兼容:用合成
PCL/Setup.ini和PCL/config.v1.yml实测隔离目录、内存档位(tick 25 → 8192 MB、tick 20 → 5632 MB、未写档位 → 3072 MB)、VersionAdvanceJvm/Game参数(含${library_directory}替换)和VersionArgumentJavaSelect;Java 偏好同时支持旧版裸路径与 PCL CE 的{"kind":"exist",...}JSON,路径失效时回退到自动检测。launch --dry-run --json的工作目录、-Xmx、额外参数与 java 均按 PCL 设置生成;解析器和run_dir行为有独立测试。 - 镜像优先/官方回退:用
install 1.0 --no-assets实测客户端和库经 BMCLAPI 下载,并在镜像慢节点出现后回退官方;客户端和 7 个适用库的 SHA-1 全部匹配。 - 真实游戏启动(离线账号):本机
D:\PCL\.minecraft复制出的独立冒烟目录(1.5 GB,不写回真实游戏目录)实跑两次。① 原版 1.19.2:install校验 3390 个资源后launch起来,日志出现Backend library: LWJGL version 3.3.1 build 7、逐张 atlas 拼接、OpenAL initialized on device ... 扬声器 (Realtek(R) Audio)、Sound engine started,无 crash-report、无hs_err,退出为干净的Stopping!。② Fabric 1.19.4(真实 PCL CE 实例,带 BOM 的config.v1.yml、VersionArgumentIndieV2: true):工作目录切到versions/<id>,日志Loading Minecraft 1.19.4 with Fabric Loader 0.18.4、Loading 9 mods、MixinService=Knot/Fabric Env=CLIENT;再用mod install sodium装进实例自己的mods,重启后模组列表出现sodium 0.4.10+build.24及其 fabric-* 传递依赖并再次到达Sound engine started(进程 RSS 1.13 GB,确认存活后由我们主动结束)。离线启动下Failed to verify authentication Status: 401属预期(伪造 token 无法通过 authlib 校验,与其他启动器离线模式一致)。 --log FILE真机复核:同一次 1.19.2 启动下文件收到 50 条游戏 log4j 事件和 JVM 自身的 stderr(例如NOTE: Picked up JDK_JAVA_OPTIONS: ...,这行只在子进程输出里可见),头部只保留时间戳与 java 可执行路径;同一文件里--accessToken与-cp命中均为 0 次。第一版曾把整条命令行写进日志,联网登录时会泄露 access token,已修正并加了回归测试。- 桌面 GUI 真机验证:
aurora_gui在 1180×700 居中窗口下真实点击走完「主页 → 实例选择 → 实例设置(概览/设置/日志)→ 返回」;最小尺寸钳制为 980×620(请求 800×500 无效),最大化到工作区 1920×1032(任务栏保留)后可还原。窗口四边逐像素抽样:左/右/下为 #ECE8E1 的 4px 底边、上为 #EAE9E3,页面内容从第 5 像素开始,没有纯白 DWM 边框;圆角由DWMWA_WINDOW_CORNER_PREFERENCE = ROUND提供。主页在 1180×700 与 1920×1032 下都铺满高度(最大化时上排 634px、日历 294px),980×620 最小窗口走紧凑断点后整页不滚动;实例页与设置页在两种尺寸下也完整显示。页面切换由 View Transitions 完成:左栏(rail)与主卡(panel)在首页/实例页/设置页之间以同名快照连续形变,日历卡独立淡出,getAnimations()可查到::view-transition-group(rail|panel)与 old/new 伪元素动画;设置内页签为 220ms 的方向性位移淡入;顶栏页转场现为 group 360ms、旧块 170ms、新块 280ms(延迟 40ms),旧块向导航方向外侧移 14px、新块从另一侧 22px 进入。运行态(玫红「停止游戏」、行尾运行点、详情页运行状态)通过消息状态复现核对;实例启动/停止的真实链路在上一轮已实测,本轮只调整设置页与外观控制。实例设置概览的「存档文件夹」真实拉起资源管理器到versions/<id>/saves(ShellExecuteW,验证后关闭该窗口)。实例图标(草方块)与玩家头像在运行时从用户自己的客户端 JAR 读取纹理、用 canvas 合成,仓库不附带 Mojang 素材;默认背景是纯 CSS 渐变,不依赖图片,背景图只由用户在本机上传。热力图按卡片宽度自适应格子尺寸(980×620 最小窗口到 1920 最大化均对齐),悬浮提示另用 148 天临时活动数据核对后还原。主题可在启动器内切换:浅色/深色的窗口 4px 边分别为 #ECE8E1 / #1B211F,切换时经theme消息同步原生边框与 WebView 底色(逐像素抽样确认)。「色块 / 柔和边界」两种卡片风格分别呈现大色块与同色系软边界;未设置背景时,切换实例会把环境背景与主卡过渡到该加载器图标的色板(浅色主卡:原版 #bccdb8、Fabric #cec7b5、Quilt #cebeee、Forge #c4c4c4、NeoForge #e7bda5;深色:原版 #2d392a、Fabric #3a3527、Quilt #3b2d50、Forge #353535、NeoForge #4a2e1d),色相取自 HMCL 归档的 grass/fabric/quilt/forge/neoforge 图标,按 OKLCH 统一亮度与彩度。实例设置新增 9 项实例信息(模组、材质包、存档、启动次数、上次游玩、累计时长等)及实例目录行,外观卡迁到启动器设置;存档数由 C++ 扫描saves/子目录,启动次数来自会话计数。页面切换曲线为 cubic-bezier(0.4, 0, 0.2, 1),取消整页缩放,getAnimations()核对到 360/280/170ms 的 rail/panel 伪元素动画,并按顶栏顺序加上方向位移。启动器设置升为顶栏页(新增下载页后为第四页),含启动/外观/下载/关于四组;启动组接管用户名/内存/Java,并新增窗口尺寸、附加 JVM/游戏参数、启动后最小化,下载组新增重试次数与额外镜像,关于组显示版本、游戏目录与配置目录。设置保存实测:临时写入窗口 900×500、JVM-XX:+UseG1GC、游戏参数--fullscreen、重试 7、镜像https://example.invalid/mirror,config.json对应字段全部落盘;再恢复为 854×480、空参数、重试 3、空镜像并回读一致。页面动画开关实测关闭后data-motion=off且过渡时长降到 1e-6s,恢复为开启。背景功能用本机 3840×2400、1.6MB 的img0.jpg走真实<input type=file>change 链路载入:存为 1600×1000、JPEG 0.82 后 localStorage 中 145KB,48×48 取色得#99bad3 #0567fb #0329a7 #36a8ff;背景模糊设为 8px 时body::before实测filter: blur(8px)、inset: -16px,卡片磨砂设为 24px 时backdrop-filter: blur(24px),设为 0 时data-blur=off且卡片回到实色取色;浅色/深色、色块/柔和组合均检查;刷新后背景、取色、两个模糊滑杆、动画与主题/风格一起恢复;点「清除」后四个存储键删除、data-bg回到 off、卡片恢复原色板。 - 下载页现场验证(临时游戏目录,不写真实实例):游戏版本清单经 Mojang 官方源拉回 921 个版本;Modrinth 搜索返回 40 个光影/资源包结果,图标从 CDN 加载;实际安装 Complementary Reimagined r5.2.2 到
1.19.2的shaderpacks、Fresh Animations v1.8 到resourcepacks,均通过 SHA-1;installGame完整安装 Minecraft 1.0 并出现在实例列表(加载器识别为原版)。后台任务通过PostMessage回到 UI 线程,浮层显示阶段/文件名/字节进度,完成时刷新实例并 toast;临时.mrpack目录在任务结束时删除。期间修掉两个真问题:WindowsNO_PROXY里的裸 IPv6::1会让WinHttpOpen报 error 87(现在过滤掉不带方括号的 IPv6 与host:port项,并在代理初始化失败时退回无 bypass/直连);旧版原版 1.0 使用launchwrapper启动被误判为 Forge(现在只有同时存在net.minecraftforge库时才判 Forge)。 - 转场复测:顶栏 启动→实例→下载→设置 会启动
rail/panel/chrome/root同名快照;data-nav=next时旧块左移 14px、新块从右 22px 进入,prev反向,--nav-dir在伪元素上继承为 ±1;动画结束后data-nav清除。实例设置子页与设置页之间、设置/下载内部页签与分类也走同向位移;关闭页面动画后不启动 View Transition。 - 截图与页面自检走 WebView2 远程调试(CDP):
Page.captureScreenshot取 WebView 真实像素,DOM/计算样式核对页签、星期标签与热力图格子坐标,避免窗口被遮挡时截到其他程序。 - 用本地临时 HTTP 服务验证过客户端 JAR、库、资源索引、native ZIP 下载、SHA-1 校验和
.dll解压;中文路径/用户名也已通过 CLI 验证。
尚未现场验证:
- Microsoft 登录全链路(需要项目自己的 Azure 应用 client ID 和真实账号)。
- Quilt 元数据 API(本机到
meta.quiltmc.org超时;Fabric 已通过镜像实测)。 - Forge/NeoForge 安装器完整执行(代码和解析已测试,安装器会下载大量第三方文件)。
- 完整 Adoptium JDK 下载(本机网络速度不足以在合理时间内验证)。
| 能力 | 状态 | 说明 |
|---|---|---|
| 版本 JSON 读取 | 已实现 | 支持 versions/<id>/<id>.json 和同目录其他 JSON 文件名 |
inheritsFrom 继承 |
已实现 | 递归合并主类、资源索引、库、JVM/游戏参数、Java 版本 |
| 版本清单与版本下载 | 已实现 | version latest / version fetch,Mojang version_manifest_v2.json |
| 规则判断 | 已实现 | OS、架构、版本正则和 features 规则 |
| Maven 坐标 | 已实现 | group/artifact/version/classifier/extension |
| Java 检测 | 已实现 | 注册表、JAVA_HOME、PATH、常见 JDK 目录、托管运行时 |
| 托管 Java 安装 | 已实现 | Adoptium API、SHA-256、ZIP 路径穿越防护、原子替换 |
| 离线账号 UUID | 已实现 | OfflinePlayer:<name> 的 MD5 UUID |
| Microsoft 登录 | 已实现(需自有 client ID) | 设备码 → Microsoft token → Xbox Live → XSTS → Minecraft;DPAPI 保存 |
| 文件下载 | 已实现 | WinHTTP、镜像优先/官方回退、重试退避、断点续传、SHA-1、系统代理 |
| 客户端/库/资源下载 | 已实现 | 资源对象、libraries、natives、版本日志配置、旧版 virtual/map_to_resources |
| 原生库解压 | 已实现(Windows) | miniz 解压 .dll 到版本 natives 目录 |
| 启动命令生成 | 已实现 | 类路径、变量替换、JVM/游戏参数、离线/正版参数 |
| Fabric / Quilt | 已实现 | 元数据查询、profile JSON 安装到 versions/ |
| Forge / NeoForge | 已实现(installer bridge) | 元数据镜像优先(BMCL schema 适配)/官方回退、安装器下载、SHA-1 sidecar、headless 执行、产物定位 |
| 启动进程 | 已实现(真启动验证) | CreateProcessW,可等待或分离;原版 1.19.2 与 Fabric 1.19.4 实例实跑到主界面 |
| 配置文件 | 已实现(基础) | 游戏目录、Java、内存、窗口、用户名、client ID、下载、额外参数 |
| 自签开发签名 | 已实现 | 脚本 + CMake Windows 资源/清单;公开发布仍需可信证书 |
| Modrinth 模组 | 已实现 | 搜索、版本选择、必需依赖递归安装、SHA-1;MCIM API 镜像 |
| 本地模组管理 | 已实现 | mod list、mod enable/disable、更新检查与 mod update --apply |
| CurseForge 模组 | 已实现(需用户自有 API key) | 搜索、文件选择、必需依赖、SHA-1;无下载授权的文件直接拒绝 |
| 资源包管理 | 已实现 | resourcepack list/enable/disable,读写 options.txt 的 resourcePacks;pack.mcmeta 兼容性、pack.png 检测、新旧 options 格式 |
| 整合包 | 已实现 | Modrinth .mrpack / CurseForge manifest、SHA-1、overrides、自动安装加载器、安装原版文件、生成可启动实例、升级/备份 |
| PCL 实例兼容 | 已实现 | 读取 PCL/Setup.ini 与 PCL/config.v1.yml:版本隔离(含 PCL 自动隔离规则)、内存档位、JVM/游戏参数、指定 Java;launch 自动采用 |
| GUI | 主页/实例/下载/设置已实现 | aurora_gui:WebView2 宿主 + 无边框窗口 + 莫奈色块主页(左栏大版本号与启动/停止按钮、最近游玩、年度热力图)+ 全页实例选择 + 全页实例设置(概览/设置/日志,文件夹快捷方式)+ 下载页(Mojang 游戏版本、Modrinth 整合包/资源包/光影;搜索、版本选择、目标实例、后台进度、SHA-1)+ 启动器设置(启动/外观/下载/关于,窗口与 JVM/游戏参数、下载重试/镜像、背景上传/取色、背景与卡片模糊滑杆、目录打开);CurseForge 浏览仍走 CLI |
| 主题包/UI/服务端模块 | 未开始 | 未迁移 |
环境:Windows 10/11、Visual Studio 2022(MSVC)、CMake 3.28+。
cmake -S . -B build -G "Visual Studio 17 2022" -A x64
cmake --build build --config Debug --parallel
ctest --test-dir build -C Debug --output-on-failure生成的可执行文件:
build\Debug\aurora.exe
Release 构建:
cmake -S . -B build -G "Visual Studio 17 2022" -A x64
cmake --build build --config Release --parallel
ctest --test-dir build -C Release --output-on-failure桌面界面(可选,默认不构建)需要 WebView2 SDK 与运行时的支持:
# 1) 取 SDK(无需 Qt、无需前端构建链;静态 loader,发布时不额外带 DLL)
python -m pip install --user aqtinstall # 或任意能解包的 NuGet 客户端
# 解包 Microsoft.Web.WebView2 到某个目录,例如 D:\tools\webview2
# 2) 配置并构建
cmake -S . -B build -DAURORA_BUILD_GUI=ON -DAURORA_WEBVIEW2_ROOT=D:/tools/webview2
cmake --build build --config Release --target aurora_gui
# 3) 运行(界面直接读源码目录的 ui/index.html,改样式只需刷新窗口)
.\build\Release\aurora_gui.exe --game-dir "D:\path\to\.minecraft"Windows 11 自带 WebView2 运行时;旧版 Windows 10 缺少时程序会弹窗提示安装地址,不会静默失败。
# 查看/安装 Java(托管运行时放在 <game-dir>\runtime\java)
.\build\Debug\aurora.exe java list
.\build\Debug\aurora.exe java install 21 --game-dir "D:\path\to\.minecraft"
# 拉取并查看版本
.\build\Debug\aurora.exe version latest
.\build\Debug\aurora.exe version fetch 1.21.1 --game-dir "D:\path\to\.minecraft"
.\build\Debug\aurora.exe version show 1.21.1 --game-dir "D:\path\to\.minecraft"
# 下载客户端、依赖库、资源并解压 natives
.\build\Debug\aurora.exe install 1.21.1 --game-dir "D:\path\to\.minecraft"
# Fabric / Quilt
.\build\Debug\aurora.exe loader list fabric 1.21.1
.\build\Debug\aurora.exe loader install fabric 1.21.1 --game-dir "D:\path\to\.minecraft"
# Forge / NeoForge
.\build\Debug\aurora.exe forge list forge 1.21.1
.\build\Debug\aurora.exe forge install forge 1.21.1 --game-dir "D:\path\to\.minecraft"
# Modrinth 模组(Fabric 示例)
.\build\Debug\aurora.exe mod search sodium --loader fabric --game-version 1.21.1
.\build\Debug\aurora.exe mod install sodium --game-dir "D:\path\to\.minecraft" --loader fabric --game-version 1.21.1
.\build\Debug\aurora.exe mod list --game-dir "D:\path\to\.minecraft"
.\build\Debug\aurora.exe mod disable sodium-fabric-0.8.13+mc1.21.1.jar --game-dir "D:\path\to\.minecraft"
.\build\Debug\aurora.exe mod update --game-dir "D:\path\to\.minecraft" --loader fabric --game-version 1.21.1 --apply
# CurseForge(使用你自己的 API key)
.\build\Debug\aurora.exe config set curseForgeApiKey <your-curseforge-key>
.\build\Debug\aurora.exe curseforge search jei --loader fabric --game-version 1.21.1
.\build\Debug\aurora.exe curseforge install 238222 --game-dir "D:\path\to\.minecraft" --loader fabric --game-version 1.21.1
# 资源包 / 整合包
.\build\Debug\aurora.exe resourcepack list --game-dir "D:\path\to\.minecraft" --instance "MyPack"
.\build\Debug\aurora.exe resourcepack enable "MyPack.zip" --game-dir "D:\path\to\.minecraft" --instance "MyPack" --game-version 1.21.1
.\build\Debug\aurora.exe modpack info "D:\packs\MyPack.mrpack"
# 安装为可启动实例:自动安装加载器、下载游戏文件、生成 versions/<id>/<id>.json
.\build\Debug\aurora.exe modpack install "D:\packs\MyPack.mrpack" --game-dir "D:\instances\MyPack" --java-home "D:\Java\jdk-21"
.\build\Debug\aurora.exe launch "MyPack" --game-dir "D:\instances\MyPack"
# 模组、资源包和 options 都位于 D:\instances\MyPack\versions\MyPack 下
.\build\Debug\aurora.exe mod list --game-dir "D:\instances\MyPack" --instance "MyPack"
# 整合包升级:重复 install 同一实例即可,升级前备份到 <game-dir>\backup
.\build\Debug\aurora.exe modpack install "D:\packs\MyPack-2.0.mrpack" --game-dir "D:\instances\MyPack"
# CurseForge:按本地 JAR 指纹识别并检查更新
.\build\Debug\aurora.exe curseforge update --game-dir "D:\instances\MyPack" --instance "MyPack" --loader fabric --game-version 1.21.1 --apply
# PCL 实例:自动读取 versions/<id>/PCL/Setup.ini 或 PCL/config.v1.yml 的隔离、内存、参数和 Java
.\build\Debug\aurora.exe launch "1.21.1-Forge" --game-dir "D:\path\to\.minecraft" --dry-run --json
# Microsoft 登录(先配置自己的 Azure client ID)
.\build\Debug\aurora.exe config set microsoftClientId <your-client-id>
.\build\Debug\aurora.exe auth login
.\build\Debug\aurora.exe auth status
# 离线启动 / 只生成命令
.\build\Debug\aurora.exe launch 1.21.1 --game-dir "D:\path\to\.minecraft" --username Steve
.\build\Debug\aurora.exe launch 1.21.1 --game-dir "D:\path\to\.minecraft" --username Steve --dry-run--json 可用于 version list/show/latest/fetch、java list/install、loader list/install、forge list/install、mod search/install/list/enable/disable/update、curseforge search/install/update、resourcepack list/enable/disable、modpack info/install、auth 和 launch --dry-run,方便后续 GUI 或脚本调用。
- 启动器自身使用 WinHTTP。优先读取
HTTPS_PROXY/HTTP_PROXY/ALL_PROXY(以及小写形式),否则读取当前用户的 WinINET 设置(含 PAC)。 NO_PROXY会转换为 WinHTTP 绕过列表;WinINET 的ProxyOverride也会保留。- Forge/NeoForge 官方安装器由 Java 执行,会自动带上
-Djava.net.useSystemProxies=true,让 JVM 使用同一套系统代理。 - 下载默认优先内置镜像;镜像失败或响应过慢时,在本次运行内回退官方源。
--mirror/downloadMirrors提供的额外 URL 位于内置镜像之后、官方之前。 - Mojang、Fabric、Forge、NeoForge 使用 BMCLAPI;Modrinth API 使用 MCIM(
mod.mcimirror.top/modrinth/),Modrinth 文件 CDN 走 MCIM 的/data/备用路由(该路由会重定向到官方 CDN,不是独立缓存)。 - Microsoft/Xbox/Minecraft 认证接口、entitlements 和 Adoptium API 不走镜像。
- Modrinth 模组只安装 SHA-1 可验证的
.jar;--no-deps可关闭必需依赖递归安装。 - CurseForge 使用用户自己的 API key(
--api-key、CURSEFORGE_API_KEY或curseForgeApiKey),不会写入日志;config show只显示<set>。CurseForge API 与文件 CDN 不走镜像,文件无downloadUrl时直接拒绝,不擅自构造 CDN 地址。 - 整合包默认自动安装加载器(Fabric/Quilt 直接写 profile;Forge/NeoForge 下载并执行官方安装器)、下载客户端/库/资源,并把包内容放进
versions/<id>;launch <id>会自动把该目录作为运行目录。--no-loader/--no-game可用于只解包或离线准备。Modrinth 包文件校验 SHA-1,CurseForge 包需要用户 API key 解析下载地址。升级前默认复制实例到<game-dir>/backup/<id>-<时间戳>,失败时恢复。 - 下载仍带重试、指数退避和
.part断点续传;跨源切换时会丢弃上一源的半成品,避免拼接不同来源的数据。
- 当前核心面向 Windows;非 Windows 分支只保留编译骨架,WinHTTP/BCrypt/注册表/进程启动尚未移植。
- Microsoft 登录必须使用 AuroraLauncher 自己的 Azure 应用 client ID;不会冒用 HMCL 或其他启动器的应用身份。
- 发布二进制应使用项目自己的代码签名证书。仓库只提供自签开发流程,不包含可信证书私钥;见
SIGNING.md。 - 资源索引支持
objects以及旧版virtual/map_to_resources布局;game_assets会指向实际资源目录。 - 启动前要求客户端 JAR、资源索引和所有带 artifact 的 allow 库已经存在;
install会尝试补齐。 - GUI 已覆盖主页、实例、下载与设置,但没有服务器管理、主题包与 CurseForge 内容浏览;下载源的资源/光影以 Modrinth 为准。Modrinth 和 CurseForge 的必需依赖已支持递归安装,模组启停、Modrinth/CurseForge 更新检查、整合包安装/升级已接入。
- Forge/NeoForge 支持以官方 installer 为准;本项目不重新实现其安装逻辑,也不在启动时隐式联网。
src/
cli.cpp CLI 命令解析和输出
core/
auth.cpp Microsoft 设备码/Xbox/Minecraft 登录与 DPAPI 存储
config.cpp JSON 配置
forge.cpp Forge/NeoForge 元数据、installer 下载与执行
hash.cpp SHA-1/SHA-256/MD5(Windows BCrypt)
http.cpp WinHTTP 请求、重试、断点续传、镜像回退
mirrors.cpp BMCLAPI URL 映射、镜像健康状态和候选顺序
http_post.cpp WinHTTP GET/POST 带自定义头(认证、CurseForge 指纹)
install.cpp 版本文件安装流水线
java.cpp Java 检测
java_install.cpp Adoptium 托管 Java 安装
launch.cpp 启动计划生成
loader.cpp Fabric/Quilt 元数据与 profile 安装
manifest.cpp Mojang 版本清单
maven.cpp Maven 坐标
modrinth.cpp Modrinth 搜索、版本/依赖解析、模组安装与更新
mods.cpp 本地模组扫描、启停和 jar 元数据
curseforge.cpp CurseForge 搜索/安装、指纹匹配与更新
modpack.cpp 整合包解析、加载器/游戏安装、实例与升级
resourcepacks.cpp 资源包扫描、pack.mcmeta 兼容性与 options.txt
paths.cpp 路径和文件工具
process.cpp CreateProcessW 封装
proxy.cpp 系统代理/PAC 解析
repository.cpp 版本目录和继承解析
rules.cpp OS/features 规则
strings.cpp UTF-8/UTF-16、参数引用
version.cpp 版本 JSON 模型
zip.cpp miniz 解压
tests/ 核心单元测试
third_party/ nlohmann/json、miniz(保留许可证)
ARCHITECTURE.md 当前 C++ 架构、数据流和风险
MIGRATION.md Java 功能迁移矩阵和阶段计划
SIGNING.md 产品身份、OAuth 应用和代码签名说明
原工程为 GPL-3.0,本重写工程继续使用 GPL-3.0,见 LICENSE。第三方库许可证见 third_party/*/LICENSE*。