Administration et TShock
L'administration d'un serveur Terraria dépend de son mode :
- Vanilla (et tModLoader) : il n'existe pas de rôle d'administrateur en jeu. Vous administrez le serveur depuis la Console du panel.
- TShock : vous créez un compte propriétaire en jeu, puis vous gérez des groupes et des permissions pour vos joueurs et votre équipe de modération.
Commandes de la console (vanilla)
Dans le Panel Game (game.yorkhost.fr), ouvrez la Console de votre serveur et tapez les commandes sans / :
| Commande | Effet |
|---|---|
help | Liste des commandes disponibles |
playing | Liste des joueurs connectés |
say <message> | Envoie un message à tous les joueurs |
kick <joueur> | Expulse un joueur |
ban <joueur> | Bannit un joueur (ajouté au fichier de banlist) |
save | Sauvegarde le monde |
exit | Sauvegarde le monde et arrête le serveur |
password / password <mdp> | Affiche / change le mot de passe (session en cours) |
motd / motd <message> | Affiche / change le message d'accueil (session en cours) |
time | Affiche l'heure du jeu |
dawn, noon, dusk, midnight | Règle l'heure : aube, midi, crépuscule, minuit |
settle | Stabilise l'eau du monde |
version | Version du serveur |
Les bannissements sont enregistrés dans le fichier indiqué par banlist dans serverconfig.txt (souvent banlist.txt). Pour débannir, arrêtez le serveur, retirez les lignes du joueur dans ce fichier depuis l'onglet Files, puis redémarrez.
Tapez save avant une opération risquée si vous n'utilisez pas le bouton d'arrêt du panel.
TShock : devenir propriétaire avec /setup
TShock remplace le serveur vanilla par une version enrichie : comptes joueurs, groupes, permissions, protection de zones, outils de modération et plugins. Il reste compatible avec les clients Terraria normaux.
TShock fonctionne uniquement avec Terraria vanilla. Sur un serveur tModLoader, les commandes et plugins TShock ne sont pas disponibles. Pour passer d'un mode à l'autre, voir Premiers pas.
Le code d'installation
Au premier démarrage d'un serveur TShock, un code d'installation (setup code) s'affiche dans la Console du panel. Il est aussi enregistré dans un fichier du dossier tshock/ (généralement setup-code.txt).
- Démarrez le serveur et notez le code affiché dans la console
- Connectez-vous au serveur en jeu
- Dans le chat du jeu, tapez :
/setup 123456
en remplaçant 123456 par votre code.
- Créez votre compte propriétaire (choisissez un mot de passe solide) :
/user add MonPseudo MonMotDePasse owner
- Connectez-vous avec ce compte :
/login MonPseudo MonMotDePasse
- Tapez
/setupune dernière fois (sans code) pour désactiver le système d'installation
Vous avez maintenant tous les droits sur le serveur. À chaque connexion, reconnectez-vous avec /login.
Tant que le système d'installation n'est pas désactivé, n'importe qui connaissant le code peut prendre le contrôle du serveur. Terminez les étapes ci-dessus avant d'ouvrir le serveur au public.
Comptes des joueurs
Les joueurs créent leur compte en jeu, puis se connectent :
/register MotDePasse
/login MotDePasse
Selon votre configuration, TShock peut exiger d'être connecté pour jouer (réglage RequireLogin dans tshock/config.json), ce qui est recommandé sur un serveur public.
Groupes et permissions
Chaque compte appartient à un groupe, et chaque groupe possède une liste de permissions. TShock fournit des groupes par défaut, du moins au plus privilégié : guest (joueur non connecté), default (joueur inscrit), vip, newadmin, admin, trustedadmin et owner. Un groupe peut hériter des permissions d'un groupe parent.
| Commande | Effet |
|---|---|
/group list | Liste des groupes |
/group listperm <groupe> | Permissions d'un groupe |
/group add <groupe> | Crée un groupe |
/group parent <groupe> <parent> | Fait hériter un groupe d'un autre |
/group addperm <groupe> <permission> | Ajoute une permission |
/group delperm <groupe> <permission> | Retire une permission |
/group prefix <groupe> <préfixe> | Préfixe affiché devant le pseudo dans le chat |
/user group <compte> <groupe> | Place un compte dans un groupe |
Exemple : créer un groupe de modérateurs basé sur default, capable d'expulser et de bannir :
/group add moderateur
/group parent moderateur default
/group addperm moderateur tshock.admin.kick tshock.admin.ban
/user group PseudoDuModo moderateur
Quelques permissions courantes : tshock.admin.kick, tshock.admin.ban, tshock.tp.self (téléportation), tshock.item.spawn (commande /item), tshock.admin.region (gestion des régions). Les noms exacts peuvent varier selon la version de TShock : vérifiez avec /group listperm admin ou dans la documentation officielle de TShock.
Pour promouvoir rapidement un membre de confiance, placez simplement son compte dans un groupe existant, par exemple /user group PseudoDuModo admin, plutôt que de créer un groupe de zéro.
Commandes TShock utiles
| Commande | Effet |
|---|---|
/help | Liste des commandes accessibles à votre groupe |
/who | Joueurs connectés |
/kick <joueur> [raison] | Expulse un joueur |
/ban add <joueur> [raison] [durée] | Bannit un joueur (voir /ban help pour la syntaxe de votre version) |
/ban list / /ban del <numéro> | Liste / retire un bannissement |
/mute <joueur> | Rend un joueur muet |
/tp <joueur> | Se téléporte vers un joueur |
/time <heure> | Règle l'heure du jeu (par exemple /time noon) |
/item <objet> [quantité] | Se donne un objet |
/save | Sauvegarde le monde |
/off | Sauvegarde et arrête le serveur |
Depuis la Console du panel, les commandes TShock fonctionnent aussi : essayez avec le /, et sans s'il n'est pas reconnu par votre version.
Protéger une zone (régions)
Pour protéger le spawn ou une base contre les modifications :
/region set 1, puis frappez le bloc du coin supérieur gauche de la zone/region set 2, puis frappez le bloc du coin inférieur droit/region define NomDeLaZone- Autorisez un joueur à construire dedans :
/region allow PseudoDuJoueur NomDeLaZone
/region list et /region info NomDeLaZone affichent les zones existantes.
Configuration de TShock
Les fichiers de TShock se trouvent dans le dossier tshock/ du serveur :
| Fichier | Rôle |
|---|---|
config.json | Réglages de TShock : nom, mot de passe, places, connexion obligatoire, protection du spawn… |
sscconfig.json | Personnages côté serveur (Server-Side Characters) : inventaires stockés sur le serveur |
tshock.sqlite | Base de données : comptes, groupes, permissions, bannissements, régions |
Certains réglages de config.json (mot de passe, nombre de places) prennent le dessus sur serverconfig.txt. Ne modifiez pas le port dans ce fichier : le serveur doit rester sur le port attribué par le panel.
Pour modifier config.json, arrêtez le serveur, éditez-le dans l'onglet Files en respectant la syntaxe JSON (guillemets, virgules), puis redémarrez. La commande /reload recharge une partie des réglages sans redémarrer.
tshock/tshock.sqlite contient tous vos comptes, groupes et régions. Incluez-le dans vos sauvegardes, en plus du monde : voir Importer un monde et sauvegardes.
Installer des plugins TShock
- Téléchargez le plugin (fichier
.dll) depuis une source fiable, dans une version compatible avec votre version de TShock - Arrêtez le serveur
- Déposez le
.dlldans le dossierServerPlugins/via l'onglet Files ou en SFTP - Démarrez le serveur et vérifiez dans la console que le plugin est chargé sans erreur
Un plugin écrit pour une ancienne version de TShock peut empêcher le serveur de démarrer : retirez-le si c'est le cas (voir Dépannage).