Repository navigation
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/.nspRomFS scanning vianx_romfs_openandShaderKey.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 automaticcache/shader_seen.txtcaching 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-slotTXQlookups (0x120..0x158) viastage_tex_handle(), andstage_set()enforces validrscalevalues for compute shaders. SyncShader Mode by Default: changed defaultsync_shaderstoSHADER_SYNCfor zero visual pop-in in unseen areas whileshader_prephandles known shaders ahead of time (still switchable toSmartorAsyncin theF1menu).- RecompLauncher Integration:
recomplauncher.jsonis 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 limitset to60or120in theF1→ Display menu (running at144+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.AppImageOn 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