[Vatsal2005]

What and why

Load exported stage manifests and the confirmed sprite board ids without hard-coded scene asset paths. Chunk coordinates place the 2160×720 grid, shared plates load once, and draw order and parallax come from the export. Development rejects missing assets with the URL; production reports the error and uses a bundled actor or plain stage plate. Placeholders are requested only on fallback.

Issue

Closes #24
Refs #110

Stack

• [16/16] feat: block frontal hits with the chair guard #149 [16/16] feat: block frontal hits with the chair guard
• [15/16] feat: add up attacks and pogo slams #146 [15/16] feat: add up attacks and pogo slams
• [14/16] feat: patrol and charge with autonomous rovers #145 [14/16] feat: patrol and charge with autonomous rovers
• [13/16] feat: save and refill at coffee machines #144 [13/16] feat: save and refill at coffee machines
• [12/16] feat: add alternating chair sweeps and contact hits #137 [12/16] feat: add alternating chair sweeps and contact hits
• [11/16] feat: add health damage and checkpoint respawn #135 [11/16] feat: add health damage and checkpoint respawn
• [10/16] feat: switch locomotion through authored bridge clips #132 [10/16] feat: switch locomotion through authored bridge clips
• [9/16] feat: follow the hero with directional camera lead #131 [9/16] feat: follow the hero with directional camera lead
• [8/16] feat: add one-way decks and ladder climbing #126 [8/16] feat: add one-way decks and ladder climbing
• [7/16] feat: follow ground slopes and slide downhill #125 [7/16] feat: follow ground slopes and slide downhill
• [6/16] feat: add variable jumps and landing poses #123 [6/16] feat: add variable jumps and landing poses
• [5/16] feat: add weighted walking and running #122 [5/16] feat: add weighted walking and running
• [4/16] feat: load authored collision with a debug overlay #120 [4/16] feat: load authored collision with a debug overlay
• [3/16] feat: load exported stages and sprite atlases #116 [3/16] feat: load exported stages and sprite atlases ← this PR
• [2/16] ci: check the game with node 22 on pull requests #111 [2/16] ci: check the game with node 22 on pull requests
• [1/4] chore(shared): scaffold the phaser game runtime #94 [1/16] chore(shared): scaffold the phaser game runtime — merged

Base: ci/25-game-checks. Human merges bottom up; retarget the next PR to main and merge origin/main into every open branch, never rebase.

Acceptance criteria

• Rusty Creek's three anomaly chunks × seven layers render from the exporter manifest; clean state loads its six authored layers per chunk
• Loads any export_atlas.py JSON-hash atlas and its animation table, including all 13 confirmed board ids
• Missing assets reject in dev; production uses fallback assets

Verification

• Node 22: npm run typecheck, npm test (49 tests), npm run build; includes main integration at e8577ab
• py -3.13 scripts/check_docs.py
• git diff --cached --check
• Actual lane A stage exporter snapshots: all Rusty Creek states and the Hidden Garden reconstruct exactly with --verify; all verification data stayed in ignored tmp/
• Browser: clean and anomaly Rusty Creek render; drag-pan crosses all three chunks with parallax and no console errors
• Browser: deliberate missing hero-move.json rejects in dev with its URL; production still renders through fallback
• Browser: missing production stage.json renders the plain stage placeholder
• Vercel preview: GitHub states Vatsal2005 needs project access on Vercel to create deployments. A project owner must grant access; local checks pass.

Contract notes

Follow #110's exact stage.json shape and list order. Rusty Creek intentionally blends water last; sorting by z would break recomposition. The existing export uses its authored scroll factors (distance 0.2, rails 1.1, foreground 1.15), which differ from docs/04's general layer table. This loader preserves the export's values; any art tuning remains in the export config. No contract names or art files were changed.

Screenshots

Captured in ignored tmp/verification/: 24-rusty-creek-start.png, 24-rusty-creek-clean.png, 24-rusty-creek-end.png, 24-production-missing-stage.png. Images are included in the chat handoff; GitHub's browser is signed out, so upload through its UI is unavailable.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
wincs	Error		Oct 24, 2026 12:27am UTC

[vercel]

@Vatsal2005 must be a member of the arudaev's projects team on Vercel to deploy.
- Click here to add @Vatsal2005 to the team.
- If you initiated this build, request access.
- If you're already a member of the arudaev's projects team, make sure that your Vercel account is connected to your GitHub account.

Learn more about collaboration on Vercel and other options here.

[arudaev]

Parallax on chunks after the first lands off-screen (lane A, found while layering the Hidden Garden for #139/#142; I'm not pushing to this stack).

stageLayers gives every layer x = chunk.x * 2160, and drawStage then applies setScrollFactor(layer.scroll). A layer is drawn at screen x − camera.scrollX × scroll. So when the camera reaches chunk i (scrollX = i × 2160), a scroll-0.2 plate sits at i × 2160 × 0.8: chunk 1 at 1728 px, chunk 2 at 3456 px. Rusty Creek's 01-distance (0.2) on rc-1-0 and rc-2-0 is never on screen, and the sky disappears past the first chunk.

Suggested fix: place a layer at x = chunk.x × chunkWidth × scroll (same for y). At the chunk's left edge it then lines up exactly as drawn. With scroll < 1, neighbouring plates overlap by chunkWidth × (1 − scroll). Drawing them in chunk order is fine for sky and far scenery, and lane A will paint far plates that tolerate that overlap. A test: stageLayers for a chunk at x = 2 with scroll 0.2 gives x = 864.

The Hidden Garden is getting 00-sky 0.1, 01-far 0.25, 02-mid 0.6 and a 1.2 foreground (#142). It has a single chunk, so it's correct either way, but more chunks are coming.

[arudaev]

Correction to my comment above: no loader change is needed. Lane A now ships every layer that scrolls at ≠ 1 as one region-wide plate, quilted from the chunks' plates and cut into 2160 px tiles; tile j is listed on chunk j (#148). With x = chunk.x × 2160 and setScrollFactor(scroll), each tile then shows exactly its part of the plate. Your current stageLayers is right for that. Rusty Creek's per-chunk 0.2 / 1.1 / 1.15 layers still need the same treatment on my side; I'll do it next.