Como criar um servidor tModLoader

O que é o tModLoader e a pegadinha da versão

O tModLoader é a forma padrão de jogar Terraria com mods no PC: um app gratuito e separado na Steam que roda o Terraria com mods do seu próprio Steam Workshop. Um servidor tModLoader é a mesma ideia do lado do servidor: ele carrega os mods, e todos os jogadores também se conectam com o tModLoader.

Duas coisas costumam confundir:

• Para o multiplayer, é outro jogo. Jogadores do tModLoader não conseguem entrar num servidor vanilla, e jogadores vanilla não conseguem entrar num servidor tModLoader. Todo o grupo usa tModLoader.
• Ele roda um Terraria mais antigo. O Terraria vanilla está na 1.4.5 (a atualização "Bigger and Boulder" de janeiro de 2026). O tModLoader ainda é baseado na 1.4.4, e ainda não existe uma versão 1.4.5 do tModLoader. Um mundo jogado na 1.4.5 não pode ser aberto no tModLoader. O contrário funciona: um mundo do tModLoader pode ser aberto no vanilla 1.4.5, e é atualizado ao ser aberto.

Então, se você quer uma partida com mods, crie o mundo no tModLoader. Não leve seu mundo vanilla 1.4.5 para ele.

Montar um servidor tModLoader em casa

O jeito rápido: hospedar pelo jogo

Instale o tModLoader pela Steam (é gratuito, mas você precisa ter o Terraria na Steam), ative seus mods e escolha Multiplayer > Host & Play. Os amigos entram pela Steam. O mundo roda no seu PC e para quando você sai.

Um servidor dedicado no Windows ou macOS

1. Acerte primeiro a lista de mods no jogo. Inscreva-se nos mods no Workshop e ative-os no tModLoader. Depois vá em Workshop > Mod Packs, escolha Save Enabled as New Mod Pack e Open Mod Pack Folder. Agora você tem o install.txt (os IDs do Workshop) e o enabled.json (quais mods estão ativos).
2. Inicie o servidor. Na pasta de instalação do tModLoader (na Steam: clique com o botão direito em tModLoader > Manage > Browse local files), execute start-tModLoaderServer.bat no Windows ou start-tModLoaderServer.sh no macOS.
3. Responda às perguntas: se vai usar a Steam, qual mundo (ou criar um), o máximo de jogadores, a porta (7777 por padrão), o redirecionamento de portas e uma senha.
4. Abra a porta. Redirecione a TCP 7777 no roteador para o PC, e os amigos entram com seu IP público por Join via IP.

Mods e mundos ficam em Documents/My Games/Terraria/tModLoader/: Mods/ guarda os arquivos .tmod e o enabled.json, e Worlds/ guarda cada mundo como um .wld mais um arquivo .twld com os dados dos mods. Mantenha os dois arquivos de um mundo juntos.

No Linux

O tModLoader traz suas próprias ferramentas para isso, chamadas DedicatedServerUtils. A documentação recomenda rodar o servidor no Docker; a alternativa é o manage-tModLoaderServer.sh, que instala o tModLoader (install-tml --github), baixa os mods do Workshop listados no seu install.txt (install-mods) e inicia o servidor (start). Antes, coloque install.txt e enabled.json em tModLoader/Mods/ e seu mundo em tModLoader/Worlds/.

Para a parte vanilla (o console, o serverconfig.txt, o redirecionamento de portas), veja como criar um servidor de Terraria; o tModLoader aceita as mesmas configurações.

Hospedagem de servidor tModLoader na HytHost

