Dépannage

Les problèmes les plus fréquents sur un serveur Terraria, et comment les résoudre. Dans tous les cas, la Console du panel est votre premier outil : lisez les dernières lignes affichées avant l'arrêt ou l'erreur.

Le serveur ne démarre pas

La console affiche un menu de choix de monde

Si la console affiche la liste des mondes (avec des options du type n pour un nouveau monde) et attend une réponse, le serveur n'a pas trouvé le monde indiqué dans serverconfig.txt et ne sait pas lequel créer.

• Vérifiez que la ligne world= pointe vers un fichier .wld existant, avec le nom exact (majuscules comprises)
• Ou définissez autocreate (1, 2 ou 3) pour que le serveur crée le monde automatiquement

Voir Configurer serverconfig.txt et Importer un monde.

Le serveur a créé un nouveau monde au lieu du vôtre

Le fichier indiqué dans world= n'existait pas (faute de frappe, mauvais dossier, majuscules), et autocreate étant défini, le serveur en a généré un nouveau. Votre monde n'est pas perdu : arrêtez le serveur, corrigez le nom dans world= et redémarrez.

Erreur de lecture de serverconfig.txt

Une ligne mal formée (espace autour du =, caractère parasite) peut rendre un réglage invalide. Comparez avec votre dernière copie fonctionnelle. Si une valeur est remise à zéro à chaque démarrage, elle est probablement définie dans l'onglet Startup : voir Paramètres de l'onglet Startup.

Le monde ne se charge plus

Après un arrêt brutal, un monde peut être endommagé. Restaurez une sauvegarde depuis l'onglet Backups, ou utilisez la copie .wld.bak : voir Restaurer une sauvegarde. Un monde enregistré par une version plus récente du jeu ne peut pas être chargé par un serveur plus ancien.

Un plugin TShock bloque le démarrage

Un plugin écrit pour une autre version de TShock provoque souvent une erreur au chargement. Arrêtez le serveur, retirez le dernier plugin ajouté du dossier ServerPlugins/, puis redémarrez. Voir Installer des plugins TShock.

Joueurs qui ne peuvent pas se connecter

Symptôme	Cause probable	Solution
Délai dépassé / connexion impossible	Mauvais IP ou port, serveur encore en chargement	Utilisez l'IP et le port affichés dans le panel avec Rejoindre via IP, attendez la fin du chargement
Message de version différente (not using the same version)	Client et serveur dans des versions différentes	Mettez à jour le jeu, ou le serveur (voir ci-dessous)
Refus avec un personnage Voyage (ou classique)	Personnage et monde de modes différents	Personnage Voyage pour un monde Voyage, personnage classique sinon
Mot de passe refusé	password modifié sans redémarrage, ou défini dans TShock	Redémarrez ; en TShock, vérifiez aussi tshock/config.json
Serveur plein	maxplayers (ou MaxSlots en TShock) atteint	Augmentez la valeur, en tenant compte de votre offre
Déconnexion pendant le chargement (tModLoader)	Mods manquants ou de version différente	Voir Mods tModLoader
Le joueur est expulsé tout de suite (TShock)	Joueur banni, ou connexion obligatoire	Vérifiez /ban list et le réglage RequireLogin
Joueur sur console ou mobile	Versions non compatibles avec un serveur PC	Nos serveurs s'adressent aux joueurs PC

Ports

L'ouverture du port est gérée par YorkHost. Ne modifiez pas la ligne port= de serverconfig.txt (ni le port dans tshock/config.json) : le serveur doit écouter sur le port attribué par le panel. Voir Tous les ports sont-ils ouverts ? et Impossible de se connecter au serveur.

Version client différente du serveur

Le jeu et le serveur doivent être dans la même version. Après une mise à jour de Terraria sur Steam, les joueurs peuvent être refusés tant que le serveur n'est pas à jour.

• Vanilla : mettez à jour le serveur selon ce que propose le panel, ou demandez-le à notre support. Sauvegardez avant.
• TShock : TShock doit publier une version compatible avec chaque mise à jour de Terraria, ce qui peut prendre un peu de temps. En attendant, les joueurs ne peuvent pas rejoindre avec la toute dernière version du jeu. Mettez à jour TShock dès qu'une version compatible est disponible, et vérifiez vos plugins.
• tModLoader : le serveur et les joueurs doivent utiliser la même version de tModLoader (même branche Steam, stable ou bêta).

Mods tModLoader

Symptôme	Solution
Un mod ne se charge pas, la console signale une dépendance manquante	Installez le mod demandé et ajoutez-le à enabled.json
Un mod présent n'est pas chargé	Vérifiez que son nom figure dans enabled.json, sans faute de frappe
Le serveur s'arrête pendant le chargement des mods	Retirez le dernier mod ajouté de enabled.json, redémarrez, puis vérifiez sa version et ses dépendances
Les joueurs sont refusés après une mise à jour d'un mod	Mettez à jour le .tmod du serveur dans la même version que celle des joueurs
Les joueurs ne parviennent pas à télécharger les mods à la connexion	Faites-les s'abonner aux mêmes mods sur le Workshop et les activer avant de rejoindre

Voir tModLoader : mods et Calamity.

Mémoire insuffisante

Si le serveur s'arrête brutalement pendant le chargement des mods, la génération d'un grand monde ou en pleine partie, sans erreur claire, ou si la console mentionne un manque de mémoire (Out of memory), la RAM de votre offre est probablement saturée.

• Surveillez l'utilisation de la RAM sur la page du serveur dans le panel
• Retirez les mods les moins utiles, en particulier les gros mods de contenu ou de musique
• Passez à une offre supérieure : Hallowed (6 Go) pour Calamity ou Thorium, Zenith (8 Go) pour les gros modpacks. Vous pouvez monter en gamme à tout moment depuis votre espace client.

Un serveur vanilla ou TShock tient en revanche très bien dans 2 Go : si la RAM est saturée sans mods, contactez le support.

Lag et désynchronisation

Terraria sollicite surtout un seul cœur : c'est la charge du monde, plus que le nombre de joueurs, qui compte.

1. Limitez les grosses fermes et machines : les fermes à monstres automatisées, beaucoup de statues reliées par câbles, de l'eau ou de la lave en mouvement constant sollicitent fortement le serveur. Après de grands travaux avec des liquides, settle dans la console stabilise l'eau.
2. Évitez les objets au sol en masse : des centaines d'objets laissés au sol pèsent sur le serveur.
3. Allégez la liste de mods sur un serveur tModLoader.
4. Redémarrez régulièrement le serveur, par exemple chaque nuit, avec un redémarrage automatique depuis l'onglet Schedules.
5. Vérifiez la connexion du joueur : si un seul joueur a du lag, le problème vient probablement de sa connexion.

Pour analyser l'utilisation des ressources, voir aussi Debug des performances.

Toujours bloqué ?

Contactez le support 7j/7 sur Discord ou via votre espace client, en indiquant :

• le nom de votre serveur et son mode (vanilla, tModLoader ou TShock)
• ce que vous avez modifié juste avant le problème
• les dernières lignes de la console au moment de l'erreur