Repository navigation
v2.1.0
Fixed (source-level verification)
- Zero or absent DLC metadata no longer produces a zero AOC base. Use a matching carried
add-on's namespace or the conventional application DLC base; preserve non-zero metadata.
Populate the base in synthesized NUP control data too. Pin its NACP offset at0x3070.
Changed (UNVERIFIED - needs runtime test)
- Donkey Kong Bananza: log the returned base and the actual carried/requested IDs, and return
FS TargetNotFound for missing data storage. Reaching the menu is unverified. - Mario Kart World:
MemoryAllocator::AllocateSparseMemorytries a compatible non-local type
within budget after device-local exhaustion, before rolling back a sparse tile upload. The
GTX 1650 log recorded 213 failed tile allocations. No same-scene FPS measurement yet.
Known issues
- Donkey Kong Bananza reaching the menu is unverified at runtime.
- Mario Kart World same-scene frametime and 1% low are unverified. No FPS gain is claimed.
- The sparse allocation fallback may use slower non-local memory.
- Mario Kart 8 and other previously working titles were not re-tested.
Compatibility notes and credits
- Guest software can still abort on a missing required add-on. GPU paging and readback stalls
are still possible; no changes to frame generation, shader cache, JIT, or PGO profiles. - Thanks to Orchid, Lichii (both forks) and Eglantine PR #877 for DLC metadata precedents.
See the investigation and retest plan for evidence and limitations.
Veshiru is a Windows-exclusive emulator: it is built and tested for 64-bit Windows 10 and 11 only.
Extract the entire zip and run veshiru.exe, or veshiru-cmd.exe from a terminal.
| Build Type | Standard | PGO (Recommended) | Notes |
|---|---|---|---|
| amd64 / x86_64 | zip | PGO zip | Both built with clang-cl and ThinLTO; the PGO zip uses a balanced multi-game Switch 1 & Switch 2 profile |
The PGO build is compiled with profile-guided optimization using a balanced multi-game Switch 1 & Switch 2 runtime profile (veshiru-windows.profdata). Prefer it on modern x86_64 CPUs.