Installation und Fehlerbehebung

Lichii Emulator einrichten und Fehler beheben

Vom frischen Download bis zum ersten Start. Richte die Steuerung ein, füge deine Spiele hinzu und behebe Probleme, die dich am Start hindern.

Nach Fehlern suchen Offiziellen Build auswählen

Spielekompatibilität prüfen

Abnehmbare Controller, USB-C-Anschlüsse und eine illustrative Ansicht der Tastenbelegung beim Einrichten des Lichii Emulators — Illustration · Einrichtung des Lichii Emulators

Latest recorded build build-94 Pre-release Published November 7, 2026

Choose a download Release notes

Drei Plattformen

So installierst du den Lichii Emulator

Wähle deine Plattform für eine Schritt-für-Schritt-Anleitung.

Lichii unter Windows einrichten

Lade die aktuellen Windows-Dateien (lichii-windows-x86_64.zip (x86_64)) aus dem offiziellen Release build-94 herunter und behalte die Originaldateinamen bei.
Entpacke das Archiv in einen Ordner, in dem du Schreibrechte hast. Starte keine ausführbare Datei direkt aus dem komprimierten Archiv.
Starte lichii.exe aus dem entpackten Ordner. Zeigt Windows eine Sicherheitsabfrage, prüfe vor dem Fortfahren, ob die Datei über den offiziellen Release-Link heruntergeladen wurde.

Hinweise zum Release

On Windows hybrid Intel CPUs with P/E cores, time-critical threads stay on performance cores by default; set EDEN_HYBRID_CORES=0 to turn this off.

Brauchst du ein anderes Paket? Downloads für windows ansehen.

Lichii unter Linux einrichten

Wähle aus den veröffentlichten Linux-Dateien (lichii-linux-aarch64.AppImage (arm64), lichii-linux-aarch64.tar.gz (arm64), lichii-linux-x86_64.AppImage (x86_64), lichii-linux-x86_64.tar.gz (x86_64)) diejenige, deren Architektur zu deinem System passt, und lade sie aus dem verlinkten Release herunter.
Führe für lichii-linux-aarch64.AppImage im Downloadordner chmod +x 'lichii-linux-aarch64.AppImage' aus und starte dann die AppImage.
Entpacke lichii-linux-aarch64.tar.gz und starte die enthaltene ausführbare Datei aus dem entpackten Ordner. Wird eine fehlende glibc- oder Qt-Abhängigkeit gemeldet, prüfe in den Release-Hinweisen und im zugehörigen Issue, welche Version benötigt wird.
Bewahre die Release-URL und den Build-Tag zusammen mit der installierten Datei auf. So kannst du spätere Kompatibilitätsergebnisse demselben Build zuordnen.

Hinweise zum Release

Linux AppImages require glibc 2.39 or newer.
Linux tar.gz packages use system libraries and require Qt 6 and the usual runtime libraries.

Brauchst du ein anderes Paket? Downloads für linux ansehen.

Lichii unter macOS einrichten

Wähle aus den veröffentlichten macOS-Dateien (lichii-macos-arm64.dmg (arm64), lichii-macos-arm64.zip (arm64)) diejenige, deren Architektur zu deinem System passt, und lade sie aus dem verlinkten Release herunter.
Öffne die DMG-Datei lichii-macos-arm64.dmg und verschiebe die Anwendung in einen Ordner, auf den du Zugriff hast, etwa „Programme“.
Öffne die ZIP-Datei lichii-macos-arm64.zip und verschiebe die Anwendung in einen Ordner, auf den du Zugriff hast. Fragt macOS beim ersten Start nach einer Bestätigung, klicke mit der rechten Maustaste auf die Anwendung und wähle „Öffnen“.
Zeigt macOS eine Sicherheitswarnung, gleiche den Download vor dem Fortfahren mit dem offiziellen Release ab. Lass die üblichen Systemschutzfunktionen aktiviert.
Starte Lichii aus dem gewählten Anwendungsordner.

Hinweise zum Release

The macOS build requires macOS 15 or newer.

Brauchst du ein anderes Paket? Downloads für macos ansehen.

Erster Start

Ersteinrichtung

Richte Lichii beim ersten Start nach deinen Wünschen ein, mit einer passenden Controller-Belegung, den richtigen Grafikeinstellungen und deiner eigenen Spielebibliothek.

