Installation et dépannage

Installer et dépanner Lichii Emulator

Du téléchargement au premier lancement, configurez vos commandes, ajoutez vos jeux et résolvez les problèmes qui vous bloquent.

Manettes détachées, connexions USB-C et écran illustrant l’affectation des boutons dans le guide d’installation de Lichii Emulator
Illustration · Guide d’installation de Lichii Emulator
Latest recorded build build-117 Published November 7, 2026

Trois plateformes

Comment installer Lichii Emulator

Choisissez votre plateforme pour suivre l’installation pas à pas.

Installer Lichii sous Windows

  1. Téléchargez les fichiers Windows actuellement proposés (lichii-windows-x86_64-pgo.zip (x86_64), lichii-windows-x86_64.zip (x86_64)) depuis la version officielle build-117 et conservez leur nom d’origine.
  2. Extrayez l’archive dans un dossier où vous avez les droits d’écriture. Ne lancez pas l’exécutable directement depuis l’archive compressée.
  3. Lancez lichii.exe depuis le dossier d’extraction. Si Windows affiche un avertissement de sécurité, vérifiez que le fichier provient du lien officiel de la version avant de décider de poursuivre.

Besoin d’un autre fichier ? Voir les téléchargements pour windows.

Installer Lichii sous Linux

  1. Choisissez parmi les fichiers Linux publiés (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)) celui qui correspond à l’architecture de votre système, puis téléchargez-le depuis le lien de la version.
  2. Pour lichii-linux-aarch64-pgo.AppImage, exécutez chmod +x 'lichii-linux-aarch64-pgo.AppImage' dans le dossier du téléchargement, puis lancez cette AppImage.
  3. Pour lichii-linux-aarch64-pgo.tar.gz, extrayez d’abord l’archive, puis lancez l’exécutable depuis le dossier d’extraction. Si un message signale une dépendance glibc ou Qt manquante, consultez les notes de la version sélectionnée et le ticket d’origine pour connaître la version requise.
  4. Conservez l’URL et le tag de la version avec le fichier installé pour pouvoir rattacher vos futurs résultats de compatibilité à la même version.

Indications de la version

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

Besoin d’un autre fichier ? Voir les téléchargements pour linux.

Installer Lichii sous macOS

  1. Choisissez parmi les fichiers macOS publiés (lichii-macos-arm64.dmg (arm64), lichii-macos-arm64.zip (arm64)) celui qui correspond à l’architecture de votre système, puis téléchargez-le depuis le lien de la version.
  2. Pour lichii-macos-arm64.dmg, ouvrez le DMG et déplacez l’application dans un dossier que vous gérez, par exemple Applications.
  3. Pour lichii-macos-arm64.zip, ouvrez le ZIP et déplacez l’application dans un dossier que vous gérez. Si macOS demande une confirmation au premier lancement, faites un clic droit sur l’application et choisissez Ouvrir.
  4. Si macOS affiche un avertissement de sécurité, comparez votre téléchargement à la version officielle avant de poursuivre. Laissez les protections habituelles du système activées.
  5. Lancez Lichii depuis le dossier où vous avez placé l’application.

Indications de la version

  • macOS arm64 requires macOS 15 or newer.

Besoin d’un autre fichier ? Voir les téléchargements pour macos.

Premier lancement

Configuration initiale

Configurez Lichii dès le premier lancement : choisissez la disposition de manette qui vous convient, réglez les graphismes et ajoutez votre bibliothèque de jeux.

Graphismes

Commencez par les réglages graphiques décrits dans les notes de votre version. Changez un seul réglage à la fois et notez le tag de la version avec vos résultats.

Pour trouver des réglages de départ adaptés à un jeu, ouvrez son rapport de compatibilité.

Périphériques d’entrée

Connectez votre manette, attribuez les boutons, puis enregistrez le profil. Si un bouton ne fonctionne pas, recherchez le modèle de votre manette et votre version de Lichii dans la section de dépannage.

Vos fichiers de jeu

Ajoutez vos jeux obtenus légalement depuis la bibliothèque ou l’option d’ouverture de fichiers de jeu de Lichii. Les jeux, les clés et le micrologiciel sont à fournir séparément.

Notes officielles d’installation actuelles

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

Reprendre la partie

Erreurs fréquentes dans Lichii et solutions

453 problèmes dans la liste

GitHub issue · closed

