* Replace native libraries on non-x86 platforms * Add support for Linux ARM * Relax the constraint 'JavaVersionConstraint.VANILLA_X86' * Fix several hints * Add OpenGL software renderer option * Add support for OpenGL software renderer on windows * Add __GLX_VENDOR_LIBRARY_NAME on Linux * Catch GLFW error 65543 * Allow users to disable auto completion of native libraries * fix NPE when violated mandatory constraint * Add support for Minecraft 1.13 * Add support for Minecraft 1.6~1.12 * Add base support for linux-loongarch64 * Improve warnings on Loongson platform * Add linux launcher script * fix typo * Add support for loongarch64 (old world)
⛏ Hello Minecraft! Launcher 💎
English | 中文
Introduction
HMCL is a Minecraft launcher which supports Mod Management, Game Customizing, Auto Installing (Forge, Fabric, LiteLoader and OptiFine), Modpack Creating, UI Customization, and more.
No plugin API is provided.
Download
Download the latest version from the official website.
Note: The recent versions released in GitHub are beta versions, which contains extra testing functions compared to the release versions on the official website. However, they may be unstable and you're more likely to encounter bugs or unexpected problems.
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
-
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.
-
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
- Do NOT modify
gradlefiles
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.self_integrity_check.disable=true |
Bypass the self integrity check when checking for update. |
-Dhmcl.bmclapi.override=<version> |
Override API Root of BMCLAPI download provider, defaults to https://bmclapi2.bangbang93.com. e.g. https://download.mcbbs.net. |
-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. |
-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. |