Como Configurar um Servidor Hytale: Guia Completo de Instalação e Configuração 2026

Pronto para hospedar o seu próprio servidor Hytale? Quer esteja a configurar um mundo privado para amigos ou a lançar um servidor comunitário público, este guia completo acompanha-o em cada etapa do processo — desde a instalação do Java até à otimização de desempenho para centenas de jogadores. No final deste guia, terá um servidor dedicado Hytale totalmente funcional pronto para os jogadores se juntarem. Vamos começar. Requisitos do Sistema Antes de iniciar a instalação, certifique-se de que a sua máquina servidor cumpre estes requisitos mínimos: ComponenteMínimoRecomendado RAM4 GB8-16 GB CPU2 núcleos4+ núcleos Armazenamento10 GB SSD50+ GB NVMe SSD JavaJava 25Java 25 (Adoptium recomendado) Arquiteturax64 ou arm64 suportados SOWindows, Linux ou macOS Compreender o Uso de Recursos O consumo de recursos do servidor Hytale depende muito do comportamento dos jogadores: Uso de CPU: Determinado pela contagem de jogadores e entidades (NPCs, mobs, criaturas ativas) Uso de RAM: Determinado pela área do mundo carregada — maior distância de visualização e jogadores a explorar independentemente aumentam as necessidades de memória Dica Pro: Monitorize o uso de RAM e CPU durante o jogo para entender o consumo típico do seu servidor. Se notar uso elevado de CPU, pode indicar pressão de memória a causar recolha excessiva de lixo — tente ajustar o parâmetro -Xmx do Java. Passo 1: Instalar Java 25 Os servidores Hytale requerem Java 25. Recomendamos o uso do Adoptium (anteriormente AdoptOpenJDK) para compilações fiáveis e prontas para produção. Descarregar Java 25 Visite adoptium.net Descarregue o instalador JDK 25 para o seu sistema operativo Execute o instalador e siga as instruções Verificar Instalação Abra um terminal ou linha de comandos e execute: java --version Deverá ver uma saída semelhante a: openjdk 25.0.1 2025-10-21 LTS OpenJDK Runtime Environment Temurin-25.0.1+8 (build 25.0.1+8-LTS) OpenJDK 64-Bit Server VM Temurin-25.0.1+8 (build 25.0.1+8-LTS, mixed mode, sharing) Se vir uma versão diferente ou um erro, certifique-se de que o Java 25 está corretamente instalado e adicionado ao PATH do sistema. Passo 2: Obter Ficheiros do Servidor Tem duas opções para obter os ficheiros do servidor Hytale: Opção A: Copiar da Sua Instalação do Jogo (Teste Rápido) O método mais fácil para uma configuração rápida — copie os ficheiros diretamente da instalação do launcher Hytale: Localizações dos Ficheiros: Sistema OperativoCaminho 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 Assets.zip para a localização do seu servidor dedicado. Opção B: Hytale Downloader CLI (Servidores de Produção) Para ambientes de produção, utilize a ferramenta oficial Hytale Downloader CLI. Isto facilita as atualizações e suporta automação: Descarregue hytale-downloader.zip do site oficial de suporte Hytale Extraia e leia o QUICKSTART.md incluído Execute o downloader para obter os ficheiros mais recentes do servidor Comandos Comuns: ComandoDescrição ./hytale-downloaderDescarregar a versão mais recente ./hytale-downloader -print-versionMostrar a versão do jogo sem descarregar ./hytale-downloader -patchline pre-releaseDescarregar do canal de pré-lançamento Passo 3: Iniciar o Seu Servidor Navegue até ao diretório do servidor e inicie com: java -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets Assets.zip A flag -XX:AOTCache utiliza a cache Ahead-Of-Time pré-treinada que vem com o servidor, melhorando significativamente os tempos de arranque. Autenticação Inicial Após o primeiro arranque, deve autenticar o seu servidor. Na consola do servidor, execute: /auth login device Verá um pedido de autorização de dispositivo: =================================================================== DEVICE AUTHORIZATION =================================================================== Visit: https://accounts.hytale.com/device Enter code: ABCD-1234 =================================================================== Waiting for authorization (expires in 900 seconds)... Visite o URL mostrado no seu navegador Inicie sessão com a sua conta Hytale Introduza o código mostrado na consola Volte à consola — deverá ver "Authentication successful!" Importante: Cada licença de jogo Hytale suporta até 100 servidores. Para implantações maiores, adquira licenças adicionais ou candidate-se a uma conta de Fornecedor de Servidores. Passo 4: Configurar Portas e Firewall O Hytale usa protocolo QUIC sobre UDP (não TCP). Isto é importante para a configuração de firewall e encaminhamento de portas. Porta Predefinida A porta predefinida é 5520. Para usar uma porta diferente: java -jar HytaleServer.jar --assets Assets.zip --bind 0.0.0.0:3500 Encaminhamento de Portas Se hospedar atrás de um router, encaminhe a porta UDP 5520 (ou a sua porta personalizada) para a máquina do servidor. O encaminhamento TCP não é necessário. Configuração de Firewall Windows (PowerShell como Administrador): New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow Linux (iptables): sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT Linux (ufw): sudo ufw allow 5520/udp Considerações sobre NAT O QUIC lida bem com a travessia de NAT na maioria dos cenários. Se os jogadores tiverem dificuldade em conectar: Certifique-se de que o encaminhamento de portas é especificamente para UDP, não TCP Configurações de NAT simétrico podem causar problemas — considere um VPS ou servidor dedicado Jogadores atrás de NAT de operadora (comum em dispositivos móveis) devem conseguir conectar como clientes Estrutura de Ficheiros do Servidor Compreender a estrutura de ficheiros do servidor ajuda na gestão e resolução de problemas: CaminhoDescrição .cache/Cache de ficheiros otimizados logs/Ficheiros de registo do servidor mods/Mods instalados universe/Dados de salvamento do mundo e jogadores bans.jsonLista de jogadores banidos config.jsonConfiguração do servidor permissions.jsonConfiguração de permissões whitelist.jsonJogadores na lista branca Estrutura do Mundo Os mundos são armazenados em universe/worlds/. Cada mundo tem o seu próprio config.json com definições para: Semente do mundo e tipo de geração PvP ativado/desativado Definições de dano de queda Comportamento de aparecimento de NPCs Plugins necessários Cada mundo é executado na sua própria thread principal, com trabalho paralelo distribuído por um pool de threads partilhado. Instalar Mods Adicionar mods ao seu servidor Hytale é simples: Descarregue mods (ficheiros .zip ou .jar) do CurseForge ou outras fontes confiáveis Coloque os ficheiros dos mods na pasta mods/ do servidor Reinicie o servidor Nota: Muitos mods funcionam apenas no lado do servidor — os jogadores que se juntam ao seu servidor receberão automaticamente o conteúdo do mod sem instalação manual. Otimização de Desempenho Distância de Visualização A distância de visualização é o principal fator de uso de RAM. A distância de visualização padrão de 384 blocos (12 chunks) é equivalente a aproximadamente 24 chunks do Minecraft. Recomendações: Para servidores pequenos (1-10 jogadores): As definições padrão funcionam bem Para servidores médios (10-50 jogadores): Considere limitar a 8-10 chunks Para servidores grandes (50+ jogadores): Limite a 6-8 chunks e monitorize os recursos Plugins Recomendados Os principais fornecedores de hosting mantêm plugins úteis para gestão de servidores: PluginDescrição Nitrado:WebServerPlugin base para aplicações web e APIs Nitrado:QueryExpõe o estado do servidor via HTTP (contagem de jogadores, etc.) Nitrado:PerformanceSaverLimita dinamicamente a distância de visualização com base nos recursos ApexHosting:PrometheusExporterExpõe métricas detalhadas do servidor e JVM Desativar Sentry Durante o Desenvolvimento Se estiver a desenvolver plugins, desative o relatório de crashes para evitar submeter erros de desenvolvimento: java -jar HytaleServer.jar --assets Assets.zip --disable-sentry Referência de Comandos do Servidor Veja todos os argumentos disponíveis do servidor com: java -jar HytaleServer.jar --help Argumentos Comuns: ArgumentoDescrição --assets <path>Caminho para Assets.zip (padrão: ../HytaleAssets) --bind <address:port>Endereço para escutar (padrão: 0.0.0.0:5520) --auth-mode <mode>Modo de autenticação: authenticated ou offline --backupAtivar backups automáticos --backup-dir <path>Localização do diretório de backup --backup-frequency <minutes>Intervalo de backup (padrão: 30) --disable-sentryDesativar relatório de crashes Arquitetura Multisservidor O Hytale suporta nativamente o encaminhamento de jogadores entre servidores — sem necessidade de proxy reverso como BungeeCord. Referência de Jogador Transfira jogadores conectados para outros servidores com um payload de dados opcional: PlayerRef.referToServer(host, port, optionalData) Nota de Segurança: O payload passa pelo cliente e pode ser adulterado. Use assinatura criptográfica (por exemplo, HMAC com um segredo partilhado) para verificar a autenticidade no servidor recetor. Redirecionamento de Conexão Durante o handshake de conexão, redirecione jogadores para diferentes servidores para balanceamento de carga ou encaminhamento regional. Fallback de Desconexão Quando os jogadores se desconectam inesperadamente (crash do servidor, problemas de rede), o cliente reconecta automaticamente a um servidor fallback pré-configurado em vez de retornar ao menu principal. Colocar o Seu Servidor na Lista Quando o seu servidor estiver em execução, coloque-o à frente dos jogadores: Submeta no HytaleCharts: Adicione o seu servidor à nossa lista de servidores para exposição gratuita Descoberta Oficial de Servidores: Opte pelo navegador de servidores integrado do Hytale (em breve) Construa a Sua Comunidade: Crie um servidor Discord e presença nas redes sociais Dicas para Melhores Rankings: Mantenha alta disponibilidade (99%+) Mantenha o seu servidor atualizado para a versão mais recente Escreva uma descrição de servidor apelativa com palavras-chave relevantes Encoraje os jogadores a votar no seu servidor Resolução de Problemas Comuns Jogadores Não Conseguem Conectar Verifique se o firewall permite UDP na porta 5520 Confirme que o encaminhamento de portas está configurado para UDP (não TCP) Verifique se o servidor está autenticado Certifique-se de que os jogadores estão na mesma versão do jogo que o servidor Uso Elevado de Memória Reduza a distância de visualização Limite a contagem máxima de jogadores Verifique mods que consomem muita memória Ajuste o parâmetro -Xmx adequadamente Lag no Servidor Monitorize a contagem de entidades (demasiados mobs/NPCs) Verifique o uso de CPU durante os picos Use plugins de monitorização de desempenho Considere atualizar o hardware se consistentemente no máximo Problemas de Autenticação Execute novamente /auth login device Certifique-se de que a sua conta Hytale está em boa situação Verifique se não excedeu o limite de 100 servidores por licença Pontos-Chave Java 25 Necessário: Use Adoptium para compilações fiáveis Porta UDP 5520: O protocolo QUIC requer UDP, não TCP Autenticação Necessária: Execute /auth login device após o primeiro arranque Distância de Visualização = RAM: Reduza a distância de visualização para diminuir o uso de memória Cache AOT: Use -XX:AOTCache=HytaleServer.aot para arranque mais rápido Pasta de Mods: Coloque mods em mods/ e reinicie Multisservidor Nativo: Sem necessidade de proxy para transferências entre servidores O seu servidor Hytale está agora pronto para jogadores. Submeta-o no HytaleCharts para começar a construir a sua comunidade!