Plugins auf einem Minecraft-Server installieren (Paper, Purpur)

Plugins ergänzen Ihren Server um Befehle, Bauschutz, ein Wirtschaftssystem, Minispiele und vieles mehr. Die Spieler müssen nichts installieren. Diese Anleitung beschreibt die Installation mit einem Klick direkt im Kundenbereich ebenso wie das Hochladen einer Datei von Hand, die Einstellung eines Plugins, Updates und die Lösung der häufigsten Fehler.

Bevor Sie beginnen#

• Plugins funktionieren nur auf Paper, Purpur und Folia. Fabric, Forge und NeoForge verwenden statt Plugins Mods, und die Registerkarte heißt Mods, siehe Mods und Modpacks. Vanilla unterstützt keines von beiden. Den Unterschied erklärt der Artikel Plugins oder Mods?
• Das Plugin muss Ihre Minecraft-Version unterstützen. Ein Plugin für eine ältere Version lädt oft nicht oder verhält sich unvorhersehbar.
• Auf Folia funktioniert nur eine Minderheit der Plugins. Das Plugin muss die Unterstützung für Folia ausdrücklich angeben.
• Ein Plugin kann auf dem Server alles. Die Dokumentation von Paper weist darauf hin, dass Plugins vollen, uneingeschränkten Zugriff auf den Server haben. Installieren Sie Plugins nur aus vertrauenswürdigen Quellen.

Installation über den Kundenbereich#

1. Öffnen Sie Meine Dienste, klicken Sie auf Ihren Server und wechseln Sie in die Registerkarte Plugins.

2. Klicken Sie auf die Unterregisterkarte Durchsuchen. Ohne Suche sehen Sie die meistgeladenen Plugins für Ihren Servertyp und Ihre Version.

3. Wählen Sie im Umschalter Quelle einen Katalog (Erklärung unten). Beginnen Sie mit Modrinth.

4. Geben Sie in das Feld „Plugins suchen“ einen Namen ein, zum Beispiel LuckPerms, und klicken Sie auf Suchen.

5. Klicken Sie beim Plugin auf Installieren. Möchten Sie eine andere als die neueste Version, klicken Sie zuerst auf Versionen und wählen sie aus der Liste.

6. Sehen Sie sich den Dialog Installation von … an:

   • Hauptdatei – die Datei des Plugins, die in den Ordner plugins hochgeladen wird.
   • Erforderliche Abhängigkeiten – andere Plugins, ohne die es nicht startet. Der Kundenbereich installiert sie mit. Wählen Sie nur die ab, die Sie bereits selbst hochgeladen haben.
   • Warnungen zu gleichnamigen Dateien, die die Installation überschreibt, und zu Plugins, mit denen es laut Autor nicht zusammenarbeitet.
   • Download – die Gesamtgröße.

7. Klicken Sie auf Installieren.

   Danach sehen Sie die Meldung Installiert: mit einer Liste der Dateien und dem Hinweis „Änderungen wirken nach einem Serverneustart“.

8. Klicken Sie auf Neu starten und bestätigen Sie. Plugins werden nur beim Start des Servers geladen.

Quellen für Plugins#

Die Prüfsumme bestätigt, dass die Datei genau so auf dem Server angekommen ist, wie der Autor sie veröffentlicht hat. Plugins, die es nur auf SpigotMC oder der Website des Autors gibt, laden Sie von Hand hoch, siehe Manuelle Installation.

Weitere Kennzeichnungen in den Ergebnissen:

• Nur extern – der Autor hostet die Datei woanders (oft kostenpflichtige Plugins). Sie lässt sich nicht automatisch installieren; laden Sie sie von der Seite des Autors herunter und von Hand hoch.
• Nicht getestet auf … – der Autor gibt für diese Version keine Unterstützung Ihrer Minecraft-Version an. Sie kann funktionieren, eine Garantie gibt es aber nicht.
• Stabil, Beta, Alpha – der Veröffentlichungskanal. Installieren Sie auf einem Server mit Spielern stabile Versionen.

Manuelle Installation#

Von Hand laden Sie Plugins hoch, die nicht im Katalog sind, zum Beispiel kostenpflichtige.

1. Laden Sie das Plugin von der offiziellen Seite des Autors oder aus einem Katalog (Modrinth, Hangar, SpigotMC) auf Ihren Computer herunter. Die Datei muss die Endung .jar haben. Haben Sie eine .zip heruntergeladen, entpacken Sie sie auf dem Computer und suchen Sie darin die .jar.
2. Wechseln Sie im Kundenbereich in die Registerkarte Dateien und öffnen Sie den Ordner plugins.
3. Klicken Sie auf Hochladen und wählen Sie die .jar-Datei. Sie können sie auch mit der Maus in die Liste ziehen. Eine einzelne Datei darf höchstens 100 MB groß sein.
4. Starten Sie den Server in der Registerkarte Konsole mit der Schaltfläche Neustart neu.

