Zurück zum Blog

Minecraft Plugins installieren: Anleitung für Paper, Spigot und Purpur

Minecraft Plugins installieren auf Paper, Spigot oder Purpur: sichere Downloads, Version und Abhängigkeiten, plugins-Ordner, Updates und häufige Fehler.

Nodesty-Team10 Min. LesezeitGameserver
Der Schriftzug Minecraft Plugins mit Paper und dem Ordner plugins auf dunklem Nodesty-Hintergrund

Wer Minecraft Plugins installieren kann, macht aus einer einfachen Survival-Welt einen Server mit Rängen, Homes, geschützten Bereichen und einer Wirtschaft. Die Installation selbst ist kurz: Sie laden eine .jar-Datei herunter, legen sie in den Ordner plugins des Servers und starten neu. Die meisten Probleme entstehen drumherum: die falsche Serversoftware, ein Plugin für eine andere Minecraft-Version oder eine fehlende Abhängigkeit.

In dieser Anleitung zeigen wir den Unterschied zwischen Plugins und Mods, wie Sie Serversoftware und Version prüfen, sichere Downloadquellen, das Installieren, Konfigurieren, Aktualisieren und Entfernen von Plugins, eine kurze Liste von Plugins für den Anfang und die häufigsten Fehler. Haben Sie Ihren Server noch nicht eingerichtet, werfen Sie zuerst einen Blick auf unsere Anleitung Minecraft Server erstellen.

Plugins oder Mods: der Unterschied

Die beiden Begriffe werden oft verwechselt, es sind aber unterschiedliche Systeme:

PluginsMods
ServersoftwarePaper, Spigot, PurpurForge, NeoForge, Fabric
InstalliertNur auf dem Server, im Ordner pluginsAuf dem Server und meist auf jedem Client
Spieler brauchenEinen normalen, unveränderten ClientDieselben Mods oder dasselbe Modpack
Typischer EinsatzRänge, Wirtschaft, Schutz, Admin-WerkzeugeNeue Blöcke, Items, Mobs und Dimensionen

Plugins ändern das Verhalten des Servers, ohne die Spieldateien zu verändern; deshalb kann jeder mit einem normalen Client beitreten. Der Vanilla-Server von Mojang lädt keine Plugins, Forge- und Fabric-Server ebenfalls nicht. Möchten Sie ein Modpack spielen, folgen Sie stattdessen unserer Anleitung Minecraft Modpack Server erstellen.

Serversoftware und Version prüfen

Bevor Sie etwas herunterladen, finden Sie heraus, was auf Ihrem Server läuft. Geben Sie in der Serverkonsole Folgendes ein (im Spiel mit Schrägstrich: /version):

version

Ein Server mit Plugin-Unterstützung antwortet mit dem Namen der Software, also Paper, Spigot oder Purpur, und der Minecraft-Version. Notieren Sie beides. Nennt die Antwort keinen dieser Namen und gibt es im Serververzeichnis keinen Ordner plugins, kann der Server keine Plugins laden.

  • Paper führt Plugins aus, die für Bukkit, Spigot und Paper geschrieben wurden. Für die meisten Server ist es die beste Wahl.
  • Purpur baut auf Paper auf und führt dieselben Plugins aus.
  • Spigot führt Bukkit- und Spigot-Plugins aus, aber keine Plugins, die die Paper-API benötigen.

Für den Wechsel von Vanilla laden Sie die Paper-Jar für Ihre Minecraft-Version von papermc.io herunter, sichern Ihre Welt und verwenden diese Datei anstelle der alten Server-Jar.

Wo Sie Plugins sicher herunterladen

