HMCL: Difference between revisions
m enable translate |
Marked this version for translation |
||
| Line 1: | Line 1: | ||
<translate> | <translate> | ||
<!--T:1--> | |||
[https://hmcl.net/ Hello Minecraft! Launcher] (HMCL) is a free, open-source, and cross-platform [https://www.minecraft.net Minecraft] launcher. | [https://hmcl.net/ Hello Minecraft! Launcher] (HMCL) is a free, open-source, and cross-platform [https://www.minecraft.net Minecraft] launcher. | ||
== Installation == | == Installation == <!--T:2--> | ||
<!--T:3--> | |||
==== Using nix-shell ==== | ==== Using nix-shell ==== | ||
<syntaxhighlight lang="shell"> | <syntaxhighlight lang="shell"> | ||
| Line 10: | Line 12: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
<!--T:4--> | |||
==== Using global configuration ==== | ==== Using global configuration ==== | ||
<syntaxhighlight lang="nix"> | <syntaxhighlight lang="nix"> | ||
| Line 15: | Line 18: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
<!--T:5--> | |||
==== Using home configuration ==== | ==== Using home configuration ==== | ||
<syntaxhighlight lang="nix"> | <syntaxhighlight lang="nix"> | ||
| Line 20: | Line 24: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== Configuration == | == Configuration == <!--T:6--> | ||
==== Basic ==== | ==== Basic ==== <!--T:7--> | ||
<!--T:8--> | |||
At present, configuration can be performed through the HMCL interface; however, declarative configuration is not currently supported. | At present, configuration can be performed through the HMCL interface; however, declarative configuration is not currently supported. | ||
==== Wayland support ==== | ==== Wayland support ==== <!--T:9--> | ||
<!--T:10--> | |||
Starting with Minecraft 26.1, Wayland support can be enabled by adding the JDK arguments <code>-DMC_DEBUG_ENABLED</code> and <code>-DMC_DEBUG_PREFER_WAYLAND</code>. In HMCL, these can be configured under <code>Advanced Settings -> JVM Options -> JVM Arguments</code>. | Starting with Minecraft 26.1, Wayland support can be enabled by adding the JDK arguments <code>-DMC_DEBUG_ENABLED</code> and <code>-DMC_DEBUG_PREFER_WAYLAND</code>. In HMCL, these can be configured under <code>Advanced Settings -> JVM Options -> JVM Arguments</code>. | ||
<!--T:11--> | |||
For older Minecraft versions, users who want to use Wayland should enable <code>Advanced Settings -> Workaround -> Use System GLFW</code>. Otherwise, this option should remain disabled. | For older Minecraft versions, users who want to use Wayland should enable <code>Advanced Settings -> Workaround -> Use System GLFW</code>. Otherwise, this option should remain disabled. | ||
==== Advanced ==== | ==== Advanced ==== <!--T:12--> | ||
<!--T:13--> | |||
You can override the JDK with one that is not included by default, such as <code>jdk8_headless</code>, or use alternative builds like <code>zulu17</code>, in order to support older versions of Minecraft. | You can override the JDK with one that is not included by default, such as <code>jdk8_headless</code>, or use alternative builds like <code>zulu17</code>, in order to support older versions of Minecraft. | ||
<!--T:14--> | |||
<syntaxhighlight lang="nix"> | <syntaxhighlight lang="nix"> | ||
environment.systemPackages = with pkgs; [ | environment.systemPackages = with pkgs; [ | ||
| Line 47: | Line 56: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== References == | == References == <!--T:15--> | ||
<!--T:16--> | |||
* [https://docs.hmcl.net/ HMCL documentation] | * [https://docs.hmcl.net/ HMCL documentation] | ||
<!--T:17--> | |||
[[Category:Applications]] | [[Category:Applications]] | ||
[[Category:Gaming]] | [[Category:Gaming]] | ||
</translate> | </translate> | ||
Latest revision as of 15:11, 23 May 2026
Hello Minecraft! Launcher (HMCL) is a free, open-source, and cross-platform Minecraft launcher.
Installation
Using nix-shell
$ nix-shell -p hmcl
Using global configuration
environment.systemPackages = with pkgs; [ hmcl ];
Using home configuration
home.packages = with pkgs; [ hmcl ];
Configuration
Basic
At present, configuration can be performed through the HMCL interface; however, declarative configuration is not currently supported.
Wayland support
Starting with Minecraft 26.1, Wayland support can be enabled by adding the JDK arguments -DMC_DEBUG_ENABLED and -DMC_DEBUG_PREFER_WAYLAND. In HMCL, these can be configured under Advanced Settings -> JVM Options -> JVM Arguments.
For older Minecraft versions, users who want to use Wayland should enable Advanced Settings -> Workaround -> Use System GLFW. Otherwise, this option should remain disabled.
Advanced
You can override the JDK with one that is not included by default, such as jdk8_headless, or use alternative builds like zulu17, in order to support older versions of Minecraft.
environment.systemPackages = with pkgs; [
(hmcl.override {
minecraftJdks = [
jdk8_headless
zulu17
];
})
];