护甲外观渲染
基于Trinkets的幻化存储、限定绘制范围的装备读取和共用护甲侧栏。
护甲外观属于内部客户端渲染系统,物品保存在Trinkets背包中。玩家操作与隐琉封印的获取方式见护甲幻化。
它做什么
ArmorTransmog注册isekaiexpansion:armor_appearance判定。普通ArmorItem只能放入对应部位;isekaiexpansion:veilglass_seal可以放入任意幻化槽。仅接受索引0。
| 分组 | 槽名 | 最大堆叠 |
|---|---|---|
head | transmog | 1 |
chest | transmog | 1 |
legs | transmog | 1 |
feet | transmog | 1 |
运行时模型
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袖口。比较放入前后的属性,重新登录、切换维度,并分别测试开启和关闭死亡不掉落。绘制抛出异常后也必须恢复读取范围。绕过标准装备读取的第三方渲染器需要单独进行游戏内兼容性检查。