Files
heros_web/docs/asset-backlog.md

365 lines
12 KiB
Markdown

# Asset Backlog
This backlog tracks sequential visual asset expansion for story images, portraits,
and unit sheets. Counts are refreshed at the start of each batch, then the batch is
generated, connected, validated, built, flow-tested, committed, and pushed.
## Current Baseline
- Story images: 114 files after Batch 9.
- Portraits: 59 files after Batch 9.
- Unit sheets: 162 files, 81 complete base/action design pairs after Batch 9.
- Target direction:
- Story: about 5 images per major campaign chapter across 65 campaign stages.
- Portraits: one portrait for every important `scenario.ts` speaker.
- Units: 100+ complete unit designs, each with a base 4x4 sheet and an actions 4x4 sheet.
## Batch 1 Priority
Status: complete and ready for build/flow verification.
The first batch targets the most repeated story backgrounds and the highest-frequency
missing portrait speakers.
### Story
- `37-yizhou-luo-road-ambush.png`
- `38-yizhou-luo-road-supply-train.png`
- `39-nanzhong-captures-jungle-net.png`
- `40-nanzhong-captures-river-ford.png`
- `41-wandering-night-camp.png`
- `42-wandering-river-crossing.png`
- `43-northern-qishan-snow-march.png`
- `44-northern-wei-fortress.png`
### Portraits
- `fa-zheng.png`
- `jian-yong.png`
- `pang-tong.png`
- `mi-zhu.png`
- `zhou-yu.png`
- `yi-ji.png`
- `yan-yan.png`
### Units
- `unit-wei-archer-veteran.png` + `unit-wei-archer-veteran-actions.png`
- `unit-wu-cavalry-elite.png` + `unit-wu-cavalry-elite-actions.png`
- `unit-nanman-shaman-ember.png` + `unit-nanman-shaman-ember-actions.png`
## Next Backlog Pool
- Story variants: `story-yizhou`, `story-jingzhou-crisis`,
`story-fan-castle-flood`, `story-jieting-crisis`, `story-chengdu-surrender`,
`story-anti-dong`.
- Portraits: `wu-yi.png`, `li-yan.png`, `ma-chao.png`, `gong-zhi.png`,
`huang-zhong.png`, `cao-cao.png`, `wei-yan.png`, `ma-dai.png`, `meng-huo.png`.
- Units: faction/class variants for Shu, Wei, Wu, Nanman, rebel remnants, and
named-general alternates until the complete design count reaches 100+.
## Batch 2 Priority
Status: complete and ready for build/flow verification.
### Story
- `45-yizhou-council-at-river.png`
- `46-yizhou-mountain-gate.png`
- `47-jingzhou-crisis-watchtower-alarm.png`
- `48-jingzhou-crisis-refugee-court.png`
- `49-fan-castle-flood-rising-water.png`
- `50-fan-castle-flood-siege-engines.png`
- `51-jieting-crisis-supply-line.png`
- `52-jieting-crisis-mountain-camp.png`
- `53-chengdu-surrender-hall.png`
- `54-anti-dong-hulao-pass.png`
### Portraits
- `wu-yi.png`
- `li-yan.png`
- `ma-chao.png`
- `gong-zhi.png`
- `huang-zhong.png`
- `cao-cao.png`
- `wei-yan.png`
- `meng-huo.png`
### Units
- `unit-shu-infantry-guard.png` + `unit-shu-infantry-guard-actions.png`
- `unit-shu-cavalry-white.png` + `unit-shu-cavalry-white-actions.png`
- `unit-wei-cavalry-iron.png` + `unit-wei-cavalry-iron-actions.png`
- `unit-wu-archer-river.png` + `unit-wu-archer-river-actions.png`
## Batch 3 Priority
Status: complete and ready for build/flow verification.
The early-game unit sheets should be remastered because the newer generated units
have a stronger silhouette, cleaner 4x4 framing, and better action readability.
Keep the existing texture keys so code paths and saved scenarios continue to work.
### Unit Remasters
- `unit-liu-bei.png` + `unit-liu-bei-actions.png`
- `unit-guan-yu.png` + `unit-guan-yu-actions.png`
- `unit-zhang-fei.png` + `unit-zhang-fei-actions.png`
- `unit-rebel.png` + `unit-rebel-actions.png`
- `unit-rebel-archer.png` + `unit-rebel-archer-actions.png`
- `unit-rebel-cavalry.png` + `unit-rebel-cavalry-actions.png`
- `unit-rebel-leader.png` + `unit-rebel-leader-actions.png`
### Remaining Portraits
- None. All currently mapped named speakers have portrait coverage after Batch 4.
## Batch 4 Priority
Status: complete. Image dimensions, unit base/action pairs, `pnpm build`, and `pnpm verify:flow` passed.
This batch finishes the named-speaker portrait backlog, adds portrait variants that
are actually selected in story scenes, and continues expanding high-repeat story
backgrounds and class/faction unit variety.
### Story
- `55-yellow-pursuit-ambush.png`
- `56-yellow-pursuit-village-relief.png`
- `57-wolong-straw-boats.png`
- `58-red-cliffs-wind-prayer.png`
- `59-yiling-baidi-mountain-retreat.png`
- `60-maicheng-isolation-snow-road.png`
- `61-yiling-fire-attack-riverbank.png`
- `62-hanzhong-rain-night-watch.png`
- `63-weishui-northbank-cavalry-screen.png`
- `64-nanzhong-forest-council.png`
### Portraits
- `ma-dai.png`
- `liu-bei-campaign.png`
- `guan-yu-campaign.png`
- `zhang-fei-campaign.png`
- `zhuge-liang-campaign.png`
### Units
- `unit-shu-spearman-veteran.png` + `unit-shu-spearman-veteran-actions.png`
- `unit-wei-strategist-blue.png` + `unit-wei-strategist-blue-actions.png`
- `unit-wu-officer-river.png` + `unit-wu-officer-river-actions.png`
- `unit-nanman-officer-warlord.png` + `unit-nanman-officer-warlord-actions.png`
## Batch 5 Priority
Status: complete. Visual contact sheets, image dimensions, unit base/action pairs,
`pnpm build`, and `pnpm verify:flow` passed. Code connection uses the existing
story, portrait, and unit variant discovery paths.
This batch expands the most repeated story backgrounds, adds variants for major
late-campaign speakers, and strengthens low-variant unit families.
### Story
- `65-yizhou-luo-road-cliff-fortress.png`
- `66-yizhou-luo-road-mountain-scouts.png`
- `67-nanzhong-captures-bamboo-gorge.png`
- `68-nanzhong-captures-river-night-camp.png`
- `69-wandering-market-shelter.png`
- `70-wandering-cold-mountain-pass.png`
- `71-northern-supply-valley.png`
- `72-northern-mountain-war-council.png`
- `73-red-cliffs-chain-smoke.png`
- `74-wolong-river-strategy.png`
- `75-jingzhou-crisis-river-watchtowers.png`
- `76-fan-castle-flood-river-breach.png`
### Portraits
- `zhao-yun-campaign.png`
- `jiang-wei-campaign.png`
- `sima-yi-campaign.png`
- `cao-cao-campaign.png`
- `ma-chao-campaign.png`
- `huang-zhong-campaign.png`
- `wang-ping-campaign.png`
### Units
- `unit-shu-archer-veteran.png` + `unit-shu-archer-veteran-actions.png`
- `unit-shu-strategist-white.png` + `unit-shu-strategist-white-actions.png`
- `unit-wei-officer-iron.png` + `unit-wei-officer-iron-actions.png`
- `unit-wu-infantry-river.png` + `unit-wu-infantry-river-actions.png`
- `unit-rebel-archer-veteran.png` + `unit-rebel-archer-veteran-actions.png`
## Batch 6 Priority
Status: complete. Visual contact sheets, image dimensions, unit base/action pairs,
`pnpm build`, and `pnpm verify:flow` passed. `sun-qian-campaign.png` was
regenerated once for clearer character differentiation. Code connection uses the
existing story, portrait, and unit variant discovery paths.
This batch expands mid-campaign and late northern-campaign story backgrounds,
adds campaign variants for supporting speakers, and improves the lowest-count
unit families.
### Story
- `77-xuzhou-gate-council.png`
- `78-xuzhou-night-evacuation.png`
- `79-anti-dong-coalition-council.png`
- `80-anti-dong-night-assault.png`
- `81-chengdu-surrender-court.png`
- `82-chengdu-outer-gate-surrender.png`
- `83-wudu-yinping-cloud-road.png`
- `84-chencang-siege-fortress-standoff.png`
- `85-chencang-siege-engineering-camp.png`
- `86-weishui-camps-logistics.png`
- `87-weishui-camps-night-alarm.png`
- `88-lucheng-pursuit-valley-road.png`
### Portraits
- `mi-zhu-campaign.png`
- `jian-yong-campaign.png`
- `sun-qian-campaign.png`
- `pang-tong-campaign.png`
- `fa-zheng-campaign.png`
- `meng-huo-campaign.png`
### Units
- `unit-wu-strategist-river.png` + `unit-wu-strategist-river-actions.png`
- `unit-nanman-infantry-jungle.png` + `unit-nanman-infantry-jungle-actions.png`
- `unit-rebel-cavalry-veteran.png` + `unit-rebel-cavalry-veteran-actions.png`
- `unit-rebel-leader-warlord.png` + `unit-rebel-leader-warlord-actions.png`
- `unit-shu-officer-council.png` + `unit-shu-officer-council-actions.png`
## Batch 7 Priority
Status: complete. Visual contact sheets, image dimensions, unit base/action pairs,
`pnpm build`, and `pnpm verify:flow` passed.
This batch keeps pressure on the highest-repeat story backgrounds, adds campaign
variants for mid-campaign supporting officers, and moves the unit design count
toward the 100+ complete-pair target.
### Story
- `89-yizhou-luo-road-hidden-bridge.png`
- `90-nanzhong-captures-monsoon-ravine.png`
- `91-wandering-snow-shrine.png`
- `92-northern-supply-depot.png`
- `93-yizhou-mountain-pass-command-post.png`
- `94-red-cliffs-dawn-aftermath.png`
- `95-yellow-pursuit-rural-crossroads.png`
- `96-wolong-autumn-study.png`
### Portraits
- `ma-liang-campaign.png`
- `yi-ji-campaign.png`
- `gong-zhi-campaign.png`
- `wu-yi-campaign.png`
- `yan-yan-campaign.png`
### Units
- `unit-wei-infantry-shield.png` + `unit-wei-infantry-shield-actions.png`
- `unit-wu-archer-naval.png` + `unit-wu-archer-naval-actions.png`
- `unit-nanman-officer-bronze.png` + `unit-nanman-officer-bronze-actions.png`
## Batch 8 Priority
Status: complete. Visual contact sheets, image dimensions, unit base/action pairs,
auto-connection checks, `pnpm build`, and `pnpm verify:flow` passed.
This batch raises several still-thin high-repeat story keys to three or more
variants, adds campaign portrait variants for important mid/late-campaign
officers, and adds unit variants for Shu cavalry, Wei cavalry, and Wu strategists.
### Story
- `97-fan-castle-flood-prison-camp.png`
- `98-jingzhou-crisis-secret-letter.png`
- `99-xuzhou-flooded-courtyard.png`
- `100-jieting-crisis-wooden-palisade.png`
- `101-chengdu-surrender-river-gate.png`
- `102-yiling-baidi-lantern-vigil.png`
- `103-weishui-northbank-frozen-ferry.png`
- `104-lucheng-pursuit-dust-road.png`
### Portraits
- `zhou-yu-campaign.png`
- `wei-yan-campaign.png`
- `ma-dai-campaign.png`
- `li-yan-campaign.png`
- `huang-quan-campaign.png`
### Units
- `unit-wei-cavalry-elite.png` + `unit-wei-cavalry-elite-actions.png`
- `unit-wu-strategist-fire.png` + `unit-wu-strategist-fire-actions.png`
- `unit-shu-cavalry-scout.png` + `unit-shu-cavalry-scout-actions.png`
## Batch 9 Priority
Status: complete. Visual contact sheets, image dimensions, unit base/action pairs,
auto-connection checks, `pnpm build`, and `pnpm verify:flow` passed.
This batch thickens late-campaign and northern-expedition story keys that still
had one or two variants, adds situational portrait variants for the core Shu
heroes, and lifts several low-count unit families to at least three complete
design pairs.
### Story
- `105-qishan-renewed-snow-relay.png`
- `106-hanzhong-rain-supply-trench.png`
- `107-maicheng-isolation-abandoned-gate.png`
- `108-yiling-fire-forest-corridor.png`
- `109-wudu-yinping-cliff-granary.png`
- `110-baidi-entrustment-medicine-chamber.png`
- `111-tianshui-front-market-command.png`
- `112-chencang-siege-ladder-yard.png`
- `113-anti-dong-coalition-oath-camp.png`
- `114-red-cliffs-wind-altar.png`
### Portraits
- `liu-bei-shuhan.png`
- `guan-yu-jingzhou.png`
- `zhang-fei-ba-command.png`
- `zhuge-liang-northern.png`
- `zhao-yun-veteran.png`
### Units
- `unit-shu-infantry-banner.png` + `unit-shu-infantry-banner-actions.png`
- `unit-wei-archer-crossbow.png` + `unit-wei-archer-crossbow-actions.png`
- `unit-wu-cavalry-river.png` + `unit-wu-cavalry-river-actions.png`
- `unit-rebel-archer-fire.png` + `unit-rebel-archer-fire-actions.png`
## Early Unit Remaster V2
Status: complete. Visual contact sheet, image dimensions, alpha transparency,
`pnpm build`, and `pnpm verify:flow` passed.
This pass replaces the early Yellow Turban campaign unit sheets in place, keeping
the same texture keys so existing battles and saves continue to load the updated
art without code changes. The goal is to bring the first-stage Liu Bei, Guan Yu,
Zhang Fei, and Yellow Turban enemy sheets up to the stronger silhouette and
cleaner sprite-sheet quality of the newer unit batches.
### Units
- `unit-liu-bei.png` + `unit-liu-bei-actions.png`
- `unit-guan-yu.png` + `unit-guan-yu-actions.png`
- `unit-zhang-fei.png` + `unit-zhang-fei-actions.png`
- `unit-rebel.png` + `unit-rebel-actions.png`
- `unit-rebel-archer.png` + `unit-rebel-archer-actions.png`
- `unit-rebel-cavalry.png` + `unit-rebel-cavalry-actions.png`
- `unit-rebel-leader.png` + `unit-rebel-leader-actions.png`