Anleitung

So erstellst du ein Paper-Plugin

Aktualisiert am 7. Oktober 2026

Paper ist die am häufigsten genutzte Minecraft-Server-Software für Plugins: Sie führt Spigot-Plugins aus und ergänzt eine größere, schnellere API. Ein Paper-Plugin ist ein Java-Projekt (oder Kotlin-Projekt), das gegen paper-api kompiliert wird. Hier steht, was es dafür braucht, von Hand oder mit einer KI, die es für dich baut.

Ein Beispiel als Ausgangspunkt.

Mit Codexe erstellen

Schritt für Schritt

  1. 1.Die Minecraft-Version wählen

    Nimm die Version, auf der dein Server läuft. Sie bestimmt die Java-Version: Java 17 vor 1.20.5, Java 21 ab 1.20.5, Java 25 für 26.x.

  2. 2.Das Projekt anlegen

    Ein Gradle- oder Maven-Projekt mit der Abhängigkeit paper-api für diese Version aus dem PaperMC-Repository, im Scope provided/compileOnly.

  3. 3.Die Hauptklasse schreiben

    Eine Klasse, die JavaPlugin erweitert, mit onEnable(), um Befehle und Listener zu registrieren.

  4. 4.Das Plugin dem Server beschreiben

    plugin.yml (name, version, main, api-version, commands, permissions). Paper unterstützt außerdem paper-plugin.yml mit eigenen Laderegeln.

  5. 5.Bauen und testen

    Baue die .jar, lege sie in den Ordner plugins/ eines Paper-Testservers, starte ihn und prüfe die Konsole auf Fehler.

Paper oder Spigot?

Code für die Spigot-API läuft auch auf Paper, aber nicht umgekehrt: Paper ergänzt Events und Methoden (zum Beispiel die Adventure-Textkomponenten und viele asynchrone APIs), die Spigot nicht hat. Schreibe für Paper, wenn dein Server Paper nutzt; schreibe für Spigot, wenn das Plugin auch auf Spigot-Servern laufen soll.

Der schnelle Weg

Wähle auf Codexe ein Bukkit-/Spigot-/Paper-Plugin, schreibe „Paper“ und die Version in die Anfrage und beschreibe, was es tut. Codexe richtet das Projekt und die passende Java-Version ein, kompiliert es, behebt Build-Fehler und lässt dich einem Paper-Testserver mit installiertem Plugin beitreten.

Häufige Probleme

  • UnsupportedClassVersionError: Das Plugin wurde mit einem neueren Java kompiliert, als der Server nutzt.
  • NoSuchMethodError / NoClassDefFoundError: Das Plugin nutzt eine API, die es in der Serverversion nicht gibt, oder eine Abhängigkeit wurde nicht in die .jar eingebunden (shaded).
  • Das Plugin lädt, aber Befehle tun nichts: Der Befehl fehlt in der plugin.yml oder der Executor ist nicht registriert.

Fragen

Funktionieren Paper-Plugins auf Purpur oder Folia?

Purpur ist ein Paper-Fork, deshalb laufen Paper-Plugins dort. Folia ändert das Threading: Ein Plugin muss für den Region-Scheduler geschrieben sein, um auf Folia zu laufen.

Kann ich ein Paper-Plugin in Kotlin schreiben?

Ja. Codexe kann ein Kotlin-Gradle-Projekt mit build.gradle.kts für dieselbe Paper-API generieren.

Jetzt ein Paper-Plugin bauen

Dieser Prompt öffnet sich versandfertig:

“Ein Paper-1.21.4-Plugin namens Bounties: /bounty set <player> <amount> mit der Vault-Wirtschaft, der Killer bekommt die Belohnung, /bounty list zeigt die Top 10, Kopfgelder bleiben über Neustarts hinweg gespeichert, Nachrichten in der config.yml.”

Mit Codexe erstellen
So erstellst du ein Paper-Plugin (Minecraft) | Codexe