Das Plugin muss direkt im Ordner plugins liegen. Unterordner liest der Server nicht. In der Registerkarte Plugins erscheint ein von Hand hochgeladenes Plugin mit der Kennzeichnung Manuell hochgeladen. Version und Updates eines solchen Plugins verfolgt der Kundenbereich nicht.

Überprüfung#

1. Beobachten Sie nach dem Neustart die Konsole. Ein erfolgreich geladenes Plugin meldet sich mit einer Zeile wie dieser:

   [12:00:08 INFO]: [LuckPerms] Enabling LuckPerms v<VERSION>

   Statt <VERSION> sehen Sie die Versionsnummer des Plugins.

2. Geben Sie in der Konsole plugins ein. Der Befehl listet die Plugins auf. Im Spiel sehen Sie Farben: laufende Plugins grün, Plugins, die sich nicht aktivieren ließen, rot.

3. Der Befehl version <PLUGIN_NAME> zeigt Details zu einem bestimmten Plugin, zum Beispiel version LuckPerms.

Ein Plugin einstellen (config.yml)#

Die meisten Plugins legen beim ersten Start einen Ordner plugins/<PLUGIN_NAME> mit einer Datei config.yml an. LuckPerms speichert seine Einstellungen zum Beispiel in plugins/LuckPerms/config.yml.

1. Stoppen Sie den Server in der Registerkarte Konsole mit der Schaltfläche Stopp. Manche Plugins schreiben ihre Datei beim Herunterfahren neu, und Ihre Änderungen gingen verloren.
2. Öffnen Sie in der Registerkarte Dateien die Datei plugins/<PLUGIN_NAME>/config.yml und klicken Sie auf Bearbeiten.
3. Ändern Sie die Werte und speichern Sie (Strg+S).
4. Starten Sie den Server.

.yml-Dateien verwenden das Format YAML. Es ist bei Kleinigkeiten pingelig:

# Eine Zeile mit einer Raute am Anfang ist ein Kommentar; der Server ignoriert sie.
nastaveni:
  zprava: "&aWillkommen auf dem Server!"
  max-domovu: 3
  zapnuto: true
  zakazane-svety:
    - world_nether
    - world_the_end

• Rücken Sie nur mit Leerzeichen ein, nie mit Tabulatoren. Ein Tabulator verursacht einen Ladefehler. Die Einrückung entscheidet, was wozu gehört (zprava gehört unter nastaveni).
• Setzen Sie nach dem Doppelpunkt immer ein Leerzeichen: max-domovu: 3, nicht max-domovu:3.
• Setzen Sie Text mit Sonderzeichen in Anführungszeichen. Vor allem Text, der mit & beginnt oder : oder # enthält.
• Eine Liste ist eine Reihe von Zeilen, die mit Bindestrich und Leerzeichen beginnen und unter dem Schlüssel eingerückt sind.
• true und false bedeuten ein und aus.

Plugins aktualisieren#

1. Bleiben Sie in der Registerkarte Plugins auf der Unterregisterkarte Installiert.
2. Klicken Sie auf Nach Updates suchen. Sie sehen entweder „Alles ist aktuell.“ oder „Verfügbare Updates:“ mit einer Anzahl.
3. Klicken Sie beim Plugin auf Auf … aktualisieren, prüfen Sie den Dialog und bestätigen Sie mit Aktualisieren.
4. Starten Sie den Server neu.

Lesen Sie vor dem Update das Changelog auf der Projektseite (Link Projektseite). Große Versionssprünge (zum Beispiel von 2.x auf 3.x) können die Konfiguration verändern. Erstellen Sie vor einem größeren Update ein Backup, siehe Backups von Gameservern. Um ein von Hand hochgeladenes Plugin zu aktualisieren, löschen Sie die alte .jar und laden die neue hoch. Zwei Dateien desselben Plugins in einem Ordner verursachen einen Fehler.

Ein Plugin deaktivieren und entfernen#

• Deaktivieren – das Plugin wird beim nächsten Start nicht geladen, bleibt aber samt Einstellungen auf der Festplatte. Die Datei wird in <file>.jar.disabled umbenannt. Die Schaltfläche Aktivieren holt es zurück.
• Entfernen – löscht die Datei des Plugins aus dem Ordner plugins. Einstellungen und Daten des Plugins im Ordner plugins/<PLUGIN_NAME> bleiben erhalten, sodass das Plugin sie bei einer erneuten Installation wiederfindet.

