Teste fora do Ryujinx
Confirme o controle no sistema ou em outro app antes de mudar perfis do emulador.
Solução de controles
Controle não funciona no Ryujinx Canary? Corrija a entrada passo a passo
Use este guia quando o Ryujinx Canary não detecta o controle, mapeia botões errados, perde entrada no Steam Deck ou falha após atualização.
$ 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.
Intenção
Corrigir entrada
Primeiro teste
Um controle, Jogador 1
Steam Deck
Perfil Steam Input
Risco Canary
Regressão de atualização
Ordem rápida para corrigir controles
Configure só o Jogador 1
Ative Player 1, escolha o dispositivo e o tipo de controle, depois salve.
Mapeie um perfil
Mapeie botões, analógicos e gatilhos para esse dispositivo e teste um jogo.
Separe Steam Input
No Steam Deck ou Steam, veja se há um gamepad virtual sendo entregue ao Ryujinx.
Compare a build anterior
Se quebrou após atualizar, teste a build Canary que funcionava antes.
Começar verificações
Use este guia quando o Ryujinx Canary não detecta o controle, mapeia botões errados, perde entrada no Steam Deck ou falha após atualização.
Comece pela camada que falha
Separe o problema em dispositivo físico, sistema operacional, perfil de entrada do Ryujinx, Steam Input e jogo específico. Não mude gráficos, firmware e controles na mesma rodada. Um teste limpo usa um controle, um slot de jogador, um jogo e uma mudança por vez.
- Se o sistema não vê o controle, corrija cabo, Bluetooth, bateria, driver ou permissões.
- Se o sistema vê, mas o Ryujinx não, selecione o dispositivo novamente em Player 1.
- Se os botões mapeiam, mas não funcionam no jogo, revise tipo de controle, slot e Steam Input.
- Se falhou após atualização Canary, compare com a build anterior.
Associe o sintoma antes de mudar configurações
Sintomas diferentes apontam para camadas diferentes. A tabela evita reinstalações desnecessárias.
| Sintoma | Camada provável | Próxima ação |
|---|---|---|
| Só teclado aparece | Detecção | Reconectar, testar cabo, reiniciar Ryujinx e abrir entrada. |
| Controle aparece, sem resposta | Perfil | Ativar Player 1, escolher dispositivo, tipo e salvar. |
| Steam Deck falha no Game Mode | Steam Input | Verificar gamepad virtual e layout. |
| Um jogo funciona, outro não | Perfil do jogo | Testar o perfil padrão primeiro. |
| Falhou após update | Regressão ou perfil | Testar build anterior e salvar perfil. |
Verificações no Windows
No Windows, identifique se o controle aparece como XInput, DirectInput ou Bluetooth parcial. Controles Xbox costumam ser simples. PlayStation, Switch Pro e controles de terceiros podem precisar de cabo estável, wrapper ou Steam Input para aparecer como gamepad virtual confiável.
- Use USB direto se Bluetooth estiver instável.
- Feche launchers que possam reservar o controle.
- Evite misturar apps com e sem administrador na mesma cadeia de entrada.
- Faça backup de um perfil funcional antes de testar uma nova Canary.
Linux e Steam Deck
Linux e Steam Deck adicionam a variável da rota de abertura. Um controle pode funcionar em modo desktop e falhar depois de adicionar o emulador ao Steam. Teste o AppImage ou arquivo em desktop mode primeiro; depois adicione ao Steam e mantenha a mesma rota durante a verificação.
- Confirme Desktop Mode antes de Game Mode.
- Use um layout Steam simples no primeiro teste.
- Com Steam Input ativo, escolha o gamepad virtual visto pelo Ryujinx.
- Após permissões do AppImage, reabra pelo atalho final.
Reconstrua o perfil Player 1
Perfis antigos podem sobreviver a updates, trocas de dispositivo e launchers. Se o Ryujinx Canary mostra o controle, mas o mapeamento está inconsistente, reconstrua Player 1: dispositivo, tipo, botões, salvar, fechar ajustes e testar um jogo.
- Use o mesmo nome de dispositivo no perfil todo.
- Mapeie botões, analógicos e gatilhos antes de opções avançadas.
- Reabra as configurações para confirmar que salvou.
- Crie perfis por jogo só depois do perfil padrão funcionar.
Quando atualização Canary quebra entrada
Builds Canary mudam rápido. Se os controles falham logo após atualizar, mantenha a build nova, abra a anterior em outra pasta e teste o mesmo controle, perfil e rota de abertura.
| Verificação | Por que importa |
|---|---|
| Build anterior funciona | Pode ser regressão Canary. |
| Ambas falham | Pareamento, Steam Input ou perfil danificado é mais provável. |
| Só um atalho falha | O launcher pode mudar o dispositivo visto pelo Ryujinx. |
Não misture controles com keys ou firmware
Keys e firmware afetam se jogos iniciam, mas não fazem um controle aparecer na lista de entrada. Se o jogo não inicia, termine a instalação primeiro. Se o jogo inicia e só a entrada falha, mantenha este fluxo. Este site não hospeda keys, firmware, ROMs, DLC ou jogos.
Fontes e verificações
Referências oficiais de setup e solução de problemas.
FAQ de controles Ryujinx Canary
Por que só aparece teclado?
O controle provavelmente ainda não está visível para o Ryujinx. Reconecte, teste cabo, confirme no sistema e selecione em Player 1.
Por que aparece, mas não funciona no jogo?
O perfil ativo pode não estar mapeado ou salvo. Reconstrua Player 1 e salve.
O que verificar primeiro no Steam Deck?
Desktop Mode, Game Mode e Steam Input separadamente, porque o Steam pode expor um gamepad virtual.
Uma atualização Canary pode quebrar entrada?
Sim. Compare com a build anterior antes de apagar perfis.
Devo reinstalar Ryujinx Canary?
Normalmente não. Verifique detecção, perfil, mapeamento e Steam Input primeiro.
Keys ou firmware afetam a detecção?
Não. Eles afetam o boot dos jogos, não a lista de dispositivos.