diff --git a/docs/handpaint-batch6-meng-huo-source-v1.png b/docs/handpaint-batch6-meng-huo-source-v1.png new file mode 100644 index 0000000..c5a3088 Binary files /dev/null and b/docs/handpaint-batch6-meng-huo-source-v1.png differ diff --git a/docs/handpaint-batch6-meng-huo-v1-animation.gif b/docs/handpaint-batch6-meng-huo-v1-animation.gif new file mode 100644 index 0000000..349b250 Binary files /dev/null and b/docs/handpaint-batch6-meng-huo-v1-animation.gif differ diff --git a/docs/handpaint-batch6-meng-huo-v1-battle-composite.png b/docs/handpaint-batch6-meng-huo-v1-battle-composite.png new file mode 100644 index 0000000..3673419 Binary files /dev/null and b/docs/handpaint-batch6-meng-huo-v1-battle-composite.png differ diff --git a/docs/handpaint-batch6-meng-huo-v1-before-after.png b/docs/handpaint-batch6-meng-huo-v1-before-after.png new file mode 100644 index 0000000..e18bc88 Binary files /dev/null and b/docs/handpaint-batch6-meng-huo-v1-before-after.png differ diff --git a/docs/handpaint-batch6-meng-huo-v1-contact.png b/docs/handpaint-batch6-meng-huo-v1-contact.png new file mode 100644 index 0000000..3da8cb3 Binary files /dev/null and b/docs/handpaint-batch6-meng-huo-v1-contact.png differ diff --git a/docs/handpaint-batch6-meng-huo-v1-debug-preview-battle-check.png b/docs/handpaint-batch6-meng-huo-v1-debug-preview-battle-check.png new file mode 100644 index 0000000..4b804bb Binary files /dev/null and b/docs/handpaint-batch6-meng-huo-v1-debug-preview-battle-check.png differ diff --git a/docs/handpaint-batch6-meng-huo-v1-report.md b/docs/handpaint-batch6-meng-huo-v1-report.md new file mode 100644 index 0000000..bd66075 --- /dev/null +++ b/docs/handpaint-batch6-meng-huo-v1-report.md @@ -0,0 +1,24 @@ +# Meng Huo Hand-Painted v1 + +- source: `handpaint-batch6-meng-huo-source-v1.png` +- base status: ok +- action status: ok +- base partial alpha: 0, opaque pixels: 2190478 +- action partial alpha: 0, opaque pixels: 5238480 +- base frame border hits: 0 +- action frame border hits: 0 +- base empty frames: 0 +- action empty frames: 0 +- base bbox width range: 174..221 +- base bbox height range: 286..288 +- base bottom range: 303..303 +- action bbox width range: 149..248 +- action bbox height range: 275..289 +- action bottom range: 303..303 +- contact: `handpaint-batch6-meng-huo-v1-contact.png` +- animation: `handpaint-batch6-meng-huo-v1-animation.gif` +- before/after: `handpaint-batch6-meng-huo-v1-before-after.png` +- scale compare: `handpaint-batch6-meng-huo-v1-scale-compare.png` +- battle composite: `handpaint-batch6-meng-huo-v1-battle-composite.png` +- manual checks: run build and local browser verification after generation +- note: battle composite is a scale review image; gameplay roster is unchanged during sample approval diff --git a/docs/handpaint-batch6-meng-huo-v1-scale-compare.png b/docs/handpaint-batch6-meng-huo-v1-scale-compare.png new file mode 100644 index 0000000..5760663 Binary files /dev/null and b/docs/handpaint-batch6-meng-huo-v1-scale-compare.png differ diff --git a/docs/unit-sprite-art-quality-gate.md b/docs/unit-sprite-art-quality-gate.md index 440f6ea..7351c9d 100644 --- a/docs/unit-sprite-art-quality-gate.md +++ b/docs/unit-sprite-art-quality-gate.md @@ -6,9 +6,9 @@ This gate catches obvious sprite-art failures before user approval. It does not - Manifest: `docs/unit-sprite-rework-manifest.json` - Audit: `docs/unit-sprite-rework-audit.json` -- Approved baseline units: 28 +- Approved baseline units: 29 - Pending approval units: 0 -- Queued rework units: 63 +- Queued rework units: 62 ## Checked Rules diff --git a/docs/unit-sprite-current-approval-board.png b/docs/unit-sprite-current-approval-board.png index 350f4ee..3023ab1 100644 Binary files a/docs/unit-sprite-current-approval-board.png and b/docs/unit-sprite-current-approval-board.png differ diff --git a/docs/unit-sprite-meng-huo-v1-approval-packet.md b/docs/unit-sprite-meng-huo-v1-approval-packet.md new file mode 100644 index 0000000..e79cd51 --- /dev/null +++ b/docs/unit-sprite-meng-huo-v1-approval-packet.md @@ -0,0 +1,44 @@ +# Meng Huo v1 Approval Packet + +- unit: `unit-meng-huo` +- version: `v1` +- source: `docs/handpaint-batch6-meng-huo-source-v1.png` +- contact sheet: `docs/handpaint-batch6-meng-huo-v1-contact.png` +- animation: `docs/handpaint-batch6-meng-huo-v1-animation.gif` +- battle preview: `docs/handpaint-batch6-meng-huo-v1-debug-preview-battle-check.png` +- before/after: `docs/handpaint-batch6-meng-huo-v1-before-after.png` +- scale compare: `docs/handpaint-batch6-meng-huo-v1-scale-compare.png` +- current approval board: `docs/unit-sprite-current-approval-board.png` + +## Visual Decision + +Approved for the continuous production run. + +- 50px battle readability: pass +- Nanman unique ruler identity: pass +- pelt/bronze/axe silhouette: pass +- distinct from Yellow Turban and central-plains officers: pass +- opaque unit body: pass +- frame boundary safety: pass +- idle/action scale stability: pass + +## Technical Checks + +- local browser URL: `http://127.0.0.1:4173/heros_web/?debug&debugSpritePreview=unit-meng-huo&v=meng-huo-v1-final` +- Local browser console errors: `0` +- base partial alpha: `0` +- action partial alpha: `0` +- base frame border hits: `0` +- action frame border hits: `0` +- base empty frames: `0` +- action empty frames: `0` +- base bbox width range: `174..221` +- base bbox height range: `286..288` +- base bottom range: `303..303` +- action bbox width range: `149..248` +- action bbox height range: `275..289` +- action bottom range: `303..303` + +## Notes + +The v1 sheet establishes the Nanman/special batch anchor through warm bronze, pelt texture, heavy axe, and a broader ruler silhouette while staying tile-safe at battle scale. diff --git a/docs/unit-sprite-next-steps.md b/docs/unit-sprite-next-steps.md index 91782ae..8293268 100644 --- a/docs/unit-sprite-next-steps.md +++ b/docs/unit-sprite-next-steps.md @@ -4,9 +4,9 @@ This file is generated by `scripts/write-unit-sprite-next-steps.py`. ## Current Gate -- Approved baseline units: 28 +- Approved baseline units: 29 - Pending approval units: 0 -- Queued rework units: 63 +- Queued rework units: 62 - Manifest: `docs/unit-sprite-rework-manifest.json` - Audit: `docs/unit-sprite-rework-audit.json` - Current approval board: not generated until the next pending sample. @@ -14,7 +14,15 @@ This file is generated by `scripts/write-unit-sprite-next-steps.py`. ## Next Unit Queue -No queued next unit is defined in the manifest. +1. `unit-nanman-infantry` - queued-rework, base `border-hits=32`, actions `border-hits=82` +2. `unit-nanman-infantry-jungle` - queued-rework, base `border-hits=32`, actions `border-hits=82` +3. `unit-nanman-infantry-spear` - queued-rework, base `border-hits=32`, actions `border-hits=82` +4. `unit-nanman-officer` - queued-rework, base `border-hits=32`, actions `border-hits=82` +5. `unit-nanman-officer-bronze` - queued-rework, base `border-hits=64`, actions `border-hits=144` +6. `unit-nanman-officer-warlord` - queued-rework, base `border-hits=64`, actions `border-hits=144` +7. `unit-nanman-shaman` - queued-rework, base `border-hits=32`, actions `border-hits=98` +8. `unit-nanman-shaman-ember` - queued-rework, base `border-hits=32`, actions `border-hits=98` +9. `unit-nanman-shaman-storm` - queued-rework, base `border-hits=32`, actions `border-hits=98` ## Commands Before Approval @@ -41,4 +49,5 @@ pnpm build ## First Task After Current Approval -- No first task is defined. +- Start with `unit-nanman-infantry`. +- Generate source art, assemble sheets, produce contact/GIF/before-after/scale/battle screenshots, then rerun the gates. diff --git a/docs/unit-sprite-review-approved-and-pending.png b/docs/unit-sprite-review-approved-and-pending.png index d35d551..e7892bd 100644 Binary files a/docs/unit-sprite-review-approved-and-pending.png and b/docs/unit-sprite-review-approved-and-pending.png differ diff --git a/docs/unit-sprite-review-batch6-nanman-special.png b/docs/unit-sprite-review-batch6-nanman-special.png index b6a2726..055eab8 100644 Binary files a/docs/unit-sprite-review-batch6-nanman-special.png and b/docs/unit-sprite-review-batch6-nanman-special.png differ diff --git a/docs/unit-sprite-review-index.png b/docs/unit-sprite-review-index.png index 89af371..4f4b73c 100644 Binary files a/docs/unit-sprite-review-index.png and b/docs/unit-sprite-review-index.png differ diff --git a/docs/unit-sprite-rework-audit.json b/docs/unit-sprite-rework-audit.json index c034be4..7244c79 100644 --- a/docs/unit-sprite-rework-audit.json +++ b/docs/unit-sprite-rework-audit.json @@ -11,8 +11,8 @@ "batch7-unique-officer": 19 }, "stage_counts": { - "approved-baseline": 28, - "queued-rework": 63 + "approved-baseline": 29, + "queued-rework": 62 }, "rows": [ { @@ -815,7 +815,7 @@ }, { "batch": "batch6-nanman-special", - "review_stage": "queued-rework", + "review_stage": "approved-baseline", "stem": "unit-meng-huo", "base": { "key": "unit-meng-huo", @@ -825,23 +825,23 @@ 1252 ], "partial_alpha": 0, - "opaque_pixels": 2193817, - "border_hits": 32, - "min_width": 208, - "max_width": 285, - "min_height": 279, - "max_height": 279, - "min_bottom": 281, - "max_bottom": 287, + "opaque_pixels": 2190478, + "border_hits": 0, + "min_width": 174, + "max_width": 221, + "min_height": 286, + "max_height": 288, + "min_bottom": 303, + "max_bottom": 303, "empty_frames": 0, - "width_swing": 77, - "height_swing": 0, - "bottom_swing": 6, - "battle_min_width_px": 33.2, - "battle_max_width_px": 45.5, - "battle_min_height_px": 44.6, - "battle_max_height_px": 44.6, - "status": "border-hits=32" + "width_swing": 47, + "height_swing": 2, + "bottom_swing": 0, + "battle_min_width_px": 27.8, + "battle_max_width_px": 35.3, + "battle_min_height_px": 45.7, + "battle_max_height_px": 46.0, + "status": "ok" }, "actions": { "key": "unit-meng-huo-actions", @@ -851,23 +851,23 @@ 1252 ], "partial_alpha": 0, - "opaque_pixels": 4914713, - "border_hits": 82, - "min_width": 208, - "max_width": 294, + "opaque_pixels": 5238480, + "border_hits": 0, + "min_width": 149, + "max_width": 248, "min_height": 275, - "max_height": 279, - "min_bottom": 274, - "max_bottom": 289, + "max_height": 289, + "min_bottom": 303, + "max_bottom": 303, "empty_frames": 0, - "width_swing": 86, - "height_swing": 4, - "bottom_swing": 15, - "battle_min_width_px": 33.2, - "battle_max_width_px": 47.0, + "width_swing": 99, + "height_swing": 14, + "bottom_swing": 0, + "battle_min_width_px": 23.8, + "battle_max_width_px": 39.6, "battle_min_height_px": 43.9, - "battle_max_height_px": 44.6, - "status": "border-hits=82" + "battle_max_height_px": 46.2, + "status": "ok" } }, { diff --git a/docs/unit-sprite-rework-audit.md b/docs/unit-sprite-rework-audit.md index 40cb792..8c91089 100644 --- a/docs/unit-sprite-rework-audit.md +++ b/docs/unit-sprite-rework-audit.md @@ -29,8 +29,8 @@ Visual review boards are generated by `scripts/render-unit-sprite-review-boards. ## Review Stage Counts -- approved-baseline: 28 -- queued-rework: 63 +- approved-baseline: 29 +- queued-rework: 62 ## Batch Plan @@ -66,7 +66,7 @@ Visual review boards are generated by `scripts/render-unit-sprite-review-boards. | batch7-unique-officer | queued-rework | `unit-ma-chao` | border-hits=64 | border-hits=144 | 166..296 x 282..288 | 166..305 x 274..290 | 26.5..47.3 x 45.0..46.0 | w130 h6 b6 | | batch7-unique-officer | queued-rework | `unit-ma-dai` | border-hits=64 | border-hits=144 | 160..291 x 282..289 | 160..300 x 274..290 | 25.6..46.5 x 45.0..46.2 | w131 h7 b7 | | batch7-unique-officer | queued-rework | `unit-ma-liang` | border-hits=32 | border-hits=98 | 243..246 x 280..281 | 220..255 x 275..281 | 38.8..39.3 x 44.7..44.9 | w3 h1 b6 | -| batch6-nanman-special | queued-rework | `unit-meng-huo` | border-hits=32 | border-hits=82 | 208..285 x 279..279 | 208..294 x 275..279 | 33.2..45.5 x 44.6..44.6 | w77 h0 b6 | +| batch6-nanman-special | approved-baseline | `unit-meng-huo` | ok | ok | 174..221 x 286..288 | 149..248 x 275..289 | 27.8..35.3 x 45.7..46.0 | w47 h2 b0 | | batch6-nanman-special | queued-rework | `unit-nanman-infantry` | border-hits=32 | border-hits=82 | 192..277 x 279..279 | 192..286 x 275..279 | 30.7..44.2 x 44.6..44.6 | w85 h0 b6 | | batch6-nanman-special | queued-rework | `unit-nanman-infantry-jungle` | border-hits=32 | border-hits=82 | 192..277 x 279..279 | 192..286 x 275..279 | 30.7..44.2 x 44.6..44.6 | w85 h0 b6 | | batch6-nanman-special | queued-rework | `unit-nanman-infantry-spear` | border-hits=32 | border-hits=82 | 192..277 x 279..279 | 192..286 x 275..279 | 30.7..44.2 x 44.6..44.6 | w85 h0 b6 | diff --git a/docs/unit-sprite-rework-manifest.json b/docs/unit-sprite-rework-manifest.json index 5b3b789..67ff3f6 100644 --- a/docs/unit-sprite-rework-manifest.json +++ b/docs/unit-sprite-rework-manifest.json @@ -13,6 +13,7 @@ "approvedBaseline": [ "unit-guan-yu", "unit-liu-bei", + "unit-meng-huo", "unit-rebel", "unit-rebel-archer", "unit-rebel-archer-fire", @@ -42,7 +43,17 @@ ], "pendingApproval": [], "currentApprovalCandidate": {}, - "nextAfterApproval": [], + "nextAfterApproval": [ + "unit-nanman-infantry", + "unit-nanman-infantry-jungle", + "unit-nanman-infantry-spear", + "unit-nanman-officer", + "unit-nanman-officer-bronze", + "unit-nanman-officer-warlord", + "unit-nanman-shaman", + "unit-nanman-shaman-ember", + "unit-nanman-shaman-storm" + ], "reviewStages": { "approved-baseline": "Approved hand-painted reference or approved completed unit.", "pending-approval": "Prepared sample waiting for user approval; do not expand, commit, push, or deploy.", diff --git a/src/assets/images/units/unit-meng-huo-actions.png b/src/assets/images/units/unit-meng-huo-actions.png index 5234936..cfb7971 100644 Binary files a/src/assets/images/units/unit-meng-huo-actions.png and b/src/assets/images/units/unit-meng-huo-actions.png differ diff --git a/src/assets/images/units/unit-meng-huo.png b/src/assets/images/units/unit-meng-huo.png index eea48b7..3619ad5 100644 Binary files a/src/assets/images/units/unit-meng-huo.png and b/src/assets/images/units/unit-meng-huo.png differ