HMCL启动器：多版本与模组玩家的实用指南
【免费下载链接】HMCLA Minecraft Launcher which is multi-functional, cross-platform and popular项目地址: https://gitcode.com/gh_mirrors/hm/HMCL
HMCL启动器（Hello Minecraft! Launcher）是一款免费开源的Minecraft启动器。它能管理多个游戏版本、安装模组、切换多账户，还能直接装整合包。这篇文章写给玩模组、要同时维护几个版本的玩家。
先跑起来：从拿到手到进游戏的3步
第1步：获取启动器。从官方发布页下载 HMCL启动器 的预构建包，Windows 下双击 exe 即可运行。开发者也可以拉源码自己构建：
git clone https://gitcode.com/gh_mirrors/hm/HMCL第2步：运行。HMCL 本身跑在 Java 上，需要 Java 17 及以上版本，项目推荐 Java 21。如果你手上只有 jar 包，在终端里这样执行：
java -jar HMCL.jar第3步：登录并装版本。首次进入界面后，先在账户区选一种登录方式（微软账户、离线账户等），再到版本列表里挑一个游戏版本。HMCL 会自动下载对应的游戏文件，下完就能点"开始游戏"。
场景：模组玩家最常用的三件事
同时管理多个版本、多份存档
HMCL 的基本单位是"实例"。同一个启动器里可以既放一个装模组的 1.20，又放一个 1.8 的小游戏版，互不干扰。给每个实例设置独立的游戏目录后，两边的存档、配置文件各归各的文件夹。游戏与实例相关的源码集中在 HMCLCore/src/main/java/org/jackhuang/hmcl/game/。
批量装模组与装整合包
给某个版本装模组时，在模组的列表区域可以一次选中多个模组文件添加，不必一个一个点。除了散装，HMCL 还支持整包安装：Modrinth、CurseForge 的整合包，以及 Minecraft 中文社区的资源，都可以通过对应的安装入口直接导入；MultiMC 格式的实例也能识别。如果目标版本还需要模组加载器，创建实例时可选 Forge、NeoForge、Fabric、Quilt、Cleanroom、LiteLoader 或 OptiFine，HMCL 会连同加载器一起下载。整合包安装任务的源码在 HMCLCore/src/main/java/org/jackhuang/hmcl/modpack/。
多账户切换
HMCL 允许你添加多个账户，点一下就能换。三种账户各自的适用场合如下：
| 账户类型 | 适用场合 |
|---|---|
| 微软账户 | 正版登录，和朋友联机时用这个 |
| 离线账户 | 单机或局域网，不需要在线验证 |
| 第三方账户（Authlib-Injector） | 社区服务器自带登录系统时 |
账户相关的代码在 HMCLCore/src/main/java/org/jackhuang/hmcl/auth/，登录、刷新、登出的流程都能在这里找到对应实现。
🎮 两个可以照做的小流程
两个版本的存档并存
- 给版本 A 建一个实例，在游戏目录设置里选"独立目录"。
- 给版本 B 再建一个实例，同样使用独立目录。
- 平时照常分别启动，存档分别落在各自目录的 saves 文件夹里，备份时直接整个文件夹复制走即可。
模组加载失败的排查
游戏刚启动就闪退时，按这个顺序来：
- 打开 HMCL 的"日志窗口"，看游戏退出后打印的错误段，先确认报错里提到哪个模组的名字。
- 核对这个模组是否支持你当前的游戏版本和模组加载器版本。
- 看不出来的话，把模组临时移走一半再启动，用二分法逐步缩小范围，找出冲突的那一个。
⚠️ 高频避坑：三个常见问题与解法
坑1：启动时提示 Java 版本不对
- 现象：点开 HMCL 或启动游戏时，弹出 Java 版本过低的提示。
- 原因：系统里的 Java 太旧，低于 HMCL 要求的 Java 17。
- 解法：装一个更新的 JDK；也可以先在 HMCL 的设置里切换到另一台机器上已有的可用 Java。
坑2：单个模组正常，凑在一起就崩
- 现象：只装一个模组能进游戏，多装几个就闪退。
- 原因：两个模组改了同一处逻辑，或某个模组缺少依赖。
- 解法：用日志窗口确认报错方，补装它声明的依赖，或换成兼容的模组版本。
坑3：下载很慢或总是失败
- 现象：下载游戏文件时速度极低，或者直接超时。
- 原因：默认下载源离你的网络环境较远。
- 解法：到设置页换用其他下载源，HMCL 内置了多个可选来源。
源码入口与社区参与
想读代码，建议从这两处入手：
- 界面与主流程：HMCL/src/main/java/org/jackhuang/hmcl/ui/
- 项目贡献指南：docs/Contributing.md，里面有从源码构建到调试的完整步骤
遇到问题时，在仓库的 issue 区提交并附上日志是最快的求助方式；有改进想法也可以直接提 PR。HMCL 从 2015 年开源至今，一直是社区在持续维护，值得长期跟进它的更新。剩下的事，就打开启动器，去装你的第二个版本吧。
【免费下载链接】HMCLA Minecraft Launcher which is multi-functional, cross-platform and popular项目地址: https://gitcode.com/gh_mirrors/hm/HMCL
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
