VoxVer Launcher

Appearance

更新日志 ​

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

v0.7.0 - 开发中 ​

主题：设计系统完善 + 组件库 + 多人游戏设置 + 启动流程增强

🎨 设计系统完善 ​

  • 组件库完成 — 完成设计系统与组件库建设，统一组件类型定义，消除 any 类型
  • 主题变量修复 — 全面替换硬编码颜色为 CSS 变量 token，确保深色/浅色模式正确切换
  • 主题色盘优化 — 减少主题色色阶间距，颜色选择器左对齐

⚔️ 多人游戏设置 ​

  • 设置页多人游戏入口 — 新增设置侧边栏「多人游戏」分类入口
  • P2P 与联机设置分离 — 将 P2P 分享和多人游戏设置独立为单独的设置区域

🌐 国际化完善 ​

  • i18n 全面补全 — 修复约 560+ 处硬编码中文文本，新增约 300 个 locale key，覆盖 33 个文件
  • P2P 分享改进 — 修复导入配置丢失、传输中取消、解压进度推送、磁盘空间检查，英文错误信息完善

🚀 启动流程增强 ​

  • 停止立即中断 — 启动过程中点击停止不再等待 90s 超时，依赖下载/诊断/版本解析阶段立即中断并回写状态
  • 停止弹窗详情 — JVM 退出非零时渲染端弹窗显示友好错误摘要，不再只显示「stopped」
  • 假 JAR 精准定位 — 优化损坏文件检测策略，防止 0 字节 HTML 被误判为有效库
  • 自动修复损坏文件 — JVM 退出时自动扫描并列出损坏 JAR 路径+大小+原因

📦 下载系统优化 ​

  • 多源切换超时控制 — 下载时支持多源自动切换与超时控制
  • 全局进度面板 — 全局下载进度面板 UI 优化

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.8.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
设计系统完善 + 组件库v0.7.0
多人游戏设置v0.7.0
i18n 全面补全v0.7.0
启动流程增强（停止中断 + 损坏文件检测）v0.7.0

说明

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

参与贡献

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