Armor Model API

API модели брони

Рендерит броню с собственной геометрией, созданной в формате Bedrock/GeckoLib .geo.json, через ванильный конвейер рендеринга брони.

Возможности

• Пользовательская геометрия брони для каждого комплекта брони: мантии, наплечники, шляпы, юбки — любая модель Blockbench на основе кубоида.
• Рендеринг каждого слота со стандартным соглашением о костях брони, включая отдельные кости ботинок и прикрепленную к груди кость талии для частей ног.
• Отделки брони с заданными текстурами отделки (ванильная отделка кузнечного стола, ваше искусство)
• Эмиссивные светящиеся маски — созданная вручную конвенция _glowmask.png; пиксели, которые остаются яркими в темноте
• Сияющее свечение — вариант с высокой яркостью, который горит до белого цвета и подпитывает цветение пакета шейдеров.
• Пользовательские слои рендеринга — небольшой интерфейс для добавления собственных проходов (дополнительные наложения, эффекты).
• Все, что делает ванильная броня, предоставляется бесплатно: поза и анимация следования, подкрадывание/плавание, подставки для брони, детские мобы, цвет окрашенной кожи, зачарованный блеск, эффект светящегося контура.

Как это работает

• Загрузка — при загрузке ресурса (и при каждой перезагрузке F3+T) каждый зарегистрированный .geo.json анализируется и запекается один раз в ванильное дерево ModelPart (тот же самый TexturedModelData, из которого построена каждая ванильная модель сущности), кэшируется до следующей перезагрузки. Текстуры — это простые ресурсы, которые обрабатываются слоями рендеринга по требованию — ничего не подвергается предварительной обработке.
• Подключение — когда часть брони готовится к рендерингу, библиотека вмешивается для каждого зарегистрированного элемента: в Fabric через перехватчик ArmorRenderer API Fabric, в NeoForge через небольшой эквивалентный миксин. Рендеринг наложения Vanilla для этой части пропускается, и вместо этого диспетчер визуализирует запеченную модель — скопированную ванильную позу, примененную видимость слотов. Незарегистрированные элементы остаются нетронутыми.
• Порядок проходов — каждая часть рисуется как набор проходов по одной и той же модели: базовая текстура → слои рендеринга (свечение, затем обрезка так, чтобы она оказалась сверху), с волшебным блеском на базовом проходе. Рендереры, созданные с помощью Fluent API, автоматически сортируют слои в этот стек; средство рендеринга, созданное с использованием явного списка слоев, рисует их в порядке списка (см. Рендеринг слоев). Каждый дополнительный проход — это просто повторная визуализация модели с другим слоем и буфером рендеринга.

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

Для разработчиков

Документацию для разработчиков можно найти в файле readme на GitHub.