Record when the crash happens
Separate launch crashes, game boot crashes, mid-game crashes and update regressions before changing settings.
Diagnóstico de crash
Use este guia quando o Ryujinx Canary fecha ao abrir, trava ao carregar um jogo, mostra tela preta, perde áudio antes do crash ou piora após update Canary.
$ crash: identify stage
$ test: one build one game
$ graphics: driver vulkan scale
$ rollback: compare previous build
Independent troubleshooting guide. No keys, firmware, ROMs, DLC or game files are hosted here.
Separate launch crashes, game boot crashes, mid-game crashes and update regressions before changing settings.
Use a legally dumped title that worked before, default settings and the same game directory so the test has a stable baseline.
Update GPU drivers when appropriate, verify Vulkan support, and change one backend or graphics option at a time.
Missing or mismatched keys, firmware or game updates can block boot, but they should be checked methodically and legally.
If the crash began after updating, keep the new build separate and test the last working build before deleting profiles or saves.
A crash can come from the build, graphics stack, setup files, game data or a local profile. Change one layer at a time so the fix is traceable.
Ryujinx Canary não fecha sempre pelo mesmo motivo. Se fecha antes da janela aparecer, verifique extração, permissões, dependências, inicialização gráfica ou configuração local corrompida. Se falha ao iniciar um jogo, olhe arquivos de setup legais, arquivo do jogo e backend gráfico. Durante gameplay, pense em título específico, shaders, escala, áudio ou regressão Canary.
Não mude build, firmware, update do jogo, backend e perfil ao mesmo tempo. Comece com uma build Canary, um jogo legal conhecido, um backend e um perfil. Mude uma variável e teste a mesma cena. Mantenha dados, saves e build funcional separados.
| Base | Por que importa | Evite |
|---|---|---|
| Uma build Canary | Mantém estável a variável do emulador | Não sobrescreva uma pasta que funciona logo de início |
| Um jogo conhecido | Separa crash do emulador de dump ruim | Não teste jogo novo e build nova juntos |
| Gráficos padrão | Reduz falsos diagnósticos | Não comece com SSAA alto ou overrides |
| Notas curtas | Ajudam no rollback | Não dependa da memória após vários testes |
Se Ryujinx Canary fecha antes das configurações, comece fora do emulador. Extraia novamente em pasta normal de usuário, evite locais protegidos, confirme permissões AppImage no Linux e Steam Deck e veja se o antivírus isolou arquivos.
A inicialização gráfica é causa comum. Se o app abre mas os jogos fecham, mostram tela preta ou travam com shaders, teste a pilha gráfica com método. Volte à escala nativa, atualize drivers claramente antigos e mude só uma opção por teste.
| Sintoma | Camada provável | Próxima ação |
|---|---|---|
| Tela preta e crash | Backend gráfico ou driver | Volte à escala nativa, confira driver e teste uma mudança. |
| Crash em cena com shaders | Shaders ou carga GPU | Repetir a cena e reduzir ajustes pesados. |
| Só um jogo crasha | Comportamento do jogo | Comparar com perfil padrão e guia de compatibilidade. |
| Todos os jogos crasham | Setup global ou gráficos | Verificar arquivos legais, driver e build anterior. |
Keys, firmware e arquivos de jogo fazem parte do boot, mas esta página não é um fluxo de compartilhamento. Ryujinx Canary não inclui conteúdo protegido e este site não hospeda isso. Se o erro aponta para setup, use seus próprios arquivos extraídos legalmente.
Builds Canary mudam rápido. Se os crashes aparecem só depois de atualizar, preserve a build nova, abra a anterior em outra pasta e teste o mesmo jogo, cena, configurações e perfil.
| Resultado | Significado | Próximo passo |
|---|---|---|
| Build antiga funciona | Possível regressão Canary | Mantenha a antiga e documente a falha. |
| Ambas falham | Causa fora do update | Volte à base e teste outro jogo conhecido. |
| Só um atalho falha | Launcher ou permissões | Compare início direto, Steam e permissões. |
Áudio e input podem falhar perto de um crash sem serem a causa. Se o app continua aberto, use a guia de controle ou áudio. Se fecha, registre cena, build e configurações antes de mudar mais coisas.
Registre build Canary, sistema, CPU, GPU, driver, backend gráfico, jogo, versão, se funcionava antes e o ponto exato do crash. Não compartilhe keys, firmware, ROMs, DLC, updates ou saves privados.
Verifique fontes oficiais antes de confiar em correções de crash ou builds supostamente recentes.
Geralmente por extração incompleta, pasta protegida, permissões, antivírus, dependências, inicialização gráfica ou configuração corrompida.
Só se a falha ocorre no setup ou boot e aponta para esses arquivos. Se chega ao gameplay, olhe gráficos, drivers, build ou título.
Sim. Compare com a build anterior usando o mesmo jogo, cena e configurações antes de apagar perfis.
Volte a gráficos conservadores, confira drivers/Vulkan e mude uma opção por vez.
Não. Evite packs com keys, firmware, ROMs, DLC, updates ou executáveis modificados.