Data Visualizator

Del juego a la decisiónFrom the game to the decision

El sistema tiene tres piezas: el cliente de Unity (donde se juega y donde se analiza), un servidor PHP intermedio y la base de datos MySQL. Los datos hacen un viaje de ida y vuelta.The system has three pieces: the Unity client (where the game is played and analysed), an intermediate PHP server and the MySQL database. The data makes a round trip.

En móvil, desliza el esquema o tócalo para verlo a tamaño completo.On mobile, scroll the diagram or tap it to see it full size.

1. 1

   GenerarGenerate

   Unity · Gameplay

   Mientras se juega, el juego registra solo los eventos que se decidió medir (posición, combate, objetos) con una frecuencia de muestreo definida, sin tocar el código central de la jugabilidad.While playing, the game records only the events that were chosen to be measured (position, combat, items) at a defined sampling rate, without touching the core gameplay code.

2. 2

   Exportar y limpiarExport and clean

   Unity → PHP

   Los datos viajan a un servidor PHP que hace de intermediario: recibe la sesión, la procesa y la limpia antes de guardarla. El editor nunca habla directamente con la base de datos.The data travels to a PHP server that acts as a middleman: it receives the session, processes it and cleans it before storing it. The editor never talks to the database directly.

3. 3

   Guardar de forma ordenadaStore in an organised way

   PHP ⇄ MySQL

   PHP traduce cada sesión a consultas SQL y la guarda en una base de datos normalizada. La estructura de esa base de datos es lo que hace posible analizar después.PHP turns each session into SQL queries and stores it in a normalised database. The structure of that database is what makes later analysis possible.

4. 4

   Importar y visualizarImport and visualise

   MySQL → PHP → Unity

   Desde el editor se pide una sesión: PHP consulta la base de datos, prepara y da formato al resultado, y Unity lo dibuja como mapa de calor, marcadores o registro de eventos.From the editor you request a session: PHP queries the database, prepares and formats the result, and Unity draws it as a heatmap, markers or an event log.

La base de datos: donde está el valorThe database: where the value is

Los mapas de calor son la parte visible, pero lo que hace posible el análisis es cómo están organizados y relacionados los datos. El esquema separa tres tipos de información.Heatmaps are the visible part, but what makes analysis possible is how the data is organised and related. The schema separates three kinds of information.

Cómo se relacionanHow they relate

Todo cuelga de la sesión. Un jugador tiene muchas sesiones; una sesión tiene muchos eventos de posición, de combate y de objetos; y cada evento apunta a un enemigo o a un objeto del catálogo.Everything hangs off the session. A player has many sessions; a session has many position, combat and item events; and each event points to an enemy or an item in the catalogue.

• players1 → Ngame_sessions
• game_sessions1 → Nplayer_position
• game_sessions1 → Ncombat_events
• game_sessions1 → Nitem_events
• enemies1 → Ncombat_events
• items1 → Nitem_events

Tres formas de cortar los datosThree ways to slice the data

Preguntas que permite responderQuestions it can answer

• ¿Por dónde se mueve el jugador y dónde se queda más tiempo?Where does the player move and where do they linger? player_position
• ¿En qué zonas muere o derrota enemigos?In which areas do they die or defeat enemies? combat_events
• ¿Qué clases de enemigo causan más problemas?Which enemy classes cause the most trouble? combat_eventsenemies
• ¿Qué objetos se recogen, se usan o curan, y dónde?Which items are picked up, used or heal, and where? item_eventsitems
• ¿Cómo evoluciona la salud y el estado durante la partida?How do health and state evolve during the play? player_position
• ¿Qué cambia entre jugadores, niveles o momentos de la sesión?What changes between players, levels or moments of the session? game_sessionsplayers

Detrás de cada pregunta hay una consulta SQL con uniones (joins) y agregaciones. Este ejemplo ilustra el tipo de consulta que el esquema permite:Behind each question there is a SQL query with joins and aggregations. This example illustrates the kind of query the schema allows:

-- Ejemplo ilustrativo / Illustrative example
-- ¿Qué clase de enemigo derrota más al jugador en cada nivel?
SELECT gs.level_name,
       e.enemy_class,
       COUNT(*) AS deaths
FROM combat_events ce
JOIN game_sessions gs ON gs.session_id = ce.session_id
JOIN enemies e        ON e.enemy_id    = ce.enemy_id
WHERE ce.event_type = 'player_death'
GROUP BY gs.level_name, e.enemy_class
ORDER BY deaths DESC;

Las herramientas del editorThe editor tools

Los datos importados se exploran desde una ventana propia en el editor, con cuatro pestañas: Tools, Markers, Heatmap y Events.Imported data is explored from a dedicated editor window with four tabs: Tools, Markers, Heatmap and Events.

Mi contribuciónMy contribution

• Definí qué eventos merecía la pena registrar y con qué frecuencia muestrearlos, e instrumenté el juego sin alterar el código central de la jugabilidad.I defined which events were worth tracking and how often to sample them, and instrumented the game without altering the core gameplay code.
• Construí el pipeline: exportación de las sesiones a una base de datos MySQL normalizada mediante scripts PHP, y reimportación a Unity para analizarlas.I built the pipeline: exporting sessions to a normalised MySQL database through PHP scripts, and re-importing them into Unity for analysis.
• Construí la capa de análisis: mapas de calor configurables, marcadores y etiquetas, filtros por tipo de evento y ventana de tiempo, y un registro de eventos de la sesión.I built the analysis layer: configurable heatmaps, markers and labels, filters by event type and time window, and a session event log.

El proyecto cubre el ciclo completo de medir un juego: decidir qué medir, guardarlo de forma consistente y presentarlo para que un equipo pueda actuar sobre ello.The project covers the full cycle of measuring a game: deciding what to measure, storing it consistently and presenting it so a team can act on it.