Java 1.20.4 NBT vs 1.20.5+ componentes do item
8 min de leitura
Minecraft Java 1.20.5 moveu muitos recursos de itens do legado NBT para componentes de itens. Essa mudança afeta comandos de fornecimento, substituição de itens, recompensas de saque, nomes personalizados, lore, enchantments, dados personalizados e muitos fluxos de trabalho de pacotes de recursos. NBTForge mantém o seletor de versão visível porque não se trata apenas de formatação.
Resultado
Uma regra de decisão clara sobre quando usar o item legado NBT e quando usar componentes de item modernos.
Caminho recomendado
- Escolha a versão exata do Java antes de editar a pilha de itens.
- Crie o item uma vez e alterne entre 1.20.4 e 1.20.5+ apenas para comparar o Output intencionalmente.
- Trate nome personalizado, lore, enchantments, inquebrável, raridade, brilho e dados personalizados como campos sensíveis à versão.
- Use entradas Project para manter uma versão legada e moderna lado a lado ao oferecer suporte a vários mundos.
- Documente a versão alvo ao lado dos comandos que você compartilha com outros criadores.
Quando o item legado NBT ainda é o alvo certo
Use o item herdado NBT quando o comando precisar ser executado em Java 1.20.4 ou mais antigo. Nessa família mundial, muitos detalhes do item residem dentro da antiga estrutura NBT e o Output do componente não é a sintaxe de destino.
O Output herdada também é útil ao migrar uma biblioteca de comandos mais antiga. Import o comando antigo, compare os campos analisados e, em seguida, gere novamente somente após escolher a nova versão de destino.
Quando os componentes do item são o alvo certo
Use o Output do componente para Java 1.20.5 e posterior. A sintaxe do componente é o formato moderno para muitos recursos de item, incluindo nomes, lore, enchantments, dados personalizados e comportamento de exibição.
Se você estiver construindo novo conteúdo de mapa para versões atuais do Java, comece com o Output do componente e gere apenas a sintaxe legada quando souber que um servidor mais antigo precisa dela.
- Os comandos de item Java modernos devem ser gerados com a versão atual selecionada.
- Os fluxos de trabalho de saque e recompensa devem usar a mesma versão do datapack mundial.
- Não misture um comando give legado com um modificador de item da era do componente, a menos que você esteja migrando intencionalmente.
Como comparar com segurança
A troca de versões pode alterar os nomes dos campos, o aninhamento e, às vezes, quais campos são representáveis. Use o painel de comparação de Output após uma troca de versão, em vez de examinar um comando longo a olho nu.
Para modelos compartilhados, mantenha a versão no título do artigo, nome predefinido ou nome da entrada Project. Um comando chamado “espada de recompensa” é ambíguo; um comando chamado "espada de recompensa Java 1.21" é muito mais fácil de suportar.
Envie o artefato copiado
Use este guia para produzir o artefato que um jogador ou criador de mapas irá realmente executar: um comando copiado, um pacote Project ordenado ou um recurso de datapack. A revisão final deve acontecer na Output copiada, não apenas no estado editável do construtor.
Quando o fluxo de trabalho for sensível à versão, rotule a versão de destino ao lado do comando. Ao usar seletores, placares, bossbars, tags, tabelas de saque ou ordem de Project, teste essas dependências em um mundo limpo antes de publicar a configuração.
- Copie de Output para um comando e de Project para pacotes solicitados.
- Mantenha Java, Bedrock e variantes de snapshot separadas.
- Teste primeiro seletores destrutivos com Output inofensiva.
- Atualize as presets relacionadas quando o guia se tornar o fluxo de trabalho canônico.
Guias e presets relacionados
FAQ
O Output Java 1.20.5 é sempre melhor?
É melhor apenas para mundos que executam 1.20.5 ou posterior. Os mundos Java mais antigos precisam de sintaxe legada, portanto, o Output correta depende do mundo de destino.
Posso manter os dois formatos?
Sim. Salve entradas Project separadas para a versão legada e moderna, rotule-as claramente e atualize ambas quando o design do item subjacente for alterado.
Quando este guia deve se tornar um pacote Project?
Use Project quando o fluxo de trabalho precisar de mais de um comando, tiver ordem de configuração e limpeza ou precisar ser editado novamente após o teste. Comandos únicos podem permanecer em Output.