Anleitung

So erstellst du ein Spigot-Plugin

Aktualisiert am 7. Oktober 2026

Ein Spigot-Plugin nutzt die Bukkit-/Spigot-API und läuft deshalb auf Spigot und auf jedem seiner Forks, Paper eingeschlossen. Damit ist es die breiteste Wahl, wenn du nicht weißt, wo das Plugin laufen wird. Diese Anleitung behandelt das Projekt, den Code und den Build.

Passe das Beispiel an deinen Server an.

Mit Codexe erstellen

Schritt für Schritt

  1. 1.Java und ein Build-Tool einrichten

    Installiere das JDK, das zu deiner Minecraft-Version passt (17, 21 oder 25), und nutze Maven oder Gradle.

  2. 2.Die Spigot-API hinzufügen

    Füge spigot-api für deine Version aus dem Spigot-Repository mit dem Scope provided hinzu. Sie wird nur zum Kompilieren gebraucht; zur Laufzeit stellt der Server sie bereit.

  3. 3.Befehle und Listener schreiben

    Registriere einen CommandExecutor mit getCommand("name").setExecutor(...) und Event-Listener mit registerEvents.

  4. 4.plugin.yml schreiben

    Name, Version, Hauptklasse, api-version (ab 1.13), Befehle und Berechtigungen.

  5. 5.Bauen und installieren

    mvn package, dann die .jar aus target/ in den Ordner plugins/ des Servers kopieren und neu starten.

Alte Versionen (1.8 bis 1.12)

Viele Minispiel-Server laufen noch auf 1.8. Die API ist älter (kein api-version, andere Material-Namen), deshalb muss ein Plugin für diese Version geschrieben sein und lässt sich nicht aus einem 1.21-Tutorial kopieren. Codexe fragt nach der Version und schreibt den Code für diese API.

Mit Codexe

Beschreibe das Plugin und nenne „Spigot“ mit der Version. Codexe generiert das Maven-Projekt, kompiliert es, behebt Fehler und lässt dich es auf einem Testserver dieser Version testen, bevor du es herunterlädst.

Fragen

Brauche ich BuildTools?

Nur um einen Spigot-Server zu betreiben oder um NMS (interner Servercode) zu nutzen. Zum Kompilieren gegen die normale API reicht die Abhängigkeit spigot-api.

Spigot-Plugin oder Paper-Plugin?

Spigot, wenn es überall laufen soll; Paper, wenn dein Server Paper nutzt und du die zusätzliche API willst. Siehe So erstellst du ein Paper-Plugin.

Ein Spigot-Plugin erstellen

Dieser Prompt öffnet sich versandfertig:

“Ein Spigot-1.8.8-Plugin namens Kits: /kit <name> gibt ein konfigurierbares Set von Items mit einem Cooldown pro Kit, Kits in der config.yml definiert, Berechtigung kits.<name> pro Kit, Cooldowns über Neustarts hinweg gespeichert.”

Mit Codexe erstellen
So erstellst du ein Spigot-Plugin: Einrichtung, Code, Build | Codexe