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…

Common Blockbench model issues


Wrong Export Version A common issue is when an entity model is not for the same version of Minecraft as your modification. Many problems can be caused by using the wrong version. It's also a good…

Custom OBJ block or item model has no textures


OBJ models do not offer native compatibility with Minecraft, when possible, use JSON models instead. Texture Issues with .OBJ models If the model renders as a missing texture block The texture is…

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 as they offer better compatibility with Minecraft. OBJ support in Minecraft…

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…

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: