Mod e plugin per server Terraria – estensioni tShock

Con tShock estendi un server Terraria con plugin, permessi, regioni, funzioni di protezione e strumenti amministrativi. Non conta la quantità di estensioni, ma un'installazione controllata: scegliere la versione adatta, posizionare correttamente la DLL, impostare i permessi in modo pulito e verificare dopo ogni riavvio se server, mondo e accesso dei giocatori funzionano come previsto.

Requisiti per i plugin tShock

Per i plugin Terraria ti serve un server che esegua tShock. Il normale server Vanilla non carica plugin tShock da ServerPlugins/. Se stai appena pianificando il tuo server, trovi le basi per configurarlo nella guida Noleggiare un server Terraria e configurare il multiplayer. Lì si parla della base, mentre questa guida tratta l'estensione tramite tShock.

Prima di ogni installazione controlla tre punti: la versione di Terraria, la versione di tShock e la versione del plugin devono essere compatibili tra loro. Trovi informazioni ufficiali su tShock nella documentazione sotto Documentazione su github.com. Per scaricare plugin, la panoramica esistente tShock Plugins è un buon punto di partenza, purché tu faccia attenzione anche ad attualità, note del repository e indicazioni di compatibilità.

Un hosting multi-game a pagamento come game-serverhosting è utile soprattutto quando ti servono accesso tecnico, procedure riproducibili, backup e supporto per gestione e configurazione del server. I plugin restano comunque codice server di terze parti: installa solo estensioni di cui riesci a capire origine e scopo.

Sistema plugin tShock

tShock è un server Terraria alternativo con gestione dei permessi, comandi e interfaccia per plugin. Di norma i plugin vengono forniti come .dll e caricati lato server. Normalmente i giocatori non devono installare questi plugin localmente, finché il plugin non richiede una modifica client separata.

La cartella centrale è:

ServerPlugins/

Lì si trovano le DLL dei plugin. All'avvio tShock carica i file e segnala errori nella console o nel log. Se un plugin non è compatibile, mancano dipendenze o una configurazione non è valida, il server può anche avviarsi comunque, ma il plugin resta disattivato o genera messaggi di errore.

Installazione

1. Scaricare la DLL del plugin da tShock Plugins
2. Inserirla nella cartella ServerPlugins/
3. Riavviare il server
4. Ricaricare con /reload (senza restart)

Usa /reload solo per modifiche che tShock e il rispettivo plugin possono davvero rileggere. Per nuove DLL, cambi di versione o errori poco chiari, un riavvio completo è il controllo più pulito. Pianifica le modifiche preferibilmente fuori dagli orari di gioco attivi, così puoi leggere i log e fare subito rollback in caso di problemi.

Plugin consigliati

La tabella seguente elenca estensioni tipiche usate spesso per amministrazione, protezione o gameplay. Non garantisce la compatibilità attuale; prima dell'uso controlla sempre la pagina del relativo plugin e la versione tShock supportata.

Installa inizialmente solo uno o due plugin e testali. Più estensioni sono attive contemporaneamente, più difficile diventa cercare gli errori. Per setup mod più grandi in altri giochi survival valgono principi simili: anche per Installare mod di V Rising o per Installare mod Palworld su server e client, il controllo delle versioni è più importante di una quantità cieca di plugin.

Server-Side Characters (SSC)

SSC salva i dati dei personaggi lato server. Questo può ridurre il cheating, perché i giocatori non possono semplicemente portare qualsiasi stato personaggio locale. Allo stesso tempo SSC cambia sensibilmente il flusso di gioco: inventario, progressi ed equipaggiamento iniziale dipendono poi dal server. Attiva quindi questa funzione con consapevolezza e informa prima la tua community.

{
  "ServerSideCharacterConfig": {
    "Enabled": true,
    "ServerSideCharacterSave": 5,
    "StartingInventory": [
      {"netID": 3506, "prefix": 0, "stack": 1}
    ]
  }
}

Prima di modificare SSC crea un backup del mondo e dei file di configurazione rilevanti. Poi verifica con un giocatore di test se login, inventario, salvataggio e riconnessione funzionano. Se i giocatori improvvisamente non trovano più oggetti, devi prima chiarire se il problema riguarda personaggi locali, dati SSC o permessi.

Configurare le regioni

Le regioni proteggono costruzioni, aree di spawn o zone di progetto. Tipico è uno spawn protetto, mentre i giocatori normali possono costruire liberamente al di fuori.

/region define <name>           # Segnare la regione
/region protect <name> true     # Proteggere la regione
/region allow <spieler> <name>  # Consentire il giocatore
/region remove <name>           # Rimuovere la regione
/region list                    # Tutte le regioni

