Item or block JSON model renders as broken texture

Section

If you made a custom JSON model and imported in MCreator, but in Minecraft, you see black and purple texture instead, this page can help you resolve this problem.

Example of broken JSON model texture

To resolve this issue, open your JSON model file you imported in MCreator with a text editor or inside MCreator using an integrated code editor. Then check the following:

The model parent model needs to be vanilla

Look for a line that looks like this

"parent": "sometext",

This line's sometext must start with minecraft: to override the Minecraft model as a parent. In most cases, this line is not needed at all and can be omitted.

Example of a ticket from our issue tracker: https://mcreator.net/tracker/issue/50321

You used non-standard rotation angles

Minecraft JSON models can only have a standard set of rotation angles. These are 0, 90, 180, or 270 for block models and 45 through -45 degrees in 22.5 degree increments for item models. More info: https://minecraft.wiki/w/Model

The model uses non-standard texture dimensions

Texture dimensions of the model need to be square with sizes of 16x16, 32x32, ... 256x256, ... 1024x1024 ... If your texture is not square, resize it to make it square and it will be then stretched back down.

Your model contains invalid characters

Model parts, textures, and groups can only contain standard English alphabet characters, numbers, and underscores. All other characters can cause the models to not work properly. More on https://mcreator.net/wiki/minecraft-1144-resourcelocationexception-non-z0-9-character-path-location.



Donate to MCreator

By donating to developers you can speed up development, as with more resources, we can dedicate more time to MCreator. It is a free project made by developers working on it in their free time.