hmcl

HMCL是一款专业级、开源免费、全平台兼容的 Minecraft 启动器，专为模组玩家与技术爱好者打造。它不仅支持 Forge、NeoForge、Fabric、Quilt、LiteLoader 和 OptiFine 等全部主流加载器的一键自动安装，还深度集成模组管理、整合包创建、光影配置、界面主题自定义、多版本隔离等核心功能，真正实现“开箱即用”的高自由度游戏体验。

跨平台兼容，全架构覆盖

HMCL 原生支持 Windows、Linux、macOS 三大桌面系统，并全面适配 x86、ARM（含 Apple Silicon）、RISC-V、MIPS、LoongArch 等多种 CPU 架构。无论你使用的是 Windows 笔记本、MacBook M系列、国产龙芯台式机，还是 ARM 架构的 Linux 服务器，HMCL 都能稳定运行，助你随时随地畅玩 Minecraft。

多人联机说明

当前 HMCL 的多人联机功能正处于维护优化阶段，暂不推荐用于正式联机场景。 建议联机玩家优先使用官方启动器或已验证稳定的第三方方案，待 HMCL 官方公告恢复后，再启用相关功能以确保连接稳定性与安全性。

轻松添加光影效果

光影包通常为 ZIP 格式文件。标准安装路径为：/.minecraft/shaderpacks（若该文件夹不存在，请手动新建）；若已开启「版本隔离」，则需放入对应路径：/.minecraft/versions/<客户端名称>/shaderpacks。不确定游戏目录位置？在 HMCL 主界面点击「打开游戏目录」即可一键跳转。

零基础用户更推荐图形化操作：进入游戏 → 设置 → 视频设置 → 光影 → 光影包文件夹 → 将光影 ZIP 文件拖入该窗口 → 返回光影列表选择并启用 → 点击「完成」即可生效。

?? 温馨提示：光影对硬件性能要求较高。如出现卡顿、掉帧或黑屏，请优先尝试切换为低配光影（如 Sildur’s Vibrant Lite、Chocapic13 Lite），或升级显卡驱动、增加 JVM 内存分配，必要时可临时关闭光影以保障流畅体验。

模组安装全流程指南

第一步：选择并安装合适的 Mod 加载器
在新建游戏实例时，HMCL 提供 Forge、LiteLoader、Fabric、Quilt 四大主流加载器选项，并同步支持 Fabric API 与 QSL/QFAPI（Quilt 核心依赖库）。安装建议如下：

• 1.14 及以上版本 → 强烈推荐 Fabric（生态活跃、轻量高效），并务必勾选 Fabric API；
• 1.14 以下版本 → 推荐 Forge（兼容性最佳），新版 Forge 已内置部分前置；
• 1.12.2 及更早版本 → 可选 LiteLoader（已停止更新，仅作怀旧支持）；
• 追求前沿实验特性 → 可尝试 Quilt（需同步安装 QSL/QFAPI）。

?? 注意事项：
? Forge 与 LiteLoader 在多数版本中可共存，但新旧版本组合可能存在兼容风险；
? Fabric 与 Forge 完全互斥，不可混用；
? Fabric Mod 必须搭配 Fabric API，Quilt Mod 必须搭配 QSL/QFAPI，否则将无法加载。

第二步：安装 Mod（自动+手动双模式）
HMCL 内置 CurseForge 与 Modrinth 官方源，支持中文关键词搜索（结果仅供参考，建议核对版本匹配性）。安装前请务必查看模组详情页——重点关注「依赖项」「适用版本」及「注意事项」，避免因版本错配导致崩溃。

? Forge Mod：在 Mod 下载页确认支持目标版本，注意区分文件名中的「forge」标识；
? Fabric/Quilt Mod：操作流程一致，但必须确保已安装对应 API（Fabric API / QSL/QFAPI）；
? LiteLoader Mod：仅识别 .litemod 后缀文件，其他类型 Mod 修改后缀无效；
? OptiFine：作为独立优化组件，其安装与光影配置深度联动，详细配置方法请参阅官方文档。

手动安装方式：将 .jar 或 .litemod 文件复制至 /.minecraft/mods（无则新建）；开启版本隔离时，路径为 /.minecraft/versions/<版本名称>/mods。亦可在 HMCL「游戏管理 → 模组管理」页面直接拖拽添加，操作更直观高效。

常见问题快速排障

Mod 安装后游戏崩溃或无法启动？别慌，按以下步骤高效定位问题：

1. 善用 HMCL 内置错误分析器：新版启动器会在报错界面直接提示可能原因（如缺失前置、API 版本冲突、Java 版本不匹配等）；
2. 二分法排查法：逐次移除一半模组重启测试，快速锁定异常模组；
3. 日志精读法：查看 /.minecraft/logs/latest.log 中的 ERROR/WARN 关键行，结合模组更新日志交叉验证；
4. 求助协作法：将 crash-reports 与 logs 文件夹打包，提交至 HMCL GitHub Issues 或中文模组社区，附上 Java 版本、HMCL 版本及操作步骤，大幅提升解决效率。