Cómo hacer ítems 3D y modelos propios en un texture pack de Minecraft

Qué es un modelo de Minecraft

Java Edition 1.8 y posteriores dibujan la mayoría de bloques e ítems a partir de archivos de modelo del paquete de recursos:

• assets/minecraft/models/block/ guarda los modelos de bloque, como oak_slab.json. Un archivo de estado de bloque en blockstates/ indica qué modelo usa un bloque en cada estado: una losa abajo o arriba, un tronco tumbado.
• assets/minecraft/models/item/ guarda los modelos de ítem. La mayoría de ítems usan un modelo plano (item/generated): el juego convierte por sí solo el sprite de 16×16 en una forma fina. Desde la 1.21.4, una definición de ítem en assets/minecraft/items/ indica qué modelo muestra un ítem.

Un archivo de modelo tiene cuatro partes principales:

• textures: nombres para las texturas que usa el modelo, como "oak_planks": "minecraft:block/oak_planks". particle es la textura de las partículas al romperlo.
• elements: los cubos. Cada uno va de una esquina (from) a la opuesta (to), medido en píxeles de un bloque de 16 × 16 × 16, y puede llegar de -16 a 32 en cada eje. Con rotation se gira un cubo.
• faces: para cada lado de un cubo (down, up, north, south, west, east), la textura que muestra, la parte de la textura (uv) y cullface, que omite la cara cuando un bloque completo tapa ese lado.
• display: cómo se gira, se mueve y se escala el modelo en el inventario (gui), en las manos, en el suelo, en un marco (fixed) y en la cabeza.

Este es un modelo de un solo cubo con forma de losa, ordenado como lo escribe el editor de modelos. Un archivo hecho en el editor incluye la vista de todos los lugares, no solo la del inventario:

{
  "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]
    }
  }
}

Los modelos hechos a mano suelen usar "parent" para tomar las texturas, los cubos o la vista de otro modelo. El editor de modelos escribe archivos completos: todo lo que leyó de los modelos padre va copiado dentro, así que tu archivo no depende de ningún otro.

Hacer un ítem 3D paso a paso

1. Abre el Texture Pack Maker y crea un pack de Java para la versión a la que juegas: 1.8 o posterior, o 1.21.4 o posterior si quieres que el ítem siga plano en el inventario.
2. Cambia la lista a Items y abre el ítem, por ejemplo la espada de diamante. En la pestaña Preview, pulsa Edit shape.
3. Elige 3D item from sprite. Cada píxel de la imagen plana pasa a formar parte de un cubo de 1 píxel de grosor.
4. Cambia la forma: haz clic en un cubo en la vista 3D o en la lista y muévelo, cambia su tamaño, cópialo o añade otros nuevos. En Faces, da a una cara otra textura u otra parte de una.
5. Abre Display y revisa el modelo en el inventario, en primera y tercera persona, en el suelo, en un marco y en la cabeza. Cambia el giro, la posición o el tamaño donde no se vea bien.
6. Opcional, desde la 1.21.4: en la pestaña Model, activa Flat in the inventory para mantener ahí el icono plano y mostrar el modelo 3D en la mano.
7. Pulsa Done, exporta el pack como .zip, ponlo en tu carpeta resourcepacks y pruébalo en el juego.

Cómo funciona «3D item from sprite»

Un ítem plano es una sola imagen, su sprite, normalmente de 16×16 píxeles. Este punto de partida toma cada píxel que no es transparente y construye con ellos cubos de 1 píxel de grosor, centrados como los ítems planos del juego (de 7,5 a 8,5 en el eje Z). Los píxeles seguidos de una fila se unen en un cubo largo, y las filas iguales una debajo de otra en un rectángulo, así que la espada de diamante queda en 19 cubos en lugar de un cubo por píxel. Las caras que un píxel vecino tapa por completo se omiten.

Cada cara muestra los píxeles correspondientes del sprite. Tres píxeles seguidos, en las columnas 5 a 7 de la fila 3, dan 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
    }
  }
}

