Custom Item Models

Позволяет использовать массивы строк в параметре minecraft:custom_model_data для настройки визуальных моделей предметов и брони.

Мод расширяет функционал стандартного компонента minecraft:custom_model_data, позволяя использовать массивы строк вместо одиночных значений. Это открывает новые возможности для декорации и создания уникальных визуальных эффектов для предметов, не создавая при этом новые ID сущностей или предметов.

Для применения кастомной модели необходимо использовать Наковальню и предмет с тегом minecraft:custom_model_data={strings:[]}. В качестве названия тега (Name Tag) на наковальне нужно указать строку, которую вы хотите использовать в массиве.

Пример настройки для алмаза, который должен превратиться в «рубин»:

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

После применения тега с названием ruby через стол работы кузнечества предмет получит следующий компонент:

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

Мод также модифицирует компонент minecraft:equippable для элементов брони и элитр. Это позволяет изменять звуки экипировки, слоты и идентификаторы ресурсов.

Пример применения тега crown к алмазному шлему:

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

Результат после применения тега:

{
    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"
        }
    }
}

⚠️ Важное примечание: из-за особенностей ванильного кода идентификатор asset_id всегда должен находиться в пространстве имен cim. Однако для обычных моделей предметов (не брони) использование пространства имен cim не является обязательным.

Для использования мода достаточно установить его на стороне сервера. Клиентам модификация не требуется: игроки без мода смогут заходить на сервер и использовать все функциональные возможности. В одиночной игре мод должен быть установлен на клиенте.

Для ознакомления с примерами совместимых ресурспаков можно перейти в папку tutorial в файлах проекта.

Требования проверенного файла

• По манифесту для файла cim-1.0.3+26.3.jar (Minecraft 26.3; Fabric) требуется fabric-api. Встроенных JAR-библиотек в проверенном файле нет.