Um servidor Minecraft calcula o mundo em ticks, 20 vezes por segundo. Se um tick demorar demasiado ou a memória RAM se esgotar, o servidor escreve avisos no registo ou, no pior dos casos, é interrompido. Cada secção abaixo explica uma destas mensagens: como a reconheces, quão grave é e o que podes fazer. Primeiro surgem as mensagens após as quais o servidor falha ou é encerrado, depois os avisos em que continua a funcionar.

Encontras a mensagem completa na Consola ou em Ficheiros, em logs/latest.log, e os relatórios de falha na pasta crash-reports/. Lê sempre também as linhas anteriores: muitas vezes é aí que está o que abrandou o servidor. Antes de alterares ficheiros de configuração ou do mundo, cria uma cópia de segurança em Cópias de segurança.

„A single server tick took … seconds“: o watchdog encerra o servidor

Este é o aspeto da mensagem:

The server has not responded for <Seconds> seconds! Creating thread dump
A single server tick took 60.00 seconds (should be max 0.05)

O que está por trás disto: O watchdog monitoriza se o servidor ainda está a trabalhar. Se um tick, ou seja, um passo de trabalho da simulação do jogo, demorar demasiado, encerra o servidor bloqueado; o jogo deixa de estar disponível. Antes disso, o Paper escreve mensagens intermédias com um thread dump, um retrato instantâneo do trabalho em curso: se o servidor recuperar a tempo, continua a funcionar. As causas mais comuns são pressão de memória ou um plugin ou mod pesado.

Como resolver:

  1. Em Ficheiros, lê em logs/latest.log as linhas anteriores à primeira mensagem do watchdog. Verifica erros anteriores; se aparecer Stopping server, investiga também o que está a impedir o encerramento.
  2. No thread dump, observa as primeiras linhas sob Server thread. O nome de um plugin ou mod indica com o que o servidor esteve ocupado por último.
  3. Verifica a memória RAM. OutOfMemoryError: Java heap space significa que a memória do Java está esgotada; nesse caso, verifica também o que a está a ocupar.
  4. Pára o servidor antes de alterares ficheiros. Atualiza o plugin afetado em Plugins ou o mod em Mods, ou remove-o para teste, reinicia e verifica novamente.

Mais detalhes: Resolver corretamente „Can't keep up“ e o timeout do watchdog

„Java heap space“: a memória do servidor esgotou-se

Este é o aspeto da mensagem:

An unexpected error while handling a WorldEdit command … java.lang.OutOfMemoryError: Java heap space
[LuckPerms] Thread <Thread> threw an uncaught exception … java.lang.OutOfMemoryError: Java heap space
failed to handle chunk data (write) … java.lang.OutOfMemoryError: Java heap space

O que está por trás disto: o Java gere a memória do servidor numa área chamada heap, que ficou cheia para a carga atual. Ações grandes do WorldEdit, muitos chunks carregados (ou seja, secções do mundo), modpacks grandes ou plugins com muitos dados podem exigir muita memória. O servidor falha com frequência ou fica instável; guardar dados do mundo ou de entidades, como criaturas e objetos, também pode falhar. A thread ou o plugin indicado mostra onde faltou memória, não é necessariamente o maior consumidor de memória.

Como resolver:

  1. Reinicia o servidor para terminar o processo que ficou cheio. Se a carga se mantiver igual, o erro pode voltar.
  2. Determina as necessidades de memória: Planear a necessidade de RAM do Minecraft. Se o teu pacote não for suficiente, escolhe mais RAM em Definições e subscrição → Plano.
  3. Divide as ações grandes do WorldEdit e, se necessário, reduz view-distance em server.properties, em Ficheiros.
  4. Depois de reiniciares, verifica a Consola e as zonas do mundo afetadas. Em caso de mensagens sobre chunk data (write), confirma sobretudo se o último estado foi guardado.

Bom saber: uma cópia de segurança antes da próxima grande alteração ao mundo ajuda a recuperar alterações perdidas.

«This crash report has been saved to …»: servidor crashou

É assim que a mensagem aparece:

This crash report has been saved to: crash-reports/crash-<Date>_<Time of day>-server.txt

O que está por trás: O servidor foi terminado por um erro grave e escreveu um relatório de falha. A mensagem em si só indica onde esse relatório se encontra. A causa real, por exemplo um mod, um plugin, o mundo ou falta de memória RAM, está no ficheiro.

