Dusklight: Apuntado con giroscopio y ratón — Guía completa de ajustes
Configura el apuntado con giroscopio o con ratón en Dusklight. Los 10 ajustes de entrada explicados directamente del código fuente, con recomendaciones por plataforma.
Dusklight soporta tanto el apuntado con giroscopio (apuntado basado en movimiento mediante un mando con giroscopio) como el apuntado con ratón (añadido en v1.0.0-rc.1). Esta es una de las mejoras más destacadas sobre la versión original de GameCube — apuntado con arco y tirachinas con controles de precisión modernos.
El soporte de ratón ha crecido mucho más allá del apuntado: v1.4.0 añade control con ratón para la cámara en tercera persona y soporte de ratón/táctil para los menús del juego (se puede desactivar con el ajuste “Mouse/Touch in Menus”). v1.4.0 también trae giroscopio nativo del teléfono en Android e iOS, así que en móvil ya no hace falta un mando con giroscopio.
Esta guía está verificada contra src/dusk/ui/settings.cpp en la rama main — cada nombre de ajuste y helpText es literalmente del código fuente.
Dónde están los ajustes
Ajustes → Entrada → Gyro
Esa sección contiene 10 ajustes distintos (verificados literalmente):
- Gyro Input Method —
SensoroMouse - Gyro Aim — toggle
- Gyro Rollgoal — toggle
- Gyro Pitch Sensitivity — deslizador
- Gyro Yaw Sensitivity — deslizador
- Rollgoal Sensitivity — deslizador
- Gyro Deadband — deslizador
- Gyro Smoothing — deslizador
- Invert Gyro Pitch — toggle
- Invert Gyro Yaw — toggle
Gyro Input Method — Sensor vs Mouse
Este es el toggle más importante. Dos modos:
Modo Sensor
Lee los datos de movimiento directamente del giroscopio/IMU del mando. Rápido, baja latencia, sin capa de traducción. Esto es lo que quieres con:
- DualShock 4 / DualSense
- Switch Pro Controller
- 8BitDo Pro 2 / Ultimate
- Steam Deck (LCD u OLED)
- Cualquier otro mando con giroscopio nativo
Modo Mouse (añadido en v1.0.0-rc.1)
Trata cualquier entrada configurada como un ratón virtual y usa el movimiento del ratón como señal de apuntado. Se añadió en las notas de la versión v1.0.0-rc.1 (literalmente):
“Added Mouse input for ‘gyro source’ (mouse aiming)”
Usa el modo Mouse cuando:
- Quieras apuntado literal con ratón (configuración de PC + teclado/ratón)
- Estés enrutando el giroscopio a través de la función “gyro to mouse” de Steam Input (p. ej., en Steam Deck si prefieres ese flujo de trabajo)
- El giroscopio de un mando no se expone a Dusklight de forma nativa pero Steam Input sí puede leerlo
⚠️ No uses ambos a la vez. Si activas el modo sensor nativo en Dusklight y también activas el gyro-to-mouse de Steam Input para el mismo mando, las entradas se interfieren entre sí.
Recomendaciones por plataforma
Windows de escritorio (sin Steam)
- Modo Sensor — DualShock / DualSense / Pro Controller / 8BitDo Pro 2 se conectan por Bluetooth o USB y Dusklight lee el giroscopio directamente
- Modo Mouse — para jugadores de teclado + ratón
Windows de escritorio (vía Steam)
- Modo Sensor si quieres baja latencia nativa
- Modo Mouse si ya tienes invertido un perfil de gyro-to-mouse de Steam Input
macOS
- Modo Sensor para DualShock 4/5, Switch Pro Controller (compatible desde iOS 16+ y macOS 13+)
- Modo Mouse para teclado+ratón, PERO nota que la vinculación de teclado está actualmente rota en macOS (#830)
Linux de escritorio
- Modo Sensor — los módulos de kernel
hid-nintendoyhid-playstationde Linux exponen el giroscopio al espacio de usuario; Dusklight lo detecta
Steam Deck
- Modo Sensor para el IMU nativo de Steam Deck — recomendado
- No uses a la vez el gyro-to-mouse de Steam Input
Android
- Modo Sensor — los mandos Bluetooth con giroscopio (8BitDo Pro 2, DualSense) funcionan
- Desde v1.4.0, el giroscopio (y la vibración) del propio teléfono tiene soporte nativo, así que ya no hace falta un mando con giroscopio
iOS
- Modo Sensor — DualShock 4/5 emparejado por Bluetooth, Switch Pro Controller por Bluetooth (iOS 16+) y 8BitDo Pro 2
- Desde v1.4.0, el giroscopio (y la vibración) del propio iPhone/iPad tiene soporte nativo, así que ya no hace falta un mando con giroscopio
Cada ajuste explicado
Gyro Aim (toggle)
El interruptor maestro. Desactivado = el giroscopio no influye en el apuntado. Activado = el giroscopio contribuye a la dirección de apuntado.
Solo verás efectos del giroscopio cuando estés apuntando de verdad (arco, tirachinas, ojo de halcón, etc.) — Dusklight no aplica el giroscopio a la cámara ni al movimiento durante el juego normal.
Gyro Rollgoal (toggle)
“Rollgoal” hace referencia al minijuego de hacer rodar una canica/bola (el minijuego de rodadura del pueblo de Plumm, las fases de rodadura). Este toggle activa el giroscopio para ese minijuego específico.
Gyro Pitch Sensitivity (deslizador)
La velocidad con la que el apuntado vertical responde a la inclinación arriba/abajo del giroscopio. Mayor = más rápido.
Gyro Yaw Sensitivity (deslizador)
La velocidad con la que el apuntado horizontal responde al giro izquierda/derecha del giroscopio.
Rollgoal Sensitivity (deslizador)
Sensibilidad independiente para el minijuego de rodadura (para que puedas tener, por ejemplo, sensibilidad de pitch/yaw baja para el arco, pero alta para el minijuego).
Gyro Deadband (deslizador)
La cantidad mínima de movimiento del giroscopio que se registra como entrada. Mayor = ignora el temblor leve de la mano; menor = más sensible pero más exigente. Ajusta esto si tu apuntado deriva ligeramente cuando estás quieto.
Gyro Smoothing (deslizador)
Cuánto suaviza Dusklight la entrada a lo largo del tiempo. Mayor = estable pero con lag; menor = reactivo pero con ruido.
Invert Gyro Pitch / Yaw (toggles)
Invierte el eje correspondiente. Útil si tu dirección de movimiento preferida difiere de la predeterminada.
Valores de partida recomendados
Estos son valores razonables para empezar — ajusta al gusto:
| Ajuste | Valor de partida |
|---|---|
| Gyro Input Method | Sensor (o Mouse para teclado+ratón) |
| Gyro Aim | Activado |
| Gyro Rollgoal | Activado (si vas a jugar ese minijuego) |
| Gyro Pitch Sensitivity | 50% |
| Gyro Yaw Sensitivity | 50% |
| Rollgoal Sensitivity | 50% |
| Gyro Deadband | 10–20% (sube si hay deriva, baja si te pierdes movimientos pequeños) |
| Gyro Smoothing | 20% (baja si quieres precisión reactiva) |
| Invert Gyro Pitch | Desactivado |
| Invert Gyro Yaw | Desactivado |
Estas son orientaciones, no medidas — TwilitRealm no ha publicado un preset recomendado.
Configuración del apuntado con ratón (PC con teclado + ratón)
Si quieres jugar a Dusklight como un FPS de PC:
- Ajustes → Entrada → Gyro → Gyro Input Method →
Mouse - Ajustes → Entrada → Gyro → Gyro Aim → Activado
- Vincula apuntar/disparar a los botones del ratón mediante Ajustes → Entrada → Mando → Configurar Mando (el sistema de vinculación de teclado/ratón añadido en v0.6.2)
- Ajusta Gyro Pitch / Yaw Sensitivity al gusto — en modo Mouse se convierten en las sensibilidades del ratón
⚠️ La vinculación de teclado en macOS está rota en v1.0.0 (#830). Usa un mando hasta que se parchee.
Problemas comunes del giroscopio y soluciones
El apuntado deriva cuando estoy quieto
Aumenta el Gyro Deadband. Si sigue derivando, puede que el giroscopio de tu mando necesite calibración — consulta las herramientas de firmware del fabricante.
El apuntado se siente nervioso / demasiado sensible
Aumenta Gyro Smoothing y reduce Pitch/Yaw Sensitivity.
El apuntado se siente con lag
Reduce Gyro Smoothing.
El giroscopio no responde en absoluto
- Asegúrate de que Gyro Input Method está en
Sensor(noMouse) - Asegúrate de que Gyro Aim está activado
- Verifica que el giroscopio de tu mando es reconocido por tu SO — prueba un juego compatible con giroscopio fuera de Dusklight para confirmarlo
- En Steam Deck específicamente: no tengas habilitado el gyro-to-mouse de Steam Input para el mismo mando
El giroscopio funciona pero solo a veces
El giroscopio normalmente solo se activa durante el apuntado (arco/tirachinas). No mueve la cámara durante el juego normal. Confirma que estás pulsando el botón de apuntar.
Giroscopio en iPhone con mando Bluetooth
El DualShock 4/5 expone el giroscopio a iOS solo desde iOS 13+. El Switch Pro Controller expone el giroscopio desde iOS 16+. Los dispositivos más antiguos no tendrán soporte de giroscopio nativo.
El giroscopio se siente diferente en diferentes sitios
Las lecturas del giroscopio pueden verse afectadas por la posición de reposo del mando cuando se empareja. Si te has movido de ubicación, vuelve a emparejar el mando.
Resumen de rutas de ajuste (verificadas literalmente del código fuente)
| Objetivo | Ruta |
|---|---|
| Cambiar entre giroscopio y apuntado con ratón | Ajustes → Entrada → Gyro → Gyro Input Method |
| Toggle maestro del giroscopio | Ajustes → Entrada → Gyro → Gyro Aim |
| Giroscopio para el minijuego de rodadura | Ajustes → Entrada → Gyro → Gyro Rollgoal |
| Ajustar velocidad vertical del giroscopio | Ajustes → Entrada → Gyro → Gyro Pitch Sensitivity |
| Ajustar velocidad horizontal del giroscopio | Ajustes → Entrada → Gyro → Gyro Yaw Sensitivity |
| Reducir entradas por temblor de mano | Ajustes → Entrada → Gyro → Gyro Deadband |
| Suavizar la respuesta del giroscopio | Ajustes → Entrada → Gyro → Gyro Smoothing |
| Invertir el giroscopio vertical | Ajustes → Entrada → Gyro → Invert Gyro Pitch |
| Invertir el giroscopio horizontal | Ajustes → Entrada → Gyro → Invert Gyro Yaw |
Relacionado
- Issues conocidos verificados en v1.0.0 — incluyendo #830 vinculación de teclado en macOS
- Cómo instalar Dusklight en Steam Deck — el giroscopio es excelente en Deck
- Backends gráficos de Dusklight
Última actualización: 2026-05-19. Árbol de ajustes verificado contra src/dusk/ui/settings.cpp en la rama main.
← Guía pilar · Todas las características