Changes since build 316
Built from the all-in-one test build 10 (test/all-in-one-10 at 9c9a1df), which testers and the maintainer ran before release: nx2 6b34d6e plus every fix that was waiting for testers. These fixes are landing in nx2 now.
Big points
- Far fewer shader freezes, in every game. Async shaders are now on by default with a short 8 ms wait (Bounded); choices you set yourself are kept (#2105). Compute shaders that are still compiling no longer stall the game when the screen already has an earlier result (#2104). On NVIDIA, compute shaders compile much faster (#2103), and a shader the game is waiting on no longer queues behind other builds (#2098). The pipeline cache is written safely, and a cache the driver rejects starts fresh (#2100). The second launch of the same build is almost freeze-free.
- Cyberpunk 2077: all 64 shaders that were rejected now translate (NVN2 root tables, surface atomics, TLD.B.LL/TXQ, USHF/REDUX/LDG) (#2089, #2090, #2093, #2094).
- Ocarina of Time: text speed add-ons, 2x, 4x or instant (#1422); smoother unlocked frame rates on the host display (#2028); FSR keeps working in handheld with Max Resolution and dynamic resolution (#2039, #2072); fewer upload hitches on Windows (#2043).
- Switch 2 Pro Controller support (#2046).
Graphics
- Star Fox: the Venom mission floor is back (#2047).
- Link's Awakening: no more fine dark stripes on round surfaces above 1x (#2057).
- Donkey Kong Bananza: I2M uploads use Switch 2 native tiling (#2085).
- Breath of the Wild: textures are written back to the right address space (#2063, #2062).
- Fire Emblem / The Duskbloods: GPU-written overlapping textures are written back instead of dropped (#1501).
- Mesh pipelines that fail no longer lend vertex inputs (#2022).
- Switch Sports Resort: Power Cruising water no longer renders black (#2074).
- Orbitals: a skipped compute shader now runs (#2083).
- macOS: cheaper occlusion queries on Apple GPUs (#2044).
Performance
- Fire Emblem: Fortune's Weave crowded battles run much faster (AMD tester: 24-35 fps to 30-50 fps) (#2037).
- Compute read-backs reuse their staging memory (#2078).
Stability
- Fixed a race that could crash Ocarina of Time when two threads touched the same new memory page (#2041).
- Syncpoint notifications are re-armed, code-page invalidation and multi-range buffer retirement fixed (#2052, #2053, #2054).
- Final Fantasy Resonance: fixed a rare crash in long video cutscenes (#2070).
- Very large shader caches are read in pieces, fixing a crash on load (#2110).
Online (Nextendo)
- Windows: sockets opened with the default protocol connect again (#2058).
- Only IPv4 connections are redirected to the Gamesync server, so IPv6 no longer breaks (#2065).
- Deleting a user profile also signs out its Nextendo account, and Lichii offers to clean up sign-ins left by build 316 (#2073).
- Host redirect for local server testing: several hosts, local sign-in tokens on localhost only, optional user-supplied patches (#2086).
Files and tools
- Solid NSZ games no longer read empty data after the disk fills up (#2031); scanning before keys are installed no longer floods the log (#2061); the DLC and update list refreshes after you change content (#2095).
- Bug reports (Ctrl+F12) include compressed textures and every mip level (#2048). New diagnostics: RADV_DEBUG=hang reports (#2050), unmapped-read provenance (#2055), EDEN_NX2_FAULT_MAP=1 names what a GPU fault address belonged to (#2097), driver build times in the log (#2099).
Known issues
- macOS: Ocarina of Time in handheld with Max Resolution and FSR can show a bright white or rainbow glare around lights.
- Kirby Air Riders can lose the GPU device after a few minutes on some NVIDIA cards (also on 316). If it happens to you, play with EDEN_NX2_FAULT_MAP=1 and send the log.
Only download Lichii from this releases page. Report bugs with Help → Report a Bug (Ctrl+F12) and share the zip privately; it holds game data.
Linux
Linux packages come as an AppImage and a tar.gz. Both are self-contained and need glibc 2.39 or newer (Ubuntu 24.04, Fedora 40, Debian 13, Arch). The tar.gz holds the same files unpacked, for systems without FUSE: extract it and run lichii/lichii.
| Build Type | Standard | PGO (Recommended) | Notes |
|---|---|---|---|
| amd64 | AppImage · tar.gz | AppImage · tar.gz | Make the AppImage executable (chmod +x) and run it
|
| ARM (aarch64) | AppImage · tar.gz | AppImage · tar.gz |
Windows
Windows packages are in-place zip files: extract and run lichii.exe, or eden-cli.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 adds a profile trained on Ocarina of Time |
macOS
| Build Type | Standard | PGO (Recommended) | Notes |
|---|---|---|---|
| arm64 (Apple Silicon) | zip | macOS 15 or newer. Not notarized: right-click and choose Open the first time, or run xattr -dr com.apple.quarantine lichii.app. eden-cli is inside the app, in Contents/MacOS
|
The PGO builds are the same programs compiled with profile-guided optimization. Linux uses clang with Eglantine's profile; Windows uses clang-cl and ThinLTO with a profile trained in Lichii on Ocarina of Time, so other games gain less. Prefer them when your CPU supports it.