VoxVer Launcher

Appearance

更新日志 ​

本文档记录了 VoxVer Launcher 各版本的功能变更、修复内容和未来计划。

v0.6.4 - 2026-07-17 ​

主题：macOS 系统适配与账户管理优化

🍎 macOS 系统适配 ​

  • macOS 双架构构建 — 新增 ARM64 / x64 双架构构建支持，macOS 用户可直接下载 DMG 安装包
  • CI/CD 升级 — GitHub Actions 自动构建 macOS DMG 安装包
  • Node.js 24 LTS — 运行时适配 macOS 26，确保兼容性

👤 账户管理优化 ​

  • 添加账户流程优化 — 点击「添加账户」按钮直接跳转到设置页面的「游戏账户与档案」标签页，不再弹出独立的账户管理弹窗，操作更直观流畅

🔧 构建 ​

  • 版本号升级至 v0.6.4

v0.6.2 - 2026-07-04 ​

主题：设计系统重构与启动画面优化

🎨 设计系统重构 ​

  • Design Token 体系 — 新增 tokens.scss，定义 OLED 暗色底座（#0a0a0a → #0d0d0d → #141414 → #1a1a1a 四层阶梯）、Neubrutalism 工具类
  • 磨砂玻璃效果 — 侧边栏、主内容区、版本信息区域统一 backdrop-filter: blur(8px) + color-mix 半透明效果
  • 磨砂层级修复 — backdrop-filter 移至 ::before 伪元素，解决文字模糊问题
  • HomePage 简化 — 移除启动按钮和统计卡片，Hero 卡片仅展示 Logo + 引导文字
  • Bento Grid 布局优化 — 修复卡片高度强制撑开和空白列问题

🖥️ 启动画面优化 ​

  • 版本号动态加载 — 从 package.json 读取版本号，构建时通过 transformIndexHtml 注入，启动画面实时显示当前版本
  • 进度条动画 — 4 秒匀速走完，完成后通过 transitionend 事件 0.8s 缓慢淡出，不再闪屏
  • Logo 替换 — 启动画面显示 Alogo.png 替代文字标题

🎨 UI 细节 ​

  • 设置页面 — 隐藏滚动条（Chrome / Safari / Firefox / IE 全覆盖）
  • 侧边栏 — 隐藏滚动条；移除底部版本信息
  • 关于页面 — 适配磨砂质感；Alogo 替换 airLogo
  • 颜色选择器 — 修复磨砂层遮挡点击（pointer-events: none）
  • 主题色 — 移除 Hero 卡片的蓝色渐变背景，改为纯背景色

🔧 构建 ​

  • 版本注入 — electron.vite.config.ts 新增 html-inject-version 插件，支持构建时动态注入版本号

v0.6.1 - 2026-07-02 ​

主题：启动稳定性与下载可靠性重大修复

🔧 游戏启动修复 ​

修复项影响
JVM 参数去重修复移除 buildJvmArguments 中的 Set 去重，避免 --add-opens 参数丢失导致 ClassNotFoundException
版本解析修复extractBaseVersion 正则锚定开头，避免从整合包名（如「你好，新蒸程！V1.4.2」）中错误提取版本号
类路径去重buildClasspath 添加 [...new Set(cp)] 去重，修复版本 JSON 中重复库声明导致的 Duplicate key 错误
GC 参数兼容性移除 CMS GC（Java 14+ 已删除），统一使用 G1GC，修复 Unrecognized VM option 'UseConcMarkSweepGC'
缺失文件状态处理前端正确处理 needsFileDownload 状态，弹出确认对话框后调用 confirmDownloadAndLaunch
启动状态切换修复spawnProcess 不再阻塞等待进程退出，进程启动 1.5 秒检测通过后立即切换到「运行中」状态，修复启动器一直显示「启动中」的问题
游戏进程独立运行spawn 选项改为 detached: true，游戏在独立进程组运行，关闭启动器后游戏不会被连带终止

📦 文件完整性校验 ​

  • 库文件大小校验 — checkMissingFiles、downloadMissingFiles 添加文件大小校验，检测 0 字节空文件和大小不匹配文件
  • 资源文件大小校验 — downloadAssets、checkMissingFiles 资源检查添加文件大小校验
  • 下载前清理损坏文件 — 重新下载前删除 0 字节或大小不匹配的文件

🌐 下载系统修复 ​

  • BMCLAPI 重定向支持 — downloadFile 添加 HTTP 301/302/303/307/308 重定向跟随（最多 5 次），修复 BMCLAPI 镜像跳转导致 0 字节文件
  • 下载后文件验证 — 下载完成后校验文件大小不为 0，空文件视为下载失败
  • 0 字节文件跳过修复 — downloadFile 不再跳过已存在的 0 字节文件
  • 资源文件下载源优化 — 资源文件主源改为官方 Minecraft 资源服务器（resources.download.minecraft.net，无速率限制），BMCLAPI 作为备用源，修复 3300+ 资源文件因 BMCLAPI 速率限制（60秒10次）全部返回 403 的问题
  • 并行下载备用源支持 — parallelDownload 添加 fallbackUrl 支持，主源失败时自动尝试备用源

🎨 UI/UX 优化 ​

  • 自定义下载确认弹窗 — 用 PxModal 组件替代原生 confirm()，包含警告图标、消息文本、取消/下载并启动按钮
  • 弹窗国际化 — 新增 launch.missingFilesTitle、launch.missingFilesMessage、launch.missingFilesHint 等 i18n 条目

☕ Java 管理 ​

  • 默认 Java 版本推荐 — 无法解析版本号时默认推荐 Java 21（适配现代 Forge/NeoForge 整合包）

v0.6.0 - 2026-06-28 ​

主题：UI 架构重构与主题系统完善

🎨 UI 重构 ​

  • 设置页分类拆分 — 设置页面按功能分类拆分为多个子页面，提升导航效率
  • 控件统一 — 全局 UI 控件使用 .vox-* 类前缀（.vox-btn、.vox-input、.vox-card 等），统一样式规范
  • 主题系统重构 — 浅色/深色主题完整切换 + 背景自定义 + 主题色自定义，提供更完善的视觉体验

v0.5.5 - 2026-06-25 ​

主题：国际化完善与 UI 优化

✨ 新增功能 ​

  • i18n 国际化全面接入 — 设置页面侧边栏、下载页面侧边栏、更多页面侧边栏、首页账号区域、启动按钮等核心 UI 组件全面支持多语言切换
  • 语言切换功能 — 用户可在设置中切换简体中文和英文，界面实时更新

🔧 TypeScript 类型全面修复 ​

  • IPC 返回类型 — 完善所有 IPC 通道的 TypeScript 类型定义，消除类型警告
  • electronAPI 接口 — 规范 preload 暴露的 API 接口，提升类型安全
  • ModLoader 参数类型 — 修复 ModLoader 安装参数的类型定义

🎨 UI/UX 优化 ​

  • 顶部导航栏图标对齐 — 修复导航栏图标与文字的对齐问题
  • 主内容区域渲染优化 — 优化主内容区域的布局和渲染性能

🔧 ModLoader 安装完善 ​

  • Forge 安装优化 — 完善 Forge ModLoader 的安装流程
  • NeoForge 安装优化 — 新增 NeoForge ModLoader 的完整安装支持
  • Quilt 安装优化 — 完善 Quilt ModLoader 的安装流程
  • Fabric 安装优化 — 修复 Fabric 安装过程中的问题

📝 文档更新 ​

  • 启动器名称变更 — 项目正式从「MC Launcher Alpha（MCLA）」更名为「VoxVer Launcher」，代码仓库从 MC-Launcher-Alpha 更名为 VoxVer-Launcher，文档仓库从 MC-Launcher-Alpha-docs 更名为 VoxVer-Launcher-docs，所有相关文档内容同步更新
  • 仓库链接更新 — 更新所有 GitHub 链接指向新的 VoxVer-Launcher 和 VoxVer-Launcher-docs 仓库
  • 错别字修复 — 修复「BMC Launcher AlphaPI」等错别字，统一为「BMCLAPI」
  • 补充缺失功能文档 — 新增 P2P 实例分享、Mod 自动更新、主题自定义、全局快捷键、皮肤管理等章节

