Die Fehlermeldung enthält die Antwort bereits: Steht dort class file version 65.0, verlangt die Datei Java 21. Die Rechnung ist immer dieselbe — Zahl minus 44 ergibt die Java-Version. Wichtiger als die Zahl ist aber die Frage, wessen Datei gemeint ist: In den meisten Fällen ist nicht der Server zu alt, sondern ein einzelnes Plugin zu neu.

Die Meldung lesen

Eine typische Zeile sieht so aus:

java.lang.UnsupportedClassVersionError: com/example/PluginMain has been compiled by a more
recent version of the Java Runtime (class file version 65.0), this version of the Java Runtime
only recognizes class file versions up to 61.0

Darin stecken drei Angaben:

  1. com/example/PluginMain — wer den Fehler verursacht. Ein Plugin- oder Mod-Name hier bedeutet: diese eine Datei passt nicht, der Server selbst ist in Ordnung.
  2. class file version 65.0 — was verlangt wird: 65 − 44 = Java 21.
  3. only recognizes … up to 61.0 — was läuft: 61 − 44 = Java 17.

Übersetzt: Ein für Java 21 gebautes Plugin liegt auf einem Server, der mit Java 17 läuft.

Umrechnungstabelle

class file version Java-Version
52.0 Java 8
55.0 Java 11
60.0 Java 16
61.0 Java 17
65.0 Java 21
69.0 Java 25

Die Zahlen stammen aus der offiziellen JVM-Spezifikation. Der Abstand von 44 ist dort seit Java 1.0 konstant — du kannst also jede künftige Version selbst ausrechnen, ohne die Tabelle zu erweitern.

Merke: Eine Java-Laufzeit versteht immer alle älteren Klassendateiversionen, aber nie eine neuere. Deshalb läuft ein Java-8-Plugin problemlos unter Java 21, umgekehrt aber nie.

Welche Java-Version braucht welche Minecraft-Version?

Minecraft-Version Benötigtes Java
bis 1.16.5 Java 8
1.17 – 1.17.1 Java 16 (praktisch Java 17)
1.18 – 1.20.4 Java 17
ab 1.20.5 Java 21
ab 26.0 Java 25

Bei uns musst du das nicht einstellen. Wir leiten die Laufzeit aus der Minecraft-Version deines Servers ab und setzen sie automatisch. Bestellst du 1.21, bekommst du Java 21, ohne einen Schalter zu suchen.

Für Server-Forks wie Leaf und Leaves pflegen wir zusätzlich eine exakte Zuordnung je Release, statt die allgemeine Regel zu übernehmen. Der Grund: Ein Fork darf von der Vanilla-Anforderung abweichen, und eine optimistische Annahme würde genau dann danebenliegen, wenn es darauf ankommt. Findet sich für eine Kombination kein passendes Java, brechen wir den Vorgang bewusst ab, statt eine zu niedrige Laufzeit zu starten — ein Server, der gar nicht erst falsch startet, ist leichter zu reparieren als einer, der halb läuft.

Der häufigste Fall: ein Plugin, nicht der Server

Wenn dein Server bis eben lief und der Fehler nach dem Hinzufügen einer Datei auftrat, ist die Sache klar. Vorgehen:

  1. Klassennamen aus der Meldung notieren. Er nennt fast immer das Projekt.
  2. Beim Anbieter die passende Build-Variante suchen. Viele Plugins bieten getrennte Downloads für Java 17 und Java 21 an, oft mit dem Zusatz -java17 oder als eigener Release-Zweig. Die neueste Datei ist nicht automatisch die richtige.
  3. Gibt es keine passende Variante, brauchst du eine neuere Minecraft-Version — denn erst die bringt die neuere Laufzeit mit. Wie du die Version wechselst, ohne die Welt zu verlieren, steht in Minecraft-Server-Version wechseln.
  4. Plugin vorerst entfernen, wenn der Server dringend laufen muss. Wie du Plugins sauber hinzufügst und entfernst, zeigt Minecraft-Mods und Plugins installieren.

Der andere Fall: Java ist zu neu

Dieser Fall wird selten erklärt, tritt aber regelmäßig auf. Alte Forge-Modpacks — der Klassiker ist 1.12.2 — sind für Java 8 gebaut. Unter Java 21 scheitern sie, allerdings meist nicht mit UnsupportedClassVersionError, sondern mit Meldungen über fehlende interne Klassen oder abgelehnte Startparameter.