La cara de delante (south) muestra los píxeles tal cual y la de atrás (north) reflejados, como se ve un dibujo por detrás. Los cubos siguen usando la textura del propio ítem (#layer0), así que si repintas el sprite, el ítem 3D cambia de color. Los píxeles que añades o borras solo cambian la forma cuando vuelves a elegir 3D item from sprite. Los ítems de varias capas, como las pociones o la armadura de cuero, reciben cubos para cada capa, y el juego los sigue tiñendo.

Después, hazlo tuyo:

• Haz la hoja más gruesa: selecciona sus cubos y cambia su posición y tamaño en Z, por ejemplo de 7,5 y 1 a 7 y 2.
• Añade un cubo para la guarda o una gema con el botón + (o N) y da a sus caras otra textura en Faces > Change.
• Gira un cubo en Rotation. Antes de Minecraft 1.21.6 un cubo solo gira sobre un eje, -45°, -22,5°, 0°, 22,5° o 45°; el editor ofrece lo que acepta tu versión.
• Deshaz cualquier cambio con Ctrl+Z.

Cómo se sostiene: Display

La pestaña Display muestra el modelo en seis lugares. Cada uno tiene un giro en grados, una posición en píxeles (hasta ±80) y un tamaño (1 es normal, 4 como máximo).

3D item from sprite conserva la vista del propio ítem, así que una espada 3D se sostiene como la plana. Game’s default devuelve un lugar a los valores del juego, y No change quita el ajuste. Java 1.21.9 añadió el lugar on_shelf para las estanterías; el editor conserva el valor del modelo del juego.

Mantener el icono plano en el inventario (1.21.4+)

Muchos packs 3D mantienen el icono plano de siempre en el inventario y muestran el modelo 3D solo en la mano. Desde Java 1.21.4, una definición de ítem puede elegir el modelo según dónde se muestra el ítem. Activa Flat in the inventory en la pestaña Model y el editor:

• guarda tu forma como un segundo modelo, models/item/diamond_sword_3d.json, y deja el diamond_sword.json plano como está;
• escribe items/diamond_sword.json, que muestra el modelo plano en el inventario (gui), en el suelo y en los marcos (fixed), y el 3D en todo lo demás:

{
  "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"
    }
  }
}

Las versiones anteriores a la 1.21.4 no tienen definiciones de ítem, así que un ítem muestra el mismo modelo en todas partes y la opción no aparece.

Cambiar la forma de un bloque

Con los bloques es igual. Muestra un bloque en la pestaña Preview y pulsa Edit shape. El editor abre el modelo que usa el bloque en el estado que estás viendo, y el menú de arriba lista sus otros modelos, como la losa de arriba y la doble. Quédate con el modelo del juego o empieza desde Full cube, Slab, Cross (plant) o Empty, y después añade, mueve y cambia el tamaño de los cubos. Para convertir la piedra en un escalón basta el punto de partida Slab y un cubo más:

• Modelos compartidos: algunos bloques usan el mismo archivo de modelo. Si otro bloque usa el modelo que editas, el editor te dice cuál; también cambia.
• Los ítems van aparte: un ítem que muestra un modelo de bloque, como una losa en la mano, recibe su propio modelo de ítem cuando editas el ítem, así que el bloque conserva su forma.
• Solo cambia el aspecto: la caja de colisión, el choque y la luz salen del código del juego. Un bloque de piedra con forma de escalón te sigue frenando como un bloque completo, y los bloques de al lado siguen ocultando las caras que lo tocan, lo que puede dejar huecos por los que se ve a través.
• Bloques que dibuja el código: los cofres, camas, carteles, estandartes y otros bloques que dibuja el propio juego no tienen modelo de bloque, así que no ofrecen Edit shape. Los ítems que dibuja el código, como el escudo, sí pueden recibir un modelo, que sustituye ese aspecto.

La piedra y algunos otros bloques eligen al azar entre dos modelos: la piedra y una copia reflejada, cada una también girada. Use for every random variant en la pestaña Model pone tu forma en todos ellos escribiendo el archivo de estado del bloque. La entrada "y": 180 mantiene el giro al azar, y weight indica con qué frecuencia se elige cada entrada:

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

