Troubleshooting

Custom OBJ models for blocks and items


MCreator supports custom OBJ models for item and block based mod elements. Importing OBJ model Go to Workspace tab, in Resouces sub tab and select 3D models and texture mappings section. Click import…

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. Testing server first If you…

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…

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


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…

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:

My 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…

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…