Troubleshooting

Common Blockbench model issues


Block & Item Parent A common issue that people have when making blocks or items is using the "Parent Model" text field. The main use of that text field is to call other settings from other model…

Custom OBJ block or item model has no textures


This is a known issue, there are currently many identified causes. You can try manually debugging and fixing this issue. If the model renders as this broken/missing block Then it is a missing texture…

Custom OBJ models for blocks and items


When possible, use JSON models instead. The result will be much better, more stable and better compatible with Minecraft. OBJ support in Minecraft is not native and is added by Forge. MCreator…

Developing multiplayer compatible mods


MCreator's mods are multiplayer compatible by default, but there are still some things you need to keep your eye on while developing your mods for multiplayer situations. Even single-player gameplay…

Gradle setup and build errors


It can happen that you get gradle errors during the setup of MCreator or even later when suddenly builds stop working. Most of these errors are related to file permissions, firewalls and other OS…

Item or block JSON model renders as broken texture


If you made a custom JSOM model and imported in MCreator, but in Minecraft, you see black and purple texture instead, this page can help you resolve this problem. To resolve this issue, open your…

Locking code


MCreator is a code generator and generates code for you. Sometimes, one needs to manually change the code of elements. This is when a code lock is used. There are some caveats when doing this that…

MCreator release notes


On this page, you can find release notes for some versions of MCreator. You can find downloads of older versions on all downloads page. Through time, server protocols, installation procedures, and…

Minecraft crashes when I open my GUI or when I access slots from procedures


Did you just make your perfect GUI and wanted to test it out in Minecraft. You right click and the game crashes. The crash log usually contains the following lines:

Resolving MCreator being stuck on launch screen


There are some cases when MCreator can get stuck on its loading screen or splash screen. The fixes differ based on the stage on which MCreator was stuck in. Each stage has own section with solutions…

ResourceLocationException: Non [a-z0-9/._-] character in path of location crash


When updating your mod from Minecraft 1.12.2 or earlier to Minecraft 1.14.4 or higher, you might have encountered a crash when trying to launch a game or the game works, but recipes, drops and such…