Grafik

Beginne mit den Grafikeinstellungen aus den Release-Hinweisen deines Builds. Ändere jeweils nur eine Einstellung und notiere bei jedem Testergebnis den Build-Tag.

Als Ausgangspunkt für ein bestimmtes Spiel dient dessen Kompatibilitätsbericht.

Eingabegeräte

Schließe deinen Controller an, belege die Tasten und speichere das Profil. Wenn eine Taste nicht funktioniert, suche in der Fehlerbehebung nach deinem Controller-Modell und deinem Lichii-Build.

Deine Spieldateien

Füge deine legal erworbenen Spiele über die Bibliothek oder die Dateiauswahl von Lichii hinzu. Spiele, Schlüssel und Firmware musst du separat bereitstellen.

Aktuelle offizielle Einrichtungshinweise

Back up saves before testing experimental builds.
For issue reports, provide the exact build, game version, CPU, GPU, driver version, relevant settings, reproduction steps, and (if useful) a screenshot and session log checked for personal information. Do not upload game files, keys, firmware, or private account information.
Desktop compatibility reporting requires a build containing PR #303 and is unavailable in build 88. In supported builds, play and stop a Switch 2 game, then right-click it and select Submit compatibility report. Review the prefilled details and public preview, and explicitly consent before submission; nothing uploads automatically, and the native v1 reporter does not read or upload logs or files.
The handbook advises trying games with stock settings before changing options.

Zurück zum Spiel

Häufige Lichii-Fehler und Lösungen

276 Problemeinträge

GitHub issue · open

[VBug] The sky in Hyrule glows white.

Spiel: Other / not listed Betriebssystem: Windows 11 Build: Lichii nx2 build 95 (222877d)

The sky in Hyrule glows white when the save file is loaded.

GitHub issue · open

[VBug] black screen amd

Spiel: Zelda: Ocarina of Time Betriebssystem: Linux Build: 95

Black screen or no video output while audio works or appears to work.

Vorgeschlagene Lösung: A commenter reports that launching in Docked Mode with Accurate GPU loads the main menu; this is a user-reported workaround, not a confirmed fix.

GitHub issue · open

[VBug] black screen amd

Spiel: Zelda: Ocarina of Time Betriebssystem: CachyOS Build: 93

Audio issues and occasional crash when launching another game without restarting after the game loads using Docked Mode and Accurate GPU.

GitHub issue · open

[GBug] Skateboarding Game in NS Sports Resort requires Joy-Con 2, emulator only emulates/shows Joy-Con 1

Spiel: Other / not listed Betriebssystem: Windows 11 Build: build-95

The Skateboarding sport's Sightseeing Tour requires a Joy-Con 2 controller, but the Controller Applet has no Joy-Con 2 option, making it impossible to play.

Spiel: Ocarina of Time Betriebssystem: Linux Build: build-94

On build 94 with GPU thread split enabled, split-front macros repeatedly fail with “instruction outside uploaded RAM,” leading to a black screen or stopped rendering.

Vorgeschlagene Lösung: Set EDEN_NX2_SPLIT=1 to keep macros on the back thread; both issue reporters say this avoids the macro errors, and the second reports that the game renders.

GitHub issue · open

[VBug] transluscent shaders flicker (water, non stained glass, etc.)

Spiel: Other / not listed Betriebssystem: Linux Build: build 88

Translucent shaders flicker on water and garden windows.

GitHub issue · open

Black 3D scene: native lowering rejects TLD4.F16 with mask != 15

**Build:** 222877d (build 95), also present on current main **GPU:** Nvidia, Vulkan ### Symptom 3D scene renders completely black. UI, subtitles and audio are fine; the pause menu background shows the scene. Every frame the log reports: ``` Native QMD failed: native shader dispatch required (native_qmd.h:96) ``` `DispatchNativeCompute` returns false for a full-screen post-process compute (QMD grid 120x68x1), so …

GitHub issue · open

Random GPU hang (Accurate): data race on DmaPusher bitfields drops SET_REPORT_SEMAPHORE release

Betriebssystem: Windows Build: build-93 (09b78bd); user comment also names nx2-build-93

