DuskPort

Cómo instalar Dusklight (Twilight Princess PC) en iOS — Guía de sideload con AltStore

Instala Dusklight (antes Dusk), el port nativo para PC de The Legend of Zelda: Twilight Princess, en iPhone o iPad vía AltStore. Paso a paso basado en los docs oficiales. Developer Mode de iOS 16+, comparación de cert 7 días vs 1 año.

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

iOS no permite instalar apps fuera del App Store, así que Dusklight (antes Dusk) usa AltStore para sideloading. Esta guía está basada en el docs/ios-install-altstore.md oficial del repo de Dusklight, con contexto extra para cosas que el doc oficial omite (emparejamiento del control, ubicación de partidas, el tradeoff del certificado de 7 días).

Tiempo necesario: ~20 minutos para la primera configuración Dificultad: Media (más pasos que Android por el sandboxing de Apple)

⚠️ Lee esto primero (actualizado para v1.4.1)

Lo principal que debes saber antes de empezar: Apple ID gratis = expiración de la app a los 7 días. El camino gratuito te obliga a refrescar Dusklight cada semana usando AltStore. Si te saltas una semana, la app deja de abrir hasta que la refresques.

Si quieres evitar refrescos semanales, una cuenta paga del Apple Developer Program ($99/año) te da certificados de 1 año en lugar de 7 días. La mayoría empieza por el camino gratis; mejora si se vuelve molesto.

