Custom Model & Item Component Tools

Build custom_model_data JSON for retextured items, and a model predicate file for the base item override.

Custom Model & Item Component Tools

Build custom_model_data JSON for retextured items, and a model predicate file for the base item override.

Quick guides

How to use this tool, and the questions players ask most.

Custom model data: giving one item many models without replacing anythingThe item-model system replaced the old CustomModelData predicate. Here is the folder layout, the JSON th

How to give item with custom model data in Minecraft?

Use the command /give @p stick[custom_model_data=1] 1 in version 1.20.5 or newer. In older versions prior to 1.20.5, use the NBT syntax /give @p stick{CustomModelData:1} 1.

How does custom model data work in Minecraft 1.21.4?

Minecraft 1.21.4 replaces model predicates with item definition files located in assets/minecraft/items/. These JSON files use the minecraft:custom_model_data select property to map specific integer indices or string identifiers directly to model paths.

Can custom model data change worn armor in Minecraft?

Custom model data changes only the item model held in hand or viewed in inventories, not the worn armor layer on a player entity. Modifying worn armor textures requires custom armor trim assets in assets/minecraft/textures/trims/ or third-party client mods.

Why is custom model data not working in my

resource pack?

Custom model data fails if the integer in your custom_model_data component does not match the predicate threshold or if your pack.mcmeta specifies an incompatible pack_format version. Check the game log for JSON parse errors in your item file.

What is custom model data in Minecraft?

Custom model data is an item component that instructs the game client to render an alternate 3D model or texture based on a numerical tag. The Custom Model & Item Component Tools generate the required override JSON configurations automatically for any base item.