# 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`
- Checked unit detail, strategy menu, command menu, and combat preview at desktop 1280x720.
- Console errors: none observed during local browser check.
- 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.