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-117 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-pgo.zip (x86_64), lichii-windows-x86_64.zip (x86_64)) aus dem offiziellen Release build-117 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.

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-pgo.AppImage (arm64), lichii-linux-aarch64-pgo.tar.gz (arm64), lichii-linux-aarch64.AppImage (arm64), lichii-linux-aarch64.tar.gz (arm64), lichii-linux-x86_64-pgo.AppImage (x86_64), lichii-linux-x86_64-pgo.tar.gz (x86_64), 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-pgo.AppImage im Downloadordner chmod +x 'lichii-linux-aarch64-pgo.AppImage' aus und starte dann die AppImage.
  3. Entpacke lichii-linux-aarch64-pgo.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 AppImage requires glibc 2.39 or newer; the source lists Ubuntu 24.04, Fedora 40, Debian 13, and Arch.
  • Linux tar.gz packages use system libraries, so Qt 6 and the usual libraries must be installed.

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

  • macOS arm64 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

  • Recommended download: the PGO build.
  • Back up saves before testing experimental builds.
  • To submit a desktop compatibility report, use a build containing PR #303. Play and stop a Switch 2 game, then right-click it and choose Submit compatibility report. Review the prefilled details and public preview, and explicitly consent before submission.
  • Test games with stock options first; try changing settings only if they do not work.

Zurück zum Spiel

Häufige Lichii-Fehler und Lösungen

453 Problemeinträge

GitHub issue · open

[Regression] OoT black screen with audio on Linux AMD RADV (RX 9070 XT): Build 83 works, Build 95 fails

Spiel: The Legend of Zelda: Ocarina of Time (Switch 2) Betriebssystem: CachyOS (Arch Linux), KDE Plasma / Wayland Build: 95 Non-PGO

On Build 95 Non-PGO in Linux AMD RADV, the game remains black-screened while intro audio plays, even after shader compilation. The symptom persisted across the reported Wayland/XWayland and environment-variable tests, and after removing Vulkan Pipeline Cache and Cache Storage.

GitHub issue · open

[Regression] OoT black screen with audio on Linux AMD RADV (RX 9070 XT): Build 83 works, Build 95 fails

Spiel: The Legend of Zelda: Ocarina of Time (Switch 2) Betriebssystem: CachyOS, KDE Plasma, Linux; Wayland and XWayland reported Build: 117

Build 117 renders again, but the user reports substantial FPS and frametime variability, including drops to 19 FPS.

GitHub issue · open

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

Spiel: The Legend of Zelda: Ocarina of Time (Switch 2)

AMD GPU users report Vulkan VK_ERROR_DEVICE_LOST crashes around the intro-to-gameplay transition or while loading a save. Reports include RX 7800 XT, RX 9070 XT, and RX 6900 XT systems; the issue is not universal across all reports or tested builds.

GitHub issue · open

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

Spiel: The Legend of Zelda: Ocarina of Time (Switch 2)

Some users report crashes or black screens after trying the EDEN_NX2_NO_MESH=1 workaround; results vary by GPU, operating system, and build.

GitHub issue · open

Title: Feature request: precompile all of a game's shaders at first boot (shader warm-up)

Spiel: The Legend of Zelda: Ocarina of Time (Switch 2) Betriebssystem: Linux (CachyOS) Build: Lichii build 88 (Linux AppImage)

Hard lag or freezes when shaders are being built, mostly on first visits to areas, as reported by the issue author.

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 (Switch 2) Betriebssystem: Windows 11 Build: build-93

On build 93 with RX 9070 XT, gameplay is slow-motion at reported frame rates, with heavy bloom and overexposure in bright areas and the Great Deku Tree rendered as a dark silhouette in its intro scene.

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 (Switch 2) Betriebssystem: Windows 11 Build: build-95 (the release tagged `build-94`)

On RX 5700 (RDNA1), Kokiri Forest performance is reported at 14–15 FPS, compared with 22–24 FPS indoors; build 95 is reported to have the same outdoor performance as 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 (Switch 2) Betriebssystem: Windows 11 Build: Lichii-AMD 2026.11.07 (nauxph fork, f4e938f516)

