Erros comuns

Solução (passo a passo):

1. Confirme que o servidor está online e sem erro no console.
2. Confirme IP e porta (se não for a padrão, precisa entrar como IP:PORTA).
3. Verifique se há incidente de conectividade: Status.
4. Se estiver usando proxy (Velocity/Bungee): confirme que você está conectando no endereço correto.
5. Se o console mostrar lag extremo, trate performance primeiro (veja "Can’t keep up").

Como prevenir:

• Tenha um endereço fixo (e compartilhe sempre no mesmo formato IP:PORTA).
• Evite instalar/atualizar plugins em horário de pico sem testar.
• Monitore travamentos/lag (TPS) para não "parecer offline".

O que enviar no suporte:

• IP/porta que você está usando para conectar.
• Horário aproximado do erro.
• Trecho do console do momento (50–100 linhas finais).
• Se possível: print do erro no client + mensagem completa.

Solução:

• Adicione o jogador: /whitelist add <jogador>
• Ou desative: /whitelist off

Como prevenir:

• Mantenha uma lista de jogadores autorizados (principalmente se o servidor for privado).
• Evite alternar whitelist sem avisar o pessoal.

O que enviar no suporte:

• Se o jogador está usando o nick correto (e se mudou recentemente).
• Saída de /whitelist list (ou print do console).
• Configuração white-list=true/false (se você alterou).

Solução (passo a passo):

1. Identifique qual plugin está falhando (normalmente aparece no stacktrace).
2. Atualize o Java do servidor para o mínimo exigido ou use uma versão do plugin compatível.
3. Confirme compatibilidade: plugin ↔ versão do Minecraft/Paper.
4. Se começou após update: volte uma versão do plugin e teste.

Como prevenir:

• Sempre conferir "Supported Minecraft versions" e "Java version" do plugin antes de instalar.
• Atualize plugins em lote pequeno (1–3 por vez) para isolar culpados.

O que enviar no suporte:

• Nome e versão do plugin (arquivo .jar e versão do plugin).
• Versão do Paper/Minecraft e Java.
• Stacktrace completo do erro (não só a última linha).

Solução (passo a passo):

1. Reduza view-distance e simulation-distance.
2. Teste iniciar sem plugins (ou removendo os últimos instalados).
3. Evite tarefas pesadas em massa (geração de mundo, farms gigantes, WorldEdit, etc.).
4. Gere um diagnóstico (timings/profiler) para achar o culpado.

Como prevenir:

• Não exagere em distância de render/simulação.
• Instale plugins "pesados" só se você realmente precisa (e monitore impacto).
• Faça mudanças grandes fora do horário de pico.

O que enviar no suporte:

• Últimas 200 linhas do console.
• Lista de plugins/mods (e os últimos que você instalou).
• Print/relato de quando o lag acontece (sempre? após entrar? ao explorar?).

Solução (passo a passo):

1. Aumente a memória alocada para o servidor (RAM).
2. Reduza carga: remova/atualize os últimos plugins/mods instalados.
3. Se for modpack pesado: reduza mods ou use um plano/limite de RAM maior.
4. Se o erro aparecer após horas/dias: suspeite de plugin/mod com leak e isole.

Como prevenir:

• Não rode modpacks grandes com pouca RAM.
• Prefira versões estáveis e plugins conhecidos.
• Atualize Java/Paper/plugins com cuidado (um por vez).

O que enviar no suporte:

• Linha do erro (heap/metaspace) + stacktrace completo.
• Quanto de RAM está alocada e uso aproximado quando caiu.
• Lista de plugins/mods e versão do servidor.

Solução (passo a passo):

1. Faça backup do mundo.
2. Remova/renomeie a pasta datapacks do mundo (ou o datapack recém-adicionado).
3. Inicie em modo seguro (--safeMode) para recuperar e entrar no mundo, se aplicável.
4. Recoloque datapacks um a um até achar o que quebra.

Como prevenir:

• Teste datapacks em um mundo de teste antes do servidor "principal".
• Evite misturar datapacks antigos com versões novas do Minecraft.

O que enviar no suporte:

• Mensagem completa do erro e stacktrace.
• Versão do Minecraft e lista de datapacks/mods recentes.
• Se possível: qual datapack foi o último a ser adicionado/atualizado.