Guía de solución de problemas de Citron
¿Citron Emulator se cierra o muestra pantalla negra? Empieza aquí
Sigue una lista basada en síntomas para cierres, pantallas negras, errores de inicio, gráficos dañados, controles que no responden y regresiones después de una actualización.
Respuesta corta: identifica la capa que falla antes de cambiar opciones
Que Citron Emulator se cierre no significa automáticamente que el juego sea incompatible. El origen puede ser un paquete incompleto, una versión incorrecta, el controlador gráfico, la configuración, la caché, una capa de entrada, los archivos de sistema propios o una regresión del build exacto.
Si aparece una pantalla negra, comprueba si todavía hay audio, menús o respuesta del mando. Una ventana negra silenciosa requiere una comprobación distinta de un juego que sigue funcionando con errores de renderizado.
Mantén separados los resultados de stable y nightly. La versión estable comprobada para esta guía es 2026-04-27 y el canal CI comprobado usa el commit 22d5038ec. Son referencias de comparación, no una garantía para todos los juegos o dispositivos.
Cambia una sola variable, repite la misma prueba y conserva la configuración anterior. Así podrás confirmar una solución y describir el problema en un issue oficial si hace falta.
Elige la rama correcta
Solución de Citron Emulator: comprueba la capa relacionada con el síntoma
Empieza por la comprobación menos invasiva. Cambiar gráficos, caché, entrada y firmware a la vez elimina pistas útiles.
| Capa | Primera comprobación | Por qué importa |
|---|---|---|
| Inicio o paquete | Usa el archivo correcto para tu sistema, termina la extracción y confirma que el sistema puede leerlo y ejecutarlo. | Una arquitectura incorrecta, una librería ausente o un archivo bloqueado puede parecer un cierre del emulador. |
| Build o canal | Anota el tag stable o el hash CI/nightly antes de probar; no mezcles resultados de builds diferentes. | Una corrección o regresión pertenece a una versión concreta. |
| Renderizado o driver | Vuelve al backend predeterminado, anota GPU y driver y prueba un backend alternativo solo si el fallo se repite. | Las pantallas negras y texturas rotas pueden depender del backend o del driver. |
| Archivos y controles | Comprueba tus archivos legales, la ruta del juego, permisos y detección del mando sin descargar paquetes. | Archivos desajustados, rutas ilegibles o capas duplicadas de entrada producen diagnósticos engañosos. |
| Configuración y caché | Haz una copia del perfil, prueba una configuración limpia y reconstruye la caché solo después de guardar el estado original. | Una caché antigua puede ser la causa, pero borrarla sin copia elimina evidencias. |
Flujo reproducible
Prueba de cinco minutos para un cierre de Citron
Esta secuencia separa un problema general de inicio de uno específico del renderizador, la entrada, el contenido o el build.
Reproduce una vez
Escribe el síntoma exacto: cierre antes de la ventana, cierre tras el logo, pantalla negra con audio, congelación o mando ausente.
Registra la base
Guarda tag o hash, sistema, GPU o chipset, driver, renderer, actualización del juego y canal stable o nightly.
Vuelve a valores predeterminados
Copia el perfil, desactiva overlays y ajustes experimentales y repite la misma prueba.
Cambia una variable
Prueba un renderer, resolución, caché, capa de mando o perfil. No actualices el emulador y el juego a la vez.
Compara o revierte
Si el fallo apareció tras actualizar, compara la misma prueba con un build estable verificado o con la copia guardada.
Conserva evidencias seguras
Qué registrar cuando Citron no funciona
Una nota breve suele bastar. Guarda el log original, la copia de configuración y el identificador del build juntos para repetir la prueba después de reiniciar o volver atrás.
No publiques rutas personales, tokens, dumps privados ni archivos de sistema protegidos. En un issue, comparte solo el fragmento mínimo y seguro permitido por el proyecto.
Un nombre de carpeta como el siguiente ayuda a separar pruebas sin indicar que el sitio distribuya contenido de Citron.
- Tag o commit exacto y fecha de prueba.
- Sistema, dispositivo, GPU o chipset, driver, renderer y modo de energía.
- Versión del juego, DLC/mods, última pantalla correcta y número de repeticiones.
- Una copia de configuración y el único cambio realizado antes de repetir.
Citron-troubleshooting/test-01/Es solo un ejemplo de organización. No descargues logs, paquetes de keys, firmware, ROM o instaladores reempaquetados desde una página de solución.
Cambios conservadores
¿Qué opción de Citron conviene cambiar primero?
Haz el cambio más pequeño que compruebe tu hipótesis y restaura el valor anterior si el resultado empeora.
| Área | Empezar con | Cambiar solo cuando |
|---|---|---|
| Backend gráfico | Backend predeterminado | La pantalla negra se repite y el log apunta al renderer. |
| Resolución | Nativa o 1x | La base es estable y estás midiendo rendimiento. |
| Shader/caché | Dejar que el build actual la cree | La caché pertenece a otro build o está dañada. |
| Perfil | Copiar y probar un perfil limpio | El perfil limpio cambia el síntoma y puedes reaplicar ajustes. |
| Mando | Una sola capa de mapeo | Steam Input, un remapper o un perfil duplica la entrada. |
| Stable/nightly | Stable como base | Un fix oficial justifica probar un nightly con rollback. |
Relaciona el siguiente test con el síntoma
Ramas comunes de cierre y pantalla negra en Citron
Son ramas de diagnóstico, no garantías. Mantén el build y el entorno junto a cada resultado.
Citron se cierra antes de mostrar la ventana
Comprueba el archivo de plataforma, extracción, arquitectura, bloqueo del sistema, dependencias y un perfil limpio.
Siguiente: Usa la página oficial, extrae en una ruta local simple y repite sin overlays.
Citron muestra una pantalla negra
Distingue una ventana congelada de un juego con audio o entrada. Renderer, driver, caché, archivos y regresiones pueden parecer iguales.
Siguiente: Registra la última pantalla correcta, restaura gráficos predeterminados y compara un backend o build verificado.
Hay audio pero no vídeo
El proceso puede seguir activo mientras falla la ruta gráfica. Anota GPU, driver, backend, resolución y respuesta de menús.
Siguiente: Prueba resolución nativa y un renderer alternativo; no declares incompatibilidad por una sola escena.
El mando no aparece o duplica entradas
Comprueba primero la detección del sistema. Steam Input, mandos virtuales y perfiles pueden solaparse.
Siguiente: Desactiva la capa duplicada, reconecta el mando y prueba un perfil directo.
La configuración dejó de funcionar tras actualizar
Pueden haber cambiado el build, el juego, el driver, la caché o el perfil. Un nightly puede corregir un error y crear otro.
Siguiente: Compara la misma prueba con el build guardado o con la base stable 2026-04-27.
Aparece un error de caché o log
El mensaje es una pista, no una orden para borrar toda la caché. Conserva el perfil y comprueba que la caché pertenece al mismo build.
Siguiente: Haz una copia, reconstruye solo la caché afectada y repite el inicio.
Preguntas de diagnóstico
Preguntas frecuentes sobre los cierres de Citron
¿Por qué Citron Emulator se cierra continuamente?
Puede ser el build, el driver o renderer, el perfil o caché, una capa de mando, la configuración de archivos propios o una regresión. Registra el síntoma y prueba una rama cada vez.
¿Cómo arreglo la pantalla negra de Citron?
Comprueba si hay audio o entrada, registra build y renderer, vuelve a resolución nativa y valores predeterminados y compara un backend o build verificado. Una pantalla negra no demuestra por sí sola incompatibilidad.
¿Debo borrar la caché de shaders?
Haz una copia primero. Reconstruye la caché solo si pertenece al mismo build y el síntoma apunta a corrupción. Borrarlo todo elimina evidencias.
¿Stable o nightly para corregir un cierre?
Empieza con stable. Prueba nightly solo con una razón oficial y guarda el hash completo para poder volver atrás.
¿Keys o firmware pueden arreglar una pantalla negra?
Los archivos correctos propios pueden resolver errores de configuración, pero no garantizan compatibilidad ni arreglan todos los fallos gráficos. No descargues paquetes agrupados.
¿Es Citron Neo Wiki el soporte oficial?
No. Es una guía independiente que enlaza a releases e issues públicos de primera parte y no aloja el emulador, juegos, keys ni firmware.
Evidencia de primera parte
Fuentes que conviene revisar antes de llamar regresión a un cierre
Compara identificadores de release, assets y issues actuales. Ninguna fuente sustituye una prueba local reproducible.
- Release estable oficial 2026-04-27Base estable y notas de release revisadas para esta guía.
- Releases oficiales de Citron CIPágina por plataforma para comparar el hash nightly.
- Issues oficiales del emuladorCompara hardware, driver, build, logs y pasos de reproducción.
- Guía de compatibilidad de CitronÚsala cuando el emulador inicia y la pregunta es específica del juego.