1. Escolha o tModLoader na compra. Em hospedagem de Terraria, escolha um plano e selecione tModLoader como software do servidor. Para Calamity ou Thorium, comece pelo Gold (6 GB).
2. Envie seus mods. No gerenciador de arquivos do GamePanel (ou por sFTP), coloque os arquivos .tmod na pasta mods/. No seu PC, eles ficam em steamapps/workshop/content/1281930/, uma pasta por item do Workshop.
3. Envie o enabled.json para a mesma pasta. É uma lista simples de nomes de mods, por exemplo ["CalamityMod","CalamityModMusic"]; todo mod que você quiser ativo precisa estar nela.
4. Reinicie o servidor e leia o console: ele lista cada mod enquanto carrega e aponta qual falhou, se algum falhar.
5. Entre. Os amigos abrem o tModLoader, escolhem Join via IP e digitam o endereço e a porta do seu painel. Os mods que faltarem são baixados do servidor na entrada.

Já tem um mundo com mods? Envie o .wld e o respectivo .twld para a pasta de mundos do servidor, ou mande para nós e fazemos a migração de graça. Nada além do próprio tModLoader vem pré-instalado, então as versões dos mods são sempre as que você escolheu.

Configurações de mods populares e quanta RAM elas precisam

Os mods são o que mais define a memória de um servidor tModLoader. Mods de conteúdo adicionam itens, inimigos, chefes e geração de mundo, e tudo isso fica na memória, esteja alguém usando ou não. Nem o tModLoader nem os grandes mods publicam um número oficial para servidores, então a tabela abaixo é a nossa recomendação, com alguma folga:

Outras duas coisas aumentam a memória: o tamanho do mundo (um mundo grande ocupa cerca do dobro da memória de um pequeno antes de alguém entrar) e os jogadores espalhados pelo mapa. Para comparar, um servidor vanilla ocioso fica bem abaixo de 1 GB num mundo pequeno.

Para ver quais mods são pesados, ative Show Mod Memory Estimates nas configurações do tModLoader. Se o servidor travar com OutOfMemoryException, ele precisa de mais RAM ou de menos mods grandes: nenhuma configuração resolve isso.

Como os amigos recebem os mods

Os amigos não precisam juntar a lista de mods na mão. Quando um cliente tModLoader entra, ele compara seus mods com os do servidor (nome, versão e arquivo) e baixa o que estiver faltando ou diferente direto do servidor, depois recarrega e conecta. Mods que o cliente tem e o servidor não são desativados naquela sessão. Mods marcados como apenas do lado do servidor nunca são enviados.

O que cada jogador precisa:

• O próprio tModLoader, pela Steam, na mesma versão do tModLoader do servidor.
• "Download Mods From Servers" ligado nas configurações do tModLoader. Vem ligado por padrão; se estiver desligado, o cliente recusa e lista os mods de que precisaria.
• Confiança no servidor. O tModLoader avisa que mods podem conter código e só devem ser baixados de um host em que você confia. No seu próprio servidor, esse host é você.

Erros comuns do servidor tModLoader

"You are not using the same version as this server"

As versões do tModLoader são diferentes, e precisam ser exatamente iguais. A Steam atualiza o tModLoader dos jogadores automaticamente, então, depois de um lançamento do tModLoader, atualize o servidor também. A mesma mensagem aparece se você estiver se conectando sem querer a um servidor vanilla na mesma porta.

Um mod está faltando ou não carrega

Confira se o mod está no enabled.json com o nome interno (não o nome de exibição), se as dependências também foram enviadas e ativadas, e se o arquivo .tmod é a versão que seus amigos têm. O log do servidor aponta o mod que falhou.

Falta de memória

OutOfMemoryException no log significa que o servidor ficou sem RAM ao carregar ou rodar os mods. Remova um mod grande, use um mundo menor ou mude para um plano maior.

O mundo não abre

Normalmente é um mundo jogado no vanilla 1.4.5, que o tModLoader não consegue abrir. Também pode ser um arquivo .twld faltando ao lado do .wld, ou um mod do qual o mundo depende que não está mais ativo.

O jogo não inicia depois de instalar um mod "64 bit"

O antigo item do Workshop "tModLoader 64 bit" está obsoleto (o tModLoader atual já é 64 bits) e instalá-lo impede o jogo de abrir. Cancele a inscrição nele.