Présentation

En attente d'approbation v1.0

Plateformes

Paper, Purpur, Folia

Minecraft

1.21.11 ou 26.2

Java

21

Requis

Aucun

Facultatif

PlaceholderAPI, MariaDB or MySQL

VelorJourney guide les nouveaux joueurs sur votre serveur et vous montre combien d'entre eux reviennent. C'est un système autonome d'accueil et de rétention : chaque intégration est facultative.

Prérequis : Java 21 et un serveur Paper, Purpur ou Folia sous Minecraft 1.21.11 ou 26.2. PlaceholderAPI et un serveur MariaDB ou MySQL sont facultatifs.

Premier démarrage #

1. Placez le jar de VelorJourney dans le dossier plugins du serveur.
2. Démarrez le serveur une fois.
3. Modifiez plugins/VelorJourney/config.yml, les fichiers de langue et les fichiers de journeys/.
4. Exécutez /journey validate pour vérifier vos modifications, puis /journey reload pour les appliquer.
5. Exécutez /journey doctor pour vérifier le stockage.

/journey validate lit les fichiers sur le disque exactement comme le ferait un rechargement et indique le fichier et le problème lorsque quelque chose ne va pas. Il ne modifie rien. /journey reload est tout ou rien : si un fichier est invalide, il est refusé et la configuration en cours reste en service.

Les titres, les textes et les matériaux des icônes de l'interface sont configurables. Le tableau de bord utilise un arrière-plan cohérent, un lore explicatif, des taux d'achèvement et des états explicites « aucune donnée » au lieu d'exposer des clés de message internes.

Stockage #

SQLite est prêt sans configuration et constitue la valeur par défaut. Pour partager des données entre serveurs, définissez storage.type: MYSQL et remplissez la section storage.mysql. Cela fonctionne avec MariaDB (testé avec la 11.8) et avec les serveurs compatibles MySQL. Le compte de la base de données doit seulement pouvoir créer des tables et lire, insérer, mettre à jour et supprimer des lignes dans sa propre base. Les changements de stockage nécessitent un redémarrage ; les changements ordinaires de configuration, de langue et de parcours se rechargent à chaud.

L'accès à la base de données s'exécute sur son propre thread. Une tentative de connexion abandonne au bout de 5 secondes et une requête au bout de 15, si bien qu'une base de données injoignable ne peut pas figer le serveur. La progression qui n'a pas pu être enregistrée reste en mémoire et est réécrite lorsque la base de données répond, y compris celle des joueurs partis entre-temps. Si le serveur lui-même est arrêté alors que la base de données est toujours injoignable, la progression non encore écrite est perdue.

Si la base de données est injoignable au démarrage du serveur, ou si la connexion est refusée, VelorJourney consigne la raison et reste désactivé jusqu'au prochain redémarrage. Rien n'est écrit dans votre configuration ni dans vos données.

Définissez journeys.enabled: false pour faire fonctionner VelorJourney en installation d'analyse seule. Le suivi du temps actif, des joueurs et de la rétention continue, tandis que l'inscription automatique, les signaux de progression et les menus de parcours des joueurs s'arrêtent. La progression existante est conservée et reprend lorsque les parcours sont réactivés.

En jeu #