Preguntas frecuentes
Lo que más surge al construir sobre la librería.
Un plugin no carga y dice que falta ExyliaLib#
Los plugins de Exylia declaran ExyliaLib en softdepend, así que arrancan aunque falte: descargan
ExyliaLib.jar en plugins/ y piden un reinicio. Reinicia una vez y cargan los dos. Si la descarga no
puede hacerse (sin acceso a internet), pon tú ExyliaLib.jar en plugins/. No hay respaldo empaquetado
a propósito: una sola copia instalada es todo el diseño.
ExyliaLib en sí no carga#
Instala PacketEvents a su lado. La librería lo declara en softdepend, así que ExyliaLib carga igualmente sin él,
pero las funciones por paquete (pantallas, HUD, overlays, displays por jugador) quedan apagadas y la consola lo dice. En el primer arranque además descarga
sus librerías de Maven Central; un servidor sin acceso a internet falla ahí.
¿Cómo cambio el idioma?#
language en plugins/ExyliaLib/config.yml: en, es, pt, fr, ru o tr. Todo plugin cuyo
language propio sea default lo sigue. Ver Idiomas.
Se descargó una actualización pero no cambió nada#
Las actualizaciones se preparan en plugins/update/ y se aplican en el siguiente reinicio, nunca en una
recarga: todos los plugins están atados a la copia de la librería en marcha. /exylialib muestra si la
auto-actualización está activa, y /exylialib plugins lista lo que está esperando.
¿Cómo evito que la librería envíe métricas?#
metrics.enabled: false en plugins/ExyliaLib/config.yml, y reinicia. Después no se envía nada. Ver
qué se informa.
Mi placeholder se ve en pantalla en vez de resolver#
Tres causas habituales:
- Nada registró ese nombre —
Placeholders.unresolved(texto)lista lo que no respondió. - El nombre está bien pero el prefijo no: el nombre registrado es el prefijo del grupo, un guion bajo y el nombre de la entrada.
- Lo estás leyendo por PlaceholderAPI, donde el nombre del plugin va delante como identificador.
Un valor muestra {highlight} como texto en vez de colorear#
Usaste with(), que es deliberado: inserta el valor como texto literal. withFormatted() es para
valores que escribió el dueño del servidor. Equivocarse al revés deja que un jugador llamado
<rainbow> recoloree tu mensaje.
Un placeholder de color en el nombre de un item no hace nada#
name: "%name_color%&l%kit_name%" no puede funcionar. La sustitución ocurre sobre el árbol de
componentes ya parseado — un color a secas parsea a un componente vacío con un color, y ese color no
alcanza al texto de al lado. Pasa la frase coloreada entera, o usa una plantilla con nombre por estado.
El menú no abre en absoluto#
Casi siempre un size que no concuerda con el type. Un barril son siempre veintisiete slots diga lo
que diga size, y crear un inventario cuyo tamaño no concuerda con su tipo lanza antes de dibujar
nada.
Un botón no hace nada#
Mira la consola de cuando se cargó el archivo: una acción que no existe compila a un botón muerto y una
línea reportada, y el resto del menú sigue funcionando. Mira también la condition del slot — un slot
cuya condición falla no está ahí en absoluto.
Mis ediciones de config se borraron tras actualizar#
Una actualización nunca reescribe un valor que cambiaste: un defecto nuevo para una clave que nunca tocaste
espera en /exylialib updates hasta
que lo apliques o lo conserves.
Lo que sí puede irse es una clave que ningún record declara ya: se elimina al cargar y se reporta como
UNKNOWN_KEY. Si una sección cambió de forma entre versiones, hacía falta una migración —
Migration.rename o Configs.moveTo mueven un valor en vez de dejar que el valor por defecto lo reemplace.
/exylialib updates lista cambios que nunca hice#
Son valores por defecto que cambiaron los autores del plugin, en claves que siguen en su defecto antiguo. Aplícalos si quieres el valor nuevo, consérvalos si prefieres el viejo; en ambos casos no vuelven a listarse.
Todo revienta en Folia#
Casi siempre una tarea en el hilo equivocado. Todo lo que va sobre un jugador pertenece a runAtEntity;
run es para el servidor entero. Es invisible en Paper y fatal en Folia.
Una llamada a la base de datos vuelve pero mi código corre en el hilo equivocado#
Los futures se completan en un hilo del pool. Vuelve por tasks.runAtEntity(player, …) antes de tocar
al jugador o al mundo.
Dos plugins se pelean por el mismo jugador#
Deberían estar usando Sessions. isFree
pregunta, claim decide de forma atómica, y el callback de liberación es cómo se le dice al dueño
actual que suelte.
La API de clanes no responde nada#
Clans.isSupported() es false cuando no se detectó ningún plugin de clanes. La detección es por
reflexión, así que un plugin instalado cuya API no se pueda alcanzar se salta con un aviso en consola —
esa línea nombra también cuál se eligió.
Un módulo no hace nada#
Los módulos que se apoyan en otro plugin tienen un isSupported() y, donde tiene sentido, un
unsupportedReason(): los clanes necesitan un plugin de clanes, los waypoints de cliente Lunar o Feather,
el combate DeluxeCombat o PvPManager. No hacen nada en vez de lanzar, y merece la pena comprobarlo en vez de
darlo por supuesto. Las esquemáticas funcionan sin FastAsyncWorldEdit, con el motor propio de la librería.
La base de datos embebida dice que está dañada o en solo lectura#
El archivo H2 embebido se comprueba al arrancar, se repara desde su último estado bueno o desde una copia
cuando está dañado, y se copia automáticamente en backups/ a su lado. Una base de datos que pasa a solo
lectura con el servidor en marcha — normalmente un disco lleno o una carpeta en la que el servidor no puede
escribir — imprime una línea y necesita un reinicio. Ver Base de datos.
¿Dónde pido soporte?#
En el Discord de Exylia.
¿Falta algo en esta página? Dínoslo en Discord