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

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

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

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

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

[GBug] Ocarina of Time (Switch 2): playable on RX 9070 XT with build 93, ~29 FPS in Kokiri Forest, one thread at 99%

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

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

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

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

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

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

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

Juego: The Legend of Zelda: Ocarina of Time (Switch 2) Sistema: Windows 11 26H2 Versión: nx2-build-92

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

GitHub issue · closed

[Crash]

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

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

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

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

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

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

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.