mirror of https://github.com/HMCL-dev/HMCL.git synced 2024-12-27 07:10:41 +08:00

Go to file

Byacrya 7206832edb feat(i18n): correct zh_CN translation Vanilla+ should be translated to '原版增强' instead of '香草+'.		2022-06-03 21:08:45 +08:00
.github	Update bug-report.yml	2022-02-03 22:15:18 +08:00
config/checkstyle	feat: check style & format	2021-05-30 03:34:44 +08:00
gradle/wrapper	Upgrade gradle wrapper	2021-09-17 23:26:54 +08:00
HMCL	feat(i18n): correct zh_CN translation	2022-06-03 21:08:45 +08:00
HMCLauncher	No longer download from tuna mirror	2022-03-01 23:27:51 +08:00
HMCLCore	修复cf源无法获取前置模组 (#1520 )	2022-06-02 14:14:51 +08:00
lib	fix: ReflectionHelper missing method 'getHandle' (#1026 )	2021-09-12 15:26:17 +08:00
minecraft/libraries	Use Gradle Kotlin DSL	2022-01-01 20:59:36 +08:00
.editorconfig	feat: add .editorconfig. Closes #1425 .	2022-05-22 00:54:57 +08:00
.gitignore	chore: update gitignore.	2022-05-22 01:45:09 +08:00
build.gradle.kts	Fix build on JDK without JavaFX	2022-01-23 19:47:26 +08:00
gradlew	Upgrade gradle wrapper	2021-09-17 23:26:54 +08:00
gradlew.bat	Add JavaFX to module path.	2021-04-16 12:18:05 +08:00
javafx.gradle.kts	Add openjfx to testImplementation dependencies	2022-05-07 18:51:52 +08:00
LICENSE	Restore original GPLv3 license	2018-12-08 21:11:10 +08:00
README.md	Update README (#1466 )	2022-05-08 00:06:21 +08:00
settings.gradle.kts	Use Gradle Kotlin DSL	2022-01-01 20:59:36 +08:00

README.md

⛏ Hello Minecraft! Launcher 💎

Join chat! Discord KaiHeiLa

Introduction

HMCL is a Minecraft launcher which supports Mod management, game customizing, auto installing(Forge, LiteLoader and OptiFine), modpack creating, UI customization, and more.

No plugin API is provided.

Download

Download the latest version from the official website.

Note: The recent version released in Github is the beta version, which contains extra testing functions compared to the release versions on the official website. However, they may be unstable and you're more likely to encounter bugs or unexpected problems.

Although not necessary, it is recommended to download the ones from the official website.

License

The software is distributed under GPL v3 with 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).]

Chinese Translation:

附加条款（依据 GPLv3 协议第七条）

当你分发本程序的修改版本时，你必须以一种合理的方式修改本程序的名称或版本号，以示其与原始版本不同。[依据 GPLv3, 7(c).]

本程序的名称及版本号可在此处修改。
你不得移除本程序所显示的版权声明。[依据 GPLv3, 7(b).]

Contribution

If you want to submit a pull request, there are some requirements:

IDE: Intellij IDEA.
Compiler: Java 1.8.
Do NOT modify gradle files.

Compilation

Simply execute the following command:

./gradlew clean build

Make sure you have Java installed with JavaFX 8 at least. Liberica full JDK 8 or later is recommended.

JVM Options (for debugging)

Parameter	Description
`-Dhmcl.self_integrity_check.disable=true`	Bypass the self integrity check when checking for update.
`-Dhmcl.bmclapi.override=<version>`	Override api root of BMCLAPI download provider, defaults to `https://bmclapi2.bangbang93.com`. e.g. `https://download.mcbbs.net`.
`-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.
`-Dhmcl.authlibinjector.location=<path>`	Use specified authlib-injector (instead of downloading one).
`-Dhmcl.openjfx.repo=<maven repository url>`	Add custom maven repository for download 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.