Presets

Predefinições de itens

Comando de item de dados de modelo personalizado do Minecraft

O custom_model_data só é útil quando corresponde a um modelo de pacote de recursos. Este artigo atualizado concentra-se no fluxo de trabalho completo: escolha o item, atribua o valor do modelo, rotule o item para os jogadores e mantenha o custom_data disponível para a lógica de comando.

Ler emENRUDEESPT中文日本語VIFR한국어IDPLTR

Resultado do preset

Um comando de item pronto para pacote de recursos com um ID de modelo claro e um marcador de dados estável.

Saída

Output do Give de dados de modelo personalizado

/give @p minecraft:diamond_sword[custom_name={text:"Runed Blade",color:"aqua",italic:false},lore=[{text:"Resource-pack model 1001",color:"gray",italic:false}],custom_model_data={floats:[1001]},enchantment_glint_override=true,custom_data={model_item:"runed_blade"}] 1
Too long for Minecraft chat

The longest command line is 266 characters, 10 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

A workbench destaca o valor do modelo, o texto de exibição e o Output pronta para cópia juntos.
A segunda cena destaca os campos que alteram a dica de ferramenta do item ou a carga útil do componente.
A captura da Output mantém o comando final e os controles de cópia visíveis antes do teste.
A cena do jogo confirma que o comando de item do pacote de recursos entrega a pilha de itens pretendida.

Criar o preset

  1. Abra o Give e escolha o item que o pacote de recursos remapeia.
  2. Configure o custom_model_data com o valor esperado pelo pacote de recursos.
  3. Adicione custom_name e lore que descrevem o item modelado, e não o item base bruto.
  4. Copie o comando e teste com o pacote de recursos ativado antes da publicação.

ID do modelo e identidade do item

O mesmo valor de modelo não significa nada sem o pacote de recursos correspondente. Mantenha o ID do modelo visível na lore durante o teste e, em seguida, remova-o ou substitua-o por texto voltado para o jogador quando o pacote estiver estável.

O custom_data deve armazenar a identidade do item separadamente. Isso permite que os comandos detectem o item sem depender do número do modelo ou do nome de exibição.

Notas de versão

O formato da Output de custom_model_data depende da família de versões Java selecionada. Use o NBTForge para reconstruir o item ao dar suporte aos mundos de pré-componentes e de componentes atuais.

As páginas geradas e redirecionadas para combinações individuais de item/modelo agora apontam para cá, para que o site tenha um recurso canônico mais forte para essa intenção.

Para fluxos de trabalho de itens próximos, compare o Gerador de comando de cabeça de jogador do Minecraft e o Nome personalizado e preset de lore para qualquer item.

  • Faça o valor do modelo combinar com o pacote de recursos.
  • Mantenha o texto de exibição legível para os jogadores.
  • Use custom_data para a lógica de comando.

Ajuste o preset em um Project real

Trate o comando de item de dados de modelo personalizado do Minecraft como um ponto de partida testado, e não apenas como uma string copiada. Depois que o Output funcionar uma vez, salve-a com um nome de Project claro, anote a versão de destino do Minecraft e mantenha o preset perto dos comandos de configuração relacionados, como scoreboard, bossbar, saque ou linhas de redefinição.

Antes de publicar o preset em um mapa, servidor ou Command Pack, execute-o a partir do artefato copiado, e não apenas a partir da workbench ativa. Isso detecta dependências ausentes, seletores obsoletos, escolhas de edição erradas e comandos que só funcionaram porque o estado de teste local já existia.

  • Mantenha a edição e a versão selecionadas junto com o comando compartilhado.
  • Teste os seletores com um comando inofensivo antes de usar dano, matar, limpar ou teletransportar.
  • Mova comandos longos para um Project ou para um fluxo de trabalho no estilo de função, em vez de colá-los no chat.
  • Revise os avisos novamente depois de alterar entidades, componentes de item, passageiros ou recursos de datapack.

FAQ

O custom_model_data cria um modelo sozinho?

Não. Ele seleciona um modelo fornecido por um pacote de recursos. O comando e o pacote de recursos devem concordar quanto ao valor.

Devo detectar itens por custom_model_data?

Prefira custom_data para a lógica. O custom_model_data é principalmente um gancho de renderização, enquanto o custom_data é mais claro para comandos.

Quando este preset deve se tornar parte de um Command Pack?

Use-o como uma entrada de Command Pack quando o Output depender de linhas de configuração, comandos de redefinição, recursos de saque, estado de scoreboard ou testes repetidos. Comandos seguros e únicos ainda podem ser copiados diretamente da Output.

Abrir este fluxo

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