Merkmal: Das Pack lief früher, oder es läuft bei anderen, und dein Server nennt eine sehr alte Minecraft-Version. Die Lösung ist dann nicht neueres Java, sondern die zum Pack gehörende Minecraft-Version im Panel — damit setzen wir die passende ältere Laufzeit.

Ehrlicher Hinweis: Unsere automatische Korrektur greift in diesem Fall nicht. Sie repariert ausschließlich in Richtung „zu alt“, also wenn der Server ein neueres Java braucht als das laufende. Ein zu neues Java gilt bewusst nicht als Drift — sonst würde ein Kunde, der absichtlich eine ältere Laufzeit gewählt hat, sie automatisch wieder verlieren.

Was wir automatisch übernehmen

  • Passende Laufzeit ab Bestellung. Die Java-Version folgt der Minecraft-Version, ohne Einstellung.
  • Korrektur bei Versionswechsel. Wechselst du auf eine Version mit höherem Java-Bedarf, wird die Laufzeit mitgezogen.
  • Der Boot-Log schlägt die Rechnung. Nennt dein Server beim Start selbst eine benötigte Java-Version, die höher liegt als die laufende, korrigieren wir anhand dieser Messung — nicht anhand der Ableitung aus der bestellten Version. Eine Aussage des Servers über sich selbst ist belastbarer als jede Tabelle.
  • Eigene Images bleiben unangetastet. Läuft dein Server auf einer selbst gewählten Laufzeit, greifen wir nicht ein.
  • Fail-closed statt halb richtig. Existiert für eine Kombination kein passendes Java, brechen wir ab und melden es, statt eine falsche Laufzeit zu starten.

Troubleshooting

Symptom Prüfung Lösung
class file version 65.0 genannt, Klassenname ist ein Plugin Lief der Server vor dem Hinzufügen? Plugin-Build für deine MC-Version laden
Fehler direkt beim Serverstart, kein Plugin genannt Welche Minecraft-Version läuft? Version und Laufzeit gleichziehen
Altes 1.12.2-Modpack startet nicht Nennt das Log fehlende interne Klassen? Java ist zu neu — passende MC-Version wählen
Nach Versionswechsel Fehler Trat er direkt nach dem Wechsel auf? Neustart abwarten; bleibt es, Support mit der vollständigen Zeile kontaktieren
Plugin lädt, aber Funktionen fehlen Steht im Log eine Warnung statt eines Fehlers? Andere Ursache — nicht die Java-Version

FAQ

Kann ich die Java-Version selbst umstellen?

Bei uns ist das nicht nötig: Sie ergibt sich aus der Minecraft-Version deines Servers. Brauchst du eine andere Laufzeit, ist der richtige Weg der Wechsel der Minecraft-Version — dann passt die gesamte Umgebung zusammen.

Ist neueres Java immer besser?

Nein. Für Minecraft ist die geforderte Version zugleich eine praktische Obergrenze: Serverkern, Mods und Plugins sind auf sie abgestimmt. Ein Sprung auf eine höhere Laufzeit „auf Verdacht“ bringt keinen Vorteil und bricht ältere Mods.

Warum läuft mein Plugin lokal, aber nicht auf dem Server?

Weil deine lokale Java-Installation neuer sein kann als die des Servers. Entscheidend ist die Laufzeit auf dem Server, nicht die auf deinem Rechner.

Woher weiß ich, mit welchem Java mein Server gerade läuft?

Die Meldung sagt es dir: only recognizes class file versions up to 61.0 bedeutet Java 17. Ohne Fehlermeldung nennt der Serverstart die Java-Version in den ersten Konsolenzeilen.

Muss ich nach einem Java-Wechsel meine Welt neu erstellen?

Nein. Die Laufzeit betrifft nur die Ausführung, nicht das Weltformat. Ein Wechsel der Minecraft-Version kann dagegen das Weltformat ändern — dafür vorher ein Backup anlegen.

Nächste Schritte

Läuft der Server wieder, aber langsam, hilft Minecraft-Server laggt: Watchdog-Timeout beheben weiter. Passt der Arbeitsspeicher nicht zur Modpack-Größe, rechnet der Minecraft-RAM-Rechner den Bedarf aus.

Du suchst einen Server, auf dem die Java-Version automatisch zur Spielversion passt? Auf Minecraft-Server mieten findest du die Tarife.

Quellen und Prüfstand

Prüfstand: 24. August 2026. Neue Minecraft-Versionen können neue Java-Anforderungen mitbringen; die verlinkten Quellen sind jeweils der aktuelle Stand.