Tu mod no se rompe

Un mod de Crafting tiene que seguir funcionando cuando se actualiza Minecraft y cuando se actualiza Crafting. Esta página dice qué está garantizado y qué tienes que hacer tú para aprovecharlo.

Qué está garantizado

Todo lo público de la API de Kotlin y Java, y todas las palabras clave, funciones integradas y nombres de eventos de CraftScript. Lo que hay dentro de Crafting (cómo carga los mods, cómo se conecta con el juego) puede cambiar en cualquier versión; tu mod no lo ve ni lo necesita.

Por qué no se rompe cuando cambia el juego

Tu mod nunca toca el código de Minecraft. Cuando una versión nueva del juego mueve o renombra algo, Crafting cambia por dentro a qué parte del juego llama cada función de la API. La función que usa tu mod sigue llamándose igual y haciendo lo mismo.

Hoy Crafting funciona con Minecraft Java 26.3. Cada versión nueva del juego se añade entera: o una función de la API funciona en esa versión, o la versión no se da por soportada.

Cuatro reglas

1. Se añade, no se cambia. Un parámetro nuevo llega con un valor por defecto, así que las llamadas que ya existían siguen valiendo. Un comportamiento nuevo llega con un nombre nuevo.
2. Se sustituye avisando. Cuando hay una forma mejor de hacer algo, la antigua se marca como obsoleta, indica qué usar en su lugar y sigue funcionando exactamente igual, como mínimo hasta la siguiente versión mayor. Tu editor la muestra tachada.
3. Solo se quita en una versión mayor, la que cambia el primer número de la versión de Crafting. Se anuncia en las notas de la versión, con el sustituto de cada cosa.
4. Nada se finge. Si una función no puede funcionar en el juego que está corriendo, da un error claro. Nunca devuelve un valor inventado que haga creer al mod que todo fue bien.

Qué significa para ti

• Actualizar Crafting nunca te obliga a cambiar el mod, salvo en una versión mayor, y entonces sabrás exactamente qué cambiar.
• Cuando algo que usas aparezca como obsoleto, tienes tiempo: cámbialo cuando te venga bien, antes de la siguiente versión mayor. La documentación muestra siempre la forma actual.
• Si un mod necesita algo que tu versión de Crafting todavía no tiene, Crafting lo dice al cargarlo en lugar de cargarlo a medias.
• No importes clases de net.minecraft en un mod de Kotlin o Java: esa parte no tiene ninguna garantía.
• Evita run_command y summon con datos del juego: aceptan formatos de Minecraft, que sí cambian. Si los necesitas para algo, es una función que le falta a la API; pídela.

Si algo falla

• Un error en un evento o un comando se registra con el nombre del mod y el resto del servidor sigue.
• Un script con errores de tipos no se carga, y el mensaje dice archivo, línea y qué esperaba.
• Un mod en .jar al que le falta una dependencia o que necesita una versión de Crafting más nueva no se carga, y Crafting informa de todos los problemas a la vez con una sugerencia para cada uno.