Ein Plugin ist ein Programm, das mit denselben Rechten läuft wie Ihr Server: Es kann Ihre Dateien lesen, Konsolenbefehle ausführen und beliebigen Spielern OP geben. Laden Sie Plugins nur von Quellen herunter, auf denen der Autor selbst veröffentlicht:

  • Modrinth (modrinth.com/plugins): mit Filtern für Plattform und Minecraft-Version.
  • Hangar (hangar.papermc.io): das Plugin-Verzeichnis des PaperMC-Projekts.
  • SpigotMC (spigotmc.org/resources): der älteste und größte Katalog, auch mit kostenpflichtigen (Premium-)Plugins.
  • Die eigene Website des Projekts oder GitHub-Releases: LuckPerms, EssentialsX und Geyser zum Beispiel veröffentlichen ihre Versionen auf eigenen Seiten.

Finger weg von geleakten oder „genullten“ Premium-Plugins. Kostenlose Kopien kostenpflichtiger Plugins von Leak-Seiten, Discord-Servern oder aus Videobeschreibungen sind ein verbreiteter Weg, Schadsoftware zu verteilen: Die Jar wird mit einer Hintertür neu verpackt, die einem Fremden OP gibt, Ihre Dateien stiehlt oder Ihren Server für Angriffe missbraucht. Updates und Support erhalten Sie ebenfalls nicht. Übersteigt ein kostenpflichtiges Plugin Ihr Budget, suchen Sie auf den genannten Plattformen nach einer kostenlosen Alternative.

Prüfen Sie auf jeder Plattform vor der Installation das Datum des letzten Updates, die Zahl der Downloads und die Bewertungen.

Version abgleichen und Abhängigkeiten prüfen

Achten Sie auf der Downloadseite des Plugins auf drei Dinge:

  1. Minecraft-Version. Wählen Sie die Datei, die die Version Ihres Servers aufführt. Plugins, die nur die offizielle API nutzen, laufen oft auch auf neueren Versionen weiter; Plugins, die in die Interna des Servers eingreifen, brauchen eine Datei genau für Ihre Version.
  2. Plattform. Viele Projekte bieten getrennte Dateien für Paper, Velocity, BungeeCord oder sogar Fabric an. Auf einem Paper, Spigot oder Purpur Server nehmen Sie die Datei für Paper, Spigot oder Bukkit. Proxy-Dateien gehören auf den Proxy; mehr dazu in unserer Anleitung Minecraft Velocity Netzwerk einrichten.
  3. Abhängigkeiten. Manche Plugins funktionieren nur, wenn ein anderes Plugin installiert ist. Häufig sind Vault (eine Brücke zwischen Wirtschafts-, Berechtigungs- und Chat-Plugins), ProtocolLib (Zugriff auf Netzwerkpakete) und PlaceholderAPI (Platzhalter wie Rang oder Kontostand eines Spielers in Texten). Erforderliche Abhängigkeiten müssen ebenfalls im Ordner plugins liegen; optionale schalten nur Zusatzfunktionen frei.

Plugin installieren: Schritt für Schritt

Ein Plugin wird nur beim Start des Servers geladen, deshalb endet jede Installation mit einem Neustart.

  1. Stoppen Sie den Server mit stop in der Konsole. Sie können ein neues Plugin auch bei laufendem Server hochladen und danach neu starten, überschreiben Sie aber niemals die Jar eines Plugins, das gerade geladen ist.
  2. Laden Sie die .jar-Datei in den Ordner plugins hoch. Nutzen Sie den Dateimanager Ihres Panels oder ein SFTP-Programm wie FileZilla oder WinSCP; wie Sie sich verbinden, zeigt unsere Anleitung FTP oder SFTP?. Im Terminal erledigt scp dasselbe (passen Sie den Pfad an Ihren Serverordner an):
    scp BeispielPlugin-1.0.jar minecraft@203.0.113.10:~/server/plugins/
    
  3. Prüfen Sie die Datei. Sie muss auf .jar enden und direkt in plugins liegen, nicht in einem Unterordner. Ist der Download eine .zip-Datei, entpacken Sie sie und laden die enthaltene Jar hoch.
  4. Starten Sie den Server. Beim ersten Start legen die meisten Plugins einen eigenen Ordner plugins/<PluginName> mit ihren Konfigurationsdateien an.

