Minecraft

This article or section needs language, wiki syntax or style improvements. See
Help:Style
for reference.
Reason:
Does not follow the conventional format for most pages, encapsulates a lot of different software, which gets highly confusing whether this is a minecraft install guide or whether this is a package page
These guides and troubleshooting should be split off into dedicated pages to be more clear. Compressing them all into a single page is messy and hard to find the information you want.
The page would benefit from the use of a "software" category, listing all the software, and linking to the dedicated page if there is one for it.
(Discuss in
Talk:Minecraft
)
Minecraft
is a game about breaking and placing blocks. At first, people built structures to protect against nocturnal monsters, but as the game grew, players worked together to create wonderful, imaginative things.
There are two separate editions of this game: Minecraft Java Edition, and Bedrock Edition. Java Edition is the original version of the game, starting development back in 2009. This edition can be played on Mac, Windows and Linux. Bedrock Edition was originally Pocket Edition, but has since been ported to different platforms. It is currently supported on Windows 10 and 11, Amazon FireOS and FireTV, Android, iOS, Xbox One, Playstation 4, Nintendo Switch and Samsung Gear VR devices. The Bedrock Edition client is not supported on Linux officially, but Bedrock server software is available.
Client
Java Edition
Installation
The Minecraft client can be installed via the
minecraft-launcher
AUR
package. It provides the official game launcher, a script to launch it and a
.desktop
file. The package is officially recommended by Mojang on their website.
Firewall configuration for Client/LAN worlds
Most shared Minecraft worlds are hosted using dedicated Minecraft servers. For more information about hosting dedicated servers, see the
#Server
section below.
A simpler way is to allow others to join your current Minecraft game. When playing, your Minecraft client also allows others to join the game in progress. Your client automatically broadcasts the info about your game on port 4445. It will also listen for TCP connections on which other players join. This TCP listening port is picked at random every time you start Minecraft. This works well if you do not have a firewall. But if your firewall blocks incoming TCP connections, then it is very tricky to allow this random port in.
To allow your client to host a local LAN game, your
firewall
needs to allow:
UDP port
4445
to broadcast your game.
A TCP port to allow friends to join your game.
Tip
After a world has been opened to LAN, a confirmation message will be sent to the game's chat with the TCP port number. For example:
Local game hosted on port
port_number
.
See also:
Setting up a LAN world
.
Bedrock Edition
The unofficial Bedrock Minecraft client can be installed by
mcpelauncher-ui
AUR
package, which is the UI interface for
mcpelauncher-linux
AUR
.
Server
Java Edition
See
Minecraft/Java Edition server
for more information on how to set up a Minecraft Java server.
Bedrock Edition
Installation
The Bedrock Minecraft server can be installed via the
minecraft-bedrock-server
AUR
package. It provides a
systemd
unit file. This package creates a separate
minecraft-bedrock
account.
To start the server, you may either use systemd or run it directly from the command line. Using systemd, you may
start
and
enable
the included
minecraft-bedrock-server.service
. Alternatively, run the following as the minecraft-bedrock user inside the
/opt/minecraft-bedrock-server
directory:
$ LD_LIBRARY_PATH=. ./bedrock_server
Configuration
The configuration file
server.properties
contains the server settings and additional documentation. Most importantly,
server-port
determines the
UDP
port at which the server will listen for incoming connections. The default port is
19132
for IPv4, and
19133
for IPv6. UDP ports
43351
for IPv4 and
51885
for IPv6 are required for authentication.
Minecraft mod launchers
You can launch Minecraft from different so called
launchers
that often include an array of modpacks to enhance one's gameplay and add
mods
.
ATLauncher
— Minecraft ModPack launcher consisting of multiple different modpacks made by the community.
https://atlauncher.com/
||
atlauncher
AUR
Badlion Client
— PvP modpack for all modern versions of Minecraft.
https://client.badlion.net
||
badlion-client
AUR
CheatBreaker Client
— The free FPS boosting modpack for Minecraft 1.7 & 1.8
https://cheatbreaker.net/
||
cheatbreaker
AUR
Feed The Beast
— Originated as a custom challenge map in Minecraft that made heavy use of multiple tech mods, and later evolved into a mod package launcher.
https://www.feed-the-beast.com/
||
ftb-app
AUR
,
feedthebeast-classic
AUR
GDLauncher Carbon
— Open-source Minecraft launcher written in Electron/React.
https://gdlauncher.com/
||
gdlauncher-carbon-bin
AUR
Hello Minecraft Launcher
— Open-source Minecraft launcher supports Mod Management, Game Customizing, Auto Installing, Modpack Creating, UI Customization...
https://github.com/HMCL-dev/HMCL
||
hmcl
AUR
Labymod Launcher
— LabyMod Launcher for launching LabyMod, which is a Minecraft client that adds bunch of useful features
https://www.labymod.net/
||
labymodlauncher-appimage
AUR
and
labymodlauncher
AUR
LauncherX
— Next generation Minecraft launcher with powerful features and pleasing UI.
https://corona.studio/lx
||
launcherx-bin
AUR
Lunar Client
— PvP modpack for all modern versions of Minecraft.
https://lunarclient.com
||
lunar-client
AUR
Modrinth Launcher
— The open-source, lightweight and official Modrinth launcher.
https://modrinth.com/
||
modrinth-app
AUR
MultiMC
— Sandbox environment manager for separable pack association.
https://multimc.org/
||
multimc-bin
AUR
PolyMC
— Power user launcher with features like mod management. Originally forked from MultiMC.
https://polymc.org/
||
polymc
AUR
,
polymc-qt5
AUR
portablemc
— Cross platform command line utility for launching Minecraft quickly and reliably with included support for Mojang versions and popular mod loaders such as Fabric, Forge, NeoForge and derived.
https://github.com/theorzr/portablemc
||
portablemc
AUR
Prism Launcher
—  Power user launcher with features like mod management. Originally forked from MultiMC, now forked from PolyMC.
https://prismlauncher.org/
||
prismlauncher
SKlauncher
— A free Minecraft Launcher supporting skins and capes.
https://skmedix.pl
||
sklauncher-bin
AUR
Technic Launcher
— Modpack installer with a focus on mod discovery via popularity rankings.
https://www.technicpack.net/
||
minecraft-technic-launcher
AUR
Other programs and editors
There are several
programs and editors
which can make your Minecraft experience a little easier to navigate. The most common of these programs are map generators. Using one of these programs will allow you to load up a Minecraft world file and render it as a 2D image, providing you with a top-down map of the world.
AMIDST
— Standing for Advanced Minecraft Interface and Data/Structure Tracking, it is a program that aids in the process of finding structures, biomes, and players in Minecraft worlds. It can draw the biomes of a world out and show where points of interest are likely to be by either giving it a seed, telling it to make a random seed, or having it read the seed from an existing world (in which case it can also show where players in that world are). The project has been forked in the past, of which the most notable one is "Amidst Exporter" (
amidstexporter
AUR
) which includes a patch for calculating Ocean Monument locations in 1.8+ worlds.
https://github.com/toolbox4minecraft/amidst
||
amidst
AUR
Mapcrafter
— A high performance Minecraft map renderer written in C++ which renders worlds to maps with an 3D-isometric perspective. You can view these maps in any webbrowser hence they are easily deployed on one's server. Mapcrafter has a simple configuration file format to specify worlds to render, different rendermodes such as day/night/cave and can also render worlds from different rotations.
https://github.com/mapcrafter/mapcrafter
||
mapcrafter-git
AUR
MCA Selector
— An external tool to export or delete selected chunks and regions from a world save of Minecraft Java Edition.
https://github.com/Querz/mcaselector
||
mcaselector
AUR
Minutor
— A minimalistic map generator for Minecraft. You are provided with a simple GTK based interface for viewing your world. Several rendering modes are available, as well as custom coloring modes and the ability to slice through z-levels.
http://seancode.com/minutor/
||
minutor-git
AUR
Tips and tricks
Enable HRTF directional audio support
Edit the following file and then enable directional audio in the in-game sound settings:
~/.alsoftrc
hrtf=true
Troubleshooting
Client or server does not start
It might be a problem with the
Java
version. Different Minecraft version numbers have different JRE requirements.
Minecraft Version
Minimum Compatible JRE Version
< 1.17
8
1.17
16
1.18 - 1.20.4
17
1.20.5 - 1.21.11
21
>= 26.1
25
Note
Note that the client/server work with newer versions of
Java
, such as
jre-openjdk
, but the Minecraft game launcher (and possibly mods) might only work with
Java
version 8.
If running an old Minecraft version, it is also recommended to run it with its potentially old "Minimum Compatible JRE Version". For example, the 1.20.1 is compatible with the JRE 17 and 21, but not with the JRE 24.
Tip
When multiple Java environments are installed, one can switch between them using
archlinux-java
.
Broken fonts with MinecraftForge
Force Unicode fonts from the language menu.
Since you cannot read any of the menu options: in the main menu, choose the bottom-left most button is Options, second-from-the-bottom on the left side is the Language Button. From there, the Force Unicode Font button is on the bottom, on the left side.
Cannot change pulseaudio sink
If you are unable to switch the audio output device (indicated by
DONT_MOVE
flag in the output of
pacmd list-sink-inputs
), then the following openalsoft config may help
~/.alsoftrc
[pulse]
allow-moves=yes
Audio missing/stutters on PipeWire or Java crashes with SIGFPE
OpenAL defaults to using JACK over PipeWire's PulseAudio backend. If that causes issues for you, you can tell OpenAL to use Pulse instead:
~/.alsoftrc
drivers=pulse
Alternatively, you can set the environment variable
ALSOFT_DRIVERS=pulse
for Minecraft if you do not want to configure this for all applications.
Minecraft does not start on native Wayland
You may see an error like
GLFW error 65548: Wayland: The platform does not support setting the window icon
.
This is because of the version of GLFW bundled with Minecraft defaulting to X. If you do not want to use
Xwayland
, you can resolve this by using the system installation of
glfw
:
For MultiMC-based launchers (like
prismlauncher
) check
Workarounds > Native Settings > Use system GLFW
in the instance settings.
For others, add
-Dorg.lwjgl.glfw.libname=/usr/lib/libglfw.so
to the java command in the settings.
Warning
Native Wayland is not officially supported and the Forge and NeoForge mod loaders may not launch at all.
Note
There is a bug present which will prevent the cursor from being centered when opening menus, leading to a suboptimal experience. This can be fixed by installing
glfw-wayland-minecraft-cursorfix
AUR
.
You can use
VulkanMod
to add native support for Wayland.
2 and 6 do not work when pressed in combination with shift on legacy versions
This is a problem caused by LWGLJ2. There are a few ways to fix it:
Use a client that uses an updated version of LWGLJ or adds the patch themselves.
Switch keyboard layout to a different one (e.g. German).
Use mods to fix it. On 1.8.9 Forge, you can use
mckeyboardfix
.
See also
Official Minecraft site
Minecraft community links
Minecraft Wiki
Minecraft Client and Server download link
Crafting Recipes
Block and item data values
Reddit Minecraft community
Minecraft Skins