Hello Minecraft! Launcher Dev logo

Hello Minecraft! Launcher Dev huanghongxun

Use this command to install Hello Minecraft! Launcher Dev:
winget install --id=HMCL.HMCL.Dev -e

A Minecraft Launcher which is multi-functional, cross-platform and popular

Hello Minecraft! Launcher (HMCL) is a versatile, cross-platform Minecraft launcher designed to enhance your gaming experience by supporting mod management, game customization, and the installation of various ModLoaders such as Forge, NeoForge, Fabric, Quilt, LiteLoader, and OptiFine. It also facilitates modpack creation and UI customization, making it an essential tool for Minecraft enthusiasts.

Key Features:

  • Multi-functional Design: Supports a wide range of mods and ModLoaders to expand gameplay possibilities.
  • Cross-platform Compatibility: Runs seamlessly on Windows, Linux, macOS, and supports diverse CPU architectures like x86, ARM, RISC-V, MIPS, and LoongArch.
  • Mod Management: Easily install, update, and manage mods with integrated tools.
  • Game Customization: Tailor your game experience with custom configurations and themes.
  • Modpack Creation: Create and share modpacks effortlessly for others to enjoy.
  • UI Customization: Personalize the launcher interface to suit your preferences.

Audience & Benefit:

Ideal for Minecraft players, modders, developers, and enthusiasts who seek a seamless and efficient way to manage their mods, create custom experiences, and enjoy cross-platform compatibility. HMCL offers a comprehensive solution that enhances creativity and flexibility in gaming.

Available for installation via winget, ensuring easy access across supported platforms.

README

⛏ 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, 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

  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 11+
  • Do NOT modify gradle files

Compilation

Simply execute the following command in the project root directory:

./gradlew clean build

Make sure you have Java 11 or later installed.

JVM Options (for debugging)

ParameterDescription
-Dhmcl.home=Override HMCL directory
-Dhmcl.self_integrity_check.disable=trueBypass the self integrity check when checking for updates
-Dhmcl.bmclapi.override=Override API Root of BMCLAPI download provider. Defaults to https://bmclapi2.bangbang93.com
-Dhmcl.font.override=Override font family
-Dhmcl.version.override=Override the version number
-Dhmcl.update_source.override=Override the update source for HMCL itself
-Dhmcl.authlibinjector.location=Use the specified authlib-injector (instead of downloading one)
-Dhmcl.openjfx.repo=Add custom Maven repository for downloading OpenJFX
-Dhmcl.native.encoding=Override the native encoding
-Dhmcl.microsoft.auth.id=Override Microsoft OAuth App ID
-Dhmcl.microsoft.auth.secret=Override Microsoft OAuth App Secret
Versions
3.6.14.286
3.6.12.283
3.6.12.282
3.6.12.281
3.6.12.280
3.6.12.279
3.6.12.278
3.6.12.276
3.6.12.275
3.6.12.274
Website
License