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…
Locking generated mod 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…
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…
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…
How to Export and Import Shareable Workspaces
What is a shareable workspace? A shareable workspace is a .zip file that allows you to easily share your project with friends or back up your work between releases. Shareable workspaces enable…
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…
Item or block JSON model renders as broken texture
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. To resolve this issue, open your…
How do I make mods for Minecraft 1.12.2?
IMPORTANT NOTE: MCreator 2021.2 and upwards no longer support 1.12.2 at all. Nor native, nor with the plugin. We do not have the means to maintain this plugin for a Minecraft version that old. If you…
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:
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…
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.…
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…
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…