O arquivo latest.log registra mensagens recentes do servidor, enquanto crash reports guardam contexto adicional de falhas fatais quando criados. Stack trace pode parecer longo, mas costuma começar com tipo e mensagem da exceção. Encontrar a primeira causa e o horário ajuda a separar raiz do problema de erros que aparecem como consequência.

Este método usa registros para decidir o próximo teste, sem apagar arquivos ou mudar várias configurações. Paper recomenda parar o servidor e fazer backup antes de diagnosticar casos que exigem edição; uma alteração errada pode corromper dados ou esconder a causa original.

Preserve o arquivo completo e o horário

Baixe logs/latest.log e o crash report correspondente ao incidente, se houver. Identifique a data, fuso horário do painel e versão de Paper e Java. O arquivo “latest” muda na próxima inicialização, então arquive uma cópia antes de reiniciar ou reproduzir.

Guarde log anterior se o problema acontece depois de várias sessões. Logs rotacionados podem estar comprimidos, e mensagens antes da falha mostram o que carregou ou qual tarefa começou. Não envie somente as cinco últimas linhas sem verificar o começo da sequência de erro.

Encontre o primeiro evento relevante

Procure linhas ERROR, exceção e a primeira referência ao plugin, mundo ou recurso envolvido. Anote o evento anterior imediato e a hora. Um servidor pode escrever muitas exceções secundárias após a primeira falha; corrija a primeira causa provável e então reproduza para confirmar.

Uma linha ERROR sozinha não explica gravidade. Pode ser ação que falhou sem interromper servidor, ou pode preceder shutdown. Observe se Paper continuou a inicialização, se o jogador foi desconectado e se há crash report. Procure evidência de persistência e escopo antes de classificar incidente.

Leia uma stack trace em camadas

O começo normalmente traz classe da exceção e mensagem; linhas iniciadas por at formam caminhos de chamada. Leia algumas primeiras linhas e identifique referências a plugin, Paper ou Java. Uma biblioteca pode aparecer porque o plugin a chamou, não necessariamente porque biblioteca tem defeito.

Olhe também para a linha “Caused by”, que pode revelar exceção original encadeada. Nomes de classes e método devem ser comparados com versão instalada e documentação. Se o stack trace se repete em diferentes horas com mesma origem, isso é evidência para um teste mais direcionado.

Diferencie startup, runtime e watchdog

Erro durante startup pode envolver JAR ausente, versão de Java, dependência ou arquivo de configuração. Erro durante jogo pode depender de ação, mundo ou plugin. Um aviso do watchdog com stack dump significa que o tick ficou lento; a própria mensagem pode dizer que não é necessariamente crash ou bug do Paper. Use o instante e a stack do thread principal para investigar a atividade travada.

Se servidor não inicia, confira a mensagem inicial do Paper e o arquivo de inicialização. Verifique nome de JAR, versão de Java e argumentos. Se console não gera log, o processo talvez nem tenha iniciado ou o painel redireciona saída para outro local.

Quando não há log da queda

Encerramento sem stack trace pode indicar que o sistema matou o processo, limite da hospedagem, falta de memória do container, pane de host ou interrupção externa. Compare horário do painel, eventos de monitoramento e uso máximo de recursos. Não aumente Xmx automaticamente: se já ocupa quase toda a cota, maior heap pode agravar a terminação.

Peça ao provedor o motivo registrado no host quando você não tem acesso a métricas de sistema. Envie o período e identificador do servidor, não credenciais. Um processo terminado por OOM killer requer evidência do sistema, não apenas interpretação do último log Minecraft.

Reduza dados sensíveis antes de compartilhar

Logs podem conter endereço IP, nomes de usuário, caminho de instalação, mensagens privadas ou segredos de plugin. Revise o arquivo e remova tokens e credenciais antes de publicar em canal aberto. Preserve a cópia original em armazenamento restrito se precisar para auditoria.

Ao pedir suporte, inclua trecho desde o primeiro erro, parte relevante do stack trace, versões, passos de reprodução e expectativa. Não edite mensagens técnicas de forma que altere a sequência; indique claramente trechos removidos por privacidade. Assim, quem ajuda consegue relacionar causa e contexto.

Teste a hipótese em cópia

Se log aponta para plugin ou configuração, faça backup, crie ambiente isolado e tente reproduzir com dados seguros. Mude uma variável por vez. Atualize versão compatível ou compare configuração conforme documentação. Desabilitar dezenas de plugins em produção pode gerar perda de funções e comprometer dados salvos.

Para lentidão durante um evento, capture perfil Spark enquanto o problema ocorre. Uma stack trace de watchdog é instantânea; profiler acumula amostras durante período. Juntas, as duas evidências podem mostrar se a lentidão é contínua, mas respondem perguntas diferentes.

Transforme o diagnóstico em registro operacional

Documente primeira causa suspeita, evidência, teste, resultado e ação de rollback. Se uma atualização remove o erro, mantenha versão que resolveu e notas da combinação. Se nenhuma hipótese se confirma, recolha mais contexto em vez de declarar que reiniciar solucionou.

Use as recomendações do Paper para diagnóstico de problemas e stack traces, consulte o mapa de arquivos e logs e capture um perfil Spark durante problemas de performance. Proteja logs antes de compartilhá-los e pare o servidor antes de editar arquivos.

Correlacione mensagens repetidas

Quando uma exceção aparece repetidamente, conte frequência e intervalo e compare com uptime, comando e região. Algumas mensagens são consequência repetida da mesma tarefa; outras pertencem a jogadores diferentes. Juntar várias ocorrências numa só pode ocultar que o padrão muda após uma atualização ou ao entrar num mundo específico.

Procure identificador de thread, data, mundo e nome de plugin ao redor da ocorrência. Preserve linhas anteriores e posteriores na mesma sessão. Se erro só aparece durante startup, investigue carregamento; se aparece depois de ação de jogador, tente reprodução mínima com conta de teste e mundo isolado.

Compartilhe a evidência sem perder contexto

Monte um recorte contínuo que inclua início da exceção, linhas de chamada e evento que a precedeu. Não corte o topo por parecer genérico: ali estão a mensagem e o tipo do erro. Acrescente duas frases com cenário e versões, e marque como removido qualquer trecho privado; isso permite que mantenedores comparem a mesma execução.

Fontes e referências

Documentação consultada em 2026-10-08. Os exemplos precisam ser conferidos na versão instalada; este guia não afirma que a configuração foi testada no seu ambiente.