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
5520por 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:
| Jogadores | RAM alocada (-Xmx) | CPU | Armazenamento |
|---|---|---|---|
| 1 a 5 | 4 GB | 2 núcleos a 2,5 GHz | 10 GB |
| 5 a 10 | 6 GB | 4 núcleos | 20 GB SSD |
| 10 a 20 | 8 GB | 4 núcleos a partir de 3 GHz | 20 GB SSD ou NVMe |
| Mais de 20 | 12 GB ou mais | 6 núcleos ou mais | NVMe 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ção | Vantagens | Limitações |
|---|---|---|
| Seu próprio PC | Grátis, ideal para testar | Fica offline quando o PC desliga, exige redirecionamento de porta, impossível atrás de CGNAT |
| VPS ou servidor dedicado | Online 24/7, IP fixo, controle total | Instalação e manutenção em Linux por sua conta |
| Hospedagem especializada | Pronto em minutos, painel, backups, proteção anti-DDoS | Assinatura 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:
| Item | Função |
|---|---|
config.json | Configuração principal |
universe/ | Mundos e dados dos jogadores, o primeiro item a fazer backup |
mods/ | Mods em formato .jar ou .zip |
permissions.json | Grupos 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:
ServerNameeMOTD: 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
| Sintoma | Causa provável | Solução |
|---|---|---|
| O servidor fecha na hora com o código 11 | Iniciado dentro da pasta do launcher | Copiar Server e Assets.zip para uma pasta separada |
| Erro na inicialização sobre a versão de classe | Java antigo demais | Instalar o Java 25 e conferir java --version |
| Ninguém consegue entrar de fora | Porta aberta em TCP ou roteador atrás de CGNAT | Abrir a 5520 em UDP, ou migrar para um VPS |
| Jogadores recusados depois de uma atualização | Versões de protocolo diferentes | Atualizar o servidor para a mesma versão do cliente |
| Quedas ou lag com vários jogadores | RAM insuficiente ou distância de visão alta demais | Aumentar 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.