Presets

Predefinições avançadas

Migração de preset de comando Java legado

A migração de preset de comando Java legado é um fluxo de trabalho avançado completo, não apenas uma nota de comando modelo. Use este preset quando um Command Pack antigo precisar passar de exemplos Java legados para o Output atual do NBTForge. A migração começa pela intenção do item ou da entidade — e não pela substituição cega de strings —, o que torna o comando finalizado mais fácil de auditar. O artigo mantém os campos de configuração, a revisão de Output, o posicionamento no Project e a captura de resultados juntos, para que o comando seja fácil de auditar antes de se tornar parte de uma configuração de mapa, gatilho de evento ou Command Pack reutilizável. A superfície de revisão deve mostrar o comando legado importado, o Output moderna reconstruída e a diferença entre eles. É aí que a migração de sintaxe se torna um fluxo de trabalho controlado, em vez de uma edição arriscada de uma linha.

Resultado do preset

Um fluxo de trabalho de migração que converte a intenção do item Java antigo na Output de componente atual, com notas de revisão.

Saída

Notas de migração do legado para o atual

Legacy command intent: named sword with lore, sharpness, unbreakable, and custom marker.
Modern rebuild: /give @p minecraft:diamond_sword[custom_name={text:"Legacy Blade",color:"gold",italic:false},lore=[{text:"Migrated component item",color:"gray",italic:false}],enchantments={"minecraft:sharpness":5},unbreakable={},custom_data={legacy_item:1}] 1
Review: compare old NBT fields to current components before replacing the saved Project entry.
Too long for Minecraft chat

The longest command line is 259 characters, 3 over the 256-character chat input limit. Pasting it into chat can truncate the line and make Minecraft report a syntax error even when the generated command is valid.

  • Use a Command Block: run /give @s command_block, place it, then paste this command into the block command field.
  • Use a .mcfunction for a reusable datapack: save the line without the leading slash at saves/<world>/datapacks/<pack>/data/<ns>/function/<name>.mcfunction with a minimal pack.mcmeta, run /reload, then run /function <ns>:<name>. Do not paste .mcfunction content into chat.

Captura do preset

Comece com os controles avançados que definem o estado da preset.
A segunda cena destaca a configuração ou o comando complementar que muda o comportamento do jogador.
A captura de tela da Output mantém o comando final ou o par de comandos visível antes de entrar no Project.

Criar o preset

  1. Cole ou documente a intenção do comando antigo.
  2. Escolha o módulo NBTForge atual que corresponde à família de comandos.
  3. Reconstrua o recurso de item, entidade ou datapack a partir dos campos.
  4. Compare o NBT legado e o Output moderna no Diff.
  5. Salve o comando migrado como uma entrada Project separada.
  6. Substitua o comando antigo somente depois que a nova Output for testada.

Por que este preset avançada pertence ao Project

Use este preset quando um Command Pack antigo precisar passar de exemplos Java legados para o Output atual do NBTForge. A migração começa pela intenção do item ou da entidade — e não pela substituição cega de strings —, o que torna o comando finalizado mais fácil de auditar.

A superfície de revisão deve mostrar o comando legado importado, o Output moderna reconstruída e a diferença entre eles. É aí que a migração de sintaxe se torna um fluxo de trabalho controlado, em vez de uma edição arriscada de uma linha. Um comando copiado só é útil quando as suposições ao redor são visíveis: escopo do seletor, estado do mundo, ordem dentro do pacote e o Output exata que será colada no Minecraft. Trate este preset como um ponto de verificação onde esses detalhes podem ser revisados antes que o comando saia do NBTForge.

A galeria está estruturada em torno dessa revisão. A primeira cena mostra o estado da workbench, a segunda mostra o campo ou módulo complementar que muda o comportamento do jogador, e a cena de Output mantém o comando ou par de comandos visível. Quando a preset tem um resultado visível, a captura de tela do jogo confirma a mesma ideia em um mundo de teste limpo, em vez de depender de uma sobreposição genérica.

Testes e verificações de escopo

Algumas ideias legadas do NBT são mapeadas para componentes modernos, algumas mudam para `custom_data` e outras precisam de um design totalmente diferente. Reconstrua e teste cada família de comandos separadamente, em vez de fazer uma substituição global de texto.

Execute o primeiro teste rápido com um seletor restrito e um estado de mundo limpo. Comandos de ambiente, utilidade, roteamento e feedback podem parecer inofensivos, mas geralmente afetam todos os jogadores ou o mundo inteiro. Confirme se o comando altera apenas o estado pretendido e salve o Output exata ao lado das linhas de configuração ou de acompanhamento que explicam por que ela existe.

Se o comando se tornar parte de um arquivo de função ou de uma cadeia de blocos de comando, teste o artefato copiado — não apenas o estado da workbench ativa. Isso detecta seletores obsoletos, ordem de comando incorreta, linhas de configuração ausentes e efeitos que só pareciam funcionar porque um teste anterior deixou o estado para trás.

  • Mantenha os seletores restritos até que o pacote completo seja revisado.
  • Coloque a configuração do mundo antes das substituições específicas do encontro.
  • Salve os comandos de feedback próximos à mudança de estado que os aciona.

Para onde ir a seguir

Migre uma entrada Project salva por vez e mantenha o Output antiga até que o novo comando passe em um teste de mundo limpo.

Para migração específica de item, consulte o Guia de preset de NBT de item do Java 1.20.4 e o Guia de preset de componente de item do Java 1.21.

FAQ

Posso colar este comando avançado no chat?

Em geral, sim, para um teste rápido de um único comando, se o seletor for seguro e a linha for curta. Para um comportamento de mapa repetível, salve-o no Project e copie o pacote ordenado ou o Output em estilo de função.

Por que esta galeria é apenas de interface?

Esta preset produz JSON, organização de Project ou fluxo de trabalho de revisão, em vez de um objeto visível no mundo. A prova útil é o estado da workbench, o Output e o posicionamento no Project.

O que devo verificar antes de compartilhar este preset?

Verifique o escopo do seletor, a ordem do comando, a versão de destino e se o comando pertence à configuração, à lógica de encontro, ao feedback ou à limpeza. Essas categorias decidem onde ele deve ficar em um pacote Project.

Abrir este fluxo

Comece pelo painel Advanced relacionado e ajuste os campos do preset para o seu mundo.