Como verificar a saúde do seu servidor de Minecraft: TPS, tempo por tick e spark

Quando os jogadores dizem que seu servidor de Minecraft está com lag, você quer um número, não uma impressão. O card Saúde do servidor na página Visão geral mostra com que velocidade seu servidor está processando os ticks, com um gráfico das últimas horas, e um botão que analisa o servidor por um minuto e aponta os plugins ou mods que usam mais tempo.

Abra o card

Abra seu servidor no painel e vá para Visão geral. Nos servidores de Minecraft Java, o card Saúde do servidor fica abaixo de Uso. Ele mostra um veredito em palavras:

TPS e tempo por tick

O Minecraft roda o mundo em ticks e busca 20 ticks por segundo (TPS). 20 é perfeito, e abaixo de uns 18 os jogadores começam a notar lag. Cada tick tem 50 ms para terminar, então você pode ler a mesma coisa como Tempo por tick (milissegundos por tick). Acima de 50 ms por tick, o servidor fica para trás e os jogadores sentem lag. Use a chave acima do gráfico para alternar entre TPS e Tempo por tick e escolha um período: Última hora, Últimas 6 horas ou Último dia. A legenda abaixo do número principal diz qual período ele cobre e mostra o tick mais lento.

O painel envia um comando curto ao servidor uma vez por minuto enquanto o card está aberto, então o gráfico tem leituras dos momentos em que o card estava aberto. Os comandos e as respostas são gravados em logs/latest.log.

Quando o card não tem números

O card diz o motivo:

• Pausado: não tem ninguém online. O Minecraft para o mundo quando ele está vazio, então não há nada para medir.
• O servidor não está rodando. Inicie-o para ver como ele processa os ticks.
• Esta versão do Minecraft não consegue informar os tempos de tick sozinha. O card oferece Instalar o spark, um profiler gratuito do Modrinth. Um reinício vem em seguida, e a medição funciona depois dele.
• Esta versão do Minecraft não tem nenhum comando que informe os tempos de tick. O Vanilla adicionou um na 1.20.3.
• O servidor não respondeu à verificação de ticks do painel. Um plugin pode ter substituído o comando /tps. O painel tenta de novo mais tarde.
• O mundo está congelado com /tick, então não está processando ticks.
• Medindo. A primeira leitura chega em até um minuto.

Analise o lag com o spark

O TPS diz que existe lag. Uma análise diz de onde ele vem.

1. Espere o lag estar acontecendo ou peça aos jogadores que façam a coisa que o causa.
2. No card, em O que está deixando lento, clique em Analisar 60 s. Ele roda o spark por um minuto e mostra Analisando com os segundos que faltam.
3. Quando terminar, o resultado diz coisas como "Nome usou uma parte da thread principal. O próprio Minecraft usou outra parte." Ele lista Plugins e mods, O próprio Minecraft e Código mais ocupado, e o que o servidor estava fazendo durante a análise: TPS, jogadores online, entidades e chunks carregados.
4. Se um plugin ou mod for a parte mais pesada, veja o que ele está fazendo: uma tarefa agendada, um trabalho grande como a geração de mundo ou uma configuração que roda com frequência demais. Pause-o ou remova-o e analise de novo para comparar. As análises anteriores ficam listadas em Análises anteriores.

O Vanilla não consegue carregar um profiler. Paper, Fabric, Forge e NeoForge conseguem. No Paper 1.21 e mais novos, o spark já está incluído. Em versões mais antigas, adicione o plugin spark à pasta plugins e reinicie o servidor.

Compartilhe uma análise

Gerar um link do spark envia a análise para spark.lucko.me, um visualizador público e gratuito mantido pelo autor do spark. Qualquer pessoa com o link pode abri-la, então o painel pergunta antes (Gerar um link do spark? e Enviar e gerar o link). O spark deixa senhas e a seed do mundo de fora. Compartilhe o link com o autor de um plugin quando pedir ajuda. O servidor guarda os dois arquivos de análise mais novos, então compartilhe uma análise logo depois de rodá-la.

O que fazer depois

• Um servidor lento muitas vezes é um servidor com pouca memória ou com coisa demais carregada. Veja Como reduzir o lag no seu servidor de Minecraft e Quanta RAM um servidor de Minecraft precisa.
• Para ver CPU, memória e armazenamento, veja Como ler os gráficos de uso do seu servidor.
• Se a causa for uma geração pesada, veja Como pré-gerar seu mundo de Minecraft para a exploração não dar lag.

Se você analisou e o lag continua, abra um ticket e inclua o link do spark.

Quer um servidor de Minecraft que dê conta? Veja Hospedagem de servidor de Minecraft.