GPU channels can wait indefinitely on a semaphore, leaving the emulator hung or Not Responding. The issue body attributes one hang to a data race that drops a `SET_REPORT_SEMAPHORE` release. A user separately reported an intermittent freeze after about 100 minutes on build 93; a second 98-minute run did not reproduce it.

Vorgeschlagene Lösung: The issue body gives a tested code change: replace the DMA pusher bitfields with separate boolean members, make `synced` an atomic boolean, and load it in the condition-variable predicate.

GitHub issue · open

[VBug] [Zelda Ocarina remake]Town vegetation and clutter render at a distance but disappear up close

Spiel: Zelda Ocarina remake Betriebssystem: Windows 10; a user also reports the issue on Linux Build: BUILD 88; user reports also on build 93 and builds 94/95

Town vegetation and small clutter render at a distance but disappear when approached; a later report says flowers no longer disappear in builds 94/95, while tree leaves still do.

GitHub issue · open

[Crash] Ocarina of Time (0400486024DEC000): VK_ERROR_DEVICE_LOST right after the intro cutscene on RX 7800 XT (build-88)

GitHub issue · open

[VBug] Ocarina of Time: Missing Foliage/Grass + Missing Textures/Objects on GTX 1070/1080. Mesh/task geometry is not drawn on GPUs without VK_EXT_mesh_shader (missing objects/foliage) [93+]

GitHub issue · open

[Feature Request] make the game proform well for crappy hardware

Users report low FPS and frequent stuttering on their hardware; one user reports about 15 FPS.

GitHub issue · open

[GBug] Zelda: Ocarina of Time (0400486024DEC000): the audio plays a different part of the stream than the picture

Spiel: Zelda: Ocarina of Time Betriebssystem: Windows 11

Clean audio from a different point of the game plays while the intro image is displayed; audio and picture are substantially out of sync.

GitHub issue · open

[Crash] Ocarina of Time Remake crash after intro cinematic

Spiel: The Legend of Zelda: Ocarina of Time Betriebssystem: Windows 10 22H2 (build 19045.6456) Build: nx2-build-93

User reports a crash after the intro cinematic when shader and pipeline compilation starts, with Vulkan device loss and NVIDIA driver errors.

GitHub issue · open

[Crash] Ocarina of Time Remake crash after intro cinematic

Spiel: The Legend of Zelda: Ocarina of Time

Commenters report similar crashes and audio desynchronization during the intro cutscene.

GitHub issue · open

[Crash] VK_ERROR_DEVICE_LOST, FEFW (Linux + AMD)

Spiel: Fire Emblem Betriebssystem: Linux Build: build 93 (09b78bd)

User reports that Fire Emblem: Fortune's Weave crashes on Linux with VK_ERROR_DEVICE_LOST and a GPU reset on AMD Radeon GPUs.

GitHub issue · open

[Crash] Game Frezes when using the ocarina function

Spiel: Legend of Zelda Ocarine of Time (remake) Betriebssystem: Windows 11 Build: Build 93

GitHub issue · open

[GBug] Ocarina of Time (Switch 2): playable on RX 9070 XT with build 93, ~29 FPS in Kokiri Forest, one thread at 99%

Spiel: The Legend of Zelda: Ocarina of Time Betriebssystem: Windows 11 Build: Lichii-AMD 2026.11.07 (nauxph fork, f4e938f516)

On the Lichii-AMD 2026.11.07 (nauxph fork, f4e938f516), GPU Mode Fast reportedly causes recurring blackouts of the game world while the HUD remains visible; the game continues running.

Vorgeschlagene Lösung: Switching GPU Mode from Fast to Accurate at runtime restores the picture without restarting; the user reports Accurate avoids blackouts but causes heavy stutter.

GitHub issue · open

[GBug] Ocarina of Time (Switch 2): playable on RX 9070 XT with build 93, ~29 FPS in Kokiri Forest, one thread at 99%

Spiel: The Legend of Zelda: Ocarina of Time Build: build-93

A user reports that gpu_accuracy, scaling_filter, and anti_aliasing values edited in qt-config.ini are rewritten at startup and says these settings must be changed through the GUI.

GitHub issue · open

[GBug]

Spiel: Zelda Ocarina Of Time Remake Betriebssystem: Windows 10 Build: build 93

Shaders load slowly and significantly slow gameplay, rebuilding when entering the same area. In the Kokiri Sword area, Link and most surroundings turn solid black; white flickers also occur.

