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 1: / Line 1: @@
-[https://www.minecraft.net/about-minecraft Minecraft] is a sandbox game about building, surviving, fighting, and being creative, developed by Mojang Studios.<ref>[https://www.minecraft.net/en-us/about-minecraft https://www.minecraft.net/about-minecraft]</ref>
+[https://www.minecraft.net/about-minecraft Minecraft] is a sandbox game about building, surviving, fighting, and being creative, developed by Mojang Studios.<ref>[https://www.minecraft.net/en-us/about-minecraft https://www.minecraft.net/about-minecraft]</ref> [https://www.minecraft.net/about-minecraft Minecraft] currently has two supported variants known as:
-[https://www.minecraft.net/about-minecraft Minecraft] has two variants: "Minecraft: Java Edition" and "Minecraft: Bedrock Edition".
 * 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.<ref>https://www.minecraft.net/article/java-or-bedrock-edition</ref><ref>[https://learn.microsoft.com/en-us/windows/uwp/get-started/universal-application-platform-guide https://learn.microsoft.com/windows/uwp/get-started/universal-application-platform-guide]</ref>
 == Launchers ==
-'''Offical Minecraft Launcher:''' [https://www.minecraft.net/download Website] — [https://search.nixos.org/packages?show=minecraft Package/pkgs.minecraft] {{note|1.19 or higher is not working on NixOS, using alternative clients is strongly recommended.}}
+'''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 24: / Line 21: @@
    pkgs.<LAUNCHER>
 ];
-</syntaxhighlight>Alternatively, the package can be installed per-user with <code>users.users.<USERNAME>.packages</code> or [[home-manager]].
+</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 = [
-For nix native, use:<syntaxhighlight lang="nix">
-environment.systemPackages = [
    pkgs.<LAUNCHER>
 ];
 </syntaxhighlight>
-For home-manager, use:<syntaxhighlight lang="nix">
+For [[Home Manager|home-manager]], use:<syntaxhighlight lang="nix">
 home.packages = [
    pkgs.<LAUNCHER>
@@ Line 40: / Line 35: @@
 == Troubleshooting ==
-=== Prismlauncher doesn't have Java Version XX. ===
+=== ATlauncher can't start instance ===
-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>
+By default, ATlauncher installs its own Java runtime in <code>**USERSDIR**/runtimes/minecraft</code>, which gets selected in the settings' <code>Java Path</code>.
+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.
+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. ===
@@ Line 58: / Line 60: @@
 |>= 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.
+[[Category: Applications]]
+[[Category: Gaming]]