spark est le profileur pour les serveurs Minecraft. Quand ton serveur rame, spark te dit en quelques secondes si le tickrate en souffre, quels plugins ou quelles fermes consomment le temps de calcul et si le CPU ou la mémoire sont à la limite. Ce guide te présente les trois commandes dont tu as vraiment besoin et t'explique comment lire les chiffres. Les captures d'écran proviennent d'un serveur de test sous Paper 1.21.4.

Installation

spark fonctionne comme plugin sur Paper et Spigot, et comme mod sur Fabric, NeoForge et Forge. Dans le panel, tu le trouves sous Plugins → Browser. Il ne nécessite aucune configuration. Les commandes sont à attribuer au groupe de modération ; le nœud correspondant s'appelle spark. Pour savoir comment l'attribuer, consulte LuckPerms : configurer les permissions.

Premier aperçu : TPS et durée des ticks

/spark tps affiche trois lignes :

Sortie de /spark tps : TPS, durées des ticks et utilisation du CPU (Enlarge image)
  • TPS (ticks par seconde) sur les 5 et 10 dernières secondes, puis sur les 1, 5 et 15 dernières minutes. Le maximum est de 20,0. Autour de 19, les joueurs ne remarquent encore rien ; sous 15, les animaux se déplacent par à-coups ; sous 10, le serveur devient injouable.
  • Durée des ticks : minimum, médiane, 95e centile et maximum en millisecondes. Un tick peut durer jusqu'à 50 ms pour maintenir 20 TPS. Sur l'image, la médiane est de 2,4 ms : le serveur a donc beaucoup de marge. Le chiffre décisif est le 95e centile : s'il approche 50 ms, des saccades apparaissent même si la moyenne semble bonne.
  • Utilisation du CPU, séparée entre système (la machine entière) et processus (ton serveur uniquement). Sur un serveur loué, c'est la valeur du processus qui compte.

/spark healthreport regroupe ces mêmes valeurs dans un rapport, avec en plus la mémoire et le disque.

Le profileur : qu'est-ce qui consomme le temps de calcul ?

Quand les TPS s'effondrent, lance le profileur :

/spark profiler start

spark confirme le démarrage et continue de tourner en arrière-plan. Laisse-le tourner au moins une minute pendant que le problème se produit, puis exécute :

/spark profiler stop
Le profileur tourne en arrière-plan ; spark affiche les commandes pour afficher, arrêter et annuler (Enlarge image)

À l'arrêt, spark envoie le rapport sur spark.lucko.me et affiche un lien. Le rapport ne contient ni noms de joueurs, ni adresses IP, ni messages de chat, seulement des arbres d'appels du processus Java. /spark profiler open l'ouvre dès le profilage en cours, tandis que /spark profiler cancel l'abandonne sans rien envoyer.

Dans le rapport, déplie l'arbre en partant du haut. Voici ce que tu y trouveras généralement :

  • Ticks d'entités d'un type précis : une ferme avec des centaines d'animaux ou d'objets. Réduis la ferme ou calme-la avec entity-activation-range dans paper-world-defaults.yml.
  • Un plugin dans un écouteur d'événements : mets le plugin à jour, vérifie sa configuration ou remplace-le.
  • Chargement de chunks causé par des joueurs qui volent rapidement : réduis la distance d'affichage ou prégénère le monde avec Chunky.
  • Horloges de redstone : un circuit qui ne s'arrête jamais. Demande au joueur de le désactiver.

Garbage collection et mémoire

/spark gc indique la fréquence et la durée des pauses du ramasse-miettes de Java. De nombreuses pauses longues signalent un manque de RAM ou une fuite de mémoire dans un plugin. /spark heapsummary liste les types d'objets qui occupent la mémoire. Avant de prendre plus de RAM, jette un œil ici : une simple mise à jour de plugin résout souvent le problème.

Erreurs courantes

  • 20 TPS, mais du lag quand même. Le problème vient du client ou du réseau. /spark ping affiche la latence de chaque joueur.
  • Lien du profileur oublié. /spark profiler sans argument affiche le statut ; après l'arrêt, le lien figure aussi dans la console du serveur.
  • Des chiffres sans comparaison. Une valeur de TPS seule ne dit pas grand-chose. Fais une mesure avec le serveur vide pour avoir une référence.

Pour aller plus loin

Générer un monde à l'avance évite au serveur de charger les chunks en jeu : Chunky : prégénérer ton monde. Le guide Lag sur un serveur Minecraft : TPS et Watchdog explique comment le panel signale des TPS durablement bas.

Sources