Voltar ao blog

Como criar um servidor de Hytale: o guia completo (Chapter I)

Criar um servidor de Hytale leva poucos minutos quando você conhece as armadilhas que pegam quase todo iniciante: a versão certa do Java, a autenticação do servidor e uma porta que precisa ser aberta em UDP, não em TCP. Este guia mostra todos os passos, da instalação ao primeiro jogador conectado, e está atualizado com o Chapter I (Update 7), lançado em outubro de 2026, que mudou várias regras do lado do servidor.

O que saber antes de começar

Hytale está em acesso antecipado desde 13 de janeiro de 2026. A Hypixel Studios disponibiliza gratuitamente o servidor oficial: um programa Java chamado HytaleServer.jar, acompanhado de um arquivo Assets.zip com os recursos do jogo. A versão atual é o Chapter I “Out of the Breach”, lançado em 12 de outubro de 2026, seguido dos hotfixes 0.7.1 e 0.7.2 nos dias 13 e 14 de outubro.

Três pontos diferenciam o Hytale de outros jogos que você talvez já tenha hospedado:

  • O Java 25 é obrigatório. Versões anteriores não iniciam o servidor.
  • A rede usa QUIC sobre UDP, na porta 5520 por padrão. Um redirecionamento só em TCP nunca vai funcionar.
  • O servidor precisa ser autenticado com uma conta Hytale antes de aceitar jogadores.

Cliente e servidor também precisam usar exatamente a mesma versão do protocolo. A cada atualização do jogo, seu servidor também deve ser atualizado, senão ninguém consegue se conectar.

Requisitos do sistema

O servidor roda em Windows, Linux e macOS, com processadores x64 ou arm64. A memória RAM é o recurso mais exigido, principalmente por causa da distância de visão. Estas são as recomendações mais comuns, para ajustar ao seu uso:

JogadoresRAM alocada (-Xmx)CPUArmazenamento
1 a 54 GB2 núcleos a 2,5 GHz10 GB
5 a 106 GB4 núcleos20 GB SSD
10 a 208 GB4 núcleos a partir de 3 GHz20 GB SSD ou NVMe
Mais de 2012 GB ou mais6 núcleos ou maisNVMe recomendado

A velocidade de upload também conta: cerca de 10 Mbps bastam para um pequeno grupo de amigos, um servidor público precisa de bem mais.

Onde hospedar seu servidor

OpçãoVantagensLimitações
Seu próprio PCGrátis, ideal para testarFica offline quando o PC desliga, exige redirecionamento de porta, impossível atrás de CGNAT
VPS ou servidor dedicadoOnline 24/7, IP fixo, controle totalInstalação e manutenção em Linux por sua conta
Hospedagem especializadaPronto em minutos, painel, backups, proteção anti-DDoSAssinatura mensal

Os passos abaixo valem para um PC ou um VPS. Com uma hospedagem, os passos 1, 2 e 5 já vêm prontos.

Passo 1: instalar o Java 25

A distribuição mais usada é o Eclipse Temurin 25, publicado gratuitamente pela Adoptium. No Windows e no macOS, use o instalador oficial. No Ubuntu ou Debian, depois de adicionar o repositório da Adoptium, um único comando resolve:

sudo apt update
sudo apt install temurin-25-jdk
java --version

O último comando deve mostrar uma versão que começa com 25. Se aparecer outra versão do Java, é ela que o servidor vai usar: mude a versão padrão ou chame o Java 25 pelo caminho completo no script de inicialização.

Passo 2: obter os arquivos do servidor

Método rápido: copiar do launcher

Se o jogo estiver instalado na máquina, os arquivos ficam na pasta do launcher:

  • Windows: %appdata%\Hytale\install\release\package\game\latest
  • Linux: $XDG_DATA_HOME/Hytale/install/release/package/game/latest
  • macOS: ~/Application Support/Hytale/install/release/package/game/latest

Copie a pasta Server e o arquivo Assets.zip para uma pasta nova, por exemplo hytale-server. Copie, não rode o servidor ali mesmo: desde o Chapter I, o servidor se recusa a iniciar (código de saída 11) se a pasta de trabalho, o mundo ou os backups estiverem dentro da pasta de instalação do launcher. A opção --allow-install-dir pula essa verificação, mas a Hypixel avisa que ela pode causar perda de dados.

