Confirma el mando fuera de Ryujinx
Prueba el mismo mando en el sistema o en otra app antes de tocar el emulador.
Solución de controles
¿El mando no funciona en Ryujinx Canary? Revisa la entrada paso a paso
Usa esta guía cuando Ryujinx Canary no detecta el mando, asigna botones incorrectos, pierde la entrada en Steam Deck o deja de reconocer controles tras una actualización.
$ channel: canary
$ platforms: windows linux macos
$ source: ryubing releases
$ status: verify before download
Independent guide. No keys, firmware, ROMs, DLC or game files are hosted here.
Intención
Solucionar entrada
Primera prueba
Un mando, Jugador 1
Steam Deck
Perfil de Steam Input
Riesgo Canary
Regresión reciente
Orden rápido para arreglar controles
Configura solo Jugador 1
Activa Player 1, elige el dispositivo correcto, define el tipo de control y guarda.
Mapea un solo perfil
Asigna botones, sticks y gatillos para ese dispositivo y prueba un juego.
Separa Steam Input
En Steam Deck o Steam, comprueba si Steam Input crea un mando virtual.
Compara con una build anterior
Si falló tras actualizar, prueba la build que funcionaba antes.
Usa un flujo de prueba reducido
Verifica primero la capa del mando, luego el perfil de Ryujinx y después Steam Input o reversión.
Empieza por la capa que falla
Divide el problema en dispositivo físico, sistema operativo, perfil de entrada de Ryujinx, Steam Input y juego concreto. No cambies gráficos, firmware y controles en la misma prueba. Una prueba limpia usa un mando, una ranura de jugador, un juego y un cambio por vez.
- Si el sistema no ve el mando, corrige cable, Bluetooth, batería, controlador o permisos.
- Si el sistema lo ve pero Ryujinx no, vuelve a seleccionar el dispositivo en Player 1.
- Si los botones se mapean pero no funcionan, revisa tipo de control, ranura y Steam Input.
- Si falló tras actualizar, compara con la build anterior antes de borrar perfiles.
Relaciona el síntoma antes de cambiar ajustes
Cada síntoma apunta a una capa distinta. Esta tabla evita reinstalaciones innecesarias y mantiene el diagnóstico práctico.
| Síntoma | Capa probable | Siguiente acción |
|---|---|---|
| Solo aparece teclado | Detección | Reconecta, prueba cable, reinicia Ryujinx y abre entrada. |
| Aparece el mando pero no responde | Perfil | Activa Player 1, elige dispositivo, tipo y guarda. |
| Steam Deck falla en Game Mode | Steam Input | Revisa el mando virtual y el layout. |
| Un juego funciona y otro no | Perfil del juego | Prueba el perfil predeterminado primero. |
| Falló tras actualizar | Regresión o perfil | Prueba la build anterior y guarda el perfil. |
Comprobaciones en Windows
En Windows, decide si el mando llega como XInput, DirectInput o Bluetooth con soporte parcial. Los mandos Xbox suelen ser los más simples. PlayStation, Switch Pro y mandos de terceros pueden necesitar cable estable, un wrapper o Steam Input para presentarse como mando virtual compatible.
- Usa un cable USB directo para la primera prueba si Bluetooth es inestable.
- Cierra otros launchers que puedan reservar el mando.
- Evita ejecutar una app como administrador y otra sin elevar dentro de la misma cadena.
- Guarda copia de un perfil funcional antes de probar una nueva Canary.
Linux y Steam Deck
Linux y Steam Deck añaden una variable importante: la ruta de lanzamiento. Un mando puede funcionar en modo escritorio y fallar al añadir el emulador a Steam. Prueba primero el AppImage o archivo en modo escritorio; después añade la app a Steam y mantén la misma ruta mientras revisas la entrada.
- Confirma entrada en Desktop Mode antes de Game Mode.
- Usa un layout de Steam simple para la primera prueba.
- Si Steam Input está activo, selecciona el mando virtual visto por Ryujinx.
- Tras cambiar permisos del AppImage, vuelve a abrir desde el acceso final.
Reconstruye el perfil de Player 1
Los perfiles antiguos pueden sobrevivir a actualizaciones, cambios de mando y launchers. Si Ryujinx Canary muestra el mando pero el mapeo es incoherente, reconstruye Player 1 desde una base simple: dispositivo, tipo de control, botones, guardar, cerrar ajustes y probar un juego.
- Usa el mismo nombre de dispositivo en todo el perfil.
- Mapea botones, sticks y gatillos antes de opciones avanzadas.
- Reabre ajustes para confirmar que se guardó.
- Crea perfiles por juego solo después de validar el perfil base.
Cuando una actualización Canary rompe controles
Canary cambia rápido. Si los controles fallan justo después de actualizar, compáralo como un problema de versión: conserva la build nueva, abre la build anterior en otra carpeta y prueba el mismo mando, perfil y ruta de lanzamiento.
| Comprobación | Por qué importa |
|---|---|
| La build anterior funciona | Puede ser una regresión Canary. |
| Ambas fallan | Probable emparejamiento, Steam Input o perfil dañado. |
| Solo falla un acceso directo | El launcher cambia el dispositivo visto por Ryujinx. |
No mezcles controles con keys o firmware
Keys y firmware afectan al arranque de juegos, pero no hacen aparecer un mando en la lista de entrada. Si el juego no arranca, termina primero la guía de instalación. Si el juego arranca y solo falla la entrada, mantente en este flujo. Este sitio no aloja keys, firmware, ROMs, DLC ni juegos.
Fuentes y comprobaciones
Referencias para contexto oficial de setup y solución de problemas.
FAQ de mandos en Ryujinx Canary
¿Por qué Ryujinx Canary solo muestra teclado?
El mando probablemente no es visible para Ryujinx. Reconéctalo, prueba cable, confirma que el sistema lo ve y vuelve a elegirlo en Player 1.
¿Por qué aparece pero no funciona en el juego?
Puede estar seleccionado sin un mapeo guardado. Reconstruye Player 1, define el tipo de control y guarda.
¿Qué revisa primero Steam Deck?
Si ocurre en Desktop Mode, Game Mode o solo por un acceso concreto. Steam Input puede crear un mando virtual.
¿Una actualización Canary puede romper entrada?
Sí. Compara con la build anterior y conserva el perfil antiguo hasta entender la causa.
¿Debo reinstalar Ryujinx Canary?
Normalmente no. Revisa detección, perfil, mapeo y Steam Input antes.
¿Keys o firmware afectan la detección?
No. Afectan al arranque de juegos, no a que aparezca el mando.