Contenido generado con IA — puede contener errores.

ExyliaPracticeCore/ReferenciaActualizada en v1.4.0

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.

Página 26 de 356 min de lectura

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#

TablaGuardaTipoPor jugador
practice_arenasUna arena: spawns, regiones, radios de protección, regiones extra y los tipos de partida que aceptaSETUP—
practice_kitsUn kit: loadout, categorías, arenas compatibles, banderas de jugabilidad, reglas en JSONSETUP—
practice_kit_categoriesUna categoríaSETUP—
practice_player_kitsUn hueco de loadout guardado de un jugador para un kitPROGRESSsí
practice_player_season_statsLos contadores de un jugador para un kit en una temporadaPROGRESSsí
practice_player_lifetime_statsLo mismo, de todas las temporadasPROGRESSsí
practice_player_statsLa tabla anterior a las temporadas. La lee la migración una vez y no se escribe más.PROGRESSsí
practice_match_historyEl lado de un jugador en una partida terminada, con sus inventarios durante replay.inventory-retention-daysHISTORYsí
practice_game_logUna fila por partida jugada: kit, arena, modo, número de jugadores, si se cancelóHISTORY—
practice_seasonsUna temporada: número, nombre, inicio, fin, si está activaHISTORY—
practice_settingsUna sola fila: spawn de lobby, spawn del editor de kits, boost global, temporada actualSETUP—
practice_player_settingsLos /settings de un jugadorACCOUNTsí
practice_elo_boostsEl boost de LP activo de un jugadorPROGRESSsí
practice_pvp_regionsUna zona PvPSETUP—
practice_portal_regionsUn portalSETUP—
practice_jumpadsUn jump pad y todas sus posicionesSETUP—
practice_match_replaysUna partida grabada, que se reproduce con /replay. Ver HistorialHISTORY—
practice_web_outboxCargas esperando a llegar a la web APICACHE—

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:

ComandoQué 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:

TemporadaHistórico
Lo reinicia una rotaciónEn la práctica: la nueva temporada empieza vacíaNunca
Lo leen las clasificacionesSíNo
Lo leen sidebars y placeholdersSí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.

Por qué winRate y kdr son columnas

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#

TablaIndexada por
practice_player_season_statsseason, playerUuid, playerName, más seasonKit con cada columna de ranking (elo, kills, deaths, kdr, wins, losses, winRate, bestStreak, currentStreak, damageDealt, timePlayed)
practice_player_lifetime_statsplayerUuid, playerName, kitId
practice_match_historymatchId, season, playedAt, más playerUuid + playedAt e inventoryDay + playedAt
practice_game_logkitId, arenaId, endedAt, cancelled
practice_player_kitsplayerUuid, kitId
practice_web_outboxkind, createdAt, nextAttemptAt
practice_seasonsactive

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#

ComandoQué 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.

Reinicia después de importar

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