Como atualizar seu servidor Hytale para o Chapter I (Update 7) sem perder seu mundo

Desde o lançamento do Chapter I (Update 7) em 12 de outubro de 2026, o jogo de todos os jogadores se atualizou sozinho, mas o seu servidor não: enquanto ele continuar na Update 6, ninguém consegue entrar. Além disso, é a atualização mais delicada desde o início do acesso antecipado, porque ela converte o seu mundo sem volta e quebra boa parte dos mods. Veja o passo a passo, conferido na versão 0.7.2, para atualizar um servidor existente sem perder nada.

O que o Chapter I muda em um servidor existente

Se você está começando do zero, nosso guia para criar um servidor Hytale explica a instalação completa. Aqui partimos de um servidor que já roda na Update 6. Segundo as notas oficiais da Hypixel Studios, estas são as mudanças que afetam você diretamente:

Mudança	O que isso significa para você
Nova versão do protocolo de rede	Um cliente atualizado não consegue entrar em um servidor que continua na Update 6, e vice-versa.
Novo formato de armazenamento das seções de blocos	O mundo é convertido na primeira vez que carrega. Ele ocupa menos espaço, mas não pode mais ser aberto por uma versão anterior.
Muitos métodos da API de modding removidos ou substituídos	Mods .jar compilados para a Update 6 podem impedir o servidor de iniciar.
Assets renomeados e novo formato para alguns campos de áudio	Pacotes de conteúdo que usam os nomes antigos podem deixar de carregar.
Verificação da pasta de instalação do launcher	O servidor encerra com o código 11 se a pasta de trabalho, o mundo ou os backups estiverem dentro da pasta do launcher.
MaxViewRadius limitado a 32	Um valor fora do intervalo de 1 a 32 é ajustado com um aviso, sem bloquear a inicialização.
Comandos renomeados	/fragment vira /portal, /leave vira /portal leave e /cursethis vira /ephemeral.

Qual versão instalar: no mínimo a 0.7.2

Não pare na versão de lançamento 0.7.0. Vieram dois hotfixes depois, e os dois importam para servidores:

• 0.7.1 (13 de outubro): conexões a um mundo hospedado no Windows não expiram mais após 30 segundos, e um jogador cujo IP muda durante a sessão consegue reconectar sem ser recusado como “já conectado”.
• 0.7.2 (14 de outubro): corrige um crash que desconectava todos os jogadores de um mundo quando um chunk de caverna carregava um antigo sinalizador de spawn de goblins criado na Update 6. É exatamente o caso dos mundos convertidos. A 0.7.2 também corrige um crash no Linux em mundos que usam o armazenamento de chunks RocksDB.

No momento em que este artigo foi escrito, a 0.7.2 é o hotfix mais recente do Chapter I. Antes de começar, confira a versão disponível com /update check ou ./hytale-downloader -print-version.

Passo 1: planejar a manutenção

Avise os jogadores e reserve cerca de uma hora para o backup, a primeira inicialização e os testes. Depois, anote a versão atual pelo console:

/update status

Por fim, faça o inventário da pasta mods/: nome e versão de cada mod e se o autor já lançou uma versão para o Chapter I. Você vai precisar dessa lista no passo 3 e na hora de recolocar os mods.

Passo 2: fazer backup do mundo, sua única garantia de verdade

A pasta universe/ guarda os seus mundos e os dados dos jogadores. Como a conversão é de mão única, uma cópia feita antes da primeira inicialização na 0.7.x é o seu único caminho de volta. Pare o servidor corretamente com /stop e compacte o mundo, os arquivos de configuração e os mods, de preferência fora da pasta do servidor:

# Linux, a partir da pasta Server/
tar -czf ~/hytale-update6-$(date +%F).tar.gz universe mods config.json permissions.json whitelist.json bans.json

# Windows (PowerShell), a partir da pasta Server\
Compress-Archive -Path universe, mods, config.json, permissions.json, whitelist.json, bans.json -DestinationPath ..\hytale-update6.zip

Confira se o arquivo compactado não está vazio e se o tamanho é parecido com o da pasta universe/. Se algum dos arquivos da lista não existir no seu servidor, é só tirá-lo do comando.

O sistema de atualização integrado também pode fazer um backup completo antes de aplicar uma versão, com a opção RunBackupBeforeUpdate, mas só se houver uma pasta de backup configurada (--backup-dir). Trate isso como uma proteção extra, não como sua única cópia.

