Instalar ExyliaAimTrainer
Pon el plugin y sus dependencias, revisa la consola y sabe qué archivos generados son tuyos para editar.
Antes de empezar#
ExyliaAimTrainer necesita dos plugins en plugins/ antes del primer arranque.
| Plugin | Para qué |
|---|---|
ExyliaLib | Configuración, menús, base de datos, placeholders, efectos, sidebars, overlays, snapshots de inventario y claims de jugador. |
packetevents | Los objetivos mismos, y el aislamiento que impide que jugadores de sesiones distintas se vean. Declarada como dependencia obligatoria; sin ella el plugin no carga. |
Opcionales:
- PlaceholderAPI — para usar los placeholders del plugin fuera de él. Todo lo demás funciona sin él.
- ExyliaPracticeCore — permite que un jugador que espera en una cola de práctica entrene hasta que se encuentre su partida. Consulta Compatibilidad.
- Geyser y Floodgate — permiten a los jugadores de Bedrock entrenar y batirse en duelo, clasificados en tablas propias. Consulta Compatibilidad.
plugin.yml pone ExyliaLib en softdepend a propósito: el loader que instala ExyliaLib es el que tiene
que cargar primero para que esa instalación ocurra. El plugin la sigue necesitando para funcionar.
Instalar#
Copia los jars
Copia ExyliaAimTrainer.jar y sus dependencias en la carpeta plugins/ del servidor.
Arranca el servidor
El primer arranque genera los archivos de configuración, los menús y las tablas de la base de datos.
Revisa la consola
Deberías ver ExyliaAimTrainer enabled y, cuando se leen las arenas, Loaded 0 arenas and 18 drills. Las arenas se leen en segundo plano; hasta que aparece esa segunda línea no se puede enviar
ningún ejercicio ni ningún duelo a ninguna parte.
Abre el panel
Con el permiso exyliaaimtrainer.admin, ejecuta /aimtraineradmin para abrir el menú de
administración y crear una primera arena. Sin ella no empieza nada. Consulta
Primeros pasos.
Cuando ExyliaLib no puede llegar a PacketEvents, la consola avisa
PacketEvents is missing: targets cannot be drawn and no drill can start, y cada ejercicio o petición
de duelo se responde con "Targets need PacketEvents, which this server does not have." El resto del
plugin —menús, perfiles, tablas— sigue funcionando.
Archivos generados#
Todos viven en plugins/ExyliaAimTrainer/.
| Archivo | Contenido |
|---|---|
config.yml | El idioma, el entrenamiento, cada ejercicio, los ajustes entre los que eligen los jugadores, puntuación, grados, el HUD, duelos, la integración con práctica, tablas, historial, arenas, aislamiento del chat y debug. |
lang/<code>/messages.yml | Cada línea que envía el plugin, agrupada por sistema, el feedback de impactos y el texto de la boss bar. |
lang/<code>/scoreboards.yml | Las dos sidebars: una para un ejercicio, otra para un duelo. |
lang/<code>/menus/ | Las pantallas de jugador —main, drills, settings, opponents, duel, profile, records, history, sessions, leaderboard_drills, leaderboard, result, drill_result—, el hotbar.yml del ejercicio y la carpeta admin/. |
database.yml | Motor de base de datos, escrito por ExyliaLib. H2 por defecto, embebido, nada que instalar. |
<code> es el idioma en el que funciona el plugin: en, es, pt, fr, ru o tr, o el idioma propio de
ExyliaLib mientras config.yml diga language: default. Un servidor actualizado desde una versión
anterior a los idiomas guarda sus archivos en lang/custom/. Consulta
Configuración · language. Las rutas de menus/ de abajo
están dentro de esa carpeta.
Un archivo de menú que no se puede leer se informa en consola como
Menu "<id>" (<path>) did not load and will not open, y esa pantalla no se abre; el resto del plugin
sigue funcionando.
Qué archivos de menú son tuyos#
La carpeta menus/ sigue dos reglas, y una de ellas conserva tus cambios.
| Archivos | Qué les pasa |
|---|---|
menus/admin/ | Se borra y se reemplaza desde el jar en cada arranque y cada recarga de menús: /aimtraineradmin reload, el botón de recarga y una recarga de la propia ExyliaLib. |
Cualquier otro archivo de menus/, hotbar.yml incluido | Tuyo. Se instala una vez y luego se actualiza respetando tus cambios. |
Cualquier cambio en menus/admin/ desaparece en el siguiente arranque o recarga. Es deliberado: un botón añadido en una versión llega a los servidores que ya tienen los
archivos. Ahí no vive nada que el dueño deba editar.
Las trece pantallas de jugador y la hotbar las mantiene al día ExyliaLib, que recuerda los valores por defecto que
revisaste por última vez en .defaults/files/ dentro de la carpeta del plugin:
- Un archivo que falta se escribe, salvo que ya se hubiera instalado y lo borraras: en ese caso sigue
borrado. Para recuperar una pantalla de serie, borra el archivo y también su copia en
.defaults/files/menus/. - Una clave nueva en una versión se añade a tu archivo al momento, con sus comentarios.
- Un valor por defecto que cambió en una clave que sigue con el valor que tenías se deja como está y
aparece en
/exylialib updates, donde lo aplicas o te quedas con el tuyo. - Todo lo que cambiaste o borraste no se toca nunca.
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.
Las arenas, los perfiles, los récords y el historial viven en la base de datos, no en YAML, en cinco tablas:
| Tabla | Una fila por |
|---|---|
aim_arenas | arena |
aim_profiles | jugador: números de por vida, récord de duelos, rating general por edición y sus ajustes |
aim_records | jugador, ejercicio y edición: los mejores valores de cada tabla |
aim_sessions | ejercicio terminado |
aim_matches | participante de un duelo terminado |
Las arenas se crean y se editan desde /aimtraineradmin, que es lo que permite a varios servidores
compartir un mismo conjunto apuntando a la misma base de datos.
Nada espera a la base de datos mientras el plugin se habilita. Cada lectura y escritura es asíncrona, un perfil se carga cuando su jugador entra, y un perfil que termina de cargarse cuando su jugador ya se fue se descarta.
Actualizar#
Reemplaza el jar y reinicia. Se conservan tus cambios en config.yml, messages.yml,
scoreboards.yml, los menús de jugador y la hotbar. El primer arranque de una versión con idiomas mueve
los antiguos messages.yml, scoreboards.yml y menus/ a lang/custom/ y pone language: custom, y
saca feedback y el texto de la boss bar de config.yml para llevarlos a ese messages.yml.
config.yml lleva una versión, y una actualización que cambia un valor de serie solo mueve los valores
que siguen en el antiguo: un ejercicio cuya duración cambiaste la conserva, un ejercicio que añadiste no
se toca nunca, y un sonido que elegiste sigue elegido. menus/admin/ se
reemplaza, como se explica arriba, y las arenas y las estadísticas viven en la base de datos.
¿Falta algo en esta página? Dínoslo en Discord