A Hytale oferece um servidor dedicado oficial como HytaleServer.jar (Java 25, ao menos 4 GB de memória, UDP 5520 com QUIC) que precisa ser autenticado com uma conta Hytale. Como o jogo está em acesso antecipado, consulte o manual oficial do suporte do Hytale; os detalhes abaixo cruzam o suporte e guias de provedores.
Instalação passo a passo
Verifique a máquina: Java 25 (x64/arm64), 4 GB RAM min..
Obtenha os arquivos do servidor: a pasta Server (com HytaleServer.jar) e Assets.zip da instalação do jogo, ou pelo Hytale Downloader oficial (login por código).
Instale o Java 25 e verifique com java -version.
Execute java -jar HytaleServer.jar --assets Assets.zip; config.json, logs/ e universe/ são criados na primeira inicialização.
No console execute /auth login device, aprove o código em accounts.hytale.com/device e depois /auth persistence Encrypted.
Edite config.json com o servidor parado (ServerName, MOTD, Password, MaxPlayers, MaxViewRadius).
Abra as portas 5520/UDP no firewall e no roteador.
Entre com o endereço mostrado no topo do console (IP:5520); registros DNS SRV ainda não são suportados, use um registro A.
Configure o início automático (tarefa agendada ou serviço systemd).
Agende backups de universe/ e atualizações.
Requisitos
- Java 25 (x64 ou arm64); ao menos 4 GB de memória, a distância de visão (MaxViewRadius, máx. 12 chunks recomendado) é o principal consumo
- Uma conta Hytale com o jogo; cada licença é limitada a 500 servidores
- Cliente e servidor devem usar a mesma versão de protocolo
Instalação local (Windows)
Crie uma pasta (ex.: C:\HytaleServer), copie a pasta Server e o Assets.zip de %appdata%\Hytale\install\release\package\game\latest e execute o comando. Um servidor no mesmo PC do jogo precisa de ao menos 16 GB de RAM no total.
cd C:\HytaleServer
java -Xms4G -Xmx4G -jar HytaleServer.jar --assets Assets.zipInstalação em VPS / servidor dedicado Linux
No Ubuntu/Debian: usuário não root, Java 25 (por exemplo Eclipse Temurin 25) e o Hytale Downloader para obter o servidor (login por código, token em .hytale-downloader-credentials.json; apague esse arquivo em erros de autenticação). As opções exatas do downloader não são detalhadas aqui: leia a ajuda dele.
sudo adduser --disabled-password --gecos "" hytale
sudo -iu hytale
mkdir -p ~/hytale-server && cd ~/hytale-server
java -version # doit afficher 25 / must show 25
java -Xms4G -Xmx4G -jar Server/HytaleServer.jar --assets Assets.zipPortas a abrir
- 5520/UDP: porta de jogo padrão (QUIC), alterável com --bind; sem TCP
Firewall do Linux (ufw)
No Ubuntu/Debian, libere primeiro o SSH para não ficar sem acesso e depois as portas do jogo.
sudo ufw allow OpenSSH
sudo ufw allow 5520/udp
sudo ufw enable
sudo ufw statusFirewall do Windows (netsh)
No PowerShell como administrador (ou «cmd» de administrador):
netsh advfirewall firewall add rule name="Hytale 5520/UDP" dir=in action=allow protocol=UDP localport=5520Firewall do provedor e redirecionamento de portas (NAT)
Se o servidor está em um provedor (OVH, Hetzner, Scaleway…), abra as mesmas portas no firewall de rede dele («security group»). Em casa, redirecione as portas (NAT) do roteador para o IP local fixo da máquina. Teste de fora (dados móveis ou um amigo): um teste na sua própria rede não prova nada.
Início automático e supervisão
Crie /etc/systemd/system/<nome>.service e execute: sudo systemctl daemon-reload && sudo systemctl enable --now <nome>. Logs: journalctl -u <nome> -f.
[Unit]
Description=Hytale server
After=network-online.target
Wants=network-online.target
[Service]
User=hytale
WorkingDirectory=/home/hytale/hytale-server
ExecStart=/usr/bin/java -Xms4G -Xmx4G -jar Server/HytaleServer.jar --assets Assets.zip
Restart=on-failure
RestartSec=15
[Install]
WantedBy=multi-user.targetInício automático no Windows (tarefa agendada)
Crie uma tarefa agendada «Na inicialização» que execute o script de inicialização, com os privilégios mais altos e «Executar estando o usuário conectado ou não».
Atualizações, backups e reinícios
Pare o servidor, execute Hytale Downloader de novo e reinicie. Faça backup de universe/ antes de atualizações grandes. O servidor verifica uma nova versão a cada início: em geral basta reiniciar. Faça backup antes de trocar de patchline (release/pre-release): mundos de uma pré-versão podem não abrir em builds antigas.
# backup
tar czf ~/backup-$(date +%F).tar.gz -C ~/server universe/Divulgar e encontrar seu servidor
Quando o servidor estiver público, adicione-o em https://game-rank.com/jeux/hytale (site do proprietário desta ferramenta) para que os jogadores o encontrem, o sigam e votem nele.
Solução de problemas
- Inacessível de fora mas funciona em localhost: falta a regra do firewall do sistema, do provedor ou o redirecionamento NAT, ou o protocolo (UDP/TCP) está errado. Verifique cada camada.
- Conexão recusada após uma atualização do jogo: cliente e servidor precisam estar na mesma versão. Atualize o servidor novamente e reinicie.
- O servidor fecha logo: execute-o em um console para ler o erro e verifique RAM livre, disco e requisitos de software.
- «Autenticação necessária» ou login perdido ao reiniciar: refaça /auth login device e verifique /auth persistence (Memory = perde ao reiniciar; escolha Encrypted).
- Memória insuficiente ou lag: reduza o MaxViewRadius (/maxviewradius <raio>) antes de aumentar a RAM.
Perguntas frequentes
- O Hytale tem servidor dedicado oficial?
- Sim: HytaleServer.jar, documentado pelo suporte do Hytale. O jogo está em acesso antecipado, então opções e formatos (config.json…) podem mudar.
- Por que não há gerador de config.json?
- Apenas alguns campos (ServerName, MOTD, Password, MaxPlayers, MaxViewRadius, backups) são documentados por terceiros, sem esquema oficial: não o inventamos. Edite o arquivo gerado com o servidor parado.
- O que devo copiar?
- A pasta universe/ (mundos e dados de jogadores), mais config.json e permissions.json.
- Dá para rodar sem conta (modo offline)?
- Guias citam --auth-mode offline para desenvolvimento; não é o caminho normal para servidor público. Verifique com --help.