Quando o Minecraft trava para um amigo, a taxa de quadros dele pode estar baixa, a conexão pode estar respondendo com atraso ou o servidor pode estar processando os passos do jogo devagar demais. O spark ajuda com o servidor em execução; ele não prova a causa de cada travada a partir de um único número. Comecem pela observação concreta durante o jogo de vocês.
Este guia reúne um diagnóstico gerenciável para um pequeno grupo MCF. Um servidor gratuito com 2 GB de RAM tem recursos limitados, mas mais RAM não é uma solução geral para qualquer atraso. Se um pack nem chega a terminar de iniciar, sigam primeiro o diagnóstico de inicialização.
Verificado: 7 de outubro de 2026. As capturas de tela mostram um teste anterior com Paper 1.21.4. Os valores delas não são um novo benchmark da MCF nem um desempenho garantido para o mundo de vocês.
Anotar a observação em conjunto
Anotem o momento, o local no jogo e a ação: alguém está voando para um terreno novo, uma farm está funcionando ou já trava só de girar a câmera? Comparem com um segundo amigo no mesmo período. "Só uma pessoa é afetada" delimita o diagnóstico, mas ainda não prova que a internet dela é a causa.
| Observação | Próxima comparação |
|---|---|
| Câmera e imagem travam | Verificar FPS do cliente, carga gráfica e dispositivo |
| Blocos reagem com atraso | Analisar juntos os ticks atuais do servidor e a conexão |
| Só um amigo é desconectado | Comparar a mensagem dele, o cliente e a conexão com uma entrada bem-sucedida |
| O servidor ainda não está rodando | Verificar o log de inicialização atual, não o profiler em execução |
A média de TPS ao longo de vários minutos pode esconder uma falha curta. Por isso, anotem o momento e observem janelas de tempo adequadas. Observem a ação normal de jogo em que o problema ocorre; uma carga extrema criada artificialmente responde a outra pergunta. Se o mundo acabou de ser carregado depois que o servidor acordou, meçam adicionalmente uma sessão em andamento mais tarde: a carga de inicialização e a carga recorrente durante o jogo são situações diferentes. Um servidor vazio serve apenas como medição de comparação e não prova que a rodada de jogo de vocês esteja fluida.
Verificar se o spark já está presente
O Paper inclui o spark desde o Minecraft 1.21. Isso é descrito na documentação de profiling do Paper. Verifiquem primeiro o comando existente e a saída de inicialização atual. Uma mensagem de erro em /version spark não prova, por si só, a falta de um plugin quando a integração é embutida.
Em outras versões de servidor, talvez vocês precisem da versão adequada do plugin ou do mod. Um plugin Bukkit não pertence a um servidor Fabric puro. Verifiquem o suporte compatível com a versão instalada do Minecraft e do loader antes de adicionar mais um arquivo.
Uma conta responsável pode receber de forma direcionada spark.tps e, se necessário, spark.profiler. A permissão ampla spark abrange mais do que a primeira comparação de números. A referência oficial de comandos lista as respectivas permissões. Amigos comuns não precisam de gerenciamento do profiler nem de acesso de proprietário MCF para relatar o problema.
Ler a duração do tick e o TPS no período certo
Executem durante o atraso observado:
/spark tps
O valor-alvo normal de 20 ticks por segundo corresponde, em termos de cálculo, a um orçamento de tempo de 50 milissegundos por tick: 1.000 ms divididos por 20. A explicação do spark sobre TPS e MSPT diferencia a taxa de ticks do tempo de tick necessário.
Além da mediana, leiam também os valores superiores e a respectiva janela de tempo. O percentil 95 descreve uma distribuição; ele não é o pior valor individual nem, sozinho, uma prova da percepção dos jogadores. Não existe um limite universal em que ninguém percebe nada até 19 TPS e, abaixo disso, todos têm a mesma experiência.
Registro anterior: nos últimos dez segundos aparecem 20 TPS, além de 2,4 ms de mediana e 4,4 ms no percentil 95. Esse teste tranquilo não diz nada sobre a farm de vocês mais tarde nem sobre outro momento de carga.
CPU do sistema e CPU do processo são informações diferentes. Limites de contêiner, número de processadores e método de medição também influenciam a interpretação. Um percentual baixo, por si só, não prova um processamento rápido o bastante da thread principal. A RAM contratada, o heap do Java e a memória total do processo também devem ser analisados separadamente.
Se necessário, fazer uma gravação limitada
Se os números ainda deixam a causa em aberto, uma conta responsável pode iniciar o profiler. Combinem uma ação de jogo normal e curta e anotem o início e o fim:
/spark profiler start
/spark profiler info
Deixem a execução incluir a falha real. Um minuto pode servir como primeiro teste próprio, mas não é uma duração mínima nem de sucesso garantida. Para falhas raras, vocês precisam de um período adequado à observação e devem encerrar a gravação de forma deliberada.
Os comandos atuais diferenciam as saídas: /spark profiler stop encerra a execução e normalmente fornece um relatório no visualizador web, cujo link vocês encontram de novo na saída do console quando o profiler termina (anotem-no junto com a situação de jogo de vocês); /spark profiler cancel a descarta sem o upload final. /spark profiler open abre um visualizador para o diagnóstico em andamento e não é uma visualização local direto no jogo.
Para obter um arquivo em vez do upload normal, a documentação atual indica:
/spark profiler stop --save-to-file
Verifiquem se a versão instalada oferece essa opção e anotem o caminho do arquivo informado. Um arquivo salvo localmente ainda não é um link de visualizador acessível publicamente. Não concedam também permissões de heapdump apenas para reunir um primeiro diagnóstico de ticks.
Demonstração de uso anterior. A mensagem visível sobre um plugin não encontrado e o profiler embutido que roda em seguida não são um diagnóstico atual da instalação do servidor de vocês.
Revisar o relatório antes de compartilhar
Um relatório do spark não está, em geral, livre de dados pessoais. A descrição oficial dos dados brutos mostra metadados com o nome e o identificador do usuário que executou. Outros conteúdos dependem do tipo de relatório, do servidor e das opções.
Revisem o relatório real antes de repassá-lo e compartilhem-no de forma direcionada com o suporte responsável. Um visualizador já aberto ou publicado não é retirado por cancelar depois outra execução. Tratem também um arquivo de heapdump como algo diferente de uma captura de tela anônima comum.
Para o primeiro diagnóstico ao suporte, acrescentem o momento, as versões do pack ou dos plugins, o número de jogadores ativos e a ação observada. Não incluam credenciais de terceiros nem uma exportação completa e descontrolada de arquivos.
Derivar do diagnóstico uma alteração verificável
Uma árvore de chamadas mostra onde foi observado tempo durante o período medido. Uma proporção alta em um plugin é um ponto de partida para novas verificações e não é automaticamente a prova de que apenas esse plugin está com defeito. O guia do spark sobre picos de lag ajuda a fazer a leitura no momento certo.
Se áreas novas do terreno estiverem envolvidas, a geração e o carregamento de chunks já existentes são coisas diferentes. O Chunky pode preparar uma área combinada, mas não tira do servidor em execução todo o trabalho de chunks posterior. Verifiquem memória e carga antes de gerar uma área grande.
Se pausas mais longas de coleta de lixo estiverem envolvidas, analisem o consumo e o histórico. Elas não provam, por si sós, um vazamento de memória nem que um upgrade resolva. O guia de RAM do Cobblemon (en) separa valores medidos históricos dos limites do plano e do processo.
Façam um backup do estado inicial antes de uma alteração. Mudem uma coisa justificada e repitam a mesma ação de jogo em condições comparáveis. Documentem valores individuais, janelas de tempo e número de jogadores; um segundo minuto casualmente mais tranquilo não é uma prova confiável de melhora.
FAQ
20 TPS significa que o servidor nunca trava por um instante?
Não. Uma média pode esconder falhas curtas. Verifique as durações de tick e o período da observação concreta, além do cliente e da conexão.
O Paper atual precisa de um plugin spark adicional?
O Paper inclui o spark desde a 1.21. Verifique a integração existente e suas funções antes de uma instalação adicional.
O profiler open é um relatório local sem upload?
Ele abre o visualizador do diagnóstico em andamento. Para um encerramento explicitamente local, verifique a opção de salvar em arquivo oferecida pela versão instalada.
O relatório garante não conter dados pessoais?
A documentação oficial dos dados brutos mostra, entre outras coisas, o nome de usuário e o identificador nos metadados. Revise o relatório real antes de compartilhar.
Só um amigo afetado prova um problema de internet?
É apenas uma pista de comparação. Cliente, conexão e processos do lado do servidor para esse jogador precisam ser verificados mais a fundo com base na observação concreta.
Devo pegar mais RAM imediatamente quando há lag?
Primeiro justifique o limite de recursos. A RAM não ajuda de forma geral contra trabalho de tick lento, um cliente inadequado ou problemas de conexão.