[Crash] Ocarina of Time Remake crash after intro cinematic

Jeu : The Legend of Zelda: Ocarina of Time Système : Windows 10; Windows 11 Version : nx2-build-93 and nx2-build-95; Fritchii v4.1 (hotfix/v4.1-f6d42b8715)

On the reported NVIDIA systems using driver 581.29, the game crashes with Vulkan device loss during shader and pipeline compilation after the intro cinematic; reports include repeated Unmapped Device ReadBlock errors and Windows nvlddmkm Event ID 153.

Solution proposée : One user reports that updating to the official NVIDIA Game Ready 621.14 driver and rebooting resolved the issue on their system. Another comment says it started working after installing the latest Nvidia driver.

GitHub issue · closed

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

Jeu : The Legend of Zelda: Ocarina of Time Système : Windows 11 Version : nx2 a7a28175 + #292, local MSVC build

After outdoor play, the sky becomes flat yellow-white and water shimmers green until reboot, due to NaNs spreading through bloom. The report says the NaNs probably originate from fog/foliage probe reads beyond the 64 MiB graphics table-pointer cap.

Solution proposée : Use NaN-safe min/max/clamp handling and fix table-pointer reads beyond the old 64 MiB cap; the reporter confirmed normal visuals after both fixes.

GitHub issue · open

[VBug] macOS/MoltenVK (Apple M1): Ocarina of Time (0400486024DEC000) shows only black output from boot, 1 FPS, only 2 draws per frame

Jeu : Ocarina of Time Système : macOS Version : 117

On macOS/MoltenVK with an Apple M1, the Switch 2 NSO version boots and plays audio but presents a black image from startup, with approximately 1 FPS and occasional red/green block artifacts.

GitHub issue · open

[Crash] OoT (0400486024DEC000): 8 compute shaders rejected on RX 6750 GRE, unoptimized table only covers 2

Jeu : The Legend of Zelda: Ocarina of Time Système : Windows 11 and Windows 10 Version : nx2-build-83, nx2-build-88, nx2-build-93, nx2-build-95, nx2-build-117

On AMD GPUs, Ocarina of Time's compute shaders can fail compilation with VK_ERROR_OUT_OF_HOST_MEMORY or cause the AMD driver to crash. The issue report describes missing intro video and an eventual process crash; a later user reports an access violation inside amdvlk64.dll.

GitHub issue · open

[Crash] OoT (0400486024DEC000): 8 compute shaders rejected on RX 6750 GRE, unoptimized table only covers 2

Jeu : The Legend of Zelda: Ocarina of Time

OpenGL is reported not to work for this game because GLSL task and mesh programs are not implemented, resulting in repeated errors and an emulator hang.

GitHub issue · open

[Crash] OoT (0400486024DEC000): 8 compute shaders rejected on RX 6750 GRE, unoptimized table only covers 2

Jeu : The Legend of Zelda: Ocarina of Time

Rejecting shader hashes before translation skips their dispatches and can result in missing output or a black screen; a user reports the environment switch did not affect the tested Vulkan compute-pipeline path.

Solution proposée : For testing shader rejection, keep the disk shader cache off or delete it before each run; the maintainer says cached shaders are loaded without checking the rejection list.

GitHub issue · open

Higher Resolution than 1x for TLoZ: OoT with DLSS?

Jeu : The Legend of Zelda: Ocarina of Time

Shader compilation can cause freezes of about 3 seconds with each step, according to a user report.

GitHub issue · open

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

Jeu : The Legend of Zelda: Ocarina of Time (Switch 2) Système : CachyOS (Arch Linux), KDE Plasma / Wayland Version : 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

Jeu : The Legend of Zelda: Ocarina of Time (Switch 2) Système : CachyOS, KDE Plasma, Linux; Wayland and XWayland reported Version : 117

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

GitHub issue · open

[GBug] [Performance] Zelda OoT – MX150 Pascal – GPU profiling results (Build 117)

GitHub issue · open

[GBug] screen artifact in oot

Système : Windows 11 Version : 117

A user reports a screen flickering glitch in an unidentified game on build 117, stating it worked in build 95. A commenter reports the same issue on a 2070 Super.

GitHub issue · open

[GBug] No Loading build 95 Shadercache (AMD RX 6600)

Jeu : OoT Système : Windows 11 Version : build 117

