Pommel - Held Item Models

Pommel представляет собой мод для Fabric, который открывает перед создателями ресурспаков возможность заменять модели предметов, когда они находятся в руке персонажа. Подобно тому, как в стандартной игре отображаются подзорная труба и трезубец, теперь вы можете настроить внешний вид любого предмета в руках игрока.

Мечтаете о трёхмерной булаве, пылающем двуручном мече или древнем магическом посохе, сохраняя при этом оригинальный предмет в инвентаре? С Pommel всё это становится реальностью! Мод также полностью совместим с предметами из других модификаций.

Для разработчиков ресурспаков

Мод добавляет следующие предикаты предметов:

• 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 — предметы в руках деревенских жителей, ведьм, панд и лис

Предикаты is_using и is_submerged также изменяют модель предмета в интерфейсе.

Пример 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" }
  ]
}

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

{
  "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/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/apple_eat_2_3d" }
  ]
}

В этом примере яблоко будет последовательно менять модели от apple_eat_0 до apple_eat_2 во время поедания. При удержании в руке активируется трёхмерная версия с уникальными моделями для каждого этапа употребления.

Дополнительные возможности

Вы можете организовывать модели в отдельные папки и изменять родительские модели для лучшей структуризации.

Часто задаваемые вопросы

Совместимость с CIT

CIT Resewn и Optifine работают корректно при условии, что CIT заменяет модель предмета, а не только текстуру.

Совместимость с ванильными предикатами

Pommel полностью совместим с ванильными предикатами, такими как Custom Model Data и bow Pulling. Не забудьте указать pommel:is_held для моделей с custom_model_data.

Совместимость с модом Eating Animation

Eating Animation позволяет заменять модели при поедании предметов с использованием предикатов Pommel. Также вы можете использовать pommel:item_use для аналогичного эффекта без необходимости установки дополнительных модов.

Работа с предметами из других модов

Используйте ту же структуру JSON, заменив minecraft на идентификатор соответствующего мода.

Решение проблем

Проверьте JSON-код на наличие ошибок. Большинство сред разработки автоматически обнаруживают синтаксические ошибки. Для сложных случаев обратитесь к сообществу разработчиков.