Dépannage

Commencez par la console du serveur. La plupart des problèmes de configuration laissent une erreur directe dans le journal (log) du plugin, et la commande d'état ainsi que les commandes de diagnostic montrent si le serveur est lié, quel transport est actif et quelle est la prochaine étape de réparation.

Ce que disent les diagnostics

Les diagnostics sont le moyen le plus rapide de transformer "le plugin ne fonctionne pas" en une cause spécifique. Ils peuvent indiquer si l'Agent est initialisé, si la configuration est chargée et inscriptible, si le client de la passerelle (gateway) existe et est prêt, si le jeton (token) est manquant ou invalide, si l'environnement de vérification est inscrit, si l'application de la liste blanche a une liaison, si le relais backend est actif sur un proxy et si les points de terminaison de l'API/passerelle configurés sont joignables depuis le serveur.

Utiliser le bon préfixe de commande

Paper, Spigot, Folia, Fabric et NeoForge utilisent /leavepulse.

Velocity utilise /leavepulsevelocity.

BungeeCord et Waterfall utilisent /leavepulsebungee.

Utilisez le préfixe correspondant pour chaque commande ci-dessous. La même règle s'applique aux commandes de liste blanche et de maintenance : Velocity utilise /whitelistvelocity et /maintenancevelocity ; BungeeCord/Waterfall utilisent /whitelistbungee et /maintenancebungee.

Premier lot de diagnostics

Exécutez-les avant de modifier la configuration :

L'exportation écrit diagnostics/latest.json sous le répertoire de configuration du plugin. Conservez ce fichier pour le support. Il explique l'état de la passerelle, la validité du jeton, l'incohérence entre le jeton et le serveur ID, l'inscription, la disponibilité de la liste blanche, les permissions du système de fichiers, l'état du planificateur, l'enregistrement des commandes, l'état du relais backend et la joignabilité TCP de l'API/passerelle.

Si le support demande des vérifications plus approfondies, exécutez :

Le mode sans échec est celui par défaut. Le mode standard peut exécuter des tests réversibles tels que le rechargement de la configuration et des vérifications d'écriture de fichiers temporaires.

Passerelle non connectée

Exécutez :

Vérifiez d'abord les messages de diagnostic et les champs actionHint. Si gateway.ws_url, gateway.token ou server_id est manquant, reconnectez-vous depuis le site web avec un nouveau code de connexion. Si l'accès au point de terminaison échoue, réparez l'accès DNS/pare-feu/proxy vers l'hôte de l'API ou de la passerelle configuré.

Jeton manquant ou invalide

Exécutez à nouveau /leavepulse connect <code> depuis le processus de configuration du site web. Ne copiez pas manuellement un jeton depuis un autre serveur.

Si un jeton a fuité, reconnectez le serveur pour qu'un nouveau jeton soit émis.

Les diagnostics peuvent faire la distinction entre un jeton manquant, un jeton malformé, un jeton expiré, des réclamations (claims) invalides, un échec de vérification de signature et une incohérence du server_id :

Serveur déjà lié

Si /leavepulse connect <code> avertit que le plugin est déjà lié, vérifiez que vous connectez le bon serveur Minecraft à la bonne page de serveur LeavePulse.

Ensuite seulement, exécutez :

/leavepulse connect <code> confirm

Liste blanche non configurée

Ouvrez les paramètres de la liste blanche du site web et confirmez que le serveur ou le projet possède une liaison de liste blanche. Puis exécutez :

/leavepulse reload
/leavepulse status
/leavepulse diagnostics suite leavepulse.whitelist

Si les commandes de liste blanche en jeu signalent que la liste blanche n'est pas configurée, le plugin peut atteindre la passerelle mais n'a aucune liaison à appliquer.

Les métriques ne se mettent pas à jour

Exécutez :

/leavepulse send
/leavepulse diagnostics suite leavepulse

Vérifiez ensuite le site web après un court délai. Si aucune mise à jour n'apparaît, utilisez les diagnostics pour vérifier le server_id, l'état de la passerelle, la dernière erreur d'envoi et l'accès réseau sortant vers l'hôte de l'API LeavePulse.

Un joueur ne peut pas rejoindre

Vérifiez si le mode maintenance est activé :

/maintenance status
/leavepulse diagnostics suite leavepulse.whitelist

Vérifiez si l'application de la liste blanche est sur kick ou restrict, puis examinez le statut de candidature du joueur. Un joueur avec le statut pending (en attente), denied (refusé) ou revision (révision) ne doit pas être traité de la même manière qu'un joueur approved (approuvé).

Problèmes de vérification ou de téléchargement des mises à jour

Exécutez :

/leavepulse update status
/leavepulse update check
/leavepulse diagnostics export

Confirmez que auto_update.enabled est sur "true" (vrai), que le canal est correct et que le serveur peut télécharger depuis la source de mise à jour configurée. Si l'application automatique est désactivée, redémarrez ou appliquez la mise à jour selon la politique de mise à jour de votre plateforme.

Si la carte de téléchargement initiale est vide ou ne montre pas votre plateforme, consultez Téléchargements de l'Agent pour vérifier l'ordre des sources, les canaux et le comportement de fallback.