v0.5.4 - 2026-06-20 ​

主题：架构优化与性能提升

✨ 新增功能 ​

  • Squirrel 安装器 — 采用 Squirrel 自动更新框架，支持增量更新和自动回滚
  • 并行下载优化 — 多文件同时下载，提升下载效率
  • JVM GC 动态参数 — 根据系统内存自动配置最佳垃圾回收参数
  • Vitest 测试框架 — 引入单元测试，保障代码质量
  • GitHub Actions CI/CD — 自动化构建、测试和发布流程

🔧 核心修复 ​

  • archiver ESM 问题 — 修复 archiver 库的 ESM 导入问题
  • i18n 导入问题 — 修复国际化模块的导入路径问题
  • CSP 策略问题 — 优化内容安全策略，允许正确的资源加载

⚡ 性能优化 ​

  • 启动速度提升 — 优化主进程启动流程
  • 内存占用降低 — 减少不必要的内存分配

v0.5.3 - 2026-06-09 ​

主题：稳定性更新与体验优化

✨ 新增功能 ​

  • 全局快捷键系统 — 支持自定义全局快捷键，快速启动游戏、切换窗口
  • 通知系统增强 — 优化通知推送逻辑，支持更多通知类型
  • 主题系统优化 — 完善深色/浅色主题切换

🔧 核心修复 ​

修复项影响
实例列表刷新修复实例列表刷新后数据不更新的问题
下载队列同步修复下载队列状态同步问题
主题切换问题修复主题切换后样式不生效的问题

🎨 UI/UX 优化 ​

  • 版本列表双层缓存 — 内存缓存 + 磁盘缓存，加快列表加载
  • 骨架屏优化 — 数据加载时显示骨架屏，提升用户体验

v0.5.2 - 2026-06-07 ​

主题：P2P 分享与主题自定义

✨ 新增功能 ​

  • P2P 实例分享 — 基于 WebRTC 直连技术，通过 6 位分享码实现实例一键分享
  • 主题自定义 — 色盘编辑器，支持自定义主题配色方案
  • CSS 变量动态计算 — 根据主题色自动计算相关颜色值

🔧 核心修复 ​

  • 版本列表缓存优化 — 减少版本列表请求次数
  • 通知系统增强 — 支持更多通知类型和自定义通知

⚡ 性能优化 ​

  • 列表渲染优化 — 虚拟列表技术，提升大数据量渲染性能

v0.5.0 - 2026-06-05 ​

主题：启动核心修复与用户体验优化

本版本聚焦于解决游戏启动失败问题，增强下载稳定性，优化 UI 交互体验，并完成启动器自身热更新功能。

✨ 新增功能 ​

  • 启动器热更新 — 基于 electron-updater 实现自动检测与安装更新，用户无需手动下载即可获取最新版本
  • 下载管理页面 — 在左侧边栏新增下载管理选项，点击可进入下载管理页面，统一管理所有下载任务
  • 多镜像下载源 — 版本文件下载时自动尝试 BMCLAPI、MCBBS、官方源三个镜像，解决单一源不可用导致的下载失败
  • 智能 Java 版本匹配 — 根据游戏版本自动推荐最佳 Java 版本（1.20.5+ → Java 21，1.17+ → Java 17，1.16- → Java 8），并对自定义 Java 路径进行验证和兼容性警告
  • 控制台中文支持 — 新增 npm run dev:zh 脚本，支持中文编码启动开发环境，解决控制台中文乱码问题

🔧 核心修复 ​

修复项影响
类路径传递spawnProcess 方法未接收 classpathStr，导致 Java 进程启动时 -cp 参数为空，触发"类文件缺失"错误
版本文件 404单一镜像源（BMCLAPI）缺少所需文件导致下载失败
版本清单超时缺少超时和重试机制，BMCLAPI 网络波动导致版本列表加载失败
启动游戏显示空版本实例仍显示旧内容，而非提示下载版本
JavaInfo 类型接口缺少 isDefault 属性，TypeScript 编译报错
桌面图标显示安装后桌面快捷方式、任务栏、开始菜单图标不正确

