Terraria · Anleitung

TShock Anleitung: Einrichtung, Befehle und Rechte

Aktualisiert October 11, 2026 5 Min. Lesezeit

Auf dieser Seite
  1. TShock- und Terraria-Versionen
  2. Erstes Setup: das Owner-Konto anlegen
  3. Gruppen und Rechte
  4. TShock Befehle (Terraria Server Befehle)
  5. Bauten mit Regionen schützen
  6. Serverseitige Charaktere
  7. Die Konfigurationsdatei und die REST API
  8. TShock bei HytHost
  9. FAQ

TShock macht aus einem einfachen Terraria-Server einen, den du als Admin wirklich verwalten kannst: Konten und Gruppen, Bans, geschützte Regionen, Item- und Mob-Befehle, serverseitige Charaktere und Anti-Cheat. Für öffentliche Terraria-Server ist es die Standardwahl.

Diese Anleitung behandelt das erste Setup, Gruppen und Rechte, die Befehle, die du täglich brauchst, Regionen, serverseitige Charaktere, die REST API und die wichtigsten Einstellungen der Konfiguration.

TShock- und Terraria-Versionen

TShock wird immer für genau eine Terraria-Version gebaut. Die aktuelle Version, TShock 6.2.1, läuft mit Terraria 1.4.5.8. Spieler müssen dieselbe Terraria-Version wie der Server nutzen.

Wenn Terraria ein Update bekommt, warte auf die passende TShock-Version, bevor du den Server aktualisierst. Sichere vor einem TShock-Upgrade tshock.sqlite und den gesamten Ordner tshock: Dort liegen deine Konten, Gruppen, Bans und Regionen.

Wie du den Server selbst mit Ports und Welten einrichtest, erklärt Terraria Server erstellen.

Erstes Setup: das Owner-Konto anlegen

Beim ersten Start zeigt TShock in der Konsole einen Setup-Code an und speichert ihn in tshock/setup-code.txt. Tritt dem Server bei und gib ein:

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

Die erste Zeile entsperrt das Setup mit dem Code, die zweite legt dein Konto in der Gruppe owner an, die dritte meldet dich an, und die letzte schaltet den Setup-Modus ab. Sobald ein Konto existiert, lässt sich das Setup nicht erneut nutzen.

Spiele aus der Gruppe owner. TShock hat auch einen eingebauten superadmin, aber die Entwickler raten davon ab, damit zu spielen: Er umgeht alles, auch serverseitige Charaktere.

Wähle TShock bei der Bestellung oder wechsle später im Panel: HytHost Terraria Hosting gibt es ab €2.59/Monat.

Terraria-Pläne ansehen

Gruppen und Rechte

Jeder Spieler gehört zu einer Gruppe, und Gruppen enthalten Rechte. TShock legt standardmäßig diese an: guest (nicht angemeldet), default (registrierte Spieler), vip, newadmin, admin, trustedadmin und owner.

BefehlWas er macht
/group add builderErstellt eine Gruppe
/group parent builder defaultLässt sie die Rechte einer anderen Gruppe erben
/group addperm builder tshock.world.editregionFügt ein Recht hinzu
/group delperm builder tshock.world.editregionEntfernt ein Recht
/group listperm builderListet die Rechte der Gruppe auf
/user group Alex builderVerschiebt das Konto eines Spielers in eine Gruppe

Spieler legen ihre Konten selbst mit /register password an und melden sich mit /login an. Damit nicht registrierte Spieler nicht bauen können, setze RequireLogin in der Konfiguration auf true.

TShock Befehle (Terraria Server Befehle)

BefehlWas er macht
/kick Name reasonWirft einen Spieler raus
/ban add Name reason 7dBannt einen Spieler, hier für 7 Tage; ohne Dauer ist der Ban dauerhaft
/ban list / /ban del 3Listet Bans auf oder entfernt Ban Nummer 3
/mute NameSchaltet einen Spieler im Chat stumm
/tp Name / /tphere NameTeleportiert dich zu einem Spieler oder holt ihn zu dir
/item "Iron Pickaxe" 1Gibt dir ein Item
/give "Healing Potion" Name 10Gibt einem anderen Spieler ein Item
/butcherTötet alle feindlichen NPCs
/time dayStellt die Zeit ein: day, night, noon, midnight
/spawnmob Zombie 5Spawnt Mobs in deiner Nähe
/save / /offSpeichert die Welt oder speichert und fährt herunter
/reloadLädt Konfiguration und Rechte neu

