Plugin-Datei defekt, doppelt oder kein Plugin: Minecraft-Fehler beheben

Ein Plugin ist bei Paper und Spigot eine einzelne JAR-Datei (ein Java-Archiv) im Ordner plugins. Ist diese Datei beschädigt, leer, doppelt vorhanden oder in Wahrheit eine Mod oder Bibliothek, lädt der Server das Plugin nicht oder es stürzt beim Start ab. Jeder Abschnitt unten behandelt eine dieser Meldungen. Über „Mehr erfahren“ in der Server-Gesundheit landest du direkt beim passenden.

Den vollständigen Text findest du in der Konsole oder unter Dateien in logs/latest.log. Wichtig sind meist die Zeilen direkt unter der Meldung, denn dort steht der eigentliche Grund. Tausche Plugin-Dateien nur bei gestopptem Server aus. Lege vorher unter Sicherungen eine Sicherung an, vor allem wenn auch Welt- oder Konfigurationsdateien betroffen sein könnten.

Plugin stürzt beim Aktivieren ab („Error occurred while enabling“)

So sieht die Meldung aus:

Error occurred while enabling <Plugin> v<Version> (Is it up to date?)
java.lang.NoSuchMethodError: '<Methode>'
    at <Plugin>-<Version>.jar//<Paket>.onEnable(…)

Was dahintersteckt: Der Server hat das Plugin geladen, beim Aktivieren ist es aber abgestürzt und hat sich selbst abgeschaltet. Der Server läuft normal weiter, doch die Funktion dieses Plugins fehlt vollständig: keine Befehle, keine Menüs, keine Rechte, und im Spiel erscheint keine weitere Fehlermeldung. Ist es ein Schutz-, Rechte- oder Login-Plugin, fehlt dieser Schutz, bis du den Fehler behebst. Meist passt das Plugin zu einer anderen Server- oder Plugin-Version als der installierten.

So behebst du es:

1. Die Fehlerzeile nennt Plugin und Version. Prüfe auf der Plugin-Seite, ob es eine Ausgabe für deine Server-Version gibt, und aktualisiere das Plugin.
2. Steht darunter NoSuchMethodError oder NoClassDefFoundError mit dem Namen eines anderen Plugins, passen diese beiden Plugin-Versionen nicht zueinander. Bring eines davon auf einen passenden Stand.
3. Steht darunter ein Datenbankfehler wie Communications link failure, erreicht das Plugin seine Datenbank nicht. Prüfe die Zugangsdaten in seiner Konfiguration und unter Datenbanken.
4. Starte den Server neu und prüfe die Konsole.

Gut zu wissen: Dieselbe Meldung mit „disabling“ beim Stoppen ist oft nur eine Folge des Startfehlers. Mehr zu Versionskonflikten: Plugin passt nicht zur Server-Version.

Plugin-Datei wird übersprungen („Could not load 'plugins/…jar'“)

So sieht die Meldung aus:

[ModernPluginLoadingStrategy] Could not load 'plugins/<Plugin>.jar' in 'plugins'
org.bukkit.plugin.UnknownDependencyException: Unknown/missing dependency plugins: [ProtocolLib]. Please download and install these plugins to run '<Plugin>'.

Was dahintersteckt: Der Server konnte die genannte JAR nicht als Plugin laden und überspringt sie. Eine JAR (Java-Archiv) ist die Datei, in der ein Plugin steckt. Der übrige Server kann weiterlaufen, dieses Plugin fehlt aber komplett. Ursache ist eine beschädigte oder ungültige Datei oder eine JAR ohne lesbare plugin.yml, die Beschreibungsdatei, an der der Server ein Plugin erkennt. Bei „Failed to run bootstrapper“ ist ein Paper-Plugin schon in der frühesten Startphase gescheitert.

So behebst du es:

