Premiers pas

LeavePulse est une plateforme publique pour les communautés de serveurs Minecraft. Elle permet d'afficher l'état des serveurs, de suivre une télémétrie plus riche via l'Agent LeavePulse, de prendre en charge les profils de joueurs et d'exécuter des processus de candidature pour la liste blanche à travers le site web, Discord et Minecraft.

Concepts de base

Un Workspace (Espace de travail) est l'endroit où votre équipe gère la propriété, les membres, la facturation et les paramètres opérationnels.

Un Project (Projet) est la page publique de la communauté ou du réseau. Un projet peut contenir un seul serveur ou de nombreux serveurs liés.

Un Server (Serveur) est l'adresse Minecraft réelle ou le backend que les joueurs rejoignent. Un serveur peut être répertorié publiquement avant que le propriétaire ne connecte le plugin, mais les fonctionnalités de gestion nécessitent une vérification.

L'Agent peut être installé avant d'être connecté. Ce premier démarrage non connecté est utile : il génère la configuration, confirme que le jar se charge sur le bon runtime, et donne accès aux commandes locales d'état et de diagnostics avant l'activation des fonctionnalités gateway.

Première configuration recommandée

1. Connectez-vous à LeavePulse.
2. Créez ou ouvrez un espace de travail.
3. Ajoutez votre serveur ou projet Minecraft.
4. Téléchargez l'Agent depuis Modrinth, en utilisant la carte de téléchargement du site pour confirmer le build adapté à votre serveur ou proxy.
5. Installez l'Agent LeavePulse pour la plateforme de votre serveur.
6. Copiez le code de connexion depuis le site web.
7. Exécutez la commande de connexion de la plateforme depuis la console du serveur ou un compte avec des autorisations d'administration.
8. Exécutez la commande d'état de la plateforme et une exportation de diagnostics.
9. Ouvrez la page du serveur et confirmez que le plugin s'affiche comme connecté.
10. Configurez la liste blanche et les fonctionnalités Discord uniquement après que la connexion de base soit stable.

Utilisez la commande de connexion adaptée à la plateforme où l'Agent est installé :

Ce que débloque la connexion du plugin

Une fois le plugin connecté, LeavePulse peut recevoir des métadonnées de serveur en direct, le nombre de joueurs, l'état de la liste blanche, l'état de maintenance et certains événements de modération. Les signaux exacts dépendent de la prise en charge de la plateforme et des paramètres activés dans votre configuration générée.

connect est le chemin de configuration normal. Il échange le code du site web, écrit le server_id lié, configure le jeton de passerelle (gateway) et l'URL WebSocket, puis essaie d'inscrire l'environnement de vérification. Modifiez la configuration uniquement lorsque les diagnostics ou le support indiquent un champ spécifique.

Première vérification des diagnostics

Après la connexion, exécutez :

Utilisez /leavepulsevelocity ... sur Velocity et /leavepulsebungee ... sur BungeeCord ou Waterfall. L'exportation écrit un rapport JSON dans diagnostics/latest.json à l'intérieur du répertoire de configuration du plugin. Gardez ce fichier à disposition lorsque vous demandez de l'aide ; il contient l'état d'exécution nécessaire pour comprendre les problèmes de passerelle, de jeton, de liste blanche, d'inscription et de réseau.

Étapes suivantes

Téléchargez l'Agent dans Téléchargements de l'Agent, installez-le avec Installation du plugin, puis consultez la Configuration du plugin avant de modifier les paramètres avancés.