Contenido generado con IA — puede contener errores.

ExyliaClans/ReferenciaActualizada en v1.4.0

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.

Página 21 de 299 min de lectura

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.

TablaClaveGuarda
clansid (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_membersuuidEl clan del jugador y su rango
clan_rolesidCada rango de cada clan: nombre, peso, permisos, si es el rango por defecto
clan_relationsclanId:targetClanIdUna opinión direccional, ALLY o RIVAL
clan_invitesplayerUuid:clanIdUna invitación vigente y cuándo se envió
clan_alliance_requestsrequestingClanId:targetClanIdUna petición de alianza pendiente y cuándo se envió
clan_claimsid(según claims-scope) Un rectángulo: mundo, minX, minZ, maxX, maxZ, baseY
clan_statsclanIdBajas, muertes, segundos jugados
clan_player_statsplayerUuid:clanIdLo mismo por jugador y clan, más el último nombre visto
clan_logsidAcción, actor, objetivo, detalle, fecha
clan_mailsidTipo, remitente, destinatario, asunto, cuerpo, enviado, caduca, lista de leídos, lista de borrados, fijado
clan_webhooksclanIdLa URL del webhook, su nombre en Discord, los eventos apagados, si Discord lo borró
lfc_profilesplayerUuidEstado, publicado, última publicación, caduca, las respuestas
lfp_postingsclanIdEstado, publicado, última publicación, caduca, descripción, las respuestas
lfp_applicationsplayerUuid:clanIdEstado, solicitado, resuelto, mensaje
clan_war_arenasid(según war-arenas-scope) Spawns, spawn de espectadores, esquinas y si está activa, de una arena de guerra
clan_war_kitsidIcono y objetos de un kit de guerra
clan_war_recordsclanIdVictorias, derrotas y empates en guerra
clan_war_returnsplayerIdDe 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:

TipoTablas
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
Progresoclan_player_stats
Historialclan_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 jugador

Cada 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_members tiene 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
ÍndiceSobrePara
idx_cl_clan_tsclan_logs (clanId, timestamp DESC)El menú de logs: filtrar por clan, más nuevo primero, tomar una página
idx_cm_clan_sentclan_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
ColumnaFormato
clans.bannedPlayersUUIDs separados por comas
clan_roles.permissionsNombres de permiso separados por comas. Un nombre desconocido se salta al leer
clans.homeLocationUna 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_nameEl nombre tal como lo dibuja /clan style, hasta 1024 caracteres. null si el clan no tiene estilo
clans.balanceEn la moneda que indica bank-currency; cambiar esa clave después no lo convierte
clans.extraSlotsHuecos de miembro dados con /clanadmin setslots, sobre max-members y el bonus de nivel
clans.dtrRegenAtCuá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.sentAtMilisegundos epoch. 0 en una invitación escrita antes de 1.2.0, que cuenta como enviada en la actualización
clan_webhooks.urlLa URL completa del webhook, token incluido. Trata la tabla como un secreto; en el juego no se muestra nunca
clan_webhooks.disabledEventsNombres de evento que el clan apagó, separados por comas: JOIN, LEAVE, KICK, BAN, INVITE, RANK, LEADER, RENAME, ALLIANCE, RIVALRY, BANK, DISBAND
clan_mails.readByPlayers / deletedByPlayersUUIDs separados por comas — así leído y borrado son por miembro desde una sola fila
lfc_profiles.data / lfp_postings.dataLas respuestas serializadas
*.statusACTIVE / 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.exp en 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éTTLPor qué
Cada ranking30 sUn scoreboard pregunta cuatro veces por segundo
La lista de conectados por clan y por alianza1 sTreinta huecos × varios espectadores × cuatro veces por segundo
Editar filas a mano requiere reiniciar

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 LFPCada 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 correoSe 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 regroupEl punto nombra su servidor; a un compañero en otro servidor se le pasa a él.
Tregua de expulsiónSigue al jugador expulsado al servidor al que se mueva.
Regeneración del DTRUna 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