HMCL：专业级开源跨平台Minecraft启动器
HMCL是一款功能完备、持续活跃的开源Minecraft启动器，原生支持Windows、Linux、macOS全平台，兼容x86、ARM、RISC-V、MIPS、LoongArch等主流CPU架构，真正实现“一次配置，多端通行”。它不仅提供Forge、NeoForge、Fabric、Quilt、LiteLoader与OptiFine六大加载器的一键自动安装，更深度集成模组管理、整合包构建、界面主题定制、版本隔离、游戏文件快速定位等核心能力，是进阶玩家与Mod创作者首选的高自由度启动解决方案。
光影安装指南：三步完成，零门槛上手
光影资源通常为ZIP格式压缩包。推荐两种安装方式：
? 路径直投法（适合熟悉文件结构的用户）：将光影ZIP文件放入.minecraft/shaderpacks目录；若启用版本隔离，则存放至.minecraft/versions/<客户端名称>/shaderpacks。不确定路径？在HMCL主界面点击「游戏」→「打开游戏目录」即可直达。
? 游戏内引导法（新手友好）：启动游戏后，依次进入「设置」→「视频设置」→「光影」→「光影包文件夹」，将光影包拖入该窗口，返回后点击目标光影并确认「完成」即可生效。
?? 温馨提示：光影对硬件性能要求较高。若出现卡顿、掉帧或黑屏，请优先尝试低配光影（如Sildur’s Vibrant Lite）、关闭抗锯齿，或升级显卡驱动与Java运行环境。
模组安装全流程：从加载器到稳定运行
第一步：精准选择Mod加载器
安装新客户端时，HMCL提供Forge、LiteLoader、Fabric、Quilt四大主流加载器选项，并同步支持Fabric API与QSL/QFAPI两大核心API组件：
- ? 1.14及以上版本：强烈推荐Fabric（轻量、生态活跃）+ Fabric API
- ? 1.14以下版本：优先选用Forge（兼容性最佳）
- ?? LiteLoader：仅适配1.12.2及更早版本（已停止维护）
- ? 重要兼容提醒：Forge与LiteLoader可共存（需注意版本匹配），但Fabric与Forge互不兼容——请勿混用！
第二步：高效安装Mod
HMCL内置CurseForge与Modrinth双源中文搜索，支持智能识别前置依赖与版本适配：
- ?? Forge Mod：搜索结果页顶部明确标注所需前置及支持版本，请严格匹配当前客户端；务必区分文件名中的
forge标识，避免误装Fabric Mod - ?? Fabric/Quilt Mod：安装逻辑一致，但必须确保已安装对应API（Fabric Mod → Fabric API；Quilt Mod → QSL/QFAPI）
- ?? LiteLoader Mod：仅识别
.litemod后缀文件，修改后缀无法被识别 - ? OptiFine：作为独立优化组件，建议通过HMCL「自动安装」通道获取，或参考官方光影文档专项配置
第三步：手动安装与快速管理
对于离线Mod或自定义资源，可直接将.jar或.litemod文件拖入HMCL「游戏管理」→「模组管理」页面；或复制至：
? 普通模式：.minecraft/mods
? 版本隔离：.minecraft/versions/<版本名称>/mods
常见问题应对：报错排查有章法
安装Mod后游戏闪退、崩溃或无法启动？别慌，按以下步骤系统排查：
?? 智能诊断：新版HMCL自带错误日志分析功能，启动失败时会高亮关键报错信息，优先依据提示操作；
?? 二分排除法：临时移除一半Mod重启测试，逐步缩小范围，快速定位冲突源；
?? 日志溯源：查看.minecraft/crash-reports/与.minecraft/logs/中最新日志文件，重点关注Caused by和at行；
?? 协作求助：将完整crash-reports与logs文件夹打包，提交至社区论坛或Mod作者Issue区，大幅提升解决效率。
