Lorsque Minecraft saccade chez un ami, ses images par seconde peuvent être basses, sa connexion peut réagir avec du retard ou le serveur peut traiter ses étapes de jeu trop lentement. spark aide sur le serveur en cours d'exécution ; il ne prouve pas la cause de chaque saccade à partir d'un seul chiffre. Commencez par l'observation concrète pendant votre partie commune.
Ce guide rassemble un diagnostic compact et facile à suivre pour un petit groupe MCF. Un serveur gratuit avec 2 Go de RAM dispose de ressources limitées, mais plus de RAM n'est pas une solution universelle à chaque latence. Si un pack ne démarre pas du tout, suivez d'abord le diagnostic de démarrage.
Vérifié : 7 octobre 2026. Les captures d'écran montrent un test antérieur sous Paper 1.21.4. Leurs valeurs ne constituent ni un nouveau benchmark MCF ni une performance garantie pour votre monde.
Noter l'observation commune
Notez le moment, le lieu et l'action : quelqu'un vole vers un nouveau terrain, une ferme tourne, ou la rotation de la caméra saccade-t-elle déjà ? Comparez avec un deuxième ami sur la même période. « Un seul est touché » restreint le diagnostic, mais ne prouve pas encore que sa connexion Internet en est la cause.
| Observation | Prochaine comparaison |
|---|---|
| La caméra et l'image saccadent | Vérifier les FPS client, la charge graphique et l'appareil |
| Les blocs réagissent avec retard | Examiner ensemble les ticks serveur actuels et la connexion |
| Un seul ami est déconnecté | Comparer son message, son client et sa connexion avec une arrivée réussie sur le serveur |
| Le serveur ne tourne pas encore | Vérifier le log de démarrage actuel plutôt qu'un profileur d'exécution |
Une moyenne de TPS sur plusieurs minutes peut masquer une brève interruption. Notez donc le moment et examinez des fenêtres de temps adaptées. Observez l'action de jeu normale pendant laquelle le problème survient ; une charge extrême créée artificiellement répond à une autre question. Si le monde vient d'être chargé juste après le réveil du serveur, mesurez en plus une partie en cours plus tard : la charge de démarrage et la charge récurrente en jeu sont deux situations différentes. Un serveur vide ne sert que de mesure de comparaison et ne prouve pas que votre partie tourne de façon fluide.
Vérifier si spark est déjà présent
Paper intègre spark depuis Minecraft 1.21. C'est ce que décrit la documentation de profilage de Paper. Vérifiez d'abord la commande existante et la sortie de démarrage actuelle. Un message d'erreur pour /version spark ne prouve pas à lui seul l'absence d'un plugin lorsque l'intégration est native.
Pour d'autres éditions de serveur, vous aurez peut-être besoin de la version de plugin ou de mod adaptée. Un plugin Bukkit n'a rien à faire sur un serveur purement Fabric. Vérifiez la compatibilité avec la version de Minecraft et du loader installés avant d'ajouter un fichier.
Un compte responsable peut recevoir de façon ciblée spark.tps et, si nécessaire, spark.profiler. La permission générale spark couvre plus que la première comparaison de chiffres. La référence officielle des commandes indique les droits correspondants. Les amis ordinaires n'ont besoin ni de la gestion du profileur ni d'un accès propriétaire MCF pour signaler le problème.
Lire la durée de tick et les TPS sur la bonne période
Exécutez pendant le retard observé :
/spark tps
La valeur cible normale de 20 ticks par seconde correspond, par le calcul, à un budget de temps de 50 millisecondes par tick : 1 000 ms divisées par 20. L'explication de spark sur les TPS et le MSPT distingue la cadence des ticks du temps de tick nécessaire.
En plus de la médiane, lisez aussi les valeurs hautes et la fenêtre de temps correspondante. Le 95e percentile décrit une distribution ; ce n'est ni la pire valeur isolée ni, à lui seul, une preuve de ce que ressentent les joueurs. Il n'existe aucun seuil universel à 19 TPS en deçà duquel tous les joueurs vivraient exactement la même expérience, et au-dessus duquel personne ne remarquerait quoi que ce soit.
Instantané antérieur : sur les dix dernières secondes, on relève 20 TPS ainsi que 2,4 ms de médiane et 4,4 ms au 95e percentile. Ce test calme ne dit rien de votre future ferme ni d'un autre moment de forte charge.
Le CPU système et le CPU du processus sont des indicateurs différents. Les limites du conteneur, le nombre de processeurs et la méthode de mesure influencent aussi l'interprétation. Un faible pourcentage ne prouve pas à lui seul un traitement suffisamment rapide du thread principal. La RAM réservée, le heap Java et la mémoire totale du processus s'examinent également séparément.
Réaliser au besoin un enregistrement limité
Si les chiffres laissent la cause ouverte, un compte responsable peut démarrer le profileur. Convenez d'une courte action de jeu normale et notez le début et la fin :
/spark profiler start
/spark profiler info
Laissez l'exécution couvrir la véritable interruption. Une minute peut servir de premier essai, mais ce n'est pas une durée minimale ni un gage de réussite. Pour des interruptions rares, il faut une période adaptée à l'observation, et vous arrêtez l'enregistrement volontairement.
Les commandes actuelles distinguent les sorties : /spark profiler stop termine l'exécution et fournit normalement un rapport dans le visualiseur web, dont vous retrouvez le lien dans la sortie console à la fin du profileur (conservez-le avec votre situation de jeu) ; /spark profiler cancel l'abandonne sans l'envoi final. /spark profiler open ouvre un visualiseur pour le diagnostic en cours et n'est pas une consultation locale directement dans le jeu.
Pour obtenir un fichier au lieu de l'envoi habituel, la documentation actuelle indique :
/spark profiler stop --save-to-file
Vérifiez que votre édition installée propose cette voie et notez le chemin de fichier indiqué. Un fichier sauvegardé localement n'est pas encore un lien de visualiseur accessible publiquement. N'accordez pas en plus les droits de heapdump uniquement pour recueillir un premier diagnostic de ticks.
Démonstration d'utilisation antérieure. Le message visible sur un plugin introuvable et le profileur intégré qui tourne ensuite ne constituent pas un diagnostic d'installation actuel de votre serveur.
Vérifier le rapport avant de le partager
Un rapport spark n'est pas systématiquement exempt de données personnelles. La description officielle des données brutes montre des métadonnées avec le nom et l'identifiant de l'utilisateur ayant lancé l'exécution. D'autres contenus dépendent du type de rapport, du serveur et des options.
Vérifiez le rapport réel avant de le transmettre et partagez-le de façon ciblée avec le support compétent. Un visualiseur déjà ouvert ou publié n'est pas retiré par l'annulation ultérieure d'une autre exécution. Ne traitez pas non plus un fichier heapdump comme une simple capture d'écran anonyme.
Pour le premier diagnostic destiné au support, ajoutez le moment, les versions du pack ou des plugins, le nombre de joueurs actifs et l'action observée. N'ajoutez ni identifiants d'accès tiers ni export complet et incontrôlé de fichiers.
Déduire du diagnostic une modification vérifiable
Un arbre d'appels montre où du temps a été observé pendant la période mesurée. Une part élevée pour un plugin est une piste pour poursuivre la vérification, et non automatiquement la preuve que ce plugin seul est défectueux. Le guide spark sur les pics de lag aide à une lecture adaptée dans le temps.
Si de nouvelles zones de terrain sont concernées, la génération et le chargement de chunks déjà existants sont deux choses différentes. Chunky peut préparer une zone convenue, mais ne décharge pas le serveur en cours de tout travail de chunks ultérieur. Vérifiez la mémoire et la charge avant de générer une grande zone.
Si de longues pauses de ramasse-miettes sont en cause, examinez la consommation et son évolution. Elles ne prouvent pas à elles seules une fuite de mémoire ni qu'une mise à niveau suffit. Le guide RAM de Cobblemon (en) sépare les valeurs mesurées historiques des limites de l'offre et du processus.
Avant toute modification, sauvegardez l'état initial. Modifiez une seule chose justifiée et répétez la même action de jeu dans des conditions comparables. Documentez les valeurs individuelles, les fenêtres de temps et le nombre de joueurs ; une deuxième minute plus calme par hasard n'est pas une preuve d'amélioration fiable.
FAQ
20 TPS signifie-t-il que le serveur ne saccade jamais brièvement ?
Non. Une moyenne peut masquer de brèves interruptions. Vérifie les durées de tick et la période de l'observation concrète, ainsi que le client et la connexion.
Le Paper actuel a-t-il besoin d'un plugin spark supplémentaire ?
Paper intègre spark depuis la 1.21. Vérifie l'intégration existante et ses fonctions avant toute installation supplémentaire.
profiler open est-il un rapport local sans envoi ?
Il ouvre le visualiseur du diagnostic en cours. Pour une clôture explicitement locale, vérifie la voie « save to file » proposée par ton édition installée.
Le rapport est-il garanti sans aucune donnée personnelle ?
La documentation officielle des données brutes montre entre autres le nom d'utilisateur et l'identifiant dans les métadonnées. Vérifie le rapport réel avant de le partager.
Un seul ami touché prouve-t-il un problème Internet ?
C'est un indice de comparaison. Le client, la connexion et les processus côté serveur pour ce joueur doivent être examinés plus en détail à partir de l'observation concrète.
Dois-je prendre immédiatement plus de RAM en cas de lag ?
Justifie d'abord la limite de ressources. La RAM n'aide pas systématiquement contre un traitement lent des ticks, un mauvais client ou des problèmes de connexion.