Skip to Content
TroubleshootingModel Issues

Model Issues

Problems with 3D models not rendering correctly in-game.

1. Model Not Showing (Item Appears Flat)

Symptom: The item appears as a flat 2D sprite instead of a 3D model.

Causes & Solutions:

  • Missing model file: Verify the .json model file exists in the correct directory for your plugin
  • Wrong custom_model_data: The CMD value in the plugin config must match the one in the model definition. LK Creator handles this automatically, but if you edited files manually, double-check
  • Model path mismatch: The path referenced in the config YAML must exactly match the actual file location

2. Model Shows as Purple/Black Box

Symptom: The 3D shape is correct but all faces are purple and black (missing texture pattern).

Solution:

  • The model’s texture references are broken. Open the .json model file and check that all texture paths are correct
  • Texture paths in the model must match the actual file locations in the resource pack
  • Example of a correct texture reference in the model:
{
  "textures": {
    "0": "your_namespace/item/your_texture"
  }
}
  • Note: texture references do not include the file extension (.png)

3. Model Faces Inverted or Invisible

Symptom: Some faces of the model are invisible from certain angles.

Solution:

  • This is a face culling issue in Minecraft’s renderer
  • In your model editor (Blockbench), ensure face normals are pointing outward
  • Add the "shade": false property to elements if needed
  • For items held in hand, check the display settings in the model JSON

4. Model Too Large or Offset

Symptom: The model appears too big, too small, or positioned incorrectly.

Solution:

  • Minecraft models have a size limit of -16 to 32 on each axis
  • Check the display section in your model JSON for the correct transformations:
{
  "display": {
    "thirdperson_righthand": {
      "rotation": [75, 45, 0],
      "translation": [0, 2.5, 0],
      "scale": [0.375, 0.375, 0.375]
    }
  }
}
  • Use Blockbench’s display preview to adjust these values visually

5. JSON Syntax Errors

Symptom: Model doesn’t load at all; Minecraft shows a missing model in the debug screen.

Solution:

  • Validate your JSON file — common issues include:
    • Trailing commas after the last element in arrays/objects
    • Missing quotes around property names
    • Unmatched brackets or braces
  • Use the LK Creator Validator to check your model files before uploading
  • Online JSON validators can also help identify syntax errors
Texture ProblemsGeneration Errors