So aktualisierst du ein Plugin auf eine neue Minecraft-Version

Schritt für Schritt

1. 1.Probiere zuerst die alte .jar aus

   Leg sie auf einen Testserver der neuen Version und lies die Konsole. Wenn sie lädt und funktioniert, musst du vielleicht gar nichts ändern.

2. 2.Ändere die API-Abhängigkeit

   Setze in pom.xml oder build.gradle paper-api oder spigot-api auf die neue Version.

3. 3.Aktualisiere api-version und Java

   Setze api-version in der plugin.yml (zum Beispiel '1.21') und kompiliere für die Java-Version, die die neue Version braucht: Java 17 vor 1.20.5, Java 21 ab 1.20.5, Java 25 für 26.x.

4. 4.Behebe, was nicht mehr kompiliert

   Baue und arbeite die Fehler ab: umbenannte Materialien, entfernte Methoden, geänderte Event-Klassen. Der Compiler listet sie mit Datei und Zeile auf.

5. 5.Aktualisiere die Abhängigkeiten

   Plugins, die dein Plugin nutzt (Vault, PlaceholderAPI, ProtocolLib, WorldGuard), brauchen ebenfalls Versionen, die die neue Minecraft-Version unterstützen, sowohl in der Build-Datei als auch auf dem Server.

6. 6.Auf der neuen Version testen

   Lade es auf einem Server der neuen Version mit denselben Plugins und probiere jeden Befehl und jede Funktion aus, nicht nur den Start.

Was meistens kaputtgeht

• Material- und Enum-Namen: Das Update 1.13 hat die meisten Items und Blöcke umbenannt; spätere Versionen fügen manche hinzu, benennen sie um oder entfernen sie. Code mit alten Namen oder numerischen IDs schlägt fehl.
• Entfernte veraltete Methoden: Methoden, die über mehrere Versionen als deprecated markiert sind, verschwinden irgendwann.
• Item-Daten: Ab 1.20.5 wurde Item-NBT durch Data Components ersetzt. Plugins, die Item-NBT direkt bearbeiten, müssen diesen Teil neu schreiben; die normale ItemMeta-API funktioniert weiter.
• NMS und Reflection: Code, der interne Serverklassen nutzt, geht in fast jeder Version kaputt. Ersetze ihn wo möglich durch die API oder durch eine Bibliothek wie ProtocolLib.
• Bibliotheksversionen: Mitgepackte Bibliotheken, die für ein älteres Java gebaut wurden, können auf dem neuen fehlschlagen.

Über viele Versionen hinweg aktualisieren

Von 1.8 oder 1.12 auf 1.21 zu gehen ist eher ein Neuschreiben der Teile, die Items, Blöcke und Partikel betreffen, als ein Update. Mach es in einem Schritt gegen die neue API, nicht Version für Version, und rechne damit, dass auch die Config-Dateien neue Materialnamen brauchen.

Wenn das Plugin mehrere Versionen gleichzeitig unterstützen muss, kompiliere gegen die älteste unterstützte Version und vermeide später hinzugefügte API, oder nutze separate Builds pro Version.

Mit Codexe

Ab Pro kannst du den Quellcode des Plugins als ZIP importieren und zum Beispiel schreiben: „Das ist mein Paper-1.20.4-Plugin. Aktualisiere es auf Paper 1.21.4“. Codexe liest die Minecraft-Version aus der Build-Datei, baut mit der Java-Version, die diese Version braucht, und repariert Kompilierfehler anhand der echten Signaturen der API, gegen die es baut. Bei einem Plugin, das du auf Codexe erstellt hast, verlange die neue Version im Projekt-Chat.

Das Kompilieren beweist, dass das Plugin auf der neuen API baut. Probiere es danach auf einem Testserver aus, denn Verhaltensänderungen zwischen Versionen zeigen sich nicht als Kompilierfehler.

Fragen