Seu mod não quebra

Um mod do Crafting precisa continuar funcionando quando o Minecraft é atualizado e quando o Crafting é atualizado. Esta página diz o que é garantido e o que você precisa fazer para aproveitar isso.

O que é garantido

Tudo o que é público na API de Kotlin e Java, e cada palavra-chave, função embutida e nome de evento do CraftScript. Os detalhes internos do Crafting (como ele carrega os mods, como se conecta ao jogo) podem mudar em qualquer versão; seu mod não os vê e não precisa deles.

Por que as atualizações do jogo não o quebram

Seu mod nunca toca no código do Minecraft. Quando uma nova versão do jogo move ou renomeia algo, o Crafting muda internamente qual parte do jogo cada função da API chama. A função que seu mod usa continua com o mesmo nome e faz a mesma coisa.

Hoje o Crafting funciona com o Minecraft Java 26.3. Cada nova versão do jogo é adicionada por completo: ou uma função da API funciona nessa versão, ou a versão não é considerada suportada.

Quatro regras

1. As coisas são adicionadas, não alteradas. Um novo parâmetro vem com valor padrão, então as chamadas existentes continuam válidas. Um comportamento novo vem com um nome novo.
2. Substituições vêm com aviso. Quando existe um jeito melhor de fazer algo, o antigo é marcado como obsoleto, diz o que usar no lugar e continua funcionando exatamente igual, pelo menos até a próxima versão principal. Seu editor o mostra riscado.
3. As coisas só são removidas em uma versão principal, aquela que muda o primeiro número da versão do Crafting. Isso é anunciado nas notas de versão, com o substituto de cada item.
4. Nada é fingido. Se uma função não pode funcionar no jogo que está rodando, ela dá um erro claro. Nunca retorna um valor inventado que faça o mod pensar que deu tudo certo.

O que isso significa para você

• Atualizar o Crafting nunca obriga você a mudar seu mod, exceto em uma versão principal, e aí você vai saber exatamente o que mudar.
• Quando algo que você usa aparece como obsoleto, você tem tempo: mude quando for conveniente, antes da próxima versão principal. A documentação sempre mostra o jeito atual.
• Se um mod precisa de algo que sua versão do Crafting ainda não tem, o Crafting avisa ao carregá-lo em vez de carregá-lo pela metade.
• Não importe classes de net.minecraft em um mod Kotlin ou Java: essa parte não tem garantia nenhuma.
• Evite run_command e summon com dados do jogo: eles aceitam formatos do Minecraft, que mudam. Se você precisa deles para algo, está faltando uma função na API; peça por ela.

Se algo falhar

• Um erro em um evento ou comando é registrado no log com o nome do mod, e o resto do servidor continua rodando.
• Um script com erros de tipo não é carregado, e a mensagem informa o arquivo, a linha e o que era esperado.
• Um mod .jar que não tem uma dependência ou precisa de uma versão mais nova do Crafting não é carregado, e o Crafting informa todos os problemas de uma vez, com uma sugestão para cada um.