Base de Conhecimento

VPS para Hytale: como montar seu servidor

  • hytale, servidor de jogos, vps, java, backup
  • Usuários acharam útil: 0

VPS para Hytale: veja os requisitos, instale o servidor, autentique com a conta do jogo, libere a porta UDP, rode como serviço, faça backup e atualize.

Por Redação Eleven Host · @robson.direitodigital · 11 de novembro de 2026 · 9 min de leitura

Arte da Eleven Host: janela de terminal com o título: VPS para Hytale: como montar seu servidor

Capa da Redação Eleven Host para o guia: VPS para Hytale: como montar seu servidor Arte: Eleven Host

VPS para Hytale é uma forma de manter o seu servidor dedicado do jogo ligado, com Java 25, usuário sem root e a porta 5520 em UDP. Veja requisitos, instalação, autenticação, systemd, backup e atualização.

Atualizado em 11/11/2026. O Hytale está em Early Access desde 13/01/2026 e recebe atualizações numeradas (a Update 7 saiu em 12/10/2026). Os blocos de comando e de arquivo abaixo são exemplos: confira cada um no seu servidor antes de usar.

O que o servidor dedicado pede

O Hytale tem servidor dedicado oficial, descrito no manual oficial do servidor. Para o conceito de VPS, o guia completo de servidor VPS explica o que ela é. Os exemplos usam Linux (por exemplo, o Ubuntu); o downloader oficial tem versão para Linux e para Windows.

O manual oficial do servidor indica no mínimo 4 GB de memória e Java 25, em máquina x64 ou arm64. Acima do mínimo, o consumo de memória depende sobretudo da distância de visão.

Segundo o manual, a distância de visão é o principal fator de uso de memória, e a recomendação é no máximo 12 chunks (384 blocos). O processador trabalha mais quando há muitos jogadores ou entidades, como NPCs e criaturas, e mais coleta de lixo (GC) é um sinal de memória curta. Acompanhe o uso quando o grupo jogar: o artigo Quanta RAM precisa uma VPS mostra como calcular a sua.

A Eleven Host lista as suas VPS na loja online. Confira na loja o que cada plano inclui. Ver as VPS

Passo 1: instalar o Java 25 e criar um usuário sem root

O manual recomenda o Java 25 da Adoptium (adoptium.net/temurin/releases). Instale-o pelas instruções dessa página e confirme a versão:

java --version

Para o servidor, recomendamos um usuário comum, e não o root: o manual usa sudo apenas para o firewall. Um exemplo de comandos para criar o usuário hytale, com a pasta /opt/hytale como home, e trabalhar como ele. Confira no seu servidor se o usuário e a pasta foram criados:

sudo apt update && sudo apt install unzip wget

sudo adduser --system --group --shell /bin/bash --home /opt/hytale hytale

sudo -iu hytale

pwd

O pwd deve mostrar /opt/hytale. Os passos 2 e 3 rodam nessa sessão; os comandos com sudo rodam na sua conta de administrador.

Passo 2: obter os arquivos do servidor

O manual descreve mais de uma forma de obter os arquivos. A primeira é copiar a pasta Server e o Assets.zip de $XDG_DATA_HOME/Hytale/install/release/package/game/latest, na instalação do launcher no Linux; o manual a indica para testes rápidos.

A segunda é o Hytale Downloader CLI, que o manual indica para servidores de produção e que usa autenticação OAuth2. É preciso uma conta Hytale com licença do jogo. Um exemplo de comandos (confira o nome do executável depois de descompactar o primeiro zip e use chmod +x se faltar permissão):

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

unzip hytale-downloader.zip

./hytale-downloader -download-path game.zip

unzip game.zip

Na primeira execução, o downloader pede o login pelo navegador. Confira que, depois do último unzip, existem a pasta Server e o arquivo Assets.zip: o restante do texto parte dessa disposição.

Passo 3: primeiro início e autenticação