Método recomendado: Hytale Downloader

Em um VPS, use a ferramenta oficial de linha de comando Hytale Downloader. Na primeira execução, ela pede que você entre na sua conta Hytale pelo navegador para autorizar o download.

./hytale-downloader -print-version   # mostra a versão disponível
./hytale-downloader                  # baixa a versão mais recente
./hytale-downloader -patchline pre-release   # canal de pré-lançamento

Você recebe um arquivo com data. Depois de extraído, ele contém a pasta Server/ e o arquivo Assets.zip, na estrutura oficial que o servidor espera.

Passo 3: iniciar o servidor

Na pasta Server, o comando mínimo é:

java -jar HytaleServer.jar --assets ../Assets.zip

Se o seu arquivo já traz um script start.sh ou start.bat ao lado do Assets.zip, use-o primeiro: é ele que aplica as atualizações baixadas pelo servidor. Se não, crie seu próprio script, por exemplo run-hytale.sh, definindo a memória e aproveitando o cache AOT incluído, que acelera a inicialização:

#!/bin/bash
cd Server
java -Xms4G -Xmx8G -XX:AOTCache=HytaleServer.aot \
  -jar HytaleServer.jar --assets ../Assets.zip \
  --bind 0.0.0.0:5520 --backup --backup-dir backups

Torne-o executável com chmod +x run-hytale.sh. No Windows, coloque a mesma linha java em um arquivo .bat. Ajuste o -Xmx conforme a tabela acima e sempre deixe 1 a 2 GB para o sistema. A opção --backup ativa backups automáticos, e --backup-frequency define o intervalo.

Em um VPS, rode o servidor em uma sessão screen ou tmux, ou melhor, como serviço systemd, para que ele continue rodando depois que você fechar a conexão SSH.

Passo 4: autenticar o servidor

Na primeira inicialização, o servidor ainda não aceita jogadores. Digite no console:

/auth login device

O servidor mostra um endereço e um código curto. Abra no navegador a página de ativação de dispositivos do site de contas do Hytale, entre na sua conta e digite o código. Seja rápido: o código só vale por tempo limitado. Desde o Chapter I, o comando também funciona com o servidor já conectado, e uma falha mantém a sessão existente.

Passo 5: abrir a porta 5520 em UDP

É aqui que a maioria dos guias e jogadores erra: o Hytale usa somente UDP. Libere a porta no firewall da máquina:

# Linux com UFW
sudo ufw allow 5520/udp

# Linux com iptables
sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT
# Windows (PowerShell como administrador)
New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow

Em casa, crie depois um redirecionamento de porta no roteador: protocolo UDP, porta externa e interna 5520, apontando para o IP local do PC que roda o servidor. Seus amigos se conectam usando o seu IP público.

Se o seu provedor coloca você atrás de CGNAT, algo comum em internet 4G e 5G e em alguns provedores de fibra, nenhum redirecionamento vai funcionar. As alternativas são um túnel, um VPS ou uma hospedagem.

Passo 6: configurar o servidor

Depois da primeira inicialização, a pasta Server contém, entre outros:

ItemFunção
config.jsonConfiguração principal
universe/Mundos e dados dos jogadores, o primeiro item a fazer backup
mods/Mods em formato .jar ou .zip
permissions.jsonGrupos e permissões
logs/Logs, o primeiro lugar para olhar quando algo dá errado

Sempre pare o servidor antes de editar um arquivo: ele reescreve os arquivos de configuração durante o jogo e pode apagar suas alterações. As configurações mais úteis do config.json:

  • ServerName e MOTD: o nome e a mensagem exibidos aos jogadores.
  • Password: vazio para um servidor aberto, ou uma senha pedida na entrada.
  • MaxPlayers: o limite de jogadores, de acordo com a sua RAM.
  • MaxViewRadius: a distância de visão em chunks, principal fator de consumo de RAM. O mais comum é recomendar no máximo 12. Desde o Chapter I, qualquer valor fora do intervalo de 1 a 32 é ajustado para esses limites com um aviso.
  • Defaults: o mundo e o modo de jogo padrão.

Deixar o servidor só para os amigos

