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.

„Error occurred while enabling …“: Plugin startet nicht

So sieht die Meldung aus:

Error occurred while enabling EssentialsSpawn v<Version> (Is it up to date?)
Error occurred while enabling WorldEditDisplay v<Version> (Is it up to date?)
Error occurred while disabling FurnitureLib v<Version>

Was dahintersteckt: Der Server hat das Plugin geladen, beim Aktivieren ist es aber abgestürzt und wurde abgeschaltet. Der Server läuft weiter, doch die Funktionen dieses Plugins fehlen vollständig. Ist es ein Schutz-, Rechte- oder Login-Plugin, fehlt auch dieser Schutz. 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, welche Ausgabe deine Server-Version unterstützt, und aktualisiere bei gestopptem Server.
  2. Steht darunter NoSuchMethodError (eine Methode fehlt) oder NoClassDefFoundError (ein Programmbaustein fehlt), prüfe die genannten Abhängigkeiten. EssentialsSpawn und EssentialsX müssen beispielsweise zusammenpassen; ein Verweis auf Bukkit kann die Server-Schnittstelle betreffen.
  3. Bei einem Datenbankfehler wie Communications link failure prüfst du die Zugangsdaten in der Plugin-Konfiguration und unter Datenbanken.
  4. Starte neu und prüfe in der Konsole, ob das Plugin erfolgreich aktiviert wird.

Gut zu wissen: „Error occurred while disabling“ betrifft das Abschalten. Tritt es nach einem Aktivierungsfehler auf, prüfe zuerst diesen früheren Fehler. Mehr dazu: 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.

„Error initializing plugin …“: Plugin scheitert beim Start

So sieht die Meldung aus:

[<Plugin>] Error initializing plugin '<Plugin>-<Version>.jar' in folder '<Ordner>' (Is it up to date?)
java.lang.ExceptionInInitializerError
java.lang.ArrayIndexOutOfBoundsException: Index <Index> out of bounds for length <Länge>

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. Meist 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. Lies zuerst die Folgezeilen in logs/latest.log unter Dateien, besonders Caused by. Sie nennen die eigentliche Ursache.
  2. Installiere die Plugin-Version für deine Server-Version oder aktualisiere das Plugin. Die Plugin-Seite nennt die unterstützten Versionen.
  3. 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.
  4. Hilft das nicht, entferne das Plugin testweise und melde den Fehler dem Plugin-Autor, mit der kompletten Meldung.
  5. 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.

„Ambiguous plugin name …“: Plugin ist doppelt installiert

So sieht die Meldung aus:

[ModernPluginLoadingStrategy] Ambiguous plugin name 'ViaVersion' for files 'plugins/ViaVersion.jar' and 'plugins/ViaVersion-<Version>.jar' in 'plugins'
[ModernPluginLoadingStrategy] Ambiguous plugin name 'LPC' for files 'plugins/.paper-remapped/LPC-<Version>.jar' and 'plugins/.paper-remapped/LPC-<AndereVersion>.jar' in 'plugins/.paper-remapped'
[ModernPluginLoadingStrategy] Ambiguous plugin name 'Slimefun' for files 'plugins/.paper-remapped/<Datei>.jar' and 'plugins/.paper-remapped/<AndereDatei>.jar' in 'plugins/.paper-remapped'

Was dahintersteckt: Zwei JAR-Dateien melden denselben internen Plugin-Namen, auch wenn ihre Dateinamen verschieden sind. Typisch sind eine alte und eine neue Version oder zwei Varianten desselben Plugins. Der Server lädt nur eine davon und läuft womöglich mit der unerwünschten Version.

So behebst du es:

  1. Stoppe den Server und öffne unter Dateien den Ordner plugins.
  2. Ordne die beiden genannten Dateien ihren Original-JARs zu. plugins/.paper-remapped enthält von Paper angepasste Kopien; entferne die unerwünschte Original-JAR in plugins, nicht nur ihre Kopie.
  3. Behalte genau eine Ausgabe, die zu deiner Server-Version passt. Lösche keine Plugin-Datenordner.
  4. Starte neu. Prüfe die Konsole auf die Meldung; der Befehl plugins zeigt die geladenen Plugins.

Gut zu wissen: Aktualisiere Plugins bei gestopptem Server und entferne die alte JAR, bevor du die neue hochlädst.

„does not contain a paper-plugin.yml or plugin.yml“: Datei ist kein Plugin

So sieht die Meldung aus:

Directory 'plugins/<Mod>-fabric-<Version>.jar' does not contain a paper-plugin.yml or plugin.yml!
Directory 'plugins/<Mod>-neoforge-<Version>.jar' does not contain a paper-plugin.yml or plugin.yml!

Was dahintersteckt: Im Ordner plugins liegt eine JAR ohne plugin.yml und ohne paper-plugin.yml, also ohne eine der Beschreibungsdateien für Plugins. Meist ist es eine Mod für Fabric, Forge oder NeoForge; manchmal ist es eine Java-Bibliothek wie ein Datenbanktreiber. Paper und seine Varianten können diese Datei nicht als Plugin laden und überspringen sie. Der Server läuft weiter, die erhoffte Funktion fehlt.

