Como Configurar um Servidor de Hytale (2026)

Neste guia vamos abordar configurar, personalizar e listar um servidor de Hytale no Windows, Linux e macOS.

Os servidores de Hytale são um pouco diferentes dos outros jogos para os quais escrevemos guias de servidor, por um motivo: todo mundo de Hytale já é um servidor. Quando você cria um mundo singleplayer, o cliente sobe um servidor local e entra nele. O multiplayer é a mesma coisa, com outras pessoas se conectando. Não existe um "modo servidor" separado para ativar.

Isso também significa que mods são uma questão do servidor, não do cliente, o que é abordado no nosso guia de mods de Hytale.

Uma nota sobre a atualidade disto: Hytale está em early access desde janeiro de 2026 e a Hypixel Studios ainda não publicou um documento específico de configuração de servidor dedicado standalone. O que segue foi construído a partir da documentação oficial deles, das notas de patch e das Server Operator Policies, e deixa claro onde a orientação oficial termina.

Requisitos

Os requisitos mínimos publicados por Hytale para o cliente são:

	Mínimo
SO	Windows 11 ou Windows 10 x64 (1809), Linux x64 (kernel 6.15), ou Apple Silicon com macOS Tahoe 26.0
CPU	Intel Core i5-7500, AMD Ryzen 3 1200, ou Apple M1
RAM	8 GB
GPU	Intel UHD 620, AMD Radeon Vega 6, Apple M1, ou uma placa GTX 900 / Radeon 400 series

Para um servidor, ignore a linha de GPU e aumente tudo o resto:

• RAM é a principal restrição. O servidor é Java, mantém chunks e entidades carregados em memória, e asset packs somam a isso. 8 GB é o mínimo para um grupo pequeno, e um servidor movimentado com mods quer consideravelmente mais.
• Desempenho single-thread importa. Como na maioria dos block games, boa parte do trabalho de tick não é paralelo.
• Disco depende inteiramente de quanto do mundo é explorado. Os saves de mundo crescem continuamente.
• Uma licença de Hytale, comprada em hytale.com. O jogo não está na Steam.

NOTA - Hytale é exclusivo para Apple Silicon no macOS. Não existe build para Mac Intel.

Entendendo o Modelo de Servidor de Hytale

Kevin Carstens, Diretor Técnico de Hytale, colocou isso claramente quando o estúdio publicou sua estratégia de modding: Hytale é diferente porque, mesmo quando você entra no singleplayer, você entra em um servidor local que é só seu. Quando a documentação fala sobre servidores, ela se refere tanto ao singleplayer quanto ao multiplayer.

Na prática, isso tem algumas consequências que vale a pena internalizar:

• Mods são instalados uma vez, pelo host. Jogadores que entram no seu servidor não instalam nada. O cliente vanilla deles renderiza o que quer que o seu servidor mande.
• Seu conhecimento de singleplayer se aplica. Configurar um mundo no singleplayer e configurar um servidor são habilidades quase idênticas.
• Não existe um cliente modificado para distribuir. O estúdio disse que não pretende dar suporte a mods de cliente, justamente para que um ecossistema fragmentado de clientes por servidor nunca se desenvolva.

Universos, Mundos e Instâncias

Hytale organiza as coisas em uma hierarquia que aparece por toda parte nas configs e nas notas de patch.

Um universo contém mundos. Um mundo é o que os jogadores entendem como o mapa. Instâncias são cópias separadas de um mundo, usadas para coisas como os Portal Devices, e podem herdar configurações como fall damage e PvP do mundo padrão do universo.

Você vai ver esse vocabulário na configuração de plugins, então vale a pena conhecê-lo antes de começar a ler arquivos de config.

Hospedando Pelo Cliente

Para um grupo pequeno, esta é a resposta completa e não precisa de nenhum software extra.

Crie um mundo no cliente, selecione os mods e asset packs que você quer para ele nas opções de New World, e compartilhe um código de convite com seus amigos. Eles se conectam e jogam com um cliente completamente vanilla.

Isso atende bem a um grupo de amigos e é como a maioria das pessoas vai rodar seu primeiro multiplayer de Hytale. As limitações são as óbvias: o mundo só fica no ar enquanto seu cliente está rodando, ele compete por recursos com o seu próprio jogo, e está preso à sua máquina.

Rodando um Servidor Standalone

Para algo persistente que roda sem você estar logado, você quer o servidor rodando sozinho.

É aqui que a documentação oficial atualmente para. A Hypixel Studios disponibiliza uma referência da Java Server API e documentação de assets, e mantém o Server Discovery com um documento de política completo por trás, então servidores auto-hospedados são claramente esperados e suportados. O que ainda não foi publicado é um guia passo a passo do tipo "baixe isso, rode este comando", como Valheim ou ARK têm.

Até isso chegar, os caminhos práticos são:

• O launcher e o gerenciador de conta de Hytale. A distribuição de servidores é feita pela própria plataforma de Hytale, e não por uma loja terceirizada, então accounts.hytale.com é o primeiro lugar a checar.
• O Discord oficial. O Discord de Hytale tem os desenvolvedores do estúdio presentes e é onde os atuais operadores de servidor estão. Para algo que se move tão rápido, isso é mais confiável do que qualquer guia escrito, incluindo este.
• Um host gerenciado. Vários provedores de game server hosting adicionaram suporte a Hytale durante 2026 e cuidam da configuração para você.

NOTA - O servidor não é ofuscado, e o estúdio se comprometeu a liberar o código-fonte do servidor sob o programa Hytale Shared Source, que entrou no ar em junho de 2026. Jogadores licenciados podem acessar o código completo do servidor, o protocolo de rede e os assets no GitHub, com um acesso modelado no programa de código-fonte da Unreal Engine da Epic. Se você é técnico, essa é a documentação mais completa que existe.

Onde Ficam os Arquivos do Servidor

Em uma instalação do cliente, o lado servidor fica em UserData:

C:\Users\<user>\AppData\Roaming\Hytale\UserData

com Mods para mods disponíveis globalmente e Saves\<World Name> para cada mundo, cada um com sua própria pasta mods.

Linux e macOS usam o diretório de dados de aplicativo equivalente da plataforma, com a mesma estrutura por baixo.

Um servidor standalone mantém a mesma estrutura: um diretório mods para plugins e asset packs, e os dados do mundo ao lado.

Pré-requisitos no Linux

O servidor do Hytale é Java, então você precisa de uma JVM além das ferramentas usuais de manutenção de servidor.

Debian e Ubuntu:

sudo apt update
sudo apt install -y openjdk-21-jre-headless screen curl unzip

Fedora, RHEL e Rocky:

sudo dnf install -y java-21-openjdk-headless screen curl unzip

Verifique o que você tem com:

java -version

DICA - Verifique a versão do Java que a build atual do Hytale espera antes de escolher uma JVM. Isso mudou durante o early access, e uma incompatibilidade produz um erro pouco útil.

O requisito de Linux do Hytale é um sistema x64 com kernel 6.15, que é mais recente do que várias distribuições de longo suporte (LTS) trazem por padrão. Verifique com uname -r antes de começar.

Instalando Mods e Plugins

Os mods ficam no diretório mods do servidor e o servidor os carrega na inicialização.

1. Baixe o plugin ou asset pack, geralmente do CurseForge.
2. Coloque-o no diretório mods do servidor. Plugins são arquivos .jar do Java; asset packs são um zip ou uma pasta com um manifest.json dentro.
3. Reinicie o servidor.

Plugins bem construídos criam sua própria pasta dentro de mods para configuração e dados. O BetterMap, por exemplo, cria mods/bettermap/ com um config.json dentro, e registra comandos /bm, incluindo /bm reload, para aplicar mudanças de configuração sem reiniciar.

Os jogadores não precisam instalar nada. Esse é todo o propósito do modelo server-side.

Nosso guia de mods do Hytale explica as quatro categorias de mods e como os asset packs são montados.

Configuração

A configuração do Hytale é em JSON, e está espalhada por alguns lugares em vez de ficar em um único arquivo no estilo server.properties.

• Configurações de mundo são escolhidas na criação do mundo, cobrindo coisas como dano de queda e PvP, e instâncias podem herdá-las do mundo padrão do universo.
• Configs de gameplay ficam em JSON nos diretórios de configuração do servidor. As notas de patch citam caminhos como GameplayConfigs/Portal.json, o que dá uma ideia da estrutura.
• Configs de plugins ficam na própria pasta de cada plugin em mods.

Como o formato e os caminhos ainda mudam entre atualizações, vale a pena ler as notas de patch em hytale.com sempre que você atualizar. As notas da Update 7, por exemplo, renomearam várias chaves de configuração diretamente.

AVISO - Leia as notas de patch antes de atualizar um servidor em produção. O Hytale roda patches semanais de pré-lançamento agrupados em releases estáveis a cada poucas semanas, e chaves de configuração já foram renomeadas e removidas entre eles. Uma renomeação que você não percebeu significa que uma configuração volta silenciosamente ao padrão.

Aparecendo no Server Discovery

O Server Discovery é o navegador de servidores dentro do jogo, lançado com a Update 5 em maio de 2026. Listar é gratuito e o processo é totalmente documentado.

1. Faça login no Account Manager e abra a página Server Profiles.
2. Clique em Create server.
3. Preencha seus detalhes:
   • Nome e descrição. É por isso que os jogadores vão te julgar, então deixe claro o que o seu servidor realmente é.
   • Tipo de servidor, entre Survival, Adventure/RPG, Creative, PvP, Minigames, Roleplay, Social, Sandbox ou Other.
   • Tag de público: Everyone, Teen ou Mature.
   • Regiões atendidas, entre dez opções cobrindo NA, América do Sul, UE, Oriente Médio, Ásia e Oceania.
   • Verificação de domínio via um registro DNS TXT, para que os jogadores saibam que a listagem é realmente sua.
4. Envie e aguarde a moderação. Um moderador verifica se os detalhes estão corretos, e o status no seu card de listagem é atualizado conforme avança na revisão.
5. Depois de aceito, configure seu servidor para enviar heartbeats usando o token de discovery do seu card de listagem.

As listagens são revisadas na ordem em que chegam. O estúdio também escolhe manualmente servidores em destaque para promover à comunidade.

Heartbeats

Seu servidor prova que está ativo enviando heartbeats usando o token de discovery do seu card de listagem. Gerar esse token é um comando simples que você executa como OP, seja no console ou no chat, para completar a vinculação.

Se o seu servidor parar de enviar heartbeats por mais de dois minutos, ele fica oculto das listagens até voltar. Esse é um design sensato, e significa que um servidor instável desaparece silenciosamente do Discovery em vez de frustrar jogadores que tentam entrar.

NOTA - A primeira versão do Discovery é propositalmente minimalista. As listagens são nome, descrição e tags, sem ícones personalizados, banners ou mídia rica. Também não há contagem de jogadores ao vivo nem avaliação, algo que o estúdio deixou de fora especificamente para que os servidores não pudessem falsificá-los ou manipulá-los.

Políticas para Operadores de Servidor

A Hypixel Studios publica as Server Operator Policies, que se aplicam a qualquer pessoa hospedando um servidor Hytale, não apenas aos listados. Vale a pena ler com atenção se você pretende operar algo público. Os pontos principais:

• Regras básicas se aplicam a todo operador. Servidores listados no Discovery assumem obrigações extras além disso.
• Servidores listados precisam de detalhes verificados do operador, uma meta de resposta de 24 horas para denúncias urgentes de segurança sempre que razoavelmente possível, mínimos técnicos e de qualidade, e autoclassificação de conteúdo precisa com controles parentais.
• Proibido em todos os servidores: conteúdo sexual, NFTs, esquemas exploratórios de blockchain ou cripto, e apostas com dinheiro real. Aceitar criptomoeda como forma de pagamento é permitido.
• Servidores listados devem suportar os cosméticos oficiais, com substituições limitadas de tema permitidas se divulgadas.

Monetização e Divisão de Receita

Se você cobra dinheiro por qualquer coisa no seu servidor, esta seção se aplica a você.

• A monetização precisa ser verdadeira e legal. Servidores All Ages só podem exibir anúncios adequados para famílias. Servidores Teen, mature e adult devem divulgar compras que afetam a jogabilidade.
• Itens aleatórios pagos precisam de probabilidades numéricas publicadas, divulgação de "custo esperado" e doze meses de registros. Compras aleatórias duplas são totalmente proibidas.
• A divisão de receita se aplica a todos os servidores que monetizam, e é de 0% pelos primeiros dois anos, até 13 de janeiro de 2028.

Esse último ponto é um prazo real que vale a pena anotar se você está construindo algo comercial.

NOTA - Onde essas políticas conflitarem com o EULA ou os Termos de Serviço do Hytale, o EULA e os Termos de Serviço prevalecem, exceto onde as políticas forem expressamente designadas como Termos Adicionais para servidores listados.

Encaminhamento de Portas

O Hytale não publicou uma porta padrão de servidor em sua documentação pública, então verifique a configuração do seu próprio servidor em vez de confiar em um número que você leu em algum lugar.

O formato geral é o mesmo de qualquer servidor de jogo:

1. Descubra a porta em que seu servidor está vinculado, a partir da sua configuração ou da saída na inicialização.
2. Encaminhe-a no seu roteador para o IP interno da máquina do servidor.
3. Permita-a através do firewall do sistema operacional.

# Debian/Ubuntu with ufw, substituting your actual port
sudo ufw allow <port>/tcp

# Fedora/RHEL with firewalld
sudo firewall-cmd --permanent --add-port=<port>/tcp
sudo firewall-cmd --reload

A verificação de domínio para o Discovery usa um registro TXT DNS em vez de algo voltado para a rede, então essa parte não precisa de nenhuma porta aberta.

Mantendo-o Rodando no Linux

Depois de ter um comando de inicialização funcionando, envolva-o para que sobreviva a desconexões e reinicializações.

A versão rápida com screen:

screen -S hytale ./start.sh

Desanexe com CTRL + A depois D, reanexe com screen -r hytale.

A versão adequada, como uma unidade systemd em /etc/systemd/system/hytale.service:

[Unit]
Description=Hytale Dedicated Server
After=network.target

[Service]
Type=simple
User=hytale
WorkingDirectory=/home/hytale/server
ExecStart=/home/hytale/server/start.sh
Restart=on-failure
RestartSec=15
KillSignal=SIGINT
TimeoutStopSec=120

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now hytale

KillSignal=SIGINT e um TimeoutStopSec generoso dão ao servidor tempo para salvar o mundo no desligamento em vez de ser morto no meio de uma gravação. Isso importa mais do que parece.

Acompanhe o log com journalctl -u hytale -f.

Backups

O Hytale não anuncia um sistema de backup automático como o Valheim, então trate os backups como sua responsabilidade.

Faça backup de todo o diretório de dados do servidor, incluindo mundos e mods, em uma programação regular. Uma tarefa cron com rsync ou tar para um disco diferente já é suficiente:

0 */6 * * * tar czf /backups/hytale-$(date +\%Y\%m\%d-\%H\%M).tar.gz /home/hytale/server/UserData

Duas razões específicas do Hytale por que isso importa mais do que o normal:

• Early access. Atualizações chegam semanalmente durante o pré-lançamento e as coisas realmente quebram.
• Mods gravam nos mundos. Remover um mod que adicionou blocos ou entidades pode deixar um mundo em mau estado, exatamente como em qualquer block game.

Faça backup antes de cada atualização, não apenas em uma programação regular.

Escrevendo Seus Próprios Plugins

Se você for administrar um servidor a sério, acabará escrevendo algo para ele.

Os plugins do Hytale são em Java, e a documentação da Server API é gerada a partir do próprio servidor, cobrindo pacotes sob com.hypixel.hytale. A referência de assets documenta o formato JSON de cada asset que o servidor carrega, gerada a partir dos próprios codecs do servidor.

Duas coisas que vale a pena saber sobre a direção seguida:

• Não existe scripting baseado em texto e não vai existir. O estúdio argumentou que scripting no estilo Lua é um falso compromisso que deixa programadores lidando com duas linguagens e designers ainda aprendendo a programar.
• Scripting visual é o plano em vez disso, no espírito dos Unreal Blueprints, com programadores estendendo-o expondo novos nodes a partir do Java. A ferramenta Trigger Volume lançada na Update 5 é uma peça inicial disso, e foi construída explicitamente com suporte a mods para que modders possam adicionar seus próprios efeitos.

Solução de Problemas

Não consigo encontrar o download do servidor dedicado. Como mencionado acima, ainda não há um guia publicado de configuração de servidor standalone. Verifique accounts.hytale.com e pergunte no Discord oficial.

Minha listagem não aparece no Discovery. Verifique o status no cartão de listagem. Ela pode ainda estar na fila de moderação, que pode ser lenta durante uma onda de lançamento. Se foi aceita e depois desapareceu, seu servidor provavelmente parou de enviar heartbeats.

Jogadores dizem que precisam de mods para entrar. Não precisam. A modding do Hytale é do lado do servidor, e quem disser o contrário está descrevendo outro jogo.

Uma configuração voltou ao padrão após uma atualização. Leia as patch notes. Chaves de configuração foram renomeadas e removidas entre atualizações, e uma chave renomeada significa que seu valor está sendo ignorado.

O servidor não inicia após uma atualização. Verifique a versão do Java que a build atual espera, e leia as patch notes em busca de mudanças que quebram compatibilidade. Se parou de funcionar logo depois que você adicionou um plugin, remova o plugin e teste novamente.

Kernel do Linux muito antigo. O Hytale pede kernel 6.15 x64. Várias distribuições LTS vêm com versões mais antigas. Verifique com uname -r.

Posso rodar um servidor no macOS? O cliente é exclusivo para Apple Silicon no macOS, e o lado do servidor é a parte menos documentada de um jogo já jovem. Uma VM Linux ou uma máquina alugada é o caminho de menor resistência.

Conclusão

O modelo de servidor do Hytale é o mais limpo de qualquer jogo nesses guias, uma vez que a ideia central se encaixa: todo mundo é um servidor, mods são instalados uma vez pelo host, e os jogadores entram com um cliente vanilla e nada mais.

Para um grupo de amigos, hospedar a partir do cliente com um código de convite já é genuinamente suficiente. Para algo persistente e público, as partes totalmente documentadas hoje são o Server Discovery e as Server Operator Policies, ambas valem a pena ler com atenção antes de lançar qualquer coisa. A configuração do servidor standalone em si é a parte que ainda aguarda documentação oficial, e o Discord é a resposta honesta até que ela chegue.

Vamos reescrever essa seção adequadamente quando a Hypixel Studios a publicar.

Veja Também

• Hytale Documentation - O hub oficial de documentação para rodar servidores e criar mods.
• Hytale Server API reference - A API Java, para desenvolvedores de plugins.
• Asset reference - O formato JSON de cada asset que o servidor carrega.
• Server Operator Policies - Leitura obrigatória para quem for hospedar publicamente.
• Hytale Account Manager - Onde ficam os Server Profiles e os listings do Discovery.
• Official Server Lists announcement - O processo completo do Discovery, e a fonte usada nessa seção.
• Hytale Modding Strategy and Status
• Official Hytale Discord
• Hytale Wiki
• TMC App - Nosso próprio app, com um navegador de servidores, gráficos de latência ao vivo e RCON. Open source sob GPL-3.0 e em desenvolvimento bem inicial, então testar ou deixar feedback é realmente bem-vindo.

O Hytale está em early access e evoluindo rápido, então este guia vai precisar ser atualizado com mais frequência que a maioria. Se você encontrar uma instrução que não corresponde mais ao que está vendo, ou já tiver configurado um servidor standalone e puder preencher as lacunas acima, por favor reporte ou abra um pull request no repositório GitHub deste guia. Contribuições para este guia em particular seriam realmente úteis.

Junte-se ao nosso Discord server se tiver dúvidas ou quiser ajuda com qualquer coisa relacionada a servidores ou modding!