heros_web/docs/asset-backlog.md

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: 134 files after Batch 11.
• Portraits: 69 files after Batch 11.
• Unit sheets: 182 files, 91 complete base/action design pairs after Batch 11.
• 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

Batch 10 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 still-thin late-campaign and northern-expedition story keys, adds situational portrait variants for major opposing and frontier figures, and raises several low-count unit families closer to the 100+ complete design-pair target.

Story

• 115-qishan-renewed-frozen-scout-line.png
• 116-yiling-fire-attack-river-ashes.png
• 117-baidi-entrustment-river-watch.png
• 118-tianshui-front-hidden-letter.png
• 119-hanzhong-rain-mountain-shrine.png
• 120-maicheng-isolation-snow-bridge.png
• 121-wudu-yinping-cloud-signal.png
• 122-chencang-siege-broken-ram.png
• 123-yellow-pursuit-grain-relief.png
• 124-nanzhong-captures-mist-stockade.png

Portraits

• cao-cao-redcliffs.png
• sima-yi-qishan.png
• jiang-wei-tianshui.png
• ma-chao-jiameng.png
• meng-huo-final.png

Units

• unit-shu-spearman-guard.png + unit-shu-spearman-guard-actions.png
• unit-shu-archer-longbow.png + unit-shu-archer-longbow-actions.png
• unit-wei-officer-gate.png + unit-wei-officer-gate-actions.png
• unit-wu-infantry-marine.png + unit-wu-infantry-marine-actions.png
• unit-nanman-shaman-storm.png + unit-nanman-shaman-storm-actions.png

Batch 11 Priority

Status: complete. Visual contact sheets, image dimensions, unit base/action pairs, auto-connection checks, pnpm build, and pnpm verify:flow passed.

This batch fills the thinnest early-story aliases so the Yellow Turban opening has more visual variety, adds several late-campaign battlefield variants, adds early and campaign-specific portrait variants for core officers, and raises more low-count unit families toward the 100+ complete design-pair target.

Story

• 125-chaos-market-panic.png
• 126-militia-training-yard.png
• 127-sortie-dawn-muster.png
• 128-liu-bei-village-resolve.png
• 129-three-heroes-rain-shelter.png
• 130-lucheng-pursuit-ravine-signal.png
• 131-weishui-camps-frozen-watch.png
• 132-weishui-northbank-siege-line.png
• 133-yiling-fire-attack-smoke-crossing.png
• 134-chengdu-surrender-sealed-gate.png

Portraits

• liu-bei-yellow-turban.png
• guan-yu-yellow-turban.png
• zhang-fei-yellow-turban.png
• zhao-yun-changban.png
• zhuge-liang-redcliffs.png

Units

• unit-shu-strategist-field.png + unit-shu-strategist-field-actions.png
• unit-shu-officer-vanguard.png + unit-shu-officer-vanguard-actions.png
• unit-wei-strategist-black.png + unit-wei-strategist-black-actions.png
• unit-wu-officer-harbor.png + unit-wu-officer-harbor-actions.png
• unit-nanman-infantry-spear.png + unit-nanman-infantry-spear-actions.png