Instalación y solución de problemas

Instalación y solución de problemas de Lichii Emulator

Desde la descarga hasta el primer inicio, configura los controles, añade tus juegos y resuelve los problemas que te impidan continuar.

Mandos separados, conexiones USB-C y una pantalla que ilustra la asignación de botones al configurar Lichii Emulator
Ilustración · Guía de instalación de Lichii Emulator
Latest recorded build build-117 Published November 7, 2026

Tres plataformas

Cómo instalar Lichii Emulator

Elige tu plataforma para seguir la instalación paso a paso.

Instalar Lichii en Windows

  1. Descarga los archivos disponibles para Windows (lichii-windows-x86_64-pgo.zip (x86_64), lichii-windows-x86_64.zip (x86_64)) de la versión oficial build-117 y conserva sus nombres originales.
  2. Extrae el archivo en una carpeta en la que tengas permiso de escritura. No ejecutes el programa directamente desde el archivo comprimido.
  3. Ejecuta lichii.exe desde la carpeta donde extrajiste los archivos. Si Windows muestra un aviso de seguridad, comprueba que el archivo venga del enlace oficial de la versión antes de decidir si continúas.

¿Necesitas otro paquete? Ver descargas para windows.

Instalar Lichii en Linux

  1. Entre los archivos publicados para Linux (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)), elige el que corresponda a la arquitectura de tu sistema y descárgalo desde el enlace de la versión.
  2. Para lichii-linux-aarch64-pgo.AppImage, ejecuta chmod +x 'lichii-linux-aarch64-pgo.AppImage' en la carpeta que contiene el archivo descargado y abre ese AppImage.
  3. Para lichii-linux-aarch64-pgo.tar.gz, extrae primero el archivo y ejecuta el programa incluido desde la carpeta de extracción. Si indica que falta una dependencia de glibc o Qt, consulta las notas de la versión seleccionada y la incidencia original para ver qué versión de la dependencia necesitas.
  4. Conserva la URL y la etiqueta de la versión junto con el archivo instalado para poder asociar un futuro resultado de compatibilidad a esa misma versión.

Indicaciones de la versión

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

¿Necesitas otro paquete? Ver descargas para linux.

Instalar Lichii en macOS

  1. Entre los archivos publicados para macOS (lichii-macos-arm64.dmg (arm64), lichii-macos-arm64.zip (arm64)), elige el que corresponda a la arquitectura de tu sistema y descárgalo desde el enlace de la versión.
  2. Para lichii-macos-arm64.dmg, abre el DMG y mueve la aplicación a una carpeta que puedas gestionar, como Aplicaciones.
  3. Para lichii-macos-arm64.zip, abre el ZIP y mueve la aplicación a una carpeta que puedas gestionar. Si macOS pide confirmación la primera vez, haz clic derecho en la aplicación y elige Abrir.
  4. Si macOS muestra un aviso de seguridad, compara la descarga con la versión oficial antes de continuar. Mantén activadas las protecciones habituales del sistema.
  5. Abre Lichii desde la carpeta donde colocaste la aplicación.

Indicaciones de la versión

  • macOS arm64 requires macOS 15 or newer.

¿Necesitas otro paquete? Ver descargas para macos.

Primer inicio

Configuración inicial

Configura Lichii desde el primer inicio: elige una asignación de botones que te resulte cómoda, ajusta los gráficos y prepara tu biblioteca de juegos.

Gráficos

Empieza con los ajustes gráficos que indican las notas de tu versión. Cambia un solo ajuste cada vez y anota la etiqueta de la versión junto con cualquier resultado que registres.

Para tener un punto de partida para un juego concreto, consulta su informe de compatibilidad.

Dispositivos de entrada

Conecta el mando, asigna los botones y guarda el perfil. Si algún botón no funciona, busca el modelo de tu mando y la versión de Lichii en la sección de solución de problemas.

Tus archivos de juego

Añade los juegos que hayas obtenido legalmente desde la biblioteca o con la opción de abrir archivos de juego de Lichii. Los juegos, las claves y el firmware se obtienen por separado.

Indicaciones oficiales de instalación actuales

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

Vuelve a jugar

Errores frecuentes en Lichii y cómo solucionarlos

453 registros de problemas

GitHub issue · closed

[Crash] Ocarina of Time Remake crash after intro cinematic

Juego: The Legend of Zelda: Ocarina of Time Sistema: Windows 10; Windows 11 Versión: 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.

Solución sugerida: 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

Juego: The Legend of Zelda: Ocarina of Time Sistema: Windows 11 Versión: 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.

Solución sugerida: 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

Juego: Ocarina of Time Sistema: macOS Versión: 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

Juego: The Legend of Zelda: Ocarina of Time Sistema: Windows 11 and Windows 10 Versión: 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

Juego: 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

Juego: 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.

Solución sugerida: 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?

Juego: 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

Juego: The Legend of Zelda: Ocarina of Time (Switch 2) Sistema: CachyOS (Arch Linux), KDE Plasma / Wayland Versión: 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

Juego: The Legend of Zelda: Ocarina of Time (Switch 2) Sistema: CachyOS, KDE Plasma, Linux; Wayland and XWayland reported Versión: 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

Sistema: Windows 11 Versión: 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)

Juego: OoT Sistema: Windows 11 Versión: 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)

Juego: The Legend of Zelda: Ocarina of Time (Switch 2) Sistema: Linux (CachyOS) Versión: 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

Juego: Other / not listed Sistema: Windows 11 Versión: 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

Juego: Other / not listed Versión: Build 93

A commenter reports slow motion in Build 93.

GitHub issue · closed

[VBug] OOT - Solar Flare in Field

Juego: Other / not listed Sistema: Linux Versión: 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

Juego: Other / not listed Sistema: Windows 11 Versión: 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)

Juego: The Legend of Zelda: Ocarina of Time Sistema: Windows 11 Versión: 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

Sistema: Windows 11 Versión: 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

Juego: Zelda: Ocarina of Time Sistema: Windows 10/11 Versión: 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

Juego: Other / not listed Sistema: Linux Versión: 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

Juego: The Legend of Zelda: Ocarina of Time Sistema: Windows 11 Versión: 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

Juego: Ocarina of Time Sistema: Linux Versión: 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.

Solución sugerida: 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

Juego: Mario Kart World Sistema: Linux Versión: 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.

Juego: OOT REMAKE Sistema: Other Versión: 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)

Juego: OoT Sistema: Linux Versión: 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)

Juego: OoT Sistema: Windows 11 Pro 64-bit

The same slow-motion cutscene problem is reported.

GitHub issue · open

[GBug] Cutscenes running in slow motion(OoT)

Juego: OoT Sistema: Windows 11 Home

The same slow-motion cutscene problem is reported.

GitHub issue · open

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

Sistema: Windows 11 Versión: build 115

Blocky reflections on water around the playable character.

GitHub issue · open

[Crash] OOT: Failed to load VPDAU

Juego: Other / not listed Sistema: Linux Versión: 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

Juego: Ocarina of Time Sistema: 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.

Solución sugerida: 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

Juego: The Legend of Zelda: Ocarina of Time Sistema: Windows 11 Versión: 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

Sistema: Windows 11 Versión: 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

Juego: The Legend of Zelda: Ocarina of Time Sistema: Windows 11 Versión: 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.

Solución sugerida: 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

Sistema: Linux Versión: 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

Juego: Other / not listed Sistema: Linux Versión: 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

Juego: Other / not listed Sistema: Linux Versión: 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.

Solución sugerida: 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

Juego: Ocarina of Time Sistema: Windows 11 Versión: 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

Juego: Ocarina of Time Sistema: Windows 10 Versión: 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

Juego: 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

Juego: The Legend of Zelda: Ocarina of Time Sistema: Windows 11 Versión: 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

Juego: 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)

Juego: Ocarina of Time Sistema: Windows 11 Versión: nx2 55532f2d81 (build-88)

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

Solución sugerida: #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.

Juego: Other / not listed Sistema: Windows 11 Versión: build 88

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

Solución sugerida: 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)

Juego: 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.

Solución sugerida: 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

Sistema: Windows 11 Versión: 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.

Juego: Other / not listed Sistema: Linux Versión: 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)

Juego: Mario Kart World Sistema: Windows 11 Versión: 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

Juego: Ocarina of Time Sistema: Windows 11 Versión: Frizti v3, `oot-gather-fix-00ef0ea6cc`

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

GitHub issue · open

[Crash]

Sistema: Windows 11 Versión: 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)

Juego: The Legend of Zelda: Ocarina of Time Sistema: Windows 11 Versión: 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

Juego: Zelda Ocarina of Time Sistema: Windows 11 Versión: 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

Juego: Other / not listed Sistema: Windows 11 Versión: 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.

Juego: Other / not listed Sistema: Linux; Windows reported by a commenter Versión: 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)

Juego: The Legend of Zelda: Ocarina of Time Sistema: Windows 11 Version 26H2 Versión: Build 75

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

Solución sugerida: 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

Juego: The Legend of Zelda: Ocarina of Time Sistema: Windows 11 25H2 Versión: 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

Juego: The Legend of Zelda: Ocarina of Time Sistema: Windows 11 Versión: 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

Juego: The Legend of Zelda: Ocarina of Time Sistema: Windows Versión: 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

Juego: Mario Kart World Sistema: Bazzite Versión: 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

Juego: Other / not listed Sistema: Windows 11 Versión: 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

Juego: Ocarina of Time Remake Sistema: Linux Versión: 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)

Juego: The Legend of Zelda: Ocarina of Time (Switch 2) Sistema: Windows Versión: 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)

Juego: Other / not listed Sistema: Linux Versión: 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.

Juego: Other / not listed Sistema: Linux Versión: 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

Juego: Zelda: OoT Remake Sistema: Windows 10 Versión: 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)

Juego: Other / not listed Sistema: Windows 11 25H2 (build 26200) Versión: 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

Juego: Other / not listed Sistema: Linux Versión: 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

Juego: Other / not listed Sistema: Windows 10 Versión: 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)

Juego: Other / not listed Sistema: Windows 11 Versión: 91

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

GitHub issue · open

[Crash] Legend of green hat

Juego: Other / not listed Sistema: macOS Versión: 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

Juego: OoT Sistema: Windows 11 Versión: build-83

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

Solución sugerida: 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

Juego: Ocarina of Time Sistema: Linux Versión: 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

Juego: Ocarina of Time Sistema: Windows 11; Linux (Fedora 44 / Aurora) Versión: 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

Juego: Zelda: Ocarina of Time Sistema: Windows 10 Versión: 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%

Juego: Legend of Green Hat Boy Sistema: Windows 11 25H2 Versión: 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.

Solución sugerida: 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

Juego: Other / not listed Sistema: Windows 11

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

GitHub issue · closed

[VBug] OoT Slows when booting.

Juego: OoT Sistema: Windows 11 Versión: 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

Juego: Other / not listed Sistema: Windows 11 Versión: build 75

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

GitHub issue · closed

[GBug] Audio disappears the legend of zelda

Juego: Other / not listed Sistema: Windows 11 Versión: 75

Music disappears during the cutscene after booting the game.

GitHub issue · closed

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

Juego: The Legend of Zelda: Ocarina of Time Sistema: Windows 10 Versión: 286117c7e0-nx2

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

GitHub issue · closed

[VBug] OOTR Terrain visible trough objects

Sistema: Windows 11 Versión: 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%

Juego: Pokémon Pokopia Sistema: Windows 11 Versión: 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

Juego: Other / not listed Sistema: SteamOS Versión: 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

Juego: 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

Juego: 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

Juego: OOT Sistema: Linux

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

GitHub issue · open

[Crash]

Juego: Other / not listed Sistema: Linux Versión: 5a50f50

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

Solución sugerida: 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

Juego: Zelda: Ocarina of Time Sistema: Windows 11 Versión: 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

Juego: Legend of Green hat boy Sistema: macOS Versión: 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)

Juego: Legend of Green hat boy Sistema: Linux Versión: 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

Juego: Other / not listed Sistema: Windows 11 Versión: 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

Juego: Other / not listed Sistema: macOS Versión: build 75

Boots to a black screen with audio on macOS.

Solución sugerida: Clear the cache and launch again.

GitHub issue · closed

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

Juego: Other / not listed Sistema: Windows 11 Versión: 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

Juego: Zelda: Ocarina of Time Sistema: Windows Versión: 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.

Solución sugerida: Update to build 117.

Consulta de juegos

Comprobar la compatibilidad de un juego

Dudas sobre la instalación

Preguntas frecuentes sobre la instalación

¿Debo eliminar primero la versión anterior?

Conserva la versión que funciona hasta que hayas instalado y probado la nueva. Haz una copia de seguridad de tus partidas y tu configuración antes de cambiar de versión.

¿Qué debo comprobar si Windows indica que falta una dependencia?

Conserva todos los archivos auxiliares de la misma versión en la misma carpeta que lichii.exe. Busca el mensaje exacto de la dependencia en las notas de la versión o en el gestor de incidencias.

El mando funciona en los menús, pero no en el juego. ¿Qué hago?

Revisa el perfil de entrada y la asignación de botones. Después, busca el modelo de tu mando o el juego en la sección de solución de problemas.

¿Por qué sigue apareciendo aquí una incidencia cerrada?

«Cerrada» es el estado en el gestor de incidencias. Lee la conversación para saber si el problema se resolvió, se trasladó o la incidencia se cerró por otro motivo, y qué versión está afectada.

¿Qué información debo incluir al pedir ayuda?

Indica la versión de Lichii, el sistema operativo, la GPU y su controlador, el texto completo del error y los pasos que lo provocan. Aclara si también ocurre en una versión que antes funcionaba.