Inicio Herramientas de Debug Event Reporting

Event Reporting

Contenido
  1. Descripción
  2. Cómo acceder
  3. Reportes disponibles
  4. Parámetros comunes
  5. Ejemplo de salida

Descripción

Event Reporting es un módulo de depuración añadido en la versión 1.2.0 de La Base de Sky. Permite buscar y reportar el uso de Game Switches, Game Variables, archivos de audio y comentarios a lo largo de todos los eventos de todos los mapas del proyecto.

Este módulo se encuentra en los scripts del juego bajo la carpeta 060_Debug/002_Event Reporting/ y añade sus funciones como entradas en el menú de debug.

Nota

Esta herramienta es especialmente útil para proyectos grandes donde es difícil recordar dónde se utilizan switches o variables específicos, o para auditar el uso de recursos de audio.

Cómo acceder

Para acceder a las funciones de Event Reporting:

  1. Asegúrate de tener el modo Debug activado
  2. Abre el menú de Debug (pulsando F9 o desde el menú de pausa)
  3. Navega hasta la sección Event Reporting
  4. Selecciona el tipo de reporte que deseas generar
  5. Introduce el ID o cadena de búsqueda según corresponda
  6. Elige el tipo de salida: Console o File

Reportes disponibles

El módulo EventReporting ofrece cuatro funciones de búsqueda que recorren todos los eventos de todos los mapas:

Método Parámetros Descripción
pbFindSwitchUsage search_id, output_type Busca en qué mapas y eventos se utiliza un Game Switch específico (por ID numérico)
pbFindVariableUsage search_id, output_type Busca en qué mapas y eventos se utiliza una Game Variable específica (por ID numérico)
pbFindAudioUsage output_type, audio_type, search_string Busca el uso de archivos de audio (BGM, BGS, ME, SE) que coincidan con la cadena de búsqueda
pbFindCommentUsage search_string, output_type Busca comentarios en eventos que contengan la cadena de texto especificada

Parámetros comunes

output_type

Define dónde se muestran los resultados del reporte:

Valor Comportamiento
:Console Los resultados se imprimen en la consola de debug del juego
:File Los resultados se exportan a un archivo de texto en la carpeta del proyecto

audio_type

Para pbFindAudioUsage, especifica qué tipo de audio buscar:

Valor Tipo de audio
:All Todos los tipos de audio
:BGM Música de fondo (Background Music)
:BGS Sonido ambiental (Background Sound)
:ME Efecto musical (Music Effect)
:SE Efecto de sonido (Sound Effect)

Ejemplo de salida

Al ejecutar un reporte, los resultados incluyen información detallada sobre cada coincidencia encontrada. Por ejemplo, al buscar el uso del Switch 25:

===== Switch 25 Usage Report =====
Map 005 [Pueblo Inicio] - Event 003 "NPC Guía" - Page 1
  > Conditional Branch: Switch [025] == ON

Map 012 [Ruta 3] - Event 007 "Bloqueo Roca" - Page 2
  > Control Switches: [025] = ON

Map 020 [Ciudad Celeste] - Event 015 "Puerta Gimnasio" - Page 1
  > Conditional Branch: Switch [025] == ON
===================================
Total: 3 occurrences found.

Cuando se elige :File como tipo de salida, esta misma información se guarda en un archivo de texto dentro de la carpeta raíz del proyecto, permitiendo consultarla posteriormente sin necesidad de volver a ejecutar la búsqueda.

Importante

En proyectos con muchos mapas, la búsqueda puede tardar algunos segundos. Se recomienda usar la salida a archivo para reportes extensos, ya que la consola puede truncar resultados muy largos.

Artículos relacionados