Configurer serverconfig.txt
Les réglages d'un serveur Terraria se trouvent dans un fichier texte : serverconfig.txt, à la racine du serveur. Il est utilisé en vanilla, avec TShock et avec tModLoader. Cette page détaille les lignes les plus utiles.
Modifier le fichier en toute sécurité
Arrêtez toujours le serveur depuis la Console du panel avant d'éditer serverconfig.txt. Le fichier n'est lu qu'au démarrage : une modification faite serveur allumé n'est pas prise en compte.
- Connectez-vous à votre Panel Game : game.yorkhost.fr
- Sélectionnez votre serveur et arrêtez-le
- Ouvrez l'onglet Files et éditez
serverconfig.txt - Modifiez les valeurs voulues
- Enregistrez, puis démarrez le serveur
Chaque réglage tient sur une ligne, au format clé=valeur, sans espace autour du = :
maxplayers=8
password=MonMotDePasse
Une ligne qui commence par # est un commentaire : elle est ignorée. Pour activer un réglage commenté, retirez le # en début de ligne.
Téléchargez une copie de votre serverconfig.txt avant toute mise à jour ou réinstallation du serveur, et avant un changement de mode (vanilla, tModLoader, TShock).
Paramètres de l'onglet Startup
Certaines valeurs (nom du monde, nombre de joueurs, taille…) peuvent aussi être exposées dans l'onglet Startup du panel. Dans ce cas, c'est la valeur de l'onglet Startup qui prend le dessus : le panel peut la réécrire dans serverconfig.txt à chaque démarrage. Si une modification du fichier semble annulée au redémarrage, vérifiez si le même réglage n'est pas défini dans l'onglet Startup et modifiez-le à cet endroit.
Le monde
| Clé | Rôle |
|---|---|
world | Chemin du fichier .wld que le serveur charge. S'il n'existe pas et que autocreate est défini, le serveur le crée |
autocreate | Taille du monde à générer s'il n'existe pas : 1 petit, 2 moyen, 3 grand |
worldname | Nom donné au monde lors de sa création |
seed | Graine de génération (facultatif) |
difficulty | Difficulté du monde lors de sa création : 0 Classique, 1 Expert, 2 Maître, 3 Voyage |
worldpath | Dossier dans lequel le serveur cherche et enregistre les mondes |
Tailles de monde :
autocreate | Taille | Dimensions (tuiles) |
|---|---|---|
1 | Petit | 4200 × 1200 |
2 | Moyen | 6400 × 1800 |
3 | Grand | 8400 × 2400 |
Exemple pour un monde moyen en Expert :
world=<chemin existant>/Worlds/MonMonde.wld
autocreate=2
worldname=MonMonde
difficulty=1
seed=
Pour la ligne world, conservez le chemin déjà présent dans votre fichier et ne changez que le nom du fichier .wld.
autocreate, worldname, seed et difficulty ne servent qu'à créer un nouveau monde. Une fois le monde généré, les modifier n'a aucun effet sur lui. Pour changer de taille ou de seed, il faut créer un autre monde (en changeant le nom du fichier dans world). Pour reprendre un monde existant, voir Importer un monde.
Un personnage Voyage (Journey) ne peut rejoindre qu'un monde Voyage, et un personnage classique ne peut pas rejoindre un monde Voyage. Choisissez la difficulté en accord avec votre groupe. Les seeds spéciales (secret seeds) se saisissent dans seed comme une seed normale ; leur prise en charge dépend de la version du jeu.
Accès et joueurs
| Clé | Rôle |
|---|---|
maxplayers | Nombre maximum de joueurs connectés (jusqu'à 255) |
password | Mot de passe pour rejoindre (vide = aucun) |
motd | Message d'accueil affiché aux joueurs à la connexion |
banlist | Fichier contenant la liste des bannis (vanilla) |
secure | 1 active la protection anti-triche intégrée du serveur |
language | Langue des messages du serveur (par exemple fr-FR ou en-US) |
maxplayers=16
password=MonMotDePasse
motd=Bienvenue sur notre serveur Terraria !
Augmentez maxplayers en cohérence avec votre offre : voir les repères de Premiers pas.
Laissez la ligne port= à la valeur prévue par le panel : le serveur doit écouter sur le port attribué, sinon il sera injoignable. Le réglage upnp est inutile sur un serveur hébergé.
TShock lit aussi serverconfig.txt, mais certains réglages (mot de passe, nombre de places, port…) existent aussi dans son propre fichier tshock/config.json et peuvent y prendre le dessus. Si une valeur semble ignorée sur un serveur TShock, vérifiez ce fichier. Voir Administration et TShock.
Réglages avancés
| Clé | Rôle |
|---|---|
npcstream | Réduit les « sauts » des ennemis à l'écran en envoyant plus de données (valeur par défaut conseillée) |
priority | Priorité du processus serveur : laissez la valeur par défaut |
Permissions du mode Voyage
Sur un monde Voyage, les pouvoirs du mode Voyage (figer le temps, mode dieu, météo, difficulté, vitesse d'apparition des ennemis…) se règlent par des lignes journeypermission_…, par exemple :
journeypermission_time_setfrozen=2
journeypermission_godmode=2
journeypermission_setdifficulty=2
Selon les valeurs habituellement documentées dans le fichier : 0 verrouille le pouvoir pour tout le monde, 1 le réserve à l'hôte, 2 l'autorise à tous les joueurs. Sur un serveur dédié, il n'y a pas d'« hôte » en jeu : utilisez 0 ou 2. Vérifiez la liste exacte des clés dans les commentaires de votre serverconfig.txt.
Changer un réglage sans redémarrer (vanilla)
Quelques valeurs peuvent être modifiées depuis la Console du panel pour la session en cours :
password MonNouveauMotDePasse
motd Nouveau message d'accueil
Pour qu'un changement soit permanent, reportez-le dans serverconfig.txt. Voir toutes les commandes dans Administration et TShock.
Et ensuite ?
- Administration et TShock : commandes console, compte propriétaire, groupes
- Importer un monde et sauvegardes : reprendre un monde
.wldexistant - Dépannage