No Minecraft: Java Edition, escolha o Java de acordo com a versão exata do Minecraft e o software do servidor, não apenas o Java mais recente do computador. O Vanilla 1.20.5–1.21.11 usa Java 21; as versões 26.1–26.3 usam Java 25. Versões antigas têm outros requisitos, e o Paper ou um modpack podem alterar a escolha prática.
Verificado em 8 de novembro de 2026: o manifesto oficial de versões da Mojang identifica 26.3 como a versão estável mais recente. Snapshots não entram nessa classificação. Este guia abrange clientes e servidores dedicados da Java Edition, não a Bedrock Edition.
Mínimo histórico, ambiente do launcher e recomendação são diferentes
O mínimo histórico indica a geração do Java exigida por uma versão Vanilla original. O ambiente do launcher é a instalação de Java selecionada hoje por um inicializador. Uma recomendação é o ambiente aconselhado pelo projeto do servidor ou responsável pelo pack para uma compilação específica. Esses números podem ser diferentes sem contradição.
A distinção importa sobretudo no Minecraft antigo. Os metadados mantidos pela Mojang atribuem Java 8 a várias versões muito anteriores; isso não prova que Java 8 era o mínimo original. Da mesma forma, uma recomendação de Java 21 pelo Paper não o transforma no requisito Vanilla original de todas as versões daquela faixa.
Use a coluna histórica para compreender a compatibilidade, não como instrução para instalar um ambiente obsoleto. Em uma instalação real, siga a documentação do servidor, carregador e plugins exatos e escolha uma distribuição Java mantida quando esses programas a suportarem.
Tabela de compatibilidade entre Minecraft e Java para Vanilla
As linhas antigas descrevem os requisitos da época de lançamento; as mais novas mostram a geração necessária e o ponto de partida habitual. Não garantem que todo jogo antigo funcione com qualquer JVM mais recente.
| Minecraft Java Edition | Mínimo histórico / geração necessária | Ponto de partida prático |
|---|---|---|
| 1.4.x–1.5.2 | Java 5 | Use um perfil legado dedicado; os metadados atuais da Mojang para 1.4.7 e 1.5.2 selecionam Java 8. Verifique toda a combinação de software. |
| 1.6.1–1.11.2, incluindo 1.7.10 e 1.8.x | Java 6 | Java 8 é uma base legada comum e consta nos metadados de 1.8.9; forks e mods podem exigir mais. |
| 1.12–1.16.5 | Java 8 | Java 8 para Vanilla; consulte recomendações da implementação antes de mudar. |
| 1.17–1.17.1 | Java 16 | Siga o ambiente do launcher ou os requisitos do servidor exato; a recomendação do Paper difere abaixo. |
| 1.18–1.20.4 | Java 17 | Java 17 para Vanilla; não estenda esta linha à versão 1.20.5. |
| 1.20.5–1.21.11 | Java 21 | Java 21; a versão 1.20.5 também passou a exigir sistema operacional de 64 bits. |
| 26.1–26.3 | Java 25 | Java 25; 26.3 é a versão estável mais recente verificada neste guia. |
Para as primeiras transições, a Minecraft Wiki registra Java 5 para 1.4.7, Java 6 para 1.6.1 e Java 6 para 1.8. A inspeção de JARs oficiais representativos do servidor confirma as gerações de bytecode, mas não equivale a um teste de jogo nem de compatibilidade completa do ambiente.
Nas versões recentes, os arquivos JSON vinculados no manifesto da Mojang indicam Java 8 para 1.12 e 1.16.5, Java 16 para 1.17, Java 17 para 1.18 e 1.20.4, Java 21 para 1.20.5 e 1.21.11 e Java 25 para 26.1 e 26.3. As notas de lançamento de 1.20.5 e as notas de 26.1 anunciam explicitamente as respectivas alterações de requisitos.
Minecraft 1.4 precisa de Java 7? E 1.8 precisa de Java 8?
Nenhuma afirmação descreve corretamente o mínimo original do Vanilla. Para 1.4, Java 7 não é o limite histórico: a referência de 1.4.7 indica Java 5. Para 1.8, o requisito inicial é Java 6, não Java 8.
Ainda assim, “use Java 8 em um servidor antigo 1.8” pode ser um conselho adequado a uma implementação específica. Os metadados atuais do launcher da Mojang usam Java 8 para 1.8.9, enquanto o Paper recomenda Java 8 para 1.7.10–1.11. Um plugin compilado para Java 8 também pode elevar o mínimo efetivo, mesmo que o jogo original não o exigisse.
Não transforme esses números históricos em instruções para baixar Java 5, 6 ou 7. São gerações obsoletas. Java 8 também é uma base legada: a manutenção de segurança depende da distribuição e do canal de atualizações, não apenas do número “8”. Uma JVM mais nova não corrige sozinha vulnerabilidades de um servidor antigo ou de suas bibliotecas. Mantenha instâncias legadas separadas e revise suas correções de segurança antes de expô-las publicamente.
O Paper tem recomendações próprias
A documentação inicial do Paper apresenta atualmente esta tabela de versões recomendadas, não de mínimos universais do Vanilla:
| Versão do Paper | Java recomendado |
|---|---|
| 1.7.10–1.11 | 8 |
| 1.12–1.16.4 | 11 |
| 1.16.5 | 16 |
| 1.17–1.19 | 17 |
| 1.20–1.21.11 | 21 |
| 26.1+ | 25 |
A versão atual exige pelo menos Java 25. Leia essa informação junto da tabela por versão, não como uma ordem para migrar toda compilação arquivada do Paper para Java 25. Um ambiente recomendado também não significa que uma ramificação antiga continue recebendo correções. Outros forks e cada plugin têm políticas de suporte próprias.
Modpacks, Forge, NeoForge e Fabric: verifique separadamente
Para um servidor com mods, comece pela versão exata do pack, depois pela versão do carregador e pelas instruções de instalação. A tabela Vanilla oferece contexto, mas não substitui os requisitos do pack. Carregadores antigos podem depender de comportamentos alterados em Java posterior; mods novos podem exigir bytecode mais recente que o jogo base.
Use a documentação dos projetos, como o guia de instalação de Java do Fabric e o guia do usuário do NeoForge, verificando a versão de Minecraft ou da documentação selecionada. Não extrapole uma linha “latest” para uma nova geração de Minecraft. Registre juntos pack, carregador, distribuição Java e versão principal para outro administrador reproduzir a instalação.
Confira o Java que realmente inicia o servidor
Antes de instalar qualquer coisa, identifique a versão exata do Minecraft, se o servidor é Vanilla, Paper ou modificado e o comando de inicialização. Em seguida, execute:
java -version
Isso informa o executável acessado por aquele terminal. Não prova que um painel de hospedagem, contêiner, serviço ou launcher use o mesmo. Verifique seu seletor de ambiente ou imagem e o registro de inicialização. Se o comando aponta para um caminho Java explícito, confira esse executável. No cliente, examine o perfil de instalação do launcher antes de alterar o Java global do computador.
Por exemplo, Vanilla 1.20.4 pertence à linha Java 17, mas Vanilla 1.20.5 pertence à de Java 21. Paper 1.20.4 segue a recomendação Java 21 do Paper. São três decisões distintas, apesar de números Minecraft semelhantes. Escolha o ambiente do processo que está diagnosticando, não o de outra instalação que funciona.
Corrija erros de inicialização sem adivinhar
UnsupportedClassVersionError normalmente significa que a JVM selecionada não consegue ler uma classe compilada para uma geração Java mais nova. O erro pode apontar para o servidor, carregador ou apenas um plugin. Na especificação do formato de classes JVM, as versões principais 52, 61, 65 e 69 correspondem a Java 8, 17, 21 e 25. São números de bytecode, não versões Minecraft.
Se um plugin precisa de Java 21, mas o servidor antigo suporta somente um ambiente anterior, apenas atualizar Java pode quebrar outra parte. Procure uma compilação compatível do plugin, atualize toda a combinação suportada ou reconsidere aquele plugin. Por outro lado, opções antigas da JVM podem se tornar inválidas no Java recente; mantenha apenas opções documentadas para o ambiente escolhido.
Se o comando java não é encontrado, investigue primeiro a instalação ou o caminho do executável. Uma falha de alocação de memória ou conflito de porta não prova que a versão principal do Java esteja errada. Leia o primeiro erro relevante e as linhas anteriores antes de mudar configurações não relacionadas.
Checklist para mudar com segurança
- Faça backup do mundo, configuração, plugins/mods e parâmetros de inicialização antes de alterar o ambiente.
- Confirme a versão e a implementação exatas e escolha o Java documentado. Use uma distribuição confiável ou o seletor suportado pela hospedagem, não um download aleatório de “Java fix”.
- Altere primeiro apenas o ambiente Java selecionado. Anote o ajuste anterior e não combine isso com uma atualização da versão do mundo.
- Reinicie corretamente e confira o registro. Em uma cópia, quando possível, teste conexão, carregamento do mundo e os plugins ou mods realmente usados.
- Se falhar, restaure o ambiente e os ajustes anteriores. Se outra alteração atualizou os dados do mundo, recupere o backup correspondente em vez de presumir que um servidor rebaixado conseguirá lê-los com segurança.
Para uma instalação hospedada, compare a hospedagem Minecraft da SharpHeberg com as necessidades exatas do servidor ou modpack e confirme a disponibilidade do ambiente antes de contratar. O ponto de partida certo é uma combinação coerente de Minecraft, servidor e Java, não a regra universal “instale o Java mais recente”.