Plugin Minecraft spark

🔌 Sobre o spark

spark é um profiler de desempenho para servidores Minecraft, clientes e software de proxy. Ele fornece ferramentas para inspecionar a atividade da CPU, recolher snapshots básicos de memória e heap dumps, e reportar métricas de saúde do servidor (TPS, duração dos ticks, uso de CPU/memória/disco). O projeto é open-source e foi pensado para produzir resultados de profiling legíveis com configuração mínima.

🎯 Objetivo

O objetivo principal do spark é ajudar administradores de servidores e desenvolvedores a diagnosticar as causas de mau desempenho (lags, baixa taxa de ticks, elevado uso de CPU, retenção excessiva de memória) produzindo perfis de CPU por amostragem, resumos de memória, heap dumps e métricas contínuas de saúde.

⚙️ Funcionalidades

• Profiling de CPU (amostragem estatística) com dois motores: um motor baseado em Java ThreadMXBean e um motor nativo/async-profiler opcional (motor nativo disponível em Linux e macOS).
• Inspeção de memória, incluindo resumos de heap e a capacidade de gerar heap dumps HPROF completos para análise externa.
• Relatórios de saúde do servidor: medições de TPS, estatísticas de duração dos ticks, uso de CPU e memória, e monitorização do uso de disco.
• Saída de profiling legível, pensada para ser vista no componente de visualização do projeto.
• Design leve, pensado para ser usado em servidores de produção com configuração mínima.

🧩 Para quem é

• Administradores e operadores de servidores que estão a resolver problemas de desempenho em redes Survival, SMP, minigames ou com proxy.
• Programadores de plugins e mods que precisam de dados precisos de profiling para caminhos de código e uso de memória.
• Operadores que usam configurações Fabric/Forge/Spigot/Paper/Proxy e precisam de diagnósticos mais profundos do que simples leituras de TPS.

🏗️ Exemplos de utilização

• Capturar um perfil curto de CPU para identificar qual plugin, mod ou tarefa do servidor está a consumir mais CPU durante picos de lag.
• Obter um resumo de heap ou um heap dump para inspecionar contagens excessivas de instâncias ou memory leaks.
• Monitorizar continuamente TPS e durações dos ticks para correlacionar regressões de desempenho com eventos do servidor ou carga externa.

⚙️ Instalação

📥 Configuração

• Faça o download do ficheiro jar do plugin/mod apropriado para a sua plataforma.
• Coloque o jar na pasta plugins/ (ou mods/plugins) do servidor para a plataforma de destino.
• Reinicie o servidor e confirme que o plugin/mod foi carregado verificando a consola/logs do servidor.

(Estes são os passos de instalação padrão para plugins do tipo Bukkit/Spigot/Paper e outras plataformas suportadas.)

🧠 Notas técnicas

• O projeto fornece componentes específicos por plataforma (Bukkit/Paper, Fabric, Forge, builds de proxy, etc.).
• O motor nativo async-profiler só está disponível em Linux e macOS; o profiler baseado em Java funciona em qualquer JVM, mas usa um método de amostragem diferente.
• spark pode produzir heap dumps HPROF para análise externa com ferramentas padrão da JVM.
• O projeto é distribuído sob a licença GNU GPLv3.

🤝 Quando este plugin é útil

Se precisa de profiling concreto, baseado em amostragem, e de inspeção de memória para localizar a causa raiz de lag ou problemas de memória num servidor ou proxy Minecraft, o spark fornece o profiling, a inspeção de heap e as métricas de saúde necessárias para tomar decisões informadas de depuração e afinação.