Achtung: Es gibt nun mit Docker eine bessere Möglichkeit Minecraft 1.19 und höher auf einem Rasperry Pi zu installieren. Hier geht es zur neuen Anleitung.

Ich wollte seit langer Zeit wegen den geringen Kosten einen Minecraft Server 1.16 auf dem neuen Raspberry Pi 4 mit 4 GB (günstig kaufen) installieren. So ein Server muss stabil 24 Stunden am Tag durchgängig laufen, damit man damit Spaß haben kann. Deswegen habe ich diese Anleitung geschrieben, in dem genau dieses Endziel beschrieben wird. Der Server ist für die JAVA-Version von Minecraft.

Unsere Minecraft-Welt ist mittlerweile stolze 150 MB groß und hat seit ihrem Debüt auf der Xbox 360 bis heute überlebt. Aus diesem Grund möchte ich ab und zu ohne viel Konfiguration oder Geld zu bezahlen, die Welt weiter gestalten.

Kompatibilität der Minecraft Clients mit den Servern

Die Bedrock-Edition läuft auf Konsolen und Mobilgeräten, nicht aber auf macOS – da gibt es bis heute keinen offiziellen Client. Sie wurde mit Steuerung per Controller entwickelt, was sie ideal für Konsolen macht. Leider kann die Nintendo Switch kann ohne Hacks nicht mit einem eigenen Bedrock-Server verbunden werden. Sie unterstützt nur die offiziellen Realms*. Der dedizierte Bedrock-Server ist zwar noch offiziell in der Beta, läuft aber deutlich performanter als der Java-Edition – allerdings nur auf x86-Systemen. ARM-Geräte wie der Raspberry Pi sind außen vor. Wichtig: Java- und Bedrock-Spieler können nicht zusammen spielen.

Client	Bedrock Server	Java Server
Android	✅	❌
iOS	✅	❌
XBOX Series/XBOX One	✅	❌
Nintendo Switch	(✅)*	❌
PlayStation 4/5	✅	❌
XBOX 360	❌	❌
PlayStation 3	❌	❌
Windows Java	❌	✅
Windows Bedrock-Edition	✅	❌
Linux	❌	✅
macOS	❌	✅

Welche Minecraft-Version wird unterstützt?

Diese Version für den Raspberry Pi in diesem Artikel funktioniert nur für die aktuelle JAVA-Version von Minecraft für Mac und PC. Wer den Server für die Xbox, PlayStation 4, iOS und Android Version aufsetzen möchte, der nutzt meine Anleitung für einen Minecraft Bedrock-Server.

Spigot, Bukkit, Vanilla oder Paper?

Der Spigot-Fork „Paper“ dient als Grundlage. Paper ist ein auf Geschwindigkeit optimierter Fork des Spigot Minecraft-Servers, die darauf abzielt, Gameplay und mechanische Inkonsistenzen zu beheben und die Leistung zu verbessern. Ohne Paper könnten wir den Minecraft-Server nicht performant auf dem Pi betreiben. Paper funktioniert genau so wie ein normaler Minecraft-Server mit der jeweils aktuellen Version von Minecraft. In diesem Artikel beschreibe ich wie man auf dem Pi den Minecraft Server Paper als „headless server“ stabil betreibt. Das heißt, der Pi kann irgendwo in der Nähe des Routers ohne Maus und Tastatur betrieben werden.

Welche Hardware benötigt man?

1. Einen Raspberry Pi 4 mit 4 GB RAM – günstig kaufen
2. Ein USB-C Netzteil für den Pi4 – nicht sparen!
3. Eine schnelle (!) micro SD-Karte – auch nicht sparen!
4. Ein schönes Gehäuse für den Pi4 – günstig kaufen
5. Optional: ein Synology NAS für Backups – kaufen

Welche Software wird benötigt?

1. Raspberry Pi OS Lite (Betriebssystem für den Pi)
2. etcher (Tool zum Schreiben von SD Karten)
3. Die Shell (beim Mac dabei) oder PuTTY für Windows.

Anleitung Schritt für Schritt

Der Weg zum eigenen Server auf dem Raspberry Pi ist simpel. Einfach jeden Schritt genau durchlesen oder das Video anschauen. Da jeder Raspberry Pi absolut gleich ist, sollte jeder Schritt genau so bei euch umsetzbar sein. Zudem haben viele andere Menschen es auf diesem Wege ebenso hinbekommen.

https://www.youtube.com/watch?v=t1cr2UasuhQ

Schritt 1: Schreiben der MicroSD Karte und SSH aktivieren

