Solução de problemas
Checagens rápidas para “não abre”. Chaves, firmware e jogos: veja a documentação oficialprimeiro; wiki Forge para casos raros.
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:
Downloads oficiais
Perguntas frequentes
- Ryujinx não abre — preciso do .NET?
- No Windows, instale a versão do .NET Desktop Runtime indicada no erro, da Microsoft, e abra o Ryujinx de novo.
- Ryujinx no Steam Deck — qual build?
- Baixe sempre o AppImage ou tar.gz Linux x64 — não ARM64. Configure chaves e firmware primeiro no Modo Desktop. Guia Steam Deck.
- Tela preta ou crash nos jogos?
- Tente alternar o backend gráfico entre Vulkan e OpenGL em Opções → Configurações → Gráficos. Atualize drivers e limpe o cache de shaders se necessário.
- Canary vs Stable — qual usar?
- Stable é melhor para iniciantes; Canary atualiza mais rápido mas pode quebrar. Você pode reverter na página de releases. Canary vs Stable.