Corev2.0

xLib Shared

Librería base que centraliza dependencias compartidas y utilidades para todos los plugins del ecosistema aifusp.dev.


¿Qué es xLib?

xLib es la columna vertebral de todos los plugins desarrollados por aifusp.dev. Su objetivo principal es centralizar dependencias (ACF, InventoryFramework, NBTAPI, Adventure, HikariCP) en un único jar, evitando conflictos de ClassLoader y reduciendo el consumo de RAM del servidor.

Atención

Todos los plugins del ecosistema requieren xLib instalado. Debe cargarse antes que el resto de plugins (la 'x' inicial garantiza orden alfabético).

Instalación

  • Descarga xLib.jar desde el panel de tu servidor.
  • Colócalo en la carpeta /plugins/ de tu servidor Spigot/Paper.
  • Reinicia el servidor — xLib no requiere configuración adicional.

Información

Compatible con Paper 1.20+ y Spigot 1.20+. Requiere Java 17 o superior.

Características

TextUtils

Soporte completo para MiniMessage, Legacy codes y gradientes RGB en un único método.

java
// MiniMessage
player.sendMessage(TextUtils.parse("<gradient:gold:yellow>¡Bienvenido!</gradient>"));

// Legacy directo
player.sendMessage(TextUtils.parseToLegacy("&aVerde &b→ &cRojo"));

Gestor de Base de Datos

Pool de conexiones HikariCP listo para SQLite y MySQL. Los plugins solo necesitan extender el manager sin configurar drivers.

java
public class MyDatabaseManager extends XLibDatabaseManager {
    public MyDatabaseManager(JavaPlugin plugin) {
        super(plugin); // Lee config.yml automáticamente
    }
}

Para Desarrolladores

Añade xLib como dependencia de compilación usando compileOnly (no la incluyas en tu shadowJar).

groovy
// build.gradle
dependencies {
    compileOnly 'org.aifusp.dev:xLib:2.0'
}

Consejo

Declara xLib en tu plugin.yml como 'depend: [xLib]' para que Bukkit garantice el orden de carga.