nxnative-easy/dm/games/010056B015FE8000/README.md

NieR:Automata The End of YoRHa Edition (010056B015FE8000)

Update 1.0.3 (v131072) over the base cartridge dump. PlatinumGames' engine, SDK 12.3.9, NVN, CRI CPK archives and Sofdec USM movies, Wwise audio through AudioOut. Modules main, subsdk0 (NintendoSDK_movie) and sdk. Mac startup, save creation/loading and opening flight gameplay pass; iPhone testing is pending.

What it needs

Setting	Where	Why
mem_reserve 0x140000000, mem_alias 0x118000000, mem_stack 0x10000000, app_pool 0xCD500000	game.tsv	5 GB guest block with a 4.375 GB alias region; the game maps its own memory there and never sets a heap during startup
sys_resource 0x1000000	game.tsv	the NPDM declares 16 MB of system resource, enabling virtual address memory
pad_layout full	game.tsv	movement and camera/aiming use both sticks
tex_flush_upload on	game.tsv	CPU-filled texture storage is published through mapped-range flushes; without uploads the title background is magenta
feedback_snap fd2c47b73f0e7e24	game.tsv	filter09.pso samples the HDR attachment it writes through separate texture slot 128; a snapshot prevents NaNs spreading through bloom
present_interval display	game.tsv	replaces the game's interval-two presentation target with 60 Hz; the native clock already measures elapsed time
gpu_timestamps segment	game.tsv	the renderer subtracts two raw timestamp reports; one timestamp for the whole submission makes its measured GPU cost zero
Four dynamic-resolution threshold cuts	patches.py	the verified 1.0.3 main build uses 22.5 / 16.005 / 15 ms thresholds for a 60 fps budget

Files and shaders

• 660 RomFS files, 10.84 GB: 30 CRI CPK archives (6.20 GB), 162 USM movies (3.52 GB), loose Wwise banks and streams, and Enlighten data.
• Resolved: the shader split found zero shaders. Five DAT archives in data000.cpk contain 1,371 size-delimited shader objects: 819 pixel, 517 vertex, 31 compute and four geometry objects, before deduplication. Every object has a 0x88-byte binding prefix, a length-prefixed NVN code area, then a length-prefixed 0x880-byte control section. All section bounds and control code lengths agree. They produce 1,225 distinct keys, including the initial runtime keys f2fd6cfd0ff14a18, 7855550732b71e48 and 62026f624061e259. The general reader is linked below.
• The full RomFS scan finds 451 distinct vertex, 739 pixel, 31 compute and four geometry shaders, with 902 single-stage cover pairs.
• Resolved: magenta title background. The render02 / flush01 route captures frame 1,200 with identical inputs; enabling tex_flush_upload alone changes the magenta pixel share from 91.8% to zero and restores the cream title background. TEXINFO also finds populated guest texture storage without packaged layouts (for example a 1024×1024 format 0x7d texture, 279,870 nonzero bytes of 704,512). No dirty-write tracking is enabled.
• Resolved: geometry shader compilation and binding failures. All four geometry objects use viewport-mask output in their generated raster reader. The reader's scalar/array mismatch, missing geometry storage-buffer table and incorrect write-flag interpretation are general chain/host fixes linked below. All 1,225 shaders build for Mac and iOS after these changes.
• Resolved: passthrough output bounds and raster emission. All four geometry objects set SPH GpPassthrough with a raw output bound of one. The earlier metadata underallocated the raw scratch/index region and read the wrong stride, while native passthrough support left compute raster output absent. The shared fixes derive bounds/output topology from input, explicitly emit positions and generic attributes, and preserve viewport-zero culling. Native canaries, compaction and real-translator GPU tests cover every topology and the full capture map. Rebuilt flight scenes render the ship models and effects.
• Resolved: green flight scene and dark rectangles. HDR targets contained sparse red/blue NaNs, most on 16-pixel seams; bloom spread them across both channels. filter09.pso (fd2c47b73f0e7e24) samples the HDR attachment it also writes, through a separate texture slot. The host's snapshot path skipped separate slots before its general fix. snap01 with the snapshot restores ship, cloud and exhaust colors; scans at frames 3,000, 3,060, 3,540 and 3,600 find no non-finite passes. Both default and active LUTs matched deswizzled guest storage byte-for-byte, ruling out their upload/layout. Enabling dirty-write tracking alone did not fix the green output and is left off.

Status on the Mac

