Troubleshooting

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. Through time, server protocols, installation procedures, and many…

Custom OBJ models for blocks and items


MCreator supports custom OBJ models for item and block based mod elements; However, when possible, use JSON models instead. The result will be much better, more stable and better compatible with…

Custom OBJ block or item model has no textures


There are currently many identified causes with this issue. You can try the following by manually debugging. If the model renders as this broken/missing block There is a Missing texture/faulty model …

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…

Coordinates when operating with block procedures are sometimes off


If your procedure does block operations and they execute on wrong positions, eg. place block procedure places a block off for 1 block, this may be caused by using x, y, and z dependencies directly.…

My entity procedure crashes the game


If your procedure crashes the game when the procedure is called in some or all cases, you are probably using one of these procedure blocks (there are other blocks too, the common thing with these…

Many fields are grayed out when making Add-On


You probably came to this page because some elements of the UI are disabled / grayed out as seen in this picture: Explanation This is because add-ons do not support all the features Java mods do. In…

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…

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…

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…

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…

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…

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…

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: