Plugin Minecraft spark

🔌 À propos de spark

spark est un profileur de performance pour les serveurs Minecraft, les clients et les logiciels de proxy. Il fournit des outils pour inspecter l'activité CPU, collecter des snapshots mémoire de base et des heap dumps, et afficher des métriques de santé du serveur (TPS, durée des ticks, utilisation CPU/mémoire/disque). Le projet est open source et conçu pour produire des résultats de profiling lisibles avec une configuration minimale.

🎯 Objectif

L'objectif principal de spark est d'aider les administrateurs de serveur et les développeurs à diagnostiquer les causes de mauvaises performances (lags, faible taux de ticks, forte utilisation CPU, rétention mémoire excessive) en produisant des profils CPU échantillonnés, des résumés mémoire, des heap dumps et des métriques de santé en continu.

⚙️ Fonctionnalités

• Profiling CPU (échantillonnage statistique) avec deux moteurs : un moteur basé sur Java ThreadMXBean et un moteur natif/async-profiler optionnel (moteur natif disponible sur Linux et macOS).
• Inspection mémoire comprenant des résumés du heap et la possibilité de produire des heap dumps HPROF complets pour une analyse externe.
• Rapports de santé du serveur : mesures du TPS, statistiques de durée des ticks, utilisation CPU et mémoire, et surveillance de l'utilisation du disque.
• Sortie de profiling lisible, conçue pour être consultée dans le composant de visualisation du projet.
• Conception légère, pensée pour être utilisable sur des serveurs de production avec une configuration minimale.

🧩 Pour qui

• Administrateurs et opérateurs de serveur qui résolvent des problèmes de performance sur des réseaux Survival, SMP, minijeux ou adossés à un proxy.
• Développeurs de plugins et de mods qui ont besoin de données de profiling précises pour les chemins de code et l'utilisation mémoire.
• Opérateurs utilisant des configurations Fabric/Forge/Spigot/Paper/Proxy qui nécessitent des diagnostics plus poussés que de simples lectures de TPS.

🏗️ Cas d'utilisation

• Capturer un court profil CPU pour identifier quel plugin, mod ou tâche du serveur consomme le plus de CPU lors des pics de lag.
• Prendre un résumé du heap ou un heap dump pour inspecter un nombre excessif d'instances ou des memory leaks.
• Surveiller en continu le TPS et la durée des ticks afin de corréler les régressions de performance avec les événements du serveur ou une charge externe.

⚙️ Installation

📥 Configuration

• Téléchargez le fichier jar du plugin/mod approprié pour votre plateforme.
• Placez le jar dans le dossier plugins/ du serveur (ou mods/plugins) pour la plateforme cible.
• Redémarrez le serveur et confirmez le chargement du plugin/mod en vérifiant la console/les logs du serveur.

(Voici les étapes d'installation standard pour les plugins de type Bukkit/Spigot/Paper et les autres plateformes prises en charge.)

🧠 Notes techniques

• Le projet fournit des composants spécifiques à chaque plateforme (Bukkit/Paper, Fabric, Forge, builds proxy, etc.).
• Le moteur natif async-profiler n'est disponible que sur Linux et macOS ; le profileur basé sur Java fonctionne sur n'importe quelle JVM mais utilise une méthode d'échantillonnage différente.
• spark peut produire des heap dumps HPROF pour une analyse externe avec les outils JVM standards.
• Le projet est publié sous licence GNU GPLv3.

🤝 Quand ce plugin est utile

Si vous avez besoin d'un profiling concret, basé sur l'échantillonnage, et d'une inspection mémoire pour identifier la cause profonde du lag ou des problèmes de mémoire sur un serveur ou un proxy Minecraft, spark fournit le profiling, l'inspection du heap et les métriques de santé nécessaires pour prendre des décisions éclairées de diagnostic et d'ajustement.