Go to file
Liyan Zhao e0764d6f0c
support java from homebrew (#3035)
* fix: support java from homebrew

* fix: support java from homebrew

* fix: add ~/Library/Java/JavaVirtualMachine
2024-05-14 00:15:07 +08:00
.github Bump Hub Mirror Action to 1.4 (#3034) 2024-05-07 23:36:28 +08:00
config/checkstyle
gradle/wrapper Bump Gradle to 8.6 (#2786) 2024-02-13 00:35:45 +08:00
HMCL Update Copyright (#3010) 2024-05-13 23:45:46 +08:00
HMCLauncher 更新 HMCLauncher 图标 (#2887) 2024-03-05 13:19:29 +08:00
HMCLCore support java from homebrew (#3035) 2024-05-14 00:15:07 +08:00
lib
minecraft/libraries/HMCLTransformerDiscoveryService Remove log4j-patch (#1860) 2022-11-23 17:20:15 +08:00
.editorconfig fix(ui): some text overflow. Closes #1694. 2022-09-03 22:21:38 +08:00
.gitignore I18n (#2468) 2024-01-24 00:11:45 +08:00
build.gradle.kts Bump JUnit to 5.10.2 (#2803) 2024-02-14 13:42:23 +08:00
config-jenkins.sh 在 Jenkins CI 上使用腾讯云镜像下载 Gradle Wrapper (#2837) 2024-02-20 01:42:51 +08:00
gradlew Bump Gradle to 8.6 (#2786) 2024-02-13 00:35:45 +08:00
gradlew.bat Bump Gradle to 8.3 (#2475) 2023-08-19 06:13:39 +08:00
javafx.gradle.kts Update javafx.gradle.kts (#2787) 2024-02-13 00:39:39 +08:00
LICENSE
PLATFORM_cn.md 更新 Linux RISC-V 64 支持 (#2760) 2024-02-08 09:36:37 +08:00
PLATFORM.md 更新 Linux RISC-V 64 支持 (#2760) 2024-02-08 09:36:37 +08:00
README_cn.md 将部分 KOOK 入口替换为 QQ 群 (#2902) 2024-03-06 14:38:13 +08:00
README.md 将部分 KOOK 入口替换为 QQ 群 (#2902) 2024-03-06 14:38:13 +08:00
settings.gradle.kts Remove log4j-patch (#1860) 2022-11-23 17:20:15 +08:00

⛏ Hello Minecraft! Launcher 💎

Build Status Downloads Stars Discord KOOK QQ Group

English | 中文

Introduction

HMCL is a cross-platform Minecraft launcher which supports Mod Management, Game Customizing, Auto Installing (Forge, NeoForge, Fabric, Quilt, LiteLoader and OptiFine), Modpack Creating, UI Customization, and more.

HMCL has amazing cross-platform capabilities. It can not only run on different operating systems such as Windows, Linux, and macOS, but also supports multiple CPU architectures such as x86, arm, mips, and loongarch. You can easily play Minecraft on different platforms through HMCL.

For systems and CPU architectures supported by HMCL, see this table.

Download

Download the latest version from the official website.

You can also download the latest version of HMCL in GitHub Releases.

Although not necessary, it is recommended to download the ones from the official website.

License

The software is distributed under GPLv3 with additional terms.

Additional terms under GPLv3 Section 7

  1. When you distribute a modified version of the software, you must change the software name or the version number in a reasonable way in order to distinguish it from the original version. (Under GPLv3, 7(c))

    The software name and the version number can be edited here.

  2. You must not remove the copyright declaration displayed in the software. (Under GPLv3, 7(b))

Contribution

If you want to submit a pull request, there are some requirements:

  • IDE: Intellij IDEA
  • Compiler: Java 1.8 or Java 11+
  • Do NOT modify gradle files

Compilation

Simply execute the following command in project root directory:

./gradlew clean build

Make sure you have Java installed with JavaFX 8 at least. Liberica Full JDK 8 or later is recommended.

JVM Options (for debugging)

Parameter Description
-Dhmcl.home=<path> Override HMCL directory.
-Dhmcl.self_integrity_check.disable=true Bypass the self integrity check when checking for update.
-Dhmcl.bmclapi.override=<url> Override API Root of BMCLAPI download provider, defaults to https://bmclapi2.bangbang93.com.
-Dhmcl.font.override=<font family> Override font family.
-Dhmcl.version.override=<version> Override the version number.
-Dhmcl.update_source.override=<url> Override the update source for HMCL itself.
-Dhmcl.authlibinjector.location=<path> Use specified authlib-injector (instead of downloading one).
-Dhmcl.openjfx.repo=<maven repository url> Add custom Maven repository for download OpenJFX.
-Dhmcl.native.encoding=<encoding> Override the native encoding.
-Dhmcl.microsoft.auth.id=<App ID> Override Microsoft OAuth App ID.
-Dhmcl.microsoft.auth.secret=<App Secret> Override Microsoft OAuth App secret.