Plugins auf Minecraft-Servern; Es betreibt das Autorisierungssystem, Wirtschaft, Schutz, Markt, Event, Anspruch, Anti-Cheat und viele spezielle Systeme. Wenn eines der Plugins nicht installiert ist, funktioniert möglicherweise ein erheblicher Teil des Servers nicht.

Plugin-Fehler treten normalerweise in der Konsole oder auf logs/latest.log erscheint in der Datei. Die häufigsten Fehler; Plugin konnte nicht geladen werden, Nicht unterstützte API-Version, unbekannte Abhängigkeit, Ungültige Plugin.yml und Java-Versionsinkompatibilitäten.

1. Wo können Sie den Plugin-Fehler sehen?

Wenn das Plugin nicht geladen wird, schauen Sie zunächst in der Serverkonsole und in der Datei „latest.log“ nach.

tail -n 200 logs/latest.log

Für Live-Tracking:

tail -f logs/latest.log

So suchen Sie nach Plugin-Namen:

grep -i "pluginadi" logs/latest.log

2. Nicht unterstützter API-Versionsfehler

Dieser Fehler weist darauf hin, dass die vom Plugin unterstützte Minecraft-API-Version nicht mit der Serverversion kompatibel ist.

Unsupported API version 1.20

Beispielsweise ist das Plugin möglicherweise für 1.20 vorbereitet, auf Ihrem Server läuft jedoch möglicherweise 1.16.5. In diesem Fall wird das Plugin möglicherweise nicht geladen oder funktioniert nicht ordnungsgemäß.

Lösung:

• Überprüfen Sie die vom Plugin unterstützte Minecraft-Version.
• Laden Sie die Plugin-Version herunter, die mit Ihrer Serverversion kompatibel ist.
• Erwarten Sie nicht, dass neue Plugins auf sehr alten Servern funktionieren.
• Suchen Sie bei Bedarf die entsprechende Version aus dem alten Versionsarchiv des Plugins.

3. Unbekannter Abhängigkeitsfehler

Einige Plugins funktionieren nicht alleine. Es fordert dazu auf, zunächst ein weiteres Plugin zu installieren. Dies nennt man Abhängigkeit.

Unknown dependency Vault
Could not load plugin because dependency LuckPerms was not found

Zum Beispiel oft Economy-Plugins Tresor will. Für Autorisierungs- oder Markt-Plugins sind möglicherweise auch andere Bibliotheks-Plugins erforderlich.

Lösung:

• Lesen Sie die Anforderungen auf der Plugin-Seite.
• Laden Sie das fehlende Abhängigkeits-Plugin herunter.
• Stellen Sie sicher, dass das Abhängigkeits-Plugin auch mit Ihrer Serverversion kompatibel ist.
• Starten Sie den Server vollständig neu.

4. Ungültiger Plugin.yml-Fehler

In der Plugin-JAR-Datei Plugin.yml Wenn die Datei beschädigt ist, fehlt oder falsch ist, kann das Plugin nicht installiert werden.

Invalid plugin.yml
Plugin does not contain a plugin.yml

Dies geschieht normalerweise, wenn:

• Die falsche Datei wurde heruntergeladen.
• Anstelle des Plugins wurde die Quellcode-ZIP-Datei im Plugins-Ordner abgelegt.
• Die Jar-Datei ist beschädigt.
• Das Plugin wurde vom Entwickler falsch gepackt.

Als Lösung ist das Plugin richtig. .jar Die Datei sollte heruntergeladen werden. Die von GitHub heruntergeladene Datei „source-code.zip“ sollte nicht direkt im Plugins-Ordner abgelegt werden.

5. Inkompatibilität der Java-Version

Für die Minecraft-Version und Plugins sind bestimmte Java-Versionen erforderlich. Wenn die falsche Java-Version verwendet wird, kann es sein, dass das Plugin oder der Server überhaupt nicht geöffnet wird.

java -version

Häufiger Fehler:

UnsupportedClassVersionError

Dieser Fehler weist darauf hin, dass das Plugin mit neuerem Java kompiliert wurde, auf dem Server jedoch älteres Java verwendet wird.

Allgemeine Logik:

