An ultra-bleeding-edge Switch 2 emulator fork — hundreds of commits ahead of upstream Eglantine.
⬇ Download Latest Build · What's Inside · Quick Start · Troubleshooting · Report a Bug
Warning
Bleeding-Edge & Not Fully Tested
This build sits ~500 commits ahead of upstream nx2-experimental. Fixes, GPU rewrites, and speed hacks land here the moment they work in local testing—long before full multi-game or multi-hardware QA.
- Tested primarily on a single rig (Windows 11 · Ryzen 9 9950X3D · RTX 5090).
- AI-assisted development (Claude / Gemini, disclosed via
Assisted-by:commit trailers) is used heavily to move fast. - Back up your saves before jumping in. Expect rough edges!
Eglantine on Crack includes 100% of upstream Eglantine plus hundreds of aggressive performance, rendering, and stability patches gathered from across the community and built in-house:
| Feature / Fix | What It Does |
|---|---|
| NVIDIA DLSS & DLAA | Native Streamline DLSS Super Resolution (Performance / Balanced / Quality) and DLAA with automatic 3D pass detection and zero-blur HUD compositing |
| 2x Frame Generation | Built-in FSR3 Frame Generation + high-refresh VRR frame pacing to push ~40 FPS gameplay to 80+ displayed FPS |
| Ocarina of Time Overhaul | Fixed terrain blotches, haze/fog, MME macro crashes, thumbnail capture, and real-time game speed below 60 FPS (OOT_STATE.md) |
| Shader Stutter Eliminator | Spreads background pipeline compilation across frames (cuts worst new-area freezes from 2.3 s → 0.6 s) |
| CPU & GPU Hot-Path Speedups | Trap-and-flush CPU reads, fast 4 KiB page-run lookups, SPSC GPU thread wakeups, and AMD X3D V-Cache CCD pinning |
| Mario Kart World & Wonder Fixes | Large-VRAM budget fix (53 → 58.7 FPS in MKW) and vi2 release fence fix (unlocks Wonder past 30 FPS) |
Your existing Eglantine setup carries over automatically:
- Back up your saves (
%APPDATA%\eglantine\nand\user\saveon Windows). - Download & extract the latest release from Releases into its own new folder (do not overwrite your upstream folder).
- Run
eglantine.exe— it shares%APPDATA%\eglantine, so your keys, firmware, games, mods, and saves work out of the box.
Tip
Using NVIDIA DLSS: Go to Emulation -> Configure -> Graphics, tick Enable NVIDIA DLSS, and pick your NVIDIA DLSS Quality (Performance, Balanced, Quality, or DLAA). Window Adapting Filter (Bilinear) and Anti-Aliasing (None) lock automatically so post-processing never blurs the DLSS output.
Every performance optimization in this fork is guarded by a runtime switch in src/video_core/nx2_perf.h:
- Disable all experimental speedups at once: Launch with environment variable
EDEN_NX2_PERF_OPT=0. - Switch back anytime: Just launch your original upstream
eglantine.exe(only the per-game shader cache will rebuild). - Report issues: Open an issue on this fork (never on upstream!) with your hardware specs and
%APPDATA%\eglantine\log\eden_log.txt.
git clone --recursive https://github.com/A-Man-With-A-Plan-dev/Eglantine.git- Build Guide: docs/Build.md
- Ocarina of Time Status & Benchmarks: OOT_STATE.md · OOT_CONTRIBUTING.md
- Upstream PR Candidates & Credits: UPSTREAM_CANDIDATES.md · CREDITS_OOT.md
- Policies: AI Policy · Coding Policy · GPLv3 License