Guide TShock : installation, commandes et permissions

Versions de TShock et de Terraria

TShock est conçu pour une seule version exacte de Terraria à la fois. La version actuelle, TShock 6.2.1, fonctionne avec Terraria 1.4.5.8. Les joueurs doivent utiliser la même version de Terraria que le serveur.

Quand Terraria reçoit une mise à jour, attendez la version de TShock correspondante avant de mettre à jour le serveur. Avant de mettre TShock à niveau, sauvegardez tshock.sqlite et tout le dossier tshock : ils contiennent vos comptes, groupes, bannissements et régions.

La mise en place du serveur lui-même, avec les ports et les mondes, est expliquée dans comment créer un serveur Terraria.

Première configuration : créer le compte owner

Au premier démarrage, TShock affiche un code de configuration dans la console et l'enregistre dans tshock/setup-code.txt. Rejoignez le serveur et tapez :

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

La première ligne déverrouille la configuration avec le code, la deuxième crée votre compte dans le groupe owner, la troisième vous connecte et la dernière désactive le mode configuration. Dès qu'un compte existe, la configuration ne peut plus être réutilisée.

Jouez depuis le groupe owner. TShock possède aussi un superadmin intégré, mais ses développeurs déconseillent de jouer avec : il contourne tout, y compris les personnages côté serveur.

Groupes et permissions

Chaque joueur appartient à un groupe, et les groupes portent les permissions. TShock crée par défaut : guest (non connecté), default (joueurs inscrits), vip, newadmin, admin, trustedadmin et owner.

Les joueurs créent eux-mêmes leur compte avec /register password et se connectent avec /login. Pour empêcher les joueurs non inscrits de construire, passez RequireLogin à true dans la configuration.

Commandes TShock (commandes serveur Terraria)

Les commandes commencent par / ; si vous en commencez une par ! à la place, elle s'exécute discrètement, sans être annoncée aux autres joueurs. Les noms contenant des espaces se mettent entre guillemets.

Protéger les constructions avec des régions

Les régions empêchent les autres joueurs de modifier une zone, comme le spawn ou une ville.

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

Après /region set 1, frappez un bloc pour marquer le premier coin ; faites de même pour le coin 2. Nommez ensuite la région et protégez-la. allow autorise un joueur à construire à l'intérieur, allowg tout un groupe. /region list et /region info spawn montrent ce qui existe.

Notez que depuis TShock 6, la protection automatique du spawn est désactivée par défaut (SpawnProtection dans la configuration). Une région autour du spawn vous donne de toute façon un contrôle plus fin.

Personnages côté serveur

Normalement, le personnage de chaque joueur, avec son inventaire, est stocké sur son propre ordinateur, si bien que les joueurs peuvent apporter des objets d'autres mondes ou des personnages modifiés. Les personnages côté serveur (SSC) stockent plutôt les personnages sur le serveur, pour que chacun progresse équitablement.

• Activez-les dans tshock/sscconfig.json avec "Enabled": true, puis redémarrez.
• Définissez ce avec quoi démarrent les nouveaux personnages : StartingHealth, StartingMana et StartingInventory.
• Les admins ayant la permission tshock.ignore.ssc ne sont pas enregistrés dans SSC.

Décidez tôt : une fois SSC activé, les joueurs partent de l'inventaire de départ, et un admin doit importer un personnage existant avec /uploadssc. L'activer plus tard prend les habitués par surprise.

Le fichier de configuration et la REST API

Les réglages de TShock se trouvent dans tshock/config.json. Ceux que la plupart des serveurs modifient :

• ServerPassword : un mot de passe pour rejoindre ;
• MaxSlots : la limite de joueurs (8 par défaut) ;
• RequireLogin : les joueurs doivent se connecter avant de pouvoir jouer ;
• EnableWhitelist : seules les adresses autorisées peuvent rejoindre ;
• BackupInterval : la fréquence à laquelle TShock sauvegarde le monde.

Appliquez les changements avec /reload, ou redémarrez pour les réglages qui l'exigent.

La REST API permet à des sites web et des outils de contrôler le serveur via HTTP, sur le port 7878 par défaut. Elle est désactivée par défaut (RestApiEnabled), et mieux vaut la laisser ainsi si vous n'en avez pas besoin : un jeton REST peut exécuter n'importe quelle commande serveur avec les permissions du compte auquel il appartient. Si vous l'utilisez, ne donnez au compte du jeton que les permissions nécessaires à l'outil, et ne publiez jamais le jeton.

TShock chez HytHost

Avec l'hébergement Terraria HytHost, TShock est à un clic : choisissez-le à la commande, ou passez-y plus tard dans l'onglet Software du panel, qui conserve votre monde, votre mot de passe, le MOTD et les slots. Le serveur tourne sous TShock 6.2.1 pour Terraria 1.4.5.8, avec la REST API désactivée par défaut.

Le code de configuration apparaît dans la console du panel au premier démarrage, et vous modifiez config.json et sscconfig.json dans le gestionnaire de fichiers.