Comment réaliser un diagnostic Spark Profiler sur son serveur Minecraft

Comment réaliser un diagnostic Spark Profiler sur son serveur Minecraft

Spark est un profiler très puissant qui permet d’identifier précisément ce qui provoque du lag sur un serveur Minecraft : mods ou plugins trop lourds, tâches mal configurées, ticks trop longs, etc. Sur BoxToPlay, vous pouvez installer Spark en quelques clics en tant que mod ou plugin directement depuis le panel BoxToPlay (ou manuellement en transférant le fichier par FTP) et lancer tous les diagnostics depuis la console en direct.

Voici, étape par étape, comment installer et utiliser Spark sur votre serveur.

1. Prérequis

Avant de lancer un profil Spark sur votre serveur Minecraft :

• Un serveur Minecraft BoxToPlay démarré et accessible.
• Le serveur doit tourner sous une version supportant les mods ou les plugins (Forge, NeoForge, Fabric, Spigot, Paper, Purpur, etc.). Spark est également compatible avec les proxies (BungeeCord, Velocity).
• L’accès à la live console de ce serveur, avec les permissions suffisantes pour exécuter les commandes Spark.

2. Installer Spark sur le serveur

Spark s’adapte à tous les types de serveurs. Selon la configuration de votre serveur, vous avez deux méthodes simples pour l’installer :

Option A : Installation automatique depuis le Panel BoxToPlay

C’est la méthode la plus rapide et recommandée :

1. Dans le menu de votre serveur sur le panel BoxToPlay, cliquez sur Installation de Mods ou Installation de Plugins (selon le type de votre serveur).
2. Dans le champ de recherche, tapez spark.
3. Sélectionnez le mod ou plugin spark.
4. Choisissez la version compatible avec votre version de Minecraft/serveur (par exemple Forge, Fabric, Paper/Spigot, etc.).
5. Cliquez sur Installer puis validez.
6. Une fois installé, redémarrez le serveur pour charger Spark.

Option B : Installation manuelle (via FTP ou Gestionnaire de fichiers)

Si vous préférez installer le fichier jar vous-même ou si vous utilisez une version spécifique :

1. Téléchargez la version appropriée de Spark (fichier .jar) depuis le site officiel de Spark, Modrinth ou CurseForge. Veillez à bien choisir le fichier correspondant à votre type de serveur (Forge, Fabric, Spigot/Paper, BungeeCord, Velocity, etc.) et à sa version de Minecraft.
2. Connectez-vous à votre serveur via FTP ou utilisez le Gestionnaire de fichiers intégré au panel.
3. Téléversez le fichier .jar dans le dossier approprié de votre serveur :
   • Pour les serveurs de type plugins (Spigot, Paper, Purpur…) : placez-le dans le dossier plugins/.
   • Pour les serveurs de type mods (Forge, NeoForge, Fabric…) : placez-le dans le dossier mods/.
4. Redémarrez le serveur pour appliquer l’installation.

3. Vérifier le chargement de Spark au démarrage

1. Revenez sur le Dashboard du serveur et assurez‑vous qu’il est bien Online.
2. Cliquez sur Server logs dans l’en‑tête de la console ou ouvrez la page All logs.
3. Dans le dernier log de démarrage, cherchez les lignes qui mentionnent spark (initialisation du mod ou du plugin, version chargée, etc.).

Si Spark n’apparaît pas :

• Vérifiez que le fichier .jar a été déposé dans le bon dossier (mods/ ou plugins/) et que le serveur a bien redémarré.
• Pour une installation automatique via le panel, vérifiez que le mod/plugin est bien activé dans l’onglet de gestion des mods/plugins installés.

4. Exécuter les commandes Spark (Console ou En jeu)

Vous pouvez exécuter les commandes de Spark de deux manières différentes :

• Depuis la live console du panel BoxToPlay : Allez sur le Dashboard de votre serveur dans le panel et saisissez les commandes dans le terminal en bas de la console sans slash initial (ex : spark profiler start).
• Directement en jeu : Si vous êtes connecté sur votre serveur et disposez des permissions requises (OP ou permissions spécifiques spark.profiler), vous pouvez lancer les commandes directement depuis le chat du jeu en ajoutant un slash / (ex : /spark profiler start).

5. Lancer un profil avec Spark Profiler

Spark propose plusieurs modes de profiling selon vos besoins.

Note : Si vous utilisez Spark sur un proxy, la commande de base change selon la plateforme : utilisez sparkb sur BungeeCord et sparkv sur Velocity (par exemple /sparkb profiler start ou /sparkv profiler start). Attention : installer Spark sur un proxy permet uniquement d’analyser les performances du proxy lui-même (gestion du réseau, plugins du proxy…). Pour diagnostiquer un serveur de jeu (Paper, Fabric, etc.) connecté derrière le proxy, vous devez installer Spark individuellement sur ce serveur de jeu.

Pour un diagnostic classique limité à 120 secondes, utilisez :

spark profiler start --timeout 120

Spark arrête alors automatiquement la capture à la fin du délai et génère le lien du rapport. Si vous voulez arrêter la capture manuellement avant la fin, utilisez :

spark profiler stop

Pour suivre l’état de la capture sans l’arrêter, vous disposez de deux commandes :

• Pour afficher les détails de la capture en cours dans la console/le chat (durée, nombre d’échantillons…) :

  spark profiler info
  

• Pour générer un lien permettant de visualiser les résultats en temps réel directement dans votre navigateur pendant que l’enregistrement se poursuit :

  spark profiler open
  

Pour enquêter sur des pics de lag isolés, commencez par activer le moniteur de ticks :

