Plugins, Mods und was Paper ausführen kann
Paper führt Plugins aus, die für Bukkit, Spigot und Paper geschrieben sind. Sie laufen komplett auf dem Server, deine Spieler joinen also mit dem normalen Spiel und müssen nichts herunterladen. Das ist der große praktische Unterschied zu Mods, die das Spiel selbst verändern und meist bei jedem Spieler in derselben Version installiert sein müssen.
Mods für Fabric, Forge und NeoForge sind keine Plugins, auch wenn sie ebenfalls .jar-Dateien sind. Legst du eine davon in den Ordner plugins, meldet Paper eine ungültige plugin.yml, weil dem Jar die Datei fehlt, die ein Plugin braucht. Gibt es das, was du willst, nur als Mod, erklärt unser Vergleich von Paper, Forge und Fabric (auf Englisch) den Wechsel.
Vielleicht begegnet dir auch der Begriff Paper-Plugin. Solche Plugins nutzen eine paper-plugin.yml statt der klassischen plugin.yml oder zusätzlich zu ihr. Für dich als Serverbetreiber ändert sich nichts: Sie werden genauso installiert, in denselben Ordner.
- Plugins für Bukkit, Spigot und Paper: gehören in plugins, nur auf den Server
- Mods für Fabric, Forge und NeoForge: keine Plugins, Paper lädt sie nicht
- Spieler brauchen nichts extra, um einem Plugin-Server beizutreten
Wo du Plugins herunterlädst und was du vorher prüfst
Die Doku von PaperMC empfiehlt Hangar, das eigene Plugin-Verzeichnis, als erste Anlaufstelle und nennt außerdem Modrinth, BukkitDev und GitHub. Sie beginnt mit einer Warnung, die man wiederholen sollte: Installiere Plugins nur aus Quellen, denen du voll vertraust, denn ein Plugin bekommt uneingeschränkten Zugriff auf deinen Server und den Rechner, auf dem er läuft. Ein Plugin ist Code, den du bewusst ausführst. Nimm also lieber Projekte mit öffentlicher Geschichte, sichtbarem Autor und aktuellen Updates.
Prüf vor dem Download, ob das Plugin deine Minecraft-Version unterstützt. Führ version in der Konsole aus, um genau zu sehen, was dein Server nutzt, und nimm dann die Plugin-Datei, die dafür gebaut ist. Hangar und Modrinth zeigen bei jedem Release die unterstützten Versionen. Manche Plugins brauchen außerdem ein anderes Plugin, um zu funktionieren, und ihre Seite sagt das. Installiere diese gleich mit.
Die Datei, die du hochlädst, muss auf .jar enden. Ist der Download eine .zip, entpacke sie und such das Jar für deine Plattform, oft mit bukkit oder paper gekennzeichnet.
- Zuerst Hangar, dann Modrinth, BukkitDev oder das GitHub des Autors
- Das Plugin-Release passend zu der Version wählen, die der Befehl version anzeigt
- Jede genannte Abhängigkeit gleich mitinstallieren
- Das .jar hochladen, nie die .zip, in der es kam
Ein Plugin installieren, Schritt für Schritt
Jeder Paper Server hat in seinem Hauptverzeichnis einen Ordner plugins, der beim ersten Start angelegt wird. Nur dort sucht Paper. Auf einem gemieteten Server erreichst du ihn über den Dateimanager im Panel oder per SFTP. Wie Gameserver-Hosting funktioniert (auf Englisch) erklärt beides, falls es neu für dich ist.
Papers eigene Schritte enden mit einem Neustart, und genau daran hältst du dich. Der Befehl reload ist in Papers Befehlsreferenz als veraltet markiert und soll entfernt werden. Dort steht, dass er bekanntermaßen Probleme mit Plugins verursacht, und es wird stattdessen ein Neustart empfohlen. Ein vollständiges Stoppen und Starten lädt jedes Plugin von Grund auf.
- Das Plugin-Jar für die Version deines Servers herunterladen
- Den Ordner plugins im Hauptverzeichnis des Servers öffnen
- Das Jar direkt in plugins hochladen, nicht in einen Unterordner
- Den Server neu starten
- plugins in der Konsole oder /plugins im Spiel ausführen und nach einem grünen Namen suchen
Prüfen, ob es geladen ist, und dann einstellen
Der Befehl plugins listet jedes Plugin, das der Server gefunden hat. Grün heißt aktiviert. Rot heißt, es konnte nicht geladen werden oder wurde deaktiviert, und das Startlog erklärt, warum. Ein gelber Stern vor einem Namen markiert ein Plugin, das über Papers Legacy-Unterstützung geladen wurde.
Die meisten Plugins legen beim ersten Start einen eigenen Ordner in plugins an, benannt nach dem Plugin, mit einer config.yml und eventuellen Datendateien. Bearbeite diese bei gestopptem Server und starte ihn danach wieder, oder schau in der Doku des Plugins nach einem eigenen Reload-Befehl.
Befehle, die ein Plugin mitbringt, sind meist durch Berechtigungen geschützt. Hat eine Berechtigung in der plugin.yml eines Plugins keinen Standardwert, fällt sie auf op zurück. Deshalb können Operatoren neue Befehle sofort nutzen und andere Spieler nicht. Willst du bestimmte Befehle an bestimmte Spieler geben, nimm ein Berechtigungs-Plugin wie LuckPerms, statt allen Operator-Rechte zu geben.
- Grün: aktiviert und läuft
- Rot: fehlgeschlagen oder deaktiviert, logs/latest.log lesen
- Gelber Stern: über die Legacy-Unterstützung geladen
- Einstellungen: bei den meisten Plugins plugins/<PluginName>/config.yml
Wenn ein Plugin rot ist oder fehlt
Öffne logs/latest.log und schau nahe am Anfang, wo der Server die Plugins lädt. Die Doku von Paper listet die Meldungen, denen du am ehesten begegnest, und für jede gibt es eine direkte Lösung. Lies die ersten ein, zwei Zeilen eines Fehlers statt des ganzen Stacktraces, denn dort sagt das Plugin, was schiefgelaufen ist.
Taucht dein Plugin im Log gar nicht auf, hat der Server es nie gesehen. Paper durchsucht nur die oberste Ebene des Ordners plugins, ein Jar in einem Unterordner wird also ignoriert, und es zählen nur Dateien, die auf .jar enden.
- Fehlende Abhängigkeit: Das Log nennt das Plugin, das gebraucht wird, etwa Vault. Installieren und neu starten
- Ungültige plugin.yml: kein Paper-Plugin. Es kann eine Mod für Fabric oder Forge sein, ein kaputter Download oder eine Datei, die eine FTP-Übertragung ohne Binärmodus beschädigt hat
- Mehrdeutiger Plugin-Name: Zwei Versionen desselben Plugins sind installiert. Eine behalten und neu starten
- Nichts im Log: Das Jar in die oberste Ebene von plugins verschieben und prüfen, ob es auf .jar endet
Plugins aktualisieren und entfernen, ohne etwas kaputtzumachen
Tausche nie ein Jar, während der Server läuft. Papers Update-Anleitung zeigt einen saubereren Weg: Leg im Ordner plugins einen Ordner namens update an, leg die neuen Plugin-Jars dort hinein und starte neu. Der Server übernimmt sie beim Hochfahren, und Paper selbst kannst du im selben Neustart aktualisieren. Mach vorher ein Backup, inklusive der Config-Ordner der Plugins, damit ein schlechtes Release nur eine schnelle Wiederherstellung bedeutet und keinen Neuaufbau.
Um ein Plugin zu entfernen, stoppst du den Server, löschst sein Jar aus plugins und startest wieder. Sein Config-Ordner bleibt liegen, bis du ihn löschst, was praktisch ist, falls du es dir anders überlegst.
Jedes Plugin braucht etwas Speicher und etwas Arbeit in jedem Tick. Eine normale Plugin-Liste passt locker auf einen Server mit 4 GB, und der Minecraft RAM Calculator (auf Englisch) rechnet dir einen Wert für dein eigenes Setup aus. Fühlt sich der Server nach einer Installation langsam an, zeigt der Ratgeber zu Lag und niedrigen TPS (auf Englisch), wie spark das verantwortliche Plugin benennt. Und wenn kein vorhandenes Plugin genau das tut, was du willst, kannst du ein eigenes Plugin in Auftrag geben (auf Englisch), gebaut für deinen Server.
- Aktualisieren: neues Jar in plugins/update, dann neu starten
- Entfernen: stoppen, Jar löschen, starten
- Plugin-Configs zusammen mit der Welt sichern