Como resolver:

  1. Em Ficheiros, abre a pasta crash-reports/ e, dentro dela, o ficheiro indicado. O nome contém a data e a hora da falha.
  2. Lê a primeira secção: depois de Description: surge uma breve descrição, abaixo a linha do erro e o stacktrace, ou seja, a lista dos pontos do programa que levaram ao erro.
  3. Verifica se os mods ou plugins mencionados no erro têm versões compatíveis. Atualiza o afetado em Mods ou Plugins, ou remove-o para teste depois de fazeres uma cópia de segurança.
  4. Em caso de OutOfMemoryError, lê o complemento da mensagem. Se indicar Java heap space, a memória Java está cheia; se tiveres contratado pouca RAM, escolhe mais RAM em Definições e subscrição → Plano.
  5. Inicia o servidor e acompanha a Consola até ele estar totalmente a funcionar.

Bom saber: Guarda o relatório para a deteção de erros e compara a data e a hora com a falha atual. Para servidores com mods: Erros de mods em servidores Forge, NeoForge e Fabric

Erro no ciclo principal do jogo

Este é o aspeto da mensagem:

Exception in server tick loop
Caused by: java.lang.<ErrorType>: <Details>

O que está por trás disto: O ciclo principal calcula o mundo tick a tick. Uma exceção, ou seja, um erro de programa, chegou até este ciclo e perturbou-o. Nesse caso, o servidor costuma falhar e escreve um relatório de falha. A verdadeira causa está quase sempre na linha Caused by imediatamente a seguir.

Como resolver:

  1. Procura a mensagem em logs/latest.log ou no relatório mais recente em crash-reports/.
  2. Lê a linha Caused by logo por baixo. Se houver várias, a última costuma levar à raiz do problema.
  3. As linhas com at … por baixo indicam nomes de pacotes e de ficheiros. Assim reconheces o plugin ou o mod envolvido.
  4. Atualiza-o ou remove-o em Plugins ou Mods e reinicia o servidor.

Bom saber: Esta mensagem não é um problema de lag, mas um erro concreto. Mais memória RAM só ajuda se a linha Caused by indicar um OutOfMemoryError.

Mais detalhes: Resolver corretamente o „Can't keep up“ e o Watchdog Timeout

Memória no limite: GC overhead limit exceeded

Este é o aspeto da mensagem:

java.lang.OutOfMemoryError: GC overhead limit exceeded

O que está por trás disto: O Java limpa automaticamente a memória que já não é necessária. A isto chama-se Garbage Collection, abreviadamente GC. Esta mensagem significa: o Java passa quase todo o tempo a limpar e recupera cada vez menos memória. O heap, isto é, a memória RAM do Java, está praticamente cheio. O servidor quase não responde ou falha.

Como resolver:

  1. Reinicia o servidor.
  2. Calcula quanta memória RAM a tua configuração precisa. Mais detalhes: Planear a memória RAM necessária para Minecraft
  3. Se o teu pacote não chegar, escolhe mais RAM em Definições e subscrição → Plano.
  4. Reduz a carga de chunks e entidades: diminui a distância de visão view-distance no server.properties, reduz as grandes quintas de animais e limpa os itens espalhados pelo chão.

Bom saber: Um reinício só dá algum alívio. Se o consumo voltar a subir de forma constante até ao limite após cada reinício, apesar de a carga se manter igual, também pode ser um plugin ou mod a reter memória.

Não é possível criar mais threads: unable to create native thread

Este é o aspeto da mensagem:

java.lang.OutOfMemoryError: unable to create native thread

O que está por trás disto: Uma thread é um fio de execução paralelo. O Java quis iniciar mais uma e não conseguiu. Apesar de OutOfMemoryError constar no nome, isto não é prova de um heap do Java cheio. Normalmente, há demasiadas threads em simultâneo, foi atingido um limite de processos ou falta memória fora do heap. O servidor deixa então de conseguir iniciar novas tarefas e fica instável. Esta linha não revela qual plugin ou mod cria as threads.

Como resolver:

  1. Não contrates mais RAM de forma generalizada. Mais memória para o Java não resolve esta mensagem automaticamente.
  2. Em logs/latest.log, lê as linhas anteriores à mensagem: o que estava a decorrer na altura do erro, que plugins se manifestaram com mais frequência?
  3. Comprova o responsável durante a execução. Com spark profiler start --thread * na Consola, vês todas as threads em execução. Os nomes delas revelam muitas vezes o plugin ou o mod.
  4. Só quando um responsável estiver comprovado é que o atualizas em Plugins ou Mods, verificas as suas definições ou o removes.