O comando de início do manual é java -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets Assets.zip. Como o Assets.zip está uma pasta acima de Server, um exemplo de comando para o primeiro início, em primeiro plano, com a sessão SSH aberta:

cd /opt/hytale/Server

java -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets ../Assets.zip

Segundo o manual, o servidor exige autenticação e só aceita jogadores depois dela. Com o servidor ligado, digite no console:

/auth login device

O servidor mostra um código. Abra o endereço accounts.hytale.com/device no navegador, entre com a conta que tem a licença do jogo e digite o código, que expira em 900 segundos (15 minutos). Se expirar, repita o comando.

A página oficial para provedores trata da persistência da credencial, com /auth persistence e /auth persistence <tipo>, em que o tipo é Memory ou Encrypted. Para um servidor que será reiniciado, recomendamos o modo Encrypted; confira no seu servidor o que cada modo faz. Um exemplo, digitado no console:

/auth persistence Encrypted

O token de acesso OAuth dura 1 hora e o token de renovação (refresh) dura 30 dias; a sessão de jogo é renovada sozinha. Só é preciso autenticar de novo se o servidor ficar desligado por mais que a validade do refresh.

Pare o servidor com Ctrl+C no terminal e confira que ele fechou. Depois digite exit para voltar à sua conta de administrador. O serviço do passo 5 só deve ser iniciado com o processo manual parado.

Passo 4: porta 5520 em UDP e firewall

O Hytale usa o protocolo QUIC sobre UDP, e não TCP. A porta padrão é a 5520, e liberar TCP não adianta. Para mudar a porta, use --bind; o formato é endereço e porta, e o padrão é 0.0.0.0:5520. Se trocar a porta, libere a nova, também em UDP.

Um exemplo de comando com o ufw, o firewall que o manual cita. Se você ainda não usa o ufw e for ativá-lo, libere antes o acesso SSH (por exemplo, com sudo ufw allow OpenSSH) para não perder a conexão ao servidor:

sudo ufw status

sudo ufw allow 5520/udp

Se os jogadores não conectarem, confira se existe outro firewall entre o servidor e a internet.

Passo 5: rodar como serviço no systemd

Faça a autenticação do passo 3 antes de criar o serviço: sob o systemd não há console interativo à mão para o /auth. Na sua conta de administrador, crie a pasta de backup antes de apontar o serviço para ela e abra o arquivo do serviço:

sudo -u hytale mkdir -p /opt/hytale/backups

sudo nano /etc/systemd/system/hytale.service

Um exemplo de arquivo de serviço, com as flags de backup do manual. O -Xmx4G é só um exemplo de limite de memória da JVM e precisa caber na memória da sua VPS, deixando espaço para o sistema:

[Unit]

Description=Servidor Hytale

After=network-online.target

Wants=network-online.target

[Service]

User=hytale

WorkingDirectory=/opt/hytale/Server

ExecStart=/usr/bin/java -Xmx4G -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets ../Assets.zip --backup --backup-dir /opt/hytale/backups --backup-frequency 30

Restart=on-failure

[Install]

WantedBy=multi-user.target

Confira o caminho do Java com which java. Depois, um exemplo de comandos para ativar e acompanhar o serviço:

sudo systemctl daemon-reload

sudo systemctl enable --now hytale

sudo systemctl status hytale

sudo journalctl -u hytale -f

Por padrão, o servidor verifica atualizações a cada hora, deixa os arquivos em updater/staging/ e desliga com código de saída 8; é o start.sh que detecta esse código, volta ao início e aplica os arquivos. Chamando o java direto, como no exemplo, esse laço não existe, e o systemd pode reiniciar o servidor sem aplicar a atualização. Há dois caminhos: usar o start.sh no ExecStart, depois de conferir que ele existe e o que executa, ou desligar a atualização automática com a variável HYTALE_DISABLE_UPDATES no ambiente do serviço (confira o valor que ela espera) e atualizar à mão, como mostra a seção de atualização.

