Armor Model API
通过原版盔甲渲染管线,使用在 Bedrock/GeckoLib .geo.json 格式中编写的自定义几何结构来渲染盔甲。

功能特性
- 每套盔甲的自定义几何结构:长袍、护肩、帽子、裙摆——任何基于方块(cuboid)的 Blockbench 模型均可支持
- 按槽位渲染:遵循标准盔甲骨骼约定,包括独立的靴子骨骼以及用于腿部装备的以胸部为锚点的腰部骨骼
- 盔甲纹饰:支持每套盔甲不同的纹饰纹理(原版铁砧锻造台纹饰,或你自己的艺术创作)
- 自发光遮罩:采用手动制作的
_glowmask.png惯例;在黑暗中保持明亮的像素将产生发光效果 - 辉光渲染:一种高亮度变体,颜色趋向白色并能为光影包提供泛光(bloom)效果
- 自定义渲染层:提供一个小接口,允许添加您自己的渲染通道(额外叠加层、特效等)
- 原版盔甲的所有功能均自动获得:姿势与动画跟随、潜行/游泳状态、盔甲架显示、幼年生物、染色皮革颜色、附魔闪烁以及发光轮廓效果
工作原理
- 加载——在资源加载时(以及每次 F3+T 重载时),每个已注册的
.geo.json都会被解析并烘焙一次,生成一个原版的ModelPart树(与所有原版实体模型构建所用的TexturedModelData相同),并缓存直到下次重载。纹理是普通资源,由渲染层按需解析——无需预处理。 - 接入方式——当某个盔甲部件即将渲染时,该库会对每个已注册的项目介入:在 Fabric 上通过 Fabric API 的
ArmorRenderer钩子实现,在 NeoForge 上则通过一个小型等效 mixin 实现。对于该部件,原版叠加层渲染将被跳过,调度器会改为渲染烘焙好的模型——同时复制原版的姿势并应用槽位可见性。未注册的项目不受影响。 - 渲染顺序——每个部件作为一系列叠加在相同模型上的渲染层进行绘制:基础纹理 → 您的自定义渲染层(先发光,后纹饰以确保纹饰位于顶层),附魔闪烁跟随基础层一起渲染。通过流畅 API 构建的渲染器会自动将这些层排序到该堆栈中;而通过显式层列表构造的渲染器则按列表顺序绘制它们(参见 Render layers)。每一个额外的渲染层本质上都是使用不同的渲染层和缓冲区再次渲染该模型。
从烘焙到缓冲区,这完全走的是原版代码路径——使用与原版盔甲相同的姿势复制、渲染层和缓冲区。这也是其兼容性和性能优势的核心所在:Sodium、Iris 以及其他任何与原版盔甲兼容的模组都能正常处理普通的原版模型渲染。这里没有自定义顶点管线。
面向开发者
如需开发者文档,请查阅 GitHub README。
你是这个资源的作者?登录后可认领此资源。
相似资源
鞘翅纹饰Elytra Trims
KikuGie
可定制的鞘翅模组,支持装饰纹饰、旗帜图案等更多功能!
装饰装备
477
Woot Revived
pharuxtan
一个用于收集生物掉落物的多区块模组。
生物科技
349
玉Jade ?
Snownee
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
实用前置
339
KubeJS
Lat
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
前置实用
239
物品管理器Just Enough Items (JEI)
mezz
查看物品与配方
前置实用
239
AAA Particles
ChloePrime
适用于 MC 1.18+ 的 Effekseer 加载器
前置装饰
186
评论 0
登录后参与评分
还没有评论,来抢沙发吧