Prüfen, ob das Plugin läuft

Lassen Sie sich die Plugins in der Konsole (oder im Spiel mit /plugins) auflisten:

plugins
  • Grün bedeutet, dass das Plugin aktiviert ist.
  • Rot bedeutet, dass es gefunden wurde, aber nicht aktiviert werden konnte.
  • Fehlt das Plugin in der Liste ganz, konnte der Server die Datei nicht laden.

Aktuelle Paper-Versionen teilen die Liste in Paper-Plugins und Bukkit-Plugins auf; das ist normal. version PluginName zeigt, welche Version eines Plugins installiert ist.

Bei roten oder fehlenden Plugins steht der Grund in der Konsole und in logs/latest.log. Unter Linux durchsuchen Sie das Log aus dem Serverordner heraus:

grep -iE "error|exception|could not load" logs/latest.log

Lesen Sie den ersten Fehler, in dem das Plugin vorkommt; er nennt die Ursache meist im Klartext.

Ein Plugin konfigurieren

Die Einstellungen liegen in plugins/<PluginName>/config.yml; größere Plugins legen weitere Dateien daneben. Es handelt sich um YAML-Dateien, und YAML ist bei der Formatierung streng:

settings:
    teleport-delay: 3
    join-message: '&eWillkommen auf dem Server!'
  • Rücken Sie mit Leerzeichen ein, nie mit Tabs, und behalten Sie die Einrückung der umliegenden Zeilen bei.
  • Setzen Sie Text mit Zeichen wie &, : oder # in Anführungszeichen.

Bei einer fehlerhaften Datei startet das Plugin nicht oder fällt auf seine Standardwerte zurück; legen Sie vor größeren Änderungen eine Kopie an.

Um Änderungen zu übernehmen, starten Sie den Server neu. Viele Plugins haben außerdem einen eigenen Reload-Befehl wie /essentials reload oder /wg reload, der für kleine Änderungen ausreicht. Verwenden Sie nicht den allgemeinen Befehl /reload: Er lädt alle Plugins im laufenden Betrieb neu, was zu Speicherlecks, doppelt laufenden Aufgaben und beschädigten Daten führen kann. Genau deshalb zeigt Paper eine Warnung an und verlangt eine Bestätigung.

Plugins aktualisieren

  1. Lesen Sie das Changelog des Plugins; dort steht, ob die neue Version die Konfiguration ändert oder einen neueren Server voraussetzt.
  2. Stoppen Sie den Server.
  3. Sichern Sie den Ordner plugins:
    tar -czf ~/plugins-backup-$(date +%F).tar.gz -C ~/server plugins
    
  4. Löschen Sie die alte Jar und laden Sie die neue hoch. Den Ordner plugins/<PluginName> lassen Sie unverändert; darin liegen Ihre Einstellungen und Daten.
  5. Starten Sie den Server und prüfen Sie plugins sowie das Log.

Bevor Sie den Server auf eine neue Minecraft-Version umstellen, prüfen Sie, ob alle Plugins, auf die Sie angewiesen sind, diese bereits unterstützen; aktualisieren Sie dann zuerst die Serversoftware und direkt danach die Plugins. Backups, die getrennt vom Server aufbewahrt werden, erklären wir in unserer Anleitung Server Backup.

Ein Plugin entfernen

Stoppen Sie den Server und löschen Sie die Jar des Plugins aus plugins. Der Ordner des Plugins bleibt mit Einstellungen und Daten zurück; löschen Sie ihn nur, wenn Sie sicher sind, dass Sie beides nicht mehr brauchen. Bevor Sie eine Bibliothek wie Vault oder ProtocolLib entfernen, stellen Sie sicher, dass kein anderes Plugin davon abhängt, sonst werden diese Plugins beim nächsten Start nicht mehr geladen.

