Deine Mod geht nicht kaputt

Eine Crafting-Mod muss weiter funktionieren, wenn Minecraft aktualisiert wird und wenn Crafting aktualisiert wird. Diese Seite sagt, was garantiert ist und was du tun musst, um davon zu profitieren.

Was garantiert ist

Alles Öffentliche in der Kotlin- und Java-API und jedes Schlüsselwort, jede eingebaute Funktion und jeder Event-Name von CraftScript. Das Innenleben von Crafting (wie es Mods lädt, wie es sich ins Spiel einklinkt) kann sich in jeder Version ändern. Deine Mod sieht es nicht und braucht es nicht.

Warum Spielupdates sie nicht kaputt machen

Deine Mod fasst den Code von Minecraft nie an. Verschiebt oder benennt eine neue Spielversion etwas um, ändert Crafting intern, welchen Teil des Spiels jede API-Funktion aufruft. Die Funktion, die deine Mod nutzt, behält denselben Namen und macht dasselbe.

Heute funktioniert Crafting mit Minecraft Java 26.3. Jede neue Spielversion wird vollständig hinzugefügt: Entweder funktioniert eine API-Funktion auf dieser Version, oder die Version gilt nicht als unterstützt.

Vier Regeln

1. Dinge werden hinzugefügt, nicht geändert. Ein neuer Parameter kommt mit einem Standardwert, damit bestehende Aufrufe gültig bleiben. Neues Verhalten kommt mit einem neuen Namen.
2. Ersatz kommt mit einer Warnung. Gibt es einen besseren Weg für etwas, wird der alte als veraltet markiert, sagt, was du stattdessen nehmen sollst, und funktioniert genau gleich weiter, mindestens bis zur nächsten Hauptversion. Dein Editor zeigt ihn durchgestrichen.
3. Dinge werden nur in einer Hauptversion entfernt, der, die die erste Zahl der Crafting-Version ändert. Das wird in den Versionshinweisen angekündigt, mit dem Ersatz für jeden Punkt.
4. Nichts wird vorgetäuscht. Kann eine Funktion im laufenden Spiel nicht funktionieren, gibt sie einen klaren Fehler. Sie gibt nie einen erfundenen Wert zurück, der die Mod glauben lässt, alles sei gut gegangen.

Was das für dich bedeutet

• Ein Update von Crafting zwingt dich nie, deine Mod zu ändern, außer in einer Hauptversion, und dann weißt du genau, was du ändern musst.
• Wird etwas, das du nutzt, als veraltet angezeigt, hast du Zeit: Ändere es, wann es dir passt, vor der nächsten Hauptversion. Die Dokumentation zeigt immer den aktuellen Weg.
• Braucht eine Mod etwas, das deine Crafting-Version noch nicht hat, sagt Crafting das beim Laden, statt sie halb zu laden.
• Importiere in einer Kotlin- oder Java-Mod keine Klassen aus net.minecraft: Für diesen Teil gibt es überhaupt keine Garantie.
• Vermeide run_command und summon mit Spieldaten: Sie akzeptieren Minecraft-Formate, und die ändern sich. Brauchst du sie für etwas, fehlt der API eine Funktion. Frag danach.

Wenn etwas schiefgeht

• Ein Fehler in einem Event oder einem Befehl wird mit dem Namen der Mod geloggt, und der Rest des Servers läuft weiter.
• Ein Skript mit Typfehlern wird nicht geladen, und die Meldung nennt die Datei, die Zeile und was erwartet wurde.
• Eine .jar-Mod, der eine Abhängigkeit fehlt oder die eine neuere Crafting-Version braucht, wird nicht geladen, und Crafting meldet alle Probleme auf einmal, mit einem Vorschlag für jedes.