La tua mod non si rompe

Una mod di Crafting deve continuare a funzionare quando Minecraft si aggiorna e quando si aggiorna Crafting. Questa pagina dice cosa è garantito e cosa devi fare per approfittarne.

Cosa è garantito

Tutto ciò che è pubblico nell’API Kotlin e Java, e ogni parola chiave, funzione integrata e nome di evento di CraftScript. Gli interni di Crafting (come carica le mod, come si aggancia al gioco) possono cambiare in qualsiasi versione; la tua mod non li vede e non ne ha bisogno.

Perché gli aggiornamenti non la rompono

La tua mod non tocca mai il codice di Minecraft. Quando una nuova versione del gioco sposta o rinomina qualcosa, Crafting cambia internamente quale parte del gioco chiama ogni funzione dell’API. La funzione che usa la tua mod mantiene lo stesso nome e fa la stessa cosa.

Oggi Crafting funziona con Minecraft Java 26.3. Ogni nuova versione del gioco viene aggiunta per intero: o una funzione dell’API funziona su quella versione, o la versione non è considerata supportata.

Quattro regole

1. Le cose si aggiungono, non si cambiano. Un nuovo parametro arriva con un valore predefinito, così le chiamate esistenti restano valide. Un nuovo comportamento arriva con un nuovo nome.
2. Le sostituzioni arrivano con un avviso. Quando c’è un modo migliore per fare qualcosa, quello vecchio viene segnato come deprecato, dice cosa usare al suo posto e continua a funzionare esattamente allo stesso modo, almeno fino alla prossima versione principale. Il tuo editor lo mostra barrato.
3. Le cose si rimuovono solo in una versione principale, quella che cambia il primo numero della versione di Crafting. Viene annunciato nelle note di rilascio, con il sostituto di ogni elemento.
4. Niente viene simulato. Se una funzione non può funzionare nel gioco in esecuzione, dà un errore chiaro. Non restituisce mai un valore inventato che faccia credere alla mod che sia andato tutto bene.

Cosa significa per te

• Aggiornare Crafting non ti obbliga mai a cambiare la tua mod, tranne in una versione principale, e allora saprai esattamente cosa cambiare.
• Quando qualcosa che usi risulta deprecato, hai tempo: cambialo quando ti va, prima della prossima versione principale. La documentazione mostra sempre il modo attuale.
• Se una mod ha bisogno di qualcosa che la tua versione di Crafting non ha ancora, Crafting lo dice al caricamento invece di caricarla a metà.
• Non importare classi net.minecraft in una mod Kotlin o Java: quella parte non ha alcuna garanzia.
• Evita run_command e summon con dati del gioco: accettano formati di Minecraft, che invece cambiano. Se ti servono per qualcosa, all’API manca una funzione: chiedila.

Se qualcosa va storto

• Un errore in un evento o in un comando viene registrato nel log con il nome della mod e il resto del server continua a funzionare.
• Uno script con errori di tipo non viene caricato, e il messaggio indica il file, la riga e cosa si aspettava.
• Una mod .jar a cui manca una dipendenza o che richiede una versione più recente di Crafting non viene caricata, e Crafting segnala tutti i problemi insieme con un suggerimento per ciascuno.