So installierst du ein Minecraft-Plugin

Schritt für Schritt

1. 1.Prüfe, ob dein Server Plugins ausführen kann

   Plugins brauchen Bukkit-basierte Serversoftware: Paper, Spigot, Purpur oder Folia für Spielserver, BungeeCord oder Velocity für Proxys. Ein Vanilla-Server oder ein Fabric- oder Forge-Server lädt keine Plugins.

2. 2.Prüfe die Version des Plugins

   Auf der Plugin-Seite oder in der Datei steht, welche Minecraft-Versionen es unterstützt. Ein Plugin, das für eine neuere Version als dein Server gebaut wurde, verweigert meist das Laden.

3. 3.Stoppe den Server und kopiere die .jar

   Lege die .jar-Datei in den Ordner plugins/ neben der Server-.jar. In einem Hosting-Panel lädst du sie über den Dateimanager oder per SFTP hoch. Entpacke sie nicht.

4. 4.Installiere seine Abhängigkeiten

   Wenn das Plugin andere Plugins braucht (Vault, PlaceholderAPI, ProtocolLib, LuckPerms), lege deren .jar-Dateien ebenfalls in plugins/.

5. 5.Starte den Server und lies die Konsole

   Such im Startprotokoll nach dem Namen des Plugins. „Enabling <Plugin>“ ohne Fehler danach heißt, dass es geladen wurde.

6. 6.Prüfe es im Spiel und konfiguriere es

   Führe /plugins aus: Geladene Plugins sind grün, Plugins, die sich nicht aktivieren ließen, sind rot. Seine Einstellungen findest du in plugins/<PluginName>/config.yml; bearbeite sie und starte neu.

Wo die Dateien hingehören

Ein typischer Serverordner sieht nach dem ersten Start mit einem Plugin so aus:

• paper.jar (oder spigot.jar): der Server selbst.
• plugins/MyPlugin.jar: das Plugin, das du hinzugefügt hast.
• plugins/MyPlugin/: ein Ordner, den das Plugin anlegt, mit config.yml, Nachrichten und seinen gespeicherten Daten.
• logs/latest.log: das Protokoll des aktuellen Laufs, in dem Ladefehler stehen.

Neu starten, nicht /reload

/reload entlädt und lädt jedes Plugin neu, ohne den Server neu zu starten. Viele Plugins unterstützen das nicht: Listener werden doppelt registriert, Daten gehen verloren oder Speicher läuft voll. Starte den Server immer neu, nachdem du ein Plugin hinzugefügt, entfernt oder aktualisiert hast. Manche Plugins haben einen eigenen Reload-Befehl (zum Beispiel /myplugin reload) nur für ihre Config: Der ist unbedenklich.

Bevor du auf dem Live-Server installierst

• Mach ein Backup des Serverordners oder zumindest von plugins/ und den Welten.
• Probiere es zuerst auf einer Kopie aus: dieselbe Software, Version und dieselben anderen Plugins wie auf dem echten Server. Siehe So testest du ein Plugin.
• Immer nur ein Plugin: Wenn etwas kaputtgeht, weißt du, welches es war.
• Lade von der Seite des Autors herunter (SpigotMC, Hangar, Modrinth, GitHub), nicht von Re-Uploads.

Mit Codexe erstellte Plugins

Ein auf Codexe erstelltes Plugin kommt als fertig gebaute .jar mit dem Namen des Projekts und wird geprüft, bevor du es bekommst: Es muss die kompilierten Klassen und eine plugin.yml enthalten. Du kannst es auf einem privaten Testserver ausprobieren, bevor du es irgendwo installierst, kostenlos in jedem Tarif; der Testserver installiert die als Abhängigkeiten angegebenen Plugins für dich. Für den Download der .jar für deinen eigenen Server brauchst du einen Tarif oder ein Download-Paket.

Fragen