🎨 UI/UX 优化 ​

  • 移除通知弹窗 — 移除右上角 PxNotification 组件，简化 UI，避免干扰用户使用
  • 下载管理入口 — 在左侧边栏添加下载管理选项，提供独立的下载管理页面
  • 版本下载提示 — 空版本实例点击启动时，提示用户先去下载版本，而非显示旧内容

📊 启动日志增强 ​

  • 添加类路径构建统计日志（总计/有效/缺失文件数）
  • 添加版本 JAR 文件缺失检查和明确错误提示
  • 添加完整的启动参数分隔日志（Java路径、工作目录、主类、JVM参数、游戏参数）
  • 长类路径列表自动缩略显示，避免日志溢出

🔒 可靠性改进 ​

  • 版本清单获取添加 30 秒超时 + 3 次重试
  • 版本文件下载添加多镜像自动切换（失败自动降级到下一个镜像）
  • AbortController 替代不支持的 timeout 参数，符合 fetch 标准

📦 构建与发布 ​

  • 版本号更新至 v0.5.0
  • 图标配置优化，确保桌面图标正确显示
  • NSIS 安装程序配置完善（桌面快捷方式、开始菜单、卸载程序）

✅ 构建状态 ​

  • npm run build — ✅ 通过
  • npm run build:win — ✅ 通过
  • TypeScript 类型检查 — ✅ 通过

v0.4.3 - 2026-06-04 ​

主题：启动核心修复与下载增强

本版本聚焦于解决用户反馈的游戏启动失败问题，增强类路径构建逻辑，添加多镜像下载支持，并优化 UI 体验。

✨ 新增功能 ​

  • 多镜像下载源支持 — 版本文件下载时自动尝试 BMCLAPI、MCBBS、官方源三个镜像，解决单一源不可用导致的下载失败
  • 智能 Java 版本匹配 — 根据游戏版本自动推荐最佳 Java 版本 （1.20.5+ → Java 21，1.17+ → Java 17，1.16- → Java 8），并对自定义 Java 路径进行验证和兼容性警告
  • ModLoader 继承版本解析 — 正确处理 Forge/Fabric/NeoForge/Quilt 等 ModLoader 版本的继承关系，合并基础版本的库和配置

🔧 核心修复 ​

修复项影响
类路径传递spawnProcess 方法未接收 classpathStr，导致 Java 进程启动时 -cp 参数为空，触发"类文件缺失"错误
Forge 模块系统参数${library_directory} / ${classpath_separator} 变量未正确替换，导致新版本 Forge 启动失败
库规则处理checkLibRules 的规则判断逻辑有误，导致 jopt-simple 等必需库被错误过滤
版本清单获取缺少超时和重试机制，BMCLAPI 网络波动导致版本列表加载失败
JavaInfo 类型接口缺少 isDefault 属性，TypeScript 编译报错

🎨 UI/UX 优化 ​

  • 移除通知铃铛 — 移除右上角 PxNotification 组件，简化 UI，避免干扰用户使用

📊 启动日志增强 ​

  • 添加类路径构建统计日志（总计/有效/缺失文件数）
  • 添加版本 JAR 文件缺失检查和明确错误提示
  • 添加完整的启动参数分隔日志（Java路径、工作目录、主类、JVM参数、游戏参数）
  • 长类路径列表自动缩略显示，避免日志溢出

🔒 可靠性改进 ​

  • 版本清单获取添加 30 秒超时 + 3 次重试
  • 版本文件下载添加多镜像自动切换（失败自动降级到下一个镜像）
  • AbortController 替代不支持的 timeout 参数，符合 fetch 标准

📦 开发者体验 ​

bash
# 新增：使用中文编码启动开发环境
npm run dev:zh
# 等同于：chcp 65001 > nul && npm run build && cross-env NODE_ENV=development electron .

✅ 构建状态 ​

  • npm run build — ✅ 通过
  • TypeScript 类型检查 — ✅ 通过

v0.4.2 - 2026-06-02 ​

主题：代码规范与稳定性提升

新增功能 ​

  • ESLint v9 配置 — 统一代码风格，配合 Prettier 格式化
  • 安全配置模板 — .env.example 提供 API Key 配置模板（CurseForge 等）

