Installer TShock sur un serveur Terraria : setup superadmin, groupes et commandes admin
Le serveur Terraria officiel n’offre que quelques commandes console : pas de comptes, pas de permissions, pas de protection contre le grief. TShock comble ce manque. C’est la boîte à outils de référence des serveurs Terraria publics : anti-triche, comptes joueurs, groupes, bannissement d’objets, régions protégées, warps et des dizaines de commandes.
Ce guide couvre TShock 6.1.0 (dernière release au 25 septembre 2026), sa configuration initiale et les commandes d’administration essentielles.
⚡ TShock en un clic
Serveur Terraria TShock dès 4,90 €/mois
Notre hébergeur Terraria installe TShock depuis le panel : pas de .NET à gérer, console web, accès fichiers, Ryzen 9 5950X, Anti-DDoS 5 Tbps et support FR 24/7.
Compatibilité : vérifiez la version avant tout
TShock remplace le serveur Vanilla. Il doit correspondre à la version de Terraria des joueurs.
| Release TShock | Date | Terraria ciblé | Runtime |
|---|---|---|---|
| 6.1.0 | 11 mars 2026 | 1.4.5.6 | .NET 9 |
| 6.0.0 | 8 mars 2026 | 1.4.5.5 | .NET 9 |
| 5.2.4 | 9 mai 2025 | 1.4.4.9 | .NET 8 |
Au 25 septembre 2026, Terraria est en 1.4.5.8 alors que la dernière release TShock cible la 1.4.5.6. Consultez la page des releases TShock avant d’installer : si les joueurs n’arrivent pas à se connecter, c’est presque toujours un décalage de version.
TShock n’est pas compatible avec tModLoader. Pour des mods comme Calamity, suivez plutôt le guide installer tModLoader sur un serveur.
Étape 1 — Télécharger TShock
Sur la page des releases, prenez l’archive qui correspond à votre système :
| Système | Fichier |
|---|---|
| Windows 64 bits | TShock-6.1.0-for-Terraria-1.4.5.6-win-x64-Release.zip |
| Linux 64 bits | TShock-6.1.0-for-Terraria-1.4.5.6-linux-x64-Release.zip |
| Linux ARM64 | …-linux-arm64-Release.zip |
| macOS | …-osx-x64-Release.zip |
Il existe aussi une image Docker officielle : ghcr.io/pryaxis/tshock:stable.
Étape 2 — Installer le runtime .NET 9
TShock 6.x demande le runtime .NET 9 (dot.net).
- Windows : installez le « .NET Runtime 9 » (x64).
- Ubuntu / Debian : suivez les instructions Microsoft pour votre distribution, puis vérifiez :
dotnet --list-runtimes
# doit afficher une ligne Microsoft.NETCore.App 9.xÉtape 3 — Extraire et lancer
Windows
- Décompressez l’archive dans un dossier vide, par exemple
C:\TShock\. - Lancez
TShock.Server.exe.
Linux
Sous Linux, le .zip contient une archive .tar qui conserve les permissions des fichiers :
mkdir ~/tshock && cd ~/tshock
unzip TShock-6.1.0-for-Terraria-1.4.5.6-linux-x64-Release.zip
tar -xf TShock-Beta-linux-x64-Release.tar
./TShock.ServerCe que vous obtenez
TShock.Server(.exe) ← lanceur du serveur
ServerPlugins/ ← plugins (.dll), dont TShockAPI.dll
tshock/ ← créé au 1er lancement : config.json, tshock.sqlite, logs, backupsAu premier lancement sans argument, le serveur pose les mêmes questions que le serveur Vanilla : monde, joueurs max, port. Pour démarrer sans interaction, TShock demande au minimum -world, -port et -maxplayers :
./TShock.Server -world /home/terraria/Worlds/MonMonde.wld -port 7777 -maxplayers 8Sous Windows :
TShock.Server.exe -world C:\Terraria\Worlds\MonMonde.wld -port 7777 -maxplayers 8Ajoutez -autocreate 3 pour créer un grand monde s’il n’existe pas encore, ou -difficulty 1 pour un nouveau monde en Expert.
Étape 4 — Devenir superadmin avec le code de setup
Au premier démarrage, TShock affiche dans la console un code de setup. Il est aussi enregistré dans tshock/setup-code.txt s’il a défilé trop vite.
Connectez-vous au serveur avec Terraria, puis dans le chat :
/setup 123456Vous obtenez un accès système temporaire. Créez immédiatement votre compte permanent dans le groupe owner :
/user add MonPseudo MonMotDePasse owner
/login MonPseudo MonMotDePasse
/setupLe dernier /setup désactive le système de setup. TShock supprime setup-code.txt et crée un fichier setup.lock. Plus personne ne pourra réutiliser un code.
Ne mettez pas vos modérateurs dans
superadmin: ce groupe a toutes les permissions. La documentation TShock le déconseille explicitement.
Les groupes par défaut
TShock crée une hiérarchie de groupes. Chaque groupe hérite des permissions de son parent :
| Groupe | Parent | Usage |
|---|---|---|
guest | — | Joueurs non connectés à un compte |
default | guest | Joueurs inscrits via /register |
vip | default | Joueurs privilégiés |
newadmin | vip | Modérateurs débutants (kick, mute…) |
admin | newadmin | Administrateurs (ban, whitelist, tp, heure, boss, warps…) |
trustedadmin | admin | Admins de confiance (objets, give, heal, butcher, godmode…) |
owner | trustedadmin | Propriétaire du serveur |
superadmin | — | Groupe spécial avec toutes les permissions |
Gérer les comptes et les groupes
/user add <pseudo> <motdepasse> <groupe> Crée un compte
/user group <pseudo> <groupe> Change le groupe d'un compte
/user password <pseudo> <nouveau_mdp> Change le mot de passe
/user del <pseudo> Supprime le compte
/group add <nom> [permissions] Crée un groupe
/group parent <groupe> <groupe_parent> Définit l'héritage
/group addperm <groupe> <permissions...> Ajoute des permissions
/group delperm <groupe> <permissions...> Retire des permissions
/group listperm <groupe> Liste les permissions
/group del <groupe> Supprime un groupeExemple : promouvoir un joueur modérateur.
/user group Lucas newadminCôté joueurs : /register <motdepasse> crée un compte (groupe default), puis /login <motdepasse> ou /login <pseudo> <motdepasse>.
Les commandes admin essentielles
| Commande | Effet |
|---|---|
/kick <joueur> [raison] | Expulse un joueur |
/ban add <cible> [raison] [durée] | Bannit (durée au format 10d30m0s, permanent si vide) |
/ban list · /ban del <ID> | Liste / lève un bannissement |
/mute <joueur> · /unmute <joueur> | Coupe / rend le chat |
/tp <joueur> · /tphere <joueur> | Se téléporter / téléporter un joueur à soi |
/tppos <x> <y> | Téléportation à des coordonnées |
/item <objet> [quantité] | Se donner un objet |
/give <objet> <joueur> [quantité] | Donner un objet à un joueur |
/heal <joueur> · /godmode | Soigner / mode invincible |
/spawnboss <boss> [nombre] | Faire apparaître un boss |
/spawnmob <monstre> [nombre] | Faire apparaître des monstres |
/butcher | Tuer tous les ennemis |
/time day / night / noon / midnight ou /time hh:mm | Changer l’heure |
/save | Sauvegarder le monde |
/off | Sauvegarder et éteindre |
/serverpassword <mdp> | Changer le mot de passe serveur |
/whitelist <ip> | Ajouter une IP à la whitelist |
/who | Joueurs connectés |
Options de /ban add : -a (compte), -u (UUID), -n (nom du personnage), -ip (adresse IP), -e (identifiant exact). Tapez /ban help pour l’aide complète en jeu. La liste exhaustive, avec les permissions associées, est dans notre référence des commandes admin TShock.
Dans la console du serveur, les mêmes commandes s’utilisent sans le /, avec les droits maximum.
Protéger une zone avec les régions
/region set 1 puis frappez le coin haut-gauche de la zone
/region set 2 puis frappez le coin bas-droit
/region define MaBase
/region allow Lucas MaBase
/region protect MaBase trueSeuls les joueurs autorisés (et les admins) peuvent construire dans la région. /region allowg <groupe> <région> autorise un groupe entier. La protection du spawn est active par défaut sur un rayon de 10 blocs (SpawnProtection).
Pour les points de téléportation : /warp add <nom>, puis /warp <nom>.
Configurer tshock/config.json
Les réglages se trouvent dans l’objet "Settings" du fichier. Les plus utiles :
| Clé | Défaut | Rôle |
|---|---|---|
ServerPassword | vide | Mot de passe du serveur |
ServerPort | 7777 | Port |
MaxSlots | 8 | Joueurs maximum |
RequireLogin | false | Obliger à se connecter à un compte pour jouer |
DefaultRegistrationGroupName | default | Groupe des nouveaux inscrits |
DefaultGuestGroupName | guest | Groupe des non-connectés |
SpawnProtection / SpawnProtectionRadius | true / 10 | Protection du spawn |
DisableBuild | false | Bloque toute construction |
EnableWhitelist | false | Whitelist par IP (tshock/whitelist.txt) |
AutoSave | true | Sauvegarde automatique du monde |
BackupInterval | 10 | Intervalle des backups en minutes (tshock/backups) |
BackupKeepFor | 240 | Durée de conservation des backups en minutes |
RestApiEnabled | false | API REST |
Appliquez les changements avec /reload ou redémarrez le serveur. Toutes les options sont décrites dans la documentation officielle du config.
Installer des plugins
Déposez le .dll du plugin dans ServerPlugins/ puis redémarrez. Les plugins compilés pour TShock 5 (.NET 8) doivent être recompilés pour TShock 6 (.NET 9). Téléchargez toujours une version prévue pour votre release TShock.
FAQ
J’ai perdu le code de setup, que faire ?
Ouvrez tshock/setup-code.txt. S’il n’existe plus, le setup a déjà été désactivé (setup.lock). Créez alors un compte depuis la console du serveur : user add <pseudo> <mdp> owner.
Les joueurs ont « version incompatible » en se connectant
La release TShock ne correspond pas à la version de Terraria des joueurs. Vérifiez les versions sur la page des releases.
TShock supporte-t-il les mods Calamity ou Thorium ?
Non. Ce sont des mods tModLoader. TShock ajoute des plugins côté serveur uniquement, jouables avec un client Terraria normal.
Où sont les sauvegardes TShock ?
Dans tshock/backups/, toutes les 10 minutes par défaut. Pour déplacer ou restaurer un monde, voir transférer un monde Terraria.
Pour aller plus loin
- Meilleur hébergeur Terraria 2026 : comment choisir
- Installer un serveur Terraria dédié Vanilla
- Transférer un monde Terraria sur un serveur
- Commandes admin TShock : liste complète par catégorie
- Serveur Terraria privé : mot de passe, whitelist et comptes obligatoires
Sources : TShock releases (GitHub) · Paramètres de ligne de commande TShock · Code source des commandes TShock · Terraria Wiki — TShock
