Projet

Ton mod ne casse pas

Un mod Crafting doit continuer de fonctionner quand Minecraft se met à jour et quand Crafting se met à jour. Cette page dit ce qui est garanti et ce que tu dois faire pour en profiter.

Ce qui est garanti

Tout ce qui est public dans l’API Kotlin et Java, ainsi que chaque mot-clé, fonction intégrée et nom d’événement de CraftScript. Les rouages internes de Crafting (comment il charge les mods, comment il se branche sur le jeu) peuvent changer dans n’importe quelle version ; ton mod ne les voit pas et n’en a pas besoin.

Pourquoi les mises à jour du jeu ne le cassent pas

Ton mod ne touche jamais au code de Minecraft. Quand une nouvelle version du jeu déplace ou renomme quelque chose, Crafting change en interne la partie du jeu que chaque fonction de l’API appelle. La fonction qu’utilise ton mod garde le même nom et fait la même chose.

Aujourd’hui, Crafting fonctionne avec Minecraft Java 26.3. Chaque nouvelle version du jeu est ajoutée en entier : soit une fonction de l’API fonctionne sur cette version, soit la version n’est pas considérée comme prise en charge.

Quatre règles

On ajoute, on ne modifie pas. Un nouveau paramètre arrive avec une valeur par défaut, donc les appels existants restent valides. Un nouveau comportement arrive avec un nouveau nom.
Les remplacements arrivent avec un avertissement. Quand il existe une meilleure façon de faire quelque chose, l’ancienne est marquée comme dépréciée, indique quoi utiliser à la place et continue de fonctionner exactement pareil, au moins jusqu’à la prochaine version majeure. Ton éditeur l’affiche barrée.
On ne retire rien sauf dans une version majeure, celle qui change le premier nombre de la version de Crafting. C’est annoncé dans les notes de version, avec le remplacement de chaque élément.
Rien n’est simulé. Si une fonction ne peut pas fonctionner dans le jeu en cours d’exécution, elle donne une erreur claire. Elle ne renvoie jamais une valeur inventée qui ferait croire au mod que tout s’est bien passé.

Ce que ça veut dire pour toi

Mettre Crafting à jour ne t’oblige jamais à modifier ton mod, sauf dans une version majeure, et là tu sauras exactement quoi changer.
Quand quelque chose que tu utilises apparaît comme déprécié, tu as le temps : change-le quand ça t’arrange, avant la prochaine version majeure. La documentation montre toujours la façon actuelle.
Si un mod a besoin de quelque chose que ta version de Crafting n’a pas encore, Crafting le dit au chargement au lieu de le charger à moitié.
N’importe pas de classes net.minecraft dans un mod Kotlin ou Java : cette partie n’a aucune garantie.
Évite run_command et summon avec des données du jeu : ils acceptent des formats de Minecraft, qui changent. Si tu en as besoin pour quelque chose, c’est qu’il manque une fonction à l’API ; demande-la.

Si quelque chose échoue

Une erreur dans un événement ou une commande est consignée avec le nom du mod, et le reste du serveur continue de tourner.
Un script avec des erreurs de type ne se charge pas, et le message donne le fichier, la ligne et ce qui était attendu.
Un mod .jar à qui il manque une dépendance ou qui demande une version plus récente de Crafting ne se charge pas, et Crafting signale tous les problèmes d’un coup avec une suggestion pour chacun.