Um guia sobre como baixar e instalar mods em Hytale no Windows, Linux e macOS.
A modificação em Hytale funciona de forma diferente da maioria dos outros jogos para os quais escrevemos esses guias, e vale a pena entender essa diferença antes de baixar qualquer coisa. A Hypixel Studios construiu o Hytale com prioridade server-side. Os mods são instalados por quem hospeda o mundo, não por cada jogador, e o estúdio já declarou claramente que não pretende oferecer suporte a mods de cliente.
Isso parece restritivo até você perceber o que ganha com isso: você pode entrar em qualquer servidor com mods de Hytale sem instalar nada. Nada de client packs, nada de fazer malabarismos com versões, nada de perfis de launcher.
Nosso exemplo é o BetterMap, um plugin de servidor que dá ao mapa do jogo exploração persistente, waypoints e renderização de cavernas.
Requisitos
- Um PC com Windows, Linux ou macOS. Hytale tem builds nativas para os três.
- Uma cópia de Hytale, comprada em hytale.com. O jogo está em early access e não está na Steam.
- Espaço livre suficiente para o que você instalar. Asset packs com muitos modelos e texturas podem ficar grandes; plugins costumam ser pequenos.
- Um extrator de
.zip, embora em muitos casos você nem precise descompactar nada.
NOTA - Hytale está em early access desde janeiro de 2026 e ainda está evoluindo rapidamente. A Hypixel Studios tem sido abertamente autocrítica quanto ao estado das ferramentas de modding, descrevendo lacunas na documentação e sistemas que ainda estão brutos. Espere que as coisas mudem, e espere que um mod ocasionalmente quebre após uma atualização.
Modding Server-Side Explicado
A Hypixel Studios estabeleceu alguns princípios ao publicar sua estratégia de modding, e dois deles moldam tudo neste guia:
- Prioridade server-side. Toda a modificação de Hytale se baseia no host do servidor ou no host do jogo. Você deve conseguir entrar em qualquer servidor com mods de Hytale sem baixar mods externos ou fazer malabarismos com client packs.
- Uma comunidade, um cliente. Eles querem evitar um ecossistema em que cada servidor precise do seu próprio cliente modificado, para que o cliente permaneça estável e consistente enquanto os servidores fornecem a variação.
Na prática, isso significa que um mod é instalado uma vez, pelo host, e todo jogador que se conecta recebe a experiência modificada com um cliente completamente vanilla.
Singleplayer Também É Um Servidor
Esta é a parte que faz tudo o resto fazer sentido.
Hytale não tem um modo singleplayer separado no sentido tradicional. Quando você cria um mundo singleplayer, você está entrando em um servidor local que é só seu. Então "o host" é você, e instalar mods para singleplayer é a mesma operação que instalá-los em um servidor, em uma pasta diferente.
Você então seleciona quais mods quer por save, o que é um modelo genuinamente bom: um mundo com um overhaul, outro vanilla, sem troca de perfis.
Entrando No Servidor Com Mods De Outra Pessoa
Você não instala nada. Conecte-se ao servidor e jogue.
Os plugins e asset packs do host conduzem a experiência, e seu cliente renderiza o que o servidor determinar. É por isso que o navegador de servidores no jogo consegue fazer verificações de compatibilidade e mostrar apenas os servidores que você realmente pode acessar.
Os Quatro Tipos De Mod De Hytale
A modificação de Hytale se divide em quatro categorias técnicas, e saber com qual delas você está lidando indica o que esperar.
| Tipo | Formato | O que faz |
|---|---|---|
| Plugins de servidor | Java .jar |
Estendem o servidor programaticamente. Minijogos, economias, comandos, lógica personalizada. A categoria mais poderosa. |
| Data assets | JSON | Definem o conteúdo principal: blocos, itens, NPCs, geração de mundo, tabelas de loot e drops. |
| Art assets | Modelos, texturas, sons | A aparência e o som de tudo. Hytale oferece suporte ao Blockbench para modelos e animações. |
| Save files | Mundos e prefabs | Mundos inteiros, ou estruturas pré-construídas usadas em ferramentas criativas e geração de mundo. |
Asset Packs são o formato de empacotamento para as duas categorias do meio. Um asset pack é um zip ou uma pasta com um manifest.json dentro, contendo um conjunto personalizado de assets que sobrescrevem ou adicionam ao jogo base. Eles podem ser feitos no Asset Editor do jogo ou manualmente em um explorador de arquivos, embora o estúdio recomende o editor porque a estrutura de pastas é rígida.
BetterMap é um plugin de servidor, então está na primeira categoria.
NOTA - Não há Lua nem qualquer outra scripting baseada em texto em Hytale, e o estúdio já disse que não haverá. O plano deles é scripting visual, no espírito dos Unreal Blueprints, junto com Java para programadores.
Onde Os Mods Ficam
Duas localizações importam.
A pasta global de mods, usada por tudo:
C:\Users\<user>\AppData\Roaming\Hytale\UserData\Mods
A pasta de mods por mundo, que cada save também possui:
C:\Users\<user>\AppData\Roaming\Hytale\UserData\Saves\<World Name>\mods
No Linux e no macOS, a pasta UserData fica na localização equivalente de dados de aplicativo do seu sistema, com a mesma estrutura por baixo.
Qualquer coisa na pasta global Mods está disponível para qualquer mundo. Qualquer coisa na pasta mods própria de um mundo pertence apenas a esse mundo.
DICA - No Windows, cole %appdata%\Hytale\UserData na barra de endereço do Explorador de Arquivos para ir direto até lá.
Instalando Um Mod Para Singleplayer
- Vá até a seção Hytale da CurseForge e encontre um mod. Para este guia, abra BetterMap.
- Baixe-o.
- Abra sua pasta
UserData\Mods. - Coloque o arquivo baixado ali dentro. Asset packs podem permanecer zipados ou serem extraídos como uma pasta; plugins entram como
.jar. - Inicie o Hytale.
- Abra o menu New World e procure em Options. Seus mods e asset packs instalados aparecem ali.
- Ative os que você quer para este mundo e crie-o.
Esse último passo é o que as pessoas costumam deixar passar. Colocar um mod na pasta o torna disponível; você ainda precisa escolhê-lo por mundo quando o mundo é criado.
A CurseForge é o principal host, o que não é surpresa considerando que a Hypixel Studios realizou com eles o New Worlds Modding Contest, de $100.000. Havia mais de 5.000 mods de Hytale na plataforma no início de 2026, somando mais de 20 milhões de downloads.
Instalando Um Mod Em Um Servidor Dedicado
Para um servidor que você hospeda para outras pessoas, a ideia é idêntica, só que a pasta é a do próprio servidor.
- Baixe o mod.
- Coloque-o no diretório
modsdo servidor. - Reinicie o servidor.
BetterMap mantém tudo o que precisa ali, criando mods/bettermap/ para sua configuração e dados na primeira execução.
Jogadores que se conectam ao seu servidor não precisam instalar nada. Esse é justamente o ponto central do modelo.
Se você está configurando um servidor pela primeira vez, nosso guia separado de servidor Hytale cobre isso.
Instalando Com O TMC App
Como ainda não existe um gerenciador de mods para Hytale, vale mencionar isto. O TMC App é nosso próprio gerenciador de mods e navegador de servidores, com instalações de um clique e sandboxes: perfis de mods nomeados por jogo, cada um com sua própria ordem de carregamento e método de implantação, alternáveis sem precisar baixar nada novamente.
Hytale ainda não está na lista de jogos suportados, mas é uma boa combinação. O app funciona sabendo onde os mods de um jogo vão e como ele é iniciado, ambos definidos por quatro arquivos JSON em vez de código, e a pasta UserData\Mods do Hytale, sem nenhum loader envolvido, é praticamente o alvo mais simples que esse sistema pode ter. Os sandboxes também se encaixariam perfeitamente na seleção de mods por mundo do Hytale.
A posição honesta: o app está em estágio muito inicial de desenvolvimento. O README dele diz que está parcialmente testado e não vamos maquiar isso. O próprio Hytale está em early access e muda semanalmente, então são duas coisas jovens apontadas uma para a outra. Se você estiver disposto a isso, testar e reportar de volta é genuinamente útil.
É código aberto sob GPL-3.0 em github.com/modcommunity/tmc-app. Relatos de bugs e pedidos de funcionalidades vão no rastreador de issues, pull requests são bem-vindos, e o repositório documenta o formato por jogo caso você queira contribuir com suporte a Hytale antes de chegarmos lá.
Instalando-o:
- Linux: uma linha, sem root e sem gerenciador de pacotes.
curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh
- Windows: o
setup.exeousetup.msida página de releases. Há também uma versão portátil, embora ela não registre a entrada do launcher nem o manipulador de linktmc://. - macOS: o
.dmgda mesma página de releases.
Configurando Mods
Não há um padrão único, mas o modelo comum é uma configuração em JSON dentro da própria pasta do mod, sob mods.
BetterMap é um bom exemplo. Suas configurações ficam em mods/bettermap/config.json, e ele expõe coisas como raio de exploração, qualidade do mapa, taxa de atualização e se a exploração é compartilhada entre jogadores:
{
"explorationRadius": 16,
"updateRateMs": 500,
"mapQuality": "MEDIUM",
"shareAllExploration": false,
"radarEnabled": true
}
Plugins bem construídos também adicionam comandos de administração e permissões. BetterMap registra comandos /bm, incluindo /bm reload para aplicar mudanças de configuração sem reiniciar, embora observe que algumas configurações ainda exigem um reinício completo.
Leia a descrição do mod na CurseForge. Com a modding de Hytale ainda tão jovem, essa página costuma ser a única documentação que existe.
Mods Por Mundo
Asset packs criados dentro do jogo com o Asset Editor vão para a pasta mods própria daquele mundo, em vez da global. Isso é conveniente enquanto você está construindo algo, e confuso na primeira vez que você inicia um segundo mundo e se pergunta onde foi seu pack.
Para usar em outro mundo um pack que você criou em um mundo, copie-o de:
UserData\Saves\<World Name>\mods
para:
UserData\Mods
Uma vez na pasta global, ele aparece nas opções de todo novo mundo.
Plataformas
Hytale entrou em early access no Windows, macOS e Linux, e essa é a lista completa. Não há versão para console ou mobile, e o jogo não está na Steam.
O jogo cruzado entre essas três plataformas de desktop existe, e um suporte mais amplo a cross-platform tem sido parte do plano desde que o jogo foi readquirido, mas nada além do desktop existe hoje para instalar mods.
Atualizando E Removendo Mods
Ainda não há gerenciador de mods para Hytale, então ambos os processos são manuais.
- Atualizar: baixe a nova versão na CurseForge e substitua o arquivo antigo em
Mods. Verifique a página do mod para saber se sua configuração é mantida. - Remover: exclua o arquivo de
Mods, ou simplesmente desmarque o mod para um dado mundo. - Desativar apenas para um mundo: deixe o arquivo onde está e desmarque-o nas opções daquele mundo.
AVISO - Remover um mod que adicionou blocos, itens ou criaturas de um mundo que os usava pode deixar esse mundo em um estado ruim, assim como em qualquer jogo de blocos. Faça backup da pasta de save antes de retirar mods de um mundo existente.
Solução De Problemas
Meu mod não aparece nas opções de New World. Pasta errada. Ele precisa estar em UserData\Mods ou na própria pasta mods daquele mundo, e um asset pack precisa de um manifest.json válido.
Instalei um mod, mas o mundo em que já estou não mudou. Os mods são selecionados quando um mundo é criado. Mundos já existentes não recebem automaticamente mods instalados recentemente.
O pack que criei no jogo está faltando no meu outro mundo. Packs do Asset Editor são salvos no mundo em que foram criados. Copie-o para a pasta global Mods.
Um plugin carrega mas os comandos não fazem nada. Verifique as permissões. Os plugins do Hytale usam nós de permissão, e os comandos geralmente precisam de OP ou de uma concessão explícita.
Tudo quebrou depois de uma atualização do Hytale. Esperado, nesta fase. O Hytale roda patches semanais de pré-lançamento agrupados em versões estáveis a cada poucas semanas, e os mods precisam de tempo para se adaptar.
Os jogadores dizem que precisam instalar o mod para entrar. Não precisam. Se alguém estiver dizendo o contrário, essa pessoa está descrevendo como outro jogo funciona.
Posso usar mods do lado do cliente? Não. Não há suporte a mods do lado do cliente e o estúdio já disse que não há planos para isso.
Conclusão
O modding de Hytale se resume a uma única ideia: o host instala, todos os outros apenas jogam. Coloque o arquivo em UserData\Mods, marque-o ao criar um mundo, e pronto. Para um servidor dedicado é o mesmo arquivo, na pasta mods do próprio servidor.
É um modelo genuinamente diferente das configurações de BepInEx e mod loaders dos nossos outros guias, e depois que se entende a lógica dá muito menos trabalho. As ferramentas ainda são jovens e a documentação é irregular, algo que a Hypixel Studios admite prontamente, então apoie-se nas descrições dos mods e em docs.hytale.com enquanto as coisas se estabilizam.
Se você quiser ajudar com algo, o TMC App é open source, está em desenvolvimento bem inicial, e feedback sobre ele seria genuinamente apreciado.
Veja Também
- Hytale no CurseForge
- Documentação do Hytale - Documentação oficial para rodar servidores e criar mods.
- Criando Conteúdo no Hytale - Asset packs, geração de mundo e os editores.
- Estratégia e Status de Modding do Hytale - O relato do próprio estúdio sobre onde o modding está e para onde está indo. Vale a pena ler na íntegra.
- Discord Oficial do Hytale
- Wiki do Hytale
- TMC App
O Hytale está em early access e muda rápido, então este guia vai desatualizar mais do que a maioria. Se você encontrar uma instrução que não corresponde mais ao que está vendo, por favor reporte ou abra um pull request no repositório GitHub deste guia.
Junte-se ao nosso servidor do Discord se tiver alguma dúvida ou quiser ajuda com qualquer coisa relacionada a modding!