1. Schreibt mit etcher die img-Datei von Raspberry Pi OS Lite auf die SD-Karte.
2. Karte einmal aus dem Schreib-Lesegerät raus und wieder reinstecken.
3. Legt eine leere Datei namens ssh (ohne Dateiendung!) per Computer auf die SD-Karte in der Partition „boot“. Das aktiviert den SSH Zugang.
4. Die microSD Karte in den Raspberry Pi einstecken und diesen per Netzwerkkabel ins lokale Netzwerk hängen. Den Pi an den Strom anschließen.

Schritt 2: Login per SSH

Per Shell oder Putty mit SSH auf den Pi wechseln. Die IP des Pi sieht ihr in eurem Router unter Netzwerkgeräte oder ihr verwendet raspberrypi als Hostname. Das Passwort lautet „raspberry“. Wenn das geklappt hat, dann haben wir den schwierigsten Teil hinter uns gelassen. Beispiel mit meiner IP:

ssh pi@raspberrypi

Falls es hier ein Problem gibt, probiert es mit der IP-Adresse statt dem Hostnamen raspberrypi. Wenn es dann immer noch Probleme gibt, habt ihr entweder vergessen, SSH zu aktivieren oder das Netzwerkkabel steht nicht drin oder hat keine Verbindung.

Schritt 3: Konfiguration von Rasperian

Mit dem folgenden Befehl startet ihr das Rasperian Konfigurationstool. Dort unter Interfacing Options kann man unter SSH den Zugang aktivieren und unter Localisation Options die korrekte Timezone setzen. Das ist wichtig für die cronjobs.

sudo raspi-config

Schritt 3: Installation von Paper

Für die einfache Installation hat James A. Chambers ein Script geschrieben, das uns diesen Schritt enorm erleichtert. Das wird mit wget von github gezogen, mit Schreibrechten versehen und dann ausgeführt. Das Script installiert Java 9 und den aktuellen Minecraft Paper Server. Ausgeführt wird es nun in drei Schritten. Jeder Schritt ist jeweils eine Zeile auf der Kommandozeile.

wget -O SetupMinecraft.sh https://raw.githubusercontent.com/mtoensing/RaspberryPiMinecraft/master/SetupMinecraft.sh

chmod +x SetupMinecraft.sh

./SetupMinecraft.sh

Schritt 4: Starten und Optimieren des Servers

Der Server kann nun direkt gestartet werden. Das Script das für liegt im Verzeichnis ~/minecraft. Erreichbar ist der Minecraft Server nun unter der IP-Adresse des Raspberry Pi.

Achtung: Bitte einmal den Server starten damit die Konfigurationsdateien geschrieben werden, die wir im nächsten Schritt editieren.

cd ~/minecraft
./start.sh

Zusätzlichen weisen wir mehr Speicher von der GPU dem Server zu. Schließlich haben wir bei diesem Projekt keinerlei grafische Ausgabe. Die System-Konfigurationsdatei editiert man mit dem Nano-Editor:

sudo nano /boot/config.txt

Diese Zeilen kommen ganz ans Ende dieser Datei:

gpu_mem=16

Synology: Isometrische Minecraft-Karten mit Docker rendern

Schritt 5: Minecraft Server konfigurieren

Es gibt eine Datei in ~/minecraft/server.properties. Dort habe ich vorerst die Anzahl der Spieler auf 3 gesetzt und die Whitelist eingeschaltet. Wenn ihr auf die Kommandozeile des Servers wollt, dann geht das der über die mit start.sh gestartete Screen-Session.

Dort kann man dann die Whitelist verwalten oder die Tageszeit auf dem Server beeinflussen. Mit dem Befehl timings report seht ihr detaillierte Metriken zur Auslastung des Servers. Mit STRG+A und dann STRG-D verlässt man den Screen dann wieder.

screen -r minecraft

Schritt 6: Freigeben des Servers über das Internet

Ich nutze eine Fritzbox. Dort kann man unter den Einstellungen Internet > Freigaben -> Portfreigaben eine Adresse einrichten, über die man die Fritzbox außerhalb des eigenen Netzwerks erreichen kann. Unter Internet > Freigaben > Gerät für Freigaben hinzufügen > [Gerät auswählen] > Neue Freigabe > Portfreigabe den Port „25565“ freigeben. Das bedeutet, dass der Port von außen an dieses interne Gerät weitergereicht wird.

Die MyFritz-URL ist dann die Server-Adresse, die man in Minecraft einträgt. (z.B. qbnsepjzhd8cvzk7y.myfritz.net) Ohne http und ohne Portnummer am Ende.