Spiel: The Legend of Zelda: Ocarina of Time Betriebssystem: Windows 11 Version 26H2 Build: Build 75

With use_disk_shader_cache = true, subsequent boots hang indefinitely at Loading Shaders 25 / 27.

Vorgeschlagene Lösung: Delete cache/shader/0400486024dec000 and set use_disk_shader_cache = false; the reporter says this resolves the startup freeze.

GitHub issue · closed

[VBug] Doesn't work for AMD GPU - 9070 XT (The Legend of Boy in Green Hat)

Spiel: The Legend of Zelda: Ocarina of Time Build: build 75

Black screen after the intro on AMD RX 9070 XT; the game's 1080p upscaler shader is rejected.

Vorgeschlagene Lösung: Comment reports that #112 fixes the shader rejection; its CI build is fix/oot-upscaler-gathers / 7459f10 (build-80), and the fix is on nx2, but not in a release yet.

GitHub issue · closed

[VBug] Doesn't work for AMD GPU - 9070 XT (The Legend of Boy in Green Hat)

Spiel: The Legend of Zelda: Ocarina of Time Betriebssystem: Windows 11

On AMD, the world is black except around Navi and Link; an RX 6800 XT reporter says the workaround still leaves all 3D geometry black.

Vorgeschlagene Lösung: Comment reports that #127 fixes AMD-only demote reordering. Before it is merged, setting EDEN_NX2_REJECT_HASH=e40561a7a0f7a0b3 in %APPDATA%\eden\nx2_switches.txt makes the world visible on the RX 9070 XT report; another reporter says it does not resolve 3D rendering on the RX 6800 XT.

GitHub issue · closed

[VBug] Doesn't work for AMD GPU - 9070 XT (The Legend of Boy in Green Hat)

Spiel: The Legend of Zelda: Ocarina of Time Build: build 75

Texture flicker with Low GPU accuracy and GPU thread split on AMD RX 9070 XT.

GitHub issue · closed

Spiel: Fire Emblem Betriebssystem: Windows 11 Build: 70

FMVs and pre-rendered videos are skipped, including the opening cut-scene.

[GBug] Green hat kid bushes, shrubbery and grass turn dead when approaching too close.

Spiel: green-hat kid adventure Betriebssystem: Linux Build: 5f6066b26b-nx2; also reported in build 83

Shrubbery, bushes, and grass turn dead-looking when approached in Hyrule Castle, especially in Zelda's garden. A user reports that it still occurs in build 83.

GitHub issue · open

[VBug]

Spiel: Ocarina of Time

White haze over Hyrule Field and the sky on AMD cards, attributed by a commenter to froxel fog reading light probes beyond a 64 MiB read-only storage binding.

Vorgeschlagene Lösung: A commenter says the issue was fixed in #351.

GitHub issue · open

[VBug] Ocarina of Time is a black screen with the title theme music, and I can't press any buttons

Spiel: Ocarina of Time Betriebssystem: Windows 11 Build: 09b78bd

A black screen with title music and unresponsive controls; after waiting for shaders to load, the game worked but was extremely glitchy and laggy.

Vorgeschlagene Lösung: Waiting for shaders to load resolved the reported black screen, according to the user; gameplay remained unplayable.

GitHub issue · open

[Crash] Crash replicated multiple times when trying to enter Hyrule Market - The Legend of Zelda: Ocarina of Time

Spiel: The Legend of Zelda: Ocarina of Time Betriebssystem: Windows 11 Build: Build 93

The emulator closes when loading Hyrule Market after the user exits Kokiri Forest and enters Hyrule Castle.

GitHub issue · open

[Crash]

Spiel: Zelda: Ocarina of Time Betriebssystem: Linux

The console restarts after the scene on Linux with a lenovo legion go 2 z2 and egpu 7600xt; the report names versions 83 et 93.

Spiel: Other / not listed Betriebssystem: Linux Build: Build 93

User reports a GPU and emulator crash within seconds of starting Green Hat Kid on Linux with an AMD RX 9000 series graphics card, producing VK_ERROR_DEVICE_LOST.

Vorgeschlagene Lösung: User reports that running with EDEN_NX2_NO_MESH=1 avoids the crash.

