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。
Armor Model API
Renders armor with custom geometry authored in the Bedrock/GeckoLib .geo.json format, through the vanilla armor rendering pipeline.

Capabilities
- Custom armor geometry per armor set: robes, pauldrons, hats, skirts — any cuboid-based Blockbench model
- Per-slot rendering with the standard armor bone convention, including separate boot bones and a chest-anchored waist bone for leg pieces
- Armor trims with per-set trim textures (vanilla smithing-table trims, your art)
- Emissive glowmasks — the hand-authored
_glowmask.pngconvention; pixels that stay bright in the dark - Radiant glow — a high-luminance variant that burns toward white and feeds shader-pack bloom
- Custom render layers — a small interface for adding your own passes (extra overlays, effects)
- Everything vanilla armor does comes for free: pose and animation following, sneaking/swimming, armor stands, baby mobs, dyed leather color, enchantment glint, the glowing outline effect
How it works
- Loading — on resource load (and every F3+T reload), each registered
.geo.jsonis parsed and baked once into a vanillaModelParttree (the sameTexturedModelDataevery vanilla entity model is built from), cached until the next reload. Textures are plain resources, resolved by the render layers on demand — nothing is preprocessed. - Hooking in — when an armor piece is about to render, the library steps in per registered item: on Fabric through Fabric API's
ArmorRendererhook, on NeoForge through a small equivalent mixin. Vanilla's overlay rendering is skipped for that piece and the dispatcher renders the baked model instead — vanilla pose copied on, slot visibility applied. Unregistered items are untouched. - Pass order — each piece draws as a stack of passes over the same model: base texture → your render layers (glow, then trim so it lands on top), with enchantment glint riding the base pass. Renderers built through the fluent API keep the layers sorted into that stack automatically; a renderer constructed with an explicit layer list draws them in list order (see Render layers). Every extra pass is just the model rendered again with a different render layer and buffer.
From bake to buffer this is 100% the vanilla code path — the same pose copy, render layers, and buffers vanilla armor uses. That is the whole compatibility and performance story: Sodium, Iris, and anything else that works with vanilla armor sees ordinary vanilla model rendering. There is no custom vertex pipeline.
For developers
For developer documentation, check out the GitHub readme.
下载 Armor Model API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Armor Model API
下载 Armor Model API
下载 Armor Model API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Armor Model API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Armor Model API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Armor Model API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Armor Model API
下载 Armor Model API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Armor Model API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
1.1.2
- 支持 Minecraft 26.3
- Trims 现在使用游戏的调色板纹理:每个灰度修剪纹理需要一个
.png.mcmeta,内容为{"palette": {"base_palette": "minecraft:trim_base"}},并且可以删除atlases/armor_trims.json TrimLayer.spriteId重命名为textureId(无修剪材质后缀)ArmorRenderContext#submit接受一个UvMapping;新增glintPending()/submitPendingGlint()- Glow 和 radiant 层与 Improved Transparency 兼容
- Geo armor 再次遵循 Entity Model Features 的玩家动画(Fresh Animations Player, Entity Player Compat)
- Geo armor 在 Better Combat 动画期间不再在第一人称视角中显示
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
可定制的鞘翅模组,支持装饰纹饰、旗帜图案等更多功能!
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
适用于 MC 1.18+ 的 Effekseer 加载器
评论 0
登录后参与评分
还没有评论,来抢沙发吧