Contenido generado con IA — puede contener errores.

ExyliaSurvivalCore/ReferenciaActualizada en v1.2.2

Entiende la base de datos

Las treinta y ocho tablas, qué módulo posee cada una, qué guardan, cómo las lee el wipe de la librería y las rarezas de esquema que conviene saber.

Página 21 de 388 min de lectura

Cada módulo que guarda algo abre sus propias tablas, y un módulo apagado no crea ninguna. Todas pasan por una sola conexión, configurada en database.yml (el archivo es de ExyliaLib; el motor y el bloque de Redis se describen en la página de base de datos de la librería).

Las tablas se crean desde las definiciones de los records con CREATE TABLE IF NOT EXISTS, la primera vez que se abre cada repositorio. No hay ningún esquema que aplicar ni migración que ejecutar.

Cada tabla declara qué guarda (@Table(data = …)) y qué columna es el jugador, así que /exylialib wipe y /exylialib resetplayer las cubren sin ningún comando propio de este plugin. La columna Tipo es esa declaración (account, progress, history, world, setup o cache), que es lo que usa el wipe de la librería para decidir qué borrar.

Tablas de módulos que se fueron

Los suministros, power-ups, cofres de botín, zonas de regeneración, salas de duelo, recompensas por cabeza, cajas, tienda, mercado, baúles, tumbas, protecciones, recompensas, votos, minas, zonas AFK y la economía ya no los crea este plugin. Sus antiguas tablas sc_* y exylia_* siguen en la base de datos sin tocar; los plugins que los heredaron las leen, así que no las borres. Mira la documentación de cada plugin, como ExyliaEconomy, ExyliaMarket y ExyliaCrates.

Movimiento#

TablaTipoClaveGuarda
spawn_datasetupidLa posición del spawn. Una fila
sc_spawn_seenprogressel UUID del jugadorQue el jugador ya entró en algún servidor de la red, y cuántas veces. Es lo que responde "primera conexión", así que saltar a otro servidor no cuenta como jugador nuevo
homesprogressid = un UUIDDueño (indexado), nombre, posición e icono
sc_warpssetupidNombre visible, activado, coste, permiso, icono, posición
sc_warp_cooldownscache<playerUuid>:<warpId>Cuándo usó el jugador ese warp por última vez
tpa_settingsaccountplayeruuidSi acepta peticiones, auto-aceptar y confirmar
rtp_cooldownscacheidJugador (indexado), mundo y cuándo se usó
sc_backcacheel UUID del jugadorDesde dónde salió por última vez, y cuándo
survival_portalssetupidLa región, el destino y la lista de comandos (solo con el módulo portals activo)
sc_jumpadssetupidServidor, potencia, dirección, planeo y las posiciones de bloque (solo con jumpads activo)

/back y los cooldowns de warp son filas y no memoria porque un warp puede llevar al jugador a otro servidor, y el servidor al que llega tiene que conocer los dos. survival_portals es la única tabla con el prefijo survival_ en lugar de sc_.

Estadísticas#

TablaTipoClaveGuarda
player_statsprogressplayeruuidNombre, bajas, muertes, mejor racha
stat_cachecache<uuid>:<statId>Un valor de estadística en caché por jugador, para las clasificaciones
sc_stat_countersprogress<uuid>:<key>Todos los contadores que lleva un módulo: nombre del jugador, clave del contador, cantidad

player_stats lleva tres índices descendentes — en bajas, muertes y mejor racha — para que una clasificación sea una lectura acotada. sc_stat_counters es lo que leen una estadística COUNTER de stats.yml, una misión y una temporada, así que contar algo nuevo nunca necesita una tabla propia.

Progresión#

TablaTipoClaveGuarda
rankup_dataprogressplayeruuidRango actual, rangos completados, nivel de prestigio
farming_dataprogressplayeruuidConteos por categoría
sc_farming_claimsprogress<playerUuid>:<category>:<milestone>Un hito de agricultura de un jugador: reclamado o no, y cuándo
reclaim_dataprogressplayeruuidLo que se reclamó una sola vez
sc_reclaim_claimsprogress<playerUuid>:<section>Cuándo reclamó el jugador una sección por última vez (0 significa nunca, o reiniciada)
player_join_dataprogressel UUID del jugadorPrimera entrada, número de entrada, entradas totales
sc_scheduled_runssetup<server>:<section> o network:<section>Cuándo se ejecutó por última vez una sección de comandos programados

