Skip to content

EoWRecomp v0.5.0

Latest

Choose a tag to compare

@github-actions github-actions released this 20 Nov 05:20

EoWRecomp v0.5.0

Important

Linux x86-64 (Vulkan) is the actively tested target in this fork. Windows x64 builds are generated automatically via GitHub Actions (untested locally), and macOS / Android builds inherited from upstream are untested.

Warning

No game files or keys are included. You must provide your own legally obtained copy of The Legend of Zelda: Echoes of Wisdom v1.0.0 (Title ID 01008CF01BAAC000, .nsp or .xci) and prod.keys.

What's New in v0.5.0

  • Ahead-of-Time Shader Preparation (shader_prep): ported from LASRecomp and adapted for EoW (direct .xci/.nsp RomFS scanning via nx_romfs_open and ShaderKey.stencil_tex). Pre-translates and builds 1,173+ known shader variants on the start screen from your own game files (only one-way hashes and NVN state ship in the repo), plus automatic cache/shader_seen.txt caching for newly encountered variants.
  • Dynamic Cubemap / IBL Lighting Fix: fixed a bug where ambient lighting and metallic reflections (e.g., Hyrule Castle courtyard / guards' helmets) dropped to pure black when transitioning between static and compute-generated cubemaps. texture_info() / shader_texture_object() now resolve image-slot TXQ lookups (0x120..0x158) via stage_tex_handle(), and stage_set() enforces valid rscale values for compute shaders.
  • Sync Shader Mode by Default: changed default sync_shaders to SHADER_SYNC for zero visual pop-in in unseen areas while shader_prep handles known shaders ahead of time (still switchable to Smart or Async in the F1 menu).
  • RecompLauncher Integration: recomplauncher.json is included in the release assets for RecompLauncher.

Current Progress (Tested on Linux x86-64 / RADV)

  • Most of the overworld explored smoothly without issues alongside story progression through the 2nd dungeon (Gerudo Desert): intro, Hyrule Castle Town, Suthorn Village, Still World (Rifts), 2D sections, 1st dungeon, and Gerudo Desert dungeon with audio, working save/load, and zero freezes.

Known Issues

  • Map screen >120 FPS: keep FPS limit set to 60 or 120 in the F1 → Display menu (running at 144+ FPS currently inverts the analog stick on the map screen).
  • Untested platforms: Windows x64 (EoWRecomp-v0.5.0-windows-x86_64.zip) is cross-built via CI and has not been validated on a Windows machine yet.

Quick Start (Linux AppImage)

chmod +x EoWRecomp-v0.5.0-linux-x86_64.AppImage
./EoWRecomp-v0.5.0-linux-x86_64.AppImage

On first launch, select the folder containing your .nsp/.xci and prod.keys. EoWRecomp will extract ExeFS, compile eowgame.so locally, and prepare the shader cache.

Full Changelog: v0.4.0...v0.5.0