Hinweis für IPv6 Kunden

Viele Router laufen schon über IPv6 oder DS-Lite. Das bedeutet, dass die Portfreigabe komplizierter ist. Einfacher ist es beim Internetprovider anzurufen und sagen, dass man gerne auf eine IPv4 Anbindung wechseln möchte. Die Begründung sollte sein, dass IPv4 für einen beruflichen Dienst benötigt wird. Danach schaltet man unter „Internet“ -> „Zugangsdaten“ -> „IPv6“ auf „native IPv4 Anbindung“ um und erstellt dann die Portfreigabe.

Schritt 7: Automatischer Start beim Neustart

Über die crontab kann man nicht nur den Pi und somit den Minecraft-Server regelmäßig neustarten, sondern ebenfalls reboot den Minecraft Server starten. Dafür einfach den Inhalt der Datei crontab in die Cron Tabelle kopieren. Der Befehl zum editieren der crontab lautet:

crontab -e

Optional: Serverneustart nach 12 Stunden

Meine Erfahrung mit Minecraft Servern ist, dass man sie zur Sicherheit regelmäßig sauber neu startet. Dabei werden alle Daten im Arbeitsspeicher auf die SD-Karte geschrieben und gehen bei einem Absturz nicht verloren. Ich bin dann so weit gegangen, dass sich erst der Paper Server runterfährt und dann der Pi komplett neugestartet wird.

Mein Repository auf GitHub enthält den letzten stabilen Stand.

Optional: Konfiguration Samba-Server für Backups

In Kurzform: Über Samba wird das Verzeichnis ~/minecraft/world im Netzwerk freigegeben. Danach kann das Verzeichnis im Synology NAS gemountet werden. Auf diesem Weg kann ein Task nächtlich die Inhalte in ein Verzeichnis kopieren, das über Cloud Sync mit der Dropbox verbunden ist.

Mit dem letzten Befehl editiert man die Samba-Konfiguration. Der Eintrag „read only“ muss von „yes“ auf „no“ gesetzt werden. Dann hat man die Möglichkeit über das Netzwerk alle relevanten Dateien auf dem Pi direkt zu bearbeiten ohne sich mit SSH anmelden zu müssen.

sudo apt install samba

sudo smbpasswd -a pi

# Editieren der Samba config. Was genau editiert werden muss, steht unten.
sudo nano /etc/samba/smb.conf

# Neustarten von Samba damit die Einstellungen übernommen werden.
sudo service smbd restart && sudo service nmbd restart

Hier der Inhalt meiner smb.conf

[homes]
   comment = Home Directories
   browseable = no

# By default, the home directories are exported read-only. Change the
# next parameter to 'no' if you want to be able to write to them.
   read only = no

Wie optimiere ich die Leistung des Servers?

„Can’t keep up! Is the server overloaded? Running 5190ms or 103 ticks behind“ ist eine Meldung, die man eventuell sofort nach dem ersten Start des Servers sieht. Der neue Server muss für die Spieler im laufenden Betrieb die Welt oder besser die „Chunks“ noch generieren. Das heißt, mit der Zeit wird die Geschwindigkeit deutlich besser.

Das Abschalten der Pillager Patrouillen hilft ebenfalls. Das sind Computergesteuerte Avatare, die permanent auf der Karte auftauchen und berechnet werden müssen. In der Datei „paper.yml“ kann man sie mit dem folgenden Befehl abschalten:

  disable-pillager-patrols: true

Java-Parameter einstellen

Wer einen Raspberry Pi 4 mit mehr als 1 GB besitzt, kann mit den beiden Parametern „Xms“ und „Xmx“ setzen. Diese setzt man in der Datei ~/minecraft/start.sh in der letzten Zeile. Mein Raspberry Pi 4 mit 4 GB Arbeitsspeicher nutzt mit folgenden Werten seinen Speicher besser aus:

/usr/bin/screen -dmS minecraft /usr/bin/java -jar  -Xms2400M -Xmx2400M /home/pi/minecraft/paperclip.jar

Diese Werte sind in der aktuellen Version bereits gesetzt. Wer noch weitergehen will, kann zusätzliche diese Parameter nutzen:

/usr/bin/screen -dmS minecraft /usr/bin/java -jar  -Xms2400M -Xmx2400M -XX:+UseG1GC -XX:+UnlockExperimentalVMOptions -XX:MaxGCPauseMillis=100 -XX:+DisableExplicitGC -XX:TargetSurvivorRatio=90 -XX:G1NewSizePercent=50 -XX:G1MaxNewSizePercent=80 -XX:G1MixedGCLiveThresholdPercent=35 -XX:+AlwaysPreTouch -XX:+ParallelRefProcEnabled -Dusing.aikars.flags=mcflags.emc.gs /home/pi/minecraft/paperclip.jar