Assegna nomi comprensibili come spawn, arena o magazzino_nord. Documenta le regioni importanti, così altri admin in seguito non devono indovinare perché un'area è protetta. Dopo la creazione dovresti testare con un account giocatore normale se costruzione, rimozione blocchi e interazione sono davvero bloccate o consentite come previsto.

Sistema gruppi

Il sistema gruppi controlla quali comandi possono eseguire giocatori, moderatori e admin. Lavora qui secondo il principio: assegna solo i permessi necessari per il ruolo.

/group add <name> <parent> <permissions> <chatcolor>
/user group <spieler> <gruppe>

Crea prima ruoli semplici, per esempio giocatore, moderatore e admin. Poi aggiungi singoli permessi. Evita diritti admin generici per i giocatori normali, anche se a breve termine sembra comodo. Soprattutto i comandi per World Edit, regioni, economia o dati personaggio possono modificare molto lo stato del server.

Verificare il risultato

Dopo ogni modifica ai plugin dovresti eseguire almeno questo controllo: avviare il server, controllare la console per errori, connetterti con un account di test, eseguire un comando del plugin, testare i permessi con un gruppo giocatore normale e poi fare un secondo riavvio. Solo quando il plugin viene caricato stabilmente anche dopo il riavvio, l'installazione è davvero conclusa.

Se hai pianificato più modifiche, eseguile una dopo l'altra. Così, in caso di errore, sai quale file o configurazione è stato modificato per ultimo.

Troubleshooting

Se un plugin non viene caricato, controlla prima l'estensione del file e il percorso di salvataggio. La DLL deve trovarsi nella cartella corretta ServerPlugins/, non in una sottocartella o nella directory del mondo. Poi controlla se la versione del plugin è compatibile con la versione tShock.

Se i comandi non funzionano, spesso non è il plugin stesso a essere difettoso, ma manca il permesso. Controlla il gruppo del giocatore e i nomi dei permessi attesi dal plugin. Se le regioni non proteggono, testa con un giocatore senza diritti admin; a seconda della configurazione, gli admin aggirano le regole di protezione più spesso degli utenti normali.

Se il server diventa instabile dopo l'installazione di un plugin, rimuovi di nuovo le DLL aggiunte per ultime e riavvia. Lavora con backup prima di usare in produzione SSC, sistemi economici o funzioni World Edit.

Verifica, limiti e ritorno sicuro

La guida “Mod e plugin per server Terraria – estensioni tShock” vale per il tipo di server descritto nell'articolo e per lo stato delle versioni visibile al momento della verifica. Nomi dei menu, versioni disponibili, compatibilità di mod o plugin e risorse necessarie possono cambiare dopo gli aggiornamenti. Quindi non trasferire valori a un'altra versione di gioco, loader o server senza verificarli.

Prima di modificare mondo, salvataggio, configurazione o estensioni, crea un backup dei file interessati. Poi modifica solo un passaggio coerente alla volta e verificalo con la stessa versione client e server con cui vorrai giocare in seguito.

Un singolo test riuscito non è una garanzia di prestazioni o disponibilità. Dimensione del mondo, mod, plugin, numero di giocatori, percorso di rete e carico simultaneo possono cambiare il risultato. Documenta versione, modifica e risultato del test, così puoi ricostruire eventuali differenze future.

FAQ

I giocatori hanno bisogno dei plugin tShock anche sul client?

Di solito no. I plugin tShock funzionano lato server. I giocatori si connettono a Terraria come sempre, finché il plugin non richiede una mod client separata o un setup speciale.

Posso installare plugin senza riavviare il server?

Alcune modifiche possono essere rilette con /reload. Per nuove DLL, aggiornamenti o ricerca errori, un riavvio completo è più affidabile, perché così vedi l'intero processo di caricamento nella console.

SSC ha senso per ogni server Terraria?

Non sempre. SSC è utile se vuoi controllare progressi e inventari lato server. Per sessioni rilassate con personaggi esistenti può essere troppo limitante.

Perché i comandi del plugin funzionano per me, ma non per i giocatori?

Di solito dipende dai permessi dei gruppi. Gli admin hanno spesso permessi ampi, i giocatori normali no. Quindi testa sempre i nuovi plugin con un account che usa lo stesso gruppo della tua community.

Quanti plugin dovrei installare?

Il meno possibile e quanti ne servono. Inizia con protezione, amministrazione e le funzioni di gameplay che usi davvero. Ogni estensione aggiuntiva aumenta il lavoro di manutenzione e ricerca errori.