AMCL v1.0.0-beta.3

⚠️ 重要提醒：1.16.5 及以下的低版本尚未完整回归测试，游玩或下载过程中如遇崩溃、下载失败等问题，请务必通过应用内「问题反馈」告诉我们，帮助我们尽快修复！

🎮 新增：1.16.5 及以下版本适配

• 完成 1.16.5 及以下（含 1.7.10 / 1.8.9 / 1.12.2 等老版本）的渲染、鼠标键盘输入、声音适配。

☕ 新增：JDK 8 运行时 + 老 Forge 支持

• 上线 JDK 8 运行时；老 Forge（1.7.10 / 1.8.9 / 1.14.4 / 1.16.4 等）可下载、安装、启动。
• Java 版本可选 自动 / JDK 8 / 17 / 21 / 25，支持单版本独立指定与启动前匹配校验。

📁 新增：版本文件夹

• 在版本详情里浏览、导入、导出、新建、重命名、删除该版本的游戏文件（沙箱内也能管理）。

🔔 优化：检查更新逻辑

• 启动自动检查更新，有新版弹提示并标红点；游戏中不打扰。

🐛 修复

• 依赖库下载失败、完整性校验误报、加载画面未全屏等。

---

versionCode 1000177 · 未签名侧载包，仅供平板/2in1 设备侧载体验。

AMCL v1.0.0-beta.2

资源管理

• 新增：已装模组显示是否最新版，可一键更新
• 新增：模组 / 资源包 / 光影 / 数据包本地导入
• 新增：存档管理板块，存档一键导入 / 导出

游戏内体验

• 重构：聊天 / 输入框，能正常唤起系统输入法

版本与下载

• 新增：版本列表长按拖拽排序；版本详情页可直接启动；版本说明可折叠展开

账户

• 修复：正版头像不显示、切换账号信息不刷新

其它

• 新增：问题反馈、崩溃日志一键上传
• 新增：未装 JDK 17 / JIT 不可用时，Forge 提前提示拦截
• 调整：停用兼容性较差的"新窗口模式"

---

本 HAP 为未签名包（DevEco 默认配置）。安装需自备签名或等待签名分发。仅支持 HarmonyOS NEXT API 20+。

AMCL v1.0.0-beta.1

AMCL 1.0.0-beta.1

从 alpha 进入 beta：启动链路更稳，新增完整性校验与检查更新。

新功能

• 启动前完整性校验 Sheet：JIT / 运行时 / 版本文件 / assets，通过后自动收起再启动
• 文件完整性校验 + 自动补全修复；损坏 / 残留版本在版本管理里标红，可修复或删除
• 自定义 JVM 参数：全局（设置页）+ 单版本（版本详情内联编辑），用户参数优先
• 检查更新：手动 + 启动自动检查（24h 节流）+ 首页/设置红点提示
• 统一版本识别，支持中文路径与版本重命名

修复与优化

• Forge：修复多版本及 MC 26.1 启动崩溃，新增损坏深度修复（保护存档 / 模组）
• JDK：按版本纪元自动路由，不再全局套用同一 JDK；修复 Fabric 路由与推荐版本
• Sodium / LWJGL 校验修复
• 崩溃提示新增 JDK 不兼容判断，正常退出不再误弹
• 下载提速：Forge 安装器 / 大文件高并发分段
• 检查更新改走 GitHub 代理镜像，解决国内直连被阻断

HAP 未签名，需在已开启开发者模式的 HarmonyOS NEXT 设备上手动安装。

AMCL v1.0.0-alpha.5

本版修复 Fabric 1.21.x 启动崩溃，并新增游戏数据外置存储选项。

修复

• Fabric 1.21.x 启动崩溃
  • 修复 vanilla 与 Fabric Loader 同时携带不同版本 ASM 库（如 9.6 / 9.9）导致 classpath 重复、启动闪退的问题。
  • 合并 libraries 时按 Maven groupId:artifactId 去重并保留最高版本；已安装版本无需重装即可生效。

新增

• 游戏数据外置目录（⚠️ 仅平板 / 2in1 可用，手机暂不支持）
  • 支持将 .minecraft 存放到 Download/com.amcl.launcher/，卸载应用后游戏文件保留。
  • 设置页可切换「沙箱 / 外部」存储位置，切换时按需申请权限并自动迁移已安装版本。
  • 外部目录在系统文件管理器中显示为 AMCL 来源入口，便于手动管理游戏文件。
  • 手机因系统对 READ_WRITE_DOWNLOAD_DIRECTORY 权限支持受限，无法将 JVM 游戏数据可靠写入公共 Download 目录，请继续使用默认沙箱存储。

---

📌 HAP 仍为未签名构建，真机安装方式与此前 release 相同。

AMCL v1.0.0-alpha.4

本次更新带来 JDK 25 运行时与 Minecraft 26.2 支持，并修复多项启动崩溃问题。

新增

• JDK 25 运行时支持

  • 完成 JDK 25 在 HarmonyOS NEXT 上的适配，可运行依赖 Java 25 的新版本 Minecraft。
  • 与既有 JDK 17 / 21 多版本运行时并存，按 MC 版本自动路由。

