Controles de teclado do Ryujinx: mapeie teclas e corrija a entrada

Comece pelo caminho de configuração dos controles de teclado do Ryujinx

Os nomes dos menus podem mudar entre forks do Ryujinx e versões Canary, mas a ordem de verificação permanece parecida. Abra a configuração de entrada ou controle, selecione o Player 1, escolha o teclado exibido pelo sistema e monte um perfil básico antes de mexer em perfis avançados. Se aparecerem vários tipos de controle, escolha o que corresponde ao layout esperado pelo jogo; não presuma que existe um modo universal especial para teclado. Salve o perfil, feche o diálogo e abra-o novamente antes de um teste longo. Assim você confirma que o mapeamento foi realmente persistido. Um perfil limpo é mais fácil de corrigir do que uma configuração alterada por vários jogos, launchers ou substituições por título.

• Deixe Player 2, movimento e perfis alternativos fora do primeiro teste.
• Anote o nome do perfil original antes de editar uma configuração existente.
• Mapeie apenas o necessário para abrir um menu e completar uma ação curta.
• Abra a tela de entrada novamente e confirme que as teclas continuam visíveis.

Mapeie primeiro os controles de teclado do Ryujinx mais importantes

Um teclado oferece mais teclas individuais do que um jogo precisa, mas preencher uma lista não cria automaticamente um bom layout. Comece pelos comandos de movimento, confirmação, cancelamento e interação. Depois acrescente ações de sistema e entradas opcionais. Não prometa que Enter será sempre confirmação: perfil, jogo e build podem usar rótulos diferentes, e essa tecla pode estar atribuída a outra ação. A tabela indica uma ordem de teste, não uma lista fixa de atalhos. Assim, a busca por controles Ryujinx e mapeamento de teclado continua baseada no perfil real, sem inventar padrões.

Teclado ou controle: qual entrada combina com o jogo?

O teclado é útil quando você não tem um gamepad, prefere comandos digitais ou quer fazer um teste rápido no desktop. Ele é menos natural para movimento analógico, gatilhos sensíveis à pressão, toque e movimento. Se um jogo responde bem a um controle mas fica desconfortável no teclado, isso costuma ser uma diferença de design, não uma falha do Ryujinx. Use esta página quando a intenção é mapear teclas; use o guia de controles quando o gamepad não é detectado. Separar as duas intenções evita alterar a camada de entrada errada.

Teclado do Ryujinx não funciona: verifique a camada correta

Quando o teclado do Ryujinx não funciona, descubra primeiro se o erro é global, específico de um perfil ou limitado a um jogo. Teste a tecla em outro aplicativo para confirmar que o teclado físico e o sistema operacional recebem o evento. No Ryujinx, verifique Player 1, dispositivo selecionado, perfil ativo e mapeamento salvo. Se os menus respondem mas uma ação do jogo não, pode haver outra ação, tecla duplicada ou substituição por jogo. Se todas as teclas pararam após uma atualização, compare um perfil limpo com a build Canary anterior antes de apagar os dados do usuário. Esse diagnóstico por camadas é mais útil do que reinstalar imediatamente.

• Se o sistema não recebe a tecla, corrija teclado, layout, foco ou permissões primeiro.
• Se apenas um perfil falha, crie uma base temporária do Player 1 em vez de editar todos.
• Se os menus funcionam, teste outro jogo e confira substituições específicas do título.
• Se começou depois de atualizar, faça backup do perfil e compare a build anterior.
• Feche overlays ou launchers que possam capturar atalhos globais antes de repetir o teste.

O que mouse e teclado podem e não podem fazer

As pesquisas sobre usar mouse no Ryujinx misturam o controle da janela do emulador com a emulação de ponteiro, toque ou movimento esperado por um jogo. Um clique não vira automaticamente um botão de console, e o botão direito não tem um significado universal no Ryujinx. Configure somente as ações expostas pela sua build e pelo perfil do jogo, e teste dentro do título. Em jogos feitos para analógicos, toque ou giroscópio, mouse e teclado podem ser apenas uma solução parcial. Não copie uma lista de teclas de outra build sem confirmar no seu perfil.

• Use o teclado para ações digitais e o mouse somente onde o perfil expuser uma ação útil.
• Não presuma que clique esquerdo, direito ou Enter têm sempre o mesmo significado.
• Teste ponteiro, toque ou movimento no jogo, não apenas na janela de configuração.
• Se precisar de faixa analógica, compare com um controle antes de mudar gráficos.

Notas para Windows, Linux, macOS e Steam Deck

O conceito de mapeamento é o mesmo em todas as plataformas, mas o caminho dos eventos pode mudar. No Windows, verifique layout de teclado, foco da janela e overlays. No Linux, sessão gráfica e permissões podem definir se a janela do emulador recebe eventos. No macOS, confira o aplicativo em foco e eventuais avisos de privacidade ou acessibilidade ligados à entrada. O Steam Deck acrescenta Desktop Mode, Game Mode e Steam Input como variáveis separadas; teste pelo mesmo caminho usado para abrir o jogo. Não compare um perfil criado no Desktop Mode com uma execução no Game Mode como se os eventos fossem iguais.

• Windows: feche ferramentas de atalhos e overlays e clique no Ryujinx antes do teste.
• Linux: reproduza na mesma sessão e método de inicialização usado pelo jogo.
• macOS: confirme que o Ryujinx está em foco e revise permissões de entrada.
• Steam Deck: teste Desktop Mode e Game Mode separadamente e anote o Steam Input.
• Em qualquer plataforma, mantenha um perfil conhecido e mude uma variável por vez.

Quando uma atualização Canary muda seu perfil de teclado

Builds Canary mudam rapidamente. Primeiro salve uma cópia do perfil ou dos dados de usuário que o contêm. Anote build, sistema operacional, layout do teclado e caminho de inicialização. Teste a mesma tecla no mesmo menu ou cena com a build nova e, se possível, com a build anterior que funcionava em outra pasta. Se somente a nova falhar, isso é evidência de comportamento específico da versão; não é motivo para baixar um substituto não verificado ou apagar todos os arquivos de configuração. Use o guia de atualização e rollback para uma comparação mais ampla.

Separe entrada do teclado de keys, firmware e arquivos de jogos

Controles de teclado são um problema de perfil de entrada, não um motivo para procurar keys, firmware, ROMs, DLC ou downloads de jogos. Se o emulador abre e um jogo local legal funciona, mas uma tecla não responde, permaneça no fluxo de entrada. Se o jogo não inicia, use os guias de instalação, keys e firmware ou compatibilidade. Este site não hospeda arquivos de jogos protegidos e não afirma que o teclado substitui todas as entradas de controle, toque ou movimento. Manter esse limite protege seus saves e deixa os testes mais fáceis de interpretar.

• Não apague keys, firmware, saves ou toda a pasta de usuário por causa de uma tecla.
• Use as fontes oficiais abaixo para contexto de configuração.
• Faça backup de um perfil funcional antes de testar outra build Canary.
• Passe ao guia de crash, compatibilidade ou controles quando o sintoma pertencer a ele.