Änderungen wirken nach einem Neustart des Servers.

Sicherheit#

• Laden Sie Plugins nur aus Katalogen (Modrinth, Hangar, SpigotMC) oder von der offiziellen Seite des Autors herunter.
• Installieren Sie nie „gecrackte“ oder „geleakte“ kostenpflichtige Plugins. Sie sind oft so verändert, dass ein Angreifer die Kontrolle über Ihren Server übernehmen oder Operator-Rechte erlangen kann.
• Installieren Sie keine Plugins, die seit Jahren niemand aktualisiert hat. Sie funktionieren mit neuen Versionen oft nicht und haben bekannte Fehler.
• Installieren Sie keine Plugins nebeneinander, die dasselbe tun (zum Beispiel zwei Berechtigungs-Plugins).

Bewährte Tipps für Plugins finden Sie im Artikel Empfohlene Plugins.

Fehlerbehebung#

Suchen Sie Fehler von Plugins beim Start des Servers in der Konsole. Das vollständige Log steht in der Datei logs/latest.log (Registerkarte Dateien).

Could not load 'plugins/….jar' in folder 'plugins' und UnknownDependencyException#

[00:00:00] [Server thread/WARN] Could not load 'plugins/MyAwesomePlugin-1.0.0.jar' in folder 'plugins'
[00:00:00] [Server thread/WARN] org.bukkit.plugin.UnknownDependencyException: Unknown/missing dependency plugins: [Vault]. Please download and install these plugins to run 'MyAwesomePlugin'.

Dem Plugin fehlt ein anderes Plugin, von dem es abhängt. Sein Name steht in den eckigen Klammern (hier Vault). Installieren Sie es und starten Sie den Server neu.

Invalid plugin.yml#

Die Datei ist kein Paper-Plugin. Meist ist es ein Mod für Fabric oder Forge oder ein unvollständiger Download. Laden Sie die richtige Datei erneut herunter.

Ambiguous plugin name#

Im Ordner plugins liegen zwei Versionen desselben Plugins. Löschen Sie die ältere Datei.

UnsupportedClassVersionError … class file version 69.0#

Das Plugin braucht ein neueres Java, als der Server verwendet. Die Klassenversion entspricht Java: 65 = Java 21, 69 = Java 25. Das Plugin ist höchstwahrscheinlich für eine neuere Minecraft-Version gemacht. Laden Sie die Version des Plugins für Ihre Minecraft-Version herunter oder aktualisieren Sie den Server, siehe Version und Software ändern.

Error occurred while enabling … (Is it up to date?)#

Das Plugin wurde geladen, ist aber beim Aktivieren abgestürzt. Unter dieser Zeile steht die Fehlerausgabe. Die häufigsten Ursachen sind eine nicht unterstützte Minecraft-Version, eine fehlende Abhängigkeit oder ein Fehler in seiner Konfiguration. Prüfen Sie die Version des Plugins und gehen Sie seine config.yml durch.

Das Plugin meldet einen Fehler in der config.yml#

Die Konsole zeigt einen YAML-Fehler mit Zeilennummer, oft InvalidConfigurationException, mapping values are not allowed here oder einen Hinweis auf einen Tabulator. Öffnen Sie die Datei und prüfen Sie diese Zeile: ein Tabulator statt Leerzeichen, ein fehlendes Leerzeichen nach einem Doppelpunkt oder Text mit Sonderzeichen ohne Anführungszeichen.

Der Server startet nach der Installation eines Plugins nicht, und Sie wissen nicht, welches es ist#

Deaktivieren Sie die Plugins in Etappen. Deaktivieren Sie in der Registerkarte Plugins die Hälfte, starten Sie neu und machen Sie je nach Ergebnis mit der Hälfte weiter, in der das Problem steckt. Ein Plugin können Sie auch von Hand deaktivieren, indem Sie seine Datei umbenennen, zum Beispiel in Plugin.jar.disabled.

„Auf dem Server läuft gerade eine Softwareänderung oder eine Modpack-Installation“#

Warten Sie, bis die Änderung in der Registerkarte Software abgeschlossen ist. Danach können Sie Plugins wieder bearbeiten.

Können Sie den Fehler nicht beheben, senden Sie uns die Datei logs/latest.log, siehe So erreichen Sie den Support.

Weiterführende Links#

• Paper: Plugins hinzufügen (öffnet sich in einem neuen Fenster)
• Paper: grundlegende Fehlerbehebung (öffnet sich in einem neuen Fenster)
• Hangar (öffnet sich in einem neuen Fenster)
• Modrinth: Plugins (öffnet sich in einem neuen Fenster)