Base de datos
Las dieciocho tablas, qué guarda cada una, cómo se relacionan los dos niveles de estadísticas y cómo exportar, importar y borrar datos.
El plugin guarda todo a través del módulo de base de datos de ExyliaLib, así que qué motor hay detrás (MySQL, SQLite, H2, MongoDB) se configura una vez en ExyliaLib y no aquí: mira base de datos. Las tablas se crean y migran solas.
Las dieciocho tablas#
| Tabla | Guarda | Tipo | Por jugador |
|---|---|---|---|
practice_arenas | Una arena: spawns, regiones, radios de protección, regiones extra y los tipos de partida que acepta | SETUP | — |
practice_kits | Un kit: loadout, categorías, arenas compatibles, banderas de jugabilidad, reglas en JSON | SETUP | — |
practice_kit_categories | Una categoría | SETUP | — |
practice_player_kits | Un hueco de loadout guardado de un jugador para un kit | PROGRESS | sí |
practice_player_season_stats | Los contadores de un jugador para un kit en una temporada | PROGRESS | sí |
practice_player_lifetime_stats | Lo mismo, de todas las temporadas | PROGRESS | sí |
practice_player_stats | La tabla anterior a las temporadas. La lee la migración una vez y no se escribe más. | PROGRESS | sí |
practice_match_history | El lado de un jugador en una partida terminada, con sus inventarios durante replay.inventory-retention-days | HISTORY | sí |
practice_game_log | Una fila por partida jugada: kit, arena, modo, número de jugadores, si se canceló | HISTORY | — |
practice_seasons | Una temporada: número, nombre, inicio, fin, si está activa | HISTORY | — |
practice_settings | Una sola fila: spawn de lobby, spawn del editor de kits, boost global, temporada actual | SETUP | — |
practice_player_settings | Los /settings de un jugador | ACCOUNT | sí |
practice_elo_boosts | El boost de LP activo de un jugador | PROGRESS | sí |
practice_pvp_regions | Una zona PvP | SETUP | — |
practice_portal_regions | Un portal | SETUP | — |
practice_jumpads | Un jump pad y todas sus posiciones | SETUP | — |
practice_match_replays | Una partida grabada, que se reproduce con /replay. Ver Historial | HISTORY | — |
practice_web_outbox | Cargas esperando a llegar a la web API | CACHE | — |
Borrar datos y reiniciar a un jugador#
El plugin no tiene comando propio para borrar ni reiniciar. Cada tabla de arriba dice qué guarda (la
columna Tipo), así que las pantallas y comandos /exylialib wipe de ExyliaLib la cubren:
| Comando | Qué hace aquí |
|---|---|
/exylialib wipe ExyliaPracticeCore <table|@kind|all> [code] | Vacía una tabla, un tipo, o todas las tablas del plugin |
/exylialib resetplayer <jugador> [ExyliaPracticeCore|all] [@kind ...] [code] | Borra las filas de un jugador en las tablas marcadas Por jugador. Por defecto son las PROGRESS: loadouts guardados, estadísticas de temporada e históricas, boosts de ELO. Añade @history para su historial de partidas y @account para sus /settings. |
Cada uno se ejecuta dos veces: la primera solo lista lo que se iría y da un código, y antes de borrar nada se exporta una copia de seguridad. Tras reiniciar a un jugador, el plugin también suelta de memoria su boost de ELO y sus entradas de clasificación en caché. Ver los comandos de ExyliaLib.
Los dos niveles de estadísticas#
practice_player_season_stats y practice_player_lifetime_stats tienen las mismas columnas. La
diferencia es qué se reinicia:
| Temporada | Histórico | |
|---|---|---|
| Lo reinicia una rotación | En la práctica: la nueva temporada empieza vacía | Nunca |
| Lo leen las clasificaciones | Sí | No |
| Lo leen sidebars y placeholders | Sí | No |
| Clave | <temporada>:<kit> desnormalizado en seasonKit | <jugador>:<kit> |
Los dos se escriben en el mismo commit al terminar una partida, así que nunca pueden discrepar.
El ladder global se guarda en ambos bajo el id de kit global, que es lo que permite que una sola
consulta responda tanto una clasificación por kit como una general.
Se guardan en vez de calcularse al leer para que la base de datos pueda ordenar una clasificación por
ellos contra un índice. Editar wins a mano con /epc stats set los recalcula.
Índices que importan#
| Tabla | Indexada por |
|---|---|
practice_player_season_stats | season, playerUuid, playerName, más seasonKit con cada columna de ranking (elo, kills, deaths, kdr, wins, losses, winRate, bestStreak, currentStreak, damageDealt, timePlayed) |
practice_player_lifetime_stats | playerUuid, playerName, kitId |
practice_match_history | matchId, season, playedAt, más playerUuid + playedAt e inventoryDay + playedAt |
practice_game_log | kitId, arenaId, endedAt, cancelled |
practice_player_kits | playerUuid, kitId |
practice_web_outbox | kind, createdAt, nextAttemptAt |
practice_seasons | active |
Las clasificaciones ordenan y limitan dentro de la base de datos contra el índice de temporada; el historial de partidas hace lo mismo contra el índice de fecha de juego. Nada carga una tabla entera en memoria.
Migrar desde ExyliaCommons#
Existen dos migraciones distintas:
Automática, en el primer arranque. Si practice_player_stats tiene filas, cada una se atribuye a
la temporada 1 y se copia a los niveles de temporada e histórico. Corre en segundo plano sin bloquear
el arranque, es reanudable si el servidor muere a mitad y solo lee la tabla antigua, así que puede
repetirse sin riesgo.
Manual, sobre un volcado. /epc migrate <archivo> [--skip-stats] convierte un volcado exportado de
una base de datos v2 de ExyliaCommons al esquema de este plugin. Deja el volcado en plugins/ExyliaPracticeCore/database/exports/: el comando escribe al lado un migrated_<archivo>.json convertido, lo importa, recarga arenas y kits y vuelve a guardar el schematic de cada arena. --skip-stats convierte arenas, kits
y ajustes sin tocar las estadísticas de jugador.
Exportar e importar#
| Comando | Qué hace |
|---|---|
/epc export [archivo] | Escribe un volcado. Sin nombre, un archivo con marca de tiempo en la carpeta de volcados. |
/epc import <archivo> | Vuelve a cargar uno |
Los dos pasan por el módulo de transferencia de ExyliaLib, así que un volcado hecho en SQLite puede importarse en MySQL.
Una importación carga filas directamente en las tablas en vivo y no invalida nada de lo que el servidor ya tenga en memoria: arenas, kits, categorías, estadísticas cargadas. Haz primero una exportación, importa sin nadie conectado y reinicia el servidor antes de dejar entrar a nadie. Si no, las copias viejas en memoria se reescriben encima de las filas importadas.
¿Falta algo en esta página? Dínoslo en Discord