Arquivos do servidor e mods

O manual descreve, na pasta do servidor, os arquivos config.json (com a seção Update), permissions.json, whitelist.json e bans.json, além de universe/ (mundos e dados de jogadores, com os mundos em universe/worlds/), mods/, logs/ e .cache/. Confira o que já existe depois do primeiro início.

O manual avisa que alterações manuais com o servidor ligado provavelmente serão sobrescritas. Por isso, pare o serviço antes de editar um deles. Os mods (arquivos .zip ou .jar) vão em mods/.

Backup e restauração

O manual traz três flags de backup: --backup liga as cópias automáticas, --backup-dir define a pasta e --backup-frequency define o intervalo em minutos, com padrão de 30. O serviço do passo 5 já usa as três. O artigo Backup da VPS trata de cópia automática da VPS.

Para uma cópia manual, pare o serviço antes, já que os arquivos são regravados com o servidor rodando. Um exemplo de comandos (o tar reclama se algum arquivo listado não existir):

sudo systemctl stop hytale

sudo -u hytale tar -czf /opt/hytale/backups/manual-$(date +%F-%H%M).tar.gz -C /opt/hytale/Server universe config.json permissions.json whitelist.json bans.json

sudo systemctl start hytale

Restaurar uma cópia manual

Um exemplo de comandos: pare o serviço, extraia a cópia e inicie de novo. Troque o nome pelo do arquivo que você gerou:

sudo systemctl stop hytale

sudo -u hytale tar -xzf /opt/hytale/backups/manual-AAAA-MM-DD-HHMM.tar.gz -C /opt/hytale/Server

sudo systemctl start hytale

Teste a restauração numa cópia antes de depender dela, e guarde uma cópia fora da VPS: backup na mesma máquina não protege se a máquina for perdida.

Atualização do servidor

Antes de aplicar uma atualização, o manual recomenda um backup completo do servidor (exige a pasta de backup configurada) e uma cópia de config.json, permissions.json, bans.json e whitelist.json. No console do servidor há os comandos /update check, /update download, /update apply --confirm, /update cancel e /update status.

Como o serviço do passo 5 não tem console à mão, atualize assim: pare o serviço, faça o backup, rode de novo o downloader e o unzip -o game.zip do passo 2 como o usuário hytale (sudo -iu hytale), saia dessa sessão com exit e inicie o serviço. Depois, confira que o mundo e os arquivos de configuração continuam no lugar, porque o zip novo pode sobrescrever arquivos.

Termos do jogo e da política de servidores

Existe a Hytale Server Operator Policies, que vale para quem hospeda ou opera um servidor do jogo, e existe a EULA do Hytale (em 11/11/2026, versões 1.1 e 2.3, vigentes desde 13/01/2026). Quem pensa em cobrar por acesso ou monetizar o servidor de alguma forma deve ler os dois documentos, no site oficial, antes de começar.

Quem entra no servidor

Os jogadores entram pelo launcher oficial do Hytale, com a conta deles, depois que o servidor estiver autenticado. Passe a eles o endereço da VPS e a porta liberada.

As VPS da Eleven Host estão reunidas na loja. Confira na loja o que cada plano inclui. Ver as VPS

Perguntas frequentes

Qual porta o servidor usa?

A padrão é a 5520, em UDP (QUIC). TCP não adianta. Ela pode ser trocada com --bind, e a nova porta também precisa ser liberada em UDP.

Quanta memória o servidor precisa?

O mínimo do manual é 4 GB e Java 25. Acima disso, o consumo depende sobretudo da distância de visão, com máximo recomendado de 12 chunks.

Preciso de uma conta para montar o servidor?

Sim. O downloader usa OAuth2 e o servidor exige /auth login device com uma conta Hytale que tenha a licença do jogo.

Esta resposta lhe foi útil?

Artigos Relacionados