Skip to content

v2.1.0

Choose a tag to compare

@github-actions github-actions released this 20 Nov 08:58
· 45 commits to main since this release
451f273

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 at 0x3070.

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::AllocateSparseMemory tries 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.