¿Qué backend gráfico debo usar en Windows con Dusklight?

Prueba primero D3D12 — es la API moderna de Microsoft con el menor overhead de CPU para renderizado a alta frecuencia de imagen. Si hay problemas, baja a D3D11 o Vulkan. Último recurso: OpenGL.

¿Qué backend gráfico debo usar en macOS con Dusklight?

Metal es el backend nativo de Apple y la mejor opción tanto en Apple Silicon como en Intel. Si hay fallos al arrancar, prueba Vulkan (vía MoltenVK) u OpenGL como alternativa.

Dusklight no arranca y no puedo cambiar el backend desde dentro de la app. ¿Qué hago?

Edita el archivo config.json directamente. La clave es backend.graphicsBackend. Ubicación: Windows → %APPDATA%\TwilitRealm\Dusk\config.json; macOS → ~/Library/Application Support/TwilitRealm/Dusk/config.json; Linux → ~/.local/share/TwilitRealm/Dusk/config.json.

Backends gráficos de Dusklight — Cuál elegir en tu plataforma

Q: Dusklight arranca pero la pantalla está en negro con audio. ¿Qué hago?

Es habitualmente un problema específico del renderer. Cambia a otro backend. En Windows: prueba D3D12 → D3D11 → Vulkan. En Linux: Vulkan → OpenGL. En Mac: Metal → OpenGL.

Dusklight soporta D3D12, D3D11, Metal, Vulkan, OpenGL, OpenGL ES y WebGPU. Aquí tienes cuál elegir según tu plataforma y cómo cambiar de backend.

Publicado 2026-05-19

La mayoría de cobertura sobre Dusklight dice “basado en Vulkan” o “usa Aurora”. Ambas afirmaciones son imprecisas: Dusklight expone en realidad siete backends gráficos distintos en sus ajustes de prelanzamiento, y puedes cambiar entre ellos. Esto importa para la compatibilidad — si Vulkan falla en tu GPU, tienes seis alternativas antes de rendirte.

Esto está verificado directamente en el código fuente de Dusklight (src/dusk/ui/settings.cpp en la rama main). El desplegable está en:

Ajustes → Prelanzamiento → Backend Gráfico

Es necesario reiniciar tras cambiarlo (Dusklight muestra el modal “A restart is required to apply selected options”).

Los 7 backends

Backend	Nativo en	Úsalo cuando
D3D12	Windows 10+	Por defecto en Windows moderno; menor overhead de CPU
D3D11	Windows 7+	Windows antiguo o driver de GPU sin D3D12
Metal	macOS, iOS	Por defecto en plataformas Apple
Vulkan	Windows, Linux, Android	Por defecto en Linux y Android; alternativa multiplataforma
OpenGL	Casi cualquier cosa	Alternativa universal; hardware antiguo o poco convencional
OpenGL ES	Android, embebido	GPUs móviles o de bajo consumo
WebGPU	(experimental)	Orientado al futuro; todavía no es el predeterminado en ninguna plataforma

Normalmente no necesitas saber todo esto — Dusklight elige un backend razonable para tu plataforma en el primer arranque. Pero saber qué hay disponible es útil cuando diagnosticas problemas de “Dusklight no renderiza nada”.

Recomendaciones por plataforma

Windows

Primera opción: D3D12. Es la API moderna de Microsoft con el menor overhead de CPU para renderizado a alta frecuencia — exactamente lo que quieres para el objetivo de framerate desbloqueado de Dusklight. Si hay problemas: baja a D3D11 (compatibilidad con drivers antiguos) o Vulkan (solución a bugs de driver). Último recurso: OpenGL.

macOS (Apple Silicon e Intel)

Primera opción: Metal. La API nativa de Apple; la GPU de Apple Silicon está diseñada en torno a Metal; espera los mejores resultados aquí. Si hay problemas: Vulkan vía MoltenVK (capa de traducción) — funciona pero añade overhead. Último recurso: OpenGL — Apple deprecó OpenGL en 10.14 y es lento, pero a veces funciona cuando las APIs más nuevas se topan con bugs de driver.

