So fügst du Plugins zu deinem Terraria tShock Server hinzu

tShock hat kein Mod-System für den Client. Erweitert wird ein tShock-Server über Plugins: .dll-Dateien, die ausschließlich auf dem Server liegen und dort neue Befehle, Regeln oder Automatismen ergänzen.

Hinweis

Deine Spieler müssen dafür nichts installieren. Sie verbinden sich weiterhin mit dem ganz normalen Terraria-Client: Server beitreten.

Wichtig

.tmod-Dateien funktionieren auf einem tShock-Server nicht. Sie gehören zu tModLoader und benötigen einen eigenen Servertyp: Mods hinzufügen (tModLoader).

Plugin herunterladen

1. Passendes Plugin suchen
   Eine gepflegte Übersicht verfügbarer Plugins findest du im offiziellen tShock-Wiki sowie auf GitHub unter dem Thema tshock-plugin.

2. Version prüfen
   Ein Plugin muss zu der tShock-Version passen, die auf deinem Server läuft. Welche Version installiert wird, steuerst du in der Verwaltung über das Feld tShock Version.

   Achtung

   Passt ein Plugin nicht zur installierten tShock-Version, wird es beim Start nicht geladen oder der Server bricht mit einer Fehlermeldung ab. Prüfe daher immer die Angaben des Entwicklers zur unterstützten Version.

3. Datei entpacken
   Lade das Plugin herunter und entpacke es, falls es als Archiv vorliegt. Du benötigst die enthaltene .dll-Datei. Bringt ein Plugin zusätzliche Bibliotheken mit, gehören auch diese .dll-Dateien mit auf den Server.

Nur vertrauenswürdige Quellen

Ein Plugin ist ausführbarer Programmcode, der mit den vollen Rechten deines Servers läuft. Lade Plugins deshalb ausschließlich aus offiziellen bzw. bekannten Quellen herunter – auch das tShock-Wiki warnt ausdrücklich davor, Plugins unbekannter Herkunft zu installieren.

Plugin hochladen

1. Server stoppen
   Stoppe deinen Server über die Verwaltung. Plugins werden nur beim Serverstart geladen.

2. Per SFTP verbinden
   Verbinde dich per SFTP mit deinem Server.

3. Plugin-Ordner öffnen
   Wechsle in folgendes Verzeichnis:

   /ServerPlugins/

   Hinweis

   Der Ordner wird bei der Installation von tShock angelegt und enthält bereits die Datei TShockAPI.dll. Lösche vorhandene Dateien dort nicht – sie gehören zu tShock selbst.

4. Datei hochladen
   Lade die .dll-Datei des Plugins in diesen Ordner hoch.

5. Server starten
   Starte deinen Server und beobachte die Serverkonsole. Geladene Plugins werden dort beim Start mit Namen und Version aufgeführt.

Plugin konfigurieren

Die meisten Plugins legen ihre Konfigurationsdatei beim ersten Start automatisch im Ordner /tshock/ ab. Gehe also so vor:

1. Server einmal starten
   Starte den Server nach dem Hochladen einmal, damit das Plugin seine Dateien anlegt.

2. Server stoppen
   Stoppe den Server wieder, bevor du die Konfiguration bearbeitest.

3. Konfiguration anpassen
   Öffne die Konfigurationsdatei des Plugins im Ordner /tshock/ und passe die Werte an.

4. Server starten
   Speichere die Datei und starte deinen Server.

Tipp

Viele Plugins bringen eigene Befehle mit. Welche Befehle dir zur Verfügung stehen, zeigt dir /help im Spiel. Damit auch andere Gruppen die neuen Befehle nutzen dürfen, musst du die zugehörigen Berechtigungen vergeben: Admin hinzufügen.

Plugin entfernen

1. Server stoppen
   Stoppe deinen Server über die Verwaltung.

2. Datei löschen
   Lösche die .dll-Datei des Plugins aus dem Ordner /ServerPlugins/.

3. Server starten
   Starte deinen Server. Das Plugin ist damit deaktiviert.

Achtung

Startet dein Server nach dem Hochladen eines Plugins nicht mehr, entferne die zuletzt hinzugefügte .dll-Datei wieder. Füge Plugins am besten einzeln hinzu und starte dazwischen den Server – so erkennst du sofort, welches Plugin Probleme macht.

Tipp

Erstelle vor größeren Änderungen ein Backup deines Servers.