• Ältere Minecraft-Versionen erfordern oft älteres Java.
• Neuere Minecraft-Versionen erfordern neueres Java.
• Die Java-Anforderung in der Plugin-Beschreibung sollte überprüft werden.
• Die ausgewählte Java-Version im Hosting-Panel muss überprüft werden.

6. Befindet sich die Plugin-Datei im richtigen Ordner?

Plugin-Dateien auf Bukkit-, Spigot- und Paper-Servern Plugins wird in den Ordner geworfen.

ls plugins/

Die Plugin-Datei sollte so aussehen:

plugins/PluginAdi.jar

Plugins, die in Zip, Rar, Quellcode oder Ordnern verbleiben, funktionieren oft nicht.

7. Plugin-Konflikte

Zwei Plugins, die die gleiche Aufgabe erfüllen, können miteinander in Konflikt geraten. Beispielsweise können zwei unterschiedliche Chat-Plugins, zwei unterschiedliche Wirtschafts-Plugins oder zwei unterschiedliche Anspruchssysteme versuchen, dieselben Ereignisse zu verwalten.

Konfliktsymptome:

• Das Plugin ist installiert, aber seine Befehle funktionieren nicht.
• Ein Plugin überfordert die Einstellungen eines anderen.
• In der Konsole tritt ein Ereigniskonflikt oder eine Ausnahme auf.
• Spieler können keine Befehle verwenden, selbst wenn sie die Erlaubnis dazu haben.
• Der Server verhält sich nach dem Neustart anders.

Um eine Lösung zu finden, können Plugins getestet werden, indem sie einzeln deaktiviert werden. Bevor dies jedoch auf dem Live-Server geschieht, sollte ein Backup erstellt und geringe Spielstunden bevorzugt werden.

8. Ein Konfigurationsfehler verhindert möglicherweise das Öffnen des Plugins

Einige Plugins werden nicht geöffnet, wenn in der Konfigurationsdatei ein YAML-Fehler vorliegt. Leerzeicheneinrückungen sind in YAML-Dateien besonders wichtig.

Häufige Fehler:

• Tabulatorzeichen verwenden
• Lassen Sie nach dem Doppelpunkt kein Leerzeichen
• Schreiben von Texten, die Anführungszeichen ohne Anführungszeichen erfordern
• Dateibeschädigung aufgrund türkischer Zeichen oder Sonderzeichen
• Fehlende Konfigurationsdatei wird gespeichert

Wenn eine falsche Konfigurationsdatei vorhanden ist, kann der Plugin-Ordner vorübergehend umbenannt werden, um den Plugin-Ordner zu sichern und die Konfiguration neu zu erstellen.

Häufige Fehler

• Installieren von Plugins, die nicht mit der Serverversion kompatibel sind
• Fehlende Abhängigkeits-Plugins werden nicht installiert
• Verwechselung der GitHub-Quell-ZIP-Datei mit einem Plugin
• Java-Version wird nicht überprüft
• Ich versuche, ein Plugin mit /reload zu installieren
• Verwendung von Tabs in YAML-Konfigurationsdateien

FAQ

Das Plugin befindet sich im Plugins-Ordner, funktioniert aber nicht. Warum?
Es kann sich um eine Versionsinkompatibilität, fehlende Abhängigkeiten, Java-Inkompatibilität oder einen Konfigurationsfehler handeln. Die Datei „latest.log“ sollte untersucht werden.

Was bedeutet UnsupportedClassVersionError?
Das Plugin wurde gerade mit Java kompiliert. Die auf dem Server verwendete Java-Version ist veraltet.

Ist die Verwendung von /reload sicher?
Für viele Plugins wird es nicht empfohlen. Ein vollständiger Neustart ist sicherer für die Installation und Entfernung von Plugins sowie für größere Konfigurationsänderungen.

Sicherheits- und Betriebsempfehlungen

• Laden Sie Plugins von zuverlässigen Quellen herunter.
• Bevor Sie das Plugin zum Live-Server hinzufügen, testen Sie es auf dem Testserver.
• Sichern Sie den Plugins-Ordner vor jedem Plugin-Update.
• Reduzieren Sie die Angriffsfläche, indem Sie unnötige Plugins entfernen.
• Überprüfen Sie regelmäßig die Plugin-Protokolle.

Dieser Artikel ist speziell für PvPServer vorbereitet.