O spark é o profiler para servidores Minecraft. Quando o servidor começa a engasgar, o spark diz-te em segundos se a tickrate está a sofrer, que plugins ou farms estão a consumir o tempo e se o CPU ou a memória estão no limite. Este guia mostra os três comandos de que realmente precisas e como interpretar os números. As capturas de ecrã foram feitas num servidor de teste com Paper 1.21.4.
Instalação
O spark funciona como plugin em Paper e Spigot e como mod em Fabric, NeoForge e Forge. No painel, encontras o spark em Plugins → Browser. Não precisa de configuração. Os comandos devem ficar reservados ao grupo de moderação; o nó de permissão chama-se spark. Para saberes como o atribuir, consulta LuckPerms: configurar as permissões.
Primeira análise: TPS e duração dos ticks
/spark tps mostra três linhas:
(Enlarge image)- TPS (ticks por segundo) nos últimos 5 segundos, 10 segundos, 1, 5 e 15 minutos. O máximo é 20,0. A partir de cerca de 19, os jogadores ainda não notam nada; abaixo de 15, os animais movem-se aos solavancos; abaixo de 10, o servidor torna-se injogável.
- Duração dos ticks como mínimo, mediana, percentil 95 e máximo, em milissegundos. Um tick pode durar até 50 ms para se manterem as 20 TPS. Na imagem, a mediana está nos 2,4 ms, por isso o servidor tem muita margem. O valor decisivo é o percentil 95: se estiver perto dos 50 ms, surgem engasgos, mesmo que a média pareça boa.
- Utilização do CPU, separada em sistema (a máquina inteira) e processo (apenas o teu servidor). Num servidor alugado, o valor que importa é o do processo.
/spark healthreport reúne os mesmos valores, juntamente com a memória e o disco, num único relatório.
O profiler: o que está a consumir o tempo?
Quando as TPS caem, inicia o profiler:
/spark profiler start
O spark confirma o início e continua a correr em segundo plano. Deixa-o a correr durante pelo menos um minuto enquanto o problema ocorre e depois executa:
/spark profiler stop
(Enlarge image)Ao parar, o spark carrega o relatório para spark.lucko.me e devolve uma ligação. O relatório não contém nomes de jogadores, endereços IP nem mensagens de chat, apenas árvores de chamadas do processo Java. /spark profiler open abre-o ainda durante a execução e /spark profiler cancel descarta-o sem o carregar.
No relatório, expande a árvore a partir do topo. O que costumas encontrar:
- Ticks de entidades de um determinado tipo: uma farm com centenas de animais ou itens. Reduz a farm ou acalma-a com
entity-activation-rangeempaper-world-defaults.yml. - Um plugin num event listener: atualiza o plugin, verifica a configuração ou substitui-o.
- Carregamento de chunks causado por jogadores que voam depressa: reduz a distância de visão ou pré-gera o mundo com o Chunky.
- Relógios de redstone: um circuito que nunca para. Pede ao jogador que o desligue.
Garbage collection e memória
/spark gc mostra com que frequência e durante quanto tempo a recolha de lixo do Java faz pausas. Muitas pausas longas significam falta de RAM ou uma fuga de memória num plugin. /spark heapsummary lista os tipos de objetos que ocupam a memória. Antes de contratares mais RAM, vale a pena dar uma vista de olhos aqui: muitas vezes, uma atualização de um plugin resolve o problema.
Erros comuns
- TPS a 20, mas continua a haver lag. O problema está no cliente ou na rede.
/spark pingmostra a latência de cada jogador. - Esqueceste-te da ligação do profiler.
/spark profilersem argumentos mostra o estado; depois de parares o profiler, a ligação também aparece na consola do servidor. - Números sem comparação. Um valor de TPS, por si só, diz pouco. Faz uma medição com o servidor vazio para teres uma referência.
Guias relacionados
Gerar um mundo antecipadamente poupa ao servidor o carregamento de chunks: Chunky: pré-gerar o mundo. O guia Lag no servidor Minecraft: TPS e Watchdog descreve como o painel assinala TPS baixas de forma persistente.
Fontes
- Documentação do spark: https://spark.lucko.me/docs/
- Comandos: https://spark.lucko.me/docs/Command-Usage
- Ler relatórios do profiler: https://spark.lucko.me/docs/guides/Finding-lag-spikes