Go to file
2024-11-05 00:20:42 +08:00
.github GitHub Action 使用 Java 8 构建 HMCL (#3340) 2024-10-15 03:13:35 +08:00
config/checkstyle 修复 #3099 自动安装选项卡重新选择版本(Minecraft版本和模组加载器版本)的按钮消失的问题 (#3117) 2024-07-28 02:41:08 +08:00
gradle/wrapper Bump Gradle to 8.10.2 (#3390) 2024-10-26 13:52:49 +08:00
HMCL 设置 FontComboBox 的最小宽度 (#3424) 2024-11-04 18:55:04 +08:00
HMCLauncher 修复 HMCLauncher 无法正常识别 Windows on Arm 平台的问题 (#3425) 2024-11-05 00:20:42 +08:00
HMCLCore Bump XZ to 1.10 (#3391) 2024-10-26 20:54:48 +08:00
lib fix: ReflectionHelper missing method 'getHandle' (#1026) 2021-09-12 15:26:17 +08:00
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.10.2 (#3390) 2024-10-26 13:52:49 +08:00
gradlew.bat Bump Gradle to 8.10.2 (#3390) 2024-10-26 13:52:49 +08:00
javafx.gradle.kts Bump JavaFX to 17.0.13 (#3364) 2024-10-20 21:33:55 +08:00
LICENSE Restore original GPLv3 license 2018-12-08 21:11:10 +08:00
PLATFORM_cn.md Revise readme and platform docs [skip ci] (#3054) 2024-10-15 18:47:38 +08:00
PLATFORM_tw.md Revise readme and platform docs [skip ci] (#3054) 2024-10-15 18:47:38 +08:00
PLATFORM.md README & PLATFORM docs post-fixes (#3417) 2024-11-02 17:36:41 +08:00
README_cn.md Revise readme (#3362) 2024-10-20 21:36:01 +08:00
README_tw.md Revise readme (#3362) 2024-10-20 21:36:01 +08:00
README.md README & PLATFORM docs post-fixes (#3417) 2024-11-02 17:36:41 +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 QQ Group

English | 简体中文 | 繁體中文

Introduction

HMCL is an open-source, cross-platform Minecraft launcher that supports Mod Management, Game Customizing, ModLoader Installing (Forge, NeoForge, Fabric, Quilt, LiteLoader, and OptiFine), Modpack Creating, UI Customization, and more.

HMCL has amazing cross-platform capabilities. Not only does it run on different operating systems like Windows, Linux, and macOS, but it also supports various CPU architectures such as x86, ARM, MIPS, and LoongArch. You can easily enjoy Minecraft across 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 find the latest version of HMCL in GitHub Releases.

Although not necessary, it is recommended only to download releases from the official websites listed above.

License

The software is distributed under GPLv3 license with the following 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, here 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 the project root directory:

./gradlew clean build

Make sure you have at least JavaFX 8 installed. 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 updates
-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 the specified authlib-injector (instead of downloading one)
-Dhmcl.openjfx.repo=<maven repository url> Add custom Maven repository for downloading 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