Guia de solução do Citron
Citron Emulator trava ou mostra tela preta? Comece aqui
Use uma checklist por sintoma para travamentos, tela preta, falhas de inicialização, gráficos quebrados, controle ausente e regressões depois de uma atualização.
Resposta curta: descubra a camada que falhou antes de mudar as configurações
O Citron Emulator travar não significa automaticamente que o jogo é incompatível. A causa pode ser um pacote incompleto, build da plataforma errada, driver gráfico, configuração danificada, cache, camada de entrada, arquivos de sistema próprios ou uma regressão do build exato.
Quando aparece uma tela preta, verifique primeiro se áudio, menus ou controle ainda respondem. Uma janela silenciosa e congelada exige uma investigação diferente de um jogo que continua rodando com falha de renderização.
Mantenha resultados Stable e Nightly separados. A versão Stable conferida para este guia é 2026-04-27; o canal CI conferido usa o commit 22d5038ec. São referências de comparação, não uma promessa para todos os jogos ou dispositivos.
Mude uma variável por vez, repita o mesmo teste curto e guarde a configuração anterior. Assim fica mais fácil confirmar uma correção e descrever um problema em um issue oficial.
Escolha o ramo certo
Solução de problemas do Citron: verifique a camada ligada ao sintoma
Comece pelo teste menos invasivo. Alterar gráficos, cache, entrada e firmware ao mesmo tempo elimina pistas importantes.
| Camada | Primeiro teste | Por que importa |
|---|---|---|
| Inicialização ou pacote | Use o asset correto, conclua a extração e confirme que o sistema consegue ler e executar o arquivo. | Biblioteca ausente, arquitetura errada ou arquivo bloqueado pode parecer um crash do emulador. |
| Build ou canal | Anote a tag Stable ou o hash CI/Nightly antes de testar e não misture builds. | Correções e regressões pertencem a uma versão específica. |
| Renderizador ou driver | Volte ao backend padrão, anote GPU e driver e compare apenas um backend alternativo. | Tela preta e texturas quebradas podem ser específicas do backend ou driver. |
| Arquivos e controle | Confira seus arquivos legais, caminho do jogo, permissões e detecção do controle sem baixar pacotes. | Arquivos incompatíveis, caminhos ilegíveis ou camadas duplicadas confundem o diagnóstico. |
| Configuração e cache | Faça backup do perfil, teste uma configuração limpa e só depois reconstrua o cache. | Um cache antigo pode causar o problema, mas apagá-lo sem backup remove evidências. |
Fluxo reproduzível
Teste de cinco minutos para um crash do Citron
A sequência separa um problema geral de início de um problema de renderização, entrada, conteúdo ou build.
Reproduza uma vez
Anote o sintoma exato: crash antes da janela, depois do logo, tela preta com áudio, congelamento ou controle ausente.
Registre a base
Guarde tag ou hash, sistema, GPU ou chipset, driver, renderer, atualização do jogo e canal Stable ou Nightly.
Volte ao padrão
Faça backup do perfil, desative overlays e ajustes experimentais e repita o mesmo teste.
Mude uma variável
Teste apenas renderer, resolução, cache, camada de controle ou perfil. Não mude tudo junto.
Compare ou reverta
Se começou após atualizar, compare o mesmo teste com o build salvo ou uma versão Stable verificada.
Guarde evidências com segurança
O que registrar quando o Citron não funciona
Uma anotação curta costuma ser suficiente. Mantenha o log original, o backup da configuração e o identificador do build juntos para repetir o teste após reiniciar ou fazer rollback.
Não publique caminhos pessoais, tokens, dumps privados ou arquivos de sistema protegidos. Em um issue, compartilhe apenas o trecho mínimo e seguro permitido pelo projeto.
Um nome de pasta como o exemplo ajuda a separar testes sem indicar que o site distribui conteúdo do Citron.
- Tag ou commit exato e data do teste.
- Sistema, dispositivo, GPU ou chipset, driver, renderer e modo de energia.
- Versão do jogo, DLC/mods, última tela bem-sucedida e número de repetições.
- Um backup da configuração e a única mudança antes do novo teste.
Citron-troubleshooting/test-01/É apenas um exemplo de organização. Não baixe logs, pacotes de keys, firmware, ROMs ou instaladores reempacotados de uma página de solução.
Mudanças conservadoras
Qual configuração do Citron mudar primeiro?
Faça a menor alteração que teste sua hipótese e restaure o valor anterior se o resultado piorar.
| Área | Comece com | Mude somente quando |
|---|---|---|
| Backend gráfico | Backend padrão da plataforma | A tela preta se repete e o log aponta para o renderer. |
| Resolução | Nativa ou 1x | A base está estável e você está medindo desempenho. |
| Shader/cache | Deixe o build atual criar | O cache veio de outro build ou parece danificado. |
| Perfil | Faça backup e teste um perfil limpo | O perfil limpo muda o sintoma. |
| Controle | Uma camada de mapeamento | Steam Input, remapper ou outro perfil duplica a entrada. |
| Stable/Nightly | Stable como referência | Um fix oficial justifica um Nightly com rollback. |
Relacione o próximo teste ao sintoma
Ramos comuns de crash e tela preta no Citron
São ramos de diagnóstico, não garantias. Mantenha o build e o ambiente junto de cada resultado.
O Citron fecha antes da janela aparecer
Verifique asset da plataforma, extração, arquitetura, bloqueio do sistema, dependências e um perfil limpo.
Próximo teste: Use a página oficial, extraia para um caminho local simples e repita sem overlays.
O Citron mostra tela preta
Separe uma janela congelada de um jogo com áudio ou entrada. Renderer, driver, cache, arquivos e regressões podem parecer iguais.
Próximo teste: Registre a última tela correta, volte aos gráficos padrão e compare um backend ou build verificado.
O áudio funciona, mas o vídeo não
O processo pode continuar ativo enquanto o caminho gráfico falha. Anote GPU, driver, backend, resolução e resposta dos menus.
Próximo teste: Teste resolução nativa e um renderer alternativo; uma cena preta não prova incompatibilidade.
O controle não aparece ou duplica entradas
Verifique primeiro a detecção pelo sistema. Steam Input, controles virtuais e perfis podem se sobrepor.
Próximo teste: Desative a camada duplicada, reconecte o controle e teste um perfil direto.
Uma atualização quebrou a configuração
Build, jogo, driver, cache ou perfil podem ter mudado. Um Nightly pode corrigir um problema e criar outro.
Próximo teste: Compare o mesmo teste com o build salvo ou com a base Stable 2026-04-27.
Aparece erro de cache ou log
A mensagem é uma pista, não uma ordem para apagar tudo. Preserve o perfil e confirme que o cache pertence ao mesmo build.
Próximo teste: Faça backup, reconstrua apenas o cache afetado e repita a inicialização.
Perguntas de diagnóstico
FAQ: Citron Emulator travando
Por que o Citron Emulator trava sempre?
Build, driver ou renderer, perfil ou cache, camada de controle, arquivos próprios e regressões são ramos comuns. Registre o sintoma e teste um por vez.
Como corrigir uma tela preta no Citron?
Verifique áudio e entrada, registre build e renderer, volte à resolução nativa e ao padrão e compare um backend ou build verificado.
Devo apagar o cache de shaders?
Faça backup primeiro. Reconstrua o cache apenas se ele for do mesmo build e houver sinal de corrupção. Apagar tudo elimina evidências.
Stable ou Nightly para corrigir um crash?
Comece com Stable. Teste Nightly apenas com um motivo oficial e guarde o hash completo para voltar atrás.
Keys ou firmware podem corrigir uma tela preta?
Arquivos próprios corretos podem resolver configuração, mas não garantem compatibilidade nem corrigem todo erro gráfico. Não use pacotes agrupados.
O Citron Neo Wiki é o suporte oficial?
Não. É um guia independente que aponta para releases e issues públicos de primeira parte e não hospeda emulador, jogos, keys ou firmware.
Evidência de primeira parte
Fontes para consultar antes de chamar um crash de regressão
Compare identificadores de release, assets e issues atuais. Nenhuma fonte substitui um teste local reproduzível.
- Release Stable oficial 2026-04-27Base Stable e notas de release conferidas para este guia.
- Releases oficiais do Citron CIPágina por plataforma para comparar o hash Nightly.
- Issues oficiais do emuladorCompare hardware, driver, build, logs e reprodução.
- Guia de compatibilidade do CitronUse quando o emulador inicia e o problema é específico do jogo.