Vor dem Upload: passt das Plugin zu deinem Server?
Ein Paper- oder Purpur-Server kann passende Bukkit-, Spigot- und Paper-Plugins laden. Ein Vanilla-Server lädt diese Plugins nicht; Fabric, Forge und NeoForge verwenden stattdessen Mods. Bei Folia reicht die Angabe „Paper-kompatibel“ nicht: Prüfe ausdrücklich die Folia-Unterstützung des Plugins. Falls du die Plattform erst auswählen musst, hilft der Vergleich der Server-Software.
Lies vor dem Download die unterstützte Minecraft-Version, erforderliche Abhängigkeiten und die Installationshinweise des Plugin-Autors. Beziehe die Datei aus einer vertrauenswürdigen Quelle, etwa dem offiziellen Projekt oder PaperMC Hangar. Ein Plugin hat weitreichenden Zugriff auf deinen Server. Erstelle vor Änderungen an einer bestehenden Welt ein Backup und lade eine Kopie herunter.
Plugin Schritt für Schritt installieren
- Stoppe den Server sauber. Lade die passende
.jar-Datei herunter. Wenn du ein ZIP erhältst, prüfe dessen Inhalt: Oft liegt die eigentliche Plugin-JAR darin. Lade weder das ZIP noch eine Fabric-/Forge-Mod als Paper-Plugin hoch. - Öffne im Server-Dateimanager oder per SFTP den Ordner
pluginsim Server-Hauptverzeichnis. Lege die JAR direkt dort ab, nicht in einem Unterordner. Gibt es den Ordner bei einem frisch eingerichteten Paper-Server noch nicht, starte Paper einmal und prüfe danach erneut. - Starte den Server. Gib im Spiel
/pluginsoder in der Konsolepluginsein. Das neue Plugin sollte geladen erscheinen. Prüfe zusätzlich die Startmeldungen und bei Bedarflogs/latest.log. - Konfiguriere das Plugin nach seiner eigenen Anleitung. Viele Plugins legen nach dem ersten Start Dateien unter
plugins/<Pluginname>/an. Ändere nur dokumentierte Werte und starte nach Konfigurationsänderungen kontrolliert neu.
Wenn das Plugin nicht erscheint
Steht es in /plugins rot oder fehlt ganz, suche im Startprotokoll nach dem ersten Fehler zum Dateinamen. „Unknown/missing dependency“ verlangt ein weiteres Plugin oder eine Bibliothek. „Invalid plugin.yml“ weist oft auf eine Datei für die falsche Plattform hin. Ein Versionsfehler verlangt eine passende Plugin-Version; bei Folia musst du zusätzlich die Thread-Kompatibilität prüfen. Ändere jeweils nur eine Ursache und teste erneut. Nach einer Plugin-Aktualisierung kann auch eine Konfigurationsdatei angepasst werden müssen.
Für Mods folge der separaten Mod-Anleitung. Wenn der Server nach dem Upload gar nicht mehr startet, nutze die Startfehler-Checkliste.