Plugin de Minecraft spark

🔌 Acerca de spark

spark es un profiler de rendimiento para servidores de Minecraft, clientes y software de proxy. Ofrece herramientas para inspeccionar la actividad de la CPU, recopilar snapshots básicos de memoria y heap dumps, y mostrar métricas de estado del servidor (TPS, duración de ticks, uso de CPU/memoria/disco). El proyecto es de código abierto y está diseñado para producir resultados de profiling legibles con una configuración mínima.

🎯 Propósito

El propósito principal de spark es ayudar a administradores de servidores y desarrolladores a diagnosticar las causas de un mal rendimiento (lags, baja tasa de ticks, alto uso de CPU, retención excesiva de memoria) mediante perfiles de CPU muestreados, resúmenes de memoria, heap dumps y métricas continuas de estado.

⚙️ Funciones

• Profiling de CPU (muestreo estadístico) con dos motores: un motor basado en Java ThreadMXBean y un motor nativo/async-profiler opcional (motor nativo disponible en Linux y macOS).
• Inspección de memoria que incluye resúmenes de heap y la capacidad de generar heap dumps HPROF completos para análisis externo.
• Informes de estado del servidor: mediciones de TPS, estadísticas de duración de ticks, uso de CPU y memoria, y monitorización del uso de disco.
• Salida de profiling legible, pensada para verse en el componente de visor del proyecto.
• Diseño ligero, pensado para poder usarse en servidores de producción con una configuración mínima.

🧩 Para quién es

• Administradores y operadores de servidores que solucionan problemas de rendimiento en redes Survival, SMP, minijuegos o con proxy.
• Desarrolladores de plugins y mods que necesitan datos precisos de profiling para rutas de código y uso de memoria.
• Operadores que ejecutan configuraciones Fabric/Forge/Spigot/Paper/Proxy y necesitan diagnósticos más profundos que simples lecturas de TPS.

🏗️ Casos de uso de ejemplo

• Capturar un perfil corto de CPU para identificar qué plugin, mod o tarea del servidor está consumiendo más CPU durante picos de lag.
• Tomar un resumen de heap o un heap dump para inspeccionar un número excesivo de instancias o memory leaks.
• Monitorizar de forma continua TPS y la duración de los ticks para correlacionar regresiones de rendimiento con eventos del servidor o carga externa.

⚙️ Instalación

📥 Configuración

• Descarga el archivo jar del plugin/mod adecuado para tu plataforma.
• Coloca el jar en la carpeta plugins/ (o mods/plugins) del servidor para la plataforma de destino.
• Reinicia el servidor y confirma que el plugin/mod se carga comprobando la consola/logs del servidor.

(Estos son los pasos de instalación estándar para plugins tipo Bukkit/Spigot/Paper y otras plataformas compatibles.)

🧠 Notas técnicas

• El proyecto ofrece componentes específicos para cada plataforma (Bukkit/Paper, Fabric, Forge, compilaciones para proxy, etc.).
• El motor nativo de async-profiler solo está disponible en Linux y macOS; el profiler basado en Java funciona en cualquier JVM, pero usa un método de muestreo distinto.
• spark puede generar heap dumps HPROF para análisis externo con herramientas estándar de JVM.
• El proyecto se publica bajo la licencia GNU GPLv3.

🤝 Cuándo es útil este plugin

Si necesitas profiling concreto basado en muestreo e inspección de memoria para localizar la causa raíz del lag o de problemas de memoria en un servidor o proxy de Minecraft, spark proporciona el profiling, la inspección de heap y las métricas de estado necesarias para tomar decisiones informadas de depuración y ajuste.