MCTOOLBOX
MC ToolboxMC TOOLBOX
Migração de comando Java

Conversor de NBT para Componentes do Minecraft

Converta NBT de itens legados do Java 1.20.4 e anteriores para a sintaxe de componentes de itens para 1.20.5, 1.21.x e as versões atuais 26.x. Os comandos permanecem no seu navegador.

Entrada legada

NBT de item antigo ou comando /give

Carregar exemplo:

Saída convertida

Comando /give atual

/give @p minecraft:diamond_sword[minecraft:custom_name={text:'Frost Blade',color:'aqua',italic:false},minecraft:lore=[{text:'Forged below Y -59',color:'gray'}],minecraft:damage=12,minecraft:repair_cost=3,minecraft:custom_model_data={floats:[27]},minecraft:unbreakable={},minecraft:enchantments={'minecraft:sharpness':5},minecraft:tooltip_display={hidden_components:['minecraft:unbreakable']}] 1

Componentes convertidos

8

Item detectado

minecraft:diamond_sword

Componentes convertidos

  • display.Nameminecraft:custom_name
  • display.Loreminecraft:lore
  • Damageminecraft:damage
  • RepairCostminecraft:repair_cost
  • CustomModelDataminecraft:custom_model_data
  • Unbreakableminecraft:unbreakable
  • Enchantmentsminecraft:enchantments
  • HideFlagsminecraft:tooltip_display

Campos reconhecidos

Nomes, lore, encantamentos, dano, custo de reparo, inquebrável, CustomModelData, dados de poção, perfis, atributos e predicados de modo aventura são mapeados para componentes.

Saída ciente da versão

Minecraft 1.21.4 mudou CustomModelData, enquanto 1.21.5 simplificou vários componentes e introduziu tooltip_display. Escolha a versão do servidor que você realmente usa.

Fallback seguro

Tags desconhecidas são preservadas em minecraft:custom_data e listadas para revisão. O conversor não finge que custom_data faz com que mecânicas de jogo obsoletas funcionem.

Por que o Minecraft substituiu o NBT de itens por componentes

Minecraft Java 1.20.5 substituiu a antiga tag de item, em sua maioria não estruturada, por componentes de dados tipados. Em comandos, os componentes aparecem entre colchetes após o ID do item, separados por vírgulas. Damage se tornou minecraft:damage, display.Name se tornou minecraft:custom_name, Enchantments se tornou minecraft:enchantments, e campos personalizados arbitrários foram movidos para minecraft:custom_data.

Esta não foi uma mudança de sintaxe única. Minecraft 1.21.4 expandiu custom_model_data em listas usadas pelo novo sistema de modelo de item. Minecraft 1.21.5 moveu a visibilidade da tooltip para minecraft:tooltip_display e simplificou encantamentos, atributos, cores tingidas e predicados de modo aventura. Os comandos atuais 26.x continuam a partir desse formato de componente mais recente.

Um conversor pode mapear campos de itens conhecidos, mas não pode reparar automaticamente cada command block ou data pack. NBT de entidade, dados de entidade de bloco, funções de loot, predicados e componentes de texto também mudaram entre as versões. Sempre teste o comando gerado em uma cópia do mundo de destino ou em um servidor de teste.

Como converter um comando /give antigo

  1. 1Cole um comando /give do Java Edition 1.20.4 ou anterior. Você também pode colar apenas o composto entre chaves.
  2. 2Escolha a família de destino exata. Use 1.21.5 - 26.x para servidores atuais, não o formato de componente 1.20.5 mais antigo.
  3. 3Leia todos os avisos. custom_data preservado é um armazenamento seguro, mas não ativa uma tag obsoleta de Damage, Potion ou AttributeModifiers.
  4. 4Copie o comando gerado e teste-o em um mundo temporário antes de substituir comandos em um data pack ou sistema de command blocks.

O que este conversor não muda

Ele converte uma pilha de itens ou um comando /give por vez. Ele não escaneia um data pack inteiro, reescreve verificações de execute if data, ou atualiza predicados de itens armazenados em arquivos JSON.

Ele não converte JSON de itens do Bedrock. Componentes de itens do Java e componentes de add-ons do Bedrock são sistemas diferentes, mesmo que alguns nomes pareçam semelhantes.

Componentes de texto de versões muito antigas ainda podem precisar de modernização manual. Perfis de jogador complexos, efeitos de poção personalizados e payloads de entidade de bloco devem ser verificados em relação à versão de destino.

FAQ de NBT para componentes

Por que meu antigo comando /give parou de funcionar na 1.20.5?

Java 1.20.5 moveu os dados do item da antiga estrutura {tag} para componentes tipados escritos entre colchetes após o ID do item.

Posso colocar todas as tags antigas dentro de minecraft:custom_data?

Você pode preservar campos arbitrários lá, mas as mecânicas embutidas não leem mais tags estruturais antigas como Damage ou Enchantments de custom_data. Elas precisam de seus componentes reais.

Qual alvo devo usar para Minecraft 26.2 ou 26.3?

Use Minecraft 1.21.5 - 26.x. Essa saída usa formas simplificadas de encantamento e atributo, além de tooltip_display do sistema de componentes mais recente.

O conversor suporta comandos completos?

Sim. Ele lê um alvo /give legado, ID do item, composto NBT e contagem, então reconstrói um comando /give atual. Ele também aceita um composto NBT autônomo.

Por que há um aviso para BlockEntityTag?

block_entity_data atual deve identificar uma entidade de bloco válida. Alguns comandos antigos dependiam do tipo de item e omitiam o ID, então esse campo precisa de revisão manual.

A conversão é realizada em um servidor?

Não. A análise e a conversão são executadas localmente no seu navegador. O comando não é enviado por esta ferramenta.