HMCL（Hello Minecraft! Launcher）

Hello Minecraft! Launcher (HMCL)

核心简介

Hello Minecraft! Launcher（简称 HMCL）不仅是一款开源且免费的 Minecraft 启动核心，更是广大玩家探索方块世界的得力助手。它具备强大的跨平台兼容性，集成了模组（Mod）管理、高度自由的游戏自定义、智能化的自动安装服务（涵盖 Forge、NeoForge、Cleanroom、Fabric、Quilt、LiteLoader 以及画面优化模组 OptiFine）、整合包制作与导出、以及完全个性化的用户界面定制等功能。

HMCL 展现了令人惊叹的跨平台适应能力。它打破了系统的藩篱，不仅完美支持 Windows、Linux、macOS、FreeBSD 等主流操作系统，更在硬件层面实现了广泛兼容，流畅运行于 x86、ARM、RISC-V、MIPS、LoongArch 等多种 CPU 架构之上。这意味着，无论您使用何种设备，HMCL 都能助您轻松开启 Minecraft 之旅。

十二载匠心沉淀

全方位系统支持

极具现代感的全新界面

智能化自动安装系统

HMCL 配备了强大的资源统筹能力，旨在简化您的游戏配置流程：

• 整合包导入支持：无缝对接主流资源平台，支持导入来自 CurseForge、MultiMC 以及 Modrinth 的整合包。
• 一键环境构建：支持创建全新的游戏实例，并自动安装 Fabric、Forge、LiteLoader、OptiFine、Quilt、NeoForge 等核心加载器与组件。
• 多格式导出：支持将您的游戏配置导出为 HMCL 专用格式、MultiMC 格式或 MCBBS 整合包格式，便于分享与备份。

深度个性化主题

• 内置多种精心调配的启动器配色方案，满足不同审美需求。
• 支持完全自定义背景图片，打造属于您的专属启动器界面。

开源精神与社区承诺

Hello Minecraft! Launcher 严格遵循 GPLv3 通用公共许可证，坚持开源与自由的理念。

自 2015 年项目启动以来，HMCL 已经汇聚了至少 110 位开发贡献者的智慧与支持。项目保持着极高的透明度，您可以通过访问官方代码仓库获取详细的开发信息，或者在那里提交功能建议与反馈遇到的问题。

新手入门与常见问题指南

本部分专为初次接触 Minecraft 或 HMCL 的玩家设计。我们将以最直观、最简洁的逻辑，引导您快速掌握从账号登录到进入游戏的全过程。如果您需要对某一功能进行深度挖掘，请参考各模块的详细技术文档。

如何完成账户登录与认证

为了进入 Minecraft 的正版服务器并享受完整的游戏皮肤等服务，您通常需要拥有一个已购买该游戏的微软账户。当然，HMCL 也支持离线模式或外置登录验证，以满足不同的使用场景。

游戏购买途径通常包括 Minecraft 官方网站或微软 Xbox 商店。

当您完成购买或准备好账户后，请按照以下步骤操作：

1. 在 HMCL 主界面的左上角，找到并点击账户板块。
2. 在弹出的菜单中，点击左侧的微软账户选项以进行正版登录。
3. 如果您仅需进行本地测试或没有正版账户，可以选择离线登录，并创建一个本地离线游戏昵称。

如何下载并安装游戏客户端

利用 HMCL 获取游戏资源不仅高效，而且非常直观。

极速启动（适用于零基础玩家）： 如果您不仅是初次使用 HMCL，而且电脑中尚未安装任何游戏版本（实例），您可以直接点击主界面醒目的开始游戏按钮。HMCL 将会自动为您下载并安装最新的 Minecraft 正式版，随后直接启动游戏。

自定义下载（适用于进阶需求）： 如果您希望体验特定的历史版本或快照版本，请遵循以下严谨的步骤：

1. 在主界面左侧导航栏中，找到并点击下载按钮。
2. 进入下载中心后，点击顶部的游戏选项卡。此时，列表会展示所有可供下载的游戏版本。请注意，版本号是按照从新到旧的顺序排列的（即最上方为最新版本）。
3. 在列表中选择您心仪的游戏版本（通常建议选择标识为“正式版”的版本以保证稳定性）。
4. 点击右下角的安装按钮，HMCL 的后台下载引擎将自动接管后续的下载与文件部署工作。
5. 安装完毕后，返回主界面，点击右下角的启动游戏按钮，即可开启您的创造之旅。

如何配置与管理 Java 环境

Java 是 Minecraft 运行的基础环境，而 HMCL 拥有智能的 Java 管理机制。

自动管理机制： 通常情况下，HMCL 能够自动识别游戏版本，并为其匹配最合适的 Java 版本。如果在启动尝试中未检测到兼容的 Java 环境，启动器会弹出提示引导您进行下载。您只需点击“下载”并确认，即可自动完成配置。对于绝大多数新手玩家而言，保留默认设置是最佳选择。

手动管理与指定（适用于高级用户）： 如果您有特殊需求，必须手动干预 Java 的选择，请参考以下逻辑链条：

第一步：安装 Java

1. 进入设置菜单，选择Java 管理。此界面会列出当前 HMCL 已识别或系统中已存在的 Java 版本。
2. 若需安装新版本，点击下载 Java，在列表中选中所需版本号，点击确定执行下载。
3. 若您已在系统中安装了 Java 但启动器未自动识别，请点击添加 Java，手动浏览文件系统，定位到 Java 安装目录下的可执行文件（Windows 系统为 java.exe，Linux/macOS 系统为 java），确认添加。

第二步：应用 Java

• 全局应用：如果您希望所有游戏实例都统一使用某个特定的 Java 版本，请进入设置 -> 全局游戏设置，在此处指定 Java。请注意，这会将该设置应用于所有采用全局默认配置的实例（一般情况下，我们不推荐这种“一刀切”的做法，因为不同游戏版本对 Java 的需求不同）。
• 独立应用：如果您仅需为某个特定的游戏整合包指定 Java，请进入该实例的实例管理界面 -> 游戏设置，勾选“启用实例特定游戏设置”，然后单独为此实例选择 Java 版本。这样设置后，该 Java 环境将仅作用于此特定实例的启动过程，互不干扰。

关键警示：Java 版本的兼容性直接关系到游戏的稳定性。如果您在手动更改 Java设置后，遭遇了游戏崩溃（Crash）或无法启动的情况，请立即将设置回调至 HMCL 的默认推荐状态，以排除环境不兼容导致的问题。