Guida a TShock: installazione, comandi e permessi

Versioni di TShock e Terraria

TShock è sviluppato per una sola versione esatta di Terraria alla volta. La release attuale, TShock 6.2.1, gira su Terraria 1.4.5.8. I giocatori devono usare la stessa versione di Terraria del server.

Quando Terraria si aggiorna, aspetta la release di TShock corrispondente prima di aggiornare il server. Prima di aggiornare TShock, fai un backup di tshock.sqlite e dell'intera cartella tshock: contengono account, gruppi, ban e regioni.

La configurazione del server vero e proprio, con porte e mondi, è spiegata in come creare un server di Terraria.

Prima configurazione: crea l'account owner

Al primo avvio, TShock stampa un codice di setup nella console e lo salva in tshock/setup-code.txt. Entra nel server e digita:

/setup 123456
/user add YourName YourPassword owner
/login YourName YourPassword
/setup

La prima riga sblocca il setup con il codice, la seconda crea il tuo account nel gruppo owner, la terza ti fa accedere e l'ultima disattiva la modalità setup. Una volta creato un account, il setup non si può più usare.

Gioca dal gruppo owner. TShock ha anche un superadmin integrato, ma i suoi sviluppatori sconsigliano di giocarci: aggira tutto, compresi i personaggi lato server.

Gruppi e permessi

Ogni giocatore appartiene a un gruppo, e i gruppi contengono i permessi. TShock crea questi gruppi di default: guest (non autenticato), default (giocatori registrati), vip, newadmin, admin, trustedadmin e owner.

I giocatori creano il proprio account con /register password e accedono con /login. Per impedire ai giocatori non registrati di costruire, imposta RequireLogin su true nella configurazione.

Comandi TShock (comandi del server di Terraria)

I comandi iniziano con /; se invece ne inizi uno con !, viene eseguito in silenzio, senza annunciarlo agli altri giocatori. I nomi con spazi vanno tra virgolette.

Proteggi le costruzioni con le regioni

Le regioni impediscono agli altri giocatori di modificare un'area, come lo spawn o una città.

/region set 1
/region set 2
/region define spawn
/region protect spawn true
/region allow Alex spawn
/region allowg builder spawn

Dopo /region set 1, colpisci un blocco per segnare il primo angolo; fai lo stesso per l'angolo 2. Poi dai un nome alla regione e proteggila. allow permette a un singolo giocatore di costruire all'interno, allowg a un intero gruppo. /region list e /region info spawn mostrano cosa esiste.

Nota che da TShock 6 la protezione automatica dello spawn è disattivata di default (SpawnProtection nella configurazione). Una regione attorno allo spawn ti dà comunque un controllo più preciso.

Personaggi lato server

Di norma il personaggio di ogni giocatore, con il suo inventario, risiede sul suo computer, quindi i giocatori possono portare oggetti da altri mondi o personaggi modificati. I personaggi lato server (SSC) salvano invece i personaggi sul server, così tutti progrediscono in modo equo.

• Attivali in tshock/sscconfig.json con "Enabled": true e riavvia.
• Imposta con cosa iniziano i nuovi personaggi: StartingHealth, StartingMana e StartingInventory.
• Gli admin con il permesso tshock.ignore.ssc non vengono salvati in SSC.

Decidi presto: con SSC attivo, i giocatori partono dall'inventario iniziale e un admin deve importare un personaggio esistente con /uploadssc. Attivarlo in seguito coglie di sorpresa i giocatori abituali.

Il file di configurazione e la REST API

Le impostazioni di TShock si trovano in tshock/config.json. Quelle che la maggior parte dei server modifica:

• ServerPassword: una password per entrare;
• MaxSlots: il limite di giocatori (8 di default);
• RequireLogin: i giocatori devono accedere prima di poter giocare;
• EnableWhitelist: possono entrare solo gli indirizzi autorizzati;
• BackupInterval: ogni quanto TShock salva un backup del mondo.

Applica le modifiche con /reload, oppure riavvia per le impostazioni che lo richiedono.

La REST API permette a siti web e strumenti di controllare il server via HTTP, sulla porta 7878 di default. È disattivata di default (RestApiEnabled), ed è meglio lasciarla così se non ti serve: un token REST può eseguire qualsiasi comando del server con i permessi dell'account a cui appartiene. Se la usi, dai all'account del token solo i permessi che servono allo strumento e non pubblicare mai il token.

TShock su HytHost

Con l'hosting Terraria di HytHost, TShock è a un clic: sceglilo al momento dell'ordine oppure passaci più tardi dalla scheda Software del pannello, che mantiene mondo, password, MOTD e slot. Il server esegue TShock 6.2.1 per Terraria 1.4.5.8, con la REST API disattivata di default.

Il codice di setup compare nella console del pannello al primo avvio, e config.json e sscconfig.json si modificano nel file manager.