AMCL

Axe Minecraft Launcher

面向 HarmonyOS NEXT 的第三方 Minecraft Java 版游戏管理器与启动器

简体中文 · English

下载最新版本 · HoKit 安装指南 · 项目主页 · 隐私政策 · 问题反馈

AMCL（Axe Minecraft Launcher）由独立开发者维护，使用 ArkTS、HarmonyOS C/C++ SDK 与自研原生兼容层，让未经修改的 Minecraft Java 版客户端能够在 HarmonyOS NEXT 上运行。

本 amcl-public 仓库是 AMCL 的公开发布入口，托管 Release、更新清单、项目说明和隐私政策。应用源码不在本仓库中，后续公开安排以项目公告为准。

• 安装和启动 Vanilla、Fabric、Forge 与 NeoForge 游戏实例。
• 同时提供 LWJGL 2 与 LWJGL 3 兼容路径，覆盖旧版与新版 Minecraft。
• 根据游戏版本自动选择 OpenJDK 8 / 17 / 21 / 25，也可在设置中手动调整。
• 支持版本隔离、独立 JVM 参数、游戏语言和存储位置配置。

• Microsoft 正版账户登录（OAuth 2.0 + PKCE、Xbox Live / XSTS / Mojang 链路）。
• 离线账户与 authlib-injector 第三方皮肤站账户。
• 敏感凭据使用 HarmonyOS HUKS AES-GCM-256 在设备本地加密。
• JDK 等关键运行时资源在使用前执行 SHA-256 完整性校验。

• 集成 Modrinth 与 CurseForge 浏览、搜索和安装。
• 支持模组依赖解析、兼容性提示、资源包和整合包安装。
• 支持公共下载目录存储；是否可用取决于设备授权与系统能力。

• 统一下载管理器支持多镜像、并行分段、断点续传、任务取消与重试。
• 1.0.1 集中修复了 JDK 下载失败、尾段重复下载、取消后无法重试及 NeoForge 安装长时间停顿。
• 提供活动日志、网络诊断和本地游戏日志，便于定位安装与启动问题。

• 面向触屏重新设计的摇杆、按键、物品栏直点与菜单输入。
• 可视化布局编辑器支持吸附对齐、多选批量编辑、手机/平板预设和真实比例预览。
• 布局可导入、导出和通过 HarmonyOS 系统分享面板分享，也可从系统“打开方式”直接导入 JSON。

不同 Minecraft 版本、模组和设备驱动的组合很多，表中的“支持”表示 AMCL 已具备对应安装与启动链路，不代表所有第三方模组均经过验证。遇到问题请附上版本信息、操作步骤与相关日志提交 Issue。

1. 打开 最新 Release。
2. 下载文件名以 -unsigned.hap 结尾的资产；1.0.1 对应 amcl-v1.0.1-unsigned.hap。
3. 按 HoKit 安装指南 完成签名和侧载。
4. 首次启动后按提示下载所需 JDK 与游戏资源。

GitHub Release 提供的是 unsigned HAP。部分 JIT 能力依赖 HarmonyOS 受限权限，侧载包和不同设备上的实际能力可能存在差异。

• 修复 JDK 下载失败、卡住及取消后重试无响应。
• 修复下载尾段异常重下和 NeoForge 安装长时间停顿。
• 优化断点续传、动态分段调度、镜像健康判断与慢尾接管。
• 保留旧版 v1.0.0 Release，便于校验与回溯。

完整资产与发布说明见 AMCL v1.0.1。

• ArkTS / ArkUI：应用界面、状态管理与系统能力集成。
• HarmonyOS C/C++ SDK：游戏窗口、输入、音频、网络和 JVM 启动链路。
• OpenJDK HotSpot：针对 HarmonyOS NEXT（musl, aarch64）维护的运行时构建。
• GLFW → XComponent 兼容层、MobileGlues OpenGL → OpenGL ES 翻译层。
• OpenAL Soft + OHAudio 音频栈。
• 自研 ELF Loader：加载经过完整性校验的 JDK 原生库。

• AMCL 不分发 Minecraft 客户端 JAR；游戏文件由用户设备按需从 Mojang 或用户选择的镜像下载。
• “Minecraft”是 Mojang Studios 的商标。AMCL 与 Mojang Studios、Microsoft Corporation、Xbox、网易公司和华为终端有限公司均无关联、无授权、无背书。
• 本仓库中的公开文档采用 MIT License。各第三方组件遵循其各自许可证。