Solução de problemas
Checagens rápidas para “não abre”. Chaves, firmware e jogos: wiki do projeto.
App não inicia (Windows)
- Instale o .NET Desktop Runtime indicado no erro (via Microsoft).
- Permita o app no Windows Security se estiver em quarentena.
- SmartScreen: Mais informações → Executar mesmo assim (arquivos oficiais).
Quebrou após atualizar
Em Canary ou Stable, abra tag antiga e baixe o mesmo asset de plataforma. Caminhos via Arquivo → Abrir pasta Ryujinx quando um build abrir. Faça backup.
Asset errado
x64 e ARM64 são diferentes; baixe o que combina com seu PC. Passos de instalação.
Linux / SteamOS
- AppImage não roda: chmod +x ou marque executável nas propriedades.
- Steam Deck: use build x64 Linux, não ARM64. Veja Linux → Steam Deck.
- Não abre após instalação antiga: feche Ryujinx, renomeie
~/.config/Ryujinx, abra de novo (config limpa) e repita primeira configuração. - Forge / GitLab fora ou login: pode ser manutenção — veja Ryubing/fóruns ou tente depois; abra tag e Assets direto quando o host permitir.
- Modo jogo (Deck) — Apply/OK: abra teclado Steam (Steam + X), focus com Tab para Apply → OK; input Steam Controller em Options → Settings → Input (também Setup → Steam Deck).
- Teclado virtual ausente após sleep? reinício completo costuma recuperar.
Gráficos / som / entrada
Teste Vulkan vs OpenGL e confira Options. Docs completos: