Anleitung

So behebst du Minecraft-Plugin-Fehler

Aktualisiert am 18. Oktober 2026

Wenn ein Plugin nicht lädt, sagt der Server fast immer, warum: Der Grund steht beim Start in der Konsole, ein paar Zeilen über oder unter dem Namen des Plugins. Lerne, diesen Teil des Protokolls zu lesen, und die meisten Fehler sind in einer Minute behoben. Hier sind die häufigsten und was sie bedeuten.

Gib deine Serverversion an und was das Plugin tun soll.

Mit Codexe erstellen

Schritt für Schritt

1.Öffne das Protokoll des Starts
Lies die Konsole oder logs/latest.log im Serverordner. In einem Hosting-Panel nutzt du dessen Konsole oder Dateimanager.
2.Suche nach dem Namen des Plugins
Finde den ersten Fehler, der es erwähnt. Wichtig sind Zeilen, die mit [ERROR] oder [WARN] beginnen, und ein Stacktrace darunter.
3.Lies die erste Zeile und die „Caused by“-Zeilen
Die erste Zeile sagt, was fehlgeschlagen ist; die letzte Zeile Caused by: sagt meist, warum. Zeilen mit dem Paketnamen des Plugins zeigen, wo in seinem Code.
4.Gleiche es mit der Liste unten ab
Die meisten Startfehler sind ein Problem mit der Version, mit Java oder mit einer Abhängigkeit, und die Meldung sagt, welches.
5.Ändere eine Sache und starte neu
Ändere eine Sache, starte neu (nicht /reload) und lies das Protokoll erneut. Fehler eines Plugins können Fehler in anderen auslösen.

Die häufigsten Fehler

Du siehst	Was es bedeutet	Lösung
`Unsupported API version 1.21`	Die `api-version` des Plugins ist neuer als dein Server.	Hol dir die Version für deinen Server oder aktualisiere den Server.
`Could not load 'plugins/X.jar'` mit `Invalid plugin.yml` oder `Jar does not contain plugin.yml`	Der Deskriptor des Plugins fehlt oder hat einen YAML-Fehler, oder die Datei ist kein Plugin.	Prüfe, ob du das Plugin heruntergeladen hast und nicht seinen Quellcode, eine Mod oder eine ZIP. Wenn du es selbst gebaut hast, korrigiere die `plugin.yml`.
`UnsupportedClassVersionError`, „class file version 65.0“	Das Plugin braucht ein neueres Java als das, mit dem der Server läuft (61 = Java 17, 65 = Java 21, 69 = Java 25).	Betreibe den Server mit diesem Java oder baue das Plugin für dein Java neu.
`NoClassDefFoundError` oder `ClassNotFoundException`	Eine Klasse, die das Plugin braucht, ist nicht da: Ein Plugin als Abhängigkeit fehlt, eine Bibliothek wurde nicht in die .jar gepackt, oder die API gibt es in dieser Version nicht.	Installiere das im Fehler genannte Plugin (Vault, ProtocolLib) oder nutze einen Build für deine Version.
`Unknown/missing dependency plugins`	Ein in `depend` aufgeführtes Plugin ist nicht installiert.	Installiere es in `plugins/`.
`Error occurred while enabling X (Is it up to date?)`	Das Plugin wurde geladen, ist aber in `onEnable` abgestürzt.	Lies die Zeile `Caused by`: oft ein Fehler in der Config oder eine fehlende Abhängigkeit.
`Ambiguous plugin name`	Zwei .jar-Dateien desselben Plugins liegen in `plugins/`.	Lösche die alte.

Fehler, die nichts mit dem Laden zu tun haben

Das Plugin ist grün, aber ein Befehl meldet „Unknown command“: Der Befehl fehlt in der plugin.yml, oder ein anderes Plugin nutzt denselben Namen.
„I'm sorry, but you do not have permission“: Dem Spieler fehlt die Berechtigung (Permission-Node). Schau auf der Plugin-Seite nach der Node und vergib sie mit deinem Berechtigungs-Plugin.
Fehler nach dem Bearbeiten der config.yml: YAML braucht Leerzeichen, keine Tabs, und Anführungszeichen um Text, der mit : oder & beginnt.
Funktioniert nach einem Neustart, geht nach /reload kaputt: Das Plugin unterstützt /reload nicht. Starte stattdessen neu.

Welches Java dein Server braucht

Minecraft 1.20.5 und neuer braucht Java 21, und 26.x braucht Java 25; 1.18 bis 1.20.4 brauchen Java 17. Führe java -version mit demselben Java aus, das der Server nutzt (in einem Hosting-Panel ist das meist eine Einstellung namens Docker-Image oder Java-Version). Ein Plugin, das für ein älteres Java gebaut wurde, läuft auf einem neueren, aber nicht umgekehrt.

Mit Codexe erstellte Plugins reparieren

Auf Codexe erstellte Plugins werden für die gewählte Version kompiliert und auf eine gültige plugin.yml geprüft, bevor sie als Ready gelten. Auf einem Testserver zeigt der Tab Logs das Protokoll live mit hervorgehobenen Fehlern, und Logs exportieren speichert es als Datei. Beschreibe im Projekt-Chat, was du siehst („das Plugin ist in /plugins rot und im Log steht ...“), und Codexe ändert den Code und baut erneut. Wenn Kompilieren bei Dateien fehlschlägt, die genau so sind, wie Codexe sie geliefert hat, repariert Mit KI beheben sie kostenlos.

Fragen

Wo ist das Serverprotokoll?

logs/latest.log im Serverordner, für den aktuellen Lauf. Ältere Läufe liegen im selben Ordner als .log.gz-Dateien.

Kann ein Plugin ein anderes kaputtmachen?

Ja: Eine fehlende oder kaputte Abhängigkeit stoppt jedes Plugin, das sie braucht. Behebe den ersten Fehler im Protokoll vor den anderen.

Kann ich mein Protokoll bedenkenlos teilen?

Meistens, aber prüfe es vorher: Protokolle können IP-Adressen enthalten und bei manchen Plugins Datenbankpasswörter aus Fehlermeldungen.

Baue ein kaputtes Plugin für deinen Server neu

Dieser Prompt öffnet sich versandfertig:

“Ein Plugin für Paper 1.21.4 namens SimpleWarps, das mein altes ersetzt, das nicht mehr lädt: /setwarp, /warp und /delwarp mit einem Namen, /warps listet sie in einer GUI auf, Berechtigung warps.admin zum Setzen und Löschen, Warps bleiben über Neustarts erhalten, Nachrichten in der config.yml.”