Variáveis de inicialização: versão, jar e parâmetros de Java
A aba Inicialização (Startup) do painel define como o seu servidor de Minecraft é iniciado. Entender essa aba evita muitos erros — especialmente na hora de trocar de versão.
O comando de inicialização
No topo, você vê o comando usado para iniciar o servidor, algo como:
java -Xms128M -Xmx4096M -jar server.jar-Xmx— memória máxima da JVM, normalmente definida automaticamente a partir do seu plano;-Xms— memória inicial;-jar server.jar— o arquivo do servidor a ser executado.
Em geral, esse comando é controlado pelo painel e não precisa ser alterado.
Variáveis comuns
As variáveis disponíveis dependem do tipo de servidor (o "egg" configurado). Exemplos frequentes:
| Variável | Para que serve |
|---|---|
| Versão do Minecraft | Qual versão baixar/instalar (ex.: 1.21.x ou "latest") |
| Build | Build específica do Paper/Purpur |
| Arquivo do servidor (jar) | Nome do .jar executado (ex.: server.jar) |
| Versão do Bedrock | No BDS, qual versão instalar |
Algumas variáveis só têm efeito ao reinstalar o servidor (que baixa os arquivos da versão escolhida). Faça backup antes de reinstalar.
Imagem Docker / versão do Java
Cada versão do Minecraft exige uma versão mínima do Java. De forma geral:
| Minecraft | Java recomendado |
|---|---|
| Até 1.16.5 | Java 8 ou 11 |
| 1.17 | Java 16 ou superior |
| 1.18 a 1.20.4 | Java 17 |
| 1.20.5 em diante | Java 21 ou superior |
Consulte sempre o requisito da versão exata que você vai usar. No painel, a versão do Java é escolhida na opção de imagem Docker. Erros como UnsupportedClassVersionError indicam Java antigo demais para a versão do servidor.
Parâmetros de Java (flags)
Parâmetros de otimização da JVM, como as flags de Aikar, podem melhorar o desempenho do garbage collector. Dependendo da configuração do painel, eles podem ser adicionados em uma variável de argumentos extras ou já vir aplicados. Veja o post "Flags de Java (Aikar) e garbage collector explicados".
Usando um jar personalizado
Quer rodar um software específico (Purpur, Folia, um fork)?
- Envie o
.jarpara a raiz do servidor; - Altere a variável do arquivo do servidor para o nome desse jar;
- Confirme que a imagem Java é compatível;
- Reinicie e acompanhe o console.
Erros comuns
- "Unable to access jarfile" — o nome do jar na variável não corresponde ao arquivo existente;
- Servidor inicia e fecha em seguida — veja o console: versão do Java, EULA não aceita ou jar corrompido;
- Memória insuficiente — o servidor precisa de mais RAM do que o plano oferece (comum em modpacks).
Crie seu servidor com o Minecraft-BR
No Minecraft-BR da VittHost, você ajusta versão, jar e ambiente Java pela aba de inicialização do painel Pterodactyl/Pelican. Servidores no Brasil, proteção DDoS e planos para Java e Bedrock.
