Vous cliquez sur « Rejoindre » et… rien. Ou un message d’erreur cryptique. Pas de panique : les problèmes de connexion à un serveur Vintage Story reviennent presque toujours aux mêmes causes. Ce guide les passe en revue, du plus fréquent au plus rare, côté joueur et côté administrateur.
Diagnostic express
| Message ou symptôme | Cause la plus probable | Aller à |
|---|---|---|
| Host has failed to respond | Serveur éteint, mauvaise adresse, port non redirigé | Section 1 |
| Host has actively refused | Pare-feu ou mauvais port | Section 2 |
| Refusé à cause de la version | Client et serveur en versions différentes | Section 3 |
| Refusé : whitelist | Pseudo non autorisé | Section 4 |
| Erreur liée aux mods | Conflit de mods client/serveur | Section 5 |
| Téléchargement bloqué | Connexion initiale lente | Section 6 |
| Refusé : compte / session | Vérification de licence | Section 7 |
💡 Premier réflexe
Demandez si d'autres joueurs arrivent à se connecter. Si oui, le problème vient de votre côté (version, mods, whitelist). Si personne ne peut, c'est le serveur ou le réseau.
1. Host has failed to respond
Le jeu a essayé de joindre le serveur mais n’a reçu aucune réponse à temps.
Côté joueur :
- Vérifiez l’adresse et le port : format
IP:port, par exemple51.xx.xx.xx:42420. Si le port n’est pas42420, il doit être précisé. - Demandez si le serveur est bien démarré.
Côté administrateur :
- Vérifiez que la console affiche
Dedicated Server now running on Port 42420. - Serveur maison : la redirection de port doit exister en TCP et en UDP, en deux règles séparées (le wiki officiel déconseille l’option combinée « TCP/UDP »), vers la bonne IP locale.
- L’IP a changé ? L’IP publique de votre box et l’IP locale du PC peuvent changer. Revérifiez les deux.
- IP partagée (CGNAT) : certains fournisseurs attribuent une IPv4 partagée entre plusieurs abonnés. Dans ce cas, la redirection de port est impossible. Demandez une IPv4 dédiée (« full-stack ») à votre opérateur, ou passez par un hébergeur.
ℹ️ Serveur chez un hébergeur ?
Chez un hébergeur, le réseau est déjà configuré. Si « failed to respond » apparaît, vérifiez l'état du serveur dans le panel et l'adresse exacte fournie (IP et port).
2. Host has actively refused
La machine a été atteinte, mais elle a refusé la connexion.
- Pare-feu : autorisez
VintagestoryServer.exedans le pare-feu Windows (règle de trafic entrant), ou ouvrez le port sous Linux (ufw allow 42420/tcpetufw allow 42420/udp). - Mauvais port : le serveur n’écoute peut-être pas sur le port utilisé. Vérifiez la clé
Portdeserverconfig.json. - Serveur en cours de démarrage : attendez la fin du chargement du monde puis réessayez.
Guides : serveur sur Windows · serveur sur Linux.
3. Version du jeu différente
Le client et le serveur doivent être sur la même version (par exemple 1.22.7 des deux côtés).
- Côté joueur : mettez à jour le jeu, ou installez la version précise du serveur depuis votre compte sur le site officiel.
- Côté admin : si une nouvelle version vient de sortir, les joueurs se mettent souvent à jour avant le serveur. Mettez le serveur à jour (après avoir vérifié vos mods), ou annoncez clairement la version à utiliser.
4. Whitelist, mot de passe, ban, serveur plein
Whitelist : sur un serveur dédié, elle est active par défaut. L’admin doit vous ajouter :
/player VotrePseudo whitelist onLe pseudo doit être exactement celui de votre compte Vintage Story.
Mot de passe : renseignez-le dans les informations du serveur, côté client. Côté admin, il se change avec /serverconfig password nouveaumotdepasse (sans espace).
Banni : seul un admin peut lever le ban avec /unban Pseudo.
Serveur plein : la limite est MaxClients. L’admin peut l’augmenter avec /serverconfig maxclients 20, si la RAM suit.
Toutes les commandes : commandes admin Vintage Story.
5. Problèmes de mods
Les mods du serveur sont téléchargés automatiquement par le client. Les conflits viennent presque toujours de mods installés à la main côté joueur.
- Le joueur a une autre version d’un mod du serveur dans son dossier
Mods: supprimez-le, le serveur enverra la bonne version. - Le joueur a un mod client incompatible : désactivez vos mods clients un par un pour trouver le coupable.
- Côté admin : un mod mal installé côté serveur peut empêcher toute connexion. Consultez les logs du serveur.
Guide complet : installer des mods sur son serveur.
6. Téléchargement bloqué à la connexion
À la première connexion, le client télécharge les données du serveur (et les mods). Le wiki officiel note que si le premier kilo-octet met plus de 30 secondes à arriver, il vaut mieux annuler et relancer : la deuxième tentative est généralement bien plus rapide.
Si c’est systématique avec beaucoup de mods, vérifiez la bande passante montante du serveur (fréquent sur un serveur maison).
7. Problème de compte ou de session
Par défaut, le serveur vérifie que chaque joueur possède une licence valide (VerifyPlayerAuth). En cas de refus :
- Déconnectez-vous puis reconnectez-vous à votre compte dans le lanceur
- Vérifiez que votre licence est bien active sur le site officiel
- Si tous les joueurs ont le problème en même temps, les serveurs d’authentification officiels sont peut-être indisponibles : patientez
🚨 Ne désactivez pas VerifyPlayerAuth pour « réparer »
Sans vérification, n'importe qui peut se connecter avec le pseudo d'un admin. Si l'authentification est temporairement en panne, attendez plutôt son retour.
8. Lag ou déconnexions en jeu
Si vous vous connectez mais êtes éjecté ensuite (délai dépassé), le serveur est peut-être surchargé. Voir optimiser son serveur Vintage Story.
Checklist administrateur
- Le serveur est démarré (
Dedicated Server now running) - Le port est correct et communiqué avec l’IP
- Pare-feu : port 42420 TCP et UDP autorisé
- Box : deux redirections séparées TCP et UDP vers la bonne IP locale
- Pas de CGNAT (IPv4 dédiée)
- Même version que les joueurs
- Joueurs ajoutés à la whitelist
- Logs sans erreur de mod
Questions fréquentes
Que signifie « Host has failed to respond » ?
Le serveur n’a pas répondu : serveur éteint, mauvaise adresse ou port non redirigé. Redirigez le port 42420 en TCP et UDP séparément.
Que signifie « Host has actively refused » ?
La machine a refusé la connexion : pare-feu ou mauvais port. Autorisez VintagestoryServer.exe dans le pare-feu.
Pourquoi je suis expulsé juste après la connexion ?
Version différente, absence de la whitelist, mot de passe, ban, serveur plein ou conflit de mods côté client.
Le téléchargement bloque à la connexion, que faire ?
Si le premier Ko met plus de 30 secondes, annulez et relancez : la deuxième tentative est généralement plus rapide.
Fini les redirections de port et les box capricieuses. Avec un hébergeur Vintage Story, le réseau est déjà prêt : voir nos offres.
Équipe HebergTonServ
Administrateurs serveurs de jeux
