Minecraft: Difference between revisions

Latest revision as of 18:45, 6 November 2024

Minecraft is a sandbox game about building, surviving, fighting, and being creative, developed by Mojang Studios.^[1] Minecraft currently has two supported variants known as:

Minecraft: Java Edition is only available on Windows, MacOS and Linux and is known for modding.
Minecraft: Bedrock Edition is available on Windows, Xbox One, Xbox Series S and X, PlayStation 4 and 5, Nintendo Switch, Android, iOS. Bedrock is not playable on Linux due to UWP applications not being supported on Linux.^[2]^[3]

Launchers

Offical Minecraft Launcher: Website — Package/pkgs.minecraft

Warning: 1.19 or higher is not working on NixOS, using alternative clients is strongly recommended.

Prism Launcher: A free, open source launcher. Website — Package/pkgs.prismlauncher

ATLauncher: A simple and easy to use Minecraft launcher which contains many different modpacks for you to choose from and play. Website — Package/pkgs.atlauncher

Badlion Client: A closed source PvP Modpack. Website — Package/pkgs.badlion-client

Lunar Client: A free Minecraft client with mods, cosmetics, and performance boost. Website — Package/pkgs.lunar-client

hmcl: A Minecraft Launcher which is multi-functional, cross-platform and popular. Website — Package/pkgs.hmcl

Installation

Your preferred client can be either imperatively installed by typing nix-env -iA nixos.<LAUNCHER> or nix profile install nixpkgs#<LAUNCHER> if Flakes are enabled. Preferably, install the package declaratively and globally by typing

environment.systemPackages = [
  pkgs.<LAUNCHER>
];

Alternatively, the package can be installed per-user with users.users.<USER>.packages or home-manager. For nix native, use:

users.users.<USER>.packages = [
  pkgs.<LAUNCHER>
];

For home-manager, use:

home.packages = [
  pkgs.<LAUNCHER>
];

Troubleshooting

ATlauncher can't start instance

By default, ATlauncher installs its own Java runtime in **USERSDIR**/runtimes/minecraft, which gets selected in the settings' Java Path.

To fix this, make sure to select the java version installed in the system store from the Settings > Java/Minecraft > Java Path menu and also disable the Use Java Provided By Minecraft? option.

If your instance still doesn't start, check the instance settings and apply the same changes there.

Prism Launcher doesn't have Java Version XX.

The Prism Launcher package can be overridden to add additional Java runtimes. Check Prism_Launcher#Advanced to see an example.

Minecraft can’t start without Java Version XX.

Different Minecraft versions need different Java versions


Minecraft Version	Minimum Compatible JRE Version
< 1.17	8
1.17	16
>= 1.18	17
>= 1.20.5	21

Official Minecraft Launcher fails to start the game.

It is possible that you are attempting to start a version of Minecraft that is 1.19 or higher. Unfortunately, this is broken on NixOS. It is strongly recommended to use alternative launchers.

[1] ttps://www.minecraft.net/about-minecraft

[2] ttps://www.minecraft.net/article/java-or-bedrock-edition

[3] ttps://learn.microsoft.com/windows/uwp/get-started/universal-application-platform-guide

[1]

[2]

[3]

@@ Line 6: / Line 6: @@
 '''Offical Minecraft Launcher:''' [https://www.minecraft.net/download Website] — [https://search.nixos.org/packages?show=minecraft Package/pkgs.minecraft] {{warning|1.19 or higher is not working on NixOS, using alternative clients is strongly recommended.}}
-'''Prismlauncher:''' A free, open source launcher. [https://prismlauncher.org/ Website] — [https://search.nixos.org/packages?show=prismlauncher Package/pkgs.prismlauncher]
+'''[[Prism Launcher]]:''' A free, open source launcher. [https://prismlauncher.org/ Website] — [https://search.nixos.org/packages?show=prismlauncher Package/pkgs.prismlauncher]
 '''ATLauncher:''' A simple and easy to use Minecraft launcher which contains many different modpacks for you to choose from and play. [https://atlauncher.com/about Website] — [https://search.nixos.org/packages?show=atlauncher Package/pkgs.atlauncher]
@@ Line 21: / Line 21: @@
    pkgs.<LAUNCHER>
 ];
-</syntaxhighlight>Alternatively, the package can be installed per-user with <code>users.users.<USER>.packages</code> or [[home-manager]]. For nix native, use:<syntaxhighlight lang="nix">
+</syntaxhighlight>Alternatively, the package can be installed per-user with <code>users.users.<USER>.packages</code> or [[Home Manager|home-manager]]. For nix native, use:<syntaxhighlight lang="nix">
 users.users.<USER>.packages = [
    pkgs.<LAUNCHER>
@@ Line 27: / Line 27: @@
 </syntaxhighlight>
-For [[home-manager]], use:<syntaxhighlight lang="nix">
+For [[Home Manager|home-manager]], use:<syntaxhighlight lang="nix">
 home.packages = [
    pkgs.<LAUNCHER>
@@ Line 35: / Line 35: @@
 == Troubleshooting ==
-=== Why does VulkanMod crash on NixOS? ===
+=== ATlauncher can't start instance ===
-Please Use Prismlauncher to use VulkanMod on NixOS instead of the Official Minecraft Launcher.
+By default, ATlauncher installs its own Java runtime in <code>**USERSDIR**/runtimes/minecraft</code>, which gets selected in the settings' <code>Java Path</code>.
-Right-click on the instance icon > Select Edit > Settings > Workarounds > Enable "Native libraries" > Choose "Use system installation of GLFW".
+To fix this, make sure to select the java version installed in the system store from the <code>Settings > Java/Minecraft > Java Path</code> menu and also disable the <code>Use Java Provided By Minecraft?</code> option.
-{{Note|1=Replace your <code>pkgs.prismlauncher</code> package with <code>(pkgs.prismlauncher.override { withWaylandGLFW = true; }</code> to get VulkanMod running on Wayland.}}
+If your instance still doesn't start, check the instance settings and apply the same changes there.
-=== Prismlauncher doesn't have Java Version XX. ===
+=== Prism Launcher doesn't have Java Version XX. ===
-The Prismlauncher package can be overridden with <code>(pkgs.prismlauncher.override { jdks = [ pkgs.<JAVA_PACKAGE> ]; })</code>. For example: <code>(pkgs.prismlauncher.override { jdks = [ pkgs.temurin-bin-21 pkgs.temurin-bin-8 pkgs.temurin-bin-17 ]; })</code>
+The [[Prism Launcher]] package can be overridden to add additional [[Java]] runtimes. Check [[Prism_Launcher#Advanced]] to see an example.
 === Minecraft can’t start without Java Version XX. ===
@@ Line 60: / Line 60: @@
 |>= 1.18
 |17
+|-
+|>= 1.20.5
+|21
 |}