On build 117, the game shows a black screen while background music plays and does not load, reported with an AMD RX 6000 series or older GPU on Windows 11.

GitHub issue · open

[VBug] FPS Drop 0 - 15 every frame OOT

GitHub issue · open

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

Jeu : The Legend of Zelda: Ocarina of Time (Switch 2) Système : Linux (CachyOS) Version : 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

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

A commenter says pipeline caches may be evicted after a few minutes, referring to issue #293; this is described as possibly related and is not independently confirmed here.

GitHub issue · open

[GBug] OOT cgi cutscenes on slow motion

Jeu : Other / not listed Système : Windows 11 Version : Build 117

In Build 117, pre-rendered cutscenes reportedly run at 28 FPS in slow motion and fall out of sync with audio, while gameplay is unaffected.

GitHub issue · open

[GBug] OOT cgi cutscenes on slow motion

Jeu : Other / not listed Version : Build 93

A commenter reports slow motion in Build 93.

GitHub issue · closed

[VBug] OOT - Solar Flare in Field

Jeu : Other / not listed Système : Linux Version : 674dd5b

User reports a solar flare in the field when looking toward Kakariko and no collision.

GitHub issue · open

[GBug] OOT : music randomly cuts out while voices keep playing

Jeu : Other / not listed Système : Windows 11 Version : 117

Music randomly cuts out while voices continue playing in the first cinematic.

GitHub issue · open

[Crash] 100% reproducible crash inside Guardhouse in Hyrule Castle Town (OoT)

Jeu : The Legend of Zelda: Ocarina of Time Système : Windows 11 Version : Lichii nx2 build 93 (09b78bd)

A user reports a reproducible crash to desktop within a few seconds of entering the Guardhouse in Hyrule Castle Town.

GitHub issue · open

[Crash] Random Crash in OoT 9800x3d, RTX5080

Système : Windows 11 Version : Build 118

A user reports random emulator crashes while running a game identified as "Other / not listed" on Build 118 with an NVIDIA RTX 50 series under Windows 11. The crashes occur at random intervals, and the user has to restart emulation.

GitHub issue · open

[Perf] OoT on AMD RX 7900 GRE: shader/pipeline hitches; preload max-age + async discard native

Jeu : Zelda: Ocarina of Time Système : Windows 10/11 Version : Lichii nx2 ~95

Long shader and pipeline hitches while exploring; the user also reports texture flashes or freezes when new pipelines compile.

GitHub issue · open

[Crash] OOT crashes with system-wide GPU error

Jeu : Other / not listed Système : Linux Version : Build 117 PGO

A system-wide GPU error and crash after playing for a few minutes, reported with AMD RX 6000 series or older on Linux in Build 117 PGO.

GitHub issue · open

[Crash] Ocarina of Time (0400486024DEC000): unimplemented nx2:vi2 function 201

Jeu : The Legend of Zelda: Ocarina of Time Système : Windows 11 Version : 93 and 95

Crashes during boot at an unimplemented nx2:vi2 function 201; the report also mentions a later unimplemented IGeneralService function 101 assert.

GitHub issue · open

[Crash] Linux RADV, Navi 33 (Steam Machine): GPU reset from mesh draws in OoT, "Illegal opcode in command stream", also MKW on stock build 88

Jeu : Ocarina of Time Système : Linux Version : build 88; builds 93, 94, and 95; nx2-588bfa611b; 9fc1a705b5-pr569

On Linux RADV systems, user reports describe GPU resets or device loss during mesh draws, sometimes with an illegal opcode in the command stream. EDEN_NX2_NO_MESH=1 avoided resets in several tests but caused missing terrain, plants, or other geometry.

Solution proposée : Users reported that EDEN_NX2_NO_MESH=1 avoided resets, with missing geometry. Tests of PR #569 reported that EDEN_NX2_FORCE_MESH_FALLBACK=1 avoided resets on Navi 23 and Navi 31 and restored geometry; these are user reports, not maintainer-confirmed fixes.

GitHub issue · open

[Crash] Linux RADV, Navi 33 (Steam Machine): GPU reset from mesh draws in OoT, "Illegal opcode in command stream", also MKW on stock build 88

Jeu : Mario Kart World Système : Linux Version : build 88

A user report says stock build 88 reset the GPU about 25 seconds after launch on Linux RADV.

GitHub issue · open

[GBug] 117 runs significantly worse then 93 in almost every aspect on mid rang nvidia hardware.

