HMCL/README_cn.md

⛏ Hello Minecraft! Launcher 💎

English | 中文

简介

HMCL 是一款跨平台 Minecraft 启动器, 支持 Mod 管理, 游戏自定义, 游戏自动安装 (Forge, NeoForge, Fabric, Quilt, LiteLoader 与 OptiFine), 整合包创建, 界面自定义等功能.

HMCL 有着强大的跨平台能力. 它不仅支持 Windows、Linux、macOS 等常见的操作系统，同时也支持 x86、ARM、MIPS 和 LoongArch 等不同的 CPU 架构. 您可以使用 HMCL 在不同平台上轻松的游玩 Minecraft.

如果您想要了解 HMCL 对不同平台的支持程度，请参见此表格.

下载

请从 HMCL 官网 下载最新版本的 HMCL.

你也可以在 GitHub Releases 中下载最新版本的 HMCL.

虽然并不强制, 但仍建议通过 HMCL 官网下载启动器.

开源协议

该程序在 GPLv3 开源协议下发布, 同时附有附加条款.

附加条款 (依据 GPLv3 开源协议第七条)

1. 当您分发该程序的修改版本时, 您必须以一种合理的方式修改该程序的名称或版本号, 以示其与原始版本不同. (依据 GPLv3, 7(c))

   该程序的名称及版本号可在此处修改.

2. 您不得移除该程序所显示的版权声明. (依据 GPLv3, 7(b))

贡献

如果您想提交一个 Pull Request, 必须遵守如下要求:

• IDE: Intellij IDEA
• 编译器: Java 1.8 或 Java 11+
• 不要修改 gradle 相关文件

编译

于项目根目录执行以下命令:

./gradlew clean build

请确保您至少安装了含有 JavaFX 8 的 Java. 建议使用 Liberica Full JDK 8 或更高版本.

JVM 选项 (用于调试)

参数	简介
-Dhmcl.home=<path>	覆盖 HMCL 数据文件夹.
-Dhmcl.self_integrity_check.disable=true	检查更新时绕过本体完整性检查.
-Dhmcl.bmclapi.override=<url>	覆盖 BMCLAPI 的 API Root, 默认值为 https://bmclapi2.bangbang93.com.
-Dhmcl.font.override=<font family>	覆盖字族.
-Dhmcl.version.override=<version>	覆盖版本号.
-Dhmcl.update_source.override=<url>	覆盖 HMCL 更新源.
-Dhmcl.authlibinjector.location=<path>	使用指定的 authlib-injector (而非下载一个).
-Dhmcl.openjfx.repo=<maven repository url>	添加用于下载 OpenJFX 的自定义 Maven 仓库
-Dhmcl.native.encoding=<encoding>	覆盖原生编码.
-Dhmcl.microsoft.auth.id=<App ID>	覆盖 Microsoft OAuth App ID.
-Dhmcl.microsoft.auth.secret=<App Secret>	覆盖 Microsoft OAuth App 密钥.