Contenido generado con IA — puede contener errores.

ExyliaLib/Empezar

Instalación

Instalar la librería en un servidor y depender de ella desde un plugin.

Página 2 de 544 min de lectura

En el servidor#

El mínimo es Paper 1.21.1 (Folia 1.21.4, que no tiene build 1.21.1). En un servidor más antiguo la librería carga, pero escribe un error en recuadro al arrancar con la versión detectada, porque los plugins de Exylia fallan a mitad de partida ahí. Ver Versiones de servidor.

Coloca ExyliaLib.jar en plugins/, junto a PacketEvents. Los plugins que dependen de ella se niegan a cargar sin ella.

En el primer arranque el servidor descarga de Maven Central las librerías que declara ExyliaLib — el framework de comandos, Caffeine, HikariCP, los drivers de base de datos y el cliente de Redis — igual que cada plugin de Exylia declara las suyas, y las guarda en su carpeta libraries/. El servidor necesita acceso a internet en ese primer arranque; después, todos los plugins comparten esas copias.

PacketEvents va a su lado en todos los servidores. Las funciones por paquete de la librería — overlays, diálogos, displays por jugador, pantallas y el HUD — pasan por él. Desde 1.595.0 la librería lo declara en softdepend: sin él, o donde malinterpreta el servidor (como en híbridos NeoForge), esas funciones quedan apagadas y la consola lo dice, y un plugin cuyo producto son los paquetes lo declara como su propia dependencia obligatoria. Descárgalo de Modrinth.

La librería de sidebars por paquetes viaja dentro del jar, relocalizada, así que hay exactamente una copia en el servidor en vez de una por plugin.

Plugins opcionales#

Nada de esto es obligatorio. Cada uno desbloquea o mejora un módulo:

PluginQué habilita
PlaceholderAPIExponer los placeholders de este plugin a otros, y leer los suyos.
FastAsyncWorldEditUn motor más rápido para las esquemáticas. Sin él, la librería pega con su propio motor.
Vault o PlayerPointsEl módulo de economía.
Un plugin de clanesEl módulo de clanes. Se detectan ocho — ver Jugadores.
Lunar (Apollo), Feather o el mod de cliente de SurvivalCoreIntegración de cliente: waypoints, equipos, temporizadores en el HUD, cooldowns.
DeluxeCombat o PvPManagerLa respuesta del módulo de combate a "¿está peleando este jugador?".
WorldsCrear y borrar mundos, que en Folia es la única forma de hacerlo.

Un módulo cuyo plugin de apoyo no está hace nada en voz alta: Clans.isSupported() responde con honestidad en vez de lanzar una excepción, así que un plugin puede ocultar lo que no puede ofrecer.

Configurarla#

La librería escribe sus propios archivos en plugins/ExyliaLib/ en el primer arranque — idioma, actualizaciones, métricas, colores, formatos. Ver Los archivos de la librería.

Desde un plugin#

Declara la dependencia para que el servidor cargue la librería primero:

plugin.yml
yaml
name: MyPlugin
main: net.example.MyPlugin
api-version: '1.21'
depend:
  - ExyliaLib

Después toma las vistas de módulo que necesites en onEnable. Casi todos los módulos se alcanzan igual — un of(plugin) estático que devuelve una vista que pertenece a tu plugin:

MyPlugin.java
java
public final class MyPlugin extends JavaPlugin {
 
    private ConfigFile<Settings> settings;
 
    @Override
    public void onEnable() {
        TaskScheduler tasks = Tasks.of(this);
        PluginMenus menus   = Menus.of(this);
        PluginActions acts  = Actions.of(this);
 
        settings = Configs.define(this, "config", Settings.class).load();
    }
}
Por qué es por plugin

La vista es lo que hace funcionar la propiedad: tus acciones viven en tu namespace, tus menús se cierran cuando tu plugin se desactiva, tus placeholders se dan de baja con él, y los valores escritos en un item se archivan bajo tu nombre y no bajo el de la librería.

Limpieza#

No tienes que hacerla. La librería libera las tareas, menús, acciones, placeholders y entradas de un plugin cuando se desactiva — los menús se cierran antes de liberar las tareas, para que un botón cuyo handler viene de un classloader moribundo no pueda responder un último clic.

Los comandos de la propia librería#

/exylialib muestra el estado de la librería; sus subcomandos la recargan, la actualizan, revisan valores por defecto cambiados, abren el editor web y mueven datos. Ver Comandos.

Un plugin escucha /exylialib reload con Reloads.onLibraryReload(plugin, runnable) — el motivo habitual es que cambie la paleta, porque cada menú compilado se queda con los colores viejos.

¿Falta algo en esta página? Dínoslo en Discord