Jeu : OOT REMAKE Système : Other Version : 117

User reports significantly worse performance and that parts of the game are broken in build 117 compared with build 93 on NVIDIA RTX 30 series or older.

GitHub issue · open

[Crash] OOT Crash on latest build

GitHub issue · open

[GBug] Cutscenes running in slow motion(OoT)

Jeu : OoT Système : Linux Version : build-88

Cutscenes play in slow motion, lagging behind audio; the report describes them as locked to 49fps with 99% GPU usage.

GitHub issue · open

[GBug] Cutscenes running in slow motion(OoT)

Jeu : OoT Système : Windows 11 Pro 64-bit

The same slow-motion cutscene problem is reported.

GitHub issue · open

[GBug] Cutscenes running in slow motion(OoT)

Jeu : OoT Système : Windows 11 Home

The same slow-motion cutscene problem is reported.

GitHub issue · open

[VBug] [OOT] Minor inconvinience blocky reflections on water

Système : Windows 11 Version : build 115

Blocky reflections on water around the playable character.

GitHub issue · open

[Crash] OOT: Failed to load VPDAU

Jeu : Other / not listed Système : Linux Version : build 95

Black screen when starting in build 95 on Linux; a commenter reports black screen with music. The commenter says build 93 loads normally on their system.

GitHub issue · open

[GBug] Ocarina of Time (0400486024DEC000): about half of boots run 20-25% slower; the game's job workers stay awake ~45% longer

Jeu : Ocarina of Time Système : Windows 11 25H2

When fastmem could not be created, guest code ran about 1.4x slower; Kokiri Forest ran at 22.2–26.6 FPS rather than 28.5–33.8 FPS. The report attributes the slow boots to failure to allocate 14336 MiB of backing memory.

Solution proposée : Change #645 retries the section after a private commit that grows the page file; in eight back-to-back boots, all three initial failures recovered on the second attempt and none ran slowly.

GitHub issue · open

[GBug] OoT on RTX 4060 Laptop (45 W): build-95 holds draws for unbuilt pipelines; Frizti host pacer misreads refresh with mixed-refresh monitors

Jeu : The Legend of Zelda: Ocarina of Time Système : Windows 11 Version : build-95 (`nx2-build-95`)

On build-95, the user reports draws held while unbuilt pipelines are being built, causing multi-second stalls, even with async shaders enabled.

GitHub issue · open

[GBug] OoT on RTX 4060 Laptop (45 W): build-95 holds draws for unbuilt pipelines; Frizti host pacer misreads refresh with mixed-refresh monitors

Système : Windows 11 Version : Frizti v3 (`Lichii Frizti v3 | oot-gather-fix-00ef0ea6cc`)

In Frizti v3, the host pacer reportedly switches between composition refresh rates on mixed-refresh monitors rather than consistently using the refresh rate of the monitor holding the game window; the report describes uneven pacing.

GitHub issue · open

[GBug] OoT on RTX 4060 Laptop (45 W): build-95 holds draws for unbuilt pipelines; Frizti host pacer misreads refresh with mixed-refresh monitors

Jeu : The Legend of Zelda: Ocarina of Time Système : Windows 11 Version : build-95 (`nx2-build-95`)

The user reports that a fresh build-95 config starts with slow defaults, including High GPU accuracy, asynchronous shaders off, async presentation off, Handheld mode, 4 GB memory layout, and CPU NVDEC; the game ran at 10–15 fps with stalls up to 8.9 s and blurry/pixelated Handheld resolution.

Solution proposée : The user reports that writing the six listed settings before launch helped: gpu_accuracy=0, use_asynchronous_shaders=true, async_presentation=true, nvdec_emulation=2, memory_layout_mode=2, and use_docked_mode=1; set each key's \default= line to false as well.

GitHub issue · open

Ocarina of Time harvest fork: findings and open tasks

GitHub issue · open

[VBug] OOT Jabu jabu belly weird strange floor and walls geometry

Système : Linux Version : build 95

Inside Lord Jabu Jabu's belly, floor and wall surfaces display geometric mesh face outlines.

GitHub issue · open

[VBug] OOT: Stone wall tablet doesn't render in Lost Woods to Zora River area

Jeu : Other / not listed Système : Linux Version : build-95

The stone tablet does not render in the Lost Woods to Zora River area, although grass particles render on it.