Para um servidor privado, adicione primeiro os jogadores permitidos e depois ative a whitelist pelo console:

/whitelist add <nick>
/whitelist enable
/whitelist list

A sintaxe dos comandos já mudou entre versões do acesso antecipado: se algum for recusado, digite /help no console para ver a da sua versão. Para ganhar direitos de administrador, veja nosso guia sobre como virar OP em um servidor de Hytale.

Adicionar mods

Coloque os arquivos .jar ou .zip na pasta mods/, reinicie e confira em logs/ se eles foram carregados. Baixe mods apenas de fontes conhecidas: a página oficial do autor ou uma plataforma de mods reconhecida. Atenção: o Chapter I removeu ou substituiu boa parte da API de modding. Um mod feito para uma versão anterior precisa ser recompilado pelo autor, senão pode impedir a inicialização. Sempre teste um mod novo em uma cópia do seu mundo.

Atualizar sem perder seu mundo

O servidor tem um atualizador integrado, que você controla pelo console:

/update status          # versão atual
/update check           # procura atualizações
/update download        # baixa em updater/staging/
/update apply --confirm # faz backup e desliga o servidor

Depois, o script de inicialização oficial troca os arquivos ao reiniciar. Se você inicia o java diretamente, prefira baixar a nova versão com o Hytale Downloader.

Antes de qualquer atualização importante, pare o servidor e copie a pasta universe/ para outro lugar. Um mundo aberto por uma versão mais nova é convertido automaticamente e não pode mais ser aberto por uma versão anterior: essa cópia é o seu único caminho de volta.

Solução rápida de problemas

SintomaCausa provávelSolução
O servidor fecha na hora com o código 11Iniciado dentro da pasta do launcherCopiar Server e Assets.zip para uma pasta separada
Erro na inicialização sobre a versão de classeJava antigo demaisInstalar o Java 25 e conferir java --version
Ninguém consegue entrar de foraPorta aberta em TCP ou roteador atrás de CGNATAbrir a 5520 em UDP, ou migrar para um VPS
Jogadores recusados depois de uma atualizaçãoVersões de protocolo diferentesAtualizar o servidor para a mesma versão do cliente
Quedas ou lag com vários jogadoresRAM insuficiente ou distância de visão alta demaisAumentar o -Xmx e reduzir o MaxViewRadius

Para ir além em desempenho, nosso guia de otimização de servidor Hytale detalha as configurações avançadas.

A opção sem instalação

Se você prefere não lidar com Java, portas e atualizações, uma hospedagem cuida disso. Na OuiHeberg, os planos OuiBox prontos para Hytale começam com a OuiBox 8G (8 GB de RAM, 4 núcleos, 50 GB NVMe) por 9,98 € por mês, seguida da OuiBox 12G (12 GB, 5 núcleos, 80 GB NVMe) por 16,79 € por mês e da OuiBox 16G (16 GB, 6 núcleos, 120 GB NVMe) por 21,59 € por mês. O servidor fica pronto em minutos: basta autenticá-lo e chamar seus amigos.

Perguntas frequentes

Criar um servidor de Hytale é grátis?

Sim, a Hypixel Studios oferece o software do servidor de graça. Você só precisa de uma conta Hytale para autenticá-lo. O único custo possível é a máquina que o executa.

Qual porta um servidor de Hytale usa?

A porta UDP 5520 por padrão. Você pode mudá-la com a opção --bind, desde que abra a nova porta em UDP.

Quanta RAM um servidor de Hytale precisa?

O mais comum é 4 GB para 1 a 5 jogadores, 8 GB para 10 a 20 jogadores e 12 GB ou mais acima disso. A distância de visão pesa tanto quanto o número de jogadores.

Posso jogar no meu servidor pelo mesmo PC?

Sim. Conecte-se em 127.0.0.1 pelo jogo. Garanta RAM suficiente para rodar o cliente e o servidor ao mesmo tempo.

Por que meus amigos não conseguem entrar no meu servidor?

Na maioria dos casos, a porta 5520 está aberta em TCP em vez de UDP, falta o redirecionamento no roteador ou sua conexão está atrás de CGNAT. Confira também se todos atualizaram o jogo.

Lance seu servidor Hytale

Crie seu servidor Hytale em poucos cliques com HytaleServ.

Ver nossos planos