Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/release-games.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
"title_id": "010015100B514000",
"game_version": "1.2.1",
"build_id": "FF773E90972D544EB79406EAA65396D53C43EFB9",
"layout_count": 124
"layout_count": 125
}
}
}
1 change: 1 addition & 0 deletions docs/aspect-ratio-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -294,6 +294,7 @@ Each of these was a real defect, either in generator output or in an early versi
| Player dies off-screen when a scripted event (a Wonder Flower) starts during an autoscroll | The fixed-camera target followed the player with no limit, so he outran the scroll; the event snapped the camera back | Ride the scroll exactly while it moves; pan within [0, 2Δ] only after it stops (Step 3) |
| Goal or item after an autoscroll stops remains just off-screen to the right | Autoscroll targets computed as rail + current half-width left-align the narrower view, so a symmetric ± Δ reach clamp leaves the right edge short | Clamp reach offset to [0, 2Δ] relative to that target, not ± Δ (Step 3) |
| A goal or item in a locked shaft or room stays just off-screen | The screen lock pins the camera to its 16:9 framing point | Let the locked camera pan within lock ± Δ (Step 3) |
| A secret at the side of a 3D map area (a hidden pipe or path) is off-screen | The area's camera is fixed on an authored look-at point (or held by a zero-width limit volume), so it never moves sideways and the narrower view crops what 16:9 showed at its edge | Move the look-at point towards the secret just far enough that it and the way back both stay in view (same-size float edit), or raise the camera distance to restore the 16:9 width. First confirm which area you're in: match several on-screen objects to the map data, and measure the screen scale rather than estimating it (SMBW World001 subregion 22: look-at x +4.0, confirmed in game) |
| A zoomed boss arena slides off its walls | A leftover Δ lets the lock-panning rule move a camera that already shows the whole frame | Δ = 0 in zoomed rooms; have the generator assert it |
| A water or fog tint stops at hard straight lines across a taller view | The tint is a fixed-size plane actor sized for the 16:9 view (it may follow the camera on one axis only), not a camera or culling box. Culling things outside the old view, or scaling a shared view box, only enforces the edge | Scale that actor in the level data (same-size float edit, built and verified from the original); first check that the game honours the scale (SMBW W4 Bowser Jr.: Scale Y 1.5, confirmed in game) |
| After a cutscene the camera sits higher than stock, and items spawned at the camera position (a boss's reward) appear out of reach | In an area taller than the view the camera rests on its bottom limit, area bottom + half the view height; a taller view raises that limit by the extra half-height | Pin the camera vertically with the fight zoom (SMBW cave Y). If pinning the taller view pushes the frustum bottom (`minY`) below the floor, clamp/restore `minY` in the camera bounding-box query (`GetCameraBoundBox2f`) so boss AI swim/move targets stay above the floor (SMBW cave K) |
Expand Down
7 changes: 4 additions & 3 deletions super-mario-bros-wonder/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@ Read the root [`../AGENTS.md`](../AGENTS.md) first. This file is the **source of

- Title ID `010015100B514000`, **version 1.2.1 only**, build ID `FF773E90972D544EB79406EAA65396D53C43EFB9`.
- Tested on Eden (yuzu family) with Graphics > Aspect Ratio > **Force 4:3**, on Windows (where agents can probe memory and take screenshots) and on the tester's Retroid Pocket Nova (Android). Other emulators and console are untested.
- Mod folder: `mod/Native 4x3 Aspect Ratio/` = `exefs/1.2.1.pchtxt` + `romfs/Layout/*.Nin_NX_NVN.blarc.zs` (115 changed archives) + `romfs/BancMapUnit/*.bcett.byml.zs` (9 stage edits: Course152_Sub4, Course411_Course, Course415_Course, Course417_Course, Course403_Course, Course400_Course, Course401_Course, Course408_Course, Course407_Course) + `README.txt` (ships with the mod; holds no install steps, only the link to `README.md#install`, the one install guide). Named "Nova Aspect Ratio 4x3 Native" before v1.0.0; don't rename it again.
- Mod folder: `mod/Native 4x3 Aspect Ratio/` = `exefs/1.2.1.pchtxt` + `romfs/Layout/*.Nin_NX_NVN.blarc.zs` (115 changed archives) + `romfs/BancMapUnit/*.bcett.byml.zs` (10 stage edits: Course152_Sub4, Course411_Course, Course415_Course, Course417_Course, Course403_Course, Course400_Course, Course401_Course, Course408_Course, Course407_Course, World001) + `README.txt` (ships with the mod; holds no install steps, only the link to `README.md#install`, the one install guide). Named "Nova Aspect Ratio 4x3 Native" before v1.0.0; don't rename it again.
- Installed for testing at `%APPDATA%\eden\load\010015100B514000\Native 4x3 Aspect Ratio`. Sync with the game closed: `robocopy "mod\Native 4x3 Aspect Ratio" "%APPDATA%\eden\load\010015100B514000\Native 4x3 Aspect Ratio" /MIR` (mirror: deletes archives the build no longer ships).
- Releases: tag prefix `smbw` (`.github/release-games.json`); procedure in the root AGENTS.md "Releasing". `layout_count` there counts every file under `romfs/` (115 layouts + 9 stage files = 124); bump it when that number changes.
- Releases: tag prefix `smbw` (`.github/release-games.json`); procedure in the root AGENTS.md "Releasing". `layout_count` there counts every file under `romfs/` (115 layouts + 10 stage files = 125); bump it when that number changes.

## Local inputs (outside the repo)

Expand Down Expand Up @@ -95,6 +95,7 @@ Shipped patch `exefs/1.2.1.pchtxt`: 11 hooks (`verify_pchtxt.py`). Includes area
8. `Course409_Main` (Break Time! Raise the Stage) is **stock and remains on the TODO list**; investigate the background/platform framing during a later play-test.
9. `Course401`, `Course404_Main`, and `Course407` have BOSS table entries at G = 20.6667, delta = 0.0. Course408 uses its stock-height CameraArea with X locked at 64.0 and Y-only `CreateTag` moves. The patch and verifier pass; all four are approved in Eden on 2026-11-07.
10. `Course407_Course` (Break Time! Watery Wonder Tokens), **approved in Eden on 2026-11-07**: revert `DVWaKaiganFarIwaA02`; adjust `DVWaKaiganFarIwaA01` (Hash `3373664933504165692`) from Translate $(23.5, 48.0, -167.5)$ / Scale $(0.7, 0.7, 0.7)$ to Translate $(23.5, 49.5, -167.5)$ / Scale $(0.82, 0.82, 0.82)$.
11. `World001` (Pipe-Rock Plateau world map), **confirmed in Eden (2026-11-09: the tester reached the lost Toad)**: subregion 22 (underground area: sign, ? block, courses 9/10, KO arena) has a fixed camera on `WorldMapCameraLookAtTag` obj479 (Hash 2929358336); its X moves 87.25 -> 91.25 so the hidden warp pipe obj513 (x 103, to the lost-Toad room) and Mario beside it are on screen (4:3 view about x 76.5-106.0; entry pipe obj29 kept). An earlier subregion 17 limit-area edit targeted the wrong area and was reverted. All nine world maps surveyed for fixed or boxed cameras cropping objects 16:9 showed (2026-11-09); only the World006 (Fungi Mines) pipe from Sunbaked Desert beside Captain Toad was a real candidate, and the tester checked it fine in game. Details: DEVELOPMENT.md section 46.


**Layouts (`build.py`, built from the 1.2.1 originals since 2026-10-30):** 115 of the game's 235 archives ship (114 changed top-level layouts incl. the 1.2.1-only `AmiiboReadWindow`, plus `LCursor`); the other 120 are unchanged and fall back to the game's copies. top-level RootPane scale y 0.75 (`ROOT_SY`); HUD/header/footer edge-anchored (+/-180 root-local units, TransY keys shifted too); full-screen layers grown x4/3 (captures and fades height only, artwork uniform); parts layouts untouched; curated per-screen tables `FORCE_SHIFT`, `NO_SHIFT_SUBTREE`, `NO_SHIFT_LAYOUT`, `NO_FILL`. 638 float writes, 46 fill panes, `verify.py` clean. Until 2026-10-30 the mod was built from won-aar's older cache and shipped all 234 archives, so 30 screens (incl. Pause, MainMenu, Title, CourseList, talk windows, button icons) carried pre-1.2.1 layouts; the 1.2.1 rebuild applies identical edits. **Play-tested after the 1.2.1 rebuild (2026-10-31): menus, HUD, pause, maps, transitions, course clear, cursor and amiibo look good.**
Expand Down Expand Up @@ -125,7 +126,7 @@ Shipped patch `exefs/1.2.1.pchtxt`: 11 hooks (`verify_pchtxt.py`). Includes area

Boss/fixed-room table (all delta 0): Course150_Sub4 607466214 G 21.0; Course151_Sub2 101336182, Course152_Sub4 1778226157, Course153_Sub3 1019598315, Course411_Course 1607468536, Course415_Course 3684305666, Course417_Course 2579434623, Course403_Course 177084102, Course008_Sub2 3214359175, Course400_Course 2214662437, Course401 1219170747, Course404_Main 1725897490, and Course407 2395215932 G 20.6667 (152's own zoom actor 17.5 multiplies the base); Course408 1474562704 uses G = 18.5, delta = 0.0 with its stock-height CameraArea and horizontal X lock. Course401, Course408, Course404, and Course407 are approved in Eden on 2026-11-07; Course409 is stock and remains on the TODO list. Course403, Course415 and Course417 visual framing is user-approved with gameplay checks still open. Course400 visual framing approved; Hoppo spawn elevation fix awaiting retry. Course411's earlier framing fix is user-confirmed; regression on the current build is not yet reported. Autoscroll end stops table (`TABLE_ENDS` after `BOSS`, surveyed by `scan_autoscroll_ends.py`): areas with intermediate pauses >= 120 frames (Course002_Main 885847797, Course022_Main 2740185052, Course062_Sub1 3839196513, Course102_Main 4167497323, Course290_Main 2931365200, Course857_Main 3856421716) mapped to rail end X + 13.7778; camera unlocks only when |fixed X + delta - key| <= 0.05. Optional lines commented after `@stop` (zone-lock disable, fixed zoom-outs 17-20) are not needed.

**Confirmed in game:** badge houses and one-screen rooms, pause/menu blur, course-entry iris, HUD and key glyphs vs stock, Select a User card, Poplin shop, kingdom map, Pipe-Rock Plateau Palace arena + pipes, wide-level base 15.75 (Outmaway Valley), airship autoscroll + Wonder Flower (Course101, re-checked with the [0, 2*delta] cave G on 2026-11-03), Piranha Plants on Parade (Course002_Main: camera stays locked during mid-scroll singing pause and unlocks at the final stop to reach the Wonder Seed, issue #1), Puffy Lifts seed (Course021), course-clear photo and View photo, menu pointer, Badge Challenge restart wipe, W4 Bowser Jr. (Course152_Sub4: water tint plane Scale Y 1.5, cave Y fight camera at 3.25, Royal Seed reachable, cave K swim AI, wall terrain to y = -10.0 for corner voids).
**Confirmed in game:** World001 underground area hidden warp pipe (subregion 22 look-at x 91.25), badge houses and one-screen rooms, pause/menu blur, course-entry iris, HUD and key glyphs vs stock, Select a User card, Poplin shop, kingdom map, Pipe-Rock Plateau Palace arena + pipes, wide-level base 15.75 (Outmaway Valley), airship autoscroll + Wonder Flower (Course101, re-checked with the [0, 2*delta] cave G on 2026-11-03), Piranha Plants on Parade (Course002_Main: camera stays locked during mid-scroll singing pause and unlocks at the final stop to reach the Wonder Seed, issue #1), Puffy Lifts seed (Course021), course-clear photo and View photo, menu pointer, Badge Challenge restart wipe, W4 Bowser Jr. (Course152_Sub4: water tint plane Scale Y 1.5, cave Y fight camera at 3.25, Royal Seed reachable, cave K swim AI, wall terrain to y = -10.0 for corner voids).

**Not yet checked in game:** Course061_Sub2 (Chase Killers) seed after its stopped autoscroll (x 595.0, rail end 570.75: the pre-fix reach was only 0.03 past it); Course857_Main short scroll stops (104 and 100 frames, under cave G's 120-frame hold, so a `CourseDisplayBoxSwitch` at x 211.5 fires later than stock); whether 151/153 also release their arena area after the cutscene; Course150 arena since its delta became 0; Bowser Jr. rooms 151-153 (extra height; alternate zoom path when subject+0x1BE != 0 bypasses caves B/F1); WipeTo*/WipeWarp; pits, level ends and Wonder zooms at 15.75; last boss and airship boss rooms; multiplayer; Android flashing bars (WipeCourseIn's kept-fill capture reads 180 rows past the frame).

Expand Down
17 changes: 17 additions & 0 deletions super-mario-bros-wonder/docs/DEVELOPMENT.md
Original file line number Diff line number Diff line change
Expand Up @@ -519,3 +519,20 @@ This supersedes §§38 and 41 for Course408. Rebuild and verification: `build_st
The maintainer play-tested the current build in Windows/Eden and approved Course401, Course404, Course407 and Course408. Course409 remains stock on the TODO list. Course408 is described in §42; Course401 keeps its 14 ice-block Y moves, Course407 keeps the A01 pillar translate/scale, and Course404 keeps its `Course404_Main` BOSS entry. Completion and retry were not separately reported for these four courses.

The mod now ships 124 romfs files (115 layouts + 9 stage archives). Patch SHA-256: `636492eb2b6a2bac8098d70f409aaf4b38ca1109d4ff3e842791e83e5962aadf`. Stage verification covers all nine stage files with 0 problems; `scripts/check_repo.py` passes.

## 46. 2026-11-09: World 1 map, hidden warp pipe off-screen (World001 subregion 22 look-at moved)

**Report:** on the Pipe-Rock Plateau map, an area with a sign, a ? block, two course nodes and the KO arena hides a warp pipe behind the right-hand rock wall (it leads to the room with the lost Toad, "Lost? Me?"). At 4:3 the pipe and Mario's silhouette next to it are off-screen.

**First attempt (wrong area, reverted):** I matched the reference screenshot to subregion 17 (sign, ? block bonus, Badge Challenge, warp pipe obj548) and widened its `WorldMapCameraLimitArea` (Hash 1601100441) from Scale X 0.0 to 6.5. The tester saw no change. Eden's log confirmed the mod was loaded (IPSwitch patch and LayeredFS applied at a boot after the sync), and an Eden capture showed the camera exactly where it is in stock. Two things gave the mistake away. The on-screen layout didn't fit subregion 17's positions. And the screen scale was about 48 px per unit, not the ~72 my "±13 units" estimate implied. The level loader (`0x13785C`) does build that box as Translate ± Scale/2 and registers it per subregion (`0x5C7018`), so the edit itself was valid; it was just in the wrong area.

**Cause:** the area is subregion 22 (the underground part of the map; `WorldMapInfo` SubregionId22: Distance 80, Tilt 20, `IsFreeMove`). Its sign (84, z 20), ? block (88.5, z 24.5), courses 9 (83.5, z 41) and 10 (96.5, z 27.25) and KO arena (93, z 40.5) match the screen. Its camera is fixed on `WorldMapCameraLookAtTag` obj479 (Hash 2929358336) at (87.25, -11.0, 24.5) and never follows Mario. Measured from the stock screenshot and the Eden capture (both about 1060 rows): at the look-at depth the view is about 48 px per unit, so 16:9 shows x 67.6 to 106.9 and 4:3 about 72.5 to 102.0. The hidden pipe obj513 (`WObjSavannaHeigenDokanIdoTateA`) is at (103, -11, 22), with Mario's silhouette at about 104.5, both off the 4:3 right edge.

**Fix (`EDITS`):** look-at X 87.25 -> 91.25 (+4.0). The 4:3 view becomes about 76.5 to 106.0: Mario at the hidden pipe has about 1.5 units of margin, and the entry pipe obj29 (horizontal, opening at about x 78.5 on screen) keeps about 2. This crops more of the poison swamp on the left than stock, and nothing that can be interacted with is there. A larger subregion `Distance` in `Stage/WorldMapInfo` (about 107+) would restore the whole 16:9 width instead, but that file isn't covered by `build_stage.py` and would also show more above and below.

**Status:** built; `build_stage.py --verify` 0 problems (World001: 1 byte inside 1 edit; the other stage files are byte-identical to the shipped ones), `check_repo.py` OK. **Confirmed in Eden on 2026-11-09:** the tester saw Mario at the hidden pipe and reached the lost Toad.

**Survey of the other world maps (2026-11-09):** a throwaway script went through every `World0*.bcett` with its `WorldMapInfo` camera settings. For each subregion with a `WorldMapCameraLookAtTag` (fixed camera) or `WorldMapCameraLimitArea` (camera clamped to a box), it projected every map object with the scale calibrated above (half-height = 0.138 x Distance at the look-at depth, corrected for depth and pan) and listed objects inside the 16:9 half-width but outside the 4:3 one. Subregions where the camera follows Mario freely were skipped, as was the tilt when it isn't set (20 assumed). On the original data it flags World001 subregion 22's pipe at 1.6 units short, which matches what the tester saw. The other results:
- World006 (Fungi Mines) subregion 13: the warp pipe obj1027 to Sunbaked Desert, beside Captain Toad (fixed look-at, Distance 100, pan +22). It was 2.3 units short under one pan sign and visible under the other; the course nodes in panned subregions fit either way, so they can't tell the signs apart. **Checked in game by the tester: fine**, so no edit.
- World005 (Sunbaked Desert) subregion 10: an open gate (obj9) at most half cut off at the left edge, under one pan sign only. It's on a fixed path and gets walked through, so it was left alone.
- Hidden coin triggers (`WorldMapCoinAppearArea`): World001 subregion 17 obj621 sits at the left edge in both aspect ratios; World001 subregion 22 obj624 was 2.1 units short with the stock look-at and is in view with the moved one.
Binary file not shown.
8 changes: 8 additions & 0 deletions super-mario-bros-wonder/tools/build_stage.py
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,14 @@
(23.5, 48.0, -167.5), (23.5, 49.5, -167.5)),
('Course407_Course', 3373664933504165692, 'DVWaKaiganFarIwaA01', 'Scale',
(0.699999988079071, 0.699999988079071, 0.699999988079071), (0.82, 0.82, 0.82)),
# World001 (Pipe-Rock Plateau map), subregion 22 (underground area: sign, ? block, courses 9 and 10, KO arena):
# the camera is fixed on WorldMapCameraLookAtTag obj479 at x 87.25 and never follows Mario. At that depth the
# view is ~48 px per unit at ~1060 rows: 16:9 shows x ~67.6-106.9, 4:3 only ~72.5-102.0, so the hidden warp
# pipe obj513 (x 103, to the lost-Toad room) and Mario's silhouette beside it (~104.5) were off the right edge.
# Look-at x +4.0 -> 91.25 shows ~76.5-106.0: pipe and Mario on screen, entry pipe obj29 (opening ~78.5) kept.
# Confirmed in Eden 2026-11-09.
('World001', 2929358336, 'WorldMapCameraLookAtTag', 'Translate',
(87.25, -11.0, 24.5), (91.25, -11.0, 24.5)),
]

# (course, actor hashes, original Gyaml, replacement Gyaml). Both variants have matching static-map/physics
Expand Down