Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 3,608 Commits
.github		.github
HMCL		HMCL
HMCLCore		HMCLCore
HMCLauncher		HMCLauncher
buildSrc		buildSrc
config/checkstyle		config/checkstyle
gradle/wrapper		gradle/wrapper
lib		lib
minecraft/libraries/HMCLTransformerDiscoveryService		minecraft/libraries/HMCLTransformerDiscoveryService
.editorconfig		.editorconfig
.gitignore		.gitignore
LICENSE		LICENSE
PLATFORM.md		PLATFORM.md
PLATFORM_cn.md		PLATFORM_cn.md
PLATFORM_tw.md		PLATFORM_tw.md
README.md		README.md
README_cn.md		README_cn.md
README_tw.md		README_tw.md
build.gradle.kts		build.gradle.kts
config-jenkins.sh		config-jenkins.sh
gradlew		gradlew
gradlew.bat		gradlew.bat
javafx.gradle.kts		javafx.gradle.kts
settings.gradle.kts		settings.gradle.kts

Repository files navigation

⛏ Hello Minecraft! Launcher 💎

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, RISC-V, MIPS, and LoongArch. You can easily enjoy Minecraft across different platforms through HMCL.

For systems and CPU architectures supported by HMCL, please refer tothis table.

Download

Download the latest version from theofficial website.

You can also find the latest version of HMCL inGitHub Releases.

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

License

The software is distributed underGPLv3 license with the following 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. (UnderGPLv3, 7(c))
The software name and the version number can be editedhere.
You must not remove the copyright declaration displayed in the software. (UnderGPLv3, 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 modifygradle 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