Cómo instalar Dusklight (Twilight Princess PC) en macOS — Apple Silicon e Intel

Instala Dusklight (antes Dusk), el port nativo para PC de The Legend of Zelda: Twilight Princess, en tu Mac con Apple Silicon o Intel. Rutas verificadas, configuración real, solución de Gatekeeper y workarounds del crash de v1.0.0.

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

Dusklight (antes Dusk) distribuye builds nativos separados para Apple Silicon (serie M) y Macs Intel. Esta guía cubre ambos, además de los problemas de arranque de v1.0.0 que algunos usuarios de Apple Silicon han reportado.

Tiempo necesario: ~10 minutos Dificultad: Fácil (con matiz — ver Problemas conocidos abajo)

⚠️ Estado en v1.0.1 (usuarios Apple Silicon)

La mayoría de los dolores de cabeza del lanzamiento en Apple Silicon están resueltos en v1.0.1 (2026-05-11):

✅ #779 / #805 — el crash original “Dusk quit unexpectedly” / símbolo faltante de dyld → corregido (el colaborador tomlube: “Fixed in 1.0.1”)
✅ #830 — binding de teclado roto en macOS → corregido
✅ Soporte de macOS 14 — añadido en v1.0.1 (sin probar según las notas de release, pero ya no oficialmente sin soporte)
⏳ #826 — Todavía abierto. Antes se confundía con el crash de dyld; en realidad es una falla aparte de compilación de shader-cache RmlUi Gradient Pipeline en WebGPU/Metal. Etiquetada como “Known shader cache crash on macOS currently. Investigating.” Si tienes un crash al arranque en v1.0.1, este es el issue a seguir.

Resumen: instala v1.0.1, no v1.0.0. Si aún así se cae, prueba cambiar el Graphics Backend (Settings → Prelaunch → Graphics Backend → Metal / Vulkan / OpenGL) y reporta en #826.

Antes de empezar

1. Identifica la arquitectura de tu Mac

Menú Apple → Acerca de este Mac
La línea “Chip” mostrará uno de los siguientes:
- Apple M1 / M2 / M3 / M4 / Pro / Max / Ultra → Apple Silicon, usa el build arm64
- Intel Core … → Mac Intel, usa el build x86_64

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

Obligatorio. Dusklight no incluye los archivos del juego. Mira Cómo volcar legalmente tu disco de TP (en inglés).

Soportado en v1.0.0:

GameCube USA (GZ2E01) — SHA-1 75edd3ddff41f125d1b4ce1a40378f1b565519e7
GameCube PAL (GZ2P01) — SHA-1 2601822a488eeb86fb89db16ca8f29c2c953e1ca

3. Versión de macOS

Según el código fuente, Dusklight apunta a versiones recientes de macOS vía el backend gráfico Metal. La versión mínima oficial de macOS no está documentada, pero macOS 12 (Monterey) o superior es una suposición razonable. Compilar desde el código fuente requiere Xcode 16.4+ (según docs/building.md) — pero no necesitas esto solo para correr el binario precompilado.

Paso 1 — Descargar Dusklight

Ve a github.com/TwilitRealm/dusklight/releases
Bajo v1.4.1 Assets, elige el archivo que coincida con tu Mac:

Mac	Archivo	Tamaño
Apple Silicon	`Dusklight-v1.4.1-macos-arm64.zip`	27.3 MB
Intel	`Dusklight-v1.4.1-macos-x86_64.zip`	29.0 MB

⚠️ Cuidado: existe un juego adulto llamado “Dusklight Manor” sin relación. Descarga solo desde GitHub TwilitRealm o twilitrealm.dev.

Verifica la descarga en Terminal (calcula el hash y compáralo con lo publicado en la página de release):

shasum -a 256 ~/Downloads/Dusklight-v1.4.1-macos-arm64.zip

⚠️ Si por error descargas la arquitectura equivocada, Dusklight no arrancará o correrá vía Rosetta 2 con pérdida de rendimiento. Elige la arquitectura correcta.

Paso 2 — Extraer y mover

Haz doble clic en el .zip desde Finder. Se expande a un bundle Dusklight.app.
Arrastra Dusklight.app a Aplicaciones (o cualquier carpeta que prefieras).

⚠️ Evita colocarlo dentro de una carpeta sincronizada por iCloud Drive o Dropbox — los conflictos de sincronización pueden corromper partidas guardadas.

Paso 3 — Primer arranque (workaround de Gatekeeper)

Dusklight v1.0.0 no está notarizado por Apple. La primera vez que lo ejecutes, Gatekeeper de macOS lo bloqueará.

Ruta para macOS 12–14

Abre Aplicaciones en Finder
Clic derecho sobre Dusklight.app → Abrir
Aparece un diálogo: “macOS cannot verify the developer of ‘Dusklight’. Are you sure you want to open it?”
Haz clic en Abrir

Esto incluye a Dusklight en la lista blanca; podrás abrirlo normalmente después.

Ruta para macOS 15

En Sequoia, el truco de clic derecho → Abrir está restringido. Si no funciona:

Intenta abrir Dusklight normalmente (será bloqueado)
Ajustes del Sistema → Privacidad y seguridad → Seguridad
Baja hasta “Dusklight fue bloqueado” → haz clic en Abrir de todos modos
Autentica con Touch ID o contraseña

Paso 4 — Verifica tu ROM

Antes de apuntar Dusklight a tu imagen de disco, verifica el SHA-1 en Terminal:

shasum -a 1 ~/path/to/your-dump.iso

Debe coincidir exactamente con:

75edd3ddff41f125d1b4ce1a40378f1b565519e7 (NTSC-U)
2601822a488eeb86fb89db16ca8f29c2c953e1ca (PAL)

