Contenido generado con IA — puede contener errores.

ExyliaMines/Empezar

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.

Página 2 de 286 min de lectura

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#

PluginPara qué
packeteventsOpcional (dependencia blanda). Sin él el plugin funciona y solo se quedan apagados los extras dibujados con paquetes, como los hologramas.
ExyliaLibObligatorio, 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:

PluginQué añade
ExyliaSurvivalCoreSus límites de encantamientos y sus objetos bloqueados se aplican dentro de las minas. Ver Integraciones.
ExyliaMarketSu autoventa se lleva los drops de cada mina. Ver Integraciones.
PlaceholderAPILos placeholders del plugin en otros plugins: scoreboards, tab, plugins de hologramas.
VaultDinero en las tablas de botín y en los premios de suerte, a través de la economía de ExyliaLib.
Worlds o Multiverse-CoreNada que configurar: una mina en un mundo que uno de ellos carga tarde se prepara en cuanto el mundo carga.
ExyliaLib figura como soft y se instala sola

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/.

ArchivoContenido
config.ymlIdioma, debug, tiempos de reinicio por defecto, intervalos de comprobación, sonidos, alcance de los anuncios y reglas de Fortune. Ver Configuración.
templates.ymlLos puntos de partida que ofrece Crear desde plantilla.
boosts.ymlLos potenciadores temporales y el horario que los lanza.
lang/<idioma>/messages.ymlCada línea que envía el plugin, los títulos y boss bars, las líneas de los hologramas.
lang/<idioma>/menus/user/mines.ymlEl menú /mines de los jugadores.
lang/<idioma>/screens/mines.yml y screens/mines.htmlLa lista /mines de los jugadores como pantalla nativa.
lang/<idioma>/menus/admin/Los veinte menús de staff.
database.ymlEl 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.

menus/admin/ se reescribe en cada arranque

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 no están en un archivo

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:

plugins/ExyliaMines/database.yml
yaml
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:

TablaUna fila por
minesmina: su servidor, tipo, área, composición o niveles, ajustes de reinicio, teletransportes, holograma, botín, efectos y ajustes de Fortune
mines_statemina clásica: bloques picados desde su último relleno y cuándo toca el siguiente
mines_broken_blocksbloque de una mina realista esperando a volver a crecer
mines_statsjugador y mina: bloques picados allí
mines_boostspotenciador 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