* 更新 MacOS 元数据以增强本地化支持 by @burningtnt in https://github.com/burningtnt/Terracotta/pull/69 * 重构 EasyTier 参数拼接逻辑 by @burningtnt in https://github.com/burningtnt/Terracotta/pull/81 * 为 ET 添加 tcp://0.0.0.0:0 监听器 by @burningtnt in https://github.com/burningtnt/Terracotta/pull/90 * 强制 ET 以 p2p_only 模式运行 by @burningtnt in https://github.com/burningtnt/Terracotta/pull/97 * 支持联机房间码持久化 by @burningtnt in https://github.com/burningtnt/Terracotta/pull/94 * 修复 'API c:player_profiles_list invocation failed: Host Profile is consumed or invalid, machine_id may have conflict.' 的问题 by @burningtnt in https://github.com/burningtnt/Terracotta/pull/98
Hello Minecraft! Launcher
English (Standard, uʍoᗡ ǝpᴉsd∩) | 中文 (简体, 繁體, 文言) | 日本語 | español | русский | українська
Introduction
HMCL is an open-source, cross-platform Minecraft launcher that supports Mod Management, Game Customizing, ModLoader Installing (Forge, NeoForge, Cleanroom, 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, macOS, and FreeBSD, 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 to 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
-
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, here are some requirements:
- IDE: IntelliJ IDEA
- Compiler: Java 17+
Compilation
See the Build Guide page.
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 |
-Dhmcl.curseforge.apikey=<Api Key> |
Override CurseForge API Key |