Servidor de Minecraft não inicia

Um servidor Minecraft que fecha um segundo depois de iniciado parece um mistério e quase nunca é. O servidor imprime o motivo antes de sair, no console ou em logs/latest.log, e na grande maioria dos casos essa linha aponta o problema diretamente. Este guia cobre as cinco causas por trás de quase todas as falhas na inicialização, como reconhecer cada uma pela mensagem de erro e o que mudar.

Leia o log antes de mudar qualquer coisa

Abra o logs/latest.log na pasta do servidor e role até o final. As últimas linhas, e a primeira linha do último stack trace, dizem qual das causas abaixo você tem. Chutar é o que transforma um conserto de dois minutos em uma noite inteira, porque cada conserto aqui é diferente e nenhum ajuda com os outros.

Na FluxCraft, o console e o arquivo de log ficam ambos no painel, então você pode ler o crash sem SSH nem transferência de arquivos. Se o servidor reiniciar em loop, o log da tentativa anterior fica em logs/ como um arquivo com carimbo de data e hora.

Causa 1: o EULA não foi aceito

Na primeira inicialização, o servidor gera o eula.txt, mostra um aviso sobre concordar com a licença da Mojang e sai imediatamente. Essa é de longe a razão mais comum para um servidor novo "não funcionar", e não é erro nenhum: é o servidor esperando por você.

Abra o eula.txt, troque eula=false por eula=true, salve e inicie de novo. Nada mais no arquivo importa. Se você usa uma hospedagem gerenciada, o EULA normalmente já é aceito para você na implantação, e por isso esse problema costuma atingir quem configura um servidor manualmente.

Causa 2: a versão do Java está errada

Esta é a falha que mais confunde as pessoas, porque não parece um problema de versão. O servidor exibe UnsupportedClassVersionError ou reclama de "Unsupported class file major version" e para. Isso significa que o jar foi compilado para um Java mais novo do que aquele em que você o está executando.

O requisito é um mínimo, não uma correspondência exata. Um Minecraft mais antigo roda perfeitamente em um Java mais novo. A falha só acontece no sentido contrário, um Minecraft mais novo iniciado em um Java mais antigo. Servidores com mods herdam o requisito da versão do jogo que a build do Forge, NeoForge ou Fabric deles usa.

• Confira o que você realmente tem com "java -version". Numa máquina com vários JDKs instalados, o que está no seu PATH nem sempre é o que você imagina.
• Se o erro citar a versão principal 65 e você tiver Java 17, precisa do Java 21. Instale a build LTS correspondente e aponte seu script de inicialização para ela explicitamente, em vez de depender do PATH.
• Em uma hospedagem gerenciada, isso é resolvido pela imagem, então escolher a versão certa do servidor no painel é toda a correção.

Causa 3: a memória está mal configurada, não apenas é insuficiente

Dois erros de memória diferentes fazem a inicialização falhar, e eles significam coisas opostas. "Could not reserve enough space for object heap" no início significa que você pediu mais RAM em -Xmx do que a máquina consegue fornecer, então a JVM nem chega a iniciar. Um OutOfMemoryError no meio da inicialização significa que o valor está baixo demais para o que você está carregando, o que é muito fácil de acontecer em um modpack grande.

Defina o -Xmx com um valor que a máquina realmente tenha, deixando folga para o sistema operacional e a sobrecarga da JVM, em vez de alocar cada byte. Em uma máquina de 4 GB, -Xmx3G é sensato e -Xmx4G não é. O vanilla precisa de pelo menos 2 GB; um modpack médio quer 8 GB e um pesado, 16 GB ou mais.

Uma forma comum de causar isso sozinho é copiar um script de inicialização de um tutorial feito para outra máquina. Se seu script diz -Xmx8G e sua máquina tem 4 GB, o servidor nunca vai iniciar, não importa o que mais você corrija.

Causa 4: a porta já está em uso

"FAILED TO BIND TO PORT" ou "Address already in use" significa que outra coisa está usando a porta, e, em nove de cada dez casos, essa coisa é uma instância anterior do seu próprio servidor que não foi encerrada corretamente. Procure um processo java perdido e finalize-o antes de iniciar de novo.

O outro caso é dois servidores configurados para a mesma porta. O Java Edition usa TCP 25565 por padrão e o Bedrock, UDP 19132, então, se você roda os dois numa mesma máquina, eles não colidem, mas dois servidores Java colidem. Mude o server-port no server.properties do segundo.

Em um host gerenciado, cada implantação tem sua própria porta, então essa classe de falha desaparece. É um problema de hospedagem própria.

Causa 5: um mod ou plugin está quebrando a inicialização

Se o log terminar em um stack trace que cita um arquivo em plugins/ ou mods/, você encontrou o problema. As causas habituais são um plugin feito para outra versão do Minecraft, um mod sem uma dependência ou dois mods que não convivem. O software do servidor também importa: um plugin Bukkit não roda em vanilla, e um mod Forge não roda no Fabric.

Quando o rastro não aponta nada útil, divida. Tire tudo da pasta, confirme que o servidor inicia limpo, depois devolva metade e reinicie. Quatro ou cinco rodadas assim isolam qualquer conflito, por maior que seja o pack, e são bem mais rápidas do que ler changelogs.

Depois de uma atualização de versão do Minecraft, presuma que cada plugin precisa de uma atualização correspondente. Atualizar o jar do servidor enquanto os plugins permanecem na versão antiga é a forma mais comum de um servidor que funcionava parar de iniciar.

Quando o servidor inicia mas ninguém consegue entrar

Esse é outro problema, e o log vai estar limpo. Um servidor que inicia até "Done" está rodando. Se os jogadores não conseguem chegar até ele, o problema está no endereço, no redirecionamento de porta ou no online-mode. Confira se você está passando às pessoas o endereço completo, incluindo a porta, e se a porta redirecionada corresponde ao server-port em server.properties.

Na FluxCraft, seu servidor tem um endereço público próprio em um domínio yourserver.app.runonflux.io, então não há roteador envolvido e nada para encaminhar.

Uma lista de verificação para seguir

Em ordem, porque cada passo descarta os seguintes:

• Abra logs/latest.log e leia as últimas vinte linhas. Compare com a tabela no topo desta página.
• Confirme que o eula.txt diz eula=true.
• Execute "java -version" e compare com a tabela de versões acima.
• Confira se o -Xmx no seu script de inicialização está bem abaixo da RAM física da máquina.
• Procure um processo java perdido ocupando a porta e confirme que nenhum segundo servidor a está usando.
• Se um mod ou plugin aparecer no rastro, remova-o. Se nenhum for citado, divida a pasta ao meio até achar.
• Depois de uma atualização de versão, atualize todos os plugins e mods para uma build compatível antes de culpar qualquer outra coisa.

Um servidor que inicia sempre

A versão certa do Java, o EULA aceito, a memória definida e a porta aberta por você. Escolha um nível de RAM e implante em menos de 30 segundos, com o console e os logs a um clique de distância. Primeira semana grátis.