Porque o meu servidor de Minecraft não arranca? Ler o erro e resolvê-lo

Quando um servidor falha ao iniciar, o painel mostra-o como Crashed ou Ran out of memory em vez de o deixar preso em "Starting". O motivo está sempre escrito no log do servidor — a parte difícil é saber onde olhar e o que a mensagem significa. Este guia cobre ambos. Quase todos os crashes de inicialização resultam de uma das poucas causas possíveis, e quase todos podem ser resolvidos removendo ou substituindo um único ficheiro.

Onde encontrar o erro

• O separador Console mostra o registo do servidor ao iniciar, por isso um crash durante o arranque é visível lá.
• O `logs/latest.log` no separador Files é o mesmo log guardado como ficheiro. Permanece lá após o servidor parar, permitindo que o leia ao seu ritmo. Execuções antigas são mantidas na mesma pasta como ficheiros .log.gz datados.
• A pasta `crash-reports` no separador Files. Quando o próprio Minecraft falha, escreve um relatório completo aqui, com uma descrição em linguagem simples perto do topo.

Como ler um erro de Java

Os crashes do Minecraft vêm com "stack traces" longos — dezenas de linhas começando com at …. Pode ignorar quase tudo isso. O que precisa é:

1. A primeira linha que contenha ERROR, Exception ou FATAL durante o arranque. Erros mais abaixo são geralmente consequências do primeiro.
2. Qualquer linha que comece com `Caused by:` — a última num bloco é normalmente a causa real.
3. Qualquer nome de mod ou plugin nessas linhas. O ID de um mod (por exemplo create ou jei) ou o nome de um ficheiro .jar indica quem é o responsável.

Depois, compare o que encontrou com as causas abaixo.

Ran out of memory (Falta de memória)

Mensagens: java.lang.OutOfMemoryError: Java heap space, ou o estado do painel Ran out of memory.

O servidor precisava de mais do que os 3 GB que um servidor gratuito tem. Isto é comum com modpacks grandes e não pode ser resolvido com ajustes — um pack de 300 mods simplesmente precisa de mais memória. Remova mods que não utiliza, escolha um pack mais leve ou mude para um servidor pago com mais memória. Quanto RAM um servidor de Minecraft precisa? mostra o que é adequado.

Um mod apenas para cliente no servidor

Mensagem: Attempted to load class … for invalid dist DEDICATED_SERVER, frequentemente identificando uma classe de um mod de renderização, shader, minimap ou menu.

Alguns mods só fazem sentido no computador do jogador — alteram gráficos, som ou menus — e causam crash num servidor que tenta carregá-los. Encontre o mod nomeado perto do erro e apague o seu .jar da pasta mods. Quando instala um modpack do CurseForge, o Cobbly já remove mods conhecidos apenas para clientes e tenta novamente automaticamente quando deteta este erro, pelo que normalmente só encontrará este problema com mods que adicionou manualmente.

Uma dependência em falta

Mensagens: Missing or unsupported mandatory dependencies, requires … which is missing, ou Unknown dependency.

Muitos mods e plugins precisam de outro — uma biblioteca — para funcionar. O erro indica ambos: o mod que falhou e o que ele necessita. Instale o que falta, garantindo que coincide com a sua versão do Minecraft. O caso mais comum é um mod Fabric sem Fabric API. No Paper, é frequentemente o Vault ou ProtocolLib.

Um mod ou plugin para uma versão diferente

Mensagens: Incompatible mod set, requires minecraft …, Mod … is incompatible with loaded version, Unsupported class file major version, ou has been compiled by a more recent version of the Java Runtime.

Os mods são criados para uma versão exata do Minecraft e para um loader específico. Um mod 1.20.1 não carregará em 1.21, e um mod Fabric não carregará em Forge. Verifique o ficheiro que instalou face à versão do servidor no separador Software e descarregue a versão correspondente. As mensagens Java significam a mesma coisa disfarçadas: o Cobbly executa a versão de Java que a sua versão do Minecraft exige, pelo que um mod a pedir uma versão de Java diferente foi construído para uma versão diferente de Minecraft.

Dois mods em conflito

Mensagens: Mixin apply failed, MixinApplyError, ou InvalidInjectionException, geralmente nomeando dois mods.

Os mods modificam o código do Minecraft e, ocasionalmente, dois tentam modificar a mesma coisa de formas incompatíveis. Se o erro mencionar dois mods, remova o que adicionou mais recentemente e comece de novo. Se adicionou vários de uma só vez, remova metade, teste e isole o problema a partir daí. Uma atualização em qualquer um dos mods costuma resolver o problema.

Mods duplicados

Mensagem: Found duplicate mods ou Duplicate mod ID.

Dois ficheiros .jar do mesmo mod, frequentemente duas versões diferentes após uma atualização. Abra a pasta mods e apague a versão mais antiga.

Um mundo ou ficheiro de configuração corrompido

Mensagens: erros a mencionar level.dat, Failed to load level, ou um erro de parsing nomeando um ficheiro em config/.

Um ficheiro de configuração com um erro de digitação, ou um mundo que não foi guardado corretamente, pode impedir a inicialização. Um erro de configuração indica o seu ficheiro — reverta a sua última alteração ou apague-o para que o mod escreva um novo padrão. Para erros de mundo, restaure a última cópia válida no separador Backups (veja Como funcionam os backups).

O servidor crasha mais tarde, não no arranque

Mensagem: A single server tick took 60.00 seconds (should be max 0.05).

Isto é o watchdog do Minecraft a desligar o servidor porque este ficou congelado durante um minuto completo. Algo estava a exigir demasiado processamento — uma quinta gigante ou máquina de redstone, milhares de itens no chão, ou um mod preso num loop. O relatório de crash lista o que o servidor estava a processar. Porque é que o meu servidor de Minecraft está com lag? aborda os culpados habituais.

A solução: remover um ficheiro

Para cada causa acima, a solução envolve os mesmos passos simples:

1. Certifique-se de que o servidor está parado.
2. Abra o separador Files e vá a mods (ou plugins em Paper e Purpur).
3. Apague, ou substitua pela versão correta, o .jar que o erro identificou.
4. Pressione Start e observe o separador Console até ver a linha que começa com Done (.

Se o erro não mencionar nada que reconheça, a página de suporte lista as formas de nos contactar. Inclua as primeiras ERROR e as últimas Caused by: linhas — isso costuma ser suficiente para identificarmos a solução.