修复 ​

  • 修复 IPC handler 注册中的日志级别误用问题
  • 修复 ModLoader 安装状态无法正确显示的问题
  • 修复全局下载弹窗在某些场景未触发的问题

v0.3.1 - 2026-05-19 ​

修复 ​

  • 站点配置修复 — 将站点基础路径改为 / 以支持自定义域名，添加 CNAME 记录支持 mcla.imipork.top 域名

文档更新 ​

  • 完整文档重写 — 文档网站全面升级，支持简体中文和英文双语
  • 新增鸣谢 — 在首页添加了 PCL2 项目的致谢（UI 布局参考）

v0.3.0 ​

新增功能 ​

  • Mod 配置编辑 UI — 内置配置文件编辑器，支持 .toml 和 .json 格式的 Mod 配置文件直接编辑，无需使用外部文本编辑器
  • 实例导入 / 导出 — 支持将实例打包为压缩文件进行分享或备份，也支持从现有 .minecraft 目录导入为实例
  • ModLoader 安装进度 — ModLoader 安装过程实时推送进度到前端，安装状态一目了然
  • 全局下载进度弹窗 — 右下角悬浮弹窗统一展示所有下载任务的进度，支持查看和管理多个并发下载
  • 通知系统前端接入 — 重要操作（下载完成、安装成功、错误提示等）通过通知系统实时反馈

修复 ​

  • 修复 ModLoader IPC 通信缺失导致安装状态无法正确显示的问题
  • 修复全局下载进度弹窗在某些情况下未正确显示的问题

v0.2.0 ​

新增功能 ​

  • CurseForge + Modrinth 双源 Mod 下载 — 接入两大主流 Mod 仓库，支持关键词搜索、分类浏览和版本筛选
  • Mod 管理 — 支持已安装 Mod 的启用/禁用切换、配置文件编辑和删除操作
  • 崩溃监控与日志分析 — 游戏崩溃时自动捕获日志，分析错误原因并给出修复建议
  • 皮肤管理 — 支持查看和管理玩家皮肤

修复 ​

  • 修复微软登录 token 自动刷新失败导致需要重复登录的问题
  • 修复部分游戏版本启动参数拼装错误导致无法启动的问题

v0.1.0 ​

首个版本 ​

VoxVer Launcher 的首个公开版本，包含以下核心功能：

  • 微软账号登录 — 基于 OAuth 2.0 Device Code Flow 的微软正版登录，安全便捷
  • 离线模式 — 支持自定义用户名的离线登录，适合单机游玩
  • 游戏版本管理 — 基于 BMCLAPI 镜像源，支持正式版、快照、远古版和愚人节版的安装与管理
  • ModLoader 安装 — 支持 Fabric / Forge / NeoForge / Quilt 四大主流 ModLoader 的一键安装
  • 基础实例系统 — 支持创建独立实例，实现版本隔离和 Mod 隔离
  • 深色主题 UI — 现代化的深色界面设计，基于 Vue 3 + TypeScript 构建

计划中的功能（v0.7.0+） ​

以下功能正在规划和开发中，将在后续版本中逐步推出：

功能说明预计版本
Linux 支持适配 Linux 平台v0.7.0+

✅ 已完成的功能 ​

功能完成版本
P2P 实例分享v0.5.2
主题自定义（色盘选择）v0.5.2
整合包创建工具v0.5.2
全局快捷键系统v0.5.3
i18n 国际化v0.5.5
语言切换v0.5.5
Mod 自动更新检测v0.5.5
UI 架构重构（设置页分类拆分）v0.6.0
主题系统重构v0.6.0
启动稳定性修复v0.6.1
下载可靠性增强v0.6.1
文件完整性校验v0.6.1
Design Token 设计体系v0.6.2
磨砂玻璃 UI 效果v0.6.2
启动画面优化v0.6.2
HomePage 重构v0.6.2
macOS 支持v0.6.4

说明

以上计划中的功能可能会根据开发进度和优先级进行调整。具体发布时间和功能细节以实际版本发布为准。

参与贡献

如果你希望为 VoxVer Launcher 贡献代码或提出功能建议，欢迎前往 GitHub 提交 Pull Request 或 Issue。