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.
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.
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#
| Tabla | Tipo | Clave | Guarda |
|---|---|---|---|
spawn_data | setup | id | La posición del spawn. Una fila |
sc_spawn_seen | progress | el UUID del jugador | Que 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 |
homes | progress | id = un UUID | Dueño (indexado), nombre, posición e icono |
sc_warps | setup | id | Nombre visible, activado, coste, permiso, icono, posición |
sc_warp_cooldowns | cache | <playerUuid>:<warpId> | Cuándo usó el jugador ese warp por última vez |
tpa_settings | account | playeruuid | Si acepta peticiones, auto-aceptar y confirmar |
rtp_cooldowns | cache | id | Jugador (indexado), mundo y cuándo se usó |
sc_back | cache | el UUID del jugador | Desde dónde salió por última vez, y cuándo |
survival_portals | setup | id | La región, el destino y la lista de comandos (solo con el módulo portals activo) |
sc_jumpads | setup | id | Servidor, 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#
| Tabla | Tipo | Clave | Guarda |
|---|---|---|---|
player_stats | progress | playeruuid | Nombre, bajas, muertes, mejor racha |
stat_cache | cache | <uuid>:<statId> | Un valor de estadística en caché por jugador, para las clasificaciones |
sc_stat_counters | progress | <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#
| Tabla | Tipo | Clave | Guarda |
|---|---|---|---|
rankup_data | progress | playeruuid | Rango actual, rangos completados, nivel de prestigio |
farming_data | progress | playeruuid | Conteos por categoría |
sc_farming_claims | progress | <playerUuid>:<category>:<milestone> | Un hito de agricultura de un jugador: reclamado o no, y cuándo |
reclaim_data | progress | playeruuid | Lo que se reclamó una sola vez |
sc_reclaim_claims | progress | <playerUuid>:<section> | Cuándo reclamó el jugador una sección por última vez (0 significa nunca, o reiniciada) |
player_join_data | progress | el UUID del jugador | Primera entrada, número de entrada, entradas totales |
sc_scheduled_runs | setup | <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#
| Tabla | Tipo | Clave | Guarda |
|---|---|---|---|
sc_missions | progress | <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_seasons | world | <track>:<period> | La temporada que una pista está contando ahora, y cuándo empezó |
sc_season_results | history | <seasonId>:<position> | La clasificación de una temporada cerrada: pista, periodo, posición, jugador, puntuación, cuándo se cerró |
sc_projects | world | el id del proyecto | Si el proyecto está abierto, completado o liquidado, y cuándo |
sc_project_progress | world | id compuesto (proyecto y material) | Cuánto ha recibido el proyecto de un material |
sc_project_contributions | world | id compuesto (proyecto y jugador) | Cuántos objetos dio un jugador a un proyecto (indexada para leer de mayor a menor) |
sc_project_payouts | world | id compuesto (proyecto y jugador) | Si un contribuyente de un proyecto completado ya cobró |
sc_reputation | progress | el UUID del jugador | Nombre, valoraciones positivas y negativas recibidas |
sc_reputation_pairs | cache | <rater>:<target> | Cuándo contó por última vez la valoración de un jugador a otro |
sc_reputation_tickets | cache | un id generado | Un trato que quien valora aún puede valorar: objetivo, dónde ocurrió (trade, market o auctions), cuándo |
Kits, boosters y herramientas#
| Tabla | Tipo | Clave | Guarda |
|---|---|---|---|
sc_kits | setup | id | El kit entero: objetos, comandos, cooldown, usos, icono, orden, banderas |
sc_kit_player_data | progress | <playerId>:<kitId> | Último reclamo y número de usos. Jugador indexado |
sc_boosters | world | id | Dueñ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_presets | setup | id | Un 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_spawners | setup | id | Servidor, posiciones, el rango de intervalo y la tabla de botín (solo sin ExyliaSpawners) |
sc_item_updates | setup | el nombre del grupo | El objeto que se sustituye y el objeto en que se convierte |
Comodidad#
| Tabla | Tipo | Clave | Guarda |
|---|---|---|---|
player_utils_data | account | playeruuid | Si el vuelo y la visión nocturna están activados |
sc_player_settings | account | playeruuid | Las 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#
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.
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