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.

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

Drei Plattformen

So installierst du den Lichii Emulator

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

Lichii unter Windows einrichten

  1. Lade die aktuellen Windows-Dateien (lichii-windows-x86_64.zip (x86_64)) aus dem offiziellen Release build-94 herunter und behalte die Originaldateinamen bei.
  2. Entpacke das Archiv in einen Ordner, in dem du Schreibrechte hast. Starte keine ausführbare Datei direkt aus dem komprimierten Archiv.
  3. 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

  1. 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.
  2. Führe für lichii-linux-aarch64.AppImage im Downloadordner chmod +x 'lichii-linux-aarch64.AppImage' aus und starte dann die AppImage.
  3. 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.
  4. 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

  1. 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.
  2. Öffne die DMG-Datei lichii-macos-arm64.dmg und verschiebe die Anwendung in einen Ordner, auf den du Zugriff hast, etwa „Programme“.
  3. Ö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“.
  4. Zeigt macOS eine Sicherheitswarnung, gleiche den Download vor dem Fortfahren mit dem offiziellen Release ab. Lass die üblichen Systemschutzfunktionen aktiviert.
  5. 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

[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.

GitHub issue · open

[VBug] OCARINA OF TIME LOCKED AT 10FPS ON INTEL ARC B580 (and the game got the same Black screen as AMD)

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

The game reportedly runs at 10 FPS on the menu and shows a black screen after the cutscene on Intel Arc.

GitHub issue · closed

[VBug] Flashing textures with GPU mode: FAST

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

Flashing textures when running with GPU Mode: Fast on Linux; the report says the issue does not occur with GPU Mode: Accurate.

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

[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

[VBug] OOT - The fella has an aura of death that makes most plants in Castle render as dead.

Spiel: Other / not listed Betriebssystem: Linux Build: 557d694581

Plants around the Castle render as dead; a commenter reports bushes render correctly at a distance.

GitHub issue · open

[VBug] WATER TEMPLE

Spiel: Other / not listed Betriebssystem: Windows 11 Build: BUILD 93

User reports disappearing room textures inside the Water Temple, making walls and stairs difficult to see.

GitHub issue · open

[Crash] black screen when starting Zelda: Ocarina of Time on the latest build - Intel(R) HD Graphics 620 with vulkan and OpenGL GLS

GitHub issue · open

[VBug] Green Hat Boy Game

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

The Fairy Fountain before meeting Saria in the Lost Woods does not render.

GitHub issue · open

[VBug] Rendering and Loading

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

Rainbow-colored artifacts on mountain edges above the castle, excessive bloom in Hyrule Field, and intermittent severe FPS drops during gameplay.

GitHub issue · open

[Crash]

Spiel: Other / not listed Betriebssystem: Windows 11 Build: build 93

Cannot go further than the DekuTree cutscene; a commenter reports a black screen after getting past the title screen with OpenGL.

GitHub issue · open

[VBug] screen

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

The screen has visual noise ("nieve") and lag when entering the game.

GitHub issue · open

[GBug]

GitHub issue · open

[Crash] Ocarina of time crash

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

User reports a crash at the first cutscene and emulator shutdown after compiling existing shaders on reboot.

GitHub issue · open

[VBug] OOT - Much of Gerudo does not render, seeming to render like the skybox instead. Issue not observed elsewhere by myself.

Spiel: Other / not listed Betriebssystem: Linux; Windows reported by a commenter Build: 09b78bd

Much of Gerudo does not render correctly, appearing like the skybox; resetting shaders reportedly changes it to physical forms and shapes with skybox textures.

GitHub issue · open

[Crash] Loading Shaders AMD

Spiel: Other / not listed Betriebssystem: Windows 11; Linux Build: 75

The emulator closes while loading shaders before a game is opened; the report says it used 20GB of RAM. Reports mention Windows 11 and Linux, and AMD GPUs.

GitHub issue · open

[Crash]

GitHub issue · open

[VBug] OOT fairy underground cave walls invisible

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

Walls are invisible in underground areas with red health fairies.

GitHub issue · open

[GBug]

GitHub issue · open

[VBug] Certain blades of grass and pebbles vanish when attacking with sword.

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

Grass, vegetation, and pebbles may disappear during sword attacks; one user reports grass vanished permanently after clearing the shader cache.

Vorgeschlagene Lösung: A user reports that disabling "use persistent pipeline cache" fixed the issue for them.

GitHub issue · open

[GBug] Green Hat Remake finally booting on 9070XT . Issue with Dynamic FPS mod

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

Deku has black textures on some parts during the cinematic, with stuttering, bloom and artifacts when jumping. Dynamic FPS makes the game run too fast (about 2x speed); without it, gameplay is almost in slow motion.

GitHub issue · open

[GBug] no detection ZL imput durring shield tutorial in ghg

Spiel: Other / not listed Betriebssystem: Windows 10 Build: 93

In the shield tutorial, holding ZL is not detected and the tutorial loops. The user reports the same issue after rebinding ZL to L or switching to keyboard.

GitHub issue · open

[GBug] Controller Hijack in 93?

Spiel: Other / not listed Betriebssystem: Windows 11 Build: build 93

In build 93, the user reports controller input is hijacked about every 30 seconds, causing the character to run into a wall. The user says this did not happen in build 92.

GitHub issue · open

[Crash] RADEON RX 9070 crashes every single run.

GitHub issue · closed

[Crash] OoT crashes in dynarec at random after some play time.

GitHub issue · open

[Crash] RX9070XT, SteamOS

Spiel: Other / not listed Betriebssystem: SteamOS Wayland Build: Lichii nx2 build 93 (09b78bd)

The source refers to the game as OOT but does not clearly identify which listed Ocarina of Time game it is. On AMD RX 9070XT under SteamOS/Linux, loading a save reportedly led to a black screen and system crash. After trying EDEN_NX2_NO_MESH=1, rendering and shading issues remained.

GitHub issue · open

[VBug] Ocarina of Time: distant Kokiri Forest canopy renders neon green in the main scene pass (RX 7900 XTX)

GitHub issue · open

[VBug] Walls and objects not rendered inside Deku tree

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

Walls and objects are missing/not rendered inside the Deku tree.

GitHub issue · open

[VBug] over exposure in specific parts (so far lower part of Saria's house and the right side of the entrance to hyrule castle)

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

Overexposure in specific areas, including the lower part of Saria's house and the right side of the entrance to hyrule castle.

GitHub issue · open

[Crash] Deadlock: texture GC holds the texture cache lock while BackSparseWrite waits on the guest page table lock (nx2 build-93)

Spiel: Other / not listed Betriebssystem: Windows 11 25H2 (build 26200) Build: build-93

A user reports a freeze about 40 seconds after boot, with texture rendering failure and overbright world brightness beforehand. A dump showed GPUBack waiting on the guest page table lock while in the texture garbage collector; the user suspects a lock cycle.

GitHub issue · open

[VBug] OOT mountain on the way up to zoras domain following the river is invisible

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

The mountain on the way up to Zora's Domain following the river is invisible.

GitHub issue · open

[GBug] 9070 xt now works but...

GitHub issue · open

[VBug] Mario tennis not show characters and sets

Spiel: Other / not listed Betriebssystem: Windows 10 Build: Lichii nx2 build 93 (09b78bd)

A user reports sound glitches and improper rendering after booting Mario tennis.

GitHub issue · open

Switch Sports Resort boots to intro cutscene

GitHub issue · open

[Crash] Build 93: GPU full crash early on start of Green Hat Kid with AMD Graphics card (RX 9070 XT)

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.

GitHub issue · open

[VBug] Only the Bottom Half of the Game Is Rendered (OOT)

GitHub issue · open

[GBug]

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.

GitHub issue · open

[GBug] 20 fps

GitHub issue · open

[Crash] Legend of green hat

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

User reports a crash when booting the game in build 88 after it worked in build 75.

GitHub issue · open

[VBug] [AMD] Ocarina of Time: yellow-white haze and green shimmering water from NaN through FMin/FMax/FClamp

Spiel: Other / not listed Betriebssystem: Windows 11 Build: nx2 a7a28175 + #292, local MSVC build

On AMD RX 7000 series, NaNs from FMin, FMax, and FClamp can spread through bloom, producing a yellow-white sky and green shimmering water.

GitHub issue · open

[Crash] OOT REmake : When attempting to use the microphone feature with the ocarina. No hard crash, emulation freeze.

GitHub issue · open

[GBug] Dynamic FPS speeds up game when 30 FPS is reached Ocarina of Time Remake

GitHub issue · open

[GBug] Dynamic FPS not working in Ocarina of Time Remake.

GitHub issue · open

[Crash] AMD 9060 XT

GitHub issue · open

[GBug] OOT Remake Intel Arc 7 Cores - Only 1 Fps in the main menu and first cutscene

GitHub issue · open

[Crash] Lichii crashes at OOT launch

GitHub issue · open

[VBug] OoT Slows on boot (still)

GitHub issue · closed

[GBug] System language Portuguese (Brazil) doesn't change in-game language for the Remake of The Legend of Zelda: Ocarina of Time

GitHub issue · open

[VBug] PGO build won't show videos on OOT

GitHub issue · open

[GBug]

GitHub issue · closed

[VBug] Ocarina of Time: dialogue box panel and hint strip flicker with EDEN_NX2_FRAMES_AHEAD=1, gone with =0

GitHub issue · open

[Crash] Ocarina of Time NUP remains on Launching in build 88

GitHub issue · closed

Old Gtx e new rtx, same fps

GitHub issue · closed

[VBug] fairy fountain invisible green hat boy game

GitHub issue · closed

[GBug] literally The Legend of Green

Betriebssystem: Windows 11 Build: Lichii nx2 build 83 (5a50f50)

The issue title says “literally The Legend of Green,” but the game field is “Other / not listed”; no specific compatibility symptom is stated.

GitHub issue · closed

[GBug] Fast Fusion runs at max 24 fps

GitHub issue · closed

[GBug] Mac: 20 fps + audio cuts in and out

GitHub issue · closed

[VBug] black screen and slow stuttery dialogue

Spiel: Other / not listed Betriebssystem: Windows 11 Build: Latest nov 5 2026

After the intro, the scene where the deku tree is talking is completely black with very slow, stuttery dialogue.

GitHub issue · closed

[VBug] start up on OoT remake screen plays, but after that only audio and a black screen

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

After the startup screen, audio plays but the screen is black.

GitHub issue · closed

[GBug] Audio disappears the legend of zelda

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

Music disappears during the cutscene after booting the game.

GitHub issue · closed

[Crash]

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

The game crashes while building shaders after the title card fades.

GitHub issue · closed

[VBug] Black screen on cinematic

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

Black screen during cinematic after the main menu appears; reported on Windows 11 with an AMD RX 6000 series or older GPU.

GitHub issue · closed

[Crash] infinite launch screen with legend of zelda ocarina of time

Spiel: Other / not listed Betriebssystem: Windows 10 Build: 286117c7e0-nx2

Infinite startup launch loop when booting the .NUP version.

GitHub issue · closed

[VBug] OOTR Terrain visible trough objects

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

Terrain is visible through solid objects after getting past the intro.

GitHub issue · open

[GBug] Ocarina of Time: pipelines evicted after ~2.5 min are rebuilt on the GPU thread when re-entering an area (stutter)

GitHub issue · open

[GBug] Cutscenes running in slow motion(OoT)

GitHub issue · open

[VBug] Invisible box in Hyrule Castle

GitHub issue · open

[GBug]

GitHub issue · open

[GBug] overall zelda ocarina of time experience on win11 rtx 2060 3700x 16gb ram system and visual glitches

GitHub issue · open

Legend of Zelda Ocarina of time

GitHub issue · closed

[Crash] Build 88 Link (amd64 / x86_64 (MinGW)) is down

GitHub issue · open

[GBug]

OCARINA OF TIME ### Before submitting - [x] I searched existing issues and found no duplicate - [x] I'm using the latest build - [x] My game is legally dumped from my own console ### Emulator build BUILD-88 ### Regression - [ ] This is a regression (it worked in an older build) ### Last known working build _No response_ ### Game Other / not listed ### Graphics card NVIDIA RTX 30 series or older ### Opera…

GitHub issue · open

[VBug] OoT Black screen after the first cutscene and weird vhs filter in docked mode

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

Black screen after the first cutscene in handheld mode and VHS-like visual filter in docked mode.

GitHub issue · closed

[VBug] Green-hat adventure game boots to black screen, only audio, on mac

Spiel: Other / not listed Betriebssystem: macOS Build: build 75

Boots to a black screen with audio on macOS.

Vorgeschlagene Lösung: Clear the cache and launch again.

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.

Spiel prüfen

Spielekompatibilität prüfen

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.