GitHub issue · open

[VBug] OOT fairy underground cave walls invisible

Jeu : Other / not listed Système : Linux Version : build 93

The fairy fountain grotto's walls and other parts are invisible in underground areas with red health fairies. A commenter reported that a damaged NUP game-data file was the cause.

Solution proposée : PR #267 workaround: when loading the NUP, serve a .zs member with no zstd header from its closest sound sibling. A user reported that the workaround restored the grotto.

GitHub issue · open

[Perf] OoT (0400486024DEC000): per-fence Preflushable buffer downloads (~430 MB/s) are the biggest GPU back-thread cost; batching them gives +55% draws/s but breaks exposure

Jeu : Ocarina of Time Système : Windows 11 Version : nx2 @ 27226d2 plus two measurement-only commits

Skipping or batching Preflushable buffer downloads can cause the scene to be overexposed because guest reads may occur before downloaded GPU-written data is available. The issue also reports potentially stale exposure data with the no-preflush experiment.

GitHub issue · open

[Perf] OoT (0400486024DEC000): per-fence Preflushable buffer downloads (~430 MB/s) are the biggest GPU back-thread cost; batching them gives +55% draws/s but breaks exposure

Jeu : Ocarina of Time Système : Windows 10 Version : nx2 c9bdbaa

A commenter reports that Kokiri Forest and the Deku Tree can run much more slowly after watching the New Game intro than when loading a save directly; the commenter reports a storage-write extent branch improved the intro-first result.

GitHub issue · open

[Perf] OoT (0400486024DEC000): per-fence Preflushable buffer downloads (~430 MB/s) are the biggest GPU back-thread cost; batching them gives +55% draws/s but breaks exposure

Jeu : Ocarina of Time

A commenter reports that the per-fence download cost remains and describes an unmerged pull request that limits GPU-written marking to shader store extents.

GitHub issue · open

[VBug] [AMD RX 9070 XT] Build 95 – White sky during daytime and black distant terrain/water at night in Zelda OoT

Jeu : The Legend of Zelda: Ocarina of Time Système : Windows 11 Version : Lichii nx2 build 95 (222877d)

On AMD Radeon RX 9070 XT with Vulkan, the daytime sky and distant scenery can appear white or washed out, and distant terrain and water can appear black at night.

GitHub issue · open

[VBug] [AMD RX 9070 XT] Build 95 – White sky during daytime and black distant terrain/water at night in Zelda OoT

Jeu : The Legend of Zelda: Ocarina of Time

A user reports crashing while loading on an RX 9070 XT, even after copying another user's settings; the game and setup details are not established in that comment.

GitHub issue · open

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

Jeu : Ocarina of Time Système : Windows 11 Version : nx2 55532f2d81 (build-88)

On an AMD RX 7900 XTX, the distant Kokiri Forest canopy renders neon green and cyan.

Solution proposée : #292 reportedly fixes the green; a commenter says #354 addresses the root cause. Another comment says a related fix was merged in PR #351 and was not in a published release at the time of the comment.

GitHub issue · open

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

Jeu : Other / not listed Système : Windows 11 Version : build 88

Selecting a microphone input and playing an ocarina note causes emulation to freeze.

Solution proposée : A comment says the issue was fixed in pull request 255.

GitHub issue · closed

[VBug] OoT (0400486024DEC000): textures flicker with Low GPU accuracy + EDEN_NX2_SPLIT=2 on AMD RX 9070 XT; High fixes it but turns the split off (~9 fps)

Jeu : Ocarina of Time

On earlier builds, small details such as leaves, pebbles, and grass flickered or appeared black with Low GPU accuracy and the split GPU thread enabled.

Solution proposée : Update to build 95 or later; the source attributes the fix to buffer usage tracking changes, with additional near-foliage fixes. EDEN_NX2_PERF_VERIFY=1 was an earlier workaround but was reported as no longer needed on build 95.

GitHub issue · open

[GBug] remaing issues on zelda oot

Système : Windows 11 Version : latest(95)

Green bushes transform into distorted shapes when approached near Hyrule Castle or the Temple of Time; performance is reported at 10–20 FPS in Castle Town or the field. The reporter says the LOD problem appears solved.

GitHub issue · closed

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

Jeu : Other / not listed Système : Linux Version : 557d694581

Plants and bushes in the Castle appear dead up close, while bushes render correctly at a distance.

