Introducción

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 cuarenta y seis 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.

Qué le da a un plugin

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.

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.

Todos los plugins de Exylia necesitan además PacketEvents, y la librería también: lo declara en depend, así que el servidor se niega a cargarla sin él. Instala los dos.

Algunos módulos se apoyan en plugins opcionales y lo dicen cuando faltan, en vez de fallar en silencio — FastAsyncWorldEdit para las esquemáticas, PlaceholderAPI para exponer placeholders fuera del servidor, Vault o PlayerPoints para la economía.