Ce guide couvre les problèmes courants que vous pouvez rencontrer lors de l'exécution d'un serveur dédié Team Fortress 2, notamment les problèmes de jeton GSLT, SourceMod qui ne se charge pas, les erreurs VAC et la visibilité dans le navigateur de serveurs. Pour la configuration initiale du serveur, consultez le Guide de configuration du serveur TF2.
Problèmes de jeton GSLT
Symptôme : La console du serveur affiche "Invalid or expired GSLT" ou le serveur n'est pas listé publiquement.
Causes et solutions :
- Le jeton a expiré en raison d'une inactivité prolongée — régénérez-le sur steamcommunity.com/dev/managegameservers.
- Le compte Steam propriétaire du jeton a un bannissement VAC — un nouveau compte non banni doit générer le jeton.
- Le jeton est déjà utilisé par un autre serveur en cours d'exécution — chaque instance de serveur nécessite son propre jeton unique.
- La ligne
sv_setsteamaccountdansserver.cfgcontient une faute de frappe ou des espaces supplémentaires — vérifiez qu'elle correspond exactement à la chaîne du jeton. - Vous avez utilisé le mauvais App ID lors de la génération du jeton — TF2 nécessite l'App ID 440.
SourceMod ne se charge pas
Symptôme : sm version retourne "Unknown command" après l'installation.
Causes et solutions :
- MetaMod:Source n'est pas installé ou ne se charge pas — confirmez que
meta versionfonctionne d'abord. Si ce n'est pas le cas, revérifiez l'installation de MetaMod. SourceMod ne peut pas fonctionner sans MetaMod. - Fichiers téléversés dans le mauvais répertoire — SourceMod doit être dans
tf/addons/sourcemod/, pas à la racine du serveur ou dans un autre dossier de jeu. - Mauvaise version téléchargée — le serveur fonctionne sous Linux. Assurez-vous d'avoir téléchargé la version Linux, pas la version Windows.
- Problèmes de permissions de fichiers — assurez-vous que tous les fichiers téléversés sont lisibles. Retéléversez via SFTP en cas de doute.
- Vérifiez les logs — consultez
tf/addons/sourcemod/logs/pour les messages d'erreur indiquant ce qui n'a pas pu se charger.
Problèmes VAC / Mode sécurisé VAC désactivé
Symptôme : La console du serveur affiche "VAC secure mode is disabled" ou les joueurs sont avertis que VAC est désactivé.
Causes et solutions :
- Pas de GSLT valide — VAC nécessite un jeton
sv_setsteamaccountvalide. Consultez le Guide de configuration du serveur pour les instructions GSLT. - Un plugin ou une extension chargé(e) est signalé(e) — certaines extensions binaires non officielles peuvent déclencher la désactivation de VAC. Supprimez les plugins récemment installés un par un pour identifier la cause.
sv_cheats 1est défini — VAC est automatiquement désactivé lorsque les cheats sont activés. Assurez-vous quesv_cheats 0est dans votreserver.cfg.- Si VAC reste désactivé après avoir traité les points ci-dessus, effectuez un redémarrage complet du serveur (pas seulement un changement de carte).
Le serveur n'apparaît pas dans le navigateur
Symptôme : Votre serveur fonctionne mais n'apparaît pas dans le navigateur de serveurs Steam.
Causes et solutions :
- Pas de GSLT valide — un Game Server Login Token valide est requis pour l'affichage public. Consultez le Guide de configuration du serveur.
- Le serveur vient de démarrer — les nouveaux serveurs peuvent prendre plusieurs minutes pour apparaître dans le navigateur après la première connexion à Steam.
- Problème de pare-feu ou de port — confirmez que le port de jeu du serveur est ouvert. Vérifiez le GPanel pour votre port assigné.
- Testez d'abord la connexion directe — essayez de vous connecter via
connect IP:PORTdans la console développeur pour confirmer que le serveur est accessible avant de dépanner l'affichage dans le navigateur.
Les plugins font planter le serveur
Symptôme : Le serveur plante ou redémarre de manière inattendue après l'installation ou la mise à jour d'un plugin.
Causes et solutions :
- Vérifiez
tf/addons/sourcemod/logs/pour les logs de crash et les messages d'erreur immédiatement après le crash. - Désactivez les plugins récemment ajoutés en déplaçant leurs fichiers
.smxverstf/addons/sourcemod/plugins/disabled/. - Assurez-vous que toutes les dépendances des plugins (ex. : TF2Attributes, DHooks) sont installées et à la bonne version.
- Certains plugins nécessitent une version spécifique de l'API SourceMod — vérifiez la compatibilité sur le fil AlliedModders du plugin.
- Si le serveur plante au démarrage, utilisez le gestionnaire de fichiers de GPanel ou SFTP pour déplacer le fichier de plugin problématique pendant que le serveur est arrêté.
.smx malveillants peuvent exécuter des commandes arbitraires sur votre serveur. Utilisez uniquement des plugins provenant d'AlliedModders ou de dépôts GitHub vérifiés.
Les joueurs ne peuvent pas se connecter
Symptôme : Les joueurs reçoivent une erreur de délai d'attente, connexion refusée ou "server not responding".
Causes et solutions :
- Le serveur ne fonctionne pas — vérifiez le GPanel pour confirmer que le serveur est en ligne et pas dans une boucle de crash.
- Mauvaise IP ou port — vérifiez les détails de connexion dans GPanel. Consultez le guide Comment trouver l'IP et le port de votre serveur.
- Mot de passe incorrect — si
sv_passwordest défini dansserver.cfg, le joueur doit entrer le bon mot de passe lors de la connexion. - Le serveur est plein — vérifiez si le serveur a atteint sa limite
maxplayers. - Délai de téléchargement de carte personnalisée — si le serveur utilise une carte personnalisée sans FastDL configuré, les joueurs avec des connexions lentes peuvent expirer pendant le téléchargement de la carte. Consultez le Guide de configuration du serveur pour la configuration FastDL.
Étapes de diagnostic générales
Lors du dépannage de tout problème de serveur TF2, suivez ces étapes pour recueillir des informations utiles avant d'ouvrir un ticket de support :
- Vérifiez la sortie de la console du serveur dans GPanel pour les messages d'erreur.
- Consultez les logs dans
tf/addons/sourcemod/logs/(si SourceMod est installé). - Vérifiez
tf/console.logou la console GPanel pour les erreurs au niveau du moteur. - Si le problème a commencé après une modification, annulez la modification et testez à nouveau.
- Essayez de vous connecter directement via
connect IP:PORTdans la console développeur pour exclure les problèmes liés au navigateur.
Articles connexes
- Guide de configuration du serveur TF2 — Configuration de Server.cfg, jetons GSLT, rotation des cartes, FastDL, connexion
- Configuration Admin et Plugins TF2 — Installation de SourceMod/MetaMod, comptes admin, gestion des plugins
- Comment trouver l'IP et le port de votre serveur
- Comment téléverser des fichiers via SFTP
tf/addons/sourcemod/logs/ ou de la console de votre serveur.