Comment configurer les groupes et les permissions TShock ?
Groupes et permissions TShock
Les droits TShock sont des groupes, et non le fichier vanilla ops.json. Ouvrez la Console dans le panel VeryGames et saisissez les commandes ci-dessous. Ce logiciel est TShock, pas tModLoader. N’envoyez pas de fichiers .tmod ici. Ils ne seront pas chargés.
Groupes par défaut
Chaque joueur appartient à un groupe. Le groupe détermine quelles commandes il peut exécuter. TShock inclut déjà ceux-ci :
- guest — non connecté. Cela correspond à toute personne qui vient de rejoindre le monde.
- default — connecté avec un utilisateur TShock. Joueurs normaux après /login.
- owner / admin — déjà présents sur le serveur. Conservez-les. Ne supprimez pas le groupe propriétaire du serveur.
Listez les groupes, puis inspectez-en un :
/group list /group info owner /group info default/group info affiche le groupe parent et toutes les permissions de ce groupe. Utilisez-le avant de copier des droits vers un nouveau rang.
Créer un groupe
Créez un groupe vide, puis ajoutez les vrais noms de permissions un par un. Exemple : un rang vip qui peut se téléporter et expulser.
/group add vip /group addperm vip tshock.tp /group addperm vip tshock.admin.kickSupprimez une permission de la même manière :
/group delperm vip tshock.admin.kickNoms de permissions utiles (la chaîne est ce que TShock vérifie, pas la commande de chat) :
- tshock.tp — se téléporter
- tshock.tp.others — téléporter d’autres joueurs
- tshock.warp — utiliser les warps
- tshock.admin.kick — expulser un joueur
- tshock.admin.ban — bannir un joueur
- tshock.admin.mute — rendre un joueur muet
- tshock.item — faire apparaître des objets
N’ajoutez pas * à un rang public. Ce joker donne toutes les permissions, y compris la gestion des utilisateurs. Laissez-le uniquement à owner ou SuperAdmin. Optionnel : /group add vip default crée vip avec default comme parent, afin que vip parte de l’ensemble des droits des utilisateurs connectés au lieu d’être vide.
Attribuer un joueur
Un groupe ne sert à rien tant qu’un utilisateur TShock n’y est pas affecté. Créez d’abord l’utilisateur (voir comment ajouter des admins sur un serveur Terraria TShock), puis déplacez-le :
/user group PlayerName vipRemplacez PlayerName par le nom d’utilisateur TShock, et non par le nom du personnage Terraria s’ils sont différents. Le joueur devra refaire /login s’il est déjà dans le monde.
Gardez SuperAdmin / owner pour la personne qui a créé le serveur. Ne déplacez pas ce compte vers vip. Vous perdriez les commandes permettant de gérer les groupes et les utilisateurs.
API REST
L’API REST est destinée aux outils et aux scripts (bots de statut, panels web, automatisation). Ce n’est pas l’adresse à saisir dans Terraria pour rejoindre le monde. Le jeu utilise l’IP et le port de jeu indiqués dans le panel. REST utilise un hôte et un port différents, également affichés dans le panel.
- Copiez l’hôte et le port REST depuis le panel. Ne les inventez pas.
- Laissez RestApiPort dans la configuration TShock sur la valeur définie par le panel. Modifier cette valeur casse le mapping du panel. Le port public et le port de configuration ne correspondent alors plus.
- Le token API est lié à un utilisateur TShock disposant de droits de groupe suffisants. Créez cet utilisateur, placez-le dans un groupe capable d’exécuter les commandes nécessaires à votre script, puis demandez un token avec ce nom d’utilisateur et ce mot de passe. Un groupe guest ou un groupe vip vide ne suffira pas pour les appels d’administration.
Si un script ne peut pas se connecter, vérifiez d’abord le port REST du panel. Confirmez ensuite que l’utilisateur TShock peut bien se connecter sur le serveur. N’ouvrez pas manuellement un second port REST.
Commande inconnue
Si la Console répond que /group ou /user est inconnu, c’est que le processus n’exécute pas encore TShock, ou que ses plugins ne se sont pas chargés.
- Vérifiez que ce serveur utilise bien le logiciel TShock pour Terraria, et non vanilla ni tModLoader.
- Redémarrez depuis le panel et attendez que le serveur soit en ligne.
- Ouvrez de nouveau la Console puis réessayez /group list.
Terraria vanilla n’a pas de groupes. Les mods tModLoader ne se chargeront pas sur ce logiciel. Si vous avez besoin de mods, il s’agit d’un autre produit.