Si Dusklight falla al arrancar en Apple Silicon (#826, #805), probar Vulkan u OpenGL es una de las soluciones habituales.

Linux (escritorio y Steam Deck)

Primera opción: Vulkan. Los drivers modernos de Mesa para AMD y NVIDIA son excelentes con Vulkan, y Steam Deck está fuertemente optimizado para Vulkan a través de DXVK de Proton y la pila Mesa. Si hay problemas: OpenGL — funciona en prácticamente cualquier cosa pero es más lento. Nota: D3D12, D3D11 y Metal no están disponibles en Linux (APIs de SO distintas).

Android

Primera opción: Vulkan. Los teléfonos Android modernos (serie Snapdragon 8xx, Tensor, MediaTek Dimensity) tienen buenos drivers Vulkan. Si hay problemas: OpenGL ES — dispositivos más antiguos o con implementaciones Vulkan con bugs. Peor rendimiento, pero funciona.

iOS / iPadOS

Primera opción: Metal. Nativo de Apple; los drivers de GPU en iOS son Metal primero. Alternativa: No hay buena alternativa en iOS — Metal es lo que tienes. Si no funciona, la app generalmente no arrancará.

WebGPU

Actualmente es experimental. WebGPU es una API multiplataforma más reciente (originada en el mundo de los estándares web) que promete renderizado moderno en una sola API para todas las plataformas. En la v1.0.0 está expuesta en el desplegable pero no es el predeterminado. Elige esta opción si tienes curiosidad o estás probando cosas — no para jugar a diario.

Cómo cambiar de backend

Lanza Dusklight
Abre Ajustes (parte superior del menú de prelanzamiento, o en juego mediante Atrás/Select)
Cambia a la pestaña Prelanzamiento
Desplegable Backend Gráfico — elige una opción diferente
Dusklight muestra el modal: “A restart is required to apply selected options. Restart now to…”
Haz clic en Restart now

Si Dusklight se congela o falla durante el reinicio, fuerza el cierre y vuelve a abrirlo — los ajustes persisten entre sesiones.

Por qué Dusklight tiene tantos backends (frente a otros ports)

Vale la pena mencionarlo porque es una diferencia real:

Ship of Harkinian (el port de OoT) históricamente soportaba un conjunto menor de backends — principalmente DX11 y OpenGL.
Cemu (emulador de Wii U) usa principalmente Vulkan, con un fallback OpenGL heredado.
Dolphin soporta Vulkan, OpenGL y D3D12.

Que Dusklight soporte 7 backends es excepcionalmente amplio. Esto se debe en gran parte al framework multiplataforma Aurora sobre el que está construido Dusklight — Aurora abstrae sobre las APIs de renderizado para que Dusklight pueda apuntar a muchos backends desde un solo código base.

La ventaja práctica: cuando un backend tiene un bug de driver para tu GPU específica, tienes seis alternativas. La desventaja: el renderer de Dusklight está limitado a las características que todos los backends pueden soportar — así que no verás, por ejemplo, trucos de ray tracing exclusivos de D3D12.

Escenarios comunes de cambio de backend

”Dusklight arranca pero la pantalla está en negro con audio”

Esto suele ser un problema específico del renderer. Prueba un backend diferente.
En Windows: cambia de D3D12 → D3D11 → Vulkan.
En Linux: cambia de Vulkan → OpenGL.
En Mac: cambia de Metal → OpenGL.

”Dusklight ni siquiera arranca / falla inmediatamente”

El backend actual puede que no esté inicializándose. Cambiar de backend requiere que Dusklight arranque primero (el desplegable está dentro de la app).
Si no puedes arrancar en absoluto para cambiar el ajuste, edita el archivo de configuración de Dusklight directamente.
Verificado en el código fuente de la v1.0.1 (src/dusk/config.cpp): el archivo es config.json, en formato JSON con sangría (parseado/escrito con nlohmann/json, indent=4). Las claves son cadenas planas con puntos como espacio de nombres, como backend.graphicsBackend y game.pauseOnFocusLost. Edita backend.graphicsBackend directamente para cambiar de backend sin arrancar la app.
La ubicación del archivo de configuración depende de la plataforma (actualmente en v1.0.1; la siguiente línea de versiones usa Dusklight en lugar de Dusk con migración automática — el port fue renombrado de Dusk a Dusklight el 12 de mayo de 2026):
- Windows: %APPDATA%\TwilitRealm\Dusk\config.json
- macOS: ~/Library/Application Support/TwilitRealm/Dusk/config.json
- Linux: ~/.local/share/TwilitRealm/Dusk/config.json
Resuelto por SDL_GetPrefPath("TwilitRealm", "Dusk") en los binarios actuales. El PR #1059 (fusionado el 12-05-2026) añadió también un descriptor data_location.json que permite los modos Predeterminado / Portable / Personalizado para reubicar el directorio.

”Los FPS son inesperadamente bajos”

Prueba un backend diferente; algunas GPUs tienen rendimiento asimétrico entre APIs.
En GPUs AMD antiguas, OpenGL puede ser más lento que D3D11/12 o Vulkan.
En iGPUs Intel antiguas, puede ocurrir lo contrario.

”Dusklight funciona pero ciertos efectos se ven mal (bloom, sombras, etc.)”

El bug de bloom pulsante con framerate desbloqueado (#825) no es específico del backend — es un problema de interpolación. Cambiar de backend no lo soluciona.
Para otros fallos de renderizado, prueba un backend diferente para aislar si es un bug del renderer o de la lógica del juego.

Disponibilidad de backends por plataforma (verificada)

	D3D12	D3D11	Metal	Vulkan	OpenGL	OpenGL ES	WebGPU
Windows	✅	✅	❌	✅	✅	❌	⚙️
macOS	❌	❌	✅	⚙️ (MoltenVK)	✅	❌	⚙️
Linux	❌	❌	❌	✅	✅	❌	⚙️
Android	❌	❌	❌	✅	❌	✅	⚙️
iOS	❌	❌	✅	❌	❌	❌	⚙️

Leyenda:

✅ Disponible y opción predeterminada normal
⚙️ Disponible pero experimental / depende de un runtime adicional
❌ No disponible (sin API de SO subyacente)

Qué falta (advertencia sobre verificabilidad)

El código fuente de Dusklight expone el desplegable, pero TwilitRealm no ha publicado:

Una “recomendación oficial” formal de qué backend usar por plataforma
Benchmarks de rendimiento comparando backends en el mismo hardware
Una lista de bugs de driver conocidos por backend

Las recomendaciones anteriores las hemos inferido del conocimiento general de estas APIs y del diseño de Aurora. Si tienes un problema específico con un backend, la página de issues de Dusklight en GitHub es el lugar de referencia, y el Discord oficial de Dusklight (discord.gg/dusktp) es donde el equipo y la comunidad comentan soluciones.

Relacionado

Requisitos del sistema de Dusklight — contexto más amplio de soporte de plataformas
Issues conocidos verificados en v1.0.0
Cómo instalar Dusklight en tu plataforma

Última actualización: 2026-05-19. Lista de backends verificada contra src/dusk/ui/settings.cpp en la rama main. El port fue renombrado de Dusk a Dusklight el 12 de mayo de 2026.

← Guía pilar · Todas las características