Plugin-Probleme beheben

Plugins funktionieren meist einwandfrei, aber manchmal geht etwas schief. Eine Plugin, die nicht lädt, ein Konflikt zwischen zwei Plugins oder mysteriöse Fehlermeldungen in der Console. In diesem Artikel lernst du, wie du die häufigsten Plugin-Probleme erkennst und behebst.

Plugin lädt nicht: häufigste Ursachen

Wenn eine Plugin nicht in /plugins erscheint oder rot eingefärbt ist, ist beim Laden etwas schiefgelaufen. Das sind die häufigsten Ursachen:

1. Falsche Minecraft-Version

Die häufigste Ursache. Eine Plugin, die für Minecraft 1.20 erstellt wurde, funktioniert nicht immer auf 1.21 und umgekehrt. Überprüfe auf der Download-Seite der Plugin, welche Versionen unterstützt werden. In der Console siehst du dann oft eine Fehlermeldung wie:

[Server] ERROR Could not load 'plugins/PluginName.jar'
Caused by: java.lang.UnsupportedClassVersionError

Lösung: Lade die richtige Version der Plugin herunter, die zu deiner Minecraft-Version passt. Auf SpigotMC findest du unter „Version History“ ältere Versionen.

2. Fehlende Abhängigkeiten (Dependencies)

Viele Plugins brauchen andere Plugins, um zu funktionieren. Zum Beispiel: WorldGuard braucht WorldEdit, und viele Plugins brauchen Vault. Wenn eine Abhängigkeit fehlt, siehst du das in der Console:

[Server] ERROR Could not load 'plugins/WorldGuard.jar'
Caused by: org.bukkit.plugin.UnknownDependencyException: WorldEdit

Lösung: Lies auf der Plugin-Seite, welche Abhängigkeiten benötigt werden, und installiere diese zuerst. Die Fehlermeldung sagt dir genau, welche Plugin fehlt.

3. Falscher Servertyp

Eine Bukkit/Spigot-Plugin funktioniert nicht auf einem Forge- oder Fabric-Server, und eine Forge-Mod funktioniert nicht auf einem Paper-Server. Stelle sicher, dass deine Plugin zu deinem Servertyp passt.

Lösung: Überprüfe deinen Servertyp im Startup-Tab deines Servers im Panel. Wenn du Plugins verwenden möchtest, musst du Paper, Spigot oder Purpur betreiben.

4. Beschädigte Datei

Manchmal ist ein Download nicht vollständig, wodurch die .jar-Datei beschädigt ist.

Lösung: Lösche die Datei und lade die Plugin erneut herunter. Überprüfe, ob die Dateigröße mit der auf der Download-Seite übereinstimmt.

Konflikte zwischen Plugins

Manchmal funktionieren zwei Plugins nicht gut zusammen. Das kann sich als Abstürze, nicht funktionierende Befehle oder unerwartetes Verhalten äußern. Häufige Konflikte:

Zwei Permissions-Plugins – Verwende nur eines (LuckPerms ist die beste Wahl).
Zwei Economy-Plugins – Wenn du EssentialsX Economy verwendest, installiere keine zweite Economy-Plugin, es sei denn, du weißt, was du tust.
Überlappende Funktionen – Zwei Plugins, die dieselben Befehle registrieren (wie zwei Chat-Plugins), können kollidieren.

Wie man Konflikte aufspürt:

Problem isolieren – Entferne alle Plugins außer der Plugin, die Probleme macht. Funktioniert sie allein? Füge dann eine nach der anderen die anderen Plugins wieder hinzu, bis das Problem zurückkommt. So findest du, welche Kombination den Konflikt verursacht.
Console prüfen – Oft geben Plugins Warnungen aus, wenn es einen Konflikt gibt.
Online suchen – Suche bei Google nach „[Plugin A] conflict [Plugin B]“. Oft hatten andere Serverbetreiber dasselbe Problem schon und eine Lösung gefunden.

Fehlermeldungen in der Console erkennen

Die Console ist dein wichtigstes Werkzeug bei der Problemlösung. Hier lernst du, die häufigsten Meldungstypen zu erkennen:

INFO (weiß/grau) – Normale Nachrichten. Plugins protokollieren hier ihre Aktivitäten. Kein Grund zur Sorge.

[EssentialsX] INFO Enabling EssentialsX v2.20.1
[LuckPerms] INFO Loading configuration...

WARN (gelb) – Warnungen. Die Plugin funktioniert wahrscheinlich noch, aber etwas braucht Aufmerksamkeit.

[Plugin] WARN Configuration option 'x' is deprecated, please use 'y' instead

ERROR (rot) – Fehler. Hier geht etwas schief. Die Plugin funktioniert möglicherweise nicht korrekt.

[Plugin] ERROR An error occurred while enabling PluginName
java.lang.NullPointerException
    at com.example.plugin.Main.onEnable(Main.java:45)

Was machst du bei einem ERROR?

Lies die erste Zeile – Sie sagt dir, welche Plugin den Fehler verursacht und was schiefgegangen ist.
Fehlermeldung kopieren – Markiere den vollständigen Fehler (einschließlich der „stack trace“-Zeilen mit at ...) und kopiere ihn.
Online suchen – Füge die Fehlermeldung bei Google ein. Oft findest du eine Lösung in SpigotMC-Foren oder GitHub-Issues.
Dem Entwickler melden – Wenn du keine Lösung findest, melde den Fehler auf der Plugin-Seite mit deiner Minecraft-Version, Servertyp, Java-Version und der vollständigen Fehlermeldung.
Frag uns – Unser Support-Team hilft dir gerne. Sende ein Ticket mit einem Screenshot oder einer Kopie der Fehlermeldung.

Eine Plugin vollständig entfernen

Wenn du eine Plugin entfernen möchtest, reicht es nicht, nur die .jar-Datei zu löschen. Folge diesen Schritten für eine saubere Entfernung:

Server stoppen – Entferne niemals eine Plugin, während der Server läuft.
.jar-Datei löschen – Gehe zum Dateien-Tab, öffne den plugins-Ordner und lösche die .jar-Datei der Plugin.
Config-Ordner löschen – Im plugins-Ordner gibt es auch einen Ordner mit dem Namen der Plugin (zum Beispiel plugins/EssentialsX/). Lösche diesen Ordner, wenn du die Plugin wirklich nicht mehr brauchst. Wenn du die Plugin später vielleicht zurückhaben möchtest, kannst du den Ordner stehen lassen, damit deine Konfiguration erhalten bleibt.
Server starten – Starte den Server wieder und überprüfe die Console auf Fehlermeldungen. Wenn andere Plugins von der entfernten Plugin abhingen, können diese jetzt Fehler ausgeben.

Schnelle Checkliste bei Problemen

Wenn eine Plugin nicht funktioniert, gehe diese Checkliste durch:

Ist die Plugin mit deiner Minecraft-Version kompatibel?
Betreibst du den richtigen Servertyp (Paper/Spigot/Purpur)?
Sind alle Abhängigkeiten installiert?
Hast du den Server neu gestartet (nicht nur reloaded)?
Steht die Plugin als grün in /plugins?
Gibt es Fehler in der Console?
Hast du die neueste Version der Plugin?
Gibt es Konflikte mit anderen Plugins?

Kommst du nicht weiter? Kein Problem! Öffne ein Ticket über das HytaleNode-Panel oder sende uns eine Nachricht. Sende dabei immer einen Screenshot der Fehlermeldung in der Console mit, dann können wir dir schneller helfen.

Plugin-Probleme beheben