BelmanteGu/SuperMarioWonderRecomp

选用指南

AI 根据 README 整理 · 2026/10/19 16:51:29

使用方式

通过命令行工具构建和运行，支持多种环境变量配置，如语言、分辨率、帧率等。

查看 README 依据

```sh cmake -S . -B private/wonder/build -G Ninja -DNX_GAME=wonder -DCMAKE_BUILD_TYPE=Release ninja -C private/wonder/build -j6 wonder ``` 6. **Run:** ```sh NX_LOG=private/wonder/nx.log private/wonder/build/wonder ``` It plays with a gamepad (SDL) or the keyboard. Useful switches: | Switch | What it does | |---|---| | `NX_MEM_LIMIT_GB=<n>` | memory guard, ends the process past this footprint (default 8) |

| `NX_LANGUAGE=<code>` | the game's language, as the console spells it: `es`, `es-419`, `en-US`, `en-GB`, `fr`, `fr-CA`, `de`, `it`, `nl`, `pt`, `pt-BR`, `ru`, `ja`, `ko`, `zh-Hans`, `zh-Hant` (`es-ES` and other ISO names are accepted as aliases). Falls back to `<data root>/language.txt`, else `en-US` | | `NX_HEADLESS=1` | no window, for unattended test runs | | `NX_MUTE=1` | no sound | | `NX_HANDHELD=1` | handheld mode, 720p | | `NX_PIPELINED=0` | waits for every submit, as before 60 fps (diagnosis); integrated GPUs pipeline by default |

部署要求

需要用户自行转储的《超级马力欧兄弟 惊奇》1.0.0 版本游戏文件、密钥和固件，且不提供获取方法。

查看 README 依据

calls (NVN, Nintendo's own API) are implemented natively on **Vulkan** (MoltenVK on the Mac). Part of the [SwitchGamesRecomp](https://github.com/BelmanteGu/SwitchGamesRecomp) work (same runtime, see [docs/FRAMEWORK.md](docs/FRAMEWORK.md)); this repo follows Wonder alone. Living log: [PROGRESS.md](PROGRESS.md). > [!NOTE] > **No game files are included.** This repository holds no game code, assets, keys or firmware, and no build > made from them. Everything derived from the game stays in `private/` (gitignored). You need your own legally

> dumped copy of Wonder 1.0.0, plus your own keys and firmware. Instructions on how to obtain them are **not** > provided. > [!IMPORTANT] > **This project was made with a lot of AI and a lot of study.** Most of the code, tooling and documentation was > written with AI assistance (Anthropic's Claude), directed, tested and reviewed by a human who spent a great deal of > time studying the Switch's CPU, OS and graphics stack (AArch64, NVN, Maxwell shaders, Vulkan) to guide it. If you > don't agree with the use of AI or don't trust AI-written code, that is your right; you run the code at your own

已知限制

目前存在窗口化拉伸时帧率下降、Android 上内存压力、Windows 上角色选择后崩溃、超宽屏 HUD 未锚定等问题，且不支持超过 60 帧。

查看 README 依据

- **Dump used:** Super Mario Bros. Wonder **1.0.0**, base game, no update, from an XCI of 3,769,099,776 bytes (SHA-256 and the rest in [docs/WONDER-DUMP.md](docs/WONDER-DUMP.md)). Other versions are not supported. ### Open The details are in the GitHub milestones. - **Windowed stretches at 35-40 fps (#51):** the GPU goes past the frame budget only when a window is visible. - **Windowed confirmation of the W7 glitch fixes (#43-#45, #47):** horizon band, silhouettes, present mode. - **Character-select blur:** needs a reference from a real console.

- **Android rendering bugs and performance:** hand-off notes in [docs/nvn/android-perf/](docs/nvn/android-perf/). - **Android: memory pressure on the Galaxy S23.** In the course the CPU replay reaches 17-18 ms because Android pushes up to 1.8 GB of the game to zram (major faults on the render thread); the GPU waits only 0.1-2 ms. Measured in [docs/nvn/android-perf/MEMORY-1810.md](docs/nvn/android-perf/MEMORY-1810.md), with the plan. The new-shader hitches have a first fix (below); neither change has run on a phone yet.

- **Windows: crash after character select (#5):** not reproduced on Linux; the crash is a rail object whose parameter resource was not found (analysis in [docs/nvn/DEBUG-2.md](docs/nvn/DEBUG-2.md), entry #93). Crash reports now end with the last files the game opened, to find the missing one. - **Ultrawide:** HUD not anchored to the screen edges, menu backdrops leave side bands, restart after resizing. - **Above 60 fps:** the game steps once per frame, so a faster vsync speeds the game up; no real unlock yet.