Custom model data generator

Drop your item textures (PNG) or models (JSON), pick the item they hang on, and get the files in the right folders plus the /give commands. Nothing is uploaded.

Version Item Namespace Pick by

Normal look Held like a tool

Or drop the files anywhere on the page. One row per custom look.

Number	Name	Kind	Notes

How custom model data works

One Minecraft item, for example paper, can show many different looks. Each look gets a number (or, from 1.21.4, a name). The resource pack says which model belongs to which number, and the item carries the number. Players without the pack see plain paper.

Drop your textures or models here, pick the item and the version, download the zip.
Unzip it into your resource pack so that assets lands next to pack.mcmeta. No pack yet? The pack.mcmeta generator makes an empty one.
Reload with F3+T and run one of the /give commands.

What changed in 1.21.4

1.21.4 and newer: the game reads assets/minecraft/items/<item>.json. Numbers go through range_dispatch, names through select. The item carries custom_model_data={floats:[1]} or {strings:["ruby"]}.
1.20.5 to 1.21.3: the old overrides list in assets/minecraft/models/item/<item>.json, and the item carries custom_model_data=1.
1.14 to 1.20.4: the same overrides file, and the item carries the tag {CustomModelData:1}.

A pack for both sides of 1.21.4 needs both files. Make the zip twice, once per version, and unzip both into the pack.

If the item shows the purple and black cube

Names: files and folders must be lower case, with only letters, digits, underscore, dash and dot. This page renames what you drop.
Normal look: it must be the model the item has without a pack. For most items that is minecraft:item/<item>, for a block it is minecraft:block/<block>. This page knows every item of the game and fills it in. Items with a special look (bow, crossbow, shield, trident, compass, clock, potions, armor with trims, bundles, beds, banners) have a longer file in the game; with this page they lose that special look, and the page warns you. Hang custom looks on a simple item such as paper.
Your own model: the textures named inside the model file must exist in the pack under the same namespace and path.
Numbers: an item with number 5 shows the look with the highest number that is not above 5. A number without its own look therefore shows the one below it.

Something wrong or missing here? Tell me, requests decide what I add next. More tools: all tools.