Skip to content

Custom Item Models

Custom Item Models Mod powered by Custom Model Data Component

Fabric
Loaders
Fabric
Downloads on Modrinth
6.4K
Followers on Modrinth
21
versions
8
Updated
September 24, 2026Sep 24
Published
in 2025
Also works for Armor · swipe

At a glance

Runs on Fabric
For Minecraft 1.21.4–26.3
Server only — players don't need to install it
Latest version — 1.0.3+26.3 from September 24, 2026
License MIT — free
Where it's needed
In gamenot neededOn serverrequired

Install on the server only; players don't need it

Game versions1.21.4–26.3

Custom Item Models

Setup

This modification is only needed on the server side - clients without this mod will be able to join and use all provided functionality. It also works in singleplayer if installed on client.

Usage

To see compatible ResourcePack examples, navigate into tutorial directory.

Rename Name Tag on the Anvil into the string that you would usually put inside minecraft:custom_model_data={strings:[]} array.

img Diamond before applying Name Tag with the title ruby:

{
    count: 1, 
    Slot: 0b, 
    id: "minecraft:diamond"
}

Then, apply this Name Tag onto the item via Smithing Table.

img Diamond after applying Name Tag with the title ruby:

{
    count: 1, 
    Slot: 0b, 
    id: "minecraft:diamond", 
    components: {
        "minecraft:custom_model_data": {
            strings: ["ruby"]
        }
    }
}

This mod also changes minecraft:equippable component for such items as armor pieces and elytras.

for example, Diamond Helmet before applying Name Tag with the title crown:

{
    count: 1, 
    Slot: 0b, 
    id: "minecraft:diamond_helmet"
}

img and after applying Name Tag with the title crown:

{
    count: 1, 
    Slot: 0b, 
    id: "minecraft:diamond_helmet", 
    components: {
        "minecraft:custom_model_data": {
            strings: ["crown"]
        }, 
        "minecraft:equippable": {
            equip_sound: "minecraft:item.armor.equip_diamond", 
            slot: "head", 
            asset_id: "cim:crown"
        }
    }
}

img

ATTENTION: Be aware that asset_id will always be under cim namespace, due to how vanilla code operates. You can see examples in the tutorial directory.

You don't have to use cim namespace for item models, only for armor rendering.

img

License

This mod is available under the MIT license. Feel free to learn from it and incorporate it in your own projects.

FAQ

How to install Custom Item Models?

Install Fabric for your Minecraft version, download Custom Item Models for the same version and loader, put the file into the mods folder and launch the game with the loader profile.

Which Minecraft versions does Custom Item Models support?

Custom Item Models has builds for Minecraft 1.21.4–26.3.

Is Custom Item Models needed on the server?

Server only — players don't need to install it

License and source
MIT Licensefree to use and share with credit to the author
Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders

The site uses cookies: the necessary ones for sign-in and the theme, plus the Yandex Metrica and LiveInternet visit counters — they show us how the site is used. We have no advertising cookies. More