• Minecraft 26.2（Pre-Release）支持

  • 补齐 26.2 启动所需的全部 LWJGL 原生库（freetype / shaderc / spvc / vma）。
  • 26.2 现可在鸿蒙设备上通过 OpenGL（MobileGlues）后端正常进入游戏。

⚠️ 渲染说明：暂不支持 Vulkan

• Minecraft 26.2 内置的官方 Vulkan 渲染后端，依赖当前华为 Maleoon GPU 驱动尚未提供的扩展（VK_KHR_dynamic_rendering / VK_KHR_push_descriptor），暂时无法使用。
• 选择 Vulkan 时会自动回退到 OpenGL 渲染，不再崩溃；游戏内误选 Vulkan 也会在下次启动时自动纠正。
• Vulkan 适配代码已就位，待 GPU 驱动升级支持后即可启用。

---

📌 当前推荐：使用默认的 OpenGL（MobileGlues） 渲染后端获得最佳兼容性。

AMCL v1.0.0-alpha.3

本次主要优化虚拟按键与输入体验：

• 虚拟按键全面重构：统一为大小一致的方形按键、框内自动显示绑定键名，新增「添加按键」与全键盘改键、可拖动可滚动的设置面板。
• 修复聊天框输入：可正常呼出输入法并实时同步到游戏聊天框；存档搜索、创造物品栏、JEI 等游戏内文本框也可输入。
• 新增多项按键玩法：支持 F3+F4 切换游戏模式等多键组合、按住按键拖动瞄准（蓄力弓箭/举盾时拖动视角）、按键显示场景（游戏/菜单）切换。
• 内置手机 / 平板两套精简默认布局，并新增全局透明度调节。

AMCL v1.0.0-alpha.2

修复多任务下载和声音修复

AMCL v1.0.0-alpha.1 — First Public Preview

AMCL v1.0.0-alpha.1 — First Public Preview / 首个公开预览版

⚠️ Pre-release · unsigned HAP · evaluation / 评估用途。Not for general end-user installation.

English

The first public preview build of AMCL — Axe Minecraft Launcher for HarmonyOS NEXT.

What works in this build

• Minecraft Java Edition 1.18 – 1.21.x launches and renders on HarmonyOS NEXT (verified on Mate 70 / Maleoon 910 with MC 1.20.4).
• Mod loaders: Vanilla, Fabric, Forge.
• Embedded patched OpenJDK 17 (stable) and OpenJDK 21 (experimental) cross-compiled for HarmonyOS NEXT (musl, aarch64).
• Touch input with on-screen virtual keys, custom layout editor, audio (OpenAL Soft + OHAudio).
• Multi-mirror, multi-thread, resumable downloader for vanilla / Fabric / Forge / Modrinth / CurseForge.
• Offline accounts (for development); Microsoft genuine login is in progress (M2).

Known limitations

See the Known Issues section in README.

The most important ones:

1. The HAP is unsigned. Real-device installation requires self-signing through the Huawei Developer programme.
2. HarmonyOS NEXT API 20 only (SDK 6.0.0+).
3. ALLOW_WRITABLE_CODE_MEMORY ACL is required for JIT to work.
4. MC version coverage is 1.18 – 1.21.x. Pre-1.18 needs Java 8/16, and 26.1+ needs Java 25 — both not yet adapted.
5. NeoForge / Quilt / OptiFine are not supported yet.

Asset

File	Size	Notes
amcl-v1.0.0-alpha.1-unsigned.hap	≈ 39 MB	DevEco default unsigned build, HarmonyOS NEXT API 20+

---

中文

AMCL — 鸿蒙 NEXT 平台 Axe Minecraft 启动器的首个公开预览版。

当前可用功能

• Minecraft Java 版 1.18 – 1.21.x 已可在 HarmonyOS NEXT 上启动并渲染（已在 Mate 70 / Maleoon 910 上验证 MC 1.20.4）。
• 模组加载器：原版、Fabric、Forge。
• 内嵌为 HarmonyOS NEXT (musl, aarch64) 交叉编译的 OpenJDK 17（稳定）和 OpenJDK 21（实验性）。
• 触摸输入 + 虚拟按键 + 自定义布局编辑器；音频走 OpenAL Soft + OHAudio。
• 多镜像、多线程、断点续传下载器，支持原版 / Fabric / Forge / Modrinth / CurseForge。
• 离线账户（用于开发）；微软正版登录在 M2 里程碑中进行中。

已知限制

详见 README 的 已知问题 章节。

最关键的几条：

1. HAP 未签名。真机安装需通过华为开发者计划自签名。
2. 仅支持 HarmonyOS NEXT API 20（SDK 6.0.0+）。
3. 必须开启 ALLOW_WRITABLE_CODE_MEMORY ACL 才能启用 JIT。
4. MC 版本覆盖为 1.18 – 1.21.x。 1.18 以前需要 Java 8/16，26.1+ 需要 Java 25 —— 两端目前都暂未适配。
5. NeoForge / Quilt / OptiFine 暂不支持。

资产

文件	大小	备注
amcl-v1.0.0-alpha.1-unsigned.hap	≈ 39 MB	DevEco 默认未签名构建，要求 HarmonyOS NEXT API 20+