Mirror Repository / Mirror to CNB (push) Skipped
Mirror Repository / Mirror to Gitee (push) Skipped
PR Size Label / label (pull_request_target) Failing after 28s
Check Codes / build (pull_request) Failing after 28s
Check Codes / build (push) Failing after 28s
Java CI / build (pull_request) Failing after 4m13s
Java CI / build (push) Failing after 4m14s
Strip Terracotta multiplayer, QQ/Discord community promo, in-launcher mod/modpack/world download browse flows, the title-bar help button, and launcher self-update checks/UI so this fork no longer hooks upstream HMCL update endpoints. Local modpack import/export and resource/shader downloads remain. Compile and setting unit tests pass.
76 lines
3.9 KiB
Markdown
76 lines
3.9 KiB
Markdown
<!-- #BEGIN BLOCK -->
|
|
<!-- #PROPERTY NAME=TITLE -->
|
|
<div align="center">
|
|
<img src="/HMCL/src/main/resources/assets/img/icon@8x.png" alt="HMCL Logo" width="64"/>
|
|
</div>
|
|
|
|
<h1 align="center">Hello Minecraft! Launcher</h1>
|
|
<!-- #END BLOCK -->
|
|
|
|
<!-- #BEGIN BLOCK -->
|
|
<!-- #PROPERTY NAME=BADGES -->
|
|
<div align="center">
|
|
|
|
[](https://github.com/HMCL-dev/HMCL)
|
|
[](https://cnb.cool/HMCL-dev/HMCL)
|
|
[](https://gitee.com/huanghongxun/HMCL)
|
|
|
|
[](https://space.bilibili.com/20314891)
|
|
|
|
</div>
|
|
<!-- #END BLOCK -->
|
|
|
|
---
|
|
|
|
<!-- #BEGIN LANGUAGE_SWITCHER -->
|
|
**English** (**Standard**, [uʍoᗡ ǝpᴉsd∩](README_en_Qabs.md)) | 中文 ([简体](README_zh_Hans.md), [繁體](README_zh_Hant.md), [文言](README_lzh.md)) | [日本語](README_ja.md) | [español](README_es.md) | [русский](README_ru.md) | [українська](README_uk.md)
|
|
<!-- #END LANGUAGE_SWITCHER -->
|
|
|
|
## Introduction
|
|
|
|
HMCL is an open-source, cross-platform Minecraft launcher that supports Mod Management, Game Customizing, ModLoader Installing (Forge, NeoForge, Cleanroom, Fabric, Legacy 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](PLATFORM.md).
|
|
|
|
## Download
|
|
|
|
You can download HMCL from the following sources:
|
|
|
|
- [HMCL Official Website](https://hmcl.huangyuhui.net/download)
|
|
- [GitHub Release](https://github.com/HMCL-dev/HMCL/releases)
|
|
- [CNB Release](https://cnb.cool/HMCL-dev/HMCL/-/releases)
|
|
|
|
## Contributing
|
|
|
|
HMCL is a community-driven open-source project, and everyone is welcome to contribute code or provide suggestions.
|
|
|
|
You can contribute to HMCL development in the following ways:
|
|
|
|
- Report bugs or request features by [creating an issue](https://github.com/HMCL-dev/HMCL/issues/new/choose) on GitHub.
|
|
- Contribute code by forking the repository on GitHub and [submitting a pull request](https://github.com/HMCL-dev/HMCL/compare).
|
|
|
|
Before contributing, please read the [Contributing Guide](./Contributing.md), which includes the following:
|
|
|
|
- [How to build and run HMCL from source](./Contributing.md#build-hmcl)
|
|
- [Adjusting HMCL behavior using debug options](./Contributing.md#debug-options)
|
|
|
|
## Contributors
|
|
|
|
Since 2015, more than 140 contributors have participated in HMCL. Thank you for your hard work!
|
|
|
|
[](https://github.com/HMCL-dev/HMCL/graphs/contributors)
|
|
|
|
## License
|
|
|
|
The software is distributed under [GPLv3](https://www.gnu.org/licenses/gpl-3.0.html) 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)](https://github.com/HMCL-dev/HMCL/blob/11820e31a85d8989e41d97476712b07e7094b190/LICENSE#L372-L374))
|
|
|
|
The software name and the version number can be edited [here](https://github.com/HMCL-dev/HMCL/blob/86529c6f15b3be54ed8d89ece47566cf57f43eb7/HMCL/src/main/java/org/jackhuang/hmcl/Metadata.java#L36-L38).
|
|
|
|
2. You must not remove the copyright declaration displayed in the software. (Under [GPLv3, 7(b)](https://github.com/HMCL-dev/HMCL/blob/11820e31a85d8989e41d97476712b07e7094b190/LICENSE#L368-L370))
|