Se não conseguires avançar, abre um ticket e indica a hora da mensagem. Sobre o spark: spark: encontrar e compreender o lag

“Can't keep up”: Server ticks are falling behind

What the message looks like:

Can't keep up! Is the server overloaded? Running <Time>ms or <Ticks> ticks behind
Can't keep up! Did the system time change, or is the server overloaded? Running <Time>ms behind, skipping <Ticks> tick(s)

What's behind it: Minecraft normally runs 20 ticks per second, giving each tick a time budget of 50 milliseconds. If these processing steps take too long, a backlog builds up, reported in milliseconds and ticks. The server keeps running but noticeably slower: mined blocks reappear and mobs stutter. Memory or CPU pressure is usually responsible; isolated messages can occur during startup or terrain generation.

How to fix it:

  1. Check whether spark is available. Current Paper versions include it; on other supported servers, install the matching plugin or mod release.
  2. Run spark tps in the Console during the lag. MSPT means milliseconds per tick: if ticks consistently exceed their time budget, the tick rate drops.
  3. Find the cause with spark profiler start --timeout 120 and open the link returned afterwards.
  4. With the server stopped, lower view-distance and simulation-distance in server.properties. Reduce large farms or pregenerate the world.
  5. Check whether memory is sufficient, and restart after configuration changes.

In detail: Properly fixing "Can't keep up" and watchdog timeouts

„DO NOT REPORT THIS TO PAPER“: diagnóstico quando o servidor bloqueia

Este é o aspeto da mensagem:

--- DO NOT REPORT THIS TO PAPER - THIS IS NOT A BUG OR A CRASH ---
Server thread dump (Look for plugins here before reporting to Paper!):

O que está por trás disto: Se a thread do servidor bloquear durante alguns segundos, o Paper escreve um diagnóstico com um thread dump, ou seja, um retrato instantâneo daquilo em que o servidor está a trabalhar. Entretanto, o jogo fica parado; depois do bloqueio, o servidor pode continuar a funcionar. Se o bloqueio durar demasiado, o watchdog encerra-o.

Como resolver:

  1. No dump, lê as primeiras linhas sob Server thread dump. Se aparecer o nome de um plugin ou mod, é um forte indício do responsável.
  2. Pára o servidor, atualiza o plugin afetado em Plugins ou o mod em Mods, ou remove-o para teste, e reinicia.
  3. Se os dumps se acumularem, verifica a memória RAM, os teus plugins e a distância de visão view-distance no server.properties.
  4. Podes observar dumps isolados, por exemplo ao arrancar ou ao guardar um mundo grande, em vez de intervir de imediato.

Mais detalhes: Resolver corretamente „Can't keep up“ e o timeout do watchdog

„ChunkTaskScheduler“: o Paper está à espera do carregamento ou da geração de um chunk

Este é o aspeto da mensagem:

[ChunkTaskScheduler] Chunk wait task info below:
[ChunkTaskScheduler] Chunk holder: NewChunkHolder{world=<Mundo>, chunkX=<x>, chunkZ=<z>, …, currentGenStatus=minecraft:initialize_light, requestedGenStatus=minecraft:full, …}

O que está por trás disto: O Paper esperou mais tempo do que o previsto pelo carregamento ou pela geração de um chunk, ou seja, uma secção do mundo de 16 × 16 blocos, e escreveu um diagnóstico. Nesse momento, o servidor engasga. currentGenStatus mostra o estado atingido e requestedGenStatus o objetivo. Normalmente, a causa é sobrecarga: geração do mundo, muitos jogadores afastados uns dos outros ou plugins lentos. Mais raramente, uma região está danificada.

Como resolver:

  1. Em Ficheiros, reduz a distância de visão view-distance em server.properties e reinicia o servidor.
  2. Gera o mundo previamente: Chunky: pré-gerar o mundo de Minecraft.
  3. Se o spark estiver disponível, analisa a carga durante a falha com spark profiler start --timeout 120 na Consola. O relatório mostra quais os processos que consomem tempo.
  4. Se o problema afetar repetidamente o mesmo mundo e as mesmas coordenadas de chunk, verifica as linhas de registo à volta em busca de erros de carregamento dessa região. Se a danificação for confirmada, pára o servidor, guarda o estado atual e restaura uma cópia de segurança intacta em Cópias de segurança. As alterações feitas desde essa cópia de segurança perdem-se.

Bom saber: Coordenadas muito grandes indicam viagens longas, muito afastadas do centro do mundo. Um limite de mundo adequado restringe uma exploração adicional.

