Instalar um servidor Hytale no Debian ou Ubuntu

Quer operar um servidor Hytale próprio no seu sistema operativo Linux, em Debian ou Ubuntu? Então está no sítio certo.

Neste tutorial utilizamos o downloader oficial da Hytale, instalamos o servidor passo a passo e efetuamos a primeira autenticação. Todos os comandos estão preparados para Debian 13, Debian 12 e Ubuntu 24.04 LTS.

Requisitos para um servidor Hytale 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 4 GB de RAM só para o servidor, no exemplo abaixo trabalhamos com 8 GB
• Java 25, ver a secção seguinte

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

Antes de começarmos, atualize a lista de pacotes do seu sistema operativo e instale todas as atualizações disponíveis:

apt update && apt upgrade -y

Instalar o Java 25

Segundo o Hytale Server Manual oficial, o Java 25 é obrigatório. Com versões mais antigas do Java, o servidor não arranca. Instale o Java 25 juntamente com o unzip e o screen:

apt install openjdk-25-jre-headless unzip screen -y

Verifique de seguida a instalação com o comando seguinte. A saída deve conter "openjdk 25":

java -version

O Java 25 não está disponível em todas as distribuições. Situação em julho de 2026:

No Debian 12, instale o Java 25 a partir da fonte de pacotes da Adoptium. A chave de assinatura pertence a /etc/apt/keyrings/, já que o antigo caminho através do apt-key deixou de existir:

apt install -y wget gpg apt-transport-https
mkdir -p /etc/apt/keyrings
wget -qO- https://packages.adoptium.net/artifactory/api/gpg/key/public | gpg --dearmor -o /etc/apt/keyrings/adoptium.gpg
echo "deb [signed-by=/etc/apt/keyrings/adoptium.gpg] https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | tee /etc/apt/sources.list.d/adoptium.list
apt update
apt install -y temurin-25-jre unzip screen

Para ver a qualquer momento que versões do Java estão disponíveis no seu sistema:

apt-cache policy openjdk-25-jre-headless

Criar um utilizador próprio para o servidor Hytale

Por razões de segurança, não opere o servidor como root, mas sim com um utilizador próprio:

adduser --disabled-login hytale

As perguntas sobre nome, morada ou número de telefone salta-as simplesmente com a tecla Enter. Depois, mude para o novo utilizador e para o respetivo diretório pessoal:

su hytale && cd

Descarregar o downloader Hytale e obter os ficheiros do servidor

Descarregue diretamente o downloader oficial da Hytale:

wget https://downloader.hytale.com/hytale-downloader.zip

Descompacte o ficheiro ZIP. Como já contém uma pasta chamada Server/, movemos para lá o Assets.zip que eventualmente exista à parte, entramos no diretório e tornamos o downloader executável:

unzip hytale-downloader.zip
mv Assets.zip Server/
cd Server/
chmod +x hytale-downloader-linux-amd64

Executamos agora o downloader para descarregar ou atualizar os verdadeiros ficheiros do servidor:

./hytale-downloader-linux-amd64

Nota: o downloader vai buscar sempre a versão atual do HytaleServer.jar e do Assets.zip. Por isso, volte a executá-lo também nas atualizações posteriores.

Criar um script de arranque com cache AOT

Crie um ficheiro "start.sh":

nano start.sh

Introduza o seguinte conteúdo. Utilizamos aqui a cache AOT recomendada no manual, que reduz visivelmente o tempo de arranque:

#!/bin/bash
# CONFIGURAÇÃO
SCREEN_NAME="hytale"
SERVER_FILE="HytaleServer.jar"
ASSETS_FILE="Assets.zip" # Nome predefinido
MEM="8G" # Adapte a RAM às suas necessidades (mín. 4GB)

# CICLO DE ARRANQUE
while true; do
    echo "A iniciar o servidor Hytale..."
    # Comando de arranque com otimização da cache AOT segundo o manual
    java -Xms$MEM -Xmx$MEM -XX:AOTCache=HytaleServer.aot -jar $SERVER_FILE --assets $ASSETS_FILE

    echo "Reinício dentro de 5 segundos... CTRL+C para cancelar"
    sleep 5
done

Guarde o ficheiro com "CTRL + X", depois "Y" e "Enter". O ciclo no script garante que o servidor volta a arrancar automaticamente após uma falha.

Torne o script executável:

chmod +x start.sh

Iniciar o servidor Hytale e utilizar a consola

Inicie o servidor numa sessão screen, para que continue a correr mesmo depois de terminar a sua ligação SSH:

screen -dmS hytale ./start.sh

A consola abre-se com:

screen -r hytale

Com "CTRL + A + D" sai novamente da consola sem terminar o servidor.

Autenticar o servidor (Device Login)

No primeiro arranque tem de autenticar o servidor uma única vez. Para isso, introduza o seguinte comando na consola do servidor:

/auth login device

Abra no seu PC o link apresentado (por exemplo https://accounts.hytale.com/device) e introduza aí o código que consta na consola. Assim que surgir "Authentication successful!", o seu servidor está pronto a usar.

Próximos passos: arranque automático e proteção contra ataques

• Arranque automático: para que o servidor Hytale volte a subir sozinho depois de um reinício do sistema operativo, configure um arranque automático. O procedimento está descrito no nosso tutorial Executar programas automaticamente no arranque do servidor.
• Proteção contra ataques DDoS: os servidores de jogos são um alvo apetecido para ataques vindos da rede. O que deve ter em conta consta no nosso artigo Servidor Hytale e proteção DDoS.