Problemas con modelos

Problemas con modelos 3D que no se renderizan bien dentro del juego.

1. El modelo no aparece (el item sale plano)

Síntoma: el item sale como un sprite plano en 2D en lugar de un modelo 3D.

Causas y soluciones:

• Falta el archivo de modelo: verifica que el archivo .json del modelo está en la carpeta correcta para tu plugin
• custom_model_data equivocado: el valor de CMD de la config del plugin tiene que coincidir con el de la definición del modelo. LK Creator se encarga de esto automáticamente, pero si has editado archivos a mano, revísalo
• Rutas de modelo que no coinciden: la ruta a la que apunta el YAML de config tiene que coincidir exactamente con la ubicación real del archivo

2. El modelo sale como una caja morada y negra

Síntoma: la forma 3D es correcta, pero todas las caras salen en morado y negro (el patrón de textura faltante).

Solución:

• Las referencias de textura del modelo están rotas. Abre el archivo .json del modelo y comprueba que todas las rutas de textura son correctas
• Las rutas de textura del modelo tienen que coincidir con la ubicación real de los archivos en el resource pack
• Ejemplo de una referencia de textura correcta en el modelo:

{
  "textures": {
    "0": "your_namespace/item/your_texture"
  }
}

• Ojo: las referencias de textura no llevan la extensión del archivo (.png)

3. Caras del modelo invertidas o invisibles

Síntoma: algunas caras del modelo son invisibles desde ciertos ángulos.

Solución:

• Es un problema de face culling del renderizador de Minecraft
• En tu editor de modelos (Blockbench), asegúrate de que las normales de las caras apuntan hacia fuera
• Si hace falta, añade la propiedad "shade": false a los elementos
• Para los items que se llevan en la mano, revisa los ajustes de display del JSON del modelo

4. El modelo es demasiado grande o está desplazado

Síntoma: el modelo sale demasiado grande, demasiado pequeño o mal colocado.

Solución:

• Los modelos de Minecraft tienen un límite de tamaño de -16 a 32 en cada eje
• Revisa la sección display del JSON de tu modelo para poner las transformaciones correctas:

{
  "display": {
    "thirdperson_righthand": {
      "rotation": [75, 45, 0],
      "translation": [0, 2.5, 0],
      "scale": [0.375, 0.375, 0.375]
    }
  }
}

• Usa la vista previa de display de Blockbench para ajustar estos valores visualmente

5. Errores de sintaxis en el JSON

Síntoma: el modelo no carga en absoluto; Minecraft muestra un modelo faltante en la pantalla de depuración.

Solución:

• Valida tu archivo JSON. Los problemas más habituales son:
  • Comas sobrantes después del último elemento de un array o un objeto
  • Comillas que faltan alrededor de los nombres de propiedad
  • Corchetes o llaves sin cerrar
• Usa el validador de LK Creator para revisar tus archivos de modelo antes de subirlos
• Los validadores de JSON online también ayudan a localizar errores de sintaxis