Paper Plugins installieren: Ordner, Updates und Fehlerquellen

Plugins erweitern einen Paper-Server serverseitig. Spieler benötigen dafür normalerweise keine identische Plugin-Datei auf dem Client. Die technische Installation ist einfach; die eigentliche Arbeit liegt in Kompatibilität, Konfiguration und sicherer Herkunft.

Plugin-JAR in den richtigen Ordner legen

Paper lädt klassische Plugins aus plugins/. Nach dem Neustart legt ein Plugin häufig einen eigenen Unterordner für Konfiguration und Daten an.

minecraft-paper/
  plugins/
    ExamplePlugin.jar
    ExamplePlugin/
      config.yml

Vorher Version und Plattform prüfen

Nicht jede JAR ist für jede Minecraft-Version und nicht jedes Plugin für jede Serverplattform gedacht. Lies die Projektseite des Plugins und prüfe mindestens:

• unterstützte Minecraft-Version
• Paper-/Spigot-/Bukkit-Kompatibilität
• erforderliche Abhängigkeiten
• Java-Anforderungen
• bekannte Inkompatibilitäten

Server neu starten

Ein sauberer Neustart ist für Installationen und Updates die sicherste Variante. Verlasse dich nicht auf pauschale Reload-Kommandos, wenn ein Plugin das nicht ausdrücklich unterstützt.

Wenn das Plugin nicht geladen wird

Der erste Blick geht in logs/latest.log. Suche nach Pluginname, ERROR, fehlenden Dependencies und Versionsmeldungen. Wenn gar nichts zum Plugin auftaucht, prüfe Dateiendung, Verzeichnis und ob die JAR wirklich ein gültiges Plugin ist.

Plugins aktualisieren

Paper dokumentiert einen update/-Ordner innerhalb von plugins/, über den neue Pluginversionen für den nächsten Neustart vorbereitet werden können. Unabhängig davon solltest du vor größeren Updates Welt, Plugin-Daten und Konfiguration sichern.

Alte Plugin-Dateien aufräumen

Halte nicht mehrere Versionen desselben Plugins gleichzeitig im Plugin-Ordner. Das erschwert Diagnose und kann zu doppelten oder fehlerhaften Ladevorgängen führen.

Konfiguration versionieren

Bei wichtigen Servern lohnt es sich, Textkonfigurationen separat zu sichern oder in einem privaten Versionssystem zu verwalten. So siehst du, welche Einstellung sich zwischen zwei funktionierenden Zuständen verändert hat.

Sicherheit ist Teil der Installation

Paper weist ausdrücklich darauf hin, dass Plugins vollen und uneingeschränkten Zugriff auf Server und Maschine erhalten können. Behandle eine Plugin-JAR deshalb wie ausführbaren Code und nicht wie eine harmlose Textdatei.

Weiter: Minecraft Plugin-Sicherheit.

Abhängigkeiten als Teil des Betriebs behandeln

Viele größere Plugins bauen auf Bibliotheken oder anderen Plugins auf. Dokumentiere diese Abhängigkeiten zusammen mit der eigentlichen Pluginliste. Wenn ein Basisplugin beim Update ausfällt, können mehrere scheinbar unabhängige Funktionen gleichzeitig verschwinden. Das Log nennt in solchen Fällen häufig fehlende oder inkompatible Dependencies.

Rollback vorbereiten

Bewahre bei produktiven Servern nicht nur das aktuelle Plugin, sondern auch die zuletzt funktionierende Version und die dazu passende Konfiguration auf. Wenn ein Update Probleme verursacht, kannst du kontrolliert auf einen bekannten Stand zurückgehen. Ein Rollback sollte jedoch nicht blind auf Datenbanken oder Datenformate angewendet werden, wenn das Plugin diese beim Update migriert hat; lies deshalb vor größeren Versionssprüngen die Updatehinweise.