heros_web/docs/battle-ui-icons-hq-batch1-report.md

Battle UI Icon HQ Batch 1

Date: 2026-07-03

Scope

This batch extends the approved high-resolution raster icon direction into the most visible combat UI icons:

• HP / troop strength
• luck
• bow
• horse
• armor
• accessory
• hit
• critical
• advantage
• strategy success
• strategy failure
• heal
• rally / encouragement
• fire tactic
• confusion / intimidation
• counterattack

The atlas remains a 128px-frame spritesheet with the existing 5x6 layout. New alias keys were added for clearer intent:

• luck aliases frame 7
• confusion aliases frame 25
• failure uses frame 26

Outputs

• Source generation sheet: docs/battle-ui-icons-hq-batch1-source.png
• Chroma-key alpha source: docs/battle-ui-icons-hq-batch1-source-alpha.png
• Batch contact sheet: docs/battle-ui-icons-hq-batch1-contact.png
• Before/after comparison: docs/battle-ui-icons-hq-batch1-before-after.png
• Local strategy menu check: docs/battle-ui-icons-hq-batch1-local-strategy-menu.png
• Local combat preview check: docs/battle-ui-icons-hq-batch1-local-combat-preview.png
• Deployed combat preview check: docs/battle-ui-icons-hq-batch1-prod-combat-preview.png
• Previous atlas reference: docs/battle-ui-icons-hq-batch1-before-atlas.png
• Applied atlas copy: docs/battle-ui-icons-hq-batch1-atlas.png
• Runtime atlas: src/assets/images/ui/battle-ui-icons.png

Notes

• The icons are generated as project-specific original raster art and do not copy existing game icon assets.
• Existing UI layout is preserved; the improvement is focused on art quality, silhouette, and readability.
• The command menu, strategy menu, unit detail, and combat preview all consume the updated atlas frames.

Verification

• Build: pnpm build passed.
• Local browser: http://127.0.0.1:4190/heros_web/?debug&debugBattleSetup=attack-preview&v=hq-icons-batch1-local
• Historical capture note: the linked local and deployed PNGs preserve the original desktop 1280x720 session and have not been relabeled or upscaled.
• Current-standard revalidation (2026-07-17): unit detail, strategy menu, command menu, and combat preview passed at an explicit 1920x1080 CSS viewport, 100% browser zoom, and DPR 1.
• Console errors: none observed during the historical capture or current-standard revalidation.
• Deploy: pnpm deploy:nas passed and deployed to /volume1/web/heros_web.
• Deployed browser: https://comtropy.synology.me/heros_web/?debug&debugBattleSetup=attack-preview&v=hq-icons-batch1-prod
• Deployed console errors: none observed during combat preview check.