Como criar um servidor tModLoader

O que é o tModLoader e o problema da versão

O tModLoader é a forma padrão de jogar Terraria com mods no PC: uma aplicação gratuita e separada no Steam que executa o Terraria com mods do seu próprio Steam Workshop. Um servidor tModLoader é a mesma ideia do lado do servidor: carrega os mods, e todos os jogadores também se ligam com o tModLoader.

Há duas coisas que costumam baralhar as pessoas:

• Para o multijogador, é outro jogo. Os jogadores do tModLoader não conseguem entrar num servidor vanilla, e os jogadores vanilla não conseguem entrar num servidor tModLoader. Todo o grupo usa o tModLoader.
• Funciona sobre um Terraria mais antigo. O Terraria vanilla está na 1.4.5 (a atualização "Bigger and Boulder" de janeiro de 2026). O tModLoader continua 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 quando isso acontece.

Por isso, se quer uma partida com mods, crie o mundo no tModLoader. Não leve para lá o seu mundo vanilla 1.4.5.

Configurar um servidor tModLoader em casa

A forma rápida: alojar a partir do jogo

Instale o tModLoader a partir do Steam (é gratuito, mas tem de ter o Terraria no Steam), ative os seus mods e escolha Multiplayer > Host & Play. Os amigos entram através do Steam. O mundo corre no seu PC e para quando sai.

Um servidor dedicado em Windows ou macOS

1. Acerte primeiro a lista de mods no jogo. Subscreva os mods no Workshop e ative-os no tModLoader. Depois vá a Workshop > Mod Packs, escolha Save Enabled as New Mod Pack e Open Mod Pack Folder. Fica com o install.txt (os IDs do Workshop) e o enabled.json (que mods estão ativos).
2. Inicie o servidor. Na pasta de instalação do tModLoader (no 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 quer usar o Steam, que mundo (ou criar um), o número máximo de jogadores, a porta (7777 por predefinição), o reencaminhamento de portas e uma palavra-passe.
4. Abra a porta. Reencaminhe a TCP 7777 no router para o PC, e os amigos entram com o seu IP público através de Join via IP.

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

Em Linux

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

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

Alojamento de servidores tModLoader na HytHost

1. Escolha o tModLoader na encomenda. Em alojamento de Terraria, escolha um plano e selecione tModLoader como software do servidor. Para Calamity ou Thorium, comece pelo Gold (6 GB).
2. Carregue os seus mods. No gestor de ficheiros do GamePanel (ou por sFTP), coloque os ficheiros .tmod na pasta mods/. No seu PC, encontra-os em steamapps/workshop/content/1281930/, uma pasta por cada item do Workshop.
3. Carregue o enabled.json para a mesma pasta. É uma lista simples de nomes de mods, por exemplo ["CalamityMod","CalamityModMusic"]; todos os mods que quer ativos têm de estar nela.
4. Reinicie o servidor e leia a consola: mostra cada mod à medida que carrega e indica qual falha, se algum falhar.
5. Entre. Os amigos abrem o tModLoader, escolhem Join via IP e introduzem o endereço e a porta do seu painel. Os mods em falta são descarregados do servidor à entrada.

Já tem um mundo com mods? Carregue o .wld e o respetivo .twld para a pasta de mundos do servidor, ou envie-nos os ficheiros e fazemos a migração gratuitamente. Além do próprio tModLoader, nada vem pré-instalado, por isso as versões dos mods são sempre as que escolheu.

Configurações de mods populares e quanta RAM precisam

Os mods são o principal fator que define a memória de um servidor tModLoader. Os mods de conteúdo acrescentam itens, inimigos, bosses e geração de mundo, e tudo isso fica em memória, quer alguém o use ou não. Nem o tModLoader nem os grandes mods publicam um valor oficial para servidores, por isso a tabela abaixo é a nossa recomendação, com alguma margem:

Há mais duas coisas que 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 comparação, um servidor vanilla em repouso fica bem abaixo de 1 GB num mundo pequeno.

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

Como os amigos obtêm os mods

Os amigos não têm de reunir a lista de mods à mão. Quando um cliente tModLoader se liga, compara os seus mods com os do servidor (nome, versão e ficheiro) e descarrega o que falta ou é diferente diretamente do servidor, depois recarrega e liga-se. Os mods que o cliente tem e o servidor não ficam desativados nessa sessão. Os mods marcados como apenas do lado do servidor nunca são enviados.

O que cada jogador precisa:

• O próprio tModLoader, a partir do Steam, na mesma versão do tModLoader do servidor.
• "Download Mods From Servers" ativado nas definições do tModLoader. Está ativado por predefinição; se estiver desativado, o cliente recusa e lista os mods de que precisaria.
• Confiança no servidor. O tModLoader avisa que os mods podem conter código e só devem ser descarregados de um host em que 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 têm de coincidir exatamente. O Steam atualiza automaticamente o tModLoader dos jogadores, por isso, depois de um lançamento do tModLoader, atualize também o servidor. A mesma mensagem aparece se estiver a ligar-se por engano a um servidor vanilla na mesma porta.

Um mod está em falta ou não carrega

Verifique se o mod está no enabled.json com o nome interno (não o nome de apresentação), se as dependências também foram carregadas e ativadas, e se o ficheiro .tmod é a versão que os seus amigos têm. O log do servidor indica o mod que falhou.

Falta de memória

OutOfMemoryException no log significa que o servidor ficou sem RAM ao carregar ou executar os mods. Remova um mod grande, use um mundo mais pequeno 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 faltar o ficheiro .twld ao lado do .wld, ou um mod de que o mundo depende já não estar ativo.

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

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