Skip to content

v0.2.2 - Metroid startup diagnostics

Choose a tag to compare

@mstan mstan released this 19 Oct 15:37
294e096

Windows startup diagnostics are now automatic, starting before the launcher opens. After reproducing a failure, send the diagnostics folder beside the executable, including the timestamped .log and matching .dmp if created. Read-only installations fall back to %LOCALAPPDATA%\NESRecomp\diagnostics. Nothing uploads automatically.

If the executable cannot start at all, run Collect-Diagnostics.cmd from the extracted folder and send its diagnostics output. This also records loader exit codes, GPU driver details and stdout/stderr before the game can create its own log. See DIAGNOSTICS.md in the ZIP.

Fixed packaging: include the required Microsoft C++ runtime DLLs. The previous Windows ZIP relied on the VC redistributable already being installed; missing runtimes can prevent startup before the launcher.

Validation: clean-extraction launcher and real Play-to-game startup; exact previous-release and interpreter hashes/picture over a 900-frame gameplay route; runtime dependency inventory; matching retained crash-analysis symbols; missing-ROM logging; actual pre-main DLL-loader failure collection; LOCALAPPDATA fallback. Windows crash-handler drills include access violation, abort, stack overflow, and a fault before launcher initialization. The reporter's specific crash was not reproduced on this host.

Windows x64, USA/shared NTSC ROM required. No ROM, player settings/saves or generated diagnostic files are included. Normal audio defaults and existing renderer/mod defaults are retained.

Source: 294e096bce8acb8ab5508f3fffeced56cb53dc23. Changes: #2.