Armor Model API

Мод Armor Model API для Minecraft — библиотека для рендеринга кастомной брони

Armor Model API — это библиотека, которая позволяет отображать броню с пользовательской геометрией, созданной в формате Bedrock или GeckoLib (.geo.json), используя стандартный пайплайн рендеринга брони Minecraft. Мод не требует кастомных шейдеров для базовой работы, интегрируясь с существующими системами оптимизации, такими как Sodium и Iris, так как использует нативные пути рендеринга игры.

Как работает рендеринг кастомной брони

Мод перехватывает процесс отрисовки брони на уровне рендер-слоев. Когда игрок надевает предмет, библиотека проверяет, зарегистрирован ли он. Если да, вместо стандартной модели из игры, в слот брони подставляется скомпилированная модель из .geo.json файла. Это позволяет использовать любые кубические модели из Blockbench: плащи (robes), наплечники (pauldrons), шляпы (hats) и юбки (skirts).

Возможности и эффекты

Помимо базовой геометрии, мод поддерживает сложные визуальные эффекты. Можно настроить emissive glowmasks (светящиеся маски), используя стандартную конвенцию _glowmask.png, где пиксели остаются яркими в темноте. Также доступна функция radiant glow — более интенсивное свечение, которое приближается к белому цвету и питает bloom-эффекты в пакетных шейдерах. Все стандартные функции брони, такие как следование позе игрока, анимация ходьбы, позы на коленях, плавания, работа с манекенами, окрашивание кожи и блеск энтчментов, работают автоматически и бесплатно.

Техническая реализация для разработчиков

Для разработчиков модов Armor Model API предоставляет удобный интерфейс для добавления собственных рендер-слоев. Можно создать слои для эффектов, накладываемых поверх основной текстуры, или для дополнительных наложений. Порядок отрисовки строго соблюдается: сначала базовая текстура, затем пользовательские слои (свечение, затем тримы), и в конце — блеск энтчментов. Мод использует нативные буферы и позы игры, что обеспечивает полную совместимость с оптимизированными клиентами вроде Sodium и Iris. Вся логика выполняется через стандартные хуки Fabric API или миксины NeoForge, не создавая собственного пайплайна вершин.

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

• Curios API — похожий мод
• Trinkets — похожий мод
• Ranged Weapon API — похожий мод
• Bundle API — похожий мод

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