Los hitos de agricultura y las secciones de reclamo son una fila cada uno, y no una lista dentro de la fila del jugador, así que dos servidores que compiten por el mismo reclamo no pueden pagarlo dos veces: de las dos escrituras condicionales, solo una entra.

Misiones, temporadas, proyectos y reputación#

TablaTipoClaveGuarda
sc_missionsprogress<uuid>|<pool>|<period>|<missionId>Una misión repartida a un jugador: grupo, periodo, misión, el valor del contador del que partió, el objetivo, reclamada
sc_seasonsworld<track>:<period>La temporada que una pista está contando ahora, y cuándo empezó
sc_season_resultshistory<seasonId>:<position>La clasificación de una temporada cerrada: pista, periodo, posición, jugador, puntuación, cuándo se cerró
sc_projectsworldel id del proyectoSi el proyecto está abierto, completado o liquidado, y cuándo
sc_project_progressworldid compuesto (proyecto y material)Cuánto ha recibido el proyecto de un material
sc_project_contributionsworldid compuesto (proyecto y jugador)Cuántos objetos dio un jugador a un proyecto (indexada para leer de mayor a menor)
sc_project_payoutsworldid compuesto (proyecto y jugador)Si un contribuyente de un proyecto completado ya cobró
sc_reputationprogressel UUID del jugadorNombre, valoraciones positivas y negativas recibidas
sc_reputation_pairscache<rater>:<target>Cuándo contó por última vez la valoración de un jugador a otro
sc_reputation_ticketscacheun id generadoUn trato que quien valora aún puede valorar: objetivo, dónde ocurrió (trade, market o auctions), cuándo

Ver Reputación y proyectos.

Kits, boosters y herramientas#

TablaTipoClaveGuarda
sc_kitssetupidEl kit entero: objetos, comandos, cooldown, usos, icono, orden, banderas
sc_kit_player_dataprogress<playerId>:<kitId>Último reclamo y número de usos. Jugador indexado
sc_boostersworldidDueño (vacío para un booster global), tipo, origen, multiplicador, duración, cuándo caduca (0 mientras no ha empezado), quién lo concedió
sc_booster_presetssetupidUn booster listo para entregar: nombre, icono, tipo, origen, multiplicador, duración. Entregar uno lo copia, así que editar un preset nunca cambia un booster ya entregado
sc_item_spawnerssetupidServidor, posiciones, el rango de intervalo y la tabla de botín (solo sin ExyliaSpawners)
sc_item_updatessetupel nombre del grupoEl objeto que se sustituye y el objeto en que se convierte

Comodidad#

TablaTipoClaveGuarda
player_utils_dataaccountplayeruuidSi el vuelo y la visión nocturna están activados
sc_player_settingsaccountplayeruuidLas preferencias que el jugador ha desactivado

Módulos que no guardan nada#

death, enchantments, near, optimization y repair. Las rachas de bajas se cuentan en memoria y se pierden en un reinicio.

Cosas que conviene saber antes de tocar una tabla a mano#

Una posición guardada puede nombrar otro servidor

Hogares, warps, portales y jumppads guardan servidor,mundo,x,y,z,yaw,pitch, donde - significa "este servidor". Eso es lo que hace que /home y /warp funcionen en una red. Una fila que nombra un servidor que no es este no tiene ninguna posición local, y por eso la API ofrece un método de teletransporte y no coordenadas. Los lugares guardados bajo un id de servidor anterior se leen como de este servidor.

Algunas filas se reclaman borrándolas o moviéndolas

Una temporada se cierra, un ticket de reputación se valora, una ejecución programada se toma y un proyecto se completa o se paga por el servidor que consiga borrar o mover la fila primero — solo una escritura tiene éxito, y eso es lo que hace que cada una de esas cosas pase una sola vez en toda la red. Editar una de esas filas a mano no es limpiar: no paga nada, no cierra nada, o ejecuta la acción dos veces.

Las tablas más antiguas del plugin llevan además created_at y updated_at; las más nuevas solo llevan las columnas de arriba. Nada tiene una restricción de unicidad más allá de su clave primaria.

Compartir entre servidores#

Apunta todos los servidores a la misma base de datos y se comparten hogares, warps, kits, rangos, estadísticas, boosters, proyectos y el resto. Las tablas sin columna de servidor son de toda la red por diseño; las que sí la llevan (hogares, warps, jumppads, portales) también se comparten, pero cada fila recuerda dónde se fijó.

¿Falta algo en esta página? Dínoslo en Discord