So behebst du es:

  1. Stoppe den Server und entferne die genannte Datei unter Dateien aus plugins/.
  2. Suche auf der Projektseite nach einer Ausgabe für Paper oder Spigot, passend zu deiner Minecraft-Version.
  3. Gibt es nur eine Mod, prüfe zuerst, ob sie überhaupt auf den Server gehört. Manche Mods laufen ausschließlich im Spiel-Client.
  4. Willst du zu einem Mod-Server wechseln, lege vorher unter Sicherungen eine Sicherung an. Wähle unter Software / Loader wechseln genau den Loader, den die Mod verlangt. Deine Paper-Plugins laufen dort nicht mehr.
  5. Starte neu und prüfe die Konsole.

Den Softwarewechsel beschreibt Server-Software und Version im Panel wechseln.

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

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.
io.netty.handler.codec.EncoderException: java.lang.BootstrapMethodError: java.lang.IllegalStateException: zip file closed

Was dahintersteckt: Eine Plugin-JAR, also die Programmdatei eines Plugins, wurde überschrieben oder gelöscht, während der Server lief, oder jemand hat /reload benutzt. Das Plugin will danach Programmteile aus seiner bereits geschlossenen Datei nachladen und wirft Fehler. Funktionen des Plugins können ausfallen, bis der Server neu startet. Die Meldung kann auch beim Stoppen erscheinen.

So behebst du es:

  1. Starte den Server vollständig neu. Fehlt die betroffene Plugin-JAR, stelle sie zuvor bei gestopptem Server unter Dateien wieder her.
  2. Tausche Plugin-Dateien künftig nur bei gestopptem Server: stoppen, JAR unter Dateien ersetzen, starten.
  3. Verzichte auf /reload. Der Befehl lädt 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 helfen dir, das betroffene Plugin zu finden.

Gut zu wissen: Änderungen, die das Plugin während des Fehlers noch nicht gespeichert hat, können verloren gehen.

„duplicate plugin identifier“: Zwei Plugin-Dateien beanspruchen denselben Namen

So sieht die Meldung aus:

[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins'
[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins/.paper-remapped'
java.lang.IllegalStateException: … attempted to add duplicate plugin identifier <Plugin> …

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. Nennt die Meldung plugins/.paper-remapped, prüfe zuerst die ursprünglichen JAR-Dateien im Ordner plugins auf doppelte Ausgaben.
  4. Starte den Server und prüfe in der Konsole, ob die Warnung verschwunden ist und das gewünschte Plugin lädt.

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.

„Error loading plugin“: Plugin-Datei oder Plugin-Name ungültig

So sieht die Meldung aus:

[DirectoryProviderSource] Error preparing plugin context: Directory 'plugins/<Datei>.jar' failed to update!
[DirectoryProviderSource] Error loading plugin: Directory 'plugins/<Datei>.jar' failed to load!
[DirectoryProviderSource] Error loading plugin: Restricted name, cannot use 0x20 (space character) in a plugin name.

Was dahintersteckt: Eine Datei im Ordner plugins lässt sich nicht laden; das Plugin startet nicht. Häufig liegt dort Quelltext (-sources.jar), Dokumentation (-javadoc.jar), ein unvollständiger Download oder eine Ausgabe für eine andere Plattform. „Invalid plugin.yml“ und „only DEFLATED entries can have EXT descriptor“ weisen ebenfalls auf eine ungeeignete Datei hin. „Restricted name“ mit „0x20“ bedeutet, dass der in plugin.yml hinterlegte Plugin-Name ein Leerzeichen enthält.

So behebst du es:

  1. Stoppe den Server und entferne die genannte JAR unter Dateien aus plugins.
  2. Lade die eigentliche Plugin-JAR von der offiziellen Seite herunter, passend zu Paper oder Spigot. Fabric- oder Forge-Mods gehören nicht in deren plugins-Ordner.
  3. Kommt der Download als ZIP, entpacke ihn am eigenen Rechner und lade die passende JAR hoch.
  4. Bei „Restricted name“ verwende eine vom Entwickler korrigierte Ausgabe. Der hinterlegte Plugin-Name muss korrigiert werden; ein anderer Dateiname behebt diesen Fehler nicht.
  5. Starte neu und prüfe die Konsole.

Gut zu wissen: Bewahre vorhandene Plugin-Daten und Konfigurationen beim Austausch der JAR auf.

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.

PlaceholderAPI: Erweiterungsdatei enthält keine ladbare Erweiterungsklasse

So sieht die Meldung aus:

[PlaceholderAPI] Failed to load expansion <Datei>.jar, as it does not have a class which extends PlaceholderExpansion

Was dahintersteckt: Eine PlaceholderAPI-Erweiterung liefert zusätzliche Textplatzhalter. Die JAR-Datei wird untersucht, aber die nötige Erweiterungsklasse lässt sich nicht finden oder laden. Diese Erweiterung bleibt aus. Der Server läuft weiter; ihre Platzhalter liefern keine vorgesehenen Werte.

So behebst du es:

  1. Lies in der Konsole die Meldungen vor diesem Fehler. Weitere Ladefehler können eine fehlende Abhängigkeit nennen.
  2. Prüfe unter Dateien, ob die genannte Datei wirklich die gewünschte PlaceholderAPI-Erweiterung ist. Sichere sie vor dem Austausch.
  3. Lade die zur installierten PlaceholderAPI-Version passende Erweiterung aus ihrer offiziellen Quelle neu herunter. Ersetze die betroffene Datei und entferne doppelte Ausgaben derselben Erweiterung.
  4. Starte den Server vollständig neu. Prüfe danach die Startmeldung und einen von der Erweiterung bereitgestellten Platzhalter.

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.

Den passenden Server bestellst du hier: Minecraft Server mieten.