Como fazer itens 3D e modelos próprios em um texture pack de Minecraft

O que é um modelo do Minecraft

O Java Edition 1.8 e mais novos desenha a maioria dos blocos e itens a partir de arquivos de modelo do pacote de recursos:

• assets/minecraft/models/block/ guarda os modelos de bloco, como oak_slab.json. Um arquivo de estado de bloco em blockstates/ diz qual modelo um bloco usa em cada estado: uma laje embaixo ou em cima, um tronco deitado.
• assets/minecraft/models/item/ guarda os modelos de item. A maioria dos itens usa um modelo plano (item/generated): o próprio jogo transforma o sprite de 16×16 em uma forma fina. Desde o 1.21.4, uma definição de item em assets/minecraft/items/ diz qual modelo um item mostra.

Um arquivo de modelo tem quatro partes principais:

• textures: nomes para as texturas que o modelo usa, como "oak_planks": "minecraft:block/oak_planks". particle é a textura das partículas ao quebrar.
• elements: os cubos. Cada um vai de um canto (from) até o oposto (to), medido em pixels de um bloco de 16 × 16 × 16, e pode ir de -16 a 32 em cada eixo. Com rotation dá para girar um cubo.
• faces: para cada lado de um cubo (down, up, north, south, west, east), a textura que ele mostra, a parte da textura (uv) e cullface, que pula a face quando um bloco inteiro cobre aquele lado.
• display: como o modelo é girado, movido e redimensionado no inventário (gui), nas mãos, no chão, na moldura (fixed) e na cabeça.

Este é um modelo de um cubo só com forma de laje, organizado do jeito que o editor de modelos escreve. Um arquivo feito no editor traz a exibição de todos os lugares, não só a do inventário:

{
  "textures": {
    "oak_planks": "minecraft:block/oak_planks",
    "particle": "#oak_planks"
  },
  "elements": [
    {
      "from": [0, 0, 0],
      "to": [16, 8, 16],
      "faces": {
        "down": {
          "texture": "#oak_planks",
          "cullface": "down"
        },
        "up": {
          "texture": "#oak_planks"
        },
        "north": {
          "texture": "#oak_planks",
          "cullface": "north"
        },
        "south": {
          "texture": "#oak_planks",
          "cullface": "south"
        },
        "west": {
          "texture": "#oak_planks",
          "cullface": "west"
        },
        "east": {
          "texture": "#oak_planks",
          "cullface": "east"
        }
      }
    }
  ],
  "display": {
    "gui": {
      "rotation": [30, 225, 0],
      "translation": [0, 0, 0],
      "scale": [0.625, 0.625, 0.625]
    }
  }
}

Modelos feitos à mão costumam usar "parent" para pegar as texturas, os cubos ou a exibição de outro modelo. O editor de modelos escreve arquivos completos: tudo o que ele leu dos modelos pais vai copiado para dentro, então o seu arquivo não depende de nenhum outro.

Fazer um item 3D passo a passo

1. Abra o Texture Pack Maker e crie um pack de Java para a versão que você joga: 1.8 ou mais nova, ou 1.21.4 ou mais nova se quiser que o item continue plano no inventário.
2. Mude a lista para Items e abra o item, por exemplo a espada de diamante. Na aba Preview, toque em Edit shape.
3. Escolha 3D item from sprite. Cada pixel da imagem plana vira parte de um cubo de 1 pixel de espessura.
4. Mude a forma: clique em um cubo na vista 3D ou na lista e mova, redimensione ou copie esse cubo, ou adicione novos. Em Faces, dê a uma face outra textura ou outra parte de uma.
5. Abra Display e confira o modelo no inventário, em primeira e terceira pessoa, no chão, na moldura e na cabeça. Ajuste a rotação, a posição ou o tamanho onde não ficar bom.
6. Opcional, a partir do 1.21.4: na aba Model, ative Flat in the inventory para manter o ícone plano ali e mostrar o modelo 3D na mão.
7. Toque em Done, exporte o pack como .zip, coloque na sua pasta resourcepacks e teste no jogo.

Como funciona o “3D item from sprite”

Um item plano é uma imagem só, o seu sprite, normalmente de 16×16 pixels. Esse ponto de partida pega cada pixel que não é transparente e monta com eles cubos de 1 pixel de espessura, centralizados como os itens planos do jogo (de 7,5 a 8,5 no eixo Z). Pixels seguidos em uma linha viram um cubo comprido, e linhas iguais uma embaixo da outra viram um retângulo, então a espada de diamante fica com 19 cubos em vez de um cubo por pixel. Faces que um pixel vizinho cobre por inteiro ficam de fora.

Cada face mostra os pixels correspondentes do sprite. Três pixels seguidos, nas colunas 5 a 7 da linha 3, formam este cubo:

{
  "from": [5, 12, 7.5],
  "to": [8, 13, 8.5],
  "faces": {
    "down": {
      "uv": [5, 3, 8, 4],
      "texture": "#layer0",
      "tintindex": 0
    },
    "up": {
      "uv": [5, 3, 8, 4],
      "texture": "#layer0",
      "tintindex": 0
    },
    "north": {
      "uv": [8, 3, 5, 4],
      "texture": "#layer0",
      "tintindex": 0
    },
    "south": {
      "uv": [5, 3, 8, 4],
      "texture": "#layer0",
      "tintindex": 0
    },
    "west": {
      "uv": [5, 3, 6, 4],
      "texture": "#layer0",
      "tintindex": 0
    },
    "east": {
      "uv": [7, 3, 8, 4],
      "texture": "#layer0",
      "tintindex": 0
    }
  }
}

A face da frente (south) mostra os pixels como são e a de trás (north) espelhados, como você vê um desenho por trás. Os cubos continuam usando a textura do próprio item (#layer0), então repintar o sprite muda as cores do item 3D. Pixels que você adiciona ou apaga só mudam a forma quando você escolhe 3D item from sprite de novo. Itens com várias camadas, como poções ou armadura de couro, ganham cubos para cada camada, e o jogo continua colorindo esses cubos.

Depois, deixe com a sua cara:

• Deixe a lâmina mais grossa: selecione os cubos dela e mude a posição e o tamanho em Z, por exemplo de 7,5 e 1 para 7 e 2.
• Adicione um cubo para a guarda ou uma gema com o botão + (ou N) e dê outra textura às faces dele em Faces > Change.
• Gire um cubo em Rotation. Antes do Minecraft 1.21.6 um cubo só gira em um eixo, -45°, -22,5°, 0°, 22,5° ou 45°; o editor oferece o que a sua versão aceita.
• Desfaça qualquer mudança com Ctrl+Z.

Como ele fica na mão: Display

A aba Display mostra o modelo em seis lugares. Cada um tem uma rotação em graus, uma posição em pixels (até ±80) e um tamanho (1 é normal, 4 no máximo).

3D item from sprite mantém a exibição do próprio item, então uma espada 3D fica na mão como a plana. Game’s default volta um lugar para os valores do jogo, e No change remove o ajuste. O Java 1.21.9 trouxe o lugar on_shelf para as prateleiras; o editor mantém o valor do modelo do jogo.

Manter o ícone plano no inventário (1.21.4+)

Muitos packs 3D mantêm o ícone plano de sempre no inventário e mostram o modelo 3D só na mão. Desde o Java 1.21.4, uma definição de item pode escolher o modelo conforme onde o item aparece. Ative Flat in the inventory na aba Model e o editor:

• salva a sua forma como um segundo modelo, models/item/diamond_sword_3d.json, e deixa o diamond_sword.json plano como está;
• escreve items/diamond_sword.json, que mostra o modelo plano no inventário (gui), no chão e nas molduras (fixed), e o 3D em todo o resto:

{
  "model": {
    "type": "minecraft:select",
    "property": "minecraft:display_context",
    "cases": [
      {
        "when": ["gui", "ground", "fixed"],
        "model": {
          "type": "minecraft:model",
          "model": "minecraft:item/diamond_sword"
        }
      }
    ],
    "fallback": {
      "type": "minecraft:model",
      "model": "minecraft:item/diamond_sword_3d"
    }
  }
}

As versões anteriores ao 1.21.4 não têm definições de item, então um item mostra o mesmo modelo em todo lugar e a opção não aparece.

Mudar a forma de um bloco

Com blocos é igual. Mostre um bloco na aba Preview e toque em Edit shape. O editor abre o modelo que o bloco usa no estado que você está vendo, e o menu no topo lista os outros modelos dele, como a laje de cima e a dupla. Fique com o modelo do jogo ou comece por Full cube, Slab, Cross (plant) ou Empty, e depois adicione, mova e redimensione cubos. Para transformar a pedra em um degrau, basta o ponto de partida Slab e mais um cubo:

• Modelos compartilhados: alguns blocos usam o mesmo arquivo de modelo. Quando outro bloco usa o modelo que você edita, o editor avisa qual; ele muda também.
• Os itens ficam separados: um item que mostra um modelo de bloco, como uma laje na mão, ganha o próprio modelo de item quando você edita o item, então o bloco mantém a forma.
• Só a aparência muda: a hitbox, a colisão e a luz vêm do código do jogo. Um bloco de pedra com forma de degrau continua barrando você como um bloco inteiro, e os blocos ao lado continuam escondendo as faces que encostam nele, o que pode deixar buracos por onde dá para ver através.
• Blocos desenhados pelo código: baús, camas, placas, estandartes e outros blocos que o próprio jogo desenha não têm modelo de bloco, então não oferecem Edit shape. Itens desenhados pelo código, como o escudo, podem ganhar um modelo, que substitui essa aparência.

A pedra e alguns outros blocos escolhem ao acaso entre dois modelos: a pedra e uma cópia espelhada, cada uma também girada. Use for every random variant na aba Model coloca a sua forma em todos eles escrevendo o arquivo de estado do bloco. A entrada "y": 180 mantém o giro ao acaso, e weight define com que frequência cada entrada é escolhida:

{
  "variants": {
    "": [
      {
        "model": "minecraft:block/stone",
        "weight": 2
      },
      {
        "model": "minecraft:block/stone",
        "y": 180,
        "weight": 2
      }
    ]
  }
}

Quais arquivos vão para o pack

Todos os caminhos ficam dentro de assets/minecraft/. Todas as versões do Java desde o 1.8 recebem os mesmos arquivos; só o plano no inventário precisa do 1.21.4 ou mais novo. O editor só adiciona uma definição de item ou um estado de bloco quando o jogo precisa, e os arquivos de modelo que já estão em um pack que você abre são mantidos e podem ser editados. Ao exportar, cada modelo é conferido para a sua versão do jogo, e você recebe um aviso sobre tudo o que não carregaria.

O que mudou entre as versões

O editor de modelos segue essas regras para a versão para a qual o seu pack foi feito.

Instalar e testar

1. Toque em Done para sair do editor de modelos e depois exporte o pack com Export como .zip.
2. No Minecraft, abra Opções... > Pacotes de recursos... > Abrir pasta de pacotes, coloque o zip lá (sem descompactar) e mova o pack para Selecionados, acima de outros packs.
3. Segure o item, aperte F5 para a terceira pessoa, jogue o item no chão e coloque em uma moldura para conferir cada exibição.
4. Depois de mudar o modelo, exporte de novo, substitua o zip e aperte F3 + T no jogo para recarregar os packs.

Mais ajuda: Como instalar pacotes de recursos e Texture pack não funciona.

Bedrock Edition

Os packs do Bedrock funcionam de outro jeito, e o editor de modelos só faz modelos do Java:

• Blocos: um pacote de recursos do Bedrock não muda a forma dos blocos do jogo. Um bloco com forma própria é um bloco novo, adicionado por um complemento com um pacote de comportamento e um arquivo de geometria.
• Itens na mão: o Bedrock dá aos itens um modelo 3D na mão com attachables, arquivos de um pacote de recursos que usam geometria e animações do Bedrock. O Texture Pack Maker não cria esses arquivos; o Blockbench cria.
• Um ponto de partida: no menu do editor de modelos, Download as Bedrock geometry salva o seu modelo como um arquivo .geo.json (formato 1.12.0, um osso, todos os cubos) para importar no Blockbench ou em um complemento. A geometria do Bedrock usa uma textura só, então cada face mantém o seu lugar na própria textura.

Em um pack do Bedrock, Edit shape explica isso em vez de abrir o editor. Pintar texturas funciona como sempre.

Problemas comuns

• Faces roxas e pretas: uma face usa uma textura que o jogo não encontra: um nome (#…) que não está em textures, um arquivo que não está nem no jogo nem no pack ou, desde o 1.19.3, uma textura fora das pastas do atlas. A aba Model lista esses problemas com o cubo em que estão.
• Um cubo roxo e preto no lugar do modelo: o arquivo não carregou. As causas comuns são JSON quebrado, um cubo fora de -16 a 32 ou uma rotação que a versão não permite. O log do jogo diz qual é o arquivo.
• O modelo não aparece: confira se o pack está selecionado e acima de outros packs, se o arquivo tem exatamente o nome e a pasta do modelo que substitui e, desde o 1.21.4, se um modelo novo (como uma cópia _3d) tem uma definição de item apontando para ele.
• Bom na mão, estranho no inventário: ajuste a exibição Inventory, teste a outra luz do inventário (de lado ou de frente) ou ative Flat in the inventory.
• Cubos demais: cada cubo adiciona faces para desenhar. Para um item na mão isso quase não pesa, mas um bloco colocado milhares de vezes deve ficar simples. Fique com os cubos juntados pelo 3D item from sprite em vez de separá-los.
• Um ângulo não é permitido: antes do 1.21.6 um cubo gira em passos de 22,5° até 45°, em um eixo. Para um quarto de volta, troque o tamanho do cubo em dois eixos; outras formas, monte com mais cubos.

Mais soluções para packs em geral: Texture pack não funciona? Soluções.

Perguntas frequentes