GitHub issue · open

[VBug] MKW 1.8.0 no render no textures (intel uhd graphics)

Jeu : Mario Kart World Système : Windows 11 Version : build-95

On Intel UHD integrated graphics, the game reportedly boots with no rendering or textures; later, some textures appeared gray. The reporter also reports crashes when teleporting during free roam.

GitHub issue · closed

[VBug] Flashing textures with GPU mode: FAST

Jeu : Ocarina of Time Système : Windows 11 Version : Frizti v3, `oot-gather-fix-00ef0ea6cc`

A commenter reports white flickering throughout the 3D world in the Frizti fork.

GitHub issue · open

[Crash]

Système : Windows 11 Version : build 93

A user reports that loading "oot remake" in build 93 stops and closes the emulator; they say build 88 worked.

GitHub issue · open

[AMD RX 9070 XT] Rainbow-colored graphical artifacts along mountain edges in Zelda OoT (Build 93)

Jeu : The Legend of Zelda: Ocarina of Time Système : Windows 11 Version : Build 93

Severe rainbow-colored graphical artifacts along mountain edges in Kakariko Village on an AMD Radeon RX 9070 XT.

GitHub issue · open

[GBug] Black Screen In AMD - Zelda Ocarina Of Time

Jeu : Zelda Ocarina of Time Système : Windows 11 Version : 75

Black screen after boot on AMD GPUs; reports describe working sound and title logo, but no game image.

GitHub issue · open

[Crash] Ocarina of time crash

Jeu : Other / not listed Système : Windows 11 Version : 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.

Jeu : Other / not listed Système : Linux; Windows reported by a commenter Version : 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 · closed

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

Jeu : The Legend of Zelda: Ocarina of Time Système : Windows 11 Version 26H2 Version : Build 75

A commenter reports subsequent boots hang at Loading Shaders 25 / 27 with use_disk_shader_cache = true.

Solution proposée : Delete cache/shader/0400486024dec000 and set use_disk_shader_cache = false.

GitHub issue · closed

[VBug] OoT (0400486024DEC000): world renders black except areas lit by Navi and around Link, AMD RX 9070

Jeu : The Legend of Zelda: Ocarina of Time Système : Windows 11 25H2 Version : build 80 (Lichii Development Build | fix/oot-upscaler-gathers-build-80)

On the reported Windows 11 system with a Radeon RX 9070, the world rendered almost entirely black after entering gameplay, with only lit areas and some white shapes visible; multi-second stalls were also reported during pipeline building and ASTC decodes.

GitHub issue · closed

[VBug] [nx2-build-75] Zelda: Ocarina of Time (0400486024DEC000) black screen — no AV1 decoder

Jeu : The Legend of Zelda: Ocarina of Time Système : Windows 11 Version : nx2-build-75

On nx2-build-75, AV1 video streams fail to decode and the game remains on a black screen despite booting and presenting frames.

GitHub issue · closed

[GBug] Zelda OOTR Won't Load

Jeu : The Legend of Zelda: Ocarina of Time Système : Windows Version : build 70; commenters also mention release-binaries #75, R75 MSVC, and R75 PGO

User reports include indefinite launching, white graphics, and a black screen in handheld mode or past the title screen. A separate report says it boots past the intro FMV in docked mode.

GitHub issue · closed

GPU crash

Jeu : Mario Kart World Système : Bazzite Version : nx2-3bdd53d08a

A user reported GPU crashes when booting on Bazzite with Mesa 26.2.4; the report was later said to concern an older nx2 build.

GitHub issue · open

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

Jeu : Other / not listed Système : Windows 11 Version : 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

[Crash] Emulator completely hangs, then full crashes at 11/14 shaders loaded: OOT

Jeu : Ocarina of Time Remake Système : Linux Version : Build-93

User reports the emulator hangs and crashes at 11/14 shaders loaded on Linux with AMD graphics when booting the game in Build-88 or Build-93.

GitHub issue · open

Switch 2 Pro Controller

GitHub issue · open

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

Jeu : The Legend of Zelda: Ocarina of Time (Switch 2) Système : Windows Version : 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

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

Jeu : Other / not listed Système : Linux Version : build-88

An AMD Linux report describes GPU/display blackout and VK_ERROR_DEVICE_LOST on entering gameplay without EDEN_NX2_NO_MESH=1; the user reports at least five minutes of gameplay with the option enabled. Another AMD Linux report describes intermittent SIGSEGV crashes that occur with or without the option.

