seedds
ed3007f1ef
HAL Laboratory's engine on NintendoWare, SDK 11.4.0, NVN. Plays on the Mac at 30 fps, as on the Switch: online and difficulty prompts, the 1080p opening movie, Point of Arrival with its guide movies, the city reveal, the Sword ability and fights, title and Continue; a 15-minute soak with no crash. No game code is cut; the profile is the memory layout and the shader groups. All 27,297 shaders build for Mac and iOS; the IPA (6.4 GB) is untested on a device. - Threads (general): a guest thread waiting for a host lock that HLE code holds while it runs guest code is blocked, not runnable (dm_host_lock, a native HLE wait). The movie decoder held its decode lock across SignalEvent; the signal's same-core handoff waited for the movie input thread, which waited for that lock, and the game froze at its first guide movie. t_preempt has the case. Docs: the game note, games table, README gallery, threads.md, shaders.md, symptom index; AGENTS count 73 -> 74. Checked: host tests, preempt, tool tests (253, 15 skips), docs tests; a Mac run on chain 5cddc47253ab through the first guide movie.
Kirby and the Forgotten Land (01004D300C5AE000)
Update 1.1.0 (v65536) over the base game, SDK 11.4.0. HAL Laboratory's own engine on NintendoWare (G3d, Font, Fxt) with nn::atk2 sound and NEX online. Modules main, subsdk0 (NintendoSDK_movie 11.4.0) and sdk; no other profile ships these sdk and subsdk0 builds. Plays on the Mac at 30 fps, as on the Switch: the online and difficulty prompts, the 1080p opening movie, the beach and the walk through Point of Arrival with its guide movies, the reveal of the city, inhaling a Blade Knight for the Sword ability, fights with Awoofies and Bronto Burts, the title screen and continuing a file. An unsigned IPA is built; iOS is untested.
What it needs
| Setting | Where | Why |
|---|---|---|
4 GB block: mem_reserve 0x100000000, mem_alias 0x10000000, mem_stack 0x10000000, app_pool 0xCD500000 |
game.tsv |
no system resource; 256 MB in front + 256 MB alias region + 256 MB stack region + 3.25 GB heap region. See Memory |
modules main subsdk0 sdk |
game.tsv |
subsdk0 is the movie library: the opening and ending movies and the guide movies |
shader_groups /gfx/=gfx /ptcl/=ptcl /lyt/=lyt /shader/=shader |
game.tsv |
the shaders are BNSH archives in HAL's .cmp containers; see Files and shaders |
No code of the game is cut, and no run-time key is set. The game asks for present interval 1 and paces itself at 30 fps.
Memory
- The NPDM declares no system resource, so there is no virtual address memory: the game sets a heap of the pool less the used memory, 3.14 GB (
[mem] heap 3.14 GB (heap region 3.25 GB)), which the 3.25 GB heap region holds. - Current: 4.1 GB resident and 2.67 GB of Metal allocations on the Mac after 20 minutes in Point of Arrival (
footprint: 2.6 GB untagged, the guest memory the game touches; 0.7 GB graphics; 0.6 GB large host mallocs). It grew with each new area (3.2 GB at the beach, 3.97 GB at the city) and then stayed nearly flat, 4.13 → 4.17 GB with Metal allocations steady at 2.67 GB, over a 15-minute soak in one area. The highest resident figure of the games so far; how much a phone allows is open.
Files and shaders
- RomFS: 9,386 files, 5.72 GB. 7,201
.cmpand 430.cmpbincontainers (HAL's size-prefixed zstd and LZ4 frames), 52.bfstmand 104.opusstreams, 36 WebM movies (mov/EventMovie,mov/GuideMovie). - 27,297 shaders in the map (18,460 pixel, 8,755 vertex, 72 compute, 10 geometry): 18,476 in
gfx/, 8,313 inptcl/(70 of them compute), 387 inlyt/, 67 in the looseshader/files and 54 in BNSH archives embedded inmain. Before the split opened the.cmpcontainers it found 121 (HAL's.cmpcontainers). All of them built for the Mac without a failure, and no run met a shader missing from the map (shader keys not in the shader map … 0).
Rendering
- Current, harmless:
[RED] texture type mismatch: shader … declares slot 1 / 2 as Metal type 2, texture ID … is type 7 (NVN target 2, format 0x38 …); bound as is, once per shader, for eight UI layout pixel shaders so far (lyt/TitleMenu,lyt/Resident/TitleLogo,lyt/Cmn/HeroPanel,lyt/Step/ScopeCine,lyt/Arena/Entry). The texture is a 16×16×16 RGBA8 sRGB 3D texture, one of the colour-grading lookup tables (texlist 2), left in slots the layout material does not use: the layout shader samples slots 1 and 2 only when its uniformc3[0].yis non-zero.
Movies
- The SDK's demuxer (libwebm in
subsdk0) runs natively; the host decodes VP9 with libvpx and Vorbis with stb_vorbis into the game's CPU buffers (NV12, mode 1). The opening movie is 1920×1080 VP9 with a Vorbis track (2,297 frames); the guide movies that show a move in a corner of the screen are 480×270 VP9 without sound. - Resolved: the game froze at the first guide movie ("A Jump", on the first walk from the beach, every time). A job worker (priority 46) returning an output buffer signalled the movie's events while the host decoder held its decode lock; the signal handed core 0 to the movie threads (priority 44), and the input thread among them was waiting for that lock in host code, which the handoff counted as running (A host lock held across a same-core handoff).
Frame rate
- Current: 30 fps on the Mac, as on the Switch (
powerlines: 28–30 fps; frame interval p99 33.6 ms in play). The game sets present interval 1 and paces its frames itself. CPU about one core and 5–5.6 W on an Apple M6 in Point of Arrival.
Audio
nn::atk2through an audio renderer (96 voices, 14 effects, one sink). 131,543 of the first 132,000 rendered frames were not silent.
Mac routes
- Build with
scripts/build_ipa_from_nsp.py <NSP folder> -k <prod.keys> --platform mac; its last line runs the game. - A fresh save, through
DM_CTL: the online prompt is up about 20 s after boot:Left,A(Do Not Use),A; the difficulty:Right,A(Spring-Breeze Mode). The game saves here, then plays the opening movie and the beach scene (about 75 s) and gives control on the beach. - With that save, the title shows Continue about 25 s after boot;
Aputs Kirby on the beach. Forward (LUp) leads to the first guide movie in about 15 s; the path then turns right past a rock, crosses a ravine under a plank (float up on the right withA) and runs forward between trees to the city reveal, then right past the building's base to the first Blade Knight. - A
DM_CTLpress replaces the one being held: send the next key only after the hold ends.
Testing
- 2026-10-26, Mac: boot, the online and difficulty prompts, the opening movie, the beach, Point of Arrival with three guide movies, the city reveal, inhaling a Blade Knight (Sword), fighting with the Sword, losing it to damage, the title screen and Continue, over five runs (the longest 30 minutes, with a 15-minute soak of walking, jumping, floating, inhaling and attacking, no crash). The only red lines were the layout shaders' texture type mismatches; a key dump of the title menu's shader (
DM_NVN_KEYDUMP=5de6e5dc52a56300) showsc3[0].y= 0, so its reads of slots 1 and 2 do not run.
Open
- The rest of the game is untested on the Mac: no stage was finished, so no Waddle Dee Town, boss or Mouthful Mode yet, and no save at a stage's end.
- iOS: the unsigned IPA (
KirbyAndTheForgottenLand.ipa, 6.4 GB, 6,846,727,151 bytes, with the fps counter; 27,297 iOS shader libraries, no pipeline archive) is untested on a device; its memory (4.1 GB resident on the Mac) may be the first limit there, above the 3.4 GB iOS gives an app without the Increased Memory Limit capability.