Pommel - Held Item Models

Pommel - Held Item Models - это Fabric мод для Майнкрафт, который даёт создателям текстурпаков возможность менять модель предмета, когда он находится в руке игрока. Раньше такая фишка была доступна только для подзорной трубы и трезубца - теперь можно сделать 3D-модель для любого предмета, от яблока до зачарованного меча.

Зачем это нужно? В ванильном Minecraft все предметы в руке выглядят как плоские спрайты (ну, почти все). Pommel исправляет это: хочешь сделать булаву объёмной, огненный двуручник или магический посох - пожалуйста. При этом сам предмет в инвентаре, на земле или в рамке остаётся стандартным. Работает и с модовыми предметами.

Для создателей текстурпаков (ресурспаков)

Мод добавляет несколько новых предикатов (item predicates), которые можно использовать в JSON-моделях:

• pommel:is_held - когда предмет в руке (от первого или третьего лица)
• pommel:first_third_person - различает первое и третье лицо: значение 0.5 для первого лица, 1.0 - для третьего
• pommel:is_offhand - предмет в левой руке
• pommel:is_fixed - предмет в рамке
• pommel:is_head - предмет на голове (в шлеме)
• pommel:is_ground - предмет на земле (выброшен)
• pommel:is_thrown - брошенный предмет (яйцо, снежок, жемчуг и т.д.)
• pommel:is_used - предмет используется (зажата ПКМ); работает в мультиплеере, если мод стоит на сервере и у игроков
• pommel:item_use - длительность использования предмета (например, сколько времени еда уже жуется)
• pommel:is_submerged - предмет погружён в minecraft:water (с другими жидкостями не работает). Важно: если убрать воду, предмет остаётся в "мокром" состоянии
• pommel:is_enchanted - предмет зачарован
• pommel:is_misc_entity_holding - предмет в руках у жителей, ведьм, панд и лис; для этих мобов также применяются настройки Ground display, так что при необходимости меняй поворот/масштаб для них

Пример JSON для кирки

{
  "parent": "item/handheld",
  "textures": {
    "layer0": "minecraft:item/2d_model_texture"
  },
  "overrides": [
    { "predicate": { "pommel:is_held": 1.0 }, "model": "minecraft:item/my_held_item" },
    { "predicate": { "pommel:is_fixed": 1.0 }, "model": "minecraft:item/my_framed_item" },
    { "predicate": { "pommel:is_head": 1.0 }, "model": "minecraft:item/my_worn_item" },
    { "predicate": { "pommel:is_ground": 1.0 }, "model": "minecraft:item/my_ground_item" }
  ]
}

Сами модели и текстуры могут лежать где угодно - главное, чтобы путь был указан в JSON.

Пример с яблоком (поедание)

{
  "parent": "minecraft:item/generated",
  "textures": {
    "layer0": "minecraft:item/apple"
  },
  "overrides": [
    { "predicate": { "pommel:is_held": 1 }, "model": "minecraft:item/held_items/apple_3d" },
    { "predicate": { "pommel:item_use": 0.25 }, "model": "minecraft:item/apple_eat_0" },
    { "predicate": { "pommel:is_held": 1, "pommel:item_use": 0.25 }, "model": "minecraft:item/held_items/apple_eat_0_3d" },
    { "predicate": { "pommel:item_use": 0.50 }, "model": "minecraft:item/apple_eat_1" },
    { "predicate": { "pommel:is_held": 1, "pommel:item_use": 0.50 }, "model": "minecraft:item/held_items/apple_eat_1_3d" },
    { "predicate": { "pommel:item_use": 0.75 }, "model": "minecraft:item/apple_eat_2" },
    { "predicate": { "pommel:is_held": 1, "pommel:item_use": 0.75 }, "model": "minecraft:item/held_items/apple_eat_2_3d" }
  ]
}

Здесь яблоко меняет модель в руке на 3D-версию, а при поедании - показывает соответствующий шаг (надкусанное).

Совместимость с другими модами

• CIT (Custom Item Textures): работает, если CIT заменяет модель предмета (не текстуру). При замене модели - всё ок.
• Ванильные предикаты (custom_model_data, натяжение лука): комбинируй с pommel:is_held - просто добавь его в override.
• Eating Animation: совместим, но можно обойтись и без него, используя pommel:item_use - тот же эффект, без проблем с CIT.
• Arsenal (только 1.20.1): использует is_fixed для отображения предметов на спине - можно заменить модель, но имей в виду, что рамки тоже подхватят эту модель.

Важно знать

• Если не уверены в JSON - проверяйте через любую IDE или онлайн-валидатор. Ошибки в синтаксисе - самая частая проблема.
• Для модовых предметов в JSON вместо minecraft пишите mod_id.
• Мод работает на Fabric для последних версий Minecraft (1.20-1.21). На сервере мод не обязателен, но без него некоторые предикаты (is_used) не синхронизируются.

Скачайте Pommel и делайте предметы объёмными - кирки, мечи, зелья, да хоть тыкву на голове превратите в изумруд. Текстурпакеры оценят гибкость, игроки - красоту.