Minecraft-Plugin passt nicht zur Version: Java-, Paper- und API-Fehler beheben

Ein Minecraft-Plugin liegt als JAR-Datei (ein Java-Archiv) im Ordner plugins/ und ist immer für bestimmte Minecraft-Versionen, eine bestimmte Java-Version und meist auch für eine bestimmte Server-Software wie Paper oder Spigot gebaut. Passt eines davon nicht, lädt das Plugin gar nicht, schaltet sich selbst ab oder einzelne Funktionen fallen aus. Jeder Abschnitt unten behandelt eine konkrete Meldung: wie sie aussieht, was dahintersteckt und wie du sie behebst.

Die vollständige Meldung findest du in der Konsole oder unter Dateien in logs/latest.log. Lies auch die Zeilen davor, dort steht oft das betroffene Plugin. Die Java-Version wird bei uns automatisch passend zur Minecraft-Version gesetzt. Welche Versionen ein Plugin unterstützt, nennt seine Download-Seite. Bevor du die Version wechselst oder Konfigurations- und Weltdateien änderst, lege unter Sicherungen eine Sicherung an.

Plugin oder Server braucht eine neuere Java-Version (UnsupportedClassVersionError)

So sieht die Meldung aus:

[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins'
org.bukkit.plugin.InvalidPluginException: java.lang.UnsupportedClassVersionError: <Klasse> 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

Was dahintersteckt: Java-Programme werden für eine bestimmte Java-Version übersetzt. Die Datei aus der Meldung verlangt eine neuere Java-Version, als dein Server gerade verwendet. Die Zahlen verraten welche: Zahl minus 44 ergibt die Java-Version, 69 steht also für Java 25 und 65 für Java 21. Nennt die Meldung ein Plugin, startet dieses Plugin nicht. Betrifft sie die Server-JAR selbst, startet der ganze Server nicht.

So behebst du es:

1. Lies den Dateinamen nach Could not load plugin. Das ist die Datei, die nicht passt.
2. Lade auf der Plugin-Seite die Ausgabe, die für deine Minecraft-Version gebaut ist.
3. Ersetze die alte Datei unter Dateien im Ordner plugins/ und starte den Server neu.
4. Brauchst du genau diese Plugin-Ausgabe, stelle den Server unter Version auf die Minecraft-Version um, die sie verlangt. Die passende Java-Version wird bei uns automatisch pro Minecraft-Version gesetzt. Lege vorher eine Sicherung an.

Gut zu wissen: Der Ordner plugins/.paper-remapped ist eine Arbeitskopie von Paper. Ersetze die Datei immer direkt in plugins/.

Ausführlich: Welche Java-Version braucht dein Minecraft-Server?

Plugin ist für eine neuere Minecraft-Version gebaut (Unsupported API version)

So sieht die Meldung aus:

[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins/.paper-remapped'
org.bukkit.plugin.InvalidPluginException: Unsupported API version 26.1

Was dahintersteckt: Jedes Plugin bringt eine kleine Steckbrief-Datei mit, die plugin.yml. Darin steht unter api-version, für welche Server-Version es geschrieben ist. Ist diese Version neuer als dein Server, lädt Paper das Plugin gar nicht, etwa bei Unsupported API version 26.1 auf einem Server mit 1.21.11. Der Server startet, aber alles, was das Plugin leisten sollte, fehlt komplett: Befehle, Schutzregeln, Menüs.

So behebst du es:

1. Vergleiche die Zahl hinter Unsupported API version mit der Minecraft-Version deines Servers unter Version.
2. Filtere auf Modrinth oder SpigotMC die Downloads des Plugins nach deiner Minecraft-Version und lade die passende Ausgabe.
3. Ersetze die alte Datei unter Dateien im Ordner plugins/ und starte neu.
4. Gibt es keine passende Ausgabe, stelle den Server unter Version auf die Version um, die das Plugin verlangt. Lege vorher eine Sicherung an, denn die Welt wird dabei auf die neue Version umgestellt.

Gut zu wissen: Ändere die api-version nicht selbst in der Plugin-Datei. Das Plugin lädt dann zwar, nutzt aber Funktionen, die dein Server nicht hat, und fällt später mit anderen Fehlern aus.

Mehr dazu: Minecraft-Version und Modloader sicher wechseln

Älterer Paper-Server kann ein neues Plugin nicht umwandeln (Fatal error trying to convert)

So sieht die Meldung aus:

Fatal error trying to convert Geyser-Spigot <Version>:org/geysermc/geyser/platform/spigot/GeyserSpigotPlugin.class
java.lang.IllegalArgumentException: Unsupported class file major version 65

Was dahintersteckt: Paper in Version 1.19.4 oder älter wandelt Plugins beim Laden mit einem eingebauten Konverter um. Dieser Konverter kann keine Klassen lesen, die für Java 21 oder neuer übersetzt wurden (major version 65 steht für Java 21, 69 für Java 25). Das Plugin wird deshalb nicht geladen. Häufig trifft es Geyser: Dann können keine Bedrock-Spieler beitreten. Der Server selbst startet und Java-Spieler kommen weiter rein.

So behebst du es:

1. Lies den Namen nach trying to convert. Das ist das betroffene Plugin.
2. Willst du auf deiner Minecraft-Version bleiben, lade eine ältere Ausgabe des Plugins, die für genau diese Version gebaut wurde, und ersetze sie unter Dateien im Ordner plugins/.
3. Alternativ stellst du den Server unter Version auf Minecraft 1.20.5 oder neuer um. Neuere Paper-Builds lesen Java-21-Klassen. Lege vorher eine Sicherung an.
4. Starte neu und prüfe in der Konsole, ob das Plugin ohne Fehler lädt.

Gut zu wissen: Die Meldung erscheint oft mehrmals hintereinander, einmal je Klasse. Betroffen ist trotzdem nur das eine Plugin.

Ausführlich: Welche Java-Version braucht dein Minecraft-Server?

Plugin meldet: Diese Server-Version wird nicht unterstützt

So sieht die Meldung aus:

[Essentials] You are running an unsupported server version!
[DecentHolograms] Plugin will now be disabled.
This plugin does not support Paper servers!

Was dahintersteckt: Das Plugin prüft beim Start, auf welcher Minecraft-Version und welcher Server-Software es läuft. Steht beides nicht auf seiner Liste, warnt es oder schaltet sich ganz oder teilweise ab. Der Grund kann eine zu neue oder zu alte Version sein oder die falsche Server-Software. Der Server selbst läuft weiter.

So behebst du es:

1. Gib in der Konsole plugins ein. Grün angezeigte Plugins sind aktiv, rot angezeigte abgeschaltet.
2. Sieh auf der Plugin-Seite nach, welche Minecraft-Versionen und welche Server-Software unterstützt werden.
3. Lade die passende Ausgabe und ersetze die alte Datei unter Dateien im Ordner plugins/.
4. Gibt es keine, wähle unter Version eine Minecraft-Version, die das Plugin unterstützt. Verlangt es eine andere Server-Software, geht das über Software / Loader wechseln. Lege vorher eine Sicherung an.

Gut zu wissen: Bleibt das Plugin trotz Warnung grün, laufen meist die Grundfunktionen. Teste die Befehle, die du brauchst, und hole das Update, sobald es erscheint.

Paper kann ein älteres Plugin nicht an die Server-Version anpassen (PluginRemapper)

So sieht die Meldung aus:

[PluginRemapper] Encountered exception remapping plugins
java.util.concurrent.CompletionException: java.lang.RuntimeException: Failed to remap plugin jar 'plugins/<Plugin>.jar'

Was dahintersteckt: Neuere Paper-Versionen schreiben ältere Plugins beim Start automatisch auf die interne Struktur der aktuellen Minecraft-Version um. Dieses Umschreiben heißt Remapping, die fertigen Kopien legt Paper in plugins/.paper-remapped ab. Bei mindestens einem Plugin ist das fehlgeschlagen. Der Server startet weiter, das Plugin arbeitet aber womöglich gar nicht oder nur teilweise, oft ohne weitere Fehlermeldung.

So behebst du es:

1. Lies den Dateinamen hinter Failed to remap plugin jar.
2. Steht im Namen etwas wie (1), liegt die Datei vermutlich doppelt im Ordner. Entferne die überzählige Kopie unter Dateien.
3. Lade eine Ausgabe des Plugins, die ausdrücklich für deine Minecraft-Version gebaut ist. Dann muss Paper gar nichts umschreiben. Ersetze damit die alte Datei in plugins/.
4. Starte neu und prüfe, ob die Meldung verschwunden ist.

Gut zu wissen: Gibt es keine passende Ausgabe, ist das Plugin für deine Server-Version noch nicht bereit. Entferne es oder warte auf ein Update.

Doppelte Dateien: Plugin-Datei beschädigt, doppelt oder gar kein Plugin

Unbekannter Block- oder Item-Name in einer Plugin-Konfiguration (Unsupported key)

So sieht die Meldung aus:

Unsupported key: minecraft:bed

Was dahintersteckt: Minecraft führt jeden Block und jedes Item unter einem festen Namen der Form minecraft:<name>, dem sogenannten Registry-Schlüssel. Ein Plugin oder seine Konfiguration nennt einen Namen, den deine Minecraft-Version nicht kennt. Typisches Beispiel ist minecraft:bed: Seit 1.13 heißen Betten nach ihrer Farbe, etwa red_bed. Der Eintrag wird übersprungen, der Server und der Rest des Plugins laufen weiter.

So behebst du es:

1. Schau in der Konsole oder in logs/latest.log in die Zeilen vor der Meldung. Dort steht, welches Plugin gerade lädt.
2. Öffne unter Dateien die Konfiguration dieses Plugins im Ordner plugins/<Plugin>/ und suche den genannten Namen.
3. Ersetze ihn durch die aktuelle Bezeichnung, die findest du im Minecraft-Wiki. Konfigurationen im YAML-Format (.yml) sind empfindlich: Lass Einrückung und Anführungszeichen unverändert.
4. Starte den Server neu. Steht der Name nicht in deiner Konfiguration, sondern im Plugin selbst, hilft nur ein Plugin-Update.

Bei Fehlern in der Datei: Konfigurationsdatei eines Plugins ist fehlerhaft

Plugin braucht eine neuere Text-Bibliothek (Adventure) als dein Server

So sieht die Meldung aus:

Caused by: java.lang.ExceptionInInitializerError: Exception java.lang.TypeNotPresentException: Type net.kyori.adventure.text.TranslationArgument not present

Was dahintersteckt: Adventure ist die Bibliothek, mit der Paper farbige Chat-Texte, Titel und Hover-Texte erzeugt. Sie ist fest im Server eingebaut, ihre Version hängt also an deiner Minecraft-Version. Das Plugin wurde gegen eine neuere Adventure-Version gebaut, die genannte Klasse fehlt auf deinem Server. Teile des Plugins starten deshalb nicht. Der Server läuft weiter.

So behebst du es:

1. Finde heraus, welches Plugin betroffen ist. Im Stacktrace, also der Liste der at …-Zeilen unter der Meldung, steht oft der Name der JAR-Datei. Sonst helfen die Zeilen davor.
2. Lade eine ältere Ausgabe des Plugins, die für deine Server-Version gebaut ist, und ersetze die Datei unter Dateien im Ordner plugins/.
3. Oder stelle den Server unter Version auf eine neuere Minecraft-Version um. Lege vorher eine Sicherung an.

Gut zu wissen: Eine zusätzliche Adventure-Datei im Ordner plugins/ hilft nicht, weil Paper seine eingebaute Fassung verwendet.

ProtocolLib passt nicht zur Server-Version

So sieht die Meldung aus:

[ProtocolLib] INTERNAL ERROR: Cannot load ProtocolLib.
  If this problem hasn't already been reported, please open a ticket
  java.lang.IllegalArgumentException: Unable to find a field that matches …

Was dahintersteckt: ProtocolLib ist eine Hilfsbibliothek, über die andere Plugins Netzwerkpakete lesen und verändern. Dafür greift sie tief in die Interna des Servers, und die ändern sich mit fast jeder Minecraft-Version. Findet ProtocolLib die erwarteten Paketfelder nicht, lädt es nicht. Alle Plugins, die ProtocolLib brauchen, funktionieren dann ebenfalls nicht.

So behebst du es:

1. Lade den neuesten ProtocolLib-Build für deine aktuelle Minecraft-Version. Für ganz neue Versionen gibt es passende Builds oft zuerst als Vorabversion auf der Projektseite.
2. Ersetze die alte Datei unter Dateien im Ordner plugins/. Behalte nur eine ProtocolLib-Datei.
3. Starte den Server vollständig neu, also stoppen und wieder starten, nicht mit /reload.
4. Gib in der Konsole plugins ein und prüfe, ob ProtocolLib und die abhängigen Plugins grün sind.

Gut zu wissen: Die Bitte, ein Ticket bei ProtocolLib zu eröffnen, stammt vom Plugin selbst. Meist fehlt nur der passende Build.

Abhängige Plugins: Plugin braucht ein anderes Plugin, das fehlt

Citizens schaltet sich ab: Build passt nicht zur Minecraft-Version

So sieht die Meldung aus:

[Citizens] v<Version> (build <Nummer>) is not compatible with Minecraft <Version> - try upgrading or downgrading Citizens. Disabling.

Was dahintersteckt: Citizens ist ein Plugin für NPCs, also computergesteuerte Figuren wie Händler oder Quest-Geber. Jeder Citizens-Build unterstützt nur bestimmte Minecraft-Versionen und Server-Builds. Passt er nicht zu deinem Server, deaktiviert sich Citizens beim Start. Deine NPCs erscheinen dann nicht, und Plugins, die auf Citizens aufbauen, verlieren diese Funktion. Der Server selbst läuft weiter.

So behebst du es:

1. Prüfe unter Version, welche Minecraft-Version dein Server hat.
2. Lade den Citizens-Build für genau diese Version. Viele Citizens-Builds tragen SNAPSHOT im Namen, maßgeblich ist die Minecraft-Version, die die Download-Seite dazu nennt.
3. Ersetze die alte Datei unter Dateien im Ordner plugins/ und starte neu.
4. Gibt es keinen passenden Build, passe die Server-Version unter Version an. Lege vorher eine Sicherung an.

Gut zu wissen: try upgrading or downgrading bedeutet: Citizens kann zu alt oder zu neu sein. Die neueste Datei ist also nicht automatisch die richtige.

Plugin meldet: nicht kompatibel mit deiner Minecraft-Version

So sieht die Meldung aus:

[Citizens] v<Version> (build <Nummer>) is not compatible with your version of Minecraft. Disabling...
[<Plugin>] Plugin will be disabled!
Your MC version isn't supported

Was dahintersteckt: Das Plugin ist für eine andere Minecraft-Version oder Server-Software gebaut und meldet das selbst. Ähnliche Wortlaute sind This plugin only supports Spigot-API … oder Unable to load Adventure, chat components will not work. Je nach Plugin schaltet es sich ganz ab, oder einzelne Funktionen fallen aus, etwa farbige Chat-Texte. Der Server läuft weiter.

So behebst du es:

1. Lies den Plugin-Namen in den eckigen Klammern am Zeilenanfang. Fehlt er, steht er in den Zeilen davor.
2. Sieh auf der Plugin-Seite nach, welche Minecraft-Versionen und welche Server-Software es unterstützt.
3. Lade die passende Ausgabe und ersetze die alte Datei unter Dateien im Ordner plugins/.
4. Gibt es keine, stelle den Server unter Version auf die Version um, die das Plugin verlangt. Lege vorher eine Sicherung an.
5. Gib nach dem Neustart in der Konsole plugins ein und prüfe, ob das Plugin grün ist.

Gut zu wissen: Ein Wechsel auf eine neuere Minecraft-Version wandelt die Welt um. Zurück geht es zuverlässig nur über die Sicherung.

Plugin braucht einen neueren Paper-Build deiner Minecraft-Version

So sieht die Meldung aus:

[EntrypointUtil] Class io.papermc.paper.plugin.loader.library.impl.MavenLibraryResolver does not have member field 'java.lang.String MAVEN_CENTRAL_DEFAULT_MIRROR'
java.lang.NoSuchFieldError: …

Was dahintersteckt: Paper wird auch innerhalb einer Minecraft-Version laufend weiterentwickelt, jede Ausgabe heißt Build. Das Plugin greift auf ein Feld der Paper-API zu, und zwar in dem Teil, der beim Start Zusatzbibliotheken für Plugins herunterlädt. Dieses Feld (MAVEN_CENTRAL_DEFAULT_MIRROR) gibt es erst in neueren Builds. Auf deinem Build fehlt es, deshalb lädt das Plugin nicht. Der Server selbst läuft weiter.

So behebst du es:

1. Öffne im Panel Version und aktualisiere auf den neuesten Paper-Build deiner Minecraft-Version.
2. Starte neu und prüfe in der Konsole, ob das Plugin jetzt ohne Fehler lädt.
3. Willst du den Build nicht wechseln, nutze eine ältere Ausgabe des Plugins und ersetze die Datei unter Dateien im Ordner plugins/.

Gut zu wissen: Ein neuerer Build derselben Minecraft-Version ist ein kleiner Schritt. Die Welt bleibt dabei auf derselben Minecraft-Version. Eine Sicherung vorher schadet trotzdem nicht.

Plugin findet interne Server-Teile nicht (Failed to init reflection)

So sieht die Meldung aus:

Failed to init reflection: Index 3 out of bounds for length 3

Was dahintersteckt: Manche Plugins nutzen nicht nur die offizielle Schnittstelle des Servers, sondern lesen interne Klassen direkt über ihren Namen aus. Das nennt man Reflection. Diese Interna ändern sich mit fast jeder Minecraft-Version. Findet das Plugin nicht, was es erwartet, wurde es für eine andere Server-Version gebaut, und die davon abhängigen Funktionen fallen aus. Der Server läuft weiter.

So behebst du es:

1. Die Meldung selbst nennt kein Plugin. Schau in der Konsole oder in logs/latest.log in die Zeilen direkt davor. Dort steht, welches Plugin gerade geladen wurde.
2. Aktualisiere dieses Plugin auf eine Ausgabe für deine Server-Version und ersetze die Datei unter Dateien im Ordner plugins/.
3. Starte neu und prüfe, ob die Meldung verschwunden ist.

Gut zu wissen: Gibt es keine neuere Ausgabe, wird das Plugin vermutlich nicht mehr gepflegt. Dann lohnt sich ein aktuelles Ersatz-Plugin mit gleicher Funktion.

Leuchteffekte eines Plugins sind abgeschaltet (GlowingEntities)

So sieht die Meldung aus:

[GlowingEntities] [GlowingEntities] Glowing Entities reflection failed to initialize. The util is disabled. Please ensure your version (<Version>) is supported.
java.lang.NoSuchFieldException: MARKER

Was dahintersteckt: GlowingEntities ist kein eigenes Plugin, sondern ein Baustein, den andere Plugins mitbringen, um Spieler, Mobs oder Objekte leuchten zu lassen. Der Baustein findet ein internes Feld deines Server-Builds nicht. Deshalb sind die Leuchteffekte des betreffenden Plugins abgeschaltet. Der Server läuft weiter, und meist arbeitet auch das Plugin ohne die Effekte weiter.

So behebst du es:

1. Finde das Plugin, das GlowingEntities mitbringt. In den at …-Zeilen unter der Meldung steht ein Eintrag der Form <Plugin>.jar//….
2. Lade dieses Plugin in einer Ausgabe für deinen Paper-Build.
3. Ersetze die alte Datei unter Dateien im Ordner plugins/ und starte neu.

Gut zu wissen: GlowingEntities selbst kannst du nicht getrennt aktualisieren. Das erledigt der Entwickler des Plugins, in dem der Baustein steckt. Brauchst du die Leuchteffekte nicht, kannst du die Meldung bis zum nächsten Update ignorieren.

Simple_RTP: Köpfe im Menü werden nicht angezeigt

So sieht die Meldung aus:

[Simple_RTP] Failed to apply GUI head texture: IllegalArgumentException: Can not set net.minecraft.world.item.component.ResolvableProfile field org.bukkit.craftbukkit.inventory.CraftMetaSkull.profile to com.mojang.authlib.GameProfile

Was dahintersteckt: Simple_RTP ist ein Plugin für zufällige Teleports. Für die Köpfe in seinem Menü setzt es ein Spielerprofil im alten Format (GameProfile). Deine Minecraft-Version erwartet an dieser Stelle aber ein neueres Format (ResolvableProfile). Das passt nicht zusammen, deshalb funktionieren die Köpfe im Menü nicht. Der Server läuft weiter.

So behebst du es:

1. Prüfe unter Version, welche Minecraft-Version dein Server hat.
2. Lade Simple_RTP in der Ausgabe für diese Minecraft-Version.
3. Ersetze die alte Datei unter Dateien im Ordner plugins/ und starte neu.
4. Öffne das Menü im Spiel und prüfe, ob die Köpfe jetzt erscheinen.

Gut zu wissen: Die Meldung kann sich bei jedem Öffnen des Menüs wiederholen. Sie richtet keinen weiteren Schaden an, sie zeigt nur, dass die Plugin-Ausgabe veraltet ist.

ZNPCs: Gespeicherte NPCs passen nicht zur Plugin-Version

So sieht die Meldung aus:

io.github.gonalez.znpcs.commands.CommandExecuteException
No enum constant io.github.gonalez.znpcs.npc.<…>.PLAYER

Was dahintersteckt: ZNPCs speichert deine NPCs samt Typ und Aktionen in einer Datei. Darin steht ein Typ oder eine Aktion, die deine installierte ZNPCs-Version nicht kennt, zum Beispiel ActionType.PLAYER. Das passiert meist, wenn die NPCs mit einer anderen ZNPCs-Version angelegt wurden. Der ausgeführte Befehl bricht ab, der Server läuft weiter.

So behebst du es:

1. Lege unter Sicherungen eine Sicherung an.
2. Installiere die ZNPCs-Version, mit der die NPCs angelegt wurden, und starte neu.
3. Geht das nicht, stoppe den Server, öffne unter Dateien die Datei plugins/ZNPCs/data.json und entferne den betroffenen NPC-Eintrag. JSON ist ein Textformat mit Klammern und Kommas: Ein fehlendes Komma macht die ganze Datei unlesbar.
4. Starte den Server und teste den Befehl erneut.

Gut zu wissen: Bearbeite die Datei nur bei gestopptem Server. Läuft er, kann ZNPCs deine Änderung beim Beenden wieder überschreiben.

Plugin braucht Paper oder eine neuere Version (failed to register events)

So sieht die Meldung aus:

Plugin <Plugin> v<Version> has failed to register events for class <Klasse> because io/papermc/paper/event/<Ereignis> does not exist.

Was dahintersteckt: Plugins reagieren auf Ereignisse im Spiel, zum Beispiel wenn ein Spieler einen Block abbaut. Dieses Plugin will auf ein Ereignis hören, das deine Server-Software nicht kennt. Meist ist das Plugin für Paper geschrieben, der Server läuft aber mit Spigot. Oder das Ereignis gibt es erst in einer neueren Minecraft-Version. Der betroffene Teil des Plugins funktioniert nicht, der Server läuft weiter.

So behebst du es:

1. Lies den Namen nach because. Beginnt er mit io/papermc/paper oder com/destroystokyo/paper, braucht das Plugin Paper.
2. Läuft dein Server mit Spigot, stelle ihn unter Software / Loader wechseln auf Paper um. Plugins für Spigot laufen in aller Regel auch auf Paper. Lege vorher eine Sicherung an.
3. Läuft er schon mit Paper, ist das Ereignis neuer als deine Version. Nutze eine Ausgabe des Plugins für deine Minecraft-Version oder stelle den Server unter Version um.
4. Starte neu und prüfe, ob die Meldung verschwunden ist.

Mehr dazu: Server-Software und Version im Panel wechseln

Datei ist für eine neuere Java-Version gebaut (Unsupported class file major version)

So sieht die Meldung aus:

java.lang.IllegalArgumentException: Unsupported class file major version 69

Was dahintersteckt: Plugins, Mods und Bibliotheken werden für eine bestimmte Java-Version übersetzt. Die Zahl hinter major version verrät welche: Zahl minus 44 ergibt die Java-Version, 65 steht also für Java 21 und 69 für Java 25. Die Werkzeuge deines Servers, die Plugins und Mods beim Laden lesen oder umschreiben, verstehen diese neuere Version nicht. Der betroffene Teil wird nicht geladen.

So behebst du es:

1. Finde in den Zeilen davor heraus, welches Plugin oder welcher Mod gerade geladen wurde.
2. Lade dafür eine Ausgabe, die für deine Minecraft-Version gebaut ist, und ersetze die alte Datei unter Dateien im Ordner plugins/ bzw. mods/.
3. Alternativ aktualisierst du den Server unter Version auf eine neuere Minecraft-Version, die mit Java 21 oder neuer läuft. Die passende Java-Version wird bei uns automatisch gesetzt. Lege vorher eine Sicherung an.

Gut zu wissen: Steht direkt davor Fatal error trying to convert, gilt der Abschnitt über ältere Paper-Server weiter oben.

Ausführlich: Welche Java-Version braucht dein Minecraft-Server?

Altes Plugin sucht eine entfernte Chunk-Funktion (Legacy-IDs)

So sieht die Meldung aus:

java.lang.NoSuchMethodException: net.minecraft.world.level.chunk.Chunk.k(net.minecraft.core.BlockPosition)

Was dahintersteckt: Bis Minecraft 1.12 hatten Blöcke Zahlen-IDs, Stein war zum Beispiel die 1. Manche alte Plugins rechnen intern noch mit diesen Legacy-IDs und greifen dafür direkt auf interne Funktionen des Spiels zu, die Klassen unter net.minecraft. Die gesuchte Chunk-Funktion gibt es in deiner Version nicht mehr. Die Legacy-ID-Funktion des Plugins startet deshalb nicht. Je nach Plugin fallen damit einzelne oder viele Funktionen aus.

So behebst du es:

1. Schau in den Stacktrace unter der Meldung, also die at …-Zeilen. Dort steht der Name des Plugins oder seiner JAR-Datei.
2. Aktualisiere dieses Plugin auf eine Ausgabe für deine Minecraft-Version und ersetze die Datei unter Dateien im Ordner plugins/.
3. Gibt es keine, wird das Plugin für moderne Versionen nicht mehr gepflegt. Suche ein aktuelles Ersatz-Plugin.

Gut zu wissen: Der kurze Name k ist ein verschleierter interner Name. Solche Namen ändern sich mit jeder Minecraft-Version. Plugins, die sie direkt nutzen, brechen deshalb bei fast jedem Update.

Plugin nutzt eine veraltete Mojang-Profilfunktion (Spielerköpfe)

So sieht die Meldung aus:

java.lang.NoSuchMethodException: com.mojang.authlib.GameProfile.getProperties()

Was dahintersteckt: authlib ist die Bibliothek von Mojang, über die der Server Spielerprofile mit Name und Skin verwaltet. Das Plugin liest diese Profile über eine Methode (GameProfile.getProperties), die es in deiner Minecraft-Version nicht mehr gibt. Die betroffene Funktion fällt aus, meist sind es die Spielerköpfe in Menüs. Der Server läuft weiter.

So behebst du es:

1. Finde das Plugin: Sein Name oder der Name seiner JAR-Datei steht in den at …-Zeilen unter der Meldung oder in den Zeilen davor.
2. Lade eine Ausgabe dieses Plugins für deine Minecraft-Version.
3. Ersetze die alte Datei unter Dateien im Ordner plugins/ und starte neu.
4. Öffne das betroffene Menü im Spiel und prüfe, ob die Köpfe wieder erscheinen.

Gut zu wissen: Diese Änderung trifft viele Menü- und Kopf-Plugins gleichzeitig. Zeigen mehrere Plugins keine Köpfe mehr, liegt es meist an derselben Ursache, und jedes braucht sein eigenes Update.

Plugin sucht Blöcke, Partikel oder Attribute, die es in deiner Version nicht gibt

So sieht die Meldung aus:

java.lang.IllegalArgumentException: No enum constant org.bukkit.Material.<NAME>
Unknown material '<NAME>' for button
java.lang.NoSuchFieldError: Class org.bukkit.<Klasse> does not have member field '<Feld>'

Was dahintersteckt: Jede Minecraft-Version bringt neue Blöcke, Partikel und Attribute mit und benennt manche um. Das Plugin ist für eine andere Version gebaut und greift auf etwas zu, das es hier nicht oder nur unter anderem Namen gibt. Je nach Plugin erscheint der Fehler bei jeder Aktion, oder einzelne Funktionen fallen aus. Auch Could not initialize Brigadier mappings gehört dazu. Brigadier ist das Befehlssystem von Minecraft, das unter anderem die Tab-Vervollständigung liefert.

So behebst du es:

1. Lies den Plugin-Namen in den Zeilen davor oder in den at …-Zeilen darunter.
2. Lade die Ausgabe des Plugins, die zu deiner Minecraft-Version passt, und ersetze die Datei unter Dateien im Ordner plugins/.
3. Oder stelle den Server unter Version auf die Minecraft-Version um, die das Plugin verlangt. Lege vorher eine Sicherung an.
4. Steht der unbekannte Name in einer Konfigurationsdatei des Plugins, etwa bei Menüknöpfen, kannst du ihn dort durch die aktuelle Bezeichnung ersetzen.

Marriage-Plugin passt nicht zur Minecraft-Version

So sieht die Meldung aus:

[Marriage] Marriage is not compatible with the version of minecraft you are using
Marriage kissing will be disabled!

Was dahintersteckt: Marriage lässt Spieler im Spiel heiraten und bringt dazu Funktionen wie das Küssen mit. Das Plugin unterstützt deine Minecraft-Version nicht. Mindestens die Kuss-Funktion schaltet es deshalb ab, andere Teile können ebenfalls betroffen sein. Der Server läuft normal weiter.

So behebst du es:

1. Sieh auf der Plugin-Seite nach, ob es eine Marriage-Ausgabe für deine Minecraft-Version gibt. Deine Version siehst du unter Version.
2. Gibt es eine, ersetze die alte Datei unter Dateien im Ordner plugins/ und starte neu.
3. Gibt es keine, ersetze das Plugin durch ein aktuelles mit ähnlicher Funktion. Rechne damit, dass ein anderes Plugin die gespeicherten Daten von Marriage nicht übernimmt, und lege vorher eine Sicherung an.

Gut zu wissen: Stört dich nur die fehlende Kuss-Funktion und läuft der Rest, kannst du die Meldung ignorieren, bis ein Update erscheint.

Anticheat- oder Paket-Plugin kennt deine Minecraft-Version noch nicht vollständig

So sieht die Meldung aus:

java.lang.IllegalStateException: Unknown entity metadata type id: <Zahl> version V_<Version>

Was dahintersteckt: Manche Plugins lesen die Netzwerkpakete zwischen Spiel und Server mit, zum Beispiel das Anticheat GrimAC über die Bibliothek PacketEvents. Mit neuen Minecraft-Versionen kommen neue Datentypen für Kreaturen und Objekte hinzu, die Entity-Metadaten. Das Plugin kennt einen davon noch nicht, meist weil es älter ist als deine Server-Version. Betroffene Pakete werden falsch verarbeitet. Das kann Fehlalarme des Anticheats oder Verbindungsprobleme auslösen.

So behebst du es:

1. Aktualisiere das Plugin und, falls es als eigene Datei installiert ist, auch PacketEvents auf eine Version, die deine Minecraft-Version ausdrücklich unterstützt.
2. Starte den Server vollständig neu.
3. Gibt es noch keine passende Version, deaktiviere das Plugin vorübergehend: Benenne seine Datei unter Dateien um, etwa in <Plugin>.jar.off. Der Server lädt nur Dateien mit der Endung .jar.
4. Alternativ nutzt du unter Version eine Minecraft-Version, die das Plugin unterstützt. Lege vorher eine Sicherung an.

Zusatzplugin für WorldEdit nutzt eine entfernte Schnittstelle

So sieht die Meldung aus:

[WorldEdit] Got request to set EditSessionFactory <…> EditSessionFactories have been removed …

Was dahintersteckt: WorldEdit hat eine ältere Schnittstelle entfernt, die EditSessionFactory. Über sie konnten sich Zusatzplugins in jede WorldEdit-Änderung einklinken. Ein Zusatzplugin, etwa für Block-Protokolle oder Gebietsschutz, versucht sie noch zu nutzen. WorldEdit selbst arbeitet normal. Die Protokoll- oder Schutzfunktion des Zusatzplugins greift bei WorldEdit-Änderungen aber nicht: Was du mit WorldEdit baust oder löschst, wird von ihm weder erfasst noch blockiert.

So behebst du es:

1. Finde heraus, welches Plugin die Anfrage stellt. Der Name steht meist in der Meldung selbst oder in den Zeilen davor.
2. Aktualisiere dieses Zusatzplugin auf eine Version, die mit deinem WorldEdit oder FastAsyncWorldEdit (FAWE, eine schnellere WorldEdit-Variante) zusammenarbeitet.
3. Gibt es keine, schalte die WorldEdit-Anbindung in der Konfiguration des Zusatzplugins ab, falls es dafür eine Einstellung gibt.
4. Starte neu und prüfe, ob die Meldung verschwunden ist.

Gut zu wissen: Bis das behoben ist, kannst du dich nicht darauf verlassen, dass WorldEdit-Änderungen protokolliert werden oder sich darüber zurücksetzen lassen.

Braslety: Rezept wird nicht registriert

So sieht die Meldung aus:

[Braslety] … java.lang.IllegalAccessException: class com.example.braslety.BraceletsPlugin cannot access …

Was dahintersteckt: Braslety greift per Reflection auf interne CraftBukkit-Klassen zu. Reflection heißt: Das Plugin liest Teile des Servers direkt aus, statt die offizielle Schnittstelle zu nutzen. In deiner Server-Version sind diese Teile nicht zugänglich, Java verweigert den Zugriff. Das betroffene Rezept wird deshalb nicht registriert, das zugehörige Item lässt sich also nicht herstellen. Der Server läuft weiter.

So behebst du es:

1. Prüfe, ob es eine Braslety-Version für deinen aktuellen Paper-Build gibt. Deinen Stand siehst du unter Version.
2. Gibt es eine, ersetze die alte Datei unter Dateien im Ordner plugins/ und starte neu.
3. Gibt es keine, ersetze das Plugin durch ein gepflegtes mit ähnlicher Funktion.
4. Prüfe im Spiel, ob das Rezept funktioniert.

Gut zu wissen: Der Paketname com.example deutet auf ein selbst erstelltes oder wenig verbreitetes Plugin hin. Ein Update kann dann nur sein Ersteller liefern.

ViaVersion kann ein Übersetzungsmodul nicht laden

So sieht die Meldung aus:

[ViaVersion] Error during loading of Protocol<Version>To<Version>

Was dahintersteckt: ViaVersion übersetzt zwischen Spielversionen, damit auch Spieler mit neueren oder älteren Clients beitreten können. Erweiterungen wie ViaBackwards ergänzen das für ältere Clients. Jede Übersetzung steckt in einem eigenen Modul, dessen Name mit Protocol beginnt. Eines davon ließ sich nicht laden, meist weil ViaVersion und seine Erweiterungen nicht zueinander oder nicht zur Server-Version passen. Spieler mit den betroffenen Client-Versionen können dann nicht beitreten. Wer genau die Server-Version spielt, ist nicht betroffen.

So behebst du es:

1. Lade die neuesten Versionen von ViaVersion und von allen Via-Erweiterungen, die du nutzt.
2. Ersetze alle gemeinsam unter Dateien im Ordner plugins/. Mische keine alten und neuen Via-Dateien.
3. Starte den Server vollständig neu.
4. Teste den Beitritt mit der Client-Version, die vorher nicht ging.

Ausführlich: ViaVersion einrichten: ältere und neuere Clients verbinden

LibreLogin läuft nicht auf Spigot

So sieht die Meldung aus:

[LibreLogin] Detected an unsupported server distribution. Please use Paper or its forks. SPIGOT IS NOT SUPPORTED!

Was dahintersteckt: LibreLogin ist ein Login-Plugin: Spieler melden sich mit einem Passwort an. Das ist vor allem auf Servern im Offline-Modus wichtig. LibreLogin braucht Paper oder einen kompatiblen Fork, also eine Abwandlung von Paper wie Purpur, und schaltet sich auf Spigot ab. Läuft dein Server im Offline-Modus, fehlt damit der Passwortschutz: Spieler können sich unter fremden Namen verbinden.

So behebst du es:

1. Lege unter Sicherungen eine Sicherung an.
2. Stelle den Server unter Software / Loader wechseln auf Paper oder Purpur um. Plugins für Spigot laufen dort in aller Regel weiter.
3. Starte neu und prüfe in der Konsole, ob LibreLogin ohne diese Meldung lädt.
4. Willst du bei Spigot bleiben, nutze ein Login-Plugin, das Spigot ausdrücklich unterstützt.

Gut zu wissen: Läuft dein Server im Offline-Modus, behebe das, bevor Spieler beitreten.

Mehr dazu: Server-Software und Version im Panel wechseln

Nova fehlt ein Java-Startparameter (-javaagent)

So sieht die Meldung aus:

[Nova] Missing required JVM argument: -javaagent:plugins/Nova-<Version>.jar

Was dahintersteckt: Nova ist ein umfangreiches Plugin, das eigene Blöcke und Items auf Paper-Servern möglich macht. Für einen Teil seiner Funktionen muss Java beim Start einen sogenannten Java-Agent laden. Das ist ein Zusatz, der schon vor dem eigentlichen Server aktiv wird und über einen Startparameter eingebunden wird. Dein Server startet ohne diesen Parameter. Nova funktioniert deshalb nicht vollständig, der Server selbst läuft.

So behebst du es:

1. Lies in der Meldung den genauen Parameter ab, einschließlich des Dateinamens der Nova-JAR.
2. Den Startbefehl deines Minecraft-Servers kannst du im Panel nicht selbst ändern. Öffne deshalb ein Ticket, kopiere den Parameter aus der Meldung hinein und nenne die Uhrzeit der Meldung.
3. Brauchst du Nova nicht zwingend, entferne das Plugin unter Plugins und starte den Server neu. Die Meldung verschwindet dann.

Gut zu wissen: Mit jeder neuen Nova-Version ändert sich meist auch der Dateiname im Parameter. Nach einem Nova-Update kommt die Meldung deshalb oft wieder.

Deine Meldung ist nicht dabei?

Lies die ganze Meldung in der Konsole oder in logs/latest.log, auch die Zeilen davor. Das betroffene Plugin erkennst du am Namen in eckigen Klammern am Zeilenanfang oder im Stacktrace, der Liste der at …-Zeilen: Dort stehen JAR-Namen aus plugins/ oder mods/ und Paketnamen, die oft den Plugin-Namen enthalten. Vergleiche dann auf der Plugin-Seite die unterstützten Versionen mit deinem Server. Lege vor jedem Versionswechsel eine Sicherung an. Kommst du nicht weiter, öffne ein Ticket und nenne die Uhrzeit der Meldung.