1. Lies die Zeile unter der Meldung. Steht dort UnknownDependencyException, fehlt ein anderes Plugin: Installiere das Plugin aus den eckigen Klammern.
2. Sonst stoppe den Server und lösche die betroffene JAR unter Dateien im Ordner plugins.
3. Lade eine Ausgabe aus einer vertrauenswürdigen Quelle herunter, die zu deinem Servertyp (Paper, Spigot) und deiner Minecraft-Version passt, und lade sie hoch.
4. Starte den Server neu.

Gut zu wissen: Zeigt der Pfad auf plugins/.paper-remapped, ist das eine Kopie, die Paper für Spigot-Plugins anlegt. Tausche die Original-JAR in plugins aus, die Kopie erzeugt Paper beim nächsten Start neu. Zu fehlenden Plugins: Plugin braucht ein anderes Plugin.

Plugin stürzt schon beim Initialisieren ab („Is it up to date?“)

So sieht die Meldung aus:

[<Plugin>] Error initializing plugin '<Plugin>-<Version>.jar' in folder 'plugins' (Is it up to date?)
java.lang.ExceptionInInitializerError

Was dahintersteckt: Das Plugin ist abgestürzt, während der Server es vorbereitet hat, also noch bevor es überhaupt aktiviert wurde. Es bleibt deaktiviert, seine Befehle und Funktionen fehlen, der Server läuft ohne es weiter. Fast immer passt die Plugin-Version nicht zur Server-Version. Die Fehlerzeile darunter nennt oft die Version oder eine fehlende Klasse, also einen Programmteil, den das Plugin im Server erwartet.

So behebst du es:

1. Installiere die Plugin-Version, die für deine Server-Version gedacht ist, oder aktualisiere das Plugin. Die Plugin-Seite nennt die unterstützten Versionen.
2. Gibt es für deine Server-Version noch keine passende Ausgabe, warte auf ein Update des Plugins oder bleib unter Version vorerst auf einer unterstützten Version.
3. Hilft das nicht, entferne das Plugin testweise und melde den Fehler dem Plugin-Autor, mit der kompletten Meldung.
4. Starte den Server neu.

Gut zu wissen: Meldet Geyser „English locale not found“, ist die Datei unvollständig. Lade Geyser neu von der offiziellen Projektseite. Mehr dazu: Plugin passt nicht zur Server-Version.

Paper lädt ein Plugin nicht („Could not load plugin … in folder“)

So sieht die Meldung aus:

