Create your own model using BlockBench - toxicity188/BetterModel GitHub Wiki

Install BlockBench

First, we will use BlockBench model file (.bbmodel) to make a model.
you can download BlockBench here.

Tip

Since we follow BlockBench's modeling, It will be helpful to check how to modeling and animating.

Create your own model project


First, you should generate your model as Generic model.
You can create your own model by using Cube.

Tip

⚠️ Mesh is not supported.
⚠️ If your client version is 1.21.3 or less, cube rotation will be limited. (-45, -22.5, 0, 22.5, 45 degrees with only one axis)
💡 If your client version is 1.21.4 or more, cube with any rotation can be rendered.

Create model bone

Model bone means some group of cube.

  • All elements will be rendered as one item display packet per one model bone.
  • Model bone can be freely rotated.
  • BlockBench supports animating model per each model bone.

Bone tag

There's some built-in bone tag in BetterModel.

  • h_ - This model bone follows base entity's head rotation.
  • hi_ - This model bone and all of children bones follow base entity's head rotation.
  • b_, ob_ or hitbox - This model bone is used to hit box.
  • p_ - This bone can be mounted with hitbox.

External features

Import model

  • Put your model file to BetterModel's plugin folder.
plugins/BetterModel/models - General model
plugins/BetterModel/players - Only for animation without textures
  • Execute reload command.
/bettermodel reload
  • Apply generated resource pack in BetterModel's directory.
plugins/BetterModel/build(.zip)
  • Tests your model to summon as entity.
/bettermodel spawn <model> [entity type] [scale]

Tip

If you're using external resource to merge resource pack, you can check FAQ in here.

5

Next docs

⚠️ **GitHub.com Fallback** ⚠️