✅ El acceso a partidas en iOS fue corregido en v1.0.1 (2026-05-11). El dolor previo del sandbox-access (#804) está cerrado. Los datos de Dusklight ahora aparecen en la app Archivos bajo En mi iPhone → Dusklight, y Settings → Interface → Open Data Folder salta directo allí. Instala v1.0.1 y olvídate del workaround de respaldo por Finder que guías más antiguas recomendaban.

Prerrequisitos (según docs oficiales)

Estos son los requisitos exactos de docs/ios-install-altstore.md:

  • Un Mac con Homebrew instalado
  • Tu iPhone conectado por USB
  • IPA de Dusklight: Dusklight-v1.4.1-ios-arm64.ipa desde GitHub releases (25.9 MB) — usa v1.4.1, no v1.0.0
  • Disco del juego: GameCube USA (GZ2E01) o GameCube PAL (GZ2P01)

El docs/ios-install-altstore.md actual del repo oficial escribe el ID PAL como GZ2PE01 — es un typo de 7 caracteres. Todos los Game IDs reales de GameCube son de 6 caracteres (4 de producto + 2 de publisher “01”), y el ID PAL canónico es GZ2P01. Tu volcado PAL funcionará mientras el SHA-1 coincida con 2601822a488eeb86fb89db16ca8f29c2c953e1ca.

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

Paso 1 — Instalar AltServer en tu Mac

Según el doc oficial:

brew install altserver
open -a AltServer

Tras abrirlo, el ícono de AltServer aparece en la barra de menú (esquina superior derecha del Mac). Mantenlo corriendo durante todo el setup.

Si AltServer no aparece en la barra de menú, revisa Ajustes del Sistema → Ítems de inicio → asegúrate de que AltServer esté permitido.

Paso 2 — Activar Modo Desarrollador en iOS (iOS 16+)

En tu iPhone:

  1. Ajustes → Privacidad y seguridad → Modo Desarrollador
  2. Activa el switch
  3. Reinicia el iPhone cuando lo pida

Sin este paso, las apps sideloaded no se abrirán en iOS 16 o superior.

Paso 3 — Instalar AltStore en el iPhone

Con tu iPhone conectado al Mac por USB:

  1. Haz clic en el ícono de AltServer en la barra de menú del Mac
  2. Haz clic en Install AltStore → [Tu iPhone]
  3. Ingresa tu Apple ID y contraseña cuando lo pida (este Apple ID es el que re-firma tus apps sideloaded)
  4. Espera a que AltStore se instale en tu teléfono

Luego en el iPhone:

  1. Ajustes → General → VPN y gestión de dispositivos
  2. Toca tu Apple ID bajo “App de desarrollador”
  3. Toca Confiar

Ya deberías tener AltStore como app en tu pantalla de inicio.

💡 Apple ID gratis vs pago: si usaste un Apple ID gratis, las apps sideloaded (incluida Dusklight) expiran a los 7 días y deben refrescarse vía AltStore. Una cuenta paga del Apple Developer Program ($99/año) te da certs de 1 año y puedes firmar más apps simultáneamente.

Paso 4 — Transferir archivos al iPhone

Necesitas tanto el IPA de Dusklight como tu imagen de disco de GameCube en el iPhone.

El doc oficial lista cuatro métodos de transferencia:

AirDrop

En tu Mac, clic derecho sobre cada archivo → Compartir → AirDrop → elige tu iPhone. Los archivos llegan a la app Archivos.

iCloud Drive

Suelta los archivos en iCloud Drive en tu Mac. Se sincronizan en la app Archivos del iPhone.

Transferencia USB (barra lateral de Finder)

Con el iPhone conectado, abre Finder → clic en el iPhone en la barra lateral → pestaña Archivos → arrastra archivos a la sección de una app compatible.

Almacenamiento en la nube

Sube a Google Drive, Dropbox, OneDrive, etc., desde tu Mac. Descarga vía la app correspondiente en el iPhone.

⚠️ Las imágenes de disco pesan ~1 GB. AirDrop y USB son lo más rápido. iCloud / nube usan ancho de banda en ambos lados.

Paso 5 — Instalar Dusklight vía AltStore

  1. Abre AltStore en tu iPhone
  2. Toca la pestaña My Apps
  3. Toca el botón + (arriba a la izquierda)
  4. Se abre el explorador de Archivos
  5. Navega a donde pusiste Dusklight-v1.4.1-ios-arm64.ipa (app Archivos o donde lo hayas guardado)
  6. Toca para seleccionarlo

AltStore firmará e instalará Dusklight. Tarda 30–60 segundos. Dusklight aparece en tu pantalla de inicio.

Paso 6 — Primer arranque

  1. Toca Dusklight en tu pantalla de inicio
  2. La pantalla de prelaunch muestra el botón Select Disc Image
  3. Tócalo. Se abre el selector de Archivos de iOS.
  4. Navega a donde pusiste tu imagen de disco de GameCube (Archivos → En mi iPhone, o iCloud Drive, o donde sea)
  5. Toca para seleccionar
  6. Dusklight verifica el hash (XXH128 contra la tabla integrada)
  7. El estado cambia a “Disc ready.”
  8. Toca Play

Paso 7 — Emparejar un control (recomendado)

iOS soporta controles certificados MFi y muchos gamepads Bluetooth:

Control (mando)Notas
Backbone OneSe clipea al iPhone; funciona nativo
Xbox Wireless (modelo 1914+)Emparejamiento Bluetooth nativo
DualShock 4 / DualSenseEmparejamiento nativo en iOS 13+
Switch Pro ControlleriOS 16+ vía Bluetooth
8BitDo Pro 2Bluetooth, soporte de giroscopio
Razer Kishi V2Clip al teléfono, funciona como MFi

Emparejamiento:

  1. iPhone Ajustes → Bluetooth → Emparejar
  2. Pon el control en modo emparejamiento (la combinación de botones varía por control)
  3. Una vez emparejado, el control funciona automáticamente en Dusklight

Dentro de Dusklight:

Settings → Input → Controller → Configure Controller

Apuntado por giroscopio (DualShock 4/5, Switch Pro Controller, 8BitDo Pro 2):

Settings → Input → Gyro → Gyro Aim → activar

Desde v1.4.0, Dusklight añade soporte nativo de giroscopio y vibración en iOS — los propios sensores del iPhone/iPad pueden mover el apuntado por giroscopio, así que no necesitas un control con giroscopio. v1.4.0 también añade controles táctiles móviles de primera clase, así que puedes jugar sin mando.

Respaldo de partida guardada (ahora fácil desde v1.0.1)

El issue #804 está cerrado — v1.0.1 (2026-05-11) hizo visible la data de Dusklight en la app Archivos de iOS.

Para encontrar o respaldar tu partida:

  1. Dentro de Dusklight: Settings → Interface → Open Data Folder — salta directo a la ubicación en Archivos de iOS
  2. Desde la app Archivos: En mi iPhone → carpeta Dusklight → contiene USA/ (o EUR/) → Card A/01-GZ2*-gczelda2.gci
  3. Mantén presionado el archivo .gci → Compartir → AirDrop a tu Mac o copia a iCloud Drive

El workaround anterior de respaldo cifrado vía Finder está obsoleto en v1.0.1. Usa la app Archivos directamente.

Para migración desde Dolphin: usa AirDrop para enviar tu .gci desde el Mac al iPhone (llega a En mi iPhone → Descargas), luego muévelo a En mi iPhone → Dusklight → USA → Card A → (o EUR para PAL).

Problemas comunes

Mensaje “Untrusted Developer” en el primer arranque

Te saltaste la acción de Confiar del Paso 3. Ajustes → General → VPN y gestión de dispositivos → [Tu Apple ID] → Confiar.

Dusklight no abre — “App is no longer available”

El cert de 7 días expiró. Abre AltStore → My Apps → toca Refresh junto a Dusklight. Tu Mac corriendo AltServer debe estar en la misma red Wi-Fi que tu iPhone.

”Failed to install app” vía AltStore

Causas comunes:

  • Apple ID gratis ya alcanzó el límite de 3 apps (solo 3 sideloaded simultáneamente). Quita otras.
  • AltServer no está corriendo en el Mac
  • iPhone no está en la misma Wi-Fi que el Mac
  • Desafío 2FA del Apple ID interrumpido

Imagen de disco no aparece en el selector de Archivos

El selector solo muestra carpetas con conciencia de nube. Asegúrate de que tu imagen esté en En mi iPhone, iCloud Drive o Documentos — no dentro de una librería Fotos solo-en-nube ni carpeta privada de app.

Rendimiento menor a lo esperado

Dusklight aún no expone ajustes específicos de rendimiento para iOS. Prueba:

  • Reducir Internal Resolution en Settings → Video
  • Desactivar Unlock Framerate si tu dispositivo se calienta y se acelera
  • Asegúrate de que Modo de bajo consumo esté apagado

El control Bluetooth funciona en otras apps pero no en Dusklight

Algunos controles se registran como MFi vs HID de forma distinta. Prueba desemparejar y volver a emparejar. Revisa Settings → Input → Controller → Configure Controller dentro de Dusklight para ver si lo detecta.

Métodos alternativos de sideload (no soportados oficialmente)

Los docs oficiales solo cubren AltStore. Alternativas de la comunidad:

  • SideStore — como AltStore pero no requiere AltServer / tu Mac corriendo para refrescar. Funciona enteramente en el dispositivo con un “truco VPN”.
  • Sideloadly — alternativa amistosa con Windows y Mac.
  • TrollStore (solo con jailbreak) — para versiones antiguas de iOS; instalación permanente sin re-firmado. Solo en ciertas versiones de iOS.

Úsalas bajo tu propio riesgo; no están validadas por TwilitRealm. El camino AltStore del doc oficial es el más seguro.

Problemas comunes en iOS

¿Qué probar después?

Última actualización: 2026-06-20. Basado en el docs/ios-install-altstore.md oficial del repo de Dusklight, actualizado para v1.4.1.

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