GerenciamentoUsando o console

    Usando o console

    O console é onde você vê tudo que o servidor está fazendo em tempo real: mensagens do sistema, avisos, erros e logs de plugins/mods. Quando algo "quebra" (queda, lag, plugin não carrega, comandos não funcionam), o console quase sempre mostra o motivo.

    Console para diagnóstico

    Como identificar um erro de verdade (stacktrace)

    Nem toda mensagem em vermelho é "o erro principal". Procure por:

    • Linhas com ERROR / SEVERE.
    • Texto como Exception, Caused by ou Stacktrace.
    • Bloco de várias linhas repetidas, com caminhos de classes (ex.: at org.bukkit...).

    Exemplo (simplificado) de stacktrace:

    ERROR ... java.lang.NullPointerException at ... Caused by: ...

    Regra prática: a parte mais importante geralmente é a primeira linha da exceção + o primeiro Caused by. O resto ajuda, mas o suporte precisa pelo menos desses pontos.

    Como copiar o log do console (do jeito certo)

    Quando der problema, copie o trecho completo incluindo:

    • a linha do erro (ERROR/SEVERE)
    • a exceção (Exception)
    • o bloco de stacktrace inteiro
    • 10–30 linhas antes do erro (pra dar contexto)

    Boas práticas ao copiar:

    • Evite mandar print (imagem) se puder copiar texto.
    • Se o log for grande, mande só o trecho relevante (com contexto).
    • Se houver tokens/senhas no log (raro, mas pode ocorrer), censure antes de enviar.

    Formato recomendado para suporte:

    • cole o log em um site de paste (ex.: Pastebin/Gist), ou
    • cole no ticket usando bloco de código (```) para não quebrar a formatação.

    Check rápido: o que olhar antes de chamar suporte

    • Servidor não inicia / reinicia sozinho: procure por FAILED TO BIND, OutOfMemory,Could not load plugin, Exception in thread "main".
    • Lag / TPS baixo: procure spam de logs repetindo muito, mensagens de can’t keep up, erros em loop.
    • Plugin não funciona: procure por Could not load, NoClassDefFoundError,InvalidPluginException, erro citando o nome do plugin.
    • Comando não existe: procure por Unknown command e confirme se o plugin está carregado.

    O que mandar no suporte (pra resolver rápido)

    • O que você estava fazendo quando ocorreu.
    • Horário aproximado do erro (e fuso, se possível).
    • Trecho do console com stacktrace.
    • Versão do servidor (Paper/Spigot/Vanilla + versão, ex.: 1.20.4).
    • Lista de plugins/mods e quais foram instalados/atualizados por último.
    • Se é recorrente: "acontece sempre" ou "só às vezes", e como reproduzir.

    Comandos perigosos (evite usar sem necessidade)

    /stopDesliga o servidor.

    Risco: jogadores caem; se usado durante gravação intensa pode aumentar chance de inconsistência. Boa prática: use quando realmente quiser desligar e avise os players antes.

    /reloadTenta recarregar partes do servidor/plugins sem reiniciar.

    Riscos comuns: plugins em estado inconsistente, tarefas duplicadas, memory leak e lag depois de um tempo. Recomendação: não use. Se precisar aplicar mudanças, prefira reiniciar o servidor.

    /op <nick>Dá permissão total de administrador.

    Risco: segurança. Boa prática: use permissão por plugin (LuckPerms etc.) em vez de OP quando possível e remova OP assim que terminar (/deop <nick>).

    Outros comandos que merecem cautela

    • whitelist off (abre o servidor).
    • ban/pardon (pode causar confusão em moderação).
    • Comandos de plugins que fazem wipe/reset (geralmente têm confirmação — leia com calma).

    Boas práticas no uso do console

    • Evite spam de comandos: se um comando falhou, leia o erro antes de repetir 10x.
    • Faça mudanças em etapas: altere uma coisa por vez (config, plugin, versão).
    • Depois de instalar/atualizar plugin: sempre reinicie o servidor (não use reload).
    • Se aparecer erro em loop: pare e investigue. Erro repetindo pode causar lag e lotar disco com logs.
    • Tenha backup antes de mudanças grandes (atualização de versão, troca de muitos plugins, mudanças em mundos).

    Como usar comandos para resolver problemas

    Caso 1: "Plugin não carrega"

    • Veja no console se aparece Could not load plugin ou InvalidPluginException.
    • Copie o stacktrace.
    • Verifique se a versão do plugin é compatível com a versão do servidor.
    • Se persistir, mande ao suporte: log + versão do servidor + nome/versão do plugin.

    Caso 2: "Servidor não inicia"

    • Procure Exception in thread "main" ou FAILED TO BIND.
    • Se for porta: geralmente é conflito (servidor duplicado rodando).
    • Se for memória: procure OutOfMemory.
    • Envie log completo do boot ao suporte.

    Caso 3: "Lag do nada"

    • Veja se há erro repetindo em loop.
    • Veja mensagens de "can’t keep up".
    • Se tiver plugin citado no erro, desative/teste removendo (com backup) e reinicie.
    • Envie log do período ao suporte.

    Atenção

    Comandos executados no console têm permissão máxima. Use com cuidado!