Plugins auf einem Paper-Minecraft-Server installieren

Um ein Plugin auf einem Paper-Minecraft-Server zu installieren, lädst du die passende .jar herunter, stoppst den Server, legst die Datei direkt in den Ordner plugins und startest den Server erneut. Anschließend prüfst du die Konsole und bestätigst mit /plugins, dass das Plugin geladen wurde.

Der Ablauf ist einfach. Eine falsche Version, fehlende Abhängigkeiten oder doppelte JAR-Dateien können jedoch verhindern, dass das Plugin oder sogar der gesamte Server korrekt startet.

Vor der Installation

Prüfe zuerst diese vier Punkte:

1. Der Server nutzt Paper. Ein Vanilla-Server kann keine Plugins laden. Spigot- und Bukkit-Plugins sind häufig kompatibel, diese Anleitung ist aber für Paper gedacht.
2. Das Plugin unterstützt deine Minecraft-Version. Lies die Downloadseite und die Versionshinweise. Verlasse dich nicht darauf, dass ein altes Plugin automatisch mit einer neuen Version funktioniert.
3. Die Datei stammt aus einer vertrauenswürdigen Quelle. Nutze möglichst die offizielle Projektseite, Hangar, Modrinth oder SpigotMC. Meide inoffizielle Reupload-Seiten.
4. Ein Backup ist vorhanden. Sichere Welt und Konfiguration, bevor du wichtige Plugins änderst. Unsere Backup-Checkliste für Minecraft-Server hilft dir dabei.

Wenn du noch nicht weißt, was du brauchst, beginne mit unseren wichtigsten Minecraft-Server-Plugins. Ein kleiner, sinnvoller Stack ist leichter zu pflegen als zwanzig Plugins auf einmal.

Paper-Plugins Schritt für Schritt installieren

1. Die richtige Datei herunterladen

Lade eine Plugin-Version herunter, die deine Minecraft- und Paper-Version unterstützt. Der Server benötigt normalerweise eine Datei mit der Endung .jar.

Wenn du eine .zip erhältst, lies vor dem Upload die Anleitung des Projekts. Das Archiv kann Dokumentation oder mehrere Dateien für verschiedene Plattformen enthalten. Dann musst du zuerst die richtige JAR entpacken.

Prüfe außerdem die Abhängigkeiten. Manche Plugins benötigen beispielsweise Vault, ProtocolLib oder ein anderes Plugin, bevor sie geladen werden können.

2. Den Server stoppen

Stoppe den Server über das Panel und warte, bis die Konsole das Herunterfahren bestätigt. Ersetze keine Dateien, während Paper die Welt speichert.

Ein vollständiger Stopp reduziert das Risiko unvollständiger Dateien und verhindert, dass eine alte Plugin-Version im Speicher aktiv bleibt.

3. Die JAR in plugins hochladen

Öffne den Dateimanager des Servers, gehe in den Ordner plugins und lade dort die .jar hoch. Die Datei muss direkt in diesem Ordner liegen, nicht in einem Unterordner.

Der Pfad sollte so aussehen:

/plugins/PluginName.jar

Falls plugins noch nicht existiert, starte Paper einmal und stoppe den Server danach wieder. Paper erstellt seine Arbeitsordner beim ersten Start.

4. Den Server erneut starten

Starte den Server und beobachte die Konsole. Paper erkennt beim Start die JAR-Dateien, prüft Abhängigkeiten und aktiviert gültige Plugins.

Nutze einen vollständigen Neustart. /reload ist keine sichere Methode, um Plugin-JARs auf einem laufenden Server zu ersetzen. Aufgaben, Befehle oder Konfigurationen können dabei in einem fehlerhaften Zustand bleiben.

5. Prüfen, ob das Plugin aktiv ist

Führe nach dem Start diesen Befehl aus:

/plugins

In der Konsole kannst du auch plugins eingeben. Ein aktiviertes Plugin erscheint normalerweise grün; ein deaktiviertes oder fehlerhaft geladenes Plugin kann rot angezeigt werden.

Verlasse dich nicht nur auf die Liste. Suche in der Startkonsole oder in logs/latest.log nach WARN- und ERROR-Meldungen mit dem Plugin-Namen. Das Log nennt meist eine fehlende Abhängigkeit, eine ungültige JAR oder eine nicht unterstützte Version.