On Lichii-AMD 2026.11.07 with RX 9070 XT using GPU Mode Fast, repeated rolling and jumping triggered black game frames while the HUD remained visible; the game continued running. Blackouts recurred in Kokiri Forest and were not accompanied by log output during the reported black periods.

Vorgeschlagene Lösung: Switching GPU Mode from Fast to Accurate at runtime restored the picture without restarting; the commenter reports stutter afterward. Accurate mode was also reported to avoid blackouts but cause 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 (Switch 2) Betriebssystem: Windows 11 Build: local clang-cl Release build of nx2 at 91d1aada6 (not PGO)

With an older configuration retaining GPU accuracy High, GPU thread splitting did not start, leaving work on one GPU thread. The commenter also reports long hitches while native pipelines were built, even with async shaders on.

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 (Switch 2) Betriebssystem: Windows 11 Build: build-117 (PGO)

On RX 9070 XT with extracted base-game version 1.0.0, the commenter reports blackouts and a Native compute shader rejected (per-tap gather) log error. They report no blackouts or such error during about 70 minutes of play using version 2.0.0 from a .nup on build 117 PGO.

GitHub issue · open

Ocarina of Time (Switch 2) gets stuck at "Building 9 shaders" on AMD RX 6750 XT

Spiel: The Legend of Zelda: Ocarina of Time (Switch 2) Betriebssystem: Windows 11 25H2 Build: build-75

On an AMD RX 6750 XT, the emulator freezes at “Building 9 shaders” after launching; background audio continues and the game does not progress.

GitHub issue · open

[Crash]

Spiel: The Legend of Zelda: Ocarina of Time (Switch 2) Betriebssystem: Windows 11 26H2 Build: nx2-build-92

Heavy stuttering during shader compilation, sometimes dropping to 0 FPS, with poor reported performance.

GitHub issue · closed

[Crash]

Spiel: The Legend of Zelda: Ocarina of Time (Switch 2) Betriebssystem: Windows 10 Build: Lichii nx2-build-75

On Radeon RX 580 (Polaris / GCN4), the game hangs at 0 FPS with a black screen while building compute pipelines as the intro video starts.

GitHub issue · open

[Investigation] OoT build-88: Vulkan pipeline stalls + reproducible hidden-window NVIDIA crash (static findings, test candidates)

Spiel: The Legend of Zelda: Ocarina of Time (Switch 2) Betriebssystem: Windows Build: build-88

Two hidden/minimized Windows CLI launches crashed in nvoglv64.dll with exception 0xc0000094 at offset 0xEFC9BB. Static findings identify stale SDL visibility state and no zero-extent guard as possible leads, but neither is proven to cause the crash.

GitHub issue · open

macOS/MoltenVK: Ocarina of Time (0400486024DEC000) kills or hangs the Metal device at the intro-video boundary

Spiel: The Legend of Zelda: Ocarina of Time (Switch 2) Betriebssystem: macOS Build: nx2 at 8813b44 and 5a50f50

On macOS arm64 with Vulkan via MoltenVK, the Metal device may be lost with a GPU address fault or device error during intro video playback, or the GPU thread may hang at the video-to-gameplay transition in fence waiting or buffer download.

GitHub issue · open

macOS/MoltenVK: Ocarina of Time (0400486024DEC000) kills or hangs the Metal device at the intro-video boundary

Spiel: The Legend of Zelda: Ocarina of Time (Switch 2) Betriebssystem: macOS

On Apple GPUs, attachment-less framebuffer draws using a 32768×32768 surface clip can exceed device framebuffer limits and cause GPU failure/device loss. A user also reports a stream-buffer constant-buffer tail read issue on Metal.

GitHub issue · open

macOS/MoltenVK: Ocarina of Time (0400486024DEC000) kills or hangs the Metal device at the intro-video boundary

Spiel: The Legend of Zelda: Ocarina of Time (Switch 2) Betriebssystem: macOS Build: Local nx2 builds 27226d2 and 55532f2 with user patches

User reports that rejecting shader programs containing native opcode 0x4a4 avoids a Metal page fault, but may leave the run stalled at the end of the video with semaphore waits and GPU-thread abort.

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.