Instalación
El jar del cargador y la licencia, las dependencias, cómo se instala ExyliaLib, los archivos que genera el plugin, la base de datos y las actualizaciones.
Conseguir el plugin#
ExyliaMines es un plugin premium, a la venta en BuiltByBit.
Se distribuye con el cargador Lukittu, así que el archivo que instalas es el jar del cargador,
Exylia-Mines-Loader.jar. Comprado en BuiltByBit, la licencia va incluida en ese jar: no hay
ninguna clave que introducir. El cargador comprueba la licencia en cada arranque y después cede el control
al plugin.
Antes de empezar#
| Plugin | Para qué |
|---|---|
packetevents | Opcional (dependencia blanda). Sin él el plugin funciona y solo se quedan apagados los extras dibujados con paquetes, como los hologramas. |
ExyliaLib | Obligatorio, versión 1.567.0 o superior. Configuración, menús, base de datos, regiones, hologramas, botín, efectos, horarios, teletransportes y actualizaciones. |
Opcionales, cada uno añade algo cuando está presente:
| Plugin | Qué añade |
|---|---|
ExyliaSurvivalCore | Sus límites de encantamientos y sus objetos bloqueados se aplican dentro de las minas. Ver Integraciones. |
ExyliaMarket | Su autoventa se lleva los drops de cada mina. Ver Integraciones. |
PlaceholderAPI | Los placeholders del plugin en otros plugins: scoreboards, tab, plugins de hologramas. |
Vault | Dinero en las tablas de botín y en los premios de suerte, a través de la economía de ExyliaLib. |
Worlds o Multiverse-Core | Nada que configurar: una mina en un mundo que uno de ellos carga tarde se prepara en cuanto el mundo carga. |
plugin.yml 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 un reinicio. En un servidor con una versión anterior a la 1.567.0 deja la última
preparada en la carpeta de actualizaciones y lo avisa en la consola; reinicia una vez más para aplicarla.
Sin acceso a la red omite la instalación y lo vuelve a intentar en el siguiente arranque — coloca
ExyliaLib.jar en plugins/ a mano.
Instalar#
Coloca los jars
Copia Exylia-Mines-Loader.jar y packetevents en plugins/. Añade también ExyliaLib.jar si lo
tienes; si no, el cargador lo descarga.
Arranca el servidor
El cargador comprueba la licencia y cede el control a ExyliaMines, que escribe sus archivos y crea sus
tablas. Deberías ver ExyliaMines enabled y, cuando las minas se leen de la base de datos,
Loaded 0 mine(s).
Reinicia si te lo pidió
Sin ExyliaLib, o con una anterior a la 1.567.0, el cargador instala la librería, avisa de que hace falta un reinicio y se detiene ahí. Reinicia una vez y arrancan los dos plugins.
Abre el editor
Con exyliamines.admin, ejecuta /minesadmin. Ver Primeros pasos.
Archivos generados#
Todos viven en plugins/ExyliaMines/.
| Archivo | Contenido |
|---|---|
config.yml | Idioma, debug, tiempos de reinicio por defecto, intervalos de comprobación, sonidos, alcance de los anuncios y reglas de Fortune. Ver Configuración. |
templates.yml | Los puntos de partida que ofrece Crear desde plantilla. |
boosts.yml | Los potenciadores temporales y el horario que los lanza. |
lang/<idioma>/messages.yml | Cada línea que envía el plugin, los títulos y boss bars, las líneas de los hologramas. |
lang/<idioma>/menus/user/mines.yml | El menú /mines de los jugadores. |
lang/<idioma>/screens/mines.yml y screens/mines.html | La lista /mines de los jugadores como pantalla nativa. |
lang/<idioma>/menus/admin/ | Los veinte menús de staff. |
database.yml | El motor de base de datos, escrito por ExyliaLib. H2 por defecto, embebido, nada que instalar. |
<idioma> es el idioma en que habla el plugin: language en config.yml, que en una instalación nueva es
default — seguir el idioma de ExyliaLib. Se incluyen inglés, español, portugués, francés, ruso y turco (en, es, pt, fr, ru, tr);
cualquier otro código empieza en inglés para que lo traduzcas.
Las pantallas de staff se refrescan desde el jar cada vez que arranca el plugin, para que un botón añadido
en una release llegue a todos los servidores. Lo que edites ahí se pierde; nada de lo que un dueño deba
cambiar vive en esa carpeta. El menus/user/mines.yml de los jugadores es tuyo: una release solo añade lo
que le falte, y un valor por defecto que cambió espera en /exylialib updates para que lo apliques o lo
ignores.
Un archivo de menú que no se puede leer se nombra en consola y esa pantalla no se registra; el resto del plugin sigue funcionando.
Las minas, sus ciclos, los bloques rotos, las estadísticas y los potenciadores en curso viven en la base de datos, no en YAML. Eso es lo que permite que varios servidores compartan una base de datos: cada mina pertenece al servidor donde se creó, y cada servidor carga solo las suyas.
Base de datos#
Por defecto el plugin usa H2: un archivo dentro de la carpeta del plugin, sin servidor, sin instalación y sin mantenimiento. Es perfectamente válido para un solo servidor.
Para compartir datos entre servidores, edita database.yml:
database:
type: mysql
settings:
pool-size: 0
mysql:
host: 127.0.0.1
port: 3306
database: minecraft
username: root
password: ""Motores soportados: h2, mysql, mariadb, postgresql y mongodb. Solo se lee el bloque que coincide
con type. El archivo es de ExyliaLib; su referencia completa está en la
página de base de datos de la librería.
El plugin crea cinco tablas:
| Tabla | Una fila por |
|---|---|
mines | mina: su servidor, tipo, área, composición o niveles, ajustes de reinicio, teletransportes, holograma, botín, efectos y ajustes de Fortune |
mines_state | mina clásica: bloques picados desde su último relleno y cuándo toca el siguiente |
mines_broken_blocks | bloque de una mina realista esperando a volver a crecer |
mines_stats | jugador y mina: bloques picados allí |
mines_boosts | potenciador en curso en un servidor |
Cada tabla está clasificada para /exylialib wipe y /exylialib resetplayer de ExyliaLib, que son la forma de
borrar sus datos; el plugin no tiene un comando de borrado propio. Ver Comandos.
Nada espera a la base de datos mientras el plugin se activa. Las minas se leen de forma asíncrona y se preparan en cuanto llegan, y los contadores de un jugador se leen cuando entra.
Actualizar#
El cargador descarga la versión actual al arrancar, así que reiniciar es actualizar. El jar del cargador solo hay que reemplazarlo cuando una versión lo pide.
Tus cambios en config.yml, templates.yml, boosts.yml, messages.yml y el menú de jugadores se
conservan, las claves nuevas se añaden con sus comentarios, y las minas viven en la base de datos.
¿Falta algo en esta página? Dínoslo en Discord