Befehle beginnen mit /; beginnst du einen stattdessen mit !, läuft er still, ohne dass andere Spieler davon erfahren. Namen mit Leerzeichen gehören in Anführungszeichen.

Bauten mit Regionen schützen

Regionen verhindern, dass andere Spieler einen Bereich verändern, etwa den Spawn oder eine Stadt.

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

Schlage nach /region set 1 auf einen Block, um die erste Ecke zu markieren; mach dasselbe für Ecke 2. Gib der Region dann einen Namen und schütze sie. allow erlaubt einem Spieler, darin zu bauen, allowg einer ganzen Gruppe. /region list und /region info spawn zeigen, was existiert.

Beachte, dass der automatische Spawnschutz seit TShock 6 standardmäßig aus ist (SpawnProtection in der Konfiguration). Eine Region um den Spawn gibt dir ohnehin feinere Kontrolle.

Serverseitige Charaktere

Normalerweise liegt der Charakter jedes Spielers samt Inventar auf dessen eigenem Computer, sodass Spieler Items aus anderen Welten oder bearbeitete Charaktere mitbringen können. Serverseitige Charaktere (SSC) speichern die Charaktere stattdessen auf dem Server, sodass alle fair vorankommen.

  • Schalte es in tshock/sscconfig.json mit "Enabled": true ein und starte neu.
  • Lege fest, womit neue Charaktere starten: StartingHealth, StartingMana und StartingInventory.
  • Admins mit dem Recht tshock.ignore.ssc werden nicht in SSC gespeichert.

Entscheide früh: Sobald SSC aktiv ist, starten Spieler mit dem Startinventar, und ein Admin muss einen bestehenden Charakter mit /uploadssc importieren. Wer es später einschaltet, überrascht die Stammspieler.

Die Konfigurationsdatei und die REST API

Die Einstellungen von TShock stehen in tshock/config.json. Die, die die meisten Server ändern:

  • ServerPassword: ein Passwort zum Beitreten;
  • MaxSlots: das Spielerlimit (standardmäßig 8);
  • RequireLogin: Spieler müssen sich anmelden, bevor sie spielen können;
  • EnableWhitelist: nur erlaubte Adressen können beitreten;
  • BackupInterval: wie oft TShock ein Backup der Welt speichert.

Übernimm Änderungen mit /reload oder starte neu, wenn eine Einstellung das verlangt.

Die REST API lässt Websites und Tools den Server über HTTP steuern, standardmäßig auf Port 7878. Sie ist standardmäßig aus (RestApiEnabled), und du solltest sie aus lassen, solange du sie nicht brauchst: Ein REST-Token kann jeden Serverbefehl mit den Rechten des Kontos ausführen, zu dem er gehört. Wenn du sie nutzt, gib dem Konto des Tokens nur die Rechte, die das Tool braucht, und veröffentliche den Token nie.

TShock bei HytHost

Bei HytHost Terraria Hosting ist TShock nur einen Klick entfernt: Wähle es bei der Bestellung oder wechsle später im Software-Tab des Panels, der Welt, Passwort, MOTD und Spielerplätze behält. Der Server läuft mit TShock 6.2.1 für Terraria 1.4.5.8, die REST API ist standardmäßig aus.

Der Setup-Code erscheint beim ersten Start in der Panel-Konsole, und config.json sowie sscconfig.json bearbeitest du im Dateimanager.

FAQ

Häufig gestellte Fragen

Nutze beim ersten Start den Setup-Code aus der Konsole: /setup code, dann /user add Name Password owner, /login Name Password und noch einmal /setup, um das Setup zu schließen.

TShock zeigt ihn beim ersten Start in der Serverkonsole an und speichert ihn in tshock/setup-code.txt. Er funktioniert nur, bis das erste Konto existiert.

TShock 6.2.1 unterstützt Terraria 1.4.5.8. Jede TShock-Version ist für eine Terraria-Version gebaut, und Spieler müssen dieselbe Version wie der Server nutzen.

Schütze ihn mit einer Region: /region set 1 und /region set 2 markieren die Ecken, dann /region define spawn und /region protect spawn true.

Nur wenn ein Tool sie braucht. Die REST API kann jeden Serverbefehl ausführen, also lass sie standardmäßig aus, gib ihrem Token ein Konto mit minimalen Rechten und gib den Token nie weiter.

Einen TShock-Server betreiben

HytHost Terraria Hosting bietet TShock, Vanilla und tModLoader, umschaltbar im Panel, ab €2.59/Monat.

Live chat 8 AM – 11 PM (Chișinău time) · tickets answered during business hours

War diese Anleitung hilfreich?