Vorgeschlagene Lösung: Leave the game at the intro for about 20 minutes once so both pipelines finish and are cached; later boots reportedly pass the intro immediately until the driver or Lichii is updated. Alternatively, set `EDEN_NX2_REJECT_HASH=eff3ccbe1438679d,f9ea14a22394f5b1`; this avoids the wait but leaves parts of the picture black.

GitHub issue · open

Ocarina of Time crashes (unhandled vk::Exception) with VK_ERROR_OUT_OF_DEVICE_MEMORY on an 8 GB RX 9060 XT, after the first cutscene

Spiel: Ocarina of Time Betriebssystem: Windows 11 25H2 Build: Lichii Development Build | nx2-build-88

User reports an unhandled Vulkan::vk::Exception and emulator crash shortly after the first cutscene when texture allocation fails with VK_ERROR_OUT_OF_DEVICE_MEMORY on an AMD Radeon RX 9060 XT 8 GB.

GitHub issue · open

[Crash] Green Hat Game - Crashes the moment i try the Ocarina, at temple of time...

Spiel: Other / not listed Betriebssystem: Windows 11 Build: Build 88

Game freezes when the user tries the Ocarina at the Temple of Time.

Vorgeschlagene Lösung: Set GPU Mode to Fast; the commenter reports this resolved the slow gameplay for their setup.

Spiel: The Legend of Zelda: Ocarina of Time Betriebssystem: Linux 7.2.6, ArmadaOS (Fedora 44 based) Build: build-75

On Adreno 740 with Turnip, large native compute-shader pipelines can keep Vulkan pipeline-builder workers busy, consume substantial memory, and result in a black screen; some tests also reported GPU hangs or device loss.

Betriebssystem: Linux Build: 5a50f50

User reports repeated crashes around Deku Tree, followed by booting getting stuck compiling shaders; deleting the shader cache allows booting again. Another user reports the problem only with RADV.

Vorgeschlagene Lösung: Deleting the shader cache allows booting again, according to the user report.

GitHub issue · open

[Crash] Linux/RADV (RX 9070 XT): invalid SPIR-V fragment shader (depth image u32 sampled as f32) segfaults in VkPipelineBuild, Ocarina of Time

Spiel: Zelda: Ocarina of Time Betriebssystem: Linux Build: build 83 (clang 23.1.6)

User reports a segfault during gameplay on Linux with an AMD RX 9000-series GPU and RADV, when a graphics pipeline is built for an invalid fragment shader.

GitHub issue · open

[Crash] An error occured initializing the video core

Betriebssystem: Windows 11 Build: Build 83

While booting an unidentified "little green hat adventure game," the emulator reports an error initializing the video core, suggesting outdated GPU drivers. On OpenGL, the game launches but shows a black screen while sound works. The reporter says their RX 9070XT drivers are updated; a commenter reports the same problem with a 7000 series GPU.

[VBug] playing mario kart world but textures wont load. also crashes when playing the grand prix race

Spiel: Mario Kart World Betriebssystem: Windows 11 Build: build-83

A user reports missing textures and buggy visuals after booting, occasional startup crashes, and crashes when playing the Grand Prix race on build-83 with Intel integrated graphics on Windows 11.

GitHub issue · closed

[GBug] Ocarina of Time: black 3D gameplay screen; HUD remains visible (Lichii build 75)

Spiel: The Legend of Zelda: Ocarina of Time Build: Lichii nx2 build 75

The 3D gameplay scene can appear black while the HUD remains visible.

Vorgeschlagene Lösung: Switch to Docked mode; one commenter reported this resolved the black screen. Other reports say this workaround did not help.

GitHub issue · closed

[GBug] Ocarina of Time: black 3D gameplay screen; HUD remains visible (Lichii build 75)

Spiel: The Legend of Zelda: Ocarina of Time Build: Lichii build 75

A commenter reported stuttering, FPS drops, and overexposure after switching to Docked mode.

GitHub issue · closed

[GBug] Ocarina of Time: black 3D gameplay screen; HUD remains visible (Lichii build 75)

Spiel: The Legend of Zelda: Ocarina of Time Betriebssystem: Windows 11

A commenter reported flickering shadows and trees with no leaves.

GitHub issue · closed

[GBug] Ocarina of Time: black 3D gameplay screen; HUD remains visible (Lichii build 75)