• The title, menus, keyboard naming, a new Easy game with auto-chips, save creation and save loading pass. The opening formation cinematic and ocean combat render ships, clouds, lighting, exhaust, shots and HUD correctly. Left/right movement and firing respond to input (snap01_control_*, fps60_opt_*).
• Both logo movies decode through NintendoSDK_movie. The final 300-second run exits cleanly after the test's SIGTERM; Wwise output has zero underruns through 28,000 device callbacks. Resident memory peaks around 2,811 MB and Metal allocations around 2,995 MB, then settle below those peaks while the route streams more objects; its last report is 2,794 / 2,933 MB at frame 17,700.
• Resolved: repeated geometry drains and sorting. The original heavy flight route spent most sampled main-thread time waiting in mdi_wait, followed by sorting capture indices. The shared synchronization/bitset fix linked below removes those hotspots.
• Resolved: serial geometry prefix scan. A GPU profile of frame 4,600 in the 720p fps60_seg records 79 geometry sequences: 7.246 ms in their serial scans out of a 16.19 ms GPU span, with 521 encoders. The general parallel scan and combined compute encoder preserve ordered primitive compaction; native checks cover 129,032 groups and the translated geometry stages. The final 1080p route's frame 4,600 uses 284 encoders, 4.19 ms compute/copy and an 11.17 ms GPU span. The mode and camera timing differ, so these totals are supporting encoder evidence rather than an isolated same-frame speedup.
• Both standard NSP build workflows pass. The unsigned NieRAutomata.ipa is 11,712,290,740 bytes (about 10.9 GiB), with all 1,225 Mac/iOS shader libraries on chain 20fe3d62b9f6 and 331 recorded prewarm entries. Its four cuts and all three embedded main sections match the tested rewrite; all 3,551 archive entries pass CRC verification. The normal Mac executable is 010056B015FE8000_build/tools/dmhost.
• Work folder: /Volumes/T7/nsp/NieR Automata The End of YoRHa Edition/010056B015FE8000-work. run/boot.py <name> <seconds> [KEY=VALUE ...] runs the adjacent 010056B015FE8000_build/tools/dmhost with bounded duration, control file run/<name>.ctl, logs and save data beside it.

60 fps

Only main build 3c10ec35c5ef4c3686b4053afb0e58e7 gets the four cuts. They replace immediate constants at 0x9bf434, 0x9bf484, 0x9bf4d4 and 0x9bf4f8, with original-byte assertions, following the FPSLocker 1.0.3 threshold sites. No address is carried to another build and no function-matched cuts are enabled.

The native clock at main+0x8fc7a8 converts elapsed milliseconds to 60 Hz ticks and clamps each step to [1, 2]. It needs no clock rewrite. Probe main:8fc888@x19+b0 reads step, accumulator, scale and elapsed milliseconds. The paired title runs measure 33.34 ms / step 2 at the original target and 16.66 ms / step 1 at 60 Hz. Slow flight before the geometry fix clamps to step 2 and loses game time; raising the presentation target alone was insufficient.

The final M4 Pro run, fps60_final, uses the profile's default console mode (1920×1080), 60 Hz presentation, the four 1.0.3 cuts, the current shader chain, sound and native-clock/DR probes. No resolution reduction is required for this route:

Window after launch	Average fps	Frame p50 / p95	Average GPU time	Game seconds / wall second
80–110 s, heavy opening formation	59.79	16.67 / 17.99 ms	10.15 ms	1.011
120–150 s, flight transition	60.03	16.67 / 17.23 ms	10.99 ms	1.010
170–200 s, free flight	60.00	16.66 / 17.39 ms	10.93 ms	1.011
220–250 s, ocean combat	59.92	16.66 / 17.26 ms	10.06 ms	1.009

These are measured windows, not a full-game or iPhone frame-rate guarantee. The frame rate stays near 60 with occasional longer frames; the native clock's minimum-one-tick clamp gives about 1% timing bias with host jitter in these flight windows.

Reproduce the save-load route with DM_KEYS=40:A,45:A,50:A,52:Left,53:A,60:A, DM_PRESENT_LINK=0 and sound enabled. Headless timing runs unset DM_WINDOW. To compare the original presentation target, set DM_PRESENT_INTERVAL=game; display selects 60 Hz. DM_OPMODE=0 selects the game's native 720p handheld mode; 1 selects 1080p console mode.

Resolved: dynamic-resolution cost reads zero or 32 times too small. The renderer's producer at main+0x9ba6d4 waits for a ring fence, maps its counter buffer and subtracts timestamp fields at +8 and +0x18; its inline conversion publishes milliseconds through renderer +0x10c4. Submission timestamps gave zero. Segment timestamps need the shared raw-unit fix linked below: this consumer expects 614.4 MHz, while the host previously wrote 19.2 MHz. Both report paths and the nanosecond API now use the proper rate. The native scale floor is currently 1.0; its existing preset setter can select 0.7. No floor override is applied.

Found on this game

• Size-delimited PlatinumGames shader objects.
• Mapped-range flushes taken as uploads.
• Geometry reader viewport masks.
• Geometry-stage storage-buffer table.
• Storage-buffer write flag in translation metadata.
• Passthrough geometry output bounds follow input topology.
• Passthrough geometry kernels lose raster vertices.
• Same-pass feedback read through a snapshot.
• Geometry capture waits for every indexed draw.
• Geometry compaction serial prefix scan.
• Raw NVN timestamp units.
• GPU timestamps per submission segment.

Open

• Conditional rendering is still drawn unconditionally (SetRenderEnableConditional is the route's only [RED] warning); no visible fault was found from it in this route.
• Validate on an iPhone and test beyond the opening flight; full-game coverage is pending.