Plugin konfigurieren und testen

Viele Plugins erstellen nach dem ersten erfolgreichen Start einen eigenen Ordner:

/plugins/PluginName/

Darin befinden sich häufig config.yml, Sprachdateien und Plugin-Daten. Stoppe den Server vor größeren Änderungen, beachte die YAML-Einrückung und bewahre eine Kopie der ursprünglichen Konfiguration auf.

Nach der Konfiguration:

1. Server neu starten;
2. Konsole prüfen;
3. Befehle mit einem Account ohne OP testen;
4. sicherstellen, dass normale Spieler nur die nötigen Rechte besitzen.

Mit unserem LuckPerms-Grundlagen-Guide kannst du Gruppen und Befehlsrechte sauber organisieren.

Häufige Fehler bei der Plugin-Installation

Problem	Wahrscheinliche Ursache	Lösung
Plugin erscheint nicht	JAR liegt in einem Unterordner, ist noch gezippt oder kein Plugin	.jar direkt in plugins legen und neu starten
Plugin erscheint rot	Abhängigkeit fehlt oder Version ist inkompatibel	logs/latest.log und Downloadseite prüfen
Server startet nicht	Falsche JAR, defekte Abhängigkeit oder Konflikt	Neuestes Plugin entfernen, erneut starten und den vollständigen Fehler lesen
Warnung „Ambiguous plugin name“	Zwei Versionen desselben Plugins sind vorhanden	Nur eine JAR behalten und neu starten
Befehl existiert, Spieler darf ihn aber nicht nutzen	Rechte fehlen	Passende Rechte mit LuckPerms vergeben
Ordner plugins fehlt	Server nutzt nicht Paper oder wurde noch nie gestartet	Server-Software prüfen und Paper einmal starten

Installiere und teste Plugins einzeln. Wenn du vor einem Neustart fünf JARs änderst, lässt sich die Ursache eines Fehlers deutlich schwerer finden.

Plugin aktualisieren oder entfernen

So aktualisierst du ein Plugin:

1. Backup erstellen;
2. Server stoppen;
3. alte JAR entfernen;
4. kompatible neue Version hochladen;
5. prüfen, dass keine zweite Kopie vorhanden ist;
6. Server starten und Konsole kontrollieren.

Den Datenordner des Plugins behältst du normalerweise. Lies trotzdem die Versionshinweise, falls ein Update das Konfigurationsformat ändert.

Zum Entfernen stoppst du den Server, löschst die JAR und startest erneut. Bewahre den Datenordner auf, bis du sicher bist, dass du die alte Konfiguration nicht mehr brauchst.

Plugins und Mods sind nicht dasselbe

Paper lädt Plugins für die Paper-, Bukkit- oder Spigot-API. Mods für Fabric, Forge oder NeoForge verwenden andere Loader und funktionieren nicht, wenn du sie einfach in plugins legst.

Wähle eine Mod-Server-Software für ein Modpack und prüfe, ob Spieler dieselben Mods installieren müssen. Paper passt besser, wenn du serverseitige Befehle, Rechte, Schutz und Admin-Werkzeuge möchtest, ohne die Clients aller Spieler zu verändern.

Abschließende Checkliste

• Paper ist als Server-Software ausgewählt.
• Die JAR stammt aus einer vertrauenswürdigen Quelle und unterstützt deine Version.
• Abhängigkeiten wurden geprüft.
• Ein aktuelles Backup ist vorhanden.
• Die Datei liegt direkt in plugins.
• Du hast vollständig neu gestartet und nicht /reload verwendet.
• /plugins und logs/latest.log bestätigen den erfolgreichen Start.
• Befehle und Rechte wurden mit einem normalen Account getestet.

Bei Mineando verwaltest du Serverdateien und Konsole über das Panel. Installiere zuerst ein Plugin, prüfe es und füge das nächste erst hinzu, wenn die Basis stabil läuft. Damit vermeidest du die meisten schwer zu diagnostizierenden Probleme.

Die wichtigste technische Referenz für diesen Ablauf ist die Paper-Dokumentation zu Plugins.