[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>-<Version>.jar' in folder 'plugins'
org.bukkit.plugin.InvalidPluginException: java.lang.ExceptionInInitializerError

Was dahintersteckt: Paper konnte das genannte Plugin beim Start nicht laden. Das Plugin fehlt vollständig, der übrige Server startet. Den Grund nennt die Zeile direkt darunter, meist eine kaputte plugin.yml, eine fehlende Abhängigkeit oder ein Build für eine andere Server-Version. Eine Meldung zu „API version string“ heißt zum Beispiel, dass die Versionsangabe in der plugin.yml ein Format hat, das deine Server-Version nicht versteht.

So behebst du es:

1. Lies die Zeile direkt unter der Meldung.
2. Lade das Plugin passend zu deiner Server-Version neu herunter.
3. Stoppe den Server, entferne unter Dateien die alte JAR aus plugins und lade die neue hoch.
4. Starte den Server neu und prüfe in der Konsole, ob das Plugin jetzt lädt.

Gut zu wissen: Nennt die Zeile darunter ein fehlendes Plugin, liegt das Problem nicht an der Datei selbst. Dann hilft Plugin braucht ein anderes Plugin.

Plugin doppelt installiert („Ambiguous plugin name“)

So sieht die Meldung aus:

[ModernPluginLoadingStrategy] Ambiguous plugin name 'ViaVersion' for files 'plugins/ViaVersion.jar' and 'plugins/ViaVersion-<Version>.jar' in 'plugins'

Was dahintersteckt: Zwei JAR-Dateien im Ordner plugins tragen denselben Plugin-Namen. Der Server lädt nur eine davon, und du weißt nicht sicher, welche. Typisch ist, dass eine neue Version hochgeladen wurde, ohne die alte zu löschen. Oder zwei Plugins enthalten dasselbe, etwa FastAsyncWorldEdit, das WorldEdit schon mitbringt. Der Server läuft, womöglich aber mit der alten Version.

So behebst du es:

1. Die Meldung nennt beide Dateien. Stoppe den Server und öffne unter Dateien den Ordner plugins.
2. Lösche die doppelte oder ältere JAR. Behalte die Version, die zu deiner Server-Version passt.
3. Bei WorldEdit und FastAsyncWorldEdit behältst du nur eines von beiden.
4. Starte den Server neu. Der Befehl plugins in der Konsole zeigt, welche Plugins geladen sind.

Gut zu wissen: Lade beim Aktualisieren immer erst die alte JAR herunter oder lösche sie, bevor du die neue hochlädst. Dateinamen mit Versionsnummer machen doppelte Plugins leicht zu übersehen.

Mod statt Plugin im plugins-Ordner

So sieht die Meldung aus:

[DirectoryProviderSource] Error loading plugin: java.lang.IllegalArgumentException: Directory 'plugins/<Mod>-fabric-<Version>.jar' does not contain a paper-plugin.yml or plugin.yml! Could not determine plugin type, cannot load a plugin from it!

Was dahintersteckt: Im Ordner plugins liegt eine JAR ohne plugin.yml, also ohne die Datei, an der Paper ein Plugin erkennt. Meist ist es eine Mod für Fabric oder Forge, der Dateiname enthält dann oft „fabric“ oder „forge“. Manchmal ist es auch eine Java-Bibliothek wie ein Datenbanktreiber. Paper kann so etwas nicht laden und überspringt die Datei. Der Server läuft weiter, die erhoffte Funktion fehlt aber.

So behebst du es:

1. Lösche die genannte Datei unter Dateien aus dem Ordner plugins.
2. Suche auf der Projektseite nach einer Plugin-Ausgabe für Paper oder Spigot. Viele Projekte bieten beides an.
3. Gibt es nur eine Mod, brauchst du einen Mod-Server. Unter Software / Loader wechseln wählst du Fabric, Forge oder NeoForge. Deine Paper-Plugins laufen dort dann nicht mehr.
4. Starte den Server neu.

Gut zu wissen: Manche Mods laufen ohnehin nur im Spiel-Client und gehören gar nicht auf den Server. Den Wechsel der Software beschreibt Server-Software und Version im Panel wechseln.

Plugin-Datei im laufenden Betrieb ersetzt („zip file closed“)

So sieht die Meldung aus:

java.lang.IllegalStateException: zip file closed
java.lang.IllegalStateException: The plugin classloader for <Plugin> has thrown a zip file error.

Was dahintersteckt: Eine Plugin-JAR wurde überschrieben oder gelöscht, während der Server lief, oder jemand hat /reload benutzt. Das Plugin will danach Programmteile aus seiner Datei nachladen, die der Server schon geschlossen hat, und wirft Fehler. Das trifft besonders Plugins, die ständig im Hintergrund arbeiten, etwa LuckPerms. Funktionen des Plugins können ausfallen, bis der Server neu startet.

So behebst du es:

1. Starte den Server vollständig neu. Damit ist die Meldung in der Regel erledigt.
2. Tausche Plugin-Dateien künftig nur bei gestopptem Server: stoppen, JAR unter Dateien ersetzen, starten.
3. Verzichte auf /reload. Der Befehl lädt alle Plugins im laufenden Betrieb neu, und viele Plugins kommen damit nicht zurecht.
4. Kommt die Meldung ohne vorherigen Dateitausch, lies die Zeilen davor in der Konsole. Sie zeigen, welches Plugin betroffen ist.

Gut zu wissen: Nach einem sauberen Neustart ist das Plugin wieder vollständig da. Daten gehen durch diese Meldung allein nicht verloren, nicht gespeicherte Änderungen des Plugins aus dieser Zeit aber unter Umständen schon.

Zwei Plugin-Dateien mit demselben Namen („duplicate plugin identifier“)

So sieht die Meldung aus:

[ModernPluginLoadingStrategy] Could not load plugin 'worldedit-bukkit-<Version>.jar' in folder 'plugins'
java.lang.IllegalStateException: Provider SpigotPluginProvider{path=plugins/worldedit-bukkit-<Version>.jar, …} attempted to add duplicate plugin identifier …

Was dahintersteckt: Zwei JAR-Dateien stellen denselben Plugin-Namen bereit. Paper lädt nur eine davon und weist die andere ab. Meist liegen alte und neue Version eines Plugins nebeneinander im Ordner plugins. Oder zwei Plugins beanspruchen denselben Namen: FastAsyncWorldEdit (kurz FAWE) enthält WorldEdit bereits, eine zusätzliche WorldEdit-JAR kollidiert damit. Der Server läuft weiter, Paper warnt aber ausdrücklich vor Folgefehlern.

So behebst du es:

1. Stoppe den Server.
2. Lösche unter Dateien im Ordner plugins die ältere bzw. überflüssige JAR. Bei FAWE ist das die separate worldedit-bukkit-JAR.
3. Starte den Server und prüfe mit dem Befehl plugins in der Konsole, dass das Plugin nur einmal geladen ist.

Gut zu wissen: Die gewohnten WorldEdit-Befehle funktionieren mit FAWE weiter. Wie du damit baust und Fehler rückgängig machst, zeigt WorldEdit: Bereiche auswählen, bauen und rückgängig machen.

ProtocolLib warnt vor einem Plugin-Reloader

So sieht die Meldung aus:

*** ProtocolLib does not support plugin reloaders! ***
*** Please use the built-in reload command!        ***

Was dahintersteckt: ProtocolLib greift tief in die Netzwerkverbindung zwischen Server und Spielern ein. Plugin-Reloader sind Plugins wie PlugMan oder PlugManX, die einzelne Plugins im laufenden Betrieb laden oder entladen. ProtocolLib unterstützt das nicht und warnt vor einem inkonsistenten Zustand. Dann können ProtocolLib und alle Plugins, die darauf aufbauen, fehlerhaft arbeiten, etwa Anti-Cheat- oder Anzeige-Plugins.

So behebst du es:

1. Lade ProtocolLib und Plugins, die es nutzen, nicht mit einem Plugin-Reloader neu.
2. Starte nach Änderungen an Plugins den ganzen Server vollständig neu.
3. Brauchst du den Reloader nicht, entferne ihn unter Dateien aus dem Ordner plugins, damit er nicht aus Versehen genutzt wird.
4. Hast du gerade einen Reloader benutzt, starte jetzt einmal komplett neu, damit alles wieder sauber geladen ist.

Gut zu wissen: Die Meldung empfiehlt den eingebauten Reload-Befehl. Auch der lädt alle Plugins im laufenden Betrieb neu. Der sicherste Weg bleibt ein vollständiger Neustart.

Datei im plugins-Ordner ist kein lauffähiges Plugin

So sieht die Meldung aus:

[DirectoryProviderSource] Error preparing plugin context: Directory 'plugins/<Plugin>-<Version>.jar' failed to update!
Failed to open plugin jar …

Was dahintersteckt: Eine Datei im Ordner plugins lässt sich nicht als Plugin laden, das Plugin startet nicht. Häufig ist es der Quelltext statt des Plugins (der Dateiname endet auf -sources.jar), die Dokumentation (-javadoc.jar), ein abgebrochener Download, eine in .jar umbenannte ZIP-Datei oder ein Plugin für eine andere Plattform. Auch „Invalid plugin.yml“ oder „only DEFLATED entries can have EXT descriptor“ gehören zu dieser Gruppe: Die Datei ist nicht so aufgebaut, wie ein Plugin sein muss.

So behebst du es:

1. Stoppe den Server und lösche die genannte Datei unter Dateien aus plugins.
2. Lade das Plugin erneut von der offiziellen Seite herunter. Nimm die eigentliche .jar, nicht -sources.jar oder -javadoc.jar.
3. Kommt das Plugin als ZIP-Archiv, entpacke es am eigenen Rechner und lade nur die enthaltene JAR hoch.
4. Achte darauf, dass die Datei für Paper oder Spigot gedacht ist, und starte den Server neu.

Gut zu wissen: Eine Ausgabe für eine andere Plattform erkennst du oft am Dateinamen oder an der Downloadseite, die mehrere Varianten zur Auswahl anbietet.

Java-Bibliothek liegt als Plugin im plugins-Ordner

So sieht die Meldung aus:

[DirectoryProviderSource] Error preparing plugin context: Directory 'plugins/asm-util-<Version>.jar' failed to update!

Was dahintersteckt: Eine Java-Bibliothek wie ASM oder Nashorn liegt als eigene Datei im Ordner plugins. Bibliotheken sind Bausteine, die Plugins intern nutzen, sie sind selbst keine Plugins. Paper kann diese JAR weder als Plugin laden noch aktualisieren und überspringt sie. Der Server läuft weiter. Solche Dateien landen dort zum Beispiel, wenn ein Archiv mit mehreren Dateien komplett hochgeladen wurde.

So behebst du es:

1. Lösche die genannte Bibliotheks-JAR unter Dateien aus plugins.
2. Installiere nur das eigentliche Plugin. Es bringt seine Bibliotheken selbst mit oder lädt sie beim Start nach.
3. Starte den Server neu und prüfe die Konsole.
4. Meldet danach ein Plugin, dass ihm etwas fehlt, lies seine Installationsanleitung, statt Bibliotheken von Hand dazuzulegen.

Gut zu wissen: Braucht ein Plugin wirklich ein zweites Plugin, nennt es dieses ausdrücklich. Wie du das erkennst: Plugin braucht ein anderes Plugin.

Plugin-Datei ist leer („zip file is empty“)

So sieht die Meldung aus:

[DirectoryProviderSource] Error loading plugin: zip file is empty

Was dahintersteckt: Eine Datei im Ordner plugins ist 0 Byte groß oder ihr Upload wurde abgebrochen. Paper kann sie nicht öffnen und überspringt sie. Das Plugin fehlt, der Server läuft weiter. Oft passiert das, wenn die Verbindung beim Hochladen abreißt oder der Download schon am eigenen Rechner unvollständig war.

So behebst du es:

1. Öffne unter Dateien den Ordner plugins und such die Datei mit 0 Byte oder auffällig kleiner Größe.
2. Lösche sie.
3. Lade das Plugin erneut aus einer vertrauenswürdigen Quelle herunter und lade es bei gestopptem Server hoch. Warte, bis der Upload vollständig abgeschlossen ist.
4. Starte den Server neu und prüfe in der Konsole, ob das Plugin lädt.

Gut zu wissen: Bei großen oder vielen Dateien ist SFTP oft zuverlässiger als der Upload im Browser, siehe Serverdateien im Panel bearbeiten und per SFTP verbinden.

Deine Meldung ist nicht dabei?

Lies die ganze Meldung in der Konsole oder in logs/latest.log, auch die Zeilen davor und danach. Den Namen der Plugin-Datei findest du in der Meldung selbst oder im Stacktrace, der Liste eingerückter at-Zeilen: Dort steht die JAR vor dem doppelten Schrägstrich, etwa <Plugin>.jar//. Auch Ordnernamen wie plugins/<Plugin>/ zeigen, welches Plugin betroffen ist. Lege vor dem Austausch von Dateien eine Sicherung an. Kommst du nicht weiter, öffne ein Ticket und nenne die Uhrzeit der Meldung.