GitHub issue · closed

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

Jeu : Other / not listed Système : Linux Version : 55532f2d81-nx2

Random dynarec crashes during gameplay, reported on Linux with AMD graphics cards; one report specifies an AMD RX 7000 series GPU.

GitHub issue · open

[Crash] Extreme low FPS (4 FPS) on RX 570 4GB - Zelda OoT Remake

Jeu : Zelda: OoT Remake Système : Windows 10 Version : build 93

Constant 4 FPS in-game on AMD Radeon RX 570 4GB.

GitHub issue · open

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

Jeu : Other / not listed Système : Windows 11 25H2 (build 26200) Version : 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

Jeu : Other / not listed Système : Linux Version : build 88

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

GitHub issue · open

[VBug] Mario tennis not show characters and sets

Jeu : Other / not listed Système : Windows 10 Version : 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

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

Jeu : Other / not listed Système : Windows 11 Version : 91

The game start cutscene renders only in the bottom half on an RX 6800.

GitHub issue · open

[Crash] Legend of green hat

Jeu : Other / not listed Système : macOS Version : build 88

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

GitHub issue · closed

[GBug] OoT (0400486024DEC000): the same ~60 cached graphics pipelines are rebuilt on the GPU thread every boot

Jeu : OoT Système : Windows 11 Version : build-83

On build-83, repeated graphics-pipeline builds on the GPU thread across boots cause a visible gameplay hitch.

Solution proposée : A user reported that build-88 (MSVC), which includes #194, fixed the issue for them; this is not a maintainer-confirmed fix.

GitHub issue · closed

[GBug] OoT (0400486024DEC000): the same ~60 cached graphics pipelines are rebuilt on the GPU thread every boot

Jeu : Ocarina of Time Système : Linux Version : build 83

A user reported repeated GPU-thread pipeline builds and tessellation-related warnings in one Linux session; recurrence across launches was not confirmed.

GitHub issue · open

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

Jeu : Ocarina of Time Système : Windows 11; Linux (Fedora 44 / Aurora) Version : Lichii nx2 build 88

Users report very low frame rates in the main menu and opening cutscene on Intel Arc GPUs; a Linux user also reports a prolonged shader stall on first boot and a frozen Kokiri intro cutscene.

GitHub issue · open

[Crash] Lichii crashes at OOT launch

Jeu : Zelda: Ocarina of Time Système : Windows 10 Version : Build 88

A user reports a crash when launching the game; the log reports failed backing-memory and fallback-buffer allocation.

GitHub issue · open

[VBug] OoT Slows on boot (still)

GitHub issue · open

[VBug] Oot is in a "nightmare mode"? also gameplay speed is at like 30%

Jeu : Legend of Green Hat Boy Système : Windows 11 25H2 Version : build-83

With GPU Mode: Accurate, gameplay runs at about 30 fps and in slow motion; the commenter attributes this to the GPU thread split not starting at high GPU accuracy. Shader pipeline builds can also cause stutter on new content.

Solution proposée : The commenter reports that changing GPU Mode to Fast resolved the slow-motion speed issue for them. For shader-build stutter, they report that an opt-in EDEN_NX2_ASYNC_DISCARD=1 skips draws while pipelines build.

GitHub issue · open

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

Jeu : Other / not listed Système : Windows 11

Black video on the PGO build; the game works well on MSV.

GitHub issue · closed

[VBug] OoT Slows when booting.

Jeu : OoT Système : Windows 11 Version : 83

The game runs slowly when booting.

GitHub issue · closed

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

Jeu : Other / not listed Système : Windows 11 Version : build 75

After the opening screen, audio plays but the display remains black.

GitHub issue · closed

[GBug] Audio disappears the legend of zelda

Jeu : Other / not listed Système : Windows 11 Version : 75

Music disappears during the cutscene after booting the game.

GitHub issue · closed

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

Jeu : The Legend of Zelda: Ocarina of Time Système : Windows 10 Version : 286117c7e0-nx2

A user reported an infinite startup launch loop when booting the .NUP version.

GitHub issue · closed

[VBug] OOTR Terrain visible trough objects

Système : Windows 11 Version : build-75

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

GitHub issue · closed

[GBug] Unable to start Pokopia. Constant Black Screen and GPU Idle at 16%

Jeu : Pokémon Pokopia Système : Windows 11 Version : Build 65

A user reports a constant black screen after booting and loading the game on Build 65.

GitHub issue · closed

Fortune's Weave boots but no visuals, only black screen

Jeu : Other / not listed Système : SteamOS Version : main

Fortune's Weave boots with sound and interaction but displays a black screen with no visuals.

GitHub issue · open

[VBug] OOT eventually turns into hard black screen outside of captions in handheld mode, renders as though looking through vaseline in docked mode

Jeu : OOT

Black screens during the introductory cinematic, GDT sequence, or gameplay; reports include intermittent black flashes and audio playing ahead of video.

GitHub issue · open

[VBug] OOT eventually turns into hard black screen outside of captions in handheld mode, renders as though looking through vaseline in docked mode

Jeu : OOT

Docked mode may show a black screen except for captions or HUD, while handheld mode may appear excessively bright, low resolution, or vaseline-like.

GitHub issue · open

[VBug] OOT eventually turns into hard black screen outside of captions in handheld mode, renders as though looking through vaseline in docked mode

Jeu : OOT Système : Linux

A commenter says many crashes with AMD graphics cards are related to mesh shaders.

GitHub issue · open

[Crash]

Jeu : Other / not listed Système : Linux Version : 5a50f50

On Linux with an AMD GPU, the game crashes in Deku Tree and may then remain stuck during shader compilation when booting.

Solution proposée : A commenter reports that starting Lichii with EDEN_NX2_NO_MESH=1 usually fixes the problem.

GitHub issue · open

[Bug] Windows build-83 can hang on Closing software after OoT gameplay

Jeu : Zelda: Ocarina of Time Système : Windows 11 Version : build-83

On Windows build-83, shutdown can hang at “Closing software…” after gameplay. Some sessions completed shutdown successfully; the cause is undetermined.

GitHub issue · open

[VBug] Regression: Legend of green hat blacks out

Jeu : Legend of Green hat boy Système : macOS Version : build 83

User reports the game blacks out when booted in build 83; they state it worked in build 75.

GitHub issue · open

[Crash after 5 - 10min BUILD 83] Legend of Green hat boy (PGO Crashes on boot)

Jeu : Legend of Green hat boy Système : Linux Version : 83

The emulator crashes after 5 to 10 minutes of gameplay on Linux with an AMD RX 9000 series GPU.

GitHub issue · open

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

Jeu : Other / not listed Système : Windows 11 Version : 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

Jeu : Other / not listed Système : macOS Version : build 75

Boots to a black screen with audio on macOS.

Solution proposée : Clear the cache and launch again.

GitHub issue · closed

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

Jeu : Other / not listed Système : Windows 11 Version : build-75

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

Lichii release

Release note · build-116

Jeu : Zelda: Ocarina of Time Système : Windows Version : build-116

AMD Radeon RX 6000 series and older on Windows crash while building shaders after boot. The release says this is fixed in build 117; RX 7000/9000 and NVIDIA are not affected.

Solution proposée : Update to build 117.

Vérification des jeux

Vérifier la compatibilité d’un jeu

Questions sur l’installation

FAQ sur l’installation

Dois-je d’abord supprimer l’ancienne version ?

Gardez la version qui fonctionne jusqu’à ce que la nouvelle soit installée et testée. Sauvegardez vos parties et votre configuration avant de changer de version.

Que vérifier si Windows signale une dépendance manquante ?

Conservez tous les fichiers associés de la même version dans le même dossier que lichii.exe. Recherchez le message exact de dépendance dans les notes de version ou le suivi des tickets.

La manette fonctionne dans les menus, mais pas dans mon jeu. Que faire ?

Vérifiez le profil de la manette et l’affectation des boutons, puis recherchez le modèle ou le jeu dans la section de dépannage.

Pourquoi un ticket fermé apparaît-il encore ici ?

« Fermé » est le statut dans le suivi des tickets. Lisez la discussion pour savoir si le problème a été résolu, déplacé ou si le ticket a été fermé pour une autre raison, et quelle version est concernée.

Quelles informations fournir lorsque je demande de l’aide ?

Indiquez la version de Lichii, le système d’exploitation, le GPU et son pilote, le texte complet de l’erreur et les étapes qui la déclenchent. Précisez si elle survient aussi dans une version qui fonctionnait auparavant.