Beliebte Plugins für den Anfang

PluginZweck
EssentialsXGrundbefehle wie /home, /spawn und /tpa, dazu Kits und Warps
LuckPermsGruppen, Ränge und Berechtigungen
VaultVerbindet Wirtschafts-, Berechtigungs- und Chat-Plugins; von vielen Plugins benötigt
WorldEditBearbeitet große Bereiche im Spiel: kopieren, einfügen, füllen und ersetzen
WorldGuardSchützt Regionen wie den Spawn; benötigt WorldEdit
CoreProtectProtokolliert Blockänderungen und macht Griefing rückgängig
Geyser + FloodgateLässt Bedrock-Spieler auf einen Java-Server; mit Floodgate ohne Java-Konto

Vault stellt selbst keine Wirtschaft bereit, sondern braucht ein Wirtschafts-Plugin wie EssentialsX. Wie Sie Ränge einrichten, zeigt unsere LuckPerms Anleitung, die eingebauten Admin-Befehle unsere Anleitung Minecraft Server Befehle.

Häufige Fehler

  • Falsche Serversoftware: Eine Forge- oder Fabric-Mod oder ein Velocity- oder BungeeCord-Plugin im Ordner plugins eines Paper Servers wird nicht geladen; die Konsole meldet, dass die Jar keine plugin.yml enthält.
  • Versionskonflikt: Das Plugin wurde für eine andere Minecraft-Version gebaut. Es bleibt rot oder wird geladen und wirft Fehler, sobald Spieler es nutzen. Laden Sie die Datei für Ihre Version herunter oder suchen Sie nach einem aktuellen Fork.
  • Fehlende Abhängigkeit: Im Log steht UnknownDependencyException zusammen mit dem Namen des fehlenden Plugins. Installieren Sie es und starten Sie neu.
  • UnsupportedClassVersionError: Das Plugin wurde für eine neuere Java-Version kompiliert als die, mit der Ihr Server läuft. Class file version 65 steht für Java 21, 61 für Java 17. Installieren Sie die Java-Version, die das Plugin verlangt, sofern Ihre Minecraft-Version sie unterstützt, und stellen Sie sicher, dass das Startskript sie verwendet.
  • Doppelte Jar-Dateien: Zwei Versionen desselben Plugins im Ordner, etwa nach einem Update. Die Konsole warnt vor einem mehrdeutigen Plugin-Namen (ambiguous plugin name), und Sie können nicht sicher sein, welche Datei geladen wird. Löschen Sie die alte Datei.
  • Fehlerhafte Konfiguration: Nach einer Änderung startet das Plugin mit einem YAML-Fehler nicht, der die Zeile nennt. Korrigieren Sie die Einrückung oder stellen Sie Ihre Kopie wieder her.

Zu viele Plugins und die Performance

Jedes Plugin fügt jedem Server-Tick Arbeit hinzu, und ein einziges schlecht geschriebenes Plugin kann den gesamten Server verlangsamen. Installieren Sie nur, was Sie wirklich nutzen, und vermeiden Sie Plugins, die dieselbe Aufgabe doppelt erledigen, etwa zwei Wirtschafts- oder zwei Teleport-Plugins.

Um herauszufinden, welches Plugin am meisten kostet, messen Sie. Paper liefert seit Version 1.21 den Profiler spark bereits mit; er hat dort das ältere Timings-System abgelöst:

/spark profiler start
/spark profiler stop

Lassen Sie den Profiler einige Minuten laufen, während auf dem Server Betrieb herrscht; nach dem Stop-Befehl gibt spark einen Link zu einem Bericht aus, der zeigt, wie viel Tick-Zeit auf jedes Plugin entfällt. Unter Spigot und älteren Paper-Versionen verwenden Sie /timings on und nach einigen Minuten /timings paste, oder Sie installieren spark als Plugin. Die nächsten Schritte finden Sie in unserer Anleitung Minecraft Server Lag.

