← All articles

From a Blockbench model to an in-game item: export, pack paths and the hook

Blockbench makes the model; the resource pack decides which item shows it. The model file is the same in every version since 1.13, but how an item is told to use it changed in 1.21.4, so the last step depends on the version you play.

Checked for versions: Java Edition 1.20 to 26.3. Blockbench's Bedrock formats do not work in Java Edition.

In Blockbench

Where the files go

my_pack/
  pack.mcmeta
  assets/cube/
    items/guild_hammer.json          (1.21.4+ only)
    models/item/guild_hammer.json    (exported from Blockbench)
    textures/item/guild_hammer.png

Use your own namespace (here cube) instead of minecraft for new files, so they cannot collide with vanilla assets or with another pack.

Hooking it to an item on 1.21.4 and newer

An item definition in items/ says which model to draw:

{
  "model": {
    "type": "minecraft:model",
    "model": "cube:item/guild_hammer"
  }
}

The item points to that definition with the item_model component, written the same way on 1.21.4 and 1.21.5 – 26.x:

/give @p minecraft:stick[minecraft:item_model="cube:guild_hammer"] 1

One model can serve several states of the same item (charged, broken, faction colors) through select, range_dispatch or condition in the definition; the item model builder writes those files.

Hooking it on 1.21.3 and older

Older versions have no items/ folder. Instead the vanilla item's model gets an override that switches on CustomModelData, in assets/minecraft/models/item/stick.json:

{
  "parent": "minecraft:item/handheld",
  "textures": { "layer0": "minecraft:item/stick" },
  "overrides": [
    { "predicate": { "custom_model_data": 1 }, "model": "cube:item/guild_hammer" }
  ]
}

The command then sets the number, with components on 1.20.5 – 1.21.3 or NBT before that:

/give @p minecraft:stick[minecraft:custom_model_data=1] 1
/give @p minecraft:stick{CustomModelData:1} 1

From 1.21.4 overrides are ignored, which is the most common reason a pack that "worked last year" shows only vanilla items.

When it does not show up

FAQ

Can one model be used by several items?

Yes. Several item definitions, or several overrides, can point to the same model file.

Can the texture be animated?

Yes, with a vertical strip of frames in the PNG and a .png.mcmeta file next to it that sets the frame time.

Which base item should carry the model?

One whose behaviour fits: a stick or a carrot on a stick for props, a sword or an axe for weapons, paper for documents. The model changes only the look.