Guide de dépannage Citron
Citron Emulator plante ou affiche un écran noir ? Commencez ici
Suivez une checklist basée sur les symptômes pour les plantages, écrans noirs, échecs de lancement, défauts graphiques, manettes absentes et régressions après une mise à jour.
Réponse courte : identifiez la couche en panne avant de modifier les réglages
Un plantage de Citron Emulator ne signifie pas forcément que le jeu est incompatible. Le problème peut venir d'un paquet incomplet, d'une mauvaise architecture, du pilote graphique, de la configuration, du cache, d'une couche d'entrée, des fichiers système personnels ou d'une régression du build utilisé.
Avec un écran noir, vérifiez d'abord si l'audio, les menus ou la manette répondent encore. Une fenêtre silencieuse et figée ne suit pas le même diagnostic qu'un jeu qui tourne avec un défaut de rendu.
Séparez toujours stable et nightly. La release stable vérifiée pour ce guide est 2026-04-27 et le canal CI vérifié utilise le commit 22d5038ec. Ce sont des repères de comparaison, pas une garantie pour chaque appareil.
Modifiez une seule variable, répétez le même test et gardez la configuration précédente. Vous pourrez ainsi confirmer une correction ou décrire un problème dans un issue officiel.
Choisir la bonne branche
Dépannage Citron Emulator : vérifier la couche liée au symptôme
Commencez par le contrôle le moins invasif. Modifier les graphiques, le cache, l'entrée et le firmware en même temps supprime les indices.
| Couche | Premier contrôle | Pourquoi |
|---|---|---|
| Lancement ou paquet | Utilisez l'asset adapté, terminez l'extraction et confirmez que le système peut lire et exécuter le fichier. | Une bibliothèque manquante, une mauvaise architecture ou un fichier bloqué peut ressembler à un plantage. |
| Build ou canal | Notez le tag stable ou le hash CI/nightly avant le test et ne mélangez pas les builds. | Une correction ou une régression appartient à une version précise. |
| Rendu ou pilote | Revenez au backend par défaut, notez le GPU et le pilote, puis comparez un seul backend alternatif. | Les écrans noirs et textures cassées peuvent dépendre du backend ou du pilote. |
| Fichiers système et entrée | Vérifiez vos fichiers légaux, le chemin du jeu, les droits et la détection de la manette sans télécharger de pack. | Des fichiers incohérents, un chemin illisible ou des couches d'entrée doubles trompent le diagnostic. |
| Configuration et cache | Sauvegardez le profil, testez une configuration propre et reconstruisez le cache après avoir conservé l'état initial. | Un cache obsolète peut être en cause, mais sa suppression sans sauvegarde efface les preuves. |
Flux reproductible
Le test de cinq minutes pour un plantage Citron
Cette séquence distingue un problème général de lancement d'un problème de rendu, d'entrée, de contenu ou de build.
Reproduire une fois
Écrivez le symptôme exact : plantage avant la fenêtre, après le logo, écran noir avec audio, gel ou entrée absente.
Noter la base
Gardez le tag ou hash, l'OS, le GPU ou chipset, le pilote, le renderer, la mise à jour du jeu et le canal.
Revenir aux valeurs par défaut
Sauvegardez le profil, désactivez les overlays et réglages expérimentaux, puis répétez le même test.
Changer une variable
Testez un renderer, une résolution, un cache, une couche de manette ou un profil, jamais tout en même temps.
Comparer ou revenir en arrière
Si le problème suit une mise à jour, comparez le même test avec un build stable vérifié ou sauvegardé.
Conserver des preuves sûres
Que noter quand Citron ne fonctionne pas
Une courte fiche suffit généralement. Gardez le log original, la sauvegarde de configuration et l'identifiant du build ensemble pour refaire le test après un redémarrage ou un rollback.
Ne publiez pas de chemins privés, tokens, dumps personnels ou fichiers système protégés. Dans un issue, joignez seulement l'extrait sûr et minimal autorisé par le projet.
Un dossier comme l'exemple ci-dessous sépare les tests sans signifier que le site distribue du contenu Citron.
- Tag ou commit exact et date du test.
- OS, appareil, GPU ou chipset, pilote, renderer et mode d'alimentation.
- Version du jeu, DLC/mods, dernier écran réussi et nombre de répétitions.
- Une sauvegarde de configuration et l'unique modification avant le nouveau test.
Citron-troubleshooting/test-01/C'est seulement un exemple d'organisation. Ne téléchargez pas de logs, packs de keys, firmware, ROM ou installateurs repackagés depuis une page de dépannage.
Modifications prudentes
Quel réglage Citron modifier en premier ?
Faites le plus petit changement qui teste votre hypothèse et restaurez l'ancienne valeur si le résultat empire.
| Zone | Commencer par | Modifier seulement si |
|---|---|---|
| Backend graphique | Backend par défaut | L'écran noir se répète et le log indique le renderer. |
| Résolution | Native ou 1x | La base est stable et vous mesurez les performances. |
| Shader/cache | Laisser le build actuel créer le cache | Le cache vient d'un autre build ou semble endommagé. |
| Profil | Sauvegarder puis tester un profil propre | Le profil propre change le symptôme. |
| Manette | Une seule couche de mappage | Steam Input, un remapper ou un profil double l'entrée. |
| Stable/nightly | Stable comme référence | Un correctif officiel justifie un nightly avec rollback. |
Associer le test au symptôme
Branches fréquentes des plantages et écrans noirs de Citron
Ce sont des branches de diagnostic, pas des garanties. Notez le build et l'environnement avec chaque résultat.
Citron plante avant l'apparition de la fenêtre
Vérifiez l'asset, l'extraction, l'architecture, le blocage du système, les dépendances et un profil propre.
Prochaine vérification : Utilisez la page officielle, extrayez vers un chemin local simple et répétez sans overlays.
Citron affiche un écran noir
Distinguez une fenêtre figée d'un jeu avec audio ou entrée. Renderer, pilote, cache, fichiers et régression peuvent se ressembler.
Prochaine vérification : Notez le dernier écran réussi, restaurez les réglages graphiques et comparez un backend ou build vérifié.
L'audio fonctionne mais pas la vidéo
Le processus peut tourner pendant que le chemin graphique échoue. Notez GPU, pilote, backend, résolution et réponse des menus.
Prochaine vérification : Testez la résolution native et un renderer alternatif; une scène noire ne prouve pas l'incompatibilité.
La manette est absente ou les entrées sont doublées
Vérifiez d'abord la détection par l'OS. Steam Input, les manettes virtuelles et les profils peuvent se superposer.
Prochaine vérification : Désactivez la couche doublée, reconnectez la manette et testez un profil direct.
Une mise à jour casse une configuration fonctionnelle
Le build, le jeu, le pilote, le cache ou le profil ont pu changer. Un nightly peut corriger un problème et en créer un autre.
Prochaine vérification : Comparez avec le build sauvegardé ou la base stable 2026-04-27.
Un message de cache ou de log apparaît
Le message est un indice, pas une instruction de tout supprimer. Conservez le profil et vérifiez que le cache correspond au build.
Prochaine vérification : Faites une copie, reconstruisez uniquement le cache concerné et répétez le lancement.
Questions de dépannage
FAQ : Citron Emulator plante
Pourquoi Citron Emulator plante-t-il toujours ?
Le build, le pilote ou renderer, le profil ou cache, une couche de manette, des fichiers personnels ou une régression sont des branches courantes. Notez le symptôme et testez une branche à la fois.
Comment corriger un écran noir dans Citron ?
Vérifiez l'audio et l'entrée, notez le build et le renderer, revenez à la résolution native et aux valeurs par défaut, puis comparez un backend ou build vérifié.
Faut-il supprimer le cache shader ?
Sauvegardez le profil. Reconstruisez le cache seulement s'il correspond au build et si le symptôme indique une corruption. Tout supprimer efface des preuves.
Stable ou nightly pour corriger un plantage ?
Commencez par stable. Essayez un nightly avec une raison officielle et conservez le hash complet pour revenir en arrière.
Les keys ou le firmware peuvent-ils corriger un écran noir ?
Des fichiers personnels corrects peuvent résoudre un problème de configuration, mais ne garantissent pas la compatibilité et ne corrigent pas tous les défauts graphiques.
Citron Neo Wiki est-il le support officiel ?
Non. C'est un guide indépendant qui renvoie vers les releases et issues publiques de première partie et n'héberge pas l'émulateur, les jeux, keys ou firmware.
Preuves de première partie
Sources à vérifier avant de parler de régression
Comparez les identifiants de release, assets et issues actuels. Une source ne remplace pas un test local reproductible.
- Release stable officielle 2026-04-27Base stable et notes vérifiées pour ce guide.
- Releases officielles Citron CIPage par plateforme pour comparer le hash nightly.
- Issues officielles de l'émulateurComparez matériel, pilote, build, logs et reproduction.
- Guide de compatibilité CitronÀ utiliser quand l'émulateur démarre et que la question concerne le jeu.