HMCL（Hello Minecraft! Launcher）跨平台开源 Minecraft 启动器：功能架构、平台支持与源码构建全解析

HMCLHello Minecraft! Launcher跨平台开源 Minecraft 启动器功能架构、平台支持与源码构建全解析【免费下载链接】HMCLA Minecraft Launcher which is multi-functional, cross-platform and popular项目地址: https://gitcode.com/gh_mirrors/hm/HMCLHMCLHello Minecraft! Launcher是一款开源、跨平台的 Minecraft 启动器集模组管理、游戏自动安装、模组包建立与介面客制化于一体。本文以docs/README_zh_Hant.md为骨架结合仓库源码HMCLCore 下载模块、平台枚举、Metadata 元数据与docs/PLATFORM_zh_Hant.md、docs/Contributing_zh_Hant.md两篇关联文档系统讲解 HMCL 的核心功能、跨平台兼容矩阵、源码构建流程与运行时调试选项帮助读者既能快速上手使用也能深入理解其实现原理并参与贡献。项目简介与核心功能HMCL 的核心定位是多功能、跨平台的 Minecraft 启动器其功能覆盖了从下载、安装到日常游玩的完整链路模组管理对已安装的模组进行启停、版本管理与依赖处理相关实现集中于HMCLCore/src/main/java/org/jackhuang/hmcl/addon/mod/与resourcepack/等子模块。游戏客制化可针对单个游戏版本设置 Java 参数、分配内存、选择渲染器、调整游戏窗口模式等配置项由HMCL/src/main/java/org/jackhuang/hmcl/setting/GameSettings.java及 GameSettingsPresets.java 管理。游戏自动安装HMCL 支持一键安装 Forge、NeoForge、Cleanroom、Fabric、Legacy Fabric、Quilt、LiteLoader 与 OptiFine 等加载器无需手动放置 JAR 或处理依赖。模组包建立可将当前游戏版本连同模组、配置打包为模组包也支持导入 CurseForge、Modrinth、MultiMC、MCBBS 等格式的模组包见HMCLCore/src/main/java/org/jackhuang/hmcl/modpack/下的curse/、modrinth/、multimc/、mcbbs/等实现。介面客制化支持主题、背景、字体与 UI 缩放的自定义相关代码位于HMCL/src/main/java/org/jackhuang/hmcl/theme/与ui/main/PersonalizationPage.java。从源码结构看游戏自动安装是 HMCL 最具代表性的能力HMCLCore/src/main/java/org/jackhuang/hmcl/download/目录下为每种加载器都维护了独立的版本列表与安装任务例如forge/ForgeInstallTask.java、neoforge/NeoForgeInstallTask.java、fabric/FabricInstallTask.java、quilt/QuiltInstallTask.java、liteloader/LiteLoaderInstallTask.java、optifine/OptiFineInstallTask.java、cleanroom/CleanroomInstallTask.java、legacyfabric/LegacyFabricInstallTask.java它们统一继承自ComponentVersionList/ComponentRemoteVersion抽象体系保证了各加载器安装流程的一致性与可扩展性。跨平台支持能力HMCL 的跨平台能力是其重要卖点。代码层面平台抽象由HMCLCore/src/main/java/org/jackhuang/hmcl/util/platform/OperatingSystem.java中的枚举定义覆盖WINDOWS、LINUX、MACOS、FREEBSD四种操作系统并通过Architecture枚举识别 x86-64、x86、ARM64、ARM32、MIPS64el、RISC-V 64、LoongArch64 等 CPU 架构Metadata.java中还针对不同平台返回推荐的 JDK 下载指引见 Metadata.java印证了其平台适配的精细化。启动器兼容性docs/PLATFORM_zh_Hant.md给出了官方维护的启动器兼容矩阵全文如下架构WindowsLinuxmacOSFreeBSDx86-64✅️ 完整支援 (Windows 7 ~ Windows 11)✅️ 完整支援 (Windows Server 2008 R2 ~ 2025)️ HMCL 3.6 (Windows Vista)️ HMCL 3.6 (Windows Server 2003 ~ 2008)✅️ 完整支援✅️ 完整支援✅ 完整支援x86️ 有限支援 (Windows 7 ~ Windows 10)️ HMCL 3.6 (Windows XP/Vista)️ 有限支援//ARM64✅️ 完整支援✅️ 完整支援✅️ 完整支援/ARM32/️ 有限支援//MIPS64el/️ 有限支援//RISC-V 64/✅️ 完整支援//LoongArch64/✅️ 完整支援 (新世界)️ 有限支援 (旧世界)//图例说明✅️ 完整支援受到完整支援的平台HMCL 会尽可能为此平台提供支援。️ 有限支援通常是老旧的遗留平台HMCL 可以运作但部分功能可能无法使用且可能为了降低维护成本而放弃部分功能。️ HMCL 3.6有限支援HMCL 主分支不再支援该平台仅通过 HMCL 3.6 LTS 分支继续提供安全修补与错误修复不再获得功能更新。/不支援尚未支援的平台未来可能支援。游戏兼容性启动器能运行不代表能顺利启动游戏游戏兼容矩阵如下架构WindowsLinuxmacOSFreeBSDx86-64✅️✅️✅️ (Minecraft 1.13~26.2)x86✅️ (~1.20.4)✅️ (~1.20.4)//ARM64 (Minecraft 1.8~1.18.2)✅ (Minecraft 1.19) (Minecraft 1.8~26.2) (Minecraft 1.6~1.18.2)✅ (Minecraft 1.19)✅ (使用 Rosetta 2)❔ARM32/ (Minecraft 1.8~1.20.1)//MIPS64el/ (Minecraft 1.8~1.20.1)//RISC-V 64/ (Minecraft 1.13~26.2)//LoongArch64 (新世界)/ (Minecraft 1.6~26.2)//LoongArch64 (旧世界)/ (Minecraft 1.6~1.20.1)//PowerPC-64 (Little-Endian)/❔//S390x/❔//图例说明✅官方支援的平台受 Mojang 官方支援游戏内问题应直接向 Mojang 回报。由 HMCL 提供支援、经过测试可正常执行但可能比全面支援的平台有更多问题不保证支援 Minecraft 1.6 以下的版本。❔低级别支援平台HMCL 可运行并有基本支援但尚不能正常启动游戏如需启动游戏需通过其他方式获得 LWJGL 等本机库并在全域游戏设定中指定本机库路径。/ 不支援目前无测试设备若你能协助测试可通过 Issue 提出支援请求。陶瓦联机兼容性HMCL 内置陶瓦联机Terracotta功能其状态机与启动逻辑由HMCL/src/main/java/org/jackhuang/hmcl/terracotta/TerracottaManager.java实现兼容矩阵如下架构WindowsLinuxmacOSFreeBSDx86-64✅️ (Windows 10 ~ Windows 11)✅️ (Windows Server 2016 ~ 2025)✅️✅️✅️x86////ARM64✅️✅️✅️/ARM32////MIPS64el////RISC-V 64/✅️//LoongArch64✅️ (新世界)❌ (旧世界)///值得注意的是陶瓦联机需要较为现代的平台如 Windows 10、RISC-V 64 与 LoongArch64 新世界这与它依赖平台网络能力与进程管理的实现方式相符。下载与获取方式HMCL 提供多个下载渠道可根据网络环境选择HMCL 官方网站获取正式发布版本与更新信息。GitHub Releases托管各版本发布产物包含源码包与可执行文件。CNB Releases面向中国大陆用户的镜像发布渠道。此外HMCL 内置了更新检查机制更新来源可通过 JVM 参数-Dhmcl.update_source.overrideurl覆盖默认指向官方网站更新接口见 Metadata.java适合企业内部部署或离线分发场景。源码结构概览仓库采用 Gradle 多模块构建settings.gradle.kts定义了以下模块HMCL启动器主模块包含 JavaFX 用户界面ui/、设置管理setting/、主题系统theme/、陶瓦联机terracotta/与启动入口EntryPoint.java、Launcher.java。HMCLCore核心业务逻辑包含下载download/、账号认证auth/、游戏版本模型game/、模组包modpack/、任务框架task/等与界面无关的纯 Java 实现。HMCLBoot启动引导模块负责在运行主程序前完成 JavaFX 依赖补丁与基础环境检查。minecraft/librariesHMCLTransformerDiscoveryService 与 HMCLMultiMCBootstrap注入到游戏进程中的辅助库。EntryPoint.java是程序的启动入口其main方法依次完成设置系统代理与 HTTP Agent → 创建 HMCL 数据目录 → 启动日志系统 → 检测 Wine 运行环境 → 处理 macOS 特殊适配 → 检查并修补 JavaFX 依赖 → 进入Launcher.main(args)。这一流程解释了为何 HMCL 能在一个不含 JavaFX 的 JRE 上自行下载依赖并运行。从源码构建 HMCL环境需求构建 HMCL 需要JDK 17或更高版本并确保JAVA_HOME环境变量指向符合需求的 JDK。各平台查看JAVA_HOME指向 JDK 版本的方式WindowsPowerShellPS $env:JAVA_HOME/bin/java.exe -versionLinux/FreeBSD $JAVA_HOME/bin/java -versionmacOS /usr/libexec/java_home --exec java -version对应地Metadata.java中声明了运行期对 Java 的最低要求MINIMUM_REQUIRED_JAVA_VERSION 17、MINIMUM_SUPPORTED_JAVA_VERSION 17推荐版本为 21见 Metadata.java构建与运行版本要求保持一致。获取源码使用 Git 克隆最新源码git clone https://gitcode.com/gh_mirrors/hm/HMCL cd HMCL也可以从发布页手动下载特定版本的源码包。构建命令切换到 HMCL 项目根目录后执行./gradlew clean makeExecutables构建产物位于根目录下的HMCL/build/libs子目录中。makeExecutables任务负责生成可执行包含 Windows/Linux 启动脚本等由buildSrc中的 Gradle 插件org.jackhuang.hmcl.gradle提供支持。运行时调试选项与调优HMCL 提供了一系列内部调试选项不保证稳定性可能随时修改或删除错误使用可能导致行为异常甚至崩溃用于控制启动器行为。这些选项可通过环境变量或JVM 参数设置若两者同时存在JVM 参数会覆盖环境变量。完整清单如下环境变量JVM 参数功能默认值额外说明HMCL_JAVA_HOME设置用于开启 HMCL 的 Java仅对 exe/sh 生效HMCL_JAVA_OPTS设置开启 HMCL 时的默认 JVM 参数仅对 exe/sh 生效HMCL_FORCE_GPU设置是否强制使用 GPU 加速绘制falseHMCL_ANIMATION_FRAME_RATE设置 HMCL 的动画帧率60HMCL_LANGUAGE设置 HMCL 的默认语言使用系统默认语言HMCL_NATIVE_DECORATION-Dhmcl.nativeDecorationtrue/false/auto指定是否使用系统原生窗口装饰autoHMCL_UI_SCALE设置 HMCL 的 UI 缩放比例遵循系统当前的缩放比例支持倍数 (1.5)、百分比 (150%) 或 DPI (144dpi)-Dhmcl.dirpath设置 HMCL 的当前数据存放位置./.hmcl-Dhmcl.homepath设置 HMCL 的用户数据存放位置Windows:%APPDATA%\.hmclLinux/BSD:$XDG_DATA_HOME/hmclmacOS:~/Library/Application Support/hmcl-Dhmcl.self_integrity_check.disabletrue检查更新时不检查程序完整性-Dhmcl.bmclapi.overrideurl设置 BMCLAPI 的 API Roothttps://bmclapi2.bangbang93.com-Dhmcl.discoapi.overrideurl设置 foojay Disco API 的 API Roothttps://api.foojay.io/disco/v3.0HMCL_FONT-Dhmcl.font.overridefont family设置 HMCL 默认字体使用系统默认字体-Dhmcl.update_source.overrideurl设置 HMCL 更新来源https://hmcl.huangyuhui.net/api/update_link-Dhmcl.authlibinjector.locationpath设置 authlib-injector JAR 档的位置使用 HMCL 内置的 authlib-injector-Dhmcl.openjfx.repomaven repository url添加用于下载 OpenJFX 的自定义 Maven 仓库-Dhmcl.native.encodingencoding设置原生编码使用系统的本机编码-Dhmcl.microsoft.auth.idApp ID设置 Microsoft OAuth App ID使用 HMCL 内置的 Microsoft OAuth App ID-Dhmcl.curseforge.apikeyApi Key设置 CurseForge API 密钥使用 HMCL 内置的 CurseForge API 密钥-Dhmcl.native.backendauto/jna/none设置 HMCL 使用的本机后端auto-Dhmcl.hardware.fastfetchtrue/false设置是否使用 fastfetch 检测硬件信息true这些选项与源码中的实现一一对应例如-Dhmcl.dir/-Dhmcl.home在 Metadata.java 中解析决定启动器的数据与用户目录-Dhmcl.bmclapi.override在 DownloadProviders.java 中用于构造 BMCLAPI 下载提供者-Dhmcl.update_source.override则对应Metadata.HMCL_UPDATE_URL。下载源切换HMCL 支持在官方源与镜像源BMCLAPI之间切换DownloadProviders.java中的createDownloadProvider根据DownloadSourceDEFAULT/OFFICIAL/MIRROR构造候选提供者列表例如DEFAULT在境内网络环境优先使用 BMCLAPI境外则优先使用 Mojang 官方源同时init()会监听下载线程数与下载源设置的变化并即时生效。这一设计兼顾了不同地区用户的下载速度与稳定性。参与贡献HMCL 是一个由社群驱动的开源项目欢迎任何人参与贡献代码或提出建议。参与方式包括通过建立Issue回报 Bug 或提出功能请求包含 Bug 报告与功能建议模板。通过 Fork 仓库并提交Pull Request贡献代码。在参与贡献前请阅读 贡献指南其中包含如何从源码构建并开启 HMCL通过调试选项调整 HMCL 的行为自 2015 年以来HMCL 已有超过 120 位贡献者参与其中。仓库的buildSrc中还集成了检查风格Checkstyle见 checkstyle.xml与许可证头校验license-header.txt等自动化质量保障贡献代码时需遵循相应规范。开源协议与附加条款HMCL 在GPLv3开源协议下发布同时附有以下附加条款依据 GPLv3 第七条的授权修改版本须改名当你分发该程序的修改版本时必须以合理方式修改程序的名称或版本号以示其与原始版本不同依据 GPLv3, 7(c)。程序的名称及版本号可在 Metadata.javaNAME、FULL_NAME、VERSION常量处修改。不得移除版权声明你不得移除该程序所显示的版权声明依据 GPLv3, 7(b)。完整的协议文本位于仓库根目录的 LICENSE其中的附加条款部分对应 GPLv3 第 7 条第 (b)、(c) 款是所有分发者都必须遵守的合规要求。结语HMCL 作为一个多功能、跨平台的 Minecraft 启动器其价值不仅体现在开箱即用的体验上更体现在清晰的多模块架构、完善的平台抽象与可配置的下载/调试体系中。通过阅读 繁体中文 README、平台支援状态 与 贡献指南再结合本文对源码实现的分析无论是普通玩家、希望二次开发的贡献者还是研究启动器实现原理的开发者都能快速定位到所需的信息与入口。【免费下载链接】HMCLA Minecraft Launcher which is multi-functional, cross-platform and popular项目地址: https://gitcode.com/gh_mirrors/hm/HMCL创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考