Spiel: The Legend of Zelda: Ocarina of Time Betriebssystem: Windows 11

A commenter reported audio playing ahead of the video during the intro.

GitHub issue · open

Ocarina of Time: frame dump findings (overlay source, bloom/exposure, missing vegetation, rejected gathers)

Spiel: Ocarina of Time

[GBug] StarFox: nx2_sysmix accepts a constant 70.32% of mixer output, so audio plays as "robot voice"

Spiel: Star Fox Betriebssystem: Bazzite (Fedora atomic), Linux Build: Lichii nx2 build 70 (`286117c`)

User reports heavily distorted speech, music, and effects (“robot voice”) on build 70. Comments clarify that the approximately 0.7032 accepted/copied ratio reflects retries rather than lost samples; possible causes discussed include emulated time running ahead of wall time or slow host audio draining, but the cause is not confirmed.

GitHub issue · closed

[VBug] OOTRemake only title screen, no video and ui (only sound)

Spiel: Other / not listed Betriebssystem: Windows 11 Build: build-75

User reports a black background at the title screen and a black screen after starting a new game, with sound still audible.

GitHub issue · closed

[GBug]

Spiel: The Legend of Zelda: Ocarina of Time Betriebssystem: Windows 11 26H2 (Build 26300.9818) Build: Lichii Development Build — nx2-build-75

The 3D gameplay scene is black while HUD elements remain visible; menus and item preview can render correctly.

GitHub issue · closed

[Crash] macOS MKW Loading Splash animation shows, but crashes after.

Spiel: Star Fox Build: build-70

Gameplay is capped at about 30 fps, even though the game asks for 60.

Lichii release

Release note · build-70

Spiel: Star Fox Build: build-70

On RTX 50-series GPUs (5070 Ti, 5090), the GPU device can be lost shortly after a scene change.

Vorgeschlagene Lösung: Try NVIDIA driver 610.88.

Lichii release

Release note · build-70

Betriebssystem: Windows Build: build-70

Failed to allocate 14336 MiB of backing memory means Windows ran out of RAM plus page file.

Vorgeschlagene Lösung: Set the page file to system-managed and close memory-heavy apps.

Lichii release

Release note · build-70

Spiel: Yoshi and the Mysterious Book (demo) Build: build-70

Some textures are still black, and the game can crash later in play.

Lichii release

Release note · build-70

Spiel: Kirby Air Riders Build: build-70

Some races still stall while shaders build.

Spiel prüfen

Spielekompatibilität prüfen

Systemanforderungen lesen

Wähle Betriebssystem, Architektur, GPU-Kategorie und DLSS-Präferenz manuell aus.

Builds für linux herunterladen

Sieh dir die veröffentlichten Dateien für das oben ausgewählte Betriebssystem an.

Änderungsprotokoll lesen

Lies die Release-Hinweise zu dem Build, der im Kompatibilitätsbericht verwendet wurde.

Fragen zur Einrichtung

Häufige Fragen zur Einrichtung

Soll ich die alte Version zuerst entfernen?

Behalte deine funktionierende Version, bis der neue Build installiert und getestet ist. Sichere vor dem Wechsel Spielstände und Einstellungen.

Was soll ich prüfen, wenn Windows eine fehlende Abhängigkeit meldet?

Lass alle zugehörigen Dateien desselben Releases zusammen mit lichii.exeim gleichen Ordner. Suche in den Release-Hinweisen oder im Issue-Tracker nach der genauen Fehlermeldung.

Der Controller funktioniert im Menü, aber nicht im Spiel. Was kann ich tun?

Prüfe das Eingabeprofil und die Tastenbelegung erneut. Suche anschließend in der Fehlerbehebung nach dem Controller-Modell oder dem Spiel.

Warum wird ein geschlossenes Issue hier noch angezeigt?

„Closed“ ist der Status im Issue-Tracker. Lies die Diskussion, um zu sehen, ob das Problem behoben, verschoben oder aus einem anderen Grund geschlossen wurde und welcher Build betroffen ist.

Welche Angaben sollte ich bei einer Bitte um Hilfe machen?

Nenne Lichii-Build, Betriebssystem, GPU und Treiber, den vollständigen Fehlertext und die Schritte, die den Fehler auslösen. Gib auch an, ob er in einem zuvor funktionierenden Build auftritt.