Pommel - Held Item Models

Мод Pommel - Held Item Models для Minecraft — замена моделей предметов в руках

Pommel — это мод для загрузчика Fabric, который расширяет возможности ресурс-паков, позволяя им заменять 3D-модели предметов, находящихся в руках игрока. Аналогично тому, как это работает для зонта (spyglass) или трезубца (trident), Pommel позволяет создать уникальную анимацию для любого предмета: от боевого топора до магической палочки. Мод добавляет в игру набор новых предикатов (условий), которые срабатывают при различных действиях: удержание предмета, использование, бросок, погружение в воду или размещение в рамке. Это открывает возможности для создания динамических сцен, где модель предмета меняется в зависимости от контекста.

Что такое Pommel?

Pommel — это мод для загрузчика Fabric, который позволяет создателям ресурс-паков заменять 3D-модели предметов, находящихся в руках игрока, аналогично тому, как это работает для подзорной трубы (spyglass) или трезубца (trident). С помощью этого инструмента можно создавать уникальные визуальные эффекты для любого предмета: от огненного двуручного меча до древней магической палочки, сохраняя при этом оригинальную текстуру предмета в инвентаре. Мод поддерживает как ванильные, так и добавленные другими модами предметы.

Расширенный набор предикатов для ресурс-паков

Для разработчиков ресурс-паков Pommel добавляет расширенный набор предикатов, позволяющих создавать сложные сценарии отображения. Ключевые условия включают pommel:is_held (предмет в руке в первом или третьем лице), pommel:is_fixed (предмет в рамке), pommel:is_ground (на земле), pommel:is_thrown (бросаемые предметы), pommel:is_submerged (под водой, работает только с водой), pommel:item_use (длительность использования, например, поедания) и pommel:is_enchanted (предмет с проклятиями). Значение предиката может быть числом: 0.5 меняет модель при переходе в первое лицо, 1.0 — при переходе в третье лицо.

Пример конфигурации JSON для яблока

Мод позволяет настраивать модели в зависимости от фазы действия. В примере ниже показано, как менять модель яблока во время поедания: от начальной стадии до полного потребления, а также как использовать 3D-модели для руки игрока в момент использования.

Интеграция с другими инструментами и модами

Pommel совместим с CIT (Custom Item Textures) и Optifine, если они заменяют текстуры на модели. Мод также поддерживает взаимодействие с модом Eating Animation, позволяя заменять модели во время анимации поедания. Для пользователей мода Arsenal (версия 1.20.1) есть специальный совет: использовать предикат pommel:is_fixed для предметов, размещенных в рамке на спине, чтобы они отображались как 3D-модели, а не как стандартные иконки. Предикаты также работают с custom_model_data ванильного Minecraft, если явно указать pommel:is_held.

Пример использования с custom_model_data

Ниже приведен пример JSON, демонстрирующий совместное использование предикатов Pommel и ванильных условий для создания переходов между разными состояниями предмета.

Особенности работы с сущностями и окружением

Предикаты охватывают широкий спектр ситуаций: предмет может быть надет на голову (pommel:is_head), брошен (pommel:is_thrown) или находиться в руках жители, ведьм, панд и лис (pommel:is_misc_entity_holding). Важно отметить, что если предмет бросается в воду, а затем вода исчезает, предмет сохраняет состояние «погруженности». Мод также меняет модель предмета в интерфейсе (GUI) при использовании или погружении.

Важные оговорки для разработчиков

При создании моделей для сущностей, держащих предметы, стоит учитывать, что они также будут использовать настройки отображения для состояния «на земле» (Ground display). Если необходимо, можно изменить вращение, смещение и масштаб для этих случаев. Файлы с моделями могут располагаться в любых директориях, главное — указать путь в файле JSON модели предмета. Также рекомендуется проверять JSON-код на ошибки перед публикацией ресурс-пака.

Поддержка и сообщество

Автор проекта приглашает создателей ресурс-паков делиться своими работами. Если возникли проблемы с отображением моделей, рекомендуется сначала проверить корректность JSON-кода. Для получения поддержки можно обратиться к автору на Discord (timmychips) или создать Issue на GitHub. Мод распространяется под лицензией MIT, что позволяет свободно использовать его в своих проектах.

Связанные материалы

• Boat Item View — похожий мод
• [ETF] Entity Texture Features — похожий мод
• [EMF] Entity Model Features — похожий мод

Автор: TimmyChips · Лицензия: MIT