Guida alla risoluzione dei problemi Citron
Citron Emulator si blocca o mostra una schermata nera? Inizia qui
Usa una checklist basata sui sintomi per crash, schermate nere, avvii falliti, grafica difettosa, input del controller assente e regressioni dopo un aggiornamento.
In breve: individua il livello guasto prima di cambiare le impostazioni
Il crash di Citron Emulator non significa automaticamente che il gioco sia incompatibile. La causa può essere un pacchetto incompleto, un build per la piattaforma sbagliata, il driver grafico, una configurazione danneggiata, la cache, un livello di input, file di sistema propri o una regressione del build preciso.
Con una schermata nera, controlla prima se audio, menu o controller rispondono. Una finestra silenziosa e bloccata richiede una diagnosi diversa da un gioco che continua a funzionare con un problema di rendering.
Tieni separati i risultati Stable e Nightly. La versione Stable verificata per questa guida è 2026-04-27; il canale CI verificato usa il commit 22d5038ec. Sono riferimenti di confronto, non una garanzia per ogni gioco o dispositivo.
Cambia una sola variabile, ripeti lo stesso test breve e conserva la configurazione precedente. Così puoi confermare una soluzione e descrivere meglio un issue ufficiale.
Scegli il ramo corretto
Risoluzione problemi Citron: controlla il livello collegato al sintomo
Inizia dal controllo meno invasivo. Cambiare grafica, cache, input e firmware insieme elimina gli indizi.
| Livello | Primo controllo | Perché conta |
|---|---|---|
| Avvio o pacchetto | Usa l'asset corretto, completa l'estrazione e verifica che il sistema possa leggere ed eseguire il file. | Librerie mancanti, architettura errata o file bloccati possono sembrare un crash dell'emulatore. |
| Build o canale | Annota tag Stable o hash CI/Nightly prima del test e non mescolare build diversi. | Fix e regressioni appartengono a una versione precisa. |
| Renderer o driver | Torna al backend predefinito, annota GPU e driver e confronta un solo backend alternativo. | Schermate nere e texture rotte possono dipendere dal backend o dal driver. |
| File di sistema e input | Controlla i tuoi file legali, percorso del gioco, permessi e rilevamento del controller senza scaricare pacchetti. | File non coerenti, percorsi illeggibili o livelli di input duplicati confondono la diagnosi. |
| Configurazione e cache | Fai un backup del profilo, prova una configurazione pulita e ricrea la cache solo dopo aver salvato lo stato originale. | Una cache vecchia può essere la causa, ma cancellarla senza backup elimina le prove. |
Flusso riproducibile
Test di cinque minuti per un crash di Citron
La sequenza separa un problema generale di avvio da uno specifico di renderer, input, contenuto o build.
Riproduci una volta
Scrivi il sintomo esatto: crash prima della finestra, dopo il logo, schermata nera con audio, blocco o input assente.
Registra la base
Salva tag o hash, sistema, GPU o chipset, driver, renderer, aggiornamento del gioco e canale Stable o Nightly.
Torna ai valori predefiniti
Fai il backup del profilo, disabilita overlay e opzioni sperimentali e ripeti lo stesso test.
Cambia una variabile
Prova solo renderer, risoluzione, cache, livello del controller o profilo. Non cambiare tutto insieme.
Confronta o torna indietro
Se il problema è iniziato dopo un aggiornamento, confronta lo stesso test con il build salvato o con Stable verificato.
Conserva prove sicure
Cosa registrare quando Citron non funziona
Per la maggior parte dei casi basta una nota breve. Conserva log originale, backup della configurazione e identificatore del build insieme per ripetere il test dopo un riavvio o un rollback.
Non pubblicare percorsi personali, token, dump privati o file di sistema protetti. In un issue condividi solo il frammento minimo e sicuro permesso dal progetto.
Un nome di cartella come quello sotto separa i test, senza indicare che il sito distribuisca contenuti Citron.
- Tag o commit esatto e data del test.
- Sistema, dispositivo, GPU o chipset, driver, renderer e modalità energetica.
- Versione del gioco, DLC/mod, ultima schermata riuscita e numero di ripetizioni.
- Un backup della configurazione e l'unica modifica prima del nuovo test.
Citron-troubleshooting/test-01/È solo un esempio organizzativo. Non scaricare log, pacchetti di key, firmware, ROM o installer ripacchettizzati da una pagina di supporto.
Modifiche conservative
Quale impostazione di Citron cambiare per prima?
Fai la modifica più piccola che verifichi l'ipotesi e ripristina il valore precedente se il risultato peggiora.
| Area | Inizia con | Cambia solo quando |
|---|---|---|
| Backend grafico | Backend predefinito della piattaforma | La schermata nera si ripete e il log indica il renderer. |
| Risoluzione | Nativa o 1x | La base è stabile e stai misurando le prestazioni. |
| Shader/cache | Lascia creare la cache al build attuale | La cache appartiene a un altro build o sembra danneggiata. |
| Profilo | Backup e profilo pulito | Il profilo pulito modifica il sintomo. |
| Controller | Un solo livello di mapping | Steam Input, remapper o un secondo profilo duplica l'input. |
| Stable/Nightly | Stable come riferimento | Un fix ufficiale giustifica un Nightly con rollback. |
Collega il test al sintomo
Rami comuni per crash e schermata nera in Citron
Sono rami diagnostici, non garanzie. Conserva build e ambiente con ogni risultato.
Citron si chiude prima della finestra
Controlla asset della piattaforma, estrazione, architettura, blocco del sistema, dipendenze e profilo pulito.
Prossimo test: Usa la pagina ufficiale, estrai in un percorso locale semplice e ripeti senza overlay.
Citron mostra una schermata nera
Distingui una finestra bloccata da un gioco con audio o input. Renderer, driver, cache, file e regressioni possono sembrare uguali.
Prossimo test: Registra l'ultima schermata corretta, ripristina la grafica standard e confronta un backend o build verificato.
L'audio funziona ma il video no
Il processo può restare attivo mentre fallisce il percorso grafico. Annota GPU, driver, backend, risoluzione e risposta dei menu.
Prossimo test: Prova la risoluzione nativa e un renderer alternativo; una scena nera non dimostra incompatibilità.
Il controller manca o duplica l'input
Verifica prima il rilevamento del sistema. Steam Input, controller virtuali e profili possono sovrapporsi.
Prossimo test: Disattiva il livello duplicato, ricollega il controller e prova un profilo diretto.
Un aggiornamento rompe una configurazione funzionante
Build, gioco, driver, cache o profilo possono essere cambiati. Un Nightly può correggere un problema e crearne un altro.
Prossimo test: Confronta lo stesso test con il build salvato o con la base Stable 2026-04-27.
Compare un errore di cache o log
Il messaggio è un indizio, non un ordine di cancellare tutto. Conserva il profilo e verifica che la cache appartenga allo stesso build.
Prossimo test: Fai un backup, ricrea solo la cache interessata e ripeti l'avvio.
Domande di diagnosi
FAQ sui crash di Citron Emulator
Perché Citron Emulator continua a bloccarsi?
Build, driver o renderer, profilo o cache, livello del controller, file propri e regressioni sono rami comuni. Registra il sintomo e prova un ramo alla volta.
Come risolvo una schermata nera in Citron?
Controlla audio e input, registra build e renderer, torna alla risoluzione nativa e ai valori predefiniti e confronta un backend o build verificato.
Devo eliminare la cache shader?
Fai prima un backup del profilo. Ricrea la cache solo se appartiene allo stesso build e c'è un segnale di corruzione. Eliminare tutto cancella le prove.
Stable o Nightly per correggere un crash?
Inizia con Stable. Prova Nightly solo per un motivo ufficiale e conserva l'hash completo per tornare indietro.
Keys o firmware possono correggere una schermata nera?
File propri corretti possono risolvere un problema di configurazione, ma non garantiscono compatibilità e non correggono ogni errore grafico. Evita pacchetti aggregati.
Citron Neo Wiki è il supporto ufficiale?
No. È una guida indipendente che collega release e issue pubblici di prima parte e non ospita emulatore, giochi, keys o firmware.
Prove di prima parte
Fonti da controllare prima di chiamare un crash regressione
Confronta identificatori di release, asset e issue attuali. Nessuna fonte sostituisce un test locale riproducibile.
- Release Stable ufficiale 2026-04-27Base Stable e note verificate per questa guida.
- Release ufficiali Citron CIPagina per piattaforma per confrontare l'hash Nightly.
- Issue ufficiali dell'emulatoreConfronta hardware, driver, build, log e riproduzione.
- Guida alla compatibilità CitronUsala quando l'emulatore si avvia e il problema riguarda il gioco.