Kzeroko KTM2

护甲外观渲染

基于Trinkets的幻化存储、限定绘制范围的装备读取和共用护甲侧栏。

更新于 2026/11/13 3 分钟阅读

护甲外观属于内部客户端渲染系统,物品保存在Trinkets背包中。玩家操作与隐琉封印的获取方式见护甲幻化。

它做什么

ArmorTransmog注册isekaiexpansion:armor_appearance判定。普通ArmorItem只能放入对应部位;isekaiexpansion:veilglass_seal可以放入任意幻化槽。仅接受索引0。

分组槽名最大堆叠
headtransmog1
chesttransmog1
legstransmog1
feettransmog1

运行时模型

Trinkets 保存并同步幻化装备。每个客户端将自己的部位显示和物品显示规则保存在 config/isekaiexpansion-armor-display.json。编辑器在本地保存更改并即时更新预览。

ArmorAppearance 在本次绘制期间替换装备读取,并在 finally 中恢复上一层状态。隐藏的部位返回空渲染堆栈。幻化槽为空或装有隐琉封印时显示实际护甲,放入对应护甲时则绘制其外观。

玩家预览读取被预览者的幻化物品,按观察者本地的物品规则绘制。show_model 控制护甲模型,cover_parts 单独控制头发与服装部件的遮挡。冒险者状态中的试穿只影响该预览。暂停菜单与公会卡都在固定日光下为独立的玩家替身拍摄半身照。更改护甲显示或遮挡规则后,照片会随之更新。

范围覆盖LivingEntityRenderer.render和Punchy第一人称绘制入口。原版护甲层及Fabric自定义渲染器沿正常流程取得幻化物品。GeckoLib 4.8.4的护甲渲染器接收该物品和选定装备部位。直接读取原始背包、或在这些范围外绘制的渲染器,需要单独接入限定范围的适配。

服务端从幻化槽读取封印。穿戴部件、目录或异界核心等级变化时,PlayerOutfitModifiers 重新计算临时属性修饰。每个来源下的属性使用稳定的修饰 ID,取出最后一枚封印会移除已生效的加成。服饰加成字段

约定

幻化槽不得提供功能效果。CosmeticComponentMixin将它们排除在getEquipped与isEquipped之外。Trinkets逐槽遍历时,限定范围的无效果饰品会屏蔽物品自定义tick、穿戴及脱下回调;属性桥为这些槽返回空修饰表。保存、同步和背包遍历仍保留幻化物品。

TransmogPanel同时展开四行,幻化槽排在功能饰品之前,边界延伸到最长一行。是否继续展开由实际槽位的悬停判定决定。创造模式背包从当前悬停的护甲列旁展开。Trinkets当前分组仍为head、chest、legs和feet,沿用IsekaiTweaks的REI_BLACKLISTED_TRINKET_SLOTS联动。

槽框采样minecraft:textures/gui/container/inventory.png,占位图标使用原版护甲图标,因此以资源包贴图为准。侧栏不会新增装备属性或独立的渲染模型。

扩展

物品准入集中在ArmorTransmog,绘制替换集中在ArmorAppearance。两者都是内部类型,不是公共接口。新增非护甲穿戴物时,应明确它的渲染约定,不要直接允许所有饰品进入幻化槽。

验证

运行./gradlew.bat compileJava processResources。在生存与创造模式背包中,分别从每个护甲入口展开侧栏,经过全部四个幻化行和最长饰品行,再从空白处移出。检查配方书位置、REI隐藏、拖动物品和替换原版槽框的资源包。

检查皮革染色、纹饰、附魔光效、GeckoLib胸甲和Punchy袖口。比较放入前后的属性,重新登录、切换维度,并分别测试开启和关闭死亡不掉落。绘制抛出异常后也必须恢复读取范围。绕过标准装备读取的第三方渲染器需要单独进行游戏内兼容性检查。

相关文档

护甲幻化 · 装备目录