Empezar

Instalación

El jar del cargador y la licencia, las dependencias, los archivos que genera el plugin, la base de datos, el paso desde ExyliaSpecials y las actualizaciones.

Conseguir el plugin

ExyliaCombat 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-Combat-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

Plugin	Para qué
`ExyliaLib`	Obligatorio. Configuración, menús y preguntas, la base de datos, los cooldowns, la barra de acción, las recompensas, la economía, las regiones y la fachada `Combat`.
`packetevents`	Opcional, recomendado. Dibuja la barrera PvP con paneles translúcidos (sin él, el muro se hace con bloques falsos), y lo necesita el módulo `combat-nametag`.

ExyliaLib figura como opcional, y se instala sola

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.

Cualquier otro plugin con el que habla ExyliaCombat es opcional y solo se usa si está instalado: WorldGuard y los plugins de claims para las zonas seguras, DeluxeCombat, CelestCombat o PvPManager como proveedor del combate, PlaceholderAPI y las APIs de los clientes Lunar y Feather. Consulta Integraciones.

Instalar

Copia los jars

Exylia-Combat-Loader.jar en plugins/, y packetevents si el servidor aún no lo tiene.

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 tuvo que hacerlo, reinicia otra vez.

Deja que genere

El plugin escribe config.yml, un modules/<module>/config.yml por módulo, sus mensajes y menús, y crea sus tablas. La consola indica qué proveedor de combate ha elegido y termina con ExyliaCombat enabled.

Elige los módulos

Activa o desactiva módulos en config.yml, bajo modules, y reinicia: los interruptores se leen al arrancar. Consulta Configuración.

Archivos generados

Todos están en plugins/ExyliaCombat/.

Archivo	Contenido
`loader.yml`	Lo escribe el cargador: `license_key` y `version` (`auto` mantiene el plugin en la última versión).
`config.yml`	Idioma, interruptores de módulos, nombres de comandos, el intervalo de guardado del registro del jugador, el combate y la desconexión, y las fuentes de zonas seguras. Consulta Configuración.
`modules/<module>/config.yml`	La configuración de un módulo, documentada en la página de ese módulo. `action-bar` no tiene.
`database.yml`	Dónde se guardan las filas, y la conexión a Redis. Lo escribe ExyliaLib.
`lang/<language>/messages.yml`	El combate, `/combat`, la barra de acción, las líneas de administración, los rechazos antiguos de las restricciones, el nombre del NPC de desconexión y el anuncio de desconexión en combate.
`lang/<language>/modules/<module>/messages.yml`	Los textos de un módulo.
`lang/<language>/modules/stats/menu.yml`, `leaderboard.yml`	La pantalla de `/pvpstats` y la de clasificaciones. Puedes rediseñarlas: una actualización solo añade lo que falta.
`lang/<language>/admin/`	El panel de administración: `players`, `player` y `cooldowns`. Se regeneran desde el jar en cada arranque, así que lo que edites ahí se pierde.

La base de datos

Dos tablas, en la base de datos a la que apunte database.yml: H2 en un archivo por defecto, o MySQL, MariaDB, PostgreSQL o MongoDB a través de ExyliaLib.

Tabla	Qué guarda
`exyliacombat_players`	Una fila por jugador: el interruptor de PvP, la protección de novato restante, kills, muertes, racha, mejor racha, desconexiones en combate, puntos y KDR. Se carga al conectar, se guarda al salir y cada `player-data.save-interval`. Solo se usa mientras `pvp-toggle`, `newbie-protection` o `stats` está activo.
`exyliacombat_loggers`	Los jugadores que se desconectaron en combate y aún no han vuelto: su equipo, su vida, su posición y si su NPC murió. Se lee al arrancar, así que un reinicio a mitad nunca hace perder el inventario de nadie.

Las dos tablas son progreso de jugador con el jugador como dueño, así que /exylialib resetplayer y /exylialib wipe de ExyliaLib las cubren; un reinicio también quita el NPC de desconexión que el jugador tenga en pie. Consulta los comandos de ExyliaLib.

Si la base de datos no se puede leer cuando un jugador entra, su registro se guarda solo en memoria durante esa sesión, y la consola lo avisa.

Desde ExyliaSpecials

ExyliaCombat heredó el combat tag de ExyliaSpecials 4.0. En su primer arranque (sin config.yml todavía, y con una carpeta ExyliaSpecials al lado) importa combat, actionbar.enabled, vanilla-cooldowns y language de ExyliaSpecials, las líneas de combate y de barra de acción de cada lang/<code>/messages.yml, y database.yml. Un Specials que ya se actualizó guarda su copia en plugins/ExyliaSpecials/exyliacombat-export.yml, que se lee primero. El permiso antiguo exyliaspecials.combat.bypass sigue saltándose las restricciones.

Actualizar

Sustituye el jar del cargador y reinicia, o deja version: auto en loader.yml. Tus archivos se conservan; las claves nuevas se añaden con su valor por defecto. Las claves que cambiaron de sitio entre versiones se trasladan con sus valores:

Desde la 1.0, actionbar.enabled pasa a modules.action-bar, y vanilla-cooldowns se mueve a modules/vanilla-cooldowns/config.yml (clave cooldowns). Las claves anti-boost de las estadísticas pasan a modules/kill-abuse/config.yml.
Desde la versión 3 de la configuración, combat.logout-npc pasa a modules/logout-npc/config.yml, combat.barrier a modules/pvp-barrier/config.yml (sus enabled se convierten en modules.logout-npc y modules.pvp-barrier), y combat.allowed-commands, blocked-inventories, blocked-teleport-causes, disable-flight, disable-elytra y las notifications de rechazo pasan a modules/combat-restrictions/config.yml.
Desde la 1.1, las líneas de racha y de fin de racha de kill-rewards suenan con notas cortas en lugar del rugido del dragón y la muerte del wither, y los sonidos de subir de nivel de la recompensa por cabeza y del granted de novatos son más suaves. Solo cambia una línea que aún tenga la etiqueta de sonido antigua.

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