Warum ist die richtige Java-Version wichtig?
Beim Einrichten eines Minecraft-Servers kann es vorkommen, dass du eine Fehlermeldung erhältst, die auf eine inkompatible Java-Version hinweist. Dies geschieht, wenn die Minecraft-Server-Software mit einer neueren Java-Version kompiliert wurde, als deine aktuelle Laufzeitumgebung unterstützt.
Typische Fehlermeldung
Ein Beispiel für eine solche Fehlermeldung:
java.lang.UnsupportedClassVersionError: net/minecraft/bundler/Main has been compiled by a more recent version of the Java Runtime (class file version 69.0), this version of the Java Runtime only recognizes class file versions up to 65.0
Diese Meldung bedeutet, dass deine installierte Java-Version nicht mit der vom Minecraft-Server benötigten Version übereinstimmt. Die Lösung ist ein Update auf die passende Java-Version.
Benötigte Java-Version ermitteln
Jede Java-Version hat eine eigene Class File Version, die angibt, welche Java-Version zum Ausführen erforderlich ist. Für ein direktes Ergebnis kannst du die vollständige Startmeldung in unseren Minecraft Java Version Checker einfügen. Er liest die benötigte und die aktuell erkannte Class-File-Version aus und schlägt ein gepinntes Docker-Image vor. Die folgende Tabelle zeigt die Zuordnung:
| Class File Version | Java-Version |
|---|---|
| 69.0 | Java 25 |
| 68.0 | Java 24 |
| 67.0 | Java 23 |
| 66.0 | Java 22 |
| 65.0 | Java 21 |
| 64.0 | Java 20 |
| 63.0 | Java 19 |
| 62.0 | Java 18 |
| 61.0 | Java 17 |
| 60.0 | Java 16 |
| 59.0 | Java 15 |
| 58.0 | Java 14 |
| 57.0 | Java 13 |
| 56.0 | Java 12 |
| 55.0 | Java 11 |
| 54.0 | Java 10 |
| 53.0 | Java 9 |
| 52.0 | Java 8 |
| 51.0 | Java 7 |
| 50.0 | Java 6 |
| 49.0 | Java 5 |
| 48.0 | Java 4 |
| 47.0 | Java 3 |
| 46.0 | Java 2 |
| 45.3 | Java 1.1 |
Falls dein Server die Fehlermeldung mit Class File Version 69.0 anzeigt, benötigst du mindestens Java 25.
Für aktuelle Paper-Versionen ist die praktische Kompatibilitätstabelle kürzer als die vollständige Class-File-Tabelle:
| Paper-/Minecraft-Version | Benötigte oder empfohlene Java-Version |
|---|---|
26.1 und neuer | Java 25 |
1.20 bis 1.21.11 | Java 21 |
1.17 bis 1.19 | Java 17 |
Ältere Modpacks können strengere Vorgaben machen. Die Minecraft-Version allein reicht deshalb nicht: Prüfe zusätzlich die Anforderungen des Modloaders und der konkreten Modpack-Version.
Docker-Image-Tag für itzg/minecraft-server prüfen
Falls du den Minecraft-Server in Docker betreibst, verwendest du möglicherweise das Image itzg/minecraft-server.
Für dieses Image gibt es verschiedene Tags mit unterschiedlichen Java-Versionen. Zum Zeitpunkt dieser Aktualisierung verwenden sowohl latest als auch stable Java 25. Diese beweglichen Tags können sich erneut ändern, wenn Mojang die Java-Basis anhebt.
Für einen aktuellen Paper-Server sieht eine bewusste Compose-Konfiguration so aus:
services:
mc:
image: itzg/minecraft-server:java25
environment:
EULA: "TRUE"
TYPE: PAPER
VERSION: "26.1"
Bei einem älteren Modpack pinnst du stattdessen das tatsächlich unterstützte Java-Tag. Ziehe das neue Image und erstelle den Container anschließend neu:
docker compose pull mc
docker compose up -d mc
docker compose logs -f mc
Eine Liste der verfügbaren Tags findest du in unserem Konfigurator für Minecraft: Java Edition-Server mit Docker.
Importiere deine compose.yml, wähle das passende Image-Tag aus und aktualisiere deine Datei entsprechend.
Java-Version auf deinem System überprüfen
Falls du deinen Minecraft-Server ohne Docker betreibst, kannst du deine aktuelle Java-Version mit folgendem Befehl in PowerShell (Windows) oder Terminal (macOS/Linux) überprüfen:
java -versionFalls die installierte Version nicht ausreicht, kannst du eine neuere Version installieren.
Zum Installieren von Java 25 verwende die folgenden Anweisungen:
- Windows: Lade bei Adoptium ein Java-25-JDK als 64-Bit-Paket für dein System herunter.
- macOS: Installiere ein Java-25-JDK mit deinem bevorzugten Paketmanager, zum Beispiel
brew install openjdk@25, und beachte die Link-Hinweise von Homebrew. - Linux: Folge der aktuellen Java-Installationsanleitung von Paper oder installiere ein Java-25-JDK deiner Distribution beziehungsweise von Adoptium.
Führe nach der Installation erneut java -version aus und bestätige, dass deine Shell die gewünschte Laufzeit auflöst.
Wenn du einen Docker-basierten Server betreibst, ändere nicht blind die Host-Laufzeit, sondern prüfe zuerst das verwendete Image-Tag. Das ist besonders bei älteren Mod-Stacks wichtig, die weiterhin Java 17 oder 21 brauchen, während aktuelle Paper-Versionen bereits auf Java 25 umgestellt wurden.
Fazit
Die richtige Java-Version ist entscheidend für den fehlerfreien Betrieb eines Minecraft-Servers. Falls du eine UnsupportedClassVersionError erhältst, prüfe die erforderliche Java-Version anhand der Class File Version und aktualisiere deine Installation entsprechend.
Durch die Nutzung der passenden Java-Version oder eines geeigneten Docker-Images kannst du deinen Server problemlos starten und betreiben.
Nächste Schritte
- Wenn du noch mitten im ersten Deployment bist, beginne mit dem Hetzner-Docker-Guide.
- Wenn der Server startet, Spieler aber nicht verbinden können, arbeite die Port-25565-Anleitung durch.
- Wenn du dich noch für einen Stack entscheiden musst, vergleiche Paper vs Vanilla vs Fabric vs Forge.
- Wenn deine Docker-Einrichtung stattdessen an Dateiberechtigungen scheitert, lies Permission denied bei itzg/minecraft-server beheben.