heros_web/docs/equipment-icon-quality-audit.md

Equipment Icon Quality Audit

Generated by scripts/audit-equipment-icon-quality.mjs.

Summary

• Catalog items: 23
• Generated procedural item textures: 23
• Slots: accessory 7, armor 5, weapon 11
• Ranks: common 11, treasure 12
• Texture size: 64px
• Drawing grid: 28 units scaled 2.29x into the texture
• Runtime item icon scene: src/game/scenes/CampScene.ts
• Observed runtime display sizes: 14px, 20px, 21px, 22px, 30px
• Direct item texture render sites found: 5

Main Findings

• Equipment item icons are generated at runtime in BootScene, not stored as individual raster images.
• The 64px textures are drawn from a compact 28-unit source grid, so they are crisp but intentionally simple.
• Battle combat preview mostly uses the high-resolution battle-ui-icons slot frames and item names; per-item textures appear primarily in camp/sortie equipment UI.
• Treasure/common distinction often relies on UI frame color plus a small palette change, not a strong unique silhouette.
• Reused helper silhouettes are the strongest quality risk because several different items collapse to the same shape at 14-22px.

First Improvement Target

• Target: weapon spear/polearm family
• Item ids: green-dragon-glaive, serpent-spear, sky-piercer-halberd, iron-spear, western-cavalry-spear
• Reason: These are high-frequency equipment surfaces and several treasure/common weapons share a thin diagonal shaft silhouette; upgrading this group gives the clearest identity gain in sortie prep and equipment swap screens.

Follow-Up Targets

• armor silhouettes: oath-robe, reinforced-lamellar, cloth-armor, lamellar-armor, rebel-vest
  • Armor and robes are readable but depend on simple triangular torsos and small color accents.
• accessory charms and tokens: bravery-token, mountain-guide-scroll, peach-charm, war-manual, wind-quiver, grain-pouch, yellow-scarf-charm
  • Accessories are the smallest UI read and several use compact badge-like shapes.

Highest-Risk Shared Silhouette Groups

score	signature	slots	ranks	items
15	drawSpearIcon	weapon	common, treasure	serpent-spear, iron-spear, western-cavalry-spear
8	drawArmorIcon	armor	common, treasure	reinforced-lamellar, lamellar-armor
8	drawCharmIcon	accessory	common, treasure	peach-charm, yellow-scarf-charm
8	drawPolearmIcon	weapon	treasure	green-dragon-glaive, sky-piercer-halberd
8	drawRobeIcon	armor	common, treasure	oath-robe, cloth-armor

Full Item Inventory

item id	slot	rank	draw helpers	calls	primitives	colors	concerns
green-dragon-glaive	weapon	treasure	drawPolearmIcon	1	11	2	single helper silhouette low primitive detail
serpent-spear	weapon	treasure	drawSpearIcon	1	7	2	single helper silhouette low primitive detail
sky-piercer-halberd	weapon	treasure	drawPolearmIcon	1	11	2	single helper silhouette low primitive detail
twin-oath-blades	weapon	treasure	drawSwordIcon drawSwordIcon	2	32	3	none
white-feather-fan	weapon	treasure	drawFanIcon	1	19	2	single helper silhouette
iron-spear	weapon	common	drawSpearIcon	1	7	2	single helper silhouette low primitive detail
leader-axe	weapon	common	drawAxeIcon	1	7	2	single helper silhouette low primitive detail
short-bow	weapon	common	drawBowIcon	1	18	2	single helper silhouette
training-sword	weapon	common	drawSwordIcon	1	16	2	single helper silhouette low primitive detail
western-cavalry-spear	weapon	common	drawSpearIcon	1	7	2	single helper silhouette low primitive detail
yellow-turban-saber	weapon	common	drawSaberIcon	1	12	2	single helper silhouette low primitive detail
oath-robe	armor	treasure	drawRobeIcon	1	7	2	single helper silhouette low primitive detail
reinforced-lamellar	armor	treasure	drawArmorIcon	1	12	2	single helper silhouette low primitive detail
cloth-armor	armor	common	drawRobeIcon	1	7	2	single helper silhouette low primitive detail
lamellar-armor	armor	common	drawArmorIcon	1	12	2	single helper silhouette low primitive detail
rebel-vest	armor	common	drawVestIcon	1	4	2	single helper silhouette low primitive detail
bravery-token	accessory	treasure	drawTokenIcon	1	4	2	single helper silhouette low primitive detail
mountain-guide-scroll	accessory	treasure	drawMapScrollIcon	1	13	2	single helper silhouette low primitive detail
peach-charm	accessory	treasure	drawCharmIcon	1	4	2	single helper silhouette low primitive detail
war-manual	accessory	treasure	drawBookIcon	1	7	2	single helper silhouette low primitive detail
wind-quiver	accessory	treasure	drawQuiverIcon	1	8	2	single helper silhouette low primitive detail
grain-pouch	accessory	common	drawPouchIcon	1	7	2	single helper silhouette low primitive detail
yellow-scarf-charm	accessory	common	drawCharmIcon	1	4	2	single helper silhouette low primitive detail

Recommended Next Batch Definition

• Scope: replace or enrich the five spear/polearm weapon icons while keeping item-${itemId} texture keys stable.
• Success criteria: each item reads as a distinct weapon silhouette at 20px and 30px, with treasure weapons visibly richer than common weapons.
• Keep the existing 64px texture size unless a UI-wide equipment icon pass is planned.
• Add before/after contact sheets and verify the sortie equipment list and equipment swap panel in a desktop browser.