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 · closed

[Crash] Bananza runs at ~57 fps then aborts silently, 0xC0000409 at +0x2ecd3bd

Spiel: Donkey Kong Bananza Betriebssystem: Windows 11 Build: build 70 (286117c)

On build 70 (286117c), the MSVC zip aborts after 133.8 seconds of gameplay with 0xC0000409 at lichii.exe+0x2ecd3bd. The MinGW PGO zip reportedly aborts on the intro screen at the same offset.

GitHub issue · open

[Crash] rx 6800xt all emulators crash on loading screen

Spiel: Donkey Kong Bananza Betriebssystem: Windows 10

User reports the game crashes when the loading screen appears on Windows 10 with an AMD RX 6000 series or older graphics card.

GitHub issue · open

[VBug] Build 93 finaly has no major visual errors but has poor performance 9070xt

Spiel: Donkey Kong Bananza

The issue says FPS is worse than on most other forks.

GitHub issue · open

[UIBug] Bananza — build 93

Spiel: Donkey Kong Bananza Betriebssystem: Windows 11 Build: build 93

On build 93, FPS fluctuates approximately between 20 and 60, with frequent periods around 30 and drops to 25–28 FPS in the Dragon Layer; GameSir G7 Pro rumble can be excessive, occur without an obvious trigger, or continue longer than expected.

GitHub issue · open

[Crash] donkey kong and ocarina crash on AMD 6800xt

Spiel: Donkey Kong Bananza Betriebssystem: Windows 11 Build: latest prelease build 93

User reports a crash when loading a save on AMD RX 6000 series or older under Windows 11.

GitHub issue · closed

Donkey Kong Bananza (040074A01BF12000): fatal 2111-3604 right after a VP9 video reaches end of stream (nx2:vdecsvc)

GitHub issue · open

[GBug] Donkey Kong Bananza locked at 20 fps

Spiel: Donkey Kong Bananza Betriebssystem: Windows 11 Build: Build-88

User reports the game is locked at 20 FPS, including menus and title screen, on Windows 11.

GitHub issue · closed

Donkey kong bananza Crash loading

GitHub issue · closed

[VBug] Shadow artifacts

Spiel: Donkey Kong Bananza Betriebssystem: Windows 11 Build: build-70

Weird artifacts, especially on shadows.

GitHub issue · closed

[GBug] Donkey kong bananza, black rectangle

Spiel: Donkey Kong Bananza Betriebssystem: Windows 11 Build: nx2 build 65 (3bdd53d); reporter also tried build-70

A black rectangle appears in a mini-example guide; the reporter says it persists on build-70.

GitHub issue · open

Donkey Kong Bananza: terrain missing (white/black) on builds 70 and 75, renders correctly on build 65

Spiel: Donkey Kong Bananza Betriebssystem: Windows 11 25H2 (build 26200.9818) Build: 70 and 75

On Windows builds 70 and 75, terrain/world renders solid white while the HUD and characters still render. On build 75, EDEN_NX2_RESETFIX=0 changes the ground to black with no texture or lighting.

GitHub issue · closed

donkey kong bananza purple screen issue

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.