Instalar um servidor Minecraft no Debian ou Ubuntu (Paper)

Quer ter o seu próprio servidor Minecraft no seu servidor root Linux com Debian ou Ubuntu? Então está no sítio certo. Neste guia instalamos um servidor Paper (compatível com plugins Spigot e Bukkit) passo a passo através da consola SSH.

Todos os comandos foram pensados para Debian 13, Debian 12 e Ubuntu 24.04 LTS. Sistemas mais antigos, como o Debian 10 ou o Ubuntu 20.04, já chegaram ao fim do suporte e deixaram de receber atualizações de segurança. Num servidor acessível a partir da Internet, não deve continuar a utilizar essas versões.

Requisitos para um servidor Minecraft próprio

• Um servidor root ou VPS com Debian 13, Debian 12 ou Ubuntu 24.04 LTS
• Acesso root através de SSH
• Pelo menos 2 GB de RAM apenas para o servidor Minecraft, e proporcionalmente mais com plugins ou muitos jogadores
• A porta TCP 25565 aberta, a porta padrão da Minecraft Java Edition

Atualizar a lista de pacotes e instalar as atualizações

Antes de começar, atualize a lista de pacotes do seu sistema operativo e instale todas as atualizações disponíveis. Um único comando trata disso:

apt update && apt upgrade -y

De que versão do Java precisa o seu servidor Minecraft?

O Minecraft exige uma versão do Java diferente consoante a versão do servidor. Se o servidor arrancar com uma versão do Java demasiado antiga, termina de imediato com uma mensagem de erro, normalmente a apontar para uma versão de classe não suportada. Para a Java Edition aplica-se a seguinte correspondência:

• Minecraft 1.20.5 e mais recente: Java 21
• Minecraft 1.18 até 1.20.4: Java 17
• Minecraft 1.17: Java 16
• Minecraft 1.16.5 e anterior: Java 8

As versões atuais do servidor exigem, portanto, o Java 21. Na dúvida, instale o Java 21, porque uma versão mais recente do Java também costuma conseguir arrancar builds antigas do Minecraft.

Instalar o Java 21 no Debian 13 e no Ubuntu 24.04 LTS

Ambos os sistemas já trazem o Java 21 nas suas próprias fontes de pacotes:

apt install openjdk-21-jre-headless -y

No Debian 12, a fonte de pacotes padrão contém apenas o Java 17. O nosso guia separado Instalar o Java 21 no Debian mostra como obter na mesma o Java 21.

Java 17 para versões mais antigas do Minecraft

Se optar conscientemente por uma versão de servidor mais antiga, entre a 1.18 e a 1.20.4, instale antes o Java 17:

apt install openjdk-17-jre-headless -y

O nosso guia Instalar o Java 17 no Debian descreve outras formas de instalação.

Verificar a instalação do Java

A seguir, confirme que versão do Java está realmente ativa:

java -version

O resultado tem de indicar a versão principal pretendida, por exemplo "openjdk version 21". Se aparecer outra versão, existe uma segunda instalação do Java definida como padrão.

Instalar o screen para o servidor ficar sempre a correr

Sem ajuda, o servidor Minecraft seria encerrado assim que fechasse a sua sessão SSH. O pacote "screen" mantém o processo vivo numa sessão própria:

apt install screen -y

Criar um utilizador próprio para o servidor Minecraft

Nunca ponha o servidor a correr como root. Crie antes um utilizador próprio. Isso é sobretudo importante quando o mesmo servidor aloja outras aplicações, porque assim um plugin comprometido não chega ao sistema inteiro.

adduser --disabled-login spigot

A opção --disabled-login desativa o início de sessão direto por SSH para este utilizador. As perguntas sobre nome, morada ou número de telefone podem ser saltadas com a tecla Enter.

Agora mude para o novo utilizador e para o respetivo diretório pessoal:

su spigot && cd

Aí crie um diretório para o servidor (no exemplo, "server") e entre nele:

mkdir server && cd server/

Escolher e descarregar a versão do Paper

Encontra a versão do Paper pretendida na página oficial de downloads: https://papermc.io/downloads. Através do seletor de versões chega também a builds mais antigas.

Copie o link de download (clique com o botão direito no botão da build e escolha "Copiar endereço do link"), volte à consola SSH e descarregue o ficheiro com wget. O resultado é mais ou menos assim:

#APENAS UM LINK DE EXEMPLO, UTILIZE O LINK ATUAL DE PAPERMC.IO!

wget https://api.papermc.io/v2/projects/paper/versions/1.20.1/builds/45/downloads/paper-1.20.1-45.jar

Depois mude o nome do ficheiro descarregado para "spigot.jar", para que o script de arranque possa usar sempre o mesmo nome de ficheiro. Numa futura mudança de versão basta então trocar o ficheiro:

mv paper*.jar spigot.jar

Criar o script de arranque e aceitar o EULA

Crie um ficheiro "start.sh":

nano start.sh

Introduza o seguinte conteúdo. No exemplo, o servidor recebe 4 GB de RAM, valor que ajusta ao seu servidor através de -Xmx:

screen -AmdS spigot java -Xmx4G -jar spigot.jar

Guarde o ficheiro com "CTRL + X", depois "Y" e "Enter".

A seguir torne o script executável e aceite a licença de utilizador final do Minecraft. Sem o EULA aceite, nenhum servidor Minecraft arranca:

chmod +x start.sh && echo "eula = true" > eula.txt

Arrancar o servidor Minecraft e utilizar a consola

Agora arranque o servidor:

./start.sh

O primeiro arranque demora um pouco mais, porque o mundo é gerado e os ficheiros de configuração são criados.

Com "CTRL + A + D" sai da consola do servidor sem o encerrar. Para voltar à consola, a qualquer momento, use:

screen -r spigot

Importante: a sessão do screen pertence ao utilizador "spigot". Autentique-se primeiro com su spigot antes de chamar screen -r.

Passos seguintes após a instalação

O servidor está a correr e a instalação base fica assim concluída. Dois pontos valem a pena logo a seguir:

• Arranque automático: para que o servidor volte a arrancar sozinho depois de reiniciar o sistema operativo, configure uma unidade de serviço do systemd. O nosso guia Arrancar o servidor Minecraft automaticamente descreve todo o processo.
• Configuração: no ficheiro "server.properties" define, entre outras coisas, o modo de jogo, a dificuldade, o número máximo de jogadores e a porta. Depois de cada alteração é necessário reiniciar o servidor.