HMCL 启动器模组管理与自动安装教程
打通 Forge / Fabric 底层补丁包极速配置，自带 CurseForge 库中文一键搜索，轻松告别模组冲突和闪退。
毒霸安全检测MD5公开可验证无恶意广告弹窗
模组(Mod)及光影极速上手 3 步曲
- 一键安装底层加载器框架 (Forge/Fabric)：进入 HMCL “版本设置” -> “自动安装”，选择 Forge 或 Fabric，点击安装。启动器全自动完成框架打补丁，免去任何手动 class 注入。
- 内置 CurseForge 仓库一键添加 Mod：进入“模组管理” -> “添加模组”，直接输入中文关键字（如旅行地图、JEI）。HMCL 自动拉取完全匹配您游戏版本的原生 jar 包并全自动解决前置 API 依赖下载。
- 配置画质光影 (OptiFine/Iris)：在自动安装界面勾选并安装 OptiFine 或 Iris，将您喜欢的光影 zip 包直接拖放到启动器下的
shaderpacks文件夹中。进入游戏即可在视频设置中轻松开启 3A 级画质。
模组高阶配置指南
提供高深度、保姆级的操作策略，解决 MCBBS 关闭后玩家模组加载困难。
模组自动与手动安装完全攻略
深度讲解内置一键 Forge 安装器流程，与传统 `.minecraft/mods` 手动拖放放置路径。
查看安装攻略 →多实例模组版本隔离
在同一个启动器玩 1.12 科技包与 1.20 生存包？一键启用版本隔离，杜绝 Mod 交叉冲突。
查看隔离配置 →常见问题
为什么把 Mod 拖入 mods 文件夹后，游戏开起来没有生效？
请确保您完成了两点自检：1. 您是否在 HMCL 中正确安装并启动了带有 “Forge” 或 “Fabric” 标识的那个游戏版本，而不是启动了“纯净版”；2. 您拖入的 Mod 文件是不是 .jar 格式。如果是 .zip 或者是 .rar，请解压缩，切勿直接放置。
安装 Mod 启动后，提示“缺少 XXX 模组，需要 Fabric API 才可以运行”？
这是因为大多数 Fabric Mod 本身只是逻辑层，必须依赖 Fabric 开发的“底层官方标准接口（Fabric API）”作为前置运行。您只需在 HMCL 模组管理中点击“添加模组”，输入并安装 Fabric API 这款前置即可。
不同的 Mod 可以混在同一个 mods 文件夹里吗？
如果不开启“版本隔离”，不同的 Mod 堆在一个 mods 文件夹里极易导致版本交叉感染，从而发生崩溃。强烈建议您开启多实例：在 HMCL 界面选中游戏设置，开启“版本隔离”复选框，此时每个 Minecraft 版本将获得一个独立的 mods 文件夹。详见 多实例隔离教程。