Instalación
El jar del loader y la licencia, las dependencias, qué cambia sin PacketEvents, los archivos que escribe el plugin y cómo actualizar.
Conseguir el plugin
ExyliaJourney es un plugin premium, comprado en BuiltByBit. Se distribuye mediante el loader de Lukittu, así que el archivo que
instalas es el jar del loader, Exylia-Journey-Loader.jar. Comprado en BuiltByBit, la licencia va incrustada en ese jar: no hay clave que introducir. El loader comprueba la licencia en cada arranque y
después cede el control al plugin.
Antes de empezar
| Requisito | Para qué |
|---|---|
| Paper o Folia 1.21.4+ | El servidor. Folia está soportado: el progreso cambia en el hilo de región de cada jugador. |
| Java 21 | El entorno de ejecución. |
ExyliaLib | Obligatorio, versión 1.392.0 o superior: la guía, las cámaras de mundo, los clics en NPCs, la configuración, los menús, las recompensas, la base de datos y la API JourneyService. |
El plugin.yml del loader pone ExyliaLib en softdepend a propósito: el loader es quien lo instala, así
que tiene que poder arrancar sin él. En un servidor sin ExyliaLib descarga la última versión en plugins/
y pide un reinicio.
PacketEvents
packetevents es opcional pero muy recomendado. Es lo que dibuja el texto flotante, el faro, el rastro,
el brillo y la cámara de las cinemáticas, además de los toasts de cada paso, los NPCs propios del plugin y
la barra del grabador de cinemáticas. Sin él ExyliaJourney sigue ejecutando todos los recorridos, con una
guía más sencilla:
| Pieza | Con PacketEvents | Sin él |
|---|---|---|
| Texto del paso | Un panel que flota delante de los ojos, o fijo en un lugar | El paso en el chat cuando empieza, y un segmento de la barra de acción con título, progreso y distancia |
| Faro | Un haz brillante con la distancia | Una columna de partículas sobre el objetivo, o una marca de partículas hacia él cuando está lejos |
| Rastro | Marcadores brillantes en el suelo a lo largo de la ruta | Huellas de partículas a lo largo de la ruta |
| Waypoint | Barra localizadora (1.21.6+) o minimapa de Lunar/Feather | Ninguno |
| Brillo | El NPC o el bloque contorneados para el jugador | Ninguno |
| Cinemáticas | La cámara recorre los fotogramas clave con subtítulos, franjas y fundidos | La cámara no se mueve; los subtítulos llegan al chat a su hora y suenan los sonidos |
| NPCs del plugin | Colocados desde config.yml | No se colocan. Los NPCs de ExyliaDisplays siguen funcionando |
Los jugadores de Bedrock reciben siempre la columna de la derecha, jugador por jugador, aunque PacketEvents esté instalado. Consulta las FAQ.
Plugins opcionales
| Plugin | Qué añade |
|---|---|
PlaceholderAPI | Los placeholders %journey_...% en otros plugins, y condiciones con placeholders en requisitos y objetivos PLACEHOLDER. Consulta Placeholders. |
ExyliaDisplays | Sus NPCs como objetivos y disparadores, sin configurar nada. Consulta Integraciones. |
ExyliaAnalytics | Cada inicio, paso, salto, finalización y abandono enviado como evento. Consulta Analítica. |
Instalar
Copia los jars
Exylia-Journey-Loader.jar y packetevents en plugins/.
Arranca el servidor
El loader comprueba la licencia incrustada en el jar y le cede el control al plugin. El loader instala ExyliaLib si falta; si tuvo que hacerlo, reinicia una vez más.
Deja que genere
El plugin escribe config.yml, sus mensajes y menús, y las carpetas journeys/ (con un example.yml
desactivado), cinematics/ y routes/.
Pruébalo
Entra como operador y ejecuta /journeyadmin demo. Consulta
Primeros pasos.
Archivos generados
Todos están en plugins/ExyliaJourney/.
| Archivo | Contenido |
|---|---|
loader.yml | Lo escribe el loader: license_key, y version (auto mantiene el plugin en la última versión). |
config.yml | Tiempos, feedback, los NPCs propios del plugin, el aspecto de la guía y la reproducción de cinemáticas. Consulta Configuración. |
journeys/<id>.yml | Un recorrido por archivo; el nombre del archivo es su id. Consulta Recorridos. |
cinematics/<id>.yml | Una cinemática por archivo. Consulta Cinemáticas. |
routes/<id>.yml | Una ruta grabada por archivo. Consulta Guía. |
lang/<language>/ | Mensajes, los textos del editor, los menús y la barra del grabador. |
Los ids — los nombres de archivo de recorridos, cinemáticas y rutas — son letras minúsculas, dígitos, - y
_, como mucho 48 caracteres. Un archivo con otro nombre se reporta y no se carga.
El progreso de los jugadores y los contadores del embudo se guardan en la base de datos que proporciona ExyliaLib. Los contadores del embudo solo se incrementan, así que varios servidores que comparten una base de datos suman juntos.
Actualizar
Sustituye el jar del loader y reinicia, o deja version: auto en loader.yml. Tu config.yml, recorridos,
cinemáticas, rutas y mensajes se conservan; las claves nuevas se añaden con sus valores por defecto.
¿Falta algo en esta página? Dínoslo en Discord