Cómo instalar Dusklight (Twilight Princess PC) en Windows — Tutorial 2026

Instala Dusklight (antes Dusk), el port nativo para PC de The Legend of Zelda: Twilight Princess, en Windows 10 u 11. Verificación SHA-1, configuración del control y solución de errores comunes.

Publicado 2026-05-16 ·Actualizado 2026-06-20

Esta guía te explica paso a paso cómo instalar Dusklight — el port nativo para PC de The Legend of Zelda: Twilight Princess, lanzado por el equipo TwilitRealm el 9 de mayo de 2026 y renombrado de Dusk a Dusklight el 12 de mayo — en una PC con Windows 10 u 11.

Importante: Dusklight no es un emulador. Es un port nativo: el código del juego, recuperado mediante decompilación, se recompila directamente para PC. No necesitas Dolphin ni ningún otro emulador.

Tiempo necesario: ~10 minutos (si ya tienes tu disco volcado) Dificultad: Fácil


Antes de empezar

Necesitas tres cosas:

1. Una PC con Windows 10 u 11 de 64 bits

Dusklight distribuye binarios de 64 bits para Windows: x86_64 (Intel/AMD) y, desde v1.4.x, una build nativa ARM64 (Surface Pro X y otros equipos Windows on ARM). No existe versión de 32 bits.

2. Cualquiera de los siete backends gráficos compatibles

Dusklight soporta D3D12, D3D11, Metal (no aplica en Windows), Vulkan, OpenGL, OpenGL ES y WebGPU. Si tu GPU es de los últimos ~10 años y tiene los drivers actualizados, no tendrás problema. Puedes cambiar el backend desde Settings → Prelaunch → Graphics Backend si la selección automática no funciona.

3. Tu propio volcado del disco de GameCube de Twilight Princess

Dusklight no incluye los archivos del juego. Debes volcar legalmente tu propio disco original de GameCube. Si todavía no tienes el volcado, sigue primero la guía Cómo volcar legalmente tu disco de TP (en inglés por ahora).

Dusklight v1.4.1 acepta únicamente:

  • NTSC-U (USA), Game ID GZ2E01, SHA-1 75edd3ddff41f125d1b4ce1a40378f1b565519e7
  • PAL (Europa / Australia), Game ID GZ2P01, SHA-1 2601822a488eeb86fb89db16ca8f29c2c953e1ca

Los volcados NTSC-J (Japón) y Wii se reconocen pero se rechazan (verás “The selected game is not supported by Dusklight”). El soporte de Wii y NTSC-J está en la hoja de ruta.

Formatos de imagen de disco compatibles: ISO, GCM, CISO, GCZ, NFS, RVZ, WBFS, WIA, TGC.


Paso 1 — Descargar Dusklight

  1. Ve a la página oficial de releases: github.com/TwilitRealm/dusklight/releases
  2. Busca la última versión (actualmente v1.4.1, publicada el 16 de junio de 2026)
  3. En Assets, descarga el archivo que corresponda a tu equipo:
    • x86_64 (Intel/AMD): Dusklight-v1.4.1-win32-x86_64.zip (35.9 MB)
    • ARM64 (Windows on ARM, p. ej. Surface Pro X): Dusklight-v1.4.1-win32-arm64.zip (33.0 MB)

⚠️ Descarga únicamente desde la página oficial de GitHub releases o desde twilitrealm.dev. Evita sitios de “descarga gratis” y torrents: pueden contener malware o estar modificados.

⚠️ Cuidado con el nombre: existe un juego adulto llamado “Dusklight Manor” que no tiene ninguna relación con este port. Siempre verifica que descargas Dusklight de TwilitRealm para Twilight Princess.

Puedes verificar la descarga desde PowerShell:

Get-FileHash -Algorithm SHA256 .\Dusklight-v1.4.1-win32-x86_64.zip

Compara el hash impreso con el que publique la página oficial de release.


Paso 2 — Extraer el archivo ZIP

Haz clic derecho sobre el ZIP y elige Extraer todo…, o usa 7-Zip / WinRAR.

Extrae a una carpeta que recuerdes. Buenas opciones:

  • C:\Games\Dusklight\
  • D:\Emulacion\Dusklight\

Evita estas ubicaciones:

  • C:\Program Files\ — los permisos UAC pueden causar problemas con la configuración y las partidas guardadas
  • Carpetas sincronizadas por OneDrive / Dropbox — los conflictos de archivos pueden corromper tus partidas
  • Rutas con caracteres no ingleses eran una falla conocida en v1.0.0 (#807) — corregido desde v1.0.1. Si aún lo experimentas, actualiza a v1.4.1.

💡 Modo Portable: si extraes el ZIP en una carpeta que contiene una subcarpeta data/, Dusklight guardará partidas, packs de texturas y configuración ahí mismo en lugar de en %APPDATA%. Ideal para USB o sincronización manual.


Paso 3 — Verificar tu volcado de ROM

Antes de iniciar Dusklight, verifica que el SHA-1 de tu volcado coincide con una versión soportada. Esto evita el error más común al primer intento.

En PowerShell, navega a la carpeta donde está tu imagen de disco y ejecuta:

Get-FileHash -Algorithm SHA1 .\tu-volcado.iso

(Sustituye tu-volcado.iso por el nombre real de tu archivo.)

El resultado debe coincidir exactamente con uno de estos:

  • 75EDD3DDFF41F125D1B4CE1A40378F1B565519E7 (NTSC-U)
  • 2601822A488EEB86FB89DB16CA8F29C2C953E1CA (PAL)

Si ninguno coincide, tu volcado es uno de los siguientes:

  • Región incorrecta (NTSC-J / Wii / Corea — no soportadas todavía)
  • Corrupto (vuélcalo de nuevo con la verificación de checksum activada en CleanRip)
  • Una versión “scene” con modificaciones

Nota: Dusklight usa internamente hashes XXH128 (no SHA-1) para su verificación interna. El SHA-1 de arriba es para que tú compruebes externamente. Si tu SHA-1 coincide, el XXH128 también coincidirá.


Paso 4 — Iniciar Dusklight por primera vez

  1. Haz doble clic en Dusklight.exe dentro de la carpeta extraída
  2. Windows SmartScreen puede advertir que el editor no está verificado. Haz clic en Más informaciónEjecutar de todas formas. Esto es normal para cualquier aplicación sin firmar; Dusklight es open source y no está firmado con un certificado de código.
  3. Se abre el menú de prelaunch de Dusklight. El botón principal dice Select Disc Image.
  4. Haz clic. Se abre un diálogo nativo de Windows con el filtro “Game Disc Images” (extensiones: iso, gcm, ciso, gcz, nfs, rvz, wbfs, wia, tgc).
  5. Navega hasta tu volcado del disco y selecciónalo.
  6. Dusklight muestra el overlay “Verifying disc image” mientras calcula el XXH128. Tarda unos segundos.
  7. La línea de estado bajo el botón cambia a “Disc ready.”
  8. El botón principal ahora dice Play. Haz clic para iniciar el juego.

Si la verificación falla verás uno de estos mensajes exactos:

  • "The selected disc image could not be validated."
  • "Unable to read the selected file."
  • "The selected file is not a valid disc image."
  • "The selected game is not supported by Dusklight."
  • "Dusklight currently supports GameCube USA and PAL disc images only."
  • "The selected disc image did not pass hash verification..."

Para cada uno, consulta la sección de errores más abajo.


Paso 5 — Configurar tu control (mando)

La ruta exacta es:

Settings → Input → Controller → Configure Controller

Esto abre una ventana por puerto con pestañas Port 1, Port 2, … y secciones Controller / Buttons / Triggers / Sticks / Rumble. También hay una sección Options con los interruptores Enable Dead Zones y Emulate Triggers.

La mayoría de controles modernos funcionan plug-and-play:

Control / MandoNotas
Xbox Wireless / Xbox SeriesPlug-and-play
DualShock 4 / DualSenseNativo, giroscopio funciona
Switch Pro ControllerNativo, giroscopio funciona
8BitDo Pro 2 / UltimateNativo, giroscopio funciona
GameCube vía MayflashFunciona, se detecta como gamepad estándar

⚠️ Problema conocido: si tienes un adaptador USB Nintendo WUP-028 (oficial GameCube) conectado, no selecciones un control no-GCN desde el menú desplegable — esto activa un bug conocido en v1.0.0 (#810) que crea un archivo basura de 4 GiB. Desconecta el adaptador o selecciona el control correcto.

Para activar el apuntado por giroscopio (DS4, DualSense, Pro Controller, 8BitDo Pro 2):

Settings → Input → Gyro → Gyro Aim → activar

Para usar apuntado por ratón:

Settings → Input → Gyro → Gyro Input MethodMouse


Opcional · Migrar partidas desde Dolphin

Dusklight lee archivos estándar de partida de GameCube (.gci). Si venías jugando en Dolphin, puedes llevar tu partida.

Del FAQ oficial (twilitrealm.dev/faq):

“Solo copia el archivo 01-GZ2*-gczelda2.gci desde Dolphin a Dusklight.”

Las rutas exactas:

  • Carpeta de partidas de Dolphin (por defecto): Documentos\Dolphin Emulator\GC\USA\Card A\
    • Nombre del archivo: 01-GZ2E01-gczelda2.gci (o 01-GZ2P01-… si es PAL)
  • Carpeta de partidas de Dusklight: %APPDATA%\TwilitRealm\Dusklight\USA\Card A\
    • Sustituye USA por EUR si juegas con el disco europeo
    • Si actualizaste desde Dusk, tu carpeta anterior %APPDATA%\TwilitRealm\Dusk\ se migra automáticamente al primer arranque

Copia el archivo desde la carpeta de Dolphin a la de Dusklight. Reinicia Dusklight; la partida aparecerá en el menú de carga del juego.

Si tus partidas de Dolphin están en formato .raw en vez de .gci, usa la Memory Card Tool de Dolphin para extraer archivos .gci individuales primero. O bien cambia el formato de Dusklight en Settings → Prelaunch → Save File Type a Card Image (que usa .raw).


Errores comunes y soluciones

”The selected game is not supported by Dusklight.”

Cargaste una imagen de disco de Wii, japonesa, coreana u otra región no soportada. v1.4.1 solo acepta GameCube USA y PAL. El soporte de Wii / NTSC-J está planificado pero aún no lanzado.

”The selected disc image did not pass hash verification…”

Tu volcado está corrupto, modificado o es de la región incorrecta. Vuélvelo a volcar con CleanRip activando la verificación de checksum.

Falla silenciosa al iniciar en una cuenta de Windows con nombre de usuario no inglés

Era un bug de v1.0.0 (#807) — corregido desde v1.0.1 con soporte de rutas Unicode. Actualiza a v1.4.1 si todavía lo experimentas.

Pantalla negra con audio

Cambia el backend gráfico: Settings → Prelaunch → Graphics Backend → prueba D3D12, D3D11, Vulkan, OpenGL hasta que uno funcione.

El juego tiene tirones con framerate desbloqueado

Hay un bug conocido de bloom pulsante con Unlock Framerate activado (#825). Bloquea el framerate (desactiva Settings → Video → Rendering → Unlock Framerate) o convive con el artefacto visual por ahora.

El juego se queda atascado a 30 FPS aunque tenga Unlock Framerate activado

Revisa la lista de comprobación de 30 FPS (en inglés por ahora).

Para otros problemas, consulta la página de issues de Dusklight en GitHub antes de preguntar en su Discord.


¿Y ahora qué?

Las siguientes páginas todavía están en inglés; las traduciremos a español próximamente:


Última actualización: 2026-06-20. Actualizamos esta guía cuando los parches de Dusklight cambian el proceso de instalación.

← Todas las guías de instalación (EN) · Guía pilar (EN) →