MCLA

Appearance

更新日志 ​

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

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 ​

首个版本 ​

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

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

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

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

功能说明预计版本
Mod 自动更新基于 Modrinth / CurseForge API 自动检测并更新已安装的 Modv0.5.1
整合包工具支持创建、导入和导出整合包（Modpack）v0.5.1
快捷键系统全局快捷键支持，如快速启动、切换实例等v0.5.1
P2P 实例分享基于 6 位分享码 + WebRTC 的实例一键分享功能v0.5.1
背景自定义支持自定义启动器背景图片v0.5.1
主题自定义支持自定义主题配色方案（色盘选择）v0.5.1
macOS 支持适配 macOS 平台v0.6.0+
Linux 支持适配 Linux 平台v0.6.0+

说明

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

参与贡献

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