Si ninguno coincide, mira solución de problemas de SHA-1 mismatch (en inglés).

Paso 5 — Cargar tu disco

Abre Dusklight
El menú de prelaunch muestra el botón Select Disc Image
Se abre un diálogo de archivo nativo de macOS con el filtro “Game Disc Images” (extensiones iso, gcm, ciso, gcz, nfs, rvz, wbfs, wia, tgc)
Selecciona tu volcado del disco
Espera el overlay “Verifying disc image” (unos segundos para la verificación XXH128)
El estado cambia a “Disc ready.”
El botón cambia a Play — haz clic

Paso 6 — Configurar el control (mando)

✅ El binding de teclado está corregido en v1.0.1. El bug previo de macOS #830 está cerrado. Si estás en v1.0.0, actualiza a v1.0.1.

La ruta verificada de Settings es:

Settings → Input → Controller → Configure Controller

Esto abre una ventana por puerto con pestañas Port 1, Port 2, … y páginas Controller / Buttons / Triggers / Sticks / Rumble, además de una sección Options con Enable Dead Zones y Emulate Triggers.

Controles recomendados para Mac:

DualShock 4 / DualSense — emparejar por Bluetooth, soporte nativo de giroscopio
Switch Pro Controller — emparejar por Bluetooth
Xbox Wireless Controller — emparejar por Bluetooth (modelo 1914+ para emparejamiento nativo en macOS)
8BitDo Pro 2 — emparejar por Bluetooth, giroscopio nativo

Para activar el apuntado por giroscopio:

Settings → Input → Gyro → Gyro Aim (activar)

Luego Gyro Input Method → Sensor

Alternativa con apuntado por ratón (añadida en v1.0.0-rc.1):

Settings → Input → Gyro → Gyro Input Method → Mouse

Ubicación de las partidas guardadas

Ruta más fácil (v1.4.1): dentro de Dusklight ve a Settings → Interface → Open Data Folder — esto abre la carpeta correcta en Finder sin importar la versión.

Ruta manual:

~/Library/Application Support/TwilitRealm/Dusklight/USA/Card A/01-GZ2E01-gczelda2.gci

Para el disco europeo, reemplaza USA por EUR en la ruta. Para llegar ahí en Finder: Ir → Ir a la carpeta… (o ⇧⌘G), pega ~/Library/Application Support/TwilitRealm/Dusklight/, presiona Enter.

ℹ️ El escritorio ahora usa la carpeta Dusklight. Si venías de una versión con marca Dusk, tu carpeta antigua ~/Library/Application Support/TwilitRealm/Dusk/ se migra automáticamente al primer arranque. Usar el botón Open Data Folder dentro de la app es la forma a prueba de renombrados de encontrar la ruta correcta.

Los packs de texturas viven en ~/Library/Application Support/TwilitRealm/Dusklight/texture_replacements/ (verificado contra el código fuente, no inferido). Usa Open Data Folder para llegar y suelta la carpeta GZ2* desde el zip del pack de texturas dentro de texture_replacements/.

Migrar desde Dolphin

Las partidas de Dolphin en Mac viven en ~/Library/Application Support/Dolphin/GC/USA/Card A/. Copia 01-GZ2E01-gczelda2.gci desde la carpeta de Dolphin a la de Dusklight. Reinicia Dusklight.

Problemas comunes en macOS

Dusklight se cae al primer arranque (Apple Silicon)

Primer chequeo: ¿estás en v1.0.0 o v1.0.1? Los issues #779 y #805 están corregidos en v1.0.1 (2026-05-11). Si todavía estás en v1.0.0, actualiza primero.

Si estás en v1.0.1 y sigue cayéndose, puede que estés viendo #826, una falla aparte de compilación de shader-cache en WebGPU/Metal. Workarounds:

Prueba otro Graphics Backend en Settings → Prelaunch → Graphics Backend (rota Metal / Vulkan / OpenGL)
Revisa el issue enlazado para el estado actual

”Dusklight is damaged and can’t be opened”

Es una variante del mensaje de Gatekeeper. En Terminal:

xattr -cr /Applications/Dusklight.app

Luego vuelve a abrirlo. Esto quita el atributo de cuarentena que Apple agregó al descargarlo.

El teclado no funciona dentro del juego

#830 fue corregido en v1.0.1 (2026-05-11). Actualiza si sigues en v1.0.0.

Arquitectura equivocada instalada (rendimiento lento)

Probablemente bajaste el build x86_64 en un Mac con Apple Silicon y está corriendo vía Rosetta 2. Vuelve a descargar el build arm64.

Crujido en el audio

Prueba alternar entre tasas de muestreo en Configurar Audio MIDI de macOS, o cambia el Graphics Backend (a veces el audio queda bloqueado por el renderer).

Problemas comunes en macOS

“Dusklight is damaged and can’t be opened” → Fix de Gatekeeper (en inglés)
Crash al arranque en Apple Silicon (shader-cache Metal/WebGPU, aún abierto en v1.0.1) → Guía del #826
Hash verification failed → guía de solución
Atascado a 30 FPS → checklist
Partida de Dolphin no carga → guía de migración
Hub completo → todos los problemas conocidos

¿Qué probar después?

🎨 Instalar el pack de texturas 4K Henriko Magnifico
🚀 Framerate y 60 FPS, explicado
💾 Rutas de partidas y sincronización entre dispositivos
🏆 Mira la lista de logros
⚡ Atajo Turbo Key — mantén Tab para 4× velocidad

Última actualización: 2026-06-20. Actualizamos esta guía cuando salen parches específicos de macOS.

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