Twój mod się nie psuje

Mod Craftingu musi działać dalej, gdy aktualizuje się Minecraft i gdy aktualizuje się Crafting. Ta strona mówi, co jest gwarantowane i co musisz zrobić, żeby z tego skorzystać.

Co jest gwarantowane

Wszystko, co publiczne w API dla Kotlina i Javy, oraz każde słowo kluczowe, funkcja wbudowana i nazwa zdarzenia w CraftScript. Wnętrze Craftingu (jak wczytuje mody, jak podpina się pod grę) może się zmienić w każdej wersji; twój mod go nie widzi i go nie potrzebuje.

Dlaczego aktualizacje gry go nie psują

Twój mod nigdy nie dotyka kodu Minecrafta. Gdy nowa wersja gry przenosi coś lub zmienia nazwę, Crafting zmienia wewnętrznie, którą część gry wywołuje każda funkcja API. Funkcja, której używa twój mod, ma tę samą nazwę i robi to samo.

Dziś Crafting działa z Minecraft Java 26.3. Każda nowa wersja gry jest dodawana w całości: albo funkcja API działa w tej wersji, albo wersja nie jest uznawana za obsługiwaną.

Cztery zasady

1. Rzeczy się dodaje, nie zmienia. Nowy parametr przychodzi z wartością domyślną, więc istniejące wywołania pozostają poprawne. Nowe zachowanie przychodzi z nową nazwą.
2. Zamienniki przychodzą z ostrzeżeniem. Gdy jest lepszy sposób na zrobienie czegoś, stary zostaje oznaczony jako przestarzały, mówi, czego użyć zamiast niego, i działa dokładnie tak samo, co najmniej do następnej wersji głównej. Twój edytor pokazuje go przekreślonego.
3. Rzeczy usuwa się tylko w wersji głównej, tej, która zmienia pierwszą liczbę wersji Craftingu. Jest to ogłaszane w informacjach o wydaniu, z zamiennikiem dla każdego elementu.
4. Nic nie jest udawane. Jeśli funkcja nie może działać w uruchomionej grze, daje jasny błąd. Nigdy nie zwraca zmyślonej wartości, przez którą mod myśli, że wszystko poszło dobrze.

Co to oznacza dla ciebie

• Aktualizacja Craftingu nigdy nie zmusza cię do zmiany moda, z wyjątkiem wersji głównej, a wtedy będziesz dokładnie wiedzieć, co zmienić.
• Gdy coś, czego używasz, pojawia się jako przestarzałe, masz czas: zmień to, kiedy ci pasuje, przed następną wersją główną. Dokumentacja zawsze pokazuje aktualny sposób.
• Jeśli mod potrzebuje czegoś, czego twoja wersja Craftingu jeszcze nie ma, Crafting mówi o tym przy wczytywaniu, zamiast wczytać go do połowy.
• Nie importuj klas net.minecraft w modzie w Kotlinie lub Javie: ta część nie ma żadnej gwarancji.
• Unikaj run_command i summon z danymi gry: przyjmują formaty Minecrafta, które się zmieniają. Jeśli do czegoś ich potrzebujesz, w API brakuje funkcji; poproś o nią.

Jeśli coś zawiedzie

• Błąd w zdarzeniu lub poleceniu trafia do dziennika z nazwą moda, a reszta serwera działa dalej.
• Skrypt z błędami typów się nie wczytuje, a komunikat podaje plik, wiersz i to, czego się spodziewano.
• Mod .jar, któremu brakuje zależności lub który potrzebuje nowszej wersji Craftingu, się nie wczytuje, a Crafting zgłasza wszystkie problemy naraz, z podpowiedzią dla każdego.