Kzeroko KTM2

Armour appearance rendering

Trinkets-backed cosmetic storage, scoped equipment reads and the shared armour drawer.

Updated Nov 13, 2026 3 min read

Armour appearance is an internal client rendering subsystem backed by Trinkets inventory. Player controls and where to find a seal are in Armour transmogrification.

What it does

ArmorTransmog declares the isekaiexpansion:armor_appearance predicate. It accepts an ArmorItem only in its matching body group, or isekaiexpansion:veilglass_seal in any appearance slot. Only index 0 is accepted.

GroupSlotMaximum stack
headtransmog1
chesttransmog1
legstransmog1
feettransmog1

Runtime model

Trinkets persists and synchronises cosmetic equipment. Each client saves its own slot visibility and registry-item display rules in config/isekaiexpansion-armor-display.json. The editor writes them locally and updates the portrait immediately.

ArmorAppearance scopes equipment reads to the current draw and restores the previous frame in finally. A hidden slot yields an empty rendered stack. A seal or empty appearance slot draws the equipped piece. A matching cosmetic armour piece supplies its own render stack.

Player portraits resolve the tracked wearer’s cosmetic stack and apply the viewer’s item rules. show_model controls the armour mesh. cover_parts independently controls hair and clothing suppression. A fitting in Adventurer Status applies only to that portrait. The pause menu and guild card photograph the same detached player model under fixed daylight. Changing visible armour or its coverage refreshes the photograph.

The scope surrounds LivingEntityRenderer.render and Punchy’s first-person render entry. Vanilla armour features and Fabric custom renderers receive the selected appearance stack through their existing path. GeckoLib 4.8.4’s armour renderer consumes that stack and the selected equipment slot. A renderer reading the raw inventory or drawing outside these scopes requires its own scoped adapter.

The server checks the native appearance slots for one seal. PlayerOutfitModifiers reconciles temporary modifiers when the worn parts, catalogue or IsekaiCore level change. Each source and attribute has a stable modifier ID. Removing the last seal removes the applied grants. Outfit grant fields

Contracts

Cosmetic slots must remain nonfunctional. CosmeticComponentMixin excludes them from getEquipped and isEquipped. During Trinkets’ per-slot traversal, a scoped passive trinket suppresses item-specific tick/equip/unequip callbacks; the modifier bridge returns an empty attribute map for these slots. Saving, synchronisation and inventory traversal still include them.

TransmogPanel opens all four rows together, sorts cosmetic slots before functional accessories and sizes bounds to the longest row. Exact slot hover controls its lifetime. Creative inventory opens the drawer beside the hovered armour column. Native Trinkets active groups remain head, chest, legs and feet, preserving IsekaiTweaks’ REI_BLACKLISTED_TRINKET_SLOTS integration.

Slot frames sample minecraft:textures/gui/container/inventory.png; placeholders use vanilla armour icons. Pack textures remain authoritative. The drawer does not introduce an equipment attribute or a separate rendering model.

Extending it

Keep appearance admission in ArmorTransmog and render substitution in ArmorAppearance. These are internal types, not public facades. Supporting a new non-armour wearable requires an explicit rendering contract; do not broaden admission to every trinket.

Verifying

Run ./gradlew.bat compileJava processResources. In survival and Creative inventories, open each armour anchor, cross between all four appearance rows and the longest accessory row, then leave through an empty area. Check recipe-book positioning, REI hiding, item dragging and a resource pack that replaces the vanilla slot texture.

Test vanilla leather dye, trims, enchantment glint, a GeckoLib chestplate and Punchy sleeves. Compare attributes before and after insertion, relog, change dimension and test death with both keep-inventory settings. Rendering scope cleanup must also survive an exception. Third-party renderers that bypass standard equipment reads need an in-game compatibility check.

Armour transmogrification · Equipment catalog