Usando o spark para encontrar a causa do lag

Em vez de adivinhar o que causa o lag, meça. O spark é um profiler gratuito, disponível para Paper, Fabric, Forge, NeoForge e Velocity. Em versões recentes do Paper, ele já vem integrado.

Comandos rápidos

/spark tps          TPS e MSPT recentes
/spark health       TPS, MSPT, CPU, memória e disco
/spark gc           Estatísticas do garbage collector

Gravando um perfil

O profiler registra onde o servidor está gastando tempo.

/spark profiler start

Espere alguns minutos — idealmente enquanto o lag está acontecendo — e então:

/spark profiler stop

O spark gera um link para um relatório interativo no navegador.

Opções úteis

/spark profiler start --timeout 300

Para automaticamente após 300 segundos.

/spark profiler start --only-ticks-over 100

Registra apenas ticks que demoraram mais de 100 ms — ótimo para investigar picos de lag.

Lendo o relatório

O relatório mostra uma árvore de chamadas, com a porcentagem de tempo gasta em cada parte.

1. Abra a thread "Server thread" (a principal);
2. Expanda os itens com maior porcentagem;
3. Procure por nomes reconhecíveis:
   • Nome de plugin/mod (ex.: com.plugin.x) → aquele plugin está pesando;
   • tickEntities/EntityTickList → excesso de entidades;
   • tickBlockEntities → hoppers, fornalhas e outras tile entities;
   • Chunk generation / ChunkMap → geração ou carregamento de chunks;
   • Garbage collection → memória/GC.

Na parte superior, é possível alternar a visualização e buscar por termos.

Encontrando onde estão as entidades

Descobriu que o problema são entidades? Use comandos do Paper para localizar:

paper entity list
paper entity list minecraft:item

Eles mostram quantas entidades de cada tipo existem e em quais chunks estão concentradas. Aí fica fácil encontrar aquela farm com 800 galinhas.

Heap summary (memória)

/spark heapsummary

Mostra o que está ocupando memória — útil para identificar vazamentos causados por plugins ou mods.

Compartilhando

O link do relatório pode ser enviado à equipe, ao desenvolvedor de um plugin ou ao suporte. Ele não expõe senhas, mas pode revelar nomes de plugins e configurações.

Crie seu servidor com o Minecraft-BR

No Minecraft-BR da VittHost, você executa o spark pelo console do painel Pterodactyl/Pelican e resolve o lag com dados. Servidores no Brasil, proteção DDoS e planos para Java e Bedrock.