spark tickmonitor --threshold-tick 50

Quand vous avez repéré des ticks anormalement longs, lancez ensuite un profil ciblé. Par exemple, pour ne collecter que les ticks dépassant 150 ms :

spark profiler start --only-ticks-over 150 --timeout 120

Pour des diagnostics plus avancés, Spark permet de modifier la portée ou le type de données analysées :

• Analyser tous les threads (au lieu de se limiter uniquement au thread principal du serveur) : utile si le lag est causé par des tâches asynchrones, des connexions réseau ou d’autres processus tournant en arrière-plan.

  spark profiler start --thread * --timeout 120
  

• Analyser l’allocation de la mémoire (au lieu de mesurer le temps processeur CPU) : permet de pister les créations d’objets en mémoire pour identifier l’origine des fuites de RAM ou des surcharges du ramasse-miettes (Garbage Collector).

  spark profiler start --alloc --timeout 120
  

Adaptez toujours la commande exacte à ce que propose l’aide de votre version de Spark (spark ou spark help) dans la console.

Bonnes pratiques pendant le profiling :

• Choisissez une période représentative : lancez le profil quand le serveur est utilisé normalement ou en charge, pas juste après le démarrage.
• Évitez de redémarrer ou d’arrêter le serveur pendant la capture.
• Essayez de reproduire le lag que vous enquêtez pendant que Spark enregistre.
• Une durée comprise entre 60 et 180 secondes suffit généralement pour obtenir des données exploitables.

6. Attendre la fin et récupérer le lien généré

1. Après l’envoi de la commande, Spark confirme dans la console que le profiling a commencé.
2. Laissez le serveur tourner jusqu’au message de fin de Spark.
3. À la fin, Spark génère une URL (lien vers le rapport de profil) et l’affiche directement dans la live console.
4. Copiez ce lien pour l’ouvrir dans votre navigateur ou le conserver pour plus tard.

Ce lien est la clé de votre diagnostic : il regroupe toutes les informations collectées pendant la session.

Cette section d’en-tête du rapport résume en un coup d’œil la santé globale de votre serveur :

• TPS (Ticks Per Second) : Le nombre de ticks de jeu traités par seconde. La valeur optimale est 20.00. Une baisse prolongée des TPS traduit un ralentissement direct en jeu pour les joueurs.
• MSPT (Milliseconds Per Tick) : Le temps (en millisecondes) nécessaire pour calculer un tick. Pour maintenir 20 TPS, cette valeur doit rester inférieure à 50.00 ms. Si le MSPT moyen ou médian dépasse 50 ms, le serveur n’arrive plus à suivre et les TPS chutent.
• CPU : Le pourcentage de processeur consommé par le processus de votre serveur.
• Memory : La RAM actuellement occupée sur le total maximum alloué au serveur.

7. Interpréter les résultats du rapport Spark

En ouvrant le lien Spark dans un navigateur, vous obtenez un rapport interactif. Les zones les plus importantes à analyser sont :

• Timeline des ticks / TPS
  • Affiche le temps de tick moyen et les TPS pendant l’enregistrement.
  • Repérez les pics au‑delà de 50 ms par tick (lag sévère) ou les périodes prolongées sous les 20 TPS.

• Principaux contributeurs au temps de tick

  • Classe les mods/plugins, entités ou systèmes qui consomment le plus de temps par tick.
  • Cherchez :
    • Les mods ou plugins très gourmands (génération de monde, automatisation complexe, plugins mal optimisés…).
    • Les dimensions ou zones problématiques.
    • Les tâches exécutées à chaque tick et particulièrement lentes.

• Schedulers / tâches planifiées

  • Spark liste les tâches planifiées (répétitives, timers, tâches asynchrones).
  • Surveillez celles qui tournent trop souvent (chaque tick) ou qui prennent beaucoup de temps.

• Garbage Collector (GC)

  • Indique le temps passé dans les pauses de GC et l’évolution de la mémoire.
  • Des pauses fréquentes ou longues peuvent révéler :
    • Des allocations massives par certains mods/plugins.
    • Une quantité de RAM insuffisante pour la charge actuelle.

• Hot paths CPU (en profil CPU)

  • Les flame graphs mettent en avant les méthodes les plus consommatrices.
  • Concentrez‑vous sur les quelques piles les plus lourdes : elles pointent souvent directement vers la mécanique, le plugin ou le mod à corriger.

Grâce à ces informations, vous pouvez décider des actions à mener : réduire la distance de vue, ajuster la configuration de certains éléments, retirer ou remplacer un mod/plugin trop coûteux, ou encore replanifier des tâches lourdes.

8. Refaire un profil après vos changements

Après chaque modification importante (ajout/retrait de mod/plugin, changement de configuration, ajustement de RAM…), il est conseillé de relancer un profil Spark :

• Conservez plusieurs liens de profils avec une étiquette claire (avant/après changement).
• Comparez les temps de tick, le comportement du GC et la liste des principaux contributeurs.

Conclusion et prochaine étape avec BoxToPlay

Spark Profiler est l’un des meilleurs outils pour comprendre ce qui se passe réellement dans votre serveur Minecraft. Avec l’installation simplifiée de mods et plugins et la console en direct intégrées au panel BoxToPlay, vous pouvez installer Spark, diagnostiquer votre serveur et corriger les problèmes de performances en quelques minutes.

Envie de tester ces étapes sur votre propre monde ? Vous pouvez créer un serveur Minecraft chez BoxToPlay et essayer Spark sans engagement. Lancez votre serveur gratuitement et commencez à optimiser vos performances dès maintenant.