Armor Model API

Armor Model API - это техническая библиотека для Майнкрафт, которая решает одну из самых старых проблем моддинга: ванильная броня всегда выглядит как плоская текстура, натянутая на игрока. Хочешь сделать шлем с рогами, плащ, юбку или массивные наплечники? В ванилле без костылей это невозможно. Этот мод дает разработчикам простой API, чтобы рендерить полноценные 3D-модели брони в формате .geo.json (Bedrock/GeckoLib), но при этом использовать стандартный пайплайн рендеринга Minecraft.

Скачать Armor Model API стоит в первую очередь тем, кто собирает модпаки с крутой кастомной экипировкой. Это зависимость, которая сама по себе ничего не добавляет в игру, но без неё не заведутся моды на уникальную броню. Проект активно поддерживается под современные версии Minecraft 1.21.x и работает на Fabric и NeoForge.

Что умеет библиотека

• Кастомная геометрия брони для каждого сета: мантии, наплечники, шляпы, юбки - любая модель из Blockbench на основе кубоидов
• По-слотовый рендеринг со стандартной конвенцией костей брони, включая отдельные кости для ботинок и кость талии, привязанную к груди, для поножей
• Отделка брони (armor trims) с текстурами для каждого сета - работает как ванильная ковка на кузнечном столе, но с вашими текстурами
• Светящиеся маски (glowmasks) - конвенция _glowmask.png, пиксели которой остаются яркими в темноте
• Radiant glow - вариант с высокой яркостью, который уходит в белый и цепляется блумом шейдерпаков
• Кастомные слои рендеринга - небольшой интерфейс для добавления собственных проходов (дополнительные оверлеи, эффекты)
• Всё, что умеет ванильная броня, работает из коробки: следование позам и анимациям, приседание и плавание, стойки для брони, детёныши мобов, окраска кожаной брони, блеск зачарования и эффект светящегося контура

Как это работает под капотом

Тут всё сделано грамотно, и это главная фишка проекта. При загрузке ресурсов (и при каждой перезагрузке по F3+T) каждый зарегистрированный .geo.json парсится и запекается один раз в ванильное дерево ModelPart - то же самое TexturedModelData, из которого строятся все ванильные модели сущностей. Результат кешируется до следующей перезагрузки. Текстуры - обычные ресурсы, которые резолвятся слоями рендеринга по требованию, без предобработки.

Когда предмет брони собирается отрендериться, библиотека перехватывает процесс для каждого зарегистрированного предмета: на Fabric через хук ArmorRenderer из Fabric API, на NeoForge - через небольшой эквивалентный миксин. Ванильный оверлей для этого предмета пропускается, а вместо него диспетчер рендерит запечённую модель - с скопированной ванильной позой и видимостью слотов. Незарегистрированные предметы вообще не трогаются.

Каждый предмет рисуется стеком проходов по одной модели: базовая текстура, потом ваши слои рендеринга (свечение, затем отделка, чтобы она легла сверху), а блеск зачарования едет вместе с базовым проходом. Рендереры, собранные через fluent API, автоматически сортируют слои в этот стек. Рендерер с явным списком слоёв рисует их в порядке списка. Каждый дополнительный проход - это просто та же модель, отрендеренная с другим слоем и буфером.

Совместимость и производительность

От запекания до буфера это на 100% ванильный код-путь - та же копия позы, те же слои рендеринга и буферы, что использует ванильная броня. В этом и вся история с совместимостью и производительностью: Sodium, Iris и всё остальное, что работает с ванильной бронёй, видит обычный ванильный рендеринг модели. Никакого кастомного вершинного пайплайна тут нет.

По факту это значит, что FPS не просядет, а конфликтов с оптимизационными модами не будет. Если вы собираете сборку модов с Sodium и Iris - Armor Model API встанет рядом без проблем. Это редкий случай, когда кастомный рендер не ломает ничего вокруг.

Для кого этот мод

Обычному игроку скачивать Armor Model API отдельно смысла нет - это библиотека-зависимость. Ставьте её, если какой-то мод на броню требует её в зависимостях. Разработчикам же это must-have инструмент: вместо того чтобы писать свой рендер-пайплайн с нуля и воевать с совместимостью, вы получаете готовое решение, которое работает через ванильные механизмы и поддерживает всё от светящихся рун до кузнечной отделки.

Проект активно обновляется под свежие версии игры, включая ветку 1.21.x, и ориентирован на современную экосистему Fabric и NeoForge. В актуальных сборках авторы в основном чинят рендеринг и совместимость, чтобы моды корректно показывали броню на новых клиентах без конфликтов. Скачать Armor Model API для Minecraft можно под оба загрузчика - выбирайте версию под свой модпак.