Introducción
Qué es ExyliaAimTrainer, qué resuelve y cómo está organizada esta documentación.
ExyliaAimTrainer es un entrenador de puntería para servidores que se toman en serio la práctica de PvP. Un jugador dispara un ejercicio en solitario, ajustado al tamaño y la distancia de objetivo que elija, o reta a otro jugador a un duelo al mejor de N en el que ambos disparan a los mismos objetivos al mismo tiempo. Cada partida se puntúa, cada récord se guarda y cada ejercicio tiene su propia tabla de clasificación.
Los objetivos no son entidades. Cada uno se envía como paquetes al único jugador que le dispara: un bloque que se ve y una caja de interacción montada encima que es la que se golpea. El servidor no tiene nada que procesar por tick, cualquier número de jugadores comparte una arena sin ver los objetivos de los demás, y un clic lo juzga el propio cliente del jugador con la misma prueba de hitbox que usa contra otro jugador: exactamente como se juzga un golpe en PvP.
Qué incluye
Dieciséis de serie en cuatro tipos —flicks, reacción, tracking y combates de combo con un arma real—
y ninguno hardcodeado: un ejercicio es un bloque de números en config.yml.
Una puntuación en la moneda del propio ejercicio, una dificultad según cómo se jugó, y el rating, que es ambas multiplicadas y el único número por el que ordenan las tablas.
AjustesCada jugador elige tamaño, distancia, color y estilo del objetivo, y qué muestra su pantalla. Más pequeño y más lejos da más rating.
DuelosRetos directos, series al mejor de N, la misma semilla en las dos pantallas para que los mismos objetivos aparezcan en los mismos sitios.
ArenasUn spawn por arena, creada desde el menú de administración, compartida por cada ejercicio y duelo que se envía a ella.
EstadísticasPerfiles, récords personales por ejercicio, una tabla por ejercicio y categoría, una tabla general, e historial de sesiones y de duelos.
Requisitos
| Requisito | Detalle |
|---|---|
| Servidor | Paper 1.21.4 o superior. Compatible con Folia. |
| Java | 21 |
| Dependencias obligatorias | ExyliaLib, packetevents |
| Dependencias opcionales | PlaceholderAPI, ExyliaPracticeCore |
La configuración tipada, los menús declarativos en YAML, la base de datos, los placeholders, los efectos, las sidebars, los overlays, los snapshots de inventario y los claims de jugador que evitan que los plugins de Exylia se pisen entre sí vienen de ExyliaLib. El plugin está escrito sobre ella y no funciona sin ella.
Cómo leer esta documentación
Empezar
Instalación, una primera arena, un primer ejercicio y un primer duelo en pocos minutos.
Configurar
Ejercicios, puntuación, ajustes de jugador, duelos y arenas. Aquí se va la mayor parte del tiempo.
Sistemas
Qué pasa durante un ejercicio, estadísticas y tablas, el HUD, y cómo convive el plugin con el resto del ecosistema Exylia.
Referencia
Comandos, permisos, placeholders, cada clave de configuración, los menús y la API para desarrolladores.
Convenciones
- Los valores marcados como por defecto son los que el plugin escribe la primera vez que arranca. Si el archivo ya existe, se conserva tu valor.
- Los identificadores entre
<y>son variables./aim train <drill>significa/aim train gridshot, no/aim train <gridshot>. - Los tiempos son segundos con decimales salvo que la clave diga ticks; 20 ticks son un segundo. Las distancias y los tamaños son bloques.
- Los colores usan los tokens de paleta de ExyliaLib (
{primary},{highlight},{muted}); las etiquetas de MiniMessage como<click>y<hover>también funcionan, como muestra la petición de duelo por defecto.
¿Falta algo en esta página? Dínoslo en Discord