TShock-gids: installatie, commando's en rechten

Versies van TShock en Terraria

TShock wordt steeds voor één exacte Terraria-versie gebouwd. De huidige release, TShock 6.2.1, draait op Terraria 1.4.5.8. Spelers moeten dezelfde Terraria-versie gebruiken als de server.

Als Terraria een update krijgt, wacht dan op de bijbehorende TShock-release voordat je de server bijwerkt. Maak vóór een TShock-upgrade een back-up van tshock.sqlite en de hele map tshock: daarin staan je accounts, groepen, bans en regio's.

Het opzetten van de server zelf, met poorten en werelden, lees je in een Terraria-server maken.

Eerste setup: maak het owner-account aan

Bij de eerste start toont TShock een setupcode in de console en slaat die op in tshock/setup-code.txt. Join de server en typ:

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

De eerste regel ontgrendelt de setup met de code, de tweede maakt je account aan in de groep owner, de derde logt je in en de laatste zet de setupmodus uit. Zodra er een account bestaat, kan de setup niet opnieuw worden gebruikt.

Speel vanuit de groep owner. TShock heeft ook een ingebouwde superadmin, maar de ontwikkelaars raden af om daarmee te spelen: die omzeilt alles, ook server-side characters.

Groepen en rechten

Elke speler zit in een groep, en groepen bevatten rechten. TShock maakt standaard deze groepen aan: guest (niet ingelogd), default (geregistreerde spelers), vip, newadmin, admin, trustedadmin en owner.

Spelers maken zelf een account aan met /register password en loggen in met /login. Wil je niet dat ongeregistreerde spelers bouwen, zet dan RequireLogin op true in de config.

TShock-commando's (Terraria-servercommando's)

Commando's beginnen met /; begin je er een met !, dan wordt hij stil uitgevoerd, zonder dat andere spelers het zien. Namen met spaties zet je tussen aanhalingstekens.

Bescherm bouwwerken met regio's

Regio's voorkomen dat andere spelers een gebied aanpassen, zoals de spawn of een dorp.

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

Sla na /region set 1 een blok om de eerste hoek te markeren; doe hetzelfde voor hoek 2. Geef de regio daarna een naam en bescherm hem. allow laat één speler binnen de regio bouwen, allowg een hele groep. /region list en /region info spawn laten zien wat er bestaat.

Let op: sinds TShock 6 staat de automatische spawnbescherming standaard uit (SpawnProtection in de config). Een regio rond de spawn geeft je sowieso meer controle.

Server-side characters

Normaal staat het personage van elke speler, met de inventaris, op de eigen computer, dus spelers kunnen items uit andere werelden of bewerkte personages meenemen. Server-side characters (SSC) slaan personages in plaats daarvan op de server op, zodat iedereen eerlijk vooruitgang boekt.

• Zet het aan in tshock/sscconfig.json met "Enabled": true en herstart.
• Stel in waarmee nieuwe personages beginnen: StartingHealth, StartingMana en StartingInventory.
• Admins met het recht tshock.ignore.ssc worden niet in SSC opgeslagen.

Beslis het vroeg: met SSC aan beginnen spelers met de startinventaris en moet een admin een bestaand personage importeren met /uploadssc. Het later aanzetten overvalt je vaste spelers.

Het configbestand en de REST API

De instellingen van TShock staan in tshock/config.json. Deze passen de meeste servers aan:

• ServerPassword: een wachtwoord om te joinen;
• MaxSlots: het spelerslimiet (standaard 8);
• RequireLogin: spelers moeten inloggen voordat ze kunnen spelen;
• EnableWhitelist: alleen toegestane adressen kunnen joinen;
• BackupInterval: hoe vaak TShock een back-up van de wereld maakt.

Pas wijzigingen toe met /reload, of herstart voor instellingen die dat vereisen.

De REST API laat websites en tools de server via HTTP aansturen, standaard op poort 7878. Hij staat standaard uit (RestApiEnabled), en laat hem zo tenzij je hem nodig hebt: een REST-token kan elk servercommando uitvoeren met de rechten van het account waar het bij hoort. Gebruik je hem wel, geef het account van het token dan alleen de rechten die de tool nodig heeft, en publiceer het token nooit.

TShock bij HytHost

Bij Terraria-hosting van HytHost is TShock één klik verwijderd: kies het bij het bestellen, of stap later over via het tabblad Software in het panel, dat je wereld, wachtwoord, MOTD en slots behoudt. De server draait TShock 6.2.1 voor Terraria 1.4.5.8, met de REST API standaard uit.

De setupcode verschijnt bij de eerste start in de console van het panel, en je bewerkt config.json en sscconfig.json in de bestandsbeheerder.