Die Bedeutung der einzelnen Parameter wird bei Aikar.co erklärt.

Wie hoch ist die CPU-Last?

Während der Bedrock-Server sehr genügsam ist und selten über 5 % CPU Last verursacht, sorgt der Paper-Server schnell für 25 % und mehr CPU-Last. Da der Java-Server eine Single-Thread-Anwendung ist, wird bei einer Quad-Core-CPU wie in dem Synology DS420+ (kaufen) nur ein Viertel der vorhandenen Leistung genutzt. Bei mir geht die Leistung manchmal auch auf über 35 % CPU-Last. Das liegt entweder am Boost-Mode der CPU oder daran, dass der Paper-Server neben dem Haupt-Thread noch andere Dinge berechnet.

Konfiguration des Servers

Die Einstellungen für den Bedrock-Server müssen in Konfigurationsdateien vorgenommen werden. Diese wurden in den lokalen Verzeichnissen auf dem NAS erzeugt. Wichtig: Vor Änderungen den Server immer runterfahren bzw. den Container stoppen.

server.properties

Hier wird zum Beispiel eingestellt, ob eine Whitelist verwendet wird oder ob im Survival oder Creative-Modus gespielt wird:

gamemode=creative
force-gamemode=true

whitelist.json

Die whitelist.json sollte hingegen nicht manuell editiert werden. Um Benutzernamen der Whitelist hinzuzufügen, geht man auf die Kommandozeile im Terminal des Servers bzw. des Containers und gibt ein:

whitelist on
whitelist add BENUTZERNAME

BENUTZERNAME steht natürlich für den jeweiligen Account-Namen.

Ich erhalte eine Fehlermeldung

Wenn Du einen Fehler wie den folgenden siehst, solltest Du den Server aktualisieren.

The endpoint you downloaded this application from is no longer in service.

Wie aktualisiere ich den Server?

Wenn Du eine alte Version des Scriptes heruntergeladen hast, dann führe folgende Befehle über ssh aus auf dem pi:

# Ab ins Minecraft Verzeichnis
cd ~/minecraft

# Diese wget Befehle laden die aktuellen Versionen der Scripte von git  
wget -O restart.sh https://raw.githubusercontent.com/mtoensing/RaspberryPiMinecraft/master/restart.sh

wget -O start.sh https://raw.githubusercontent.com/mtoensing/RaspberryPiMinecraft/master/start.sh

wget -O start_lowspec.sh https://raw.githubusercontent.com/mtoensing/RaspberryPiMinecraft/master/start_lowspec.sh

# Die Scripte brauchen Rechte um ausführbar zu sein
chmod +x restart.sh start.sh start_lowspec.sh

# Nun können wir mit dem restart Script den Pi neustarten.
./restart.sh

# nach eine Neustart können wir den Server starten.
./start.sh

Diese Befehle laden die aktuelle Version des Skriptes runter und starten den Server neu und laden die aktuelle Version (z.Z. 1.16.2) runter. Wenn das nicht hilft, dann ist das nächste Kapitel die Lösung.

Wie starte ich eine alte Version von Minecraft?

Die eingesetzte Server-Software PaperMC ist nicht immer sofort auf dem neuesten Stand. Deswegen kann man in der Zeit einfach seinen Minecraft-Client mit einer alten Version starten. Dazu startet man den Minecraft Launcher und wählt oben im Menü „Installations“ und dann „New“ aus.

Dort kann man nun eine Installation anlegen mit einer älteren Version und diese beim Starten auswählen.

Der Server läuft stabil

Bislang hat der Server erstaunlich wenig Zicken gemacht. Insgessamt waren maximal 3 Personen gleichzeitig auf dem Server und der Pi hat das sehr gut weggesteckt.

Ich bin kein Systemadministrator und es gibt sicherlich einiges an dieser Anleitung zu optimieren. Für Korrekturen und Verbesserungen bin ich dankbar. Gerne auch direkt auf GitHub.

Als Tipp: Der neue schnellere Raspberry Pi 4 mit 4 GB ist ideal für dieses Projekt und aktuell günstig zu haben. Wem die Leistung des Raspberry Pi nicht reicht, der nutzt einfach meine Anleitung für einen Minecraft-Server auf einem Synology NAS.