Qué archivos van en el pack

Todas las rutas están dentro de assets/minecraft/. Todas las versiones de Java desde la 1.8 reciben los mismos archivos; solo lo de plano en el inventario necesita la 1.21.4 o posterior. El editor solo añade una definición de ítem o un estado de bloque cuando el juego lo necesita, y los archivos de modelo que ya hay en un pack que abres se conservan y se pueden editar. Al exportar, cada modelo se revisa para tu versión del juego y recibes un aviso de todo lo que no cargaría.

Qué cambió entre versiones

El editor de modelos sigue estas reglas para la versión para la que está hecho tu pack.

Instalarlo y probarlo

1. Pulsa Done para salir del editor de modelos y luego exporta el pack con Export como .zip.
2. En Minecraft abre Opciones... > Paquetes de recursos... > Abrir carpeta de paquetes, suelta ahí el zip (sin descomprimir) y mueve el pack a Seleccionados, por encima de otros packs.
3. Sostén el ítem, pulsa F5 para la tercera persona, tíralo al suelo y ponlo en un marco para revisar cada vista.
4. Después de cambiar el modelo, exporta de nuevo, sustituye el zip y pulsa F3 + T en el juego para recargar los packs.

Más ayuda: Cómo instalar paquetes de recursos y El texture pack no funciona.

Bedrock Edition

Los packs de Bedrock funcionan de otra manera, y el editor de modelos solo hace modelos de Java:

• Bloques: un paquete de recursos de Bedrock no puede cambiar la forma de los bloques del juego. Un bloque con forma propia es un bloque nuevo, añadido por un complemento con un paquete de comportamiento y un archivo de geometría.
• Ítems en la mano: Bedrock da a los ítems un modelo 3D en la mano con attachables, archivos de un paquete de recursos que usan geometría y animaciones de Bedrock. El Texture Pack Maker no los crea; Blockbench sí.
• Un punto de partida: en el menú del editor de modelos, Download as Bedrock geometry guarda tu modelo como un archivo .geo.json (formato 1.12.0, un hueso, todos los cubos) para importarlo en Blockbench o en un complemento. La geometría de Bedrock usa una sola textura, así que cada cara conserva su sitio en su propia textura.

En un pack de Bedrock, Edit shape explica esto en lugar de abrir el editor. Pintar texturas funciona como siempre.

Problemas frecuentes

• Caras moradas y negras: una cara usa una textura que el juego no encuentra: un nombre (#…) que no está en textures, un archivo que no está ni en el juego ni en el pack, o, desde la 1.19.3, una textura fuera de las carpetas del atlas. La pestaña Model lista estos problemas con el cubo en el que están.
• Un cubo morado y negro en lugar del modelo: el archivo no se cargó. Las causas habituales son un JSON roto, un cubo fuera de -16 a 32 o un giro que la versión no permite. El registro del juego nombra el archivo.
• El modelo no aparece: comprueba que el pack está seleccionado y por encima de otros packs, que el archivo tiene exactamente el nombre y la carpeta del modelo que sustituye y, desde la 1.21.4, que un modelo nuevo (como una copia _3d) tiene una definición de ítem que lo usa.
• Bien en la mano, raro en el inventario: ajusta la vista Inventory, prueba la otra luz del inventario (de lado o de frente) o activa Flat in the inventory.
• Demasiados cubos: cada cubo añade caras que dibujar. Para un ítem en la mano apenas importa, pero un bloque colocado miles de veces debe ser sencillo. Quédate con los cubos unidos que crea 3D item from sprite en lugar de dividirlos.
• Un ángulo no está permitido: antes de la 1.21.6 un cubo gira en pasos de 22,5° hasta 45°, sobre un eje. Para un cuarto de vuelta, intercambia el tamaño del cubo en dos ejes; otras formas, constrúyelas con más cubos.

Más soluciones para packs en general: ¿El texture pack no funciona? Soluciones.

Preguntas frecuentes