hmcl

HMCL 是一款开源、跨平台的 Minecraft 启动器，功能强大且高度可定制。它不仅支持模组管理、游戏自定义设置，还能自动安装 Forge、NeoForge、Fabric、Quilt、LiteLoader 和 OptiFine 等主流加载器，轻松创建和导入整合包，并提供灵活的界面个性化选项，满足各类玩家从入门到进阶的多样化需求。

HMCL 具备出色的跨平台兼容性，全面支持 Windows、Linux 和 macOS 等主流操作系统，同时适配 x86、ARM、RISC-V、MIPS、LoongArch 等多种 CPU 架构。无论你使用的是台式机、笔记本还是国产设备，都能通过 HMCL 流畅启动并畅玩 Minecraft。

HMCL怎么联机

目前 HMCL 的多人联机功能正处于维护状态，暂时无法使用。请关注后续更新以获取最新进展。

HMCL怎么加光影

光影通常以 Zip 格式提供，只需将其放入 .minecraft\shaderpacks 文件夹即可生效（若该文件夹不存在，请手动创建）。如果启用了版本隔离功能，则路径应为 .minecraft\version\<客户端名称>\shaderpacks。若不确定游戏目录位置，可在 HMCL 中直接点击“打开游戏文件夹”快速定位。

如果你不熟悉版本隔离或不会手动创建文件夹，也可以在游戏内操作：进入游戏后依次点击 设置 → 视频设置 → 光影 → 光影包文件夹，在弹出的目录中放入光影包，返回后选择你要启用的光影，最后点击“完成”即可应用。

注意：光影对硬件性能要求较高。若开启后出现卡顿、帧率骤降等问题，建议升级设备配置、更换为低负载光影包，或直接关闭光影以保障流畅体验。

HMCL怎么加模组

1.安装 Mod 加载器

在创建新游戏版本时，你会看到多个 Mod 加载器选项，包括 Forge、LiteLoader、Fabric 和 Quilt。

此外，还可选择 Fabric API 或 QSL/QFAPI，它们分别是 Fabric 与 Quilt 所需的核心依赖（本质上也是模组）。

对于 Minecraft 1.14 及以上版本，推荐使用 Fabric；1.14 以下版本则更适合 Forge。

LiteLoader 仅适用于 1.12.2 及更早版本，目前已停止更新。

注意：

选定合适的 Mod 加载器后，点击右下角“安装”按钮即可继续完成安装流程。

注意：

LiteLoader 与 Forge 在多数情况下兼容（但新版 Forge 与旧版 LiteLoader 可能存在冲突）。

Fabric 与 Forge 完全不兼容，不可同时使用。

若选择 Fabric，强烈建议一并安装 Fabric API。

若选择 Quilt，则建议同时安装 QSL/QFAPI。

2.安装 Mod

自动安装

Forge Mod

HMCL 内置 CurseForge 与 Modrinth 的模组搜索及下载功能，现已支持中文关键词检索（匹配结果可能因翻译差异略有偏差）。

在模组详情页顶部，会显示该模组所需的前置依赖（如有）以及支持的所有游戏版本，请务必根据你当前安装的 Minecraft 版本选择对应的模组版本。

注意：请仔细区分 Forge Mod 与 Fabric Mod。大多数模组会在文件名中标注类型，请勿选错，否则将导致模组无法加载。

建议点击上方的“模组详情链接”查看官方说明，其中可能包含重要的安装提示或兼容性警告。

Fabric Mod / Quilt Mod

Fabric 与 Quilt 模组的安装流程与 Forge 类似，可参照上述步骤操作。

注意：

几乎所有的 Fabric 或 Quilt 模组都依赖 Fabric API 或 QSL/QFAPI。若在安装加载器时未勾选这些依赖，请务必手动补装，否则模组可能无法正常加载。

Fabric 对应 Fabric API，Quilt 对应 QSL/QFAPI，请勿混淆。

LiteLoader Mod

LiteLoader 模组的安装方式与 Forge 类似，同样可通过 HMCL 内置功能完成。

注意：LiteLoader 仅识别后缀为 .litemod 的文件。强行将其他类型模组（如 .jar）修改后缀名无法被识别，也无法生效。

OptiFine

详情请查阅此

手动安装

常规模组文件格式为 .jar 或 .litemod。

将对应文件复制到 .minecraft\mods 文件夹中即可（若无此文件夹，请自行创建）。

若启用了版本隔离，路径则为 .minecraft\version\<版本名称>\mods。

你也可以在 HMCL 的“游戏管理”页面进入“模组管理”，点击“添加模组”按钮，或将模组文件直接拖入启动器窗口完成安装。

3.安装 Mod 后游戏报错/无法启动

游戏崩溃或启动失败的原因多种多样，常见包括模组间冲突、Fabric API 版本过高、缺少必要前置等。

1. 新版 HMCL 提供错误分析功能，可根据提示快速定位问题根源。

2. 可采用“二分法”排查：每次启用或移除一半模组，逐步缩小范围，直至找出引发问题的具体模组。

3. 若具备一定技术能力，可直接查阅游戏日志（位于 .minecraft\logs）分析错误信息。

4. 如无法理解日志内容，建议将 .minecraft\crash-reports 与 .minecraft\logs 文件夹打包，发送给社区或开发者寻求协助。