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 OBJ model button. Select your OBJ model and the MTL material file of the model. If your model has textures, MCreator will ask you for texture mappings too (from 1.8.3 onwards). To use the model for block or item, simply select it as the model when creating the block or item.

OBJ model limitations

As long as the OBJ model follows all the general OBJ model standards, there should be no issues.

MTL material limitations

Only very basic materials are supported. Only basic transparency is supported for the time of writing. It is said that this support is to be improved in the future, but this depends on when Minecraft adds support for this as we use their model loader. If more advanced material is used, they will be reduced to more simple implementation.

UV texture limitations

From MCreator 1.8.3 onwards, support for UV textured OBJ models was introduced.

There are two main limitations:

  1. Textures need to be in PNG file format and need to be square! If the texture you use is not square, just stretch it so its aspect ratio will be 1:1. This will not affect how your model looks as it will be down stretched later, but Minecraft requires square textures.
  2. All textures can be mapped only on the scale from 0 to 1. This means that no vt parameter (UV texture coordinates) in OBJ can be larger than 1 or smaller than 0. You need to consider this when mapping the textures on the model in your OBJ modeler.

Video tutorials

You can find an example on how to make a simple solid color material only OBJ model and use it in MCreator below. Keep in mind that these tutorials were made in older versions of MCreator so the import procedure has changed (see the instructions above).

Minecraft item with custom OBJ model


Minecraft block with custom OBJ model


Donate to MCreator

By donating to developers you can speed up development, as with more resources, we can dedicate more time to MCreator. It is a free project made by developers working on it in their free time.