Comment vérifier la santé de votre serveur Minecraft : TPS, temps de tick et spark

Quand les joueurs disent que votre serveur Minecraft lag, il vous faut un chiffre, pas une impression. La carte Santé du serveur sur la page Aperçu montre à quelle vitesse tourne votre serveur, avec un graphique des dernières heures, et un bouton qui le profile pendant une minute et nomme les plugins ou mods qui utilisent le plus de temps.

Ouvrir la carte

Ouvrez votre serveur dans le panel et allez sur Aperçu. Sur les serveurs Minecraft Java, la carte Santé du serveur se trouve sous Utilisation. Elle affiche un verdict en toutes lettres :

TPS et temps de tick

Minecraft fait tourner son monde en ticks, et vise 20 ticks par seconde (TPS). 20, c’est parfait, et en dessous d’environ 18, les joueurs commencent à remarquer du lag. Chaque tick dispose de 50 ms pour se terminer : vous pouvez donc lire la même chose avec le Temps de tick (millisecondes par tick). Au-delà de 50 ms par tick, le serveur prend du retard et les joueurs ressentent du lag. Utilisez le sélecteur au-dessus du graphique pour passer de TPS à Temps de tick, et choisissez une période : Dernière heure, 6 dernières heures ou Dernières 24 heures. La légende sous le gros chiffre indique la période couverte, et montre le tick le plus lent.

Le panel envoie une courte commande au serveur une fois par minute tant que la carte est ouverte : le graphique a donc des valeurs pour les moments où la carte était ouverte. Les commandes et leurs réponses sont écrites dans logs/latest.log.

Quand la carte n’a pas de chiffres

La carte vous dit pourquoi :

• En pause : personne n’est en ligne. Minecraft arrête le monde quand il est vide : il n’y a donc rien à mesurer.
• Le serveur ne tourne pas. Démarrez-le pour voir comment il tourne.
• Cette version de Minecraft ne peut pas indiquer ses temps de tick par elle-même. La carte propose Installer spark, un profileur gratuit de Modrinth. Un redémarrage suit, et la mesure fonctionne ensuite.
• Cette version de Minecraft n’a aucune commande qui indique les temps de tick. Vanilla en a ajouté une en 1.20.3.
• Le serveur n’a pas répondu à la vérification des ticks du panel. Un plugin a peut-être remplacé la commande /tps. Le panel réessaie plus tard.
• Le monde est figé avec /tick : il ne tourne donc pas.
• Mesure en cours. La première valeur arrive dans la minute.

Profiler le lag avec spark

Les TPS vous disent qu’il y a du lag. Un profil vous dit d’où il vient.

1. Attendez que le lag se produise, ou demandez aux joueurs de faire ce qui le cause.
2. Sur la carte, sous Ce qui le ralentit, cliquez sur Profiler 60 s. Cela lance spark pendant une minute et affiche Profilage avec les secondes restantes.
3. Quand c’est terminé, le résultat dit des choses comme « Nom a utilisé une part du thread principal. Minecraft lui-même en a utilisé une autre. » Il liste Plugins et mods, Minecraft lui-même et Code le plus sollicité, et ce que faisait le serveur pendant le profil : TPS, joueurs en ligne, entités et chunks chargés.
4. Si un plugin ou un mod est la partie la plus lourde, regardez ce qu’il fait : une tâche planifiée, un gros travail comme la génération du monde, ou un paramètre qui s’exécute trop souvent. Mettez-le en pause ou retirez-le, puis profilez à nouveau pour comparer. Les profils précédents sont listés sous Profils précédents.

Vanilla ne peut pas charger de profileur. Paper, Fabric, Forge et NeoForge le peuvent. Sur Paper 1.21 et plus récent, spark est déjà inclus. Sur les versions plus anciennes, ajoutez le plugin spark dans le dossier plugins et redémarrez le serveur.

Partager un profil

Obtenir un lien spark envoie le profil sur spark.lucko.me, un visualiseur public gratuit tenu par l’auteur de spark. Toute personne qui a le lien peut l’ouvrir : le panel demande donc d’abord (Obtenir un lien spark ? et Envoyer et obtenir le lien). spark en retire les mots de passe et la seed du monde. Partagez le lien avec l’auteur d’un plugin quand vous demandez de l’aide. Le serveur garde ses deux fichiers de profil les plus récents : partagez donc un profil peu après l’avoir lancé.

Que faire ensuite

• Un serveur lent est souvent un serveur à court de mémoire ou avec trop de choses chargées. Voir Comment réduire le lag sur votre serveur Minecraft et De combien de RAM un serveur Minecraft a-t-il besoin.
• Pour voir le CPU, la mémoire et le stockage, voir Comment lire les graphiques d’utilisation de votre serveur.
• Si une grosse génération est la cause, voir Comment prégénérer votre monde Minecraft pour que l’exploration ne lag pas.

Si vous avez profilé et que le lag reste, ouvrez un ticket et joignez le lien spark.

Envie d’un serveur Minecraft qui tient le rythme ? Voir l’hébergement de serveurs Minecraft.