Instalación
El jar del cargador y la licencia, las dependencias, los archivos que genera el plugin, la base de datos y las actualizaciones.
Conseguir el plugin
ExyliaDuels es un plugin premium, comprado en BuiltByBit. Se distribuye con el cargador Lukittu, así que el archivo que instalas es
el jar del cargador, Exylia-Duels-Loader.jar. Comprado en BuiltByBit, la licencia va incrustada en ese jar: no hay clave que introducir. El cargador comprueba la licencia en cada arranque y
después le pasa el control al plugin.
Antes de empezar
ExyliaDuels funciona en Paper 1.21.1 o superior, o un fork, y en Folia 1.21.4 o superior, con Java 21.
| Plugin | Para qué |
|---|---|
packetevents | Obligatorio. Está en depend, así que sin él el servidor no carga ExyliaDuels. Congelar a los dos jugadores durante la cuenta atrás se hace con paquetes. |
ExyliaLib | Obligatorio, la última versión. Configuración, menús y preguntas, el depósito, la ventana de intercambio, las instantáneas, el pool de arenas, la economía, la base de datos y la red. |
| Una economía | Solo para apuestas de dinero: ExyliaEconomy, Vault con un plugin de economía, PlayerPoints, o cualquier moneda que sirva ExyliaLib. Sin ninguna, los duelos sin dinero funcionan igual. |
El plugin.yml del cargador pone ExyliaLib en softdepend a propósito: quien la instala es el cargador,
así que el cargador tiene que poder arrancar sin ella. En un servidor sin ExyliaLib descarga la última
versión en plugins/ y pide reiniciar. En un servidor con una versión anterior deja la nueva preparada y lo
avisa en consola; reinicia otra vez para aplicarla.
Plugins opcionales
| Plugin | Qué añade |
|---|---|
PlaceholderAPI | Los placeholders del plugin en otros plugins: scoreboards, tab, hologramas. Consulta Placeholders. |
FastAsyncWorldEdit | Si está instalado, se usa para guardar y pegar las schematics de las arenas. Sin él, el motor propio de ExyliaLib hace lo mismo con los mismos archivos .schem. |
ExyliaRandomKitsCore | Un kit aleatorio en el selector de kits de la pantalla de reto. Consulta Arenas y kits. |
AuraSkills, mcMMO | Nada que configurar: mientras un jugador está en un duelo, mirando uno o viendo una repetición, estos plugins no le dan experiencia, habilidades ni estadísticas de combate. |
ExyliaProxyUtils | En el proxy, para duelos entre servidores. Consulta Red. |
Instalar
Copia los jars
Exylia-Duels-Loader.jar y packetevents en plugins/, y una economía si quieres apuestas de dinero.
Arranca el servidor
El cargador comprueba la licencia incrustada en el jar y le pasa el control al plugin. El cargador instala ExyliaLib si falta; si ha tenido que hacerlo, reinicia otra vez.
Deja que genere
El plugin escribe config.yml, sus mensajes y menús, y crea sus tablas. La consola termina con
ExyliaDuels enabled.
Construye una arena y un kit
Los duelos necesitan al menos una arena lista. Abre /duelsadmin y sigue
Arenas y kits. Los jugadores ya pueden escribir /duel <player>:
exyliaduels.duel está activado para todos por defecto.
Archivos generados
Todos están en plugins/ExyliaDuels/.
| Archivo | Contenido |
|---|---|
loader.yml | Lo escribe el cargador: license_key, y version (auto mantiene el plugin en la última versión). |
config.yml | Solicitudes, tiempos del combate, modos, apuestas, espectadores, después del duelo, historial, repeticiones, red, los scoreboards del duelo y la lista de comandos permitidos. Consulta Configuración. |
database.yml | Dónde se guardan las filas, y Redis para una red. Lo escribe ExyliaLib. |
lang/<language>/messages.yml | Cada línea de chat, título, boss bar y etiqueta. |
lang/<language>/menus/user/ | Las pantallas de jugador: challenge, duel_inventory (la vista del inventario del final del duelo), history e history_entry. Son tuyas para cambiarles el estilo: una actualización solo añade lo que falta. |
lang/<language>/overlays/replay.yml | La barra que se muestra mientras se mira una repetición. Tuya para cambiarle el estilo, como las pantallas de jugador. |
lang/<language>/menus/admin/ | Las pantallas de administración: panel, arenas, arena, kits, kit, kit_external, kit_start, kit_attributes, kit_combat, kit_win, settings, own y own_win. Se regeneran desde el jar en cada arranque, así que no las edites. |
schematics/duels_<arena>.schem | La schematic de cada arena, desde la que se regenera y se copia. |
La base de datos
ExyliaDuels guarda siete tablas en la base de datos a la que apunta database.yml: H2 en un archivo por
defecto, o MySQL, MariaDB, PostgreSQL o MongoDB a través de ExyliaLib.
| Tabla | Filas |
|---|---|
exyliaduels_players | Victorias, derrotas, racha actual y mejor racha, dinero ganado de cada jugador, y si acepta retos. |
exyliaduels_arenas | Cada arena: nombre, icono, mundo, caja, los dos spawns, copias, si está activada, y el kit al que está ligada. |
exyliaduels_kits | Cada kit: nombre, icono, objetos, si está activado, sus flags de arena y sus reglas. |
exyliaduels_kit_profiles | Las flags de arena y las reglas de los kits que ofrecen otros plugins, y de los duelos con inventario propio. |
exyliaduels_history | Una fila por jugador de cada duelo terminado: rival, resultado, modo, arena, marcador, apuesta, duración, fecha, servidor y la repetición a la que apunta. |
exyliaduels_replays | Las grabaciones, una por duelo, compartida por las filas de historial de los dos jugadores. |
exyliaduels_post_duels | Los resúmenes del final de un duelo en red, para que los botones de inventario y revancha funcionen desde cualquier servidor hasta que se cierre su plazo. |
Las estadísticas son seguras en una base de datos que comparten varios servidores: cada cambio solo se escribe si la fila sigue como estaba al leerla, y si no se vuelve a intentar, así que una victoria en un servidor y un toggle en otro nunca se pisan. Las filas de los jugadores conectados se guardan en memoria.
Las apuestas las retiene el depósito de ExyliaLib, y el estado de cada jugador las instantáneas de ExyliaLib, en la misma base de datos. Lo que un crash deja retenido se devuelve en el siguiente arranque; lo que tenía un jugador antes de un duelo se le devuelve cuando vuelve a entrar.
Borrar datos
ExyliaDuels no tiene un comando de reinicio propio. Sus tablas están clasificadas para los comandos de
ExyliaLib: /exylialib wipe ExyliaDuels <table|*> vacía una tabla o todas, y
/exylialib resetplayer <player> ExyliaDuels borra las estadísticas y el historial de duelos de un jugador.
Las arenas, los kits y sus flags y reglas son configuración, no datos de jugadores. Consulta
los comandos de ExyliaLib.
Actualizar
Sustituye el jar del cargador y reinicia, o deja version: auto en loader.yml. Tu config.yml, los
mensajes y la pantalla de reto se conservan; las claves nuevas se añaden con su valor por defecto.
¿Falta algo en esta página? Dínoslo en Discord