Introducción
Qué es ExyliaLib, los módulos que trae, y las reglas sobre las que está construida.
ExyliaLib es la librería compartida de la que depende cada plugin de Exylia. Se instala una vez en el servidor y nunca se empaqueta dentro de un plugin: una copia, una clase, una caché.
No es un cajón de utilidades. Son decenas de módulos con una regla que los guía — el servidor debe trabajar lo menos posible. Donde algo puede ser un paquete en vez de estado real del servidor, la librería manda el paquete: sidebars, hologramas, nametags y boss bars no crean ningún equipo de scoreboard ni ningún armor stand.
| Java | 21 |
| API | Paper 1.21.4 |
| Corre en | Paper y Purpur 1.21.1 o superior, Folia 1.21.4 o superior, desde una sola build. Ver Versiones de servidor |
| Versión documentada aquí | 1.476.2 |
Qué le da a un plugin#
Un archivo YAML declarado como record de Java, generado a partir de él, y migrado cuando cambia de forma.
Menús en YAMLListas paginadas, plantillas, condiciones, valores en vivo y clics atados a acciones — sin código de menús.
Un solo schedulerLa misma llamada corre en Spigot y en los hilos por región de Folia.
Records en base de datosH2, MySQL, MariaDB, PostgreSQL o MongoDB detrás de un repositorio, sin bloquear nunca.
Todo lo de pantallaSidebars, hologramas, nametags y waypoints de cliente, todo por paquetes.
Jugadores, una vezUn único registro de reservas para que dos minijuegos no puedan tener al mismo jugador.
Editado desde el navegadorLos ajustes, mensajes y menús de cada plugin, editados en la web y aplicados en el juego.
La lista completa, con para qué sirve cada módulo, está en Índice de módulos.
Tres reglas que conviene conocer antes de seguir#
Leer una vez, dibujar por jugador#
Un item, un menú y un sidebar son definiciones compiladas al cargar el archivo, y dibujadas por
jugador después. Interpretar es la mitad cara y ocurre una vez; dibujar es barato y ocurre
constantemente. Esa separación es la razón de que Item no sea un ItemStack y UiDefinition no sea
una ventana abierta.
Un valor es texto salvo que digas lo contrario#
Cualquier cosa que se sustituya en un mensaje, un item o una fila de menú se inserta como texto
literal por defecto. Un jugador llamado {error}X muestra esos caracteres en vez de repintar la
línea. withFormatted es la otra puerta, para valores que escribió el dueño del servidor — un rango
escrito {highlight}&lMVP.
La pregunta nunca es de qué tipo es el valor. Es de quién es el valor.
Una parte rota se reporta, no es fatal#
Un encantamiento mal escrito se convierte en un botón muerto y una línea en consola; los otros cincuenta botones siguen funcionando. Un archivo que no describe un menú en absoluto sí lanza, porque adivinar escondería el error.
Empaquetarla pondría una copia de la librería de scoreboards, la caché de cabezas y el registro de placeholders dentro de cada plugin. Con una sola copia instalada hay una caché que calentar, un registro donde mirar, y un placeholder registrado por un plugin es visible para el siguiente.
Qué depende de ella#
Todos los plugins de Exylia: ExyliaFFA, ExyliaCapture, ExyliaEvents, ExyliaPracticeCore y el resto. La
declaran en softdepend solo para que el loader que la instala cargue antes; ninguno funciona sin
ella.
Instala PacketEvents junto a la librería: las funciones por paquete (pantallas, HUD, overlays, displays por jugador) lo necesitan. La librería lo declara como dependencia blanda, así que sin él esas funciones quedan apagadas y la consola lo dice.
Algunos módulos se apoyan en plugins opcionales y lo dicen cuando faltan, en vez de fallar en silencio — PlaceholderAPI para exponer placeholders fuera del servidor, Vault o PlayerPoints para la economía, un plugin de clanes para los clanes.
Para el dueño del servidor#
La librería es también lo que el dueño del servidor configura una sola vez para todos los plugins de Exylia:
el idioma de toda la red, la paleta de colores, las
actualizaciones que mantienen al día cada plugin de Exylia, la revisión de
valores por defecto cambiados tras
una actualización, el editor web y el registro del staff. Todo está bajo
/exylialib.
¿Falta algo en esta página? Dínoslo en Discord