Come creare un server tModLoader

Cos'è tModLoader e il problema della versione

tModLoader è il modo standard per giocare a Terraria con le mod su PC: un'app gratuita e separata su Steam che esegue Terraria con le mod del proprio Steam Workshop. Un server tModLoader è la stessa idea lato server: carica le mod, e anche ogni giocatore si connette con tModLoader.

Due cose mettono spesso in difficoltà:

• Per il multiplayer è un gioco diverso. I giocatori tModLoader non possono entrare in un server vanilla, e i giocatori vanilla non possono entrare in uno tModLoader. Tutto il gruppo usa tModLoader.
• Si basa su un Terraria più vecchio. Terraria vanilla è alla 1.4.5 (l'aggiornamento "Bigger and Boulder" di gennaio 2026). tModLoader è ancora basato sulla 1.4.4, e non esiste ancora una versione 1.4.5 di tModLoader. Un mondo giocato sulla 1.4.5 non può essere aperto in tModLoader. Il contrario funziona: un mondo tModLoader può essere aperto in vanilla 1.4.5, e viene aggiornato quando lo si apre.

Quindi, se vuoi una partita moddata, crea il mondo in tModLoader. Non portarci il tuo mondo vanilla 1.4.5.

Configurare un server tModLoader a casa

Il modo rapido: ospitare dal gioco

Installa tModLoader da Steam (è gratuito, ma devi possedere Terraria su Steam), attiva le tue mod e scegli Multiplayer > Host & Play. Gli amici entrano tramite Steam. Il mondo gira sul tuo PC e si ferma quando esci.

Un server dedicato su Windows o macOS

1. Sistema prima la lista delle mod nel gioco. Iscriviti alle mod nel Workshop e attivale in tModLoader. Poi vai su Workshop > Mod Packs, scegli Save Enabled as New Mod Pack e Open Mod Pack Folder. Ora hai install.txt (gli ID del Workshop) e enabled.json (quali mod sono attive).
2. Avvia il server. Nella cartella di installazione di tModLoader (su Steam: clic destro su tModLoader > Manage > Browse local files), esegui start-tModLoaderServer.bat su Windows o start-tModLoaderServer.sh su macOS.
3. Rispondi alle domande: se usare Steam, quale mondo (o crearne uno), il numero massimo di giocatori, la porta (7777 di default), il port forwarding e una password.
4. Apri la porta. Inoltra la TCP 7777 del router verso il PC, e gli amici entrano con il tuo IP pubblico tramite Join via IP.

Mod e mondi si trovano in Documents/My Games/Terraria/tModLoader/: Mods/ contiene i file .tmod e enabled.json, Worlds/ contiene ogni mondo come file .wld più un file .twld con i dati delle mod. Tieni sempre insieme i due file di un mondo.

Su Linux

tModLoader include i propri strumenti per questo, chiamati DedicatedServerUtils. La documentazione consiglia di eseguire il server in Docker; l'alternativa è manage-tModLoaderServer.sh, che installa tModLoader (install-tml --github), scarica le mod del Workshop elencate nel tuo install.txt (install-mods) e avvia il server (start). Prima metti install.txt e enabled.json in tModLoader/Mods/ e il tuo mondo in tModLoader/Worlds/.

Per le parti vanilla (la console, serverconfig.txt, il port forwarding) vedi come creare un server Terraria; tModLoader accetta le stesse impostazioni.

Hosting di server tModLoader su HytHost

1. Scegli tModLoader all'ordine. Su hosting Terraria, scegli un piano e seleziona tModLoader come software del server. Per Calamity o Thorium, parti da Gold (6 GB).
2. Carica le tue mod. Nel file manager del GamePanel (o via sFTP), metti i file .tmod nella cartella mods/. Sul tuo PC li trovi in steamapps/workshop/content/1281930/, una cartella per ogni elemento del Workshop.
3. Carica enabled.json nella stessa cartella. È un semplice elenco di nomi di mod, per esempio ["CalamityMod","CalamityModMusic"]; ogni mod che vuoi attivare deve esserci.
4. Riavvia il server e leggi la console: elenca ogni mod mentre viene caricata e indica quella che fallisce, se succede.
5. Entra. Gli amici aprono tModLoader, scelgono Join via IP e inseriscono indirizzo e porta dal tuo pannello. Le mod mancanti vengono scaricate dal server all'ingresso.

Hai già un mondo moddato? Carica il .wld e il relativo .twld nella cartella dei mondi del server, oppure inviaceli e li migriamo gratuitamente. Oltre a tModLoader stesso non c'è nulla di preinstallato, quindi le versioni delle mod sono sempre quelle che hai scelto tu.

Configurazioni di mod popolari e quanta RAM servono

Le mod sono il fattore principale che determina la memoria di un server tModLoader. Le mod di contenuto aggiungono oggetti, nemici, boss e generazione del mondo, e tutto resta in memoria che qualcuno lo usi o no. Né tModLoader né le grandi mod pubblicano un dato ufficiale per i server, quindi la tabella qui sotto è la nostra raccomandazione, con un po' di margine:

Altre due cose aumentano la memoria: la dimensione del mondo (un mondo grande occupa circa il doppio della memoria di uno piccolo prima che entri qualcuno) e i giocatori sparsi per la mappa. Per confronto, un server vanilla a riposo resta ben sotto 1 GB su un mondo piccolo.

Per vedere quali mod sono pesanti, attiva Show Mod Memory Estimates nelle impostazioni di tModLoader. Se il server va in crash con OutOfMemoryException, servono più RAM o meno mod grandi: nessuna impostazione lo risolve.

Come gli amici ottengono le mod

Gli amici non devono raccogliere a mano la lista delle mod. Quando un client tModLoader si connette, confronta le sue mod con quelle del server (nome, versione e file) e scarica ciò che manca o è diverso direttamente dal server, poi ricarica e si connette. Le mod che il client ha e il server no vengono disattivate per quella sessione. Le mod contrassegnate come solo lato server non vengono mai inviate.

Cosa serve a ogni giocatore:

• tModLoader stesso, da Steam, alla stessa versione di tModLoader del server.
• "Download Mods From Servers" lasciato attivo nelle impostazioni di tModLoader. È attivo di default; se è disattivato, il client rifiuta ed elenca le mod che gli servirebbero.
• Fiducia nel server. tModLoader avverte che le mod possono contenere codice e vanno scaricate solo da un host di cui ti fidi. Sul tuo server, quell'host sei tu.

Errori comuni del server tModLoader

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

Le versioni di tModLoader sono diverse, e devono coincidere esattamente. Steam aggiorna automaticamente il tModLoader dei giocatori, quindi dopo una nuova release di tModLoader aggiorna anche il server. Lo stesso messaggio compare se per errore ti stai connettendo a un server vanilla sulla stessa porta.

Una mod manca o non si carica

Controlla che la mod sia in enabled.json con il suo nome interno (non quello visualizzato), che anche le sue dipendenze siano caricate e attive, e che il file .tmod sia la versione che hanno i tuoi amici. Il log del server indica la mod che ha fallito.

Memoria esaurita

OutOfMemoryException nel log significa che il server ha esaurito la RAM caricando o eseguendo le mod. Rimuovi una mod grande, usa un mondo più piccolo o passa a un piano superiore.

Il mondo non si apre

Di solito è un mondo giocato su vanilla 1.4.5, che tModLoader non può aprire. Può anche mancare il file .twld accanto al .wld, oppure una mod da cui il mondo dipende non è più attiva.

Il gioco non parte dopo aver installato una mod "64 bit"

Il vecchio elemento del Workshop "tModLoader 64 bit" è obsoleto (il tModLoader attuale è già a 64 bit) e installarlo impedisce l'avvio del gioco. Annulla l'iscrizione.