Ir al contenido

Visor de Registros

El Visor de Registros te permite revisar los registros de traceback de Ren’Py generados cuando un juego encuentra un error o cierre inesperado.

Cuando un juego Ren’Py se cierra inesperadamente o encuentra un error de Python durante el juego, el motor escribe un archivo traceback.txt en el directorio del juego. Cuando el juego se cierra, Spark automáticamente:

  1. Detecta el archivo traceback.txt
  2. Añade información del sistema de Spark (versión de iOS, versión de Spark, versión del motor, ajustes del juego y configuración del dispositivo)
  3. Renombra el archivo con una marca de tiempo (ej. traceback_20260311_143022.txt)
  4. Lo mueve a una carpeta logs/ dentro del directorio del juego

Cada cierre inesperado genera un archivo de registro separado, por lo que puedes revisar el historial de errores de un juego.

El Visor de Registros es accesible desde la pantalla de Detalle del Juego. Un botón verde Logs aparece cuando un juego tiene uno o más registros de traceback disponibles.

Si se detecta un traceback inmediatamente después de que un juego se cierra, Spark te alertará que hay un archivo de registro disponible para revisión con una opción para verlo de inmediato.

Los registros contienen tracebacks de Ren’Py — mensajes de error de Python y trazas de pila que describen qué salió mal durante la ejecución del juego. Cada registro también incluye información del sistema de Spark añadida al final:

  • Versión del motor Ren’Py utilizada
  • Versión de iOS y versión/número de compilación de Spark
  • Configuración completa de la app y ajustes del juego
  • Ajustes de traducción (si están activados)
  • Variantes del dispositivo sobreescritas (si están establecidas)

El navegador de registros muestra todos los archivos de traceback guardados para el juego seleccionado, ordenados del más reciente al más antiguo. Cada entrada muestra el nombre del archivo y la fecha de creación. Toca un registro para ver su contenido completo.

Al ver un registro, puedes compartirlo con el equipo de soporte:

  • Botón de compartir — Abre la hoja de compartir de iOS para exportar el traceback a través de cualquier app (correo, almacenamiento en la nube, mensajería, etc.)
  • Enviar por correo al Soporte — Envía el registro directamente al correo de soporte de Spark con el archivo de traceback adjunto

Puedes eliminar todos los registros de un juego desde el menú del navegador de registros. Esto elimina toda la carpeta logs/ de ese juego.

Al reportar problemas al equipo de soporte:

  1. Reproduce el problema iniciando el juego
  2. Después del cierre inesperado, abre el Visor de Registros desde la pantalla de Detalle del Juego
  3. Comparte el registro de traceback más reciente en Discord o por correo electrónico

El traceback y la información del sistema añadida proporcionan al equipo de soporte los detalles necesarios para diagnosticar el problema.

MensajeSignificado
SystemExitEl juego se cerró normalmente o vía Spark
ImportErrorMódulo de Python faltante — puede necesitar una versión diferente del motor
IOError / FileNotFoundErrorRecurso o archivo del juego faltante
MemoryErrorDispositivo con poca memoria — ver Jetsam
Errores de pickleIncompatibilidad de archivo de guardado — ver Problemas de Guardado