Descripción general

Pendiente de aprobación v1.0

Plataformas

Paper, Purpur, Folia

Minecraft

1.21.11 o 26.2

Java

21

Obligatorio

Ninguno

Opcional

PlaceholderAPI, MariaDB or MySQL

VelorJourney guía a los jugadores nuevos por tu servidor y te muestra cuántos de ellos vuelven. Es un sistema independiente de incorporación y retención: todas las integraciones son opcionales.

Requisitos: Java 21 y un servidor Paper, Purpur o Folia con Minecraft 1.21.11 o 26.2. PlaceholderAPI y un servidor MariaDB o MySQL son opcionales.

Primer arranque #

1. Copia el jar de VelorJourney en la carpeta plugins del servidor.
2. Inicia el servidor una vez.
3. Edita plugins/VelorJourney/config.yml, los archivos de idioma y los archivos de journeys/.
4. Ejecuta /journey validate para comprobar tus ediciones y luego /journey reload para aplicarlas.
5. Ejecuta /journey doctor para verificar el almacenamiento.

/journey validate lee los archivos del disco exactamente como lo haría una recarga y nombra el archivo y el problema cuando algo falla. No cambia nada. /journey reload es todo o nada: si algún archivo no es válido, se rechaza y la configuración en ejecución sigue en servicio.

Los títulos, los textos y los materiales de los iconos de la GUI son configurables. El panel usa un fondo coherente, lore explicativo, tasas de finalización y estados explícitos de «sin datos» en lugar de mostrar claves internas de mensajes.

Almacenamiento #

SQLite está listo sin configuración y es el valor por defecto. Para compartir datos entre servidores, define storage.type: MYSQL y rellena la sección storage.mysql. Funciona con MariaDB (probado con la 11.8) y con servidores compatibles con MySQL. La cuenta de la base de datos solo necesita crear tablas y leer, insertar, actualizar y borrar filas en su propia base de datos. Los cambios de almacenamiento necesitan un reinicio; los cambios normales de configuración, idioma y viajes se recargan en vivo.

El acceso a la base de datos se ejecuta en su propio hilo. Un intento de conexión se rinde a los 5 segundos y una consulta a los 15, así que una base de datos inalcanzable no puede congelar el servidor. El progreso que no se pudo guardar permanece en memoria y se vuelve a escribir cuando la base de datos responde, incluido el progreso de los jugadores que se fueron entretanto. Si el propio servidor se detiene mientras la base de datos sigue inalcanzable, el progreso que aún no se escribió se pierde.

Si no se puede acceder a la base de datos cuando el servidor arranca, o se rechaza el inicio de sesión, VelorJourney registra el motivo y permanece desactivado hasta el siguiente reinicio. No se escribe nada en tu configuración ni en tus datos.

Define journeys.enabled: false para ejecutar VelorJourney como una instalación solo de analítica. El seguimiento del tiempo activo, de jugadores y de retención continúa, mientras que la inscripción automática, las señales de progreso y los menús de viaje de los jugadores se detienen. El progreso existente se conserva y se reanuda cuando se vuelven a activar los viajes.

En el juego #