Base de datos
Las diecinueve tablas, qué las indexa, cómo las borra y reinicia ExyliaLib, varios servidores sobre una base de datos, y qué saber antes de tocarlas a mano.
Usa ExyliaClans en un servidor sin configurar nada, o apunta varios servidores a una misma base de datos para que compartan todos los clanes. El almacenamiento es de ExyliaLib: elige el motor y configura Redis como se explica en Base de datos, y el plugin crea y migra sus diecinueve tablas desde las definiciones de los records, así que no hay ningún esquema que aplicar. database.yml se escribe en el primer arranque y usa H2 por defecto.
A la mayoría de dueños solo les hace falta Varios servidores. El resto de la página es para quien consulta las tablas.
Las diecinueve tablas#
Las diecinueve tablas
Aquí la tabla de estadísticas por jugador es clan_player_stats; antes se llamaba player_stats y las filas se conservan.
| Tabla | Clave | Guarda |
|---|---|---|
clans | id (UUID en texto) | Nombre, nombre con estilo, líder, saldo, abierto, friendly fire, home, baneados, DTR, congelado, última regeneración, EXP, huecos de miembro extra |
clan_members | uuid | El clan del jugador y su rango |
clan_roles | id | Cada rango de cada clan: nombre, peso, permisos, si es el rango por defecto |
clan_relations | clanId:targetClanId | Una opinión direccional, ALLY o RIVAL |
clan_invites | playerUuid:clanId | Una invitación vigente y cuándo se envió |
clan_alliance_requests | requestingClanId:targetClanId | Una petición de alianza pendiente y cuándo se envió |
clan_claims | id | (según claims-scope) Un rectángulo: mundo, minX, minZ, maxX, maxZ, baseY |
clan_stats | clanId | Bajas, muertes, segundos jugados |
clan_player_stats | playerUuid:clanId | Lo mismo por jugador y clan, más el último nombre visto |
clan_logs | id | Acción, actor, objetivo, detalle, fecha |
clan_mails | id | Tipo, remitente, destinatario, asunto, cuerpo, enviado, caduca, lista de leídos, lista de borrados, fijado |
clan_webhooks | clanId | La URL del webhook, su nombre en Discord, los eventos apagados, si Discord lo borró |
lfc_profiles | playerUuid | Estado, publicado, última publicación, caduca, las respuestas |
lfp_postings | clanId | Estado, publicado, última publicación, caduca, descripción, las respuestas |
lfp_applications | playerUuid:clanId | Estado, solicitado, resuelto, mensaje |
clan_war_arenas | id | (según war-arenas-scope) Spawns, spawn de espectadores, esquinas y si está activa, de una arena de guerra |
clan_war_kits | id | Icono y objetos de un kit de guerra |
clan_war_records | clanId | Victorias, derrotas y empates en guerra |
clan_war_returns | playerId | De dónde vino un luchador de pérdida real, y su modo de juego |
Borrar y reiniciar#
No hay un comando propio para borrar los clanes o reiniciar a un jugador. Cada tabla declara qué guarda
para ExyliaLib, así que /exylialib wipe y /exylialib resetplayer cubren el
plugin:
| Tipo | Tablas |
|---|---|
| Mundo (los clanes y todo lo suyo) | clans, clan_members, clan_roles, clan_relations, clan_invites, clan_alliance_requests, clan_claims, clan_stats, clan_mails, clan_webhooks, lfc_profiles, lfp_postings, lfp_applications, clan_war_records |
| Progreso | clan_player_stats |
| Historial | clan_logs |
| Preparación (una temporada nueva la conserva) | clan_war_arenas, clan_war_kits |
| Caché | clan_war_returns |
/exylialib wipe ExyliaClans all todas las tablas
/exylialib wipe ExyliaClans clan_logs una tabla
/exylialib resetplayer Steve ExyliaClans las filas de un jugadorCada primera ejecución muestra lo que se iría y un código de seis dígitos; la misma línea con el código lo ejecuta.
Reiniciar a un jugador quita las filas que son suyas: su pertenencia (clan_members), sus estadísticas
(clan_player_stats), sus invitaciones, su perfil LFC, sus solicitudes LFP y su vuelta de guerra pendiente.
El servidor en marcha las suelta al momento, sin reiniciar. Si el jugador era líder de un clan, pasa a
serlo el miembro con el rango de más peso; si no queda nadie, el clan se disuelve.
Qué te dan las claves#
Qué te dan las claves
Varias reglas que habría que hacer cumplir a mano las impone la propia clave:
- Un jugador está en un clan.
clan_memberstiene por clave el UUID del jugador, así que no puede existir una segunda fila de pertenencia. - Un clan tiene un terreno y una oferta LFP. Las dos tienen por clave el id del clan.
- Un jugador tiene un perfil LFC, y una solicitud por clan.
- Una invitación es única por pareja, y una relación también.
Dos índices#
Índices
| Índice | Sobre | Para |
|---|---|---|
idx_cl_clan_ts | clan_logs (clanId, timestamp DESC) | El menú de logs: filtrar por clan, más nuevo primero, tomar una página |
idx_cm_clan_sent | clan_mails (clanId, sentAt DESC) | El buzón, igual |
Los dos convierten una página en una lectura acotada en vez de un escaneo.
Columnas que conviene conocer#
Columnas que conviene conocer
| Columna | Formato |
|---|---|
clans.bannedPlayers | UUIDs separados por comas |
clan_roles.permissions | Nombres de permiso separados por comas. Un nombre desconocido se salta al leer |
clans.homeLocation | Una localización serializada que lleva el servidor en el que se puso: servidor,mundo,x,y,z,yaw,pitch. null si no está puesta. Un home guardado con un server-id anterior se lee como de este servidor |
clans.styled_name | El nombre tal como lo dibuja /clan style, hasta 1024 caracteres. null si el clan no tiene estilo |
clans.balance | En la moneda que indica bank-currency; cambiar esa clave después no lo convierte |
clans.extraSlots | Huecos de miembro dados con /clanadmin setslots, sobre max-members y el bonus de nivel |
clans.dtrRegenAt | Cuándo regeneró el DTR por última vez, en milisegundos epoch — lo que evita que varios servidores lo regeneren cada uno |
clan_invites.sentAt / clan_alliance_requests.sentAt | Milisegundos epoch. 0 en una invitación escrita antes de 1.2.0, que cuenta como enviada en la actualización |
clan_webhooks.url | La URL completa del webhook, token incluido. Trata la tabla como un secreto; en el juego no se muestra nunca |
clan_webhooks.disabledEvents | Nombres de evento que el clan apagó, separados por comas: JOIN, LEAVE, KICK, BAN, INVITE, RANK, LEADER, RENAME, ALLIANCE, RIVALRY, BANK, DISBAND |
clan_mails.readByPlayers / deletedByPlayers | UUIDs separados por comas — así leído y borrado son por miembro desde una sola fila |
lfc_profiles.data / lfp_postings.data | Las respuestas serializadas |
*.status | ACTIVE / EXPIRED para ofertas y perfiles; PENDING / ACCEPTED / REJECTED para solicitudes |
Qué no está en la base de datos#
- Los canales de chat. Por sesión; tras un reinicio todo el mundo vuelve a global.
- Las rachas de bajas. Por sesión, y se reinician al morir.
- Los marcadores de camp, rally, focus y regroup. Todos en memoria. Un punto de regroup y una tregua de expulsión se comparten con los demás servidores de una red, nunca se guardan.
- Las esperas anti-spam. Las de crear, invitar, correo, aviso de rival y webhook viven en memoria, por servidor.
- El nivel del clan. Se deriva de
clans.expen cada lectura, nunca se guarda. - Qué miembros son dueños de un terreno. Se deriva de
clan_members; la fila del terreno solo nombra al clan.
Cachés#
Clanes, miembros, rangos, relaciones, terrenos, invitaciones, peticiones de alianza y webhooks se mantienen en memoria y se escriben al cambiar, así que el camino caliente no toca la base de datos. Dos cosas se cachean con TTL:
| Caché | TTL | Por qué |
|---|---|---|
| Cada ranking | 30 s | Un scoreboard pregunta cuatro veces por segundo |
| La lista de conectados por clan y por alianza | 1 s | Treinta huecos × varios espectadores × cuatro veces por segundo |
Las cachés se cargan al activar y las mantienen al día las escrituras del propio plugin — y, en una red,
las de los demás servidores. Una fila cambiada directamente en la base de datos no se detecta, y se
sobrescribirá la próxima vez que ese clan cambie. Usa /clanadmin donde cubra lo que necesitas, y para
los servidores donde no.
Varios servidores#
Los servidores que comparten una base de datos funcionan como un solo sistema de clanes en cuanto todos
activan Redis en database.yml (el bloque redis, con un server-id distinto en cada uno). No hay nada
más que configurar.
| Qué | Cómo |
|---|---|
| Todas las tablas: clanes, miembros, rangos, relaciones, invitaciones, peticiones de alianza, correo, estadísticas, terrenos, webhooks, LFC y LFP | Cada servidor tiene su copia y vuelve a leer una fila en cuanto otro servidor la escribe o la borra. Una entrada, una expulsión, un ascenso o una alianza hechos en un servidor se ven en todos en milisegundos. |
| Chat de clan, chat de aliados, cada aviso del clan, invitaciones, expulsiones, ascensos, avisos de correo | Se publican una vez y cada servidor los entrega a los miembros que tiene, así que una línea nunca llega dos veces ni solo donde pasó. |
/clan regroup | El punto nombra su servidor; a un compañero en otro servidor se le pasa a él. |
| Tregua de expulsión | Sigue al jugador expulsado al servidor al que se mueva. |
| Regeneración del DTR | Una vez por intervalo para toda la red, corran el temporizador los servidores que sean. |
Conectados (%exyliaclans_clan_online%, la lista de conectados, menús, el ranking) | Cuentan a los miembros de cualquier servidor. |
Lo que se queda en el servidor donde se hizo: los marcadores de camp y rally y el contorno del focus (se dibujan en el mapa de un servidor), las esperas anti-spam y el canal de chat que tenga puesto cada jugador. Un terreno solo se dibuja donde su mundo está cargado.
Sin Redis todo se comporta como en un solo servidor.
Arranque#
Los repositorios se leen de forma asíncrona, así que el plugin termina de activarse antes de que las tablas hayan respondido. Hasta entonces, cualquier consulta dice sin clan, que es la forma segura de equivocarse un momento. En cuanto las cachés son ciertas, a quien ya esté conectado se le repite la entrada, así que un jugador que se conectó en esa ventana no se queda invisible para su propio clan.
Si la lectura falla del todo, la consola lo dice y el plugin se queda quieto en vez de empezar a escribir contra cachés que sabe vacías.
¿Falta algo en esta página? Dínoslo en Discord