Minecraft Server bei Nodesty

Die Pakete für Minecraft Server mieten von Nodesty laufen in Frankfurt mit einem AMD Ryzen 9 9950X Prozessor mit bis zu 5,7 GHz, NVMe-Speicher und DDoS-Schutz. Mit Paper starten Sie in wenigen Minuten, laden Ihre Plugins in den Ordner plugins und verwalten den Server mit vollem Administratorzugriff. Tägliche Backups sind bei Gameservern kostenlos und werden 7 Tage aufbewahrt; ein missglücktes Plugin-Update kostet Sie also nicht Ihre Welt.

Minecraft ist eine Marke der Mojang AB. Nodesty ist nicht mit Mojang oder Microsoft verbunden und wird nicht von ihnen unterstützt.

Häufig gestellte Fragen

Kann ich Plugins auf einem Vanilla-Minecraft-Server installieren?

Nein. Die offizielle Serverdatei von Mojang lädt keine Plugins. Sie brauchen eine Bukkit-kompatible Serversoftware wie Paper, Spigot oder Purpur. Der Wechsel ist einfach, denn Sie ersetzen die Server-Jar durch die Paper-Jar derselben Minecraft-Version und behalten Ihre Welt. Sichern Sie den Weltordner vor dem Wechsel.

Müssen Spieler etwas installieren, um einem Server mit Plugins beizutreten?

Nein. Plugins laufen nur auf dem Server; Spieler verbinden sich mit einem normalen, unveränderten Minecraft-Client in einer unterstützten Version. Das ist der wichtigste Unterschied zu Mods, die in der Regel auch auf dem Computer jedes Spielers installiert sein müssen.

Kann ich Plugins und Mods auf demselben Server nutzen?

Nicht direkt. Plugins brauchen Paper, Spigot oder Purpur, Mods dagegen Forge, NeoForge oder Fabric, und die beiden Systeme laden die Dateien des jeweils anderen nicht. Es gibt hybride Serversoftware, die beides kombinieren will, sie verursacht aber häufig Kompatibilitätsprobleme; für den ersten Server empfehlen wir sie nicht.

Warum wird mein Plugin in der Plugin-Liste rot angezeigt?

Rot bedeutet, dass das Plugin gefunden wurde, aber nicht aktiviert werden konnte. Die häufigsten Ursachen sind eine fehlende Abhängigkeit wie Vault, eine Plugin-Datei für eine andere Minecraft-Version oder eine zu alte Java-Version. Öffnen Sie logs/latest.log und lesen Sie den ersten Fehler, in dem der Plugin-Name vorkommt; dort steht meist der Grund.

Ist der Befehl reload nach dem Hinzufügen eines Plugins sicher?

Nein. Der Befehl reload entlädt alle Plugins im laufenden Betrieb und lädt sie neu, wofür viele Plugins nicht ausgelegt sind. Das kann zu Speicherlecks, doppelt laufenden Aufgaben und beschädigten Daten führen; auch Paper selbst warnt davor. Starten Sie stattdessen den Server neu.

Gehen meine Einstellungen beim Update eines Plugins verloren?

Nein, solange Sie nur die Jar-Datei ersetzen. Einstellungen und Daten liegen im eigenen Ordner des Plugins innerhalb des Ordners plugins und bleiben dort erhalten. Sichern Sie den Ordner plugins trotzdem vor jedem Update, denn eine neue Hauptversion kann das Format der Konfiguration oder der Daten ändern.

Nodesty

Über den Autor

Nodesty-Team · Infrastruktur und Support

Das Nodesty-Team betreibt unsere Server, unser Netzwerk und unseren DDoS-Schutz im Alltag und beantwortet Support-Anfragen rund um die Uhr. Diese Ratgeber entstehen aus dieser Arbeit.

Verwandte Artikel

Starte deinen Server jetzt.

Erstellen, wachsen und skalieren Sie Ihre Projekte grenzenlos auf der Premium-Infrastruktur von Nodesty.

                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                             ············································                                                   
                                                ··································································································..........···························                                     
                                       ················..........................................................................................................................··············                             
                                  ·············.................::::::::::::::::::::::::::::::::::::::::::::::....................:::::::::::::::::::::::::::::::::::::::................···········                        
                             ············................:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::............·········                     
                         ············.................:::::::::::::::::::::::::::::::::::::::::::::::::::------------::::::::::::::::::::::::::::::----------------:::::::::::::::::::::..........········                  
                    ············......................::::::::::::::::::::::::::::::::::::------------------------------------------------------------------------------------:::::::::::::.........········                
                ··········.............................................::::::::::::::::::-------------==========================================-----------------------------------:::::::::::........·······               
             ········..................:.....................................::::::::::--------=======+++++++++++++++++++++++++++++++++++++=========================------------------::::::::::.......·······              
           ······.........::::::::::::::::::::................................:::::::-----=====++++xxxxxx**************************xxxxxxxxx++++++++++++++===================------------::::::::.......·······             
          ·····.......:::::::::::::::::::::::::::.............................:::::----===+++xxx****%%%%&&&&&&#############&&&&&&&%%%%%*******xxxxxxxx++++++++++++++==============----------:::::::......······             
         ····......::::::::-------------:::::::::::..........................::::---===+++xx***%%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@####&&&&&%%%%*******xxxxxxxxx+++++++++++++===========--------::::::......·····             
        ····.....:::::::--------------------:::::::::.......................::::---===++xxx**%%&&&###@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&%%%%%********xxxxxxxxxxx++++++++++++========------::::::.....······            
        ····.....:::::--------------------------::::::::....................::::---===++xx***%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&&%%%%%**********xxxxxxxxxxxxx+++++++++=======------:::::.....·····            
        ····....::::::-------=============---------:::::::::................:::::---===+++xx***%%%&&&#####@@@@@@@@@@@@@@@@@@@@@@@@@#####&&&&&%%%%%%*************xxxxxxxxxxxxxx+++++++++======-----:::::....·····            
         ····....:::::-------================---------:::::::::...............:::::----===++++xxx***%%%%&&&&&&#################&&&&&&%%%%%%%*******************xxxxxxxxxxxxxxxxx++++++++======----:::::....·····            
         ·····....:::::--------=================---------::::::::::..............:::::::-----====+++++xxxxxx**************************xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx++++++++=====-----::::....·····            
          ·····.....:::::--------=================----------:::::::::::.................:::::::::-------=============++++++++++++++++++++++++++++++++++++xxxxxxxxxxxxxxxxxxxxxxx++++++++======-----::::....·····            
            ·····.....:::::::----------===========-------------::::::::::::.........................::::::::::::::::::------------------=============+++++++++++++++++++++++++++++++++=======-----::::.....·····            
              ······......:::::::---------------------------------:::::::::::::........................................:::::::::::::::-----------============+++++++++++++++++++++========------:::::.....·····             
                 ······........:::::::::---------------------------:::::::::::::::::...........................................:::::::::::::------------=============================--------::::::.....······              
                    ·········.........:::::::::::::::-------------::::::::::::::::::::::::.......................................::::::::::::::::--------------------------------------::::::::......·······                
                          ··········............::::::::::::::::::::::::::::::::::::::::::::::::::................................::::::::::::::::::::::::::-------------:::::::::::::::.........········                   
                                  ············..................:::::::::::::::::::::::::::::::::::::::::::.........................:::::::::::::::::::::::::::::::::::::................···········                        
                                             ················.............................................................................................................·················                                 
                                                           ······················................................................................···························                                                
                                                                               ·········································································