Passo 3: deixar os mods de lado

O Chapter I removeu ou substituiu uma longa lista de métodos que os mods usam para mexer com chunks, blocos e mundos. Um mod que chama um método que não existe mais pode falhar ao carregar ou até impedir o servidor inteiro de iniciar. Para uma atualização sem surpresas, inicie a nova versão sem nenhum mod:

mkdir mods-update6
mv mods/* mods-update6/

No Windows, basta mover o conteúdo de mods para uma pasta mods-update6 pelo Explorador de Arquivos.

Cuidado com mods que adicionam blocos ou itens. Se você carregar o seu mundo de verdade sem eles, esses blocos podem sumir ou ser substituídos. Nesse caso, faça a primeira inicialização sem mods em uma cópia do mundo e só abra o mundo principal depois de instalar as versões desses mods para o Chapter I.

Passo 4: instalar a nova versão

Método 1: o comando /update integrado

É o método oficial se o seu servidor segue a estrutura prevista pela Hypixel: uma pasta principal com o Assets.zip e o script start.sh ou start.bat, e o servidor rodando a partir da subpasta Server/. Sem essa estrutura, o sistema de atualização se desativa. O servidor também precisa estar autenticado com /auth login device.

/update check            # procura uma nova versão
/update download         # baixa para updater/staging/
/update apply --confirm  # faz backup e encerra o servidor (código 8)

O servidor não reinicia sozinho. Ele encerra com o código de saída 8, e é o script start.sh ou start.bat que detecta esse código, copia os novos arquivos (HytaleServer.jar, Assets.zip e os scripts) mantendo sua configuração, seus mundos e seus mods, e inicia o servidor de novo. Se você roda o java diretamente ou por um serviço que não usa esses scripts, a atualização para aí. Copiou os arquivos na mão e não tem os scripts? O comando /update setup cria os dois na pasta principal.

Se mudar de ideia antes de aplicar, /update cancel apaga a versão baixada.

Método 2: Hytale Downloader

Em uma VPS, a ferramenta oficial de linha de comando é o método mais previsível. Atualize primeiro a própria ferramenta e depois baixe a nova versão em uma pasta temporária:

./hytale-downloader -check-update            # atualiza a ferramenta, se preciso
./hytale-downloader -print-version           # mostra a versão disponível
./hytale-downloader -download-path hytale-0.7.2.zip
unzip hytale-0.7.2.zip -d nova-versao

Depois copie só os arquivos do jogo para o lugar certo: Server/HytaleServer.jar (e HytaleServer.aot, se existir), Assets.zip, além de start.sh e start.bat. Nunca substitua config.json, universe/ ou mods/ pelos que vêm no arquivo baixado.

Método 3: em uma hospedagem

No painel de uma hospedagem, a atualização costuma ser feita reinstalando a versão ou por um botão próprio. Mesmo assim, faça o backup do passo 2 e baixe-o para o seu computador antes de começar.

Passo 5: primeira inicialização e conversão do mundo

Inicie o servidor e acompanhe o console. No primeiro carregamento, cada mundo é convertido para o novo formato, o que pode deixar a inicialização mais lenta em um mundo grande: não interrompa. Depois confira:

• se /update status mostra a nova versão;
• se a pasta logs/ não tem erros;
• se aparece algum aviso sobre MaxViewRadius: nesse caso, pare o servidor e coloque em config.json um valor de 32 ou menos;
• se um primeiro jogador com o jogo atualizado consegue entrar, antes de reabrir o servidor para todo mundo.

Se o servidor encerrar na hora com o código 11, os dados dele estão dentro da pasta de instalação do launcher: mova a pasta do servidor para outro lugar. A opção --allow-install-dir força a inicialização, mas a Hypixel avisa que ela pode causar perda de dados.

Atualize também as tarefas agendadas e scripts de administração que ainda usam /fragment, /leave ou /cursethis.

Passo 6: recolocar os mods um por um

Para cada mod da sua lista, pegue a versão que o autor indica como compatível com o Chapter I, coloque em mods/, reinicie e leia os logs. Um mod de cada vez: se o servidor não iniciar, você sabe na hora qual é o culpado. Um mod sem versão compatível fica em mods-update6/ até o autor atualizá-lo.

Erros mais comuns depois da atualização

Sintoma	Causa	Solução
Todos os jogadores são recusados com uma mensagem de versão incompatível	O servidor ainda está na Update 6	Atualizar o servidor e reiniciá-lo
Só um jogador é recusado	O jogo dele está desatualizado ou ele usa outro canal (pre-release)	Reiniciar o launcher e conferir o canal release
O servidor encerra com o código 8	Comportamento normal de uma atualização	Iniciar o servidor com start.sh ou start.bat
O servidor encerra com o código 11	Dados na pasta do launcher	Mover o servidor para uma pasta própria
Um mod não carrega	Mod compilado para a Update 6	Removê-lo e esperar uma versão para o Chapter I
Todo mundo é desconectado ao explorar cavernas	Sinalizador antigo de spawn de goblins (corrigido na 0.7.2)	Instalar a 0.7.2
Um mundo trava no Linux	Armazenamento RocksDB (corrigido na 0.7.2)	Instalar a 0.7.2
As conexões expiram após 30 segundos em um servidor Windows	Bug corrigido na 0.7.1	Instalar a 0.7.2
/leave não funciona mais	Comando renomeado	Usar /portal leave

Como voltar atrás se der errado

Depois de uma atualização com /update, os arquivos anteriores do servidor ficam guardados em updater/backup/. O script oficial explica o procedimento: apagar Server/ e Assets.zip e depois trazer de volta os da pasta de backup. Esses arquivos não incluem o seu mundo antigo: como ele foi convertido, você também precisa substituir universe/ pela cópia do passo 2.

Lembre-se: um servidor que voltou para a Update 6 não vai aceitar jogadores cujo jogo já está no Chapter I. Voltar atrás serve principalmente para recuperar um mundo intacto, não para continuar jogando na versão antiga. Na maioria dos casos, o melhor é restaurar o backup, tirar o mod com problema e refazer a atualização.

Automatizar as próximas atualizações

Enquanto cliente e servidor precisarem ter exatamente a mesma versão do protocolo, cada nova versão vai obrigar você a atualizar rápido. A Hypixel anunciou uma tolerância de duas versões de diferença entre cliente e servidor, mas ela ainda não está disponível. Enquanto isso, a seção Update do config.json pode fazer o trabalho por você:

"Update": {
  "Enabled": true,
  "CheckIntervalSeconds": 3600,
  "RunBackupBeforeUpdate": true,
  "BackupConfigBeforeUpdate": true,
  "AutoApplyMode": "WhenEmpty",
  "AutoApplyDelayMinutes": 30
}

Com WhenEmpty, a atualização é aplicada assim que não há mais ninguém conectado. Scheduled aplica depois do prazo definido, mesmo com jogadores online, avisando antes. O valor padrão, Disabled, espera o seu /update apply --confirm. Em um servidor com muitos mods, fique no modo manual: uma atualização automática poderia reiniciar o servidor com mods que não funcionam mais. Para desligar o sistema por completo, defina a variável de ambiente HYTALE_DISABLE_UPDATES.

Atualizações sem estresse em uma hospedagem

Na OuiHeberg, todo plano OuiBox compatível com Hytale inclui backups para fazer antes de uma atualização: 5 no OuiBox 8G por 9,98 € por mês, 10 no OuiBox 12G por 16,79 € por mês e 15 no OuiBox 16G por 21,59 € por mês. Você cria o backup pelo painel, atualiza e restaura se algo der errado, sem linha de comando.

Perguntas frequentes

Vou perder meu mundo ao passar para o Chapter I?

Não. O mundo é convertido automaticamente e mantém suas construções. Mas a conversão é definitiva: sem uma cópia feita antes da atualização, não há como voltar para a Update 6.

Por que meus amigos não conseguem mais entrar no meu servidor desde 12 de outubro?

O jogo deles passou para o Chapter I e o seu servidor ficou na Update 6. Os dois precisam usar exatamente a mesma versão do protocolo: atualize o servidor.

Meus mods ainda funcionam na Update 7?

Não necessariamente. Grande parte da API usada pelos mods mudou. Só são seguros os mods recompilados pelo autor para o Chapter I.

Preciso autenticar o servidor de novo depois de atualizar?

Normalmente não, porque os arquivos de autenticação ficam na pasta Server/. Se o servidor pedir, rode /auth login device de novo: desde o Chapter I, o comando funciona mesmo com uma sessão já ativa.

Como descubro a versão do meu servidor?

Digite /update status no console. Para ver a versão mais recente disponível, use /update check ou ./hytale-downloader -print-version.