Guias
Solução de problemasImportOutputDiff

Por que seu comando Minecraft não está funcionando

9 min de leitura

A maioria dos comandos quebrados falha por um dos quatro motivos: o comando tem como alvo a versão Minecraft errada, o seletor não corresponde a nada, o JSON ou NBT está malformado ou o comando usa dados somente Java em Bedrock. NBTForge ajuda reconstruindo comandos suportados em campos digitados, mostrando avisos e mantendo o Output visível enquanto você edita.

Comece identificando o tipo de falha e siga a lista de verificação antes de tentar novamente o comando.
Cole o comando quebrado primeiro em Import e, em seguida, confirme a edição Java e o destino da versão.
Mantenha o Output visível enquanto corrige o comando e use Diff após cada alteração para que a edição real seja óbvia.

Resultado

Um passo de depuração de comando repetível que isola problemas de sintaxe, destino, versão e edição antes de colar novamente.

Abrir módulo relacionadoImport, Output, DiffDepurando comandos quebrados

Caminho recomendado

  1. Cole o comando na barra de importação e verifique se NBTForge pode roteá-lo para um módulo visual.
  2. Configure Edition e Version para corresponder ao mundo que executará o comando.
  3. Leia os avisos de Output antes de alterar os campos, especialmente ao mover entre Java e Bedrock.
  4. Verifique os seletores de destino separadamente com um comando de teste simples antes de culpar a carga NBT.
  5. Use Diff após cada correção para saber qual parte do comando realmente foi alterada.

Comece com incompatibilidade de versão

Um comando copiado de um mundo Java atual pode falhar em Java 1.20.4 ou anterior porque a sintaxe do componente do item ainda não existia. O inverso também é comum: o item antigo NBT pode ser aceito por um mundo mais antigo, mas falha ou se comporta de maneira diferente após a mudança do componente do item 1.20.5.

Defina primeiro a versão NBTForge e depois gere novamente o Output. Se o comando mudar de forma após a mudança de versão, trate isso como uma diferença de sintaxe real, em vez de uma reescrita cosmética.

  • Use Java 1.20.4 ou anterior para exemplos de itens legados NBT.
  • Use Java 1.20.5+ para Output de item no estilo de componente.
  • Use Bedrock Estável somente quando a família de comandos for suportada pela sintaxe Bedrock.

Separar bugs de seletores de bugs de carga útil

Um comando válido pode parecer quebrado quando o seletor não corresponde a nenhuma entidade ou corresponde ao jogador errado. Teste o seletor com um pequeno comando, como título, Tellraw ou efeito, antes de depurar uma convocação longa ou fornecer carga útil.

Quando um seletor inclui filtros de distância, pontuações, tags, equipes ou NBT, remova os filtros um de cada vez até que o comando comece a corresponder novamente. Em seguida, adicione filtros novamente nas menores etapas possíveis.

Verifique cotações e dados aninhados

Comandos longos geralmente quebram componentes de texto JSON aninhados, aspas de escape, nomes de itens, linhas lore ou NBT escrito à mão. Se o comando incluir texto visível do jogador, reconstrua esse texto no editor visual em vez de editar as citações manualmente.

NBTForge é mais útil após a importação porque transforma uma string grande em campos digitados menores. Edite um campo, verifique o Output e evite alterar várias seções aninhadas de uma só vez.

  • Os nomes e lore geralmente falham porque o texto JSON tem escape duplo.
  • Os livros podem falhar quando o texto da página contém aspas sem escape.
  • Os dados personalizados podem falhar quando chaves ou colchetes não fecham na ordem correta.

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.

Para exemplos ao vivo para depurar, compare a Predefinição de comando de zumbi montado em aranha, Predefinição de comando de invocação do Spider Jockey e Predefinição de saque do chefe de fogo do Blaze Emperor.

  • 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

Por que um comando funciona em um mundo, mas não em outro?

A causa mais comum é uma incompatibilidade de versão ou edição de Minecraft. A sintaxe do item Java, os recursos de captura instantânea e o suporte ao comando Bedrock podem diferir mesmo quando o comando parece semelhante.

Devo corrigir um comando longo manualmente?

Apenas para pequenas edições. Para comandos de item longo, convocação, texto ou datapack, importe o comando e edite os campos visualmente para que o escape de cotação e os dados aninhados fiquem mais fáceis de revisar.

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.