Instalación

Antes de empezar

El servidor necesita Paper 1.21 o superior y Java 21. Dos plugins tienen que estar en plugins/ junto al jar; otros dos son opcionales y cada uno aporta algo concreto.

# Soft on purpose: a hard depend stops this plugin from loading when
# ExyliaLib is absent, and the loader that would install ExyliaLib is
# exactly what has to load for the install to happen.
softdepend: [ExyliaLib, PlaceholderAPI, LuckPerms]

Qué aporta cada plugin opcional

PlaceholderAPI. ExyliaLib registra cada placeholder bajo %exyliachatcosmetics_<nombre>% y los lleva a PAPI automáticamente. Dentro del texto propio de ExyliaLib funcionan igual; PAPI es lo que hace que se resuelvan en el formato de chat, el scoreboard o el tab de otro plugin. Si el módulo de chat integrado es el que entrega los mensajes, nada necesita ese rodeo y PAPI no aporta nada.

LuckPerms. Un color de rango repinta el prefijo y el sufijo que ya escribe tu plugin de permisos, y los lee de los datos en caché de LuckPerms. Sin LuckPerms, {prefix} y {suffix} no dibujan nada y toda la pantalla de colores de rango queda vacía. LuckPerms también aporta los grupos que nombra la lista groups de cada entrada, y su UserDataRecalculateEvent limpia los permisos memorizados y la caché de render, así que un rango que caducó se lleva sus cosméticos sin reconectar. La propiedad por permiso sigue funcionando por Bukkit sin él — la memoria simplemente se refresca al entrar, al recargar y en el barrido de 30 segundos.

Instalación

Qué escribe el primer arranque

Todo vive bajo plugins/ExyliaChatCosmetics/. Cada archivo se copia una vez y nunca se sobrescribe, así que tus ediciones sobreviven a una actualización.

cosmetics/

El catálogo. Estos no son archivos con esquema, y es a propósito: un catálogo se cura a mano y un escritor de esquemas no conserva ninguno de sus comentarios, así que lo que viene es un archivo comentado que puedes leer de arriba abajo.

menus/

Seis archivos de menú de ExyliaLib, compilados al cargar y recompilados por /cca reload.

El árbol chat/

Nada de esto se escribe en el primer arranque. El módulo de chat construye sus archivos la primera vez que arranca, que es la primera carga o recarga después de poner chat.module.enabled: true.

Base de datos

Por defecto el plugin usa H2: un archivo dentro de la carpeta del plugin, sin servidor, sin instalación y sin mantenimiento. Las tablas se crean al primer uso y se ensanchan solas cuando una columna necesita más sitio.

Hay una sexta tabla, chatcosmetics_chat_players, que pertenece al módulo de chat y solo se crea cuando ese módulo funciona. Lleva el canal del jugador, su lista de ignorados y su estado de moderación.

Para compartir los cosméticos entre varios servidores, apúntalos al mismo motor:

database:
  type: mysql
  settings:
    max-pool-size: 0
  mysql:
    host: 127.0.0.1
    port: 3306
    database: minecraft
    username: root
    password: ""

Motores soportados: h2, mysql, mariadb, postgresql y mongodb. Solo se lee el bloque que coincide con type, y un valor que no se reconoce cae a h2 y lo dice. El archivo es de ExyliaLib; su referencia completa está en la página de base de datos de la librería.

Un perfil se lee una sola vez al entrar — la fila, las concesiones, lo que el jugador ha creado y sus loadouts — y se mantiene en memoria mientras está conectado. Los clics en el menú marcan la fila como sucia y un volcado corre cada cinco segundos, al salir y al apagar. Dibujar una línea de chat nunca toca la base de datos.

Folia

El plugin.yml declara folia-supported: true, y todo lo que depende de un hilo pasa por los Tasks de ExyliaLib: las escrituras de perfil y el disparo de eventos caen en la región del propio jugador, el reloj de las animaciones y el barrido de caducidades son asíncronos, y dibujar una línea o responder un placeholder solo lee memoria. No hay nada más que configurar.

Actualizar

Reemplaza el jar y reinicia. Tus archivos de catálogo, tus menús y tus archivos de chat se quedan intactos, y todo lo que posee un jugador vive en la base de datos.

config.yml y messages.yml se generan desde records, así que se tratan distinto de los archivos que solo se copian: una clave que añada una versión nueva aparece con su valor por defecto y su comentario, y una clave que ya no declara ningún record se elimina al cargar y se reporta una vez como UNKNOWN_KEY. Eso es de ida y no de vuelta — un error tipográfico en el nombre de una clave se borra en vez de avisarte para siempre, así que lee la consola después de una actualización si has estado editando a mano.

Recargar

/cca reload

Permiso exyliachatcosmetics.admin. Corre cinco pasos en orden, y un paso que falla se reporta mientras el resto siguen corriendo:

/exylialib reload es otra cosa: recarga la paleta, y este plugin tira su caché de render como respuesta, así que recolorear el servidor recolorea etiquetas y nombres sin tocar nada de aquí.

A dónde ir después