„The server has stopped responding“: o Paper Watchdog reporta um bloqueio

Este é o aspeto da mensagem:

The server has stopped responding! This is (probably) not a Paper bug.
If you see a world save or edit, then it means you did far more than your server can handle at once
If this is the case, consider increasing timeout-time in spigot.yml but note that this will replace the crash with LARGE lag spikes

O que está por trás disto: estas linhas fazem parte do bloco de aviso do Paper Watchdog, que deteta uma thread principal bloqueada durante muito tempo, ou seja, a thread responsável pelo decorrer do jogo. Durante o bloqueio, o jogo fica parado; se o bloqueio persistir, o Watchdog termina o servidor. As causas típicas são plugins sobrecarregados, grandes operações no mundo ou acessos HTTP e à base de dados que bloqueiam. O thread dump abaixo mostra as chamadas de programa que estavam a ser executadas.

Como resolver:

  1. Lê o thread dump em logs/latest.log, em Ficheiros. Verifica se os plugins mencionados têm atualizações; ajusta a respetiva configuração ou remove-os para teste com o servidor parado.
  2. Se mostrar edição do mundo ou gravação, divide as ações grandes, por exemplo com o WorldEdit, em passos mais pequenos.
  3. Se mostrar acessos HTTP ou MySQL, verifica no plugin envolvido a ligação e a acessibilidade do serviço.
  4. Aumentar timeout-time em spigot.yml prolonga o tempo de espera, mas não resolve o bloqueio.
  5. Em caso de bloqueios repetidos, reduz a carga dos plugins e verifica a memória.

Mais detalhes: Resolver corretamente o „Can't keep up“ e o timeout do Watchdog

A tarefa de chunks do Paper falha com BootstrapMethodError

Assim aparece a mensagem:

[ca.spottedleaf.concurrentutil.executor.thread.BalancedPrioritisedThreadPool] Exception thrown from thread <Thread>
java.lang.BootstrapMethodError: bootstrap method initialization exception

O que está por trás: O Paper carrega e gera chunks em threads próprias, ou seja, linhas de execução paralelas ao jogo principal. Numa delas, o Java não conseguiu preparar um ponto de chamada no programa. Os motivos possíveis são um erro no Paper, uma extensão incompatível ou uma versão de Java não suportada. A mensagem, por si só, não aponta nenhuma destas causas.

Como resolver:

  1. Atualiza o Paper em Versão para uma build estável atual da tua versão de Minecraft.
  2. Usa uma versão de Java suportada por essa build: Que versão de Java precisa o teu servidor de Minecraft?
  3. Lê o stacktrace completo em logs/latest.log. Se uma linha Caused by indicar um plugin, atualiza-o em Plugins.
  4. Não substituas bibliotecas do servidor manualmente. Isso tende a causar novos erros.
  5. Se o erro se repetir após a atualização, comunica o stacktrace completo ao projeto Paper.

O Minecraft não consegue guardar o relatório de falha

Este é o aspeto da mensagem:

We were unable to save this crash report to disk.

O que está por trás disto: A mensagem diz respeito à escrita do relatório de falha. Depois de um erro, o Minecraft tentou guardar o diagnóstico no disco e não conseguiu gravar o ficheiro do relatório. A causa do erro original aparece antes na Consola; a falta do relatório dificulta a análise posterior do problema.

Como resolver:

  1. Começa por guardar o bloco de erro completo da Consola, incluindo as linhas anteriores a esta mensagem.
  2. Em Ficheiros, verifica os ficheiros existentes em crash-reports/ e também logs/latest.log. Lê a mensagem concreta do erro de escrita e verifica o espaço de armazenamento disponível.
  3. Corrige a causa indicada aí. Se o caminho continuar sem permitir escrita, abre um ticket e indica a hora e o erro de escrita.

A tua mensagem não está aqui?

Lê a mensagem completa em logs/latest.log e, sobretudo, as linhas anteriores: a sobrecarga quase sempre tem um desencadeador que aparece antes do primeiro aviso. No stacktrace ou no thread dump, os nomes de pacotes, ou seja, os nomes de pastas separados por pontos, como com.<Entwickler>.<Plugin>, e os nomes de ficheiros, como <Plugin>.jar, revelam qual o plugin ou mod envolvido. Antes de alterares ficheiros de configuração, cria uma cópia de segurança em Cópias de segurança. Se não conseguires avançar, abre um ticket e indica a hora da mensagem.