Dusklight (Twilight Princess) — Problemas conocidos y soluciones

Bugs reales de Dusk/Dusklight rastreados en GitHub — qué arregló v1.0.1 (Apple Silicon, nombres no ingleses en Windows, pelo de Ilia, partidas en iOS) y qué sigue abierto.

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

Esta es una lista de issues verificada — cada entrada de abajo tiene como fuente un issue real de GitHub, una entrada del FAQ oficial, o un reporte comunitario de múltiples usuarios. No listamos “errores comunes” que no hemos visto reportados realmente.

Si tu problema específico no está aquí, revisa la página de issues de Dusklight en GitHub para los últimos reportes, o pregunta en el Discord del equipo en discord.gg/dusktp (gestionado por ellos — no por nosotros).

Última actualización: 2026-06-20. La mayoría de los estados de los issues abajo reflejan la verdad de campo a la fecha del release de v1.0.1 el 2026-05-11; ver las notas de v1.4.0 y v1.4.1 para los fixes adicionales lanzados el 2026-06-16.

Saltar a un issue específico

Cada issue de abajo también tiene su propia página enfocada con un fix autocontenido. Buscables por mensaje de error:

Cuelgues y fallos de lanzamiento

Cuelgue de shader-cache en Apple Silicon (#826) — abierto en v1.0.1
macOS “Dusklight is damaged and can’t be opened” — fix de Gatekeeper
Linux AppImage “Couldn’t create directory /TwilitRealm” (#818)
Cuelgue en cinemática / lago de Faron en Windows (#819)

Disco / ROM

Control e input

Adaptador GameCube WUP-028 crea archivo basura de 4 GiB (#810)

Gráficos

Rendimiento

Atascado en 30 FPS aun con Unlock Framerate

Migración de partidas

Partida guardada de Dolphin no carga en Dusklight

La lista completa categorizada (con workarounds y citas de fuentes) continúa abajo.

✅ Arreglado por v1.0.1 (2026-05-11)

Si estabas en v1.0.0 y golpeaste uno de estos, actualiza a v1.0.1.

Issue	Síntoma	Fix de v1.0.1
#779, #805	Cuelgue de lanzamiento en Apple Silicon	Cerrado por el colaborador tomlube: “Fixed in 1.0.1”
#807	Fallo silencioso al iniciar con nombre de usuario no inglés en Windows	Manejo de rutas Unicode añadido
#804	Partida guardada en iOS no accesible al usuario	Los datos de Dusklight ahora aparecen en la app Files en Android + iOS; nuevo menú “Open Data Folder” bajo Settings → Interface
#821	Recording Mode mata la música hasta reiniciar	Arreglado
#827	Ilia sin pelo en Android (alpha-discard de Adreno)	Workaround incluido
#830	Asignación de teclado en macOS rota	Arreglado
Mapeos por defecto del control (Z/Back)	Mapeo por defecto incorrecto	Defaults corregidos
Nombres de ejes de sensibilidad de giroscopio invertidos	Etiquetas Pitch/yaw desfasadas	Etiquetas corregidas
Congelado al minimizar ventana	Algunas configuraciones congelaban al minimizar	Arreglado
Cuelgue por escalado de monitor	Cuelgue al mover entre monitores con DPI distinto	Arreglado

Para las notas completas del parche de v1.0.1, ver el changelog.

✅ También arreglado por v1.4.0 (2026-06-16)

La v1.4.0 arregló varios cuelgues y bugs que no están rastreados individualmente en esta página pero que vale la pena anotar si los golpeas:

Cuelgue al hablar con el Zora bajo la cascada en el Dominio Zora
Cuelgue en la Villa Oculta tras obtener el Amuleto de Ilia de Impaz
Cuelgue de carga del mono en el Templo del Bosque
Reaparecer en la fase final de la pelea contra Zant
Textura y tearing de la capa de Ganondorf
Problemas de rendimiento y cuelgues con el renderizado del mapa
Soporte de macOS 12 restaurado

Ver el changelog para las notas completas de v1.4.0.

✅ También corregido en v1.4.1 (2026-06-16)

La v1.4.1 es un hotfix publicado el mismo día que v1.4.0 para corregir varias regresiones detectadas tras el lanzamiento. Si los golpeas, actualiza a v1.4.1:

Regresiones en el reemplazo de texturas de v1.4.0 (orden de carga y texturas de UI ausentes)
Regresión de rendimiento en algunas GPU (en particular AMD en Windows)
Problemas de foco de teclado en Android e iOS
Problema del bloqueo de aspecto 4:3 en GPU PowerVR
El menú oculto de Dusklight seguía recibiendo input en algunas circunstancias
Regresión del fallback del backend de GPU

Ver el changelog para las notas completas de v1.4.1.

Cuelgues y fallos de lanzamiento

Cuelgue de shader-cache en Apple Silicon (separado de #779/#805)

Issue: #826 Síntoma: Cuelgue al lanzar en Macs con chip M con un fallo de compilación de shader RmlUi Gradient Pipeline en WebGPU/Metal. Este es un bug distinto del cuelgue original “Dusk quit unexpectedly” por símbolo faltante en dyld documentado en v1.0.0 — ese era #779 / #805 y está cerrado en v1.0.1. Estado (2026-05-13): Abierto, bajo investigación. Etiquetado como “Known shader cache crash on macOS currently.” Workarounds:

Prueba un backend gráfico distinto en Settings → Prelaunch → Graphics Backend — cicla Metal / Vulkan / OpenGL
Vigila #826 para actualizaciones del fix

Nombre de usuario no inglés en Windows — ARREGLADO en v1.0.1

Issue: #807 — cerrado Era: Dusklight no se iniciaba cuando el nombre de usuario de Windows contenía caracteres no latinos (p.ej., C:\Users\ミドナ). Fix: Manejo de rutas Unicode incluido en v1.0.1 (2026-05-11). Actualiza a v1.0.1 si te afecta.

Linux AppImage: “Couldn’t create directory ‘/TwilitRealm’”

Issue: #818 Síntoma: En Linux (reportado en CachyOS), una variante AppImage falla al iniciar con:

[fatal] [dusk] Unable to get PrefPath: Couldn't create directory '/TwilitRealm': 'Permission denied'

Estado: Abierto. Afecta a una variante AppImage; las builds oficiales .zip no se ven afectadas. Workarounds:

Usa Dusk-v1.0.0-linux-x86_64.zip (o linux-arm64.zip) en vez de cualquier AppImage
Si ya ejecutaste el AppImage, limpia: sudo rm -rf /TwilitRealm

Mac: “Dusklight is damaged and can’t be opened”

Causa: Atributo de cuarentena de Gatekeeper. Dusklight no está notarizado. Estado: Comportamiento esperado en el primer lanzamiento (no es un bug per se). Fix: En Terminal:

xattr -cr /Applications/Dusklight.app

Luego ejecuta normalmente. O clic derecho → Abrir la primera vez.

Cuelgues aleatorios a mitad de cinemática / a mitad de juego (Windows)

Issue: #819 Setup del reporter: Windows 11, i9-13980HX, RTX 4060, control Xbox One. Síntoma: Cuelgues durante cinemáticas específicas (diálogo de Zelda, diálogo de Ordona) y durante el platforming del lago envenenado de los Bosques de Farone. El reporter tenía Fast Spinner, Fast Iron Boots y pantalla completa activados. Estado: Abierto. Workarounds:

Desactiva opciones tipo cheat (Fast Spinner, Fast Iron Boots) antes de cinemáticas clave
Prueba modo ventana en vez de pantalla completa
Vigila el issue enlazado para actualizaciones

Problemas de disco / ROM

”The selected disc image did not pass hash verification”

Causa: El XXH128 de tu volcado no coincide con el hash esperado por Dusklight. Más a menudo: volcado corrupto, región equivocada, o un lanzamiento modificado/scene. Fix:

Verifica el SHA-1 de tu volcado:
- Windows: Get-FileHash -Algorithm SHA1 tuvolcado.iso
- macOS / Linux: shasum -a 1 tuvolcado.iso
Debe coincidir exactamente con:
- 75edd3ddff41f125d1b4ce1a40378f1b565519e7 (NTSC-U)
- 2601822a488eeb86fb89db16ca8f29c2c953e1ca (PAL)
Si ninguno coincide, vuelve a volcar usando la guía legal de volcado (en inglés) con la verificación de checksum activada.

”The selected game is not supported by Dusklight”

Causa: Cargaste una imagen de disco de GameCube Japón, Wii, Wii Corea, o Wii U HD. v1.0.0 solo acepta GameCube NA y PAL. Fix: Usa un volcado de disco de GameCube NA (GZ2E01) o PAL (GZ2P01). Otras regiones están en la hoja de ruta del proyecto (según el README).

ISO modificado no carga

Comportamiento: La discrepancia de hash es esperada cuando modificas el ISO (p.ej., aplicando el mod del personaje Linkle). Dusklight muestra una advertencia pero ofrece un camino “Continue anyway”:

“Just install the [mod] as you usually would directly to the GameCube or Wii .iso and then direct Dusklight to that modded .iso file and confirm that you still want to use it when it tells you it’s probably corrupted or modified.” — TomoAries, r/pcgaming, 14 upvotes

Así que los mods funcionan — Dusklight solo te avisa que el hash difiere de los valores conocidos como buenos.

Problemas de control e input

Seleccionar un control no-GCN con el adaptador WUP-028 crea archivo basura de 4 GiB

Issue: #810 Síntoma: Con el adaptador USB de GameCube WUP-028 de Nintendo conectado, seleccionar un control no-GCN del desplegable escribe un archivo basura de 2^32 + 32 bytes (~4 GiB), casi todo ceros. Causa cuelgues largos en HDDs y cuelgues breves en SSDs. Estado: Abierto. Workarounds:

Desconecta el adaptador WUP-028 antes de cambiar la selección de control
O elige el control GCN coincidente en el desplegable

No se puede asignar teclado en macOS — ARREGLADO en v1.0.1

Issue: #830 — cerrado Era: La asignación de teclado a través de la UI de configuración de control de Dusklight no funcionaba en macOS. Fix: Asignaciones de teclado reparadas en v1.0.1 (2026-05-11). Actualiza a v1.0.1 si te afecta.

El Steam Controller deja el cursor del ratón en pantalla

Issue: #811 Síntoma: Al usar un Steam Controller, el cursor del ratón permanece visible durante el juego. Estado: Abierto.

El rumble del AYN Thor no funciona

Issue: #812 Estado: Abierto. El portátil AYN Thor está soportado; el rumble específicamente está roto.

No se pueden reasignar los controles de interfaz (menú)

Issue: #824 Síntoma: Puedes reasignar los controles del juego pero no los controles de navegación de menú / UI. Estado: Solicitud de mejora abierta.

Sin navegación de menú con D-Pad

Issue: #814 Síntoma: El D-Pad no navega los menús. Estado: Solicitud de mejora abierta.

Confusión del mapeo del hombro derecho / Z

Reporte comunitario: usuario de r/pcgaming LargeBirdInATree:

“Right Bumper is mapped to Right Trigger under ‘Digital Trigger’. I don’t know what ‘Digital Trigger’ is, and pressing left and right shoulder doesn’t appear to do anything.”

Workaround: En Settings → Input → Controller → Configure Controller → Triggers, la terminología “Digital Trigger” se refiere a si los gatillos reportan como analógicos o digitales. Cicla por las configuraciones hasta que los bumpers + gatillos coincidan con lo que tu control físico espera.

Problemas de gráficos / pantalla

Bloom pulsante con framerate desbloqueado

Issue: #825 (etiqueta: Interpolation) Síntoma: El efecto bloom pulsa notablemente cuando Settings → Video → Rendering → Unlock Framerate está activado. Estado: Abierto. Workaround: Bloquea el framerate (desactiva Unlock Framerate) hasta que se parchee.

Cinemáticas 21:9 recortadas verticalmente

Issue: #813 Síntoma: En pantallas ultrawide (21:9), las cinemáticas in-game se recortan arriba y abajo. Estado: Abierto. Workaround: Usa 16:9 para cinemáticas, o bloquea el aspect ratio 4:3 (Settings → Video → Display → Lock 4:3 Aspect Ratio) — esto último asegura encuadre consistente todo el rato.

Sombras de la mesa en casa de Bo recortadas

Issue: #815 Síntoma: Bug específico de iluminación en la casa de Bo en la Villa Ordon. Estado: Abierto.

El mini-mapa se mueve con modo espejo activado

Issue: #809 Síntoma: Bug cosmético de posicionamiento del mini-mapa en modo espejo. Estado: Abierto.

Tirones al cambiar a primera persona

Issue: #816 Síntoma: Hitch breve al cambiar a vista en primera persona. Estado: Abierto.

La resolución interna se ve como 4:3 incluso con bloqueo 4:3 desactivado

Reporte comunitario (r/SteamDeck): usuario SEANPLEASEDISABLEPVP (3 upvotes):

“the ‘internal resolution’ setting for me defaults to 1216×896 for some reason, it looks like a 4:3 aspect ratio even though that’s turned off. EDIT: Nevermind, I had to toggle fullscreen lol.” Workaround (verificado): Alterna pantalla completa on/off en Settings → Video → Display → Toggle Fullscreen.

Problemas de audio

Recording Mode mata la música hasta reiniciar — ARREGLADO en v1.0.1

Issues: #821, #832 — cerrados Era: Apagar Settings → Interface → Recording Mode no reactivaba la música; requería reiniciar Dusklight. Fix: v1.0.1 (2026-05-11). La música se reactiva correctamente cuando Recording Mode se desactiva.

Problemas de móvil (Android e iOS)

Android: Ilia sin pelo — ARREGLADO en v1.0.1

Issue: #827 — workaround incluido Era: En varios dispositivos Android (Retroid Pocket 5, serie Samsung Galaxy y otros), el modelo del personaje Ilia se renderizaba sin pelo. Confirmado por múltiples usuarios de Reddit (splashtext 43 upvotes, Shizzawn, OutsiderInCider). Fix: v1.0.1 (2026-05-11) incluye un workaround del driver de GPU Adreno para alpha discard. Actualiza a v1.0.1.

Android: bug visual en Galaxy S26 Ultra (“string cheese”)

Issue: #801 Estado: Abierto. La Adreno 840 (Snapdragon 8 Elite Gen 5) parece tener múltiples problemas residuales — texturas estiradas, explosiones de vértices, bugs de LOD. Rastreado junto con #750, #846, #1184. Según el README oficial: “we are also aware of a number of issues on devices with Adreno GPUs and are working to resolve them.”

iOS: ubicación de partida no accesible al usuario — ARREGLADO en v1.0.1

Issue: #804 — cerrado Era: El archivo de partida vivía en el sandbox de la app de iOS; no visible en la app Files para backup o transferencia. Fix: v1.0.1 (2026-05-11) hace los datos de Dusklight visibles en la app Files tanto en iOS como en Android. También añade un nuevo menú Settings → Interface → Open Data Folder que salta directamente a la ubicación.

Ruta del sandbox de partidas en Android

El identificador de paquete de Android es dev.twilitrealm.dusk (no com.twilitrealm.dusk). Las partidas viven bajo /sdcard/Android/data/dev.twilitrealm.dusk/files/ con estructura que incluye Texture_Replacement/. Desde v1.0.1 en adelante, usa el botón Open Data Folder dentro de la app en lugar de navegar manualmente.

Problemas de migración de partidas

La partida de Dolphin no aparece en Dusklight

Causa: Nombre de archivo equivocado, ruta equivocada o formato de partida equivocado. Fix (según el FAQ oficial):

El archivo de partida de Dolphin está en:
- Windows: Documents\Dolphin Emulator\GC\USA\Card A\01-GZ2E01-gczelda2.gci
- macOS: ~/Library/Application Support/Dolphin/GC/USA/Card A/01-GZ2E01-gczelda2.gci
- Linux: ~/.local/share/dolphin-emu/GC/USA/Card A/01-GZ2E01-gczelda2.gci
La carpeta de partidas de Dusklight está en:
- Windows: %APPDATA%\TwilitRealm\Dusklight\USA\Card A\
- macOS: ~/Library/Application Support/TwilitRealm/Dusklight/USA/Card A/
- Linux: ~/.local/share/TwilitRealm/Dusklight/USA/Card A/
Reemplaza USA por EUR si usas el disco PAL

Si tu partida de Dolphin está en formato .raw (una imagen de memory card en lugar de .gci separados), usa la Memory Card Tool de Dolphin para extraer los .gci individuales primero. O cambia el Settings → Prelaunch → Save File Type de Dusklight a Card Image para usar .raw directamente.

Partida cargada pero el progreso no se conserva

Puede que hayas cargado un slot de partida vacío. En TP, carga desde Card A (que es lo que representa 01-GZ2*-gczelda2.gci). Los otros slots están típicamente vacíos.

Problemas de rendimiento

Atascado en 30 FPS aun con Unlock Framerate activado

Reporte comunitario (r/pcgaming): usuario Thr0waway_Joe:

“I can’t get it past 30fps. Even with unlocked fps” Estado: Esporádico, sin causa raíz definitiva a v1.0.0. Posibles causas:

VSync todavía limitando (Settings → Video → Display → Enable VSync → desactivar)
Tope de tasa de refresco del monitor
Cuello de botella del backend gráfico — prueba otro (Settings → Prelaunch → Graphics Backend)

Rendimiento más bajo de lo esperado

Baja la Internal Resolution (Settings → Video → Resolution)
Limita el framerate a 60 en vez de desbloqueado
Desactiva el post-procesado (Settings → Video → Post-Processing → Bloom)
Prueba un backend gráfico distinto (D3D12 / Vulkan suelen ser los más rápidos en PC; Metal en Mac; OpenGL ES en móvil)

Reportes “disputados” / “resueltos"

"La batalla de Mirror Link es inganable con FPS desbloqueados” (DISPUTADO)

Un usuario (r/pcgaming, WiglyWorm, 10 upvotes) afirmó:

“I just watched a video where someone was playing this game uncapped and certain things like the mirror link battle were actually unwinnable due to FPS changes.”

Contra-aclaración por liamwilliams93:

“on this recomp it still runs the game logic at 30fps and uses interpolation to render at higher frame rates”

Veredicto: El diseño de Dusklight desacopla la lógica (30 Hz) del renderizado. La “rotura de gameplay atada a FPS” no es como funciona Dusklight. El usuario original puede haber estado pensando en un esquema de parche de Dolphin o de un intento previo de port. La interpolación de Dusklight no afecta el timing de la lógica del juego.

Bugs ya arreglados (no los re-reportes)

Estos fueron arreglados en v0.x.x → v1.0.0 — si estás en v1.0.0, no aplican:

Rutas Unicode en carpeta appdata de Windows (#767, #755 — cerrados)
Ejes de sensibilidad del giroscopio invertidos (#764, #759 — cerrados)
Linux x86_64 no arrancaba tras configurar settings (#788 — cerrado)
Intercambio por defecto de B / X del control de GameCube (#732 — cerrado)
Bug inicial de Recording Mode silenciando streams (distinto de #821) (#735 — cerrado)
Mac: No se abre tras hacer clic en setting de livesplit (#773 — cerrado)

Si estás golpeando uno de estos, puede que estés en una versión vieja. Actualiza a v1.0.0.

Cómo reportar un nuevo bug

Si tu problema no está en esta lista:

Revisa la página de GitHub Issues de Dusklight (puede que alguien lo haya reportado)
Si es nuevo, abre un nuevo issue en GitHub con:
- OS + versión
- Versión de Dusklight
- Pasos para reproducir
- Capturas si es visual
O publica en el Discord del equipo de Dusklight en discord.gg/dusktp

Nosotros no aceptamos reportes de bugs para Dusklight — somos un sitio de contenido independiente, no el proyecto. Los reportes van directamente a TwilitRealm.

Historial de versiones de esta página

Fecha	Cambio
2026-05-10	Publicación inicial basada en snapshot de issues de GitHub de v1.0.0 + reportes comunitarios del día de lanzamiento
2026-06-16	Añadida nota de fixes de cuelgues de v1.4.0 (cascada Zora, Villa Oculta, mono del Templo del Bosque, fase final de Zant, renderizado de mapa, macOS 12)
2026-06-20	Añadida nota de fixes de v1.4.1 (regresiones de reemplazo de texturas, rendimiento AMD en Windows, foco de teclado Android/iOS, aspecto 4:3 en PowerVR, input del menú oculto, fallback del backend de GPU)

Esta página refleja el estado en v1.0.0 a 2026-05-10. Dusklight publica parches con frecuencia — guarda en marcadores y vuelve a revisar, o vigila la página de GitHub releases para lo último.

← Guía pilar · Guías de instalación