Une nouvelle version de Vintage Story vient de sortir, vos joueurs l’ont déjà installée… et ne peuvent plus rejoindre le serveur. Mettre à jour est indispensable, mais une mise à jour mal préparée peut casser vos mods, voire votre monde. Voici la méthode sûre, que votre serveur soit chez vous ou chez un hébergeur Vintage Story.
Comprendre les numéros de version
Vintage Story utilise des numéros du type 1.22.7 :
| Type | Exemple | Risque |
|---|---|---|
| Corrective (dernier chiffre) | 1.22.6 → 1.22.7 | Faible : corrections de bugs, mods presque toujours compatibles |
| Majeure (chiffre du milieu) | 1.21.x → 1.22.x | Élevé : nouveau contenu, génération modifiée, mods à mettre à jour, parfois nouveau runtime .NET |
📌 Rappel .NET
La 1.22 nécessite .NET 10, la 1.21 .NET 8, les versions antérieures .NET 7. Chez un hébergeur, c'est géré pour vous. Sur votre propre machine, vérifiez le runtime avant une mise à jour majeure.
Règle d’or : le client et le serveur doivent être sur exactement la même version. Un serveur en 1.22.6 refuse un joueur en 1.22.7, et inversement.
Étape 1 : décider du bon moment
Pour une mise à jour majeure, il n’y a aucune urgence à migrer le jour de la sortie :
- Les premiers correctifs arrivent souvent dans les jours qui suivent
- Vos mods indispensables ne sont peut-être pas encore à jour
- Vos joueurs peuvent rester sur l’ancienne version en attendant (en installant cette version précise depuis leur compte)
Annoncez une date sur votre Discord et laissez le temps aux mods de suivre.
Étape 2 : vérifier la compatibilité des mods
Pour chaque mod installé, ouvrez sa page sur mods.vintagestory.at et vérifiez qu’une version existe pour la nouvelle version du jeu. Depuis la console, vous pouvez aussi lister vos mods puis chercher les versions compatibles :
/moddb list
/moddb searchcompatible nom du modFaites trois listes :
| Mod | Statut | Action |
|---|---|---|
| Compatible | ✅ | Télécharger la nouvelle version |
| Pas encore à jour | ⏳ | Attendre, ou migrer sans lui |
| Abandonné | ❌ | Trouver une alternative |
🚨 Retirer un mod de contenu
Si vous migrez sans un mod qui ajoute des blocs ou des objets, ceux-ci disparaissent du monde. Pour un mod central (cuisine, construction), mieux vaut attendre sa mise à jour.
Étape 3 : sauvegarder (vraiment)
Dans la console :
/announce Mise à jour du serveur dans 10 minutes, pensez à vous mettre à l'abri !
/genbackup avant-maj-1-22Puis téléchargez la sauvegarde hors du serveur (via SFTP), avec :
serverconfig.json- le dossier
Mods/(vos versions actuelles) - le dossier
ModConfig/
C’est votre billet retour si quelque chose tourne mal.
Étape 4 : mettre à jour le serveur
Arrêtez d’abord le serveur proprement (/stop ou bouton Arrêter du panel).
Chez un hébergeur
Chez HebergTonServ, la version du jeu se gère depuis le panel. Selon l’installation de votre serveur, elle se change dans la configuration de démarrage du serveur (menu Configuration) ; en cas de doute, ouvrez un ticket, le support s’en occupe. Faites toujours l’étape 3 avant : une réinstallation peut remplacer des fichiers.
Sur Windows (serveur maison)
Le serveur est installé avec le jeu : mettez à jour Vintage Story avec le lanceur ou l’installateur de la nouvelle version, et VintagestoryServer.exe est mis à jour en même temps. Guide : créer un serveur sur Windows.
Sur Linux (VPS)
Téléchargez l’archive vs_server_linux-x64_<version>.tar.gz de la nouvelle version et remplacez le dossier du serveur, sans toucher au dossier de données. La procédure complète est dans installer un serveur sur VPS Linux.
Étape 5 : mettre à jour les mods
- Supprimez les anciens
.zipdes mods mis à jour dansMods/ - Ajoutez les nouvelles versions (ne gardez jamais deux versions du même mod)
- Retirez les mods non compatibles, si vous avez décidé de migrer sans eux
Étape 6 : tester avant de rouvrir
- Démarrez le serveur et lisez la console jusqu’au message
Dedicated Server now running - Cherchez les erreurs liées aux mods dans les logs
- Connectez-vous vous-même, faites le tour de votre base, ouvrez quelques coffres
- Explorez un peu une zone non générée pour vérifier la génération
Si tout est bon :
/announce Serveur à jour en 1.22.7, bon jeu !Et indiquez clairement la version exacte à vos joueurs.
Revenir en arrière si ça se passe mal
- Arrêtez le serveur
- Réinstallez l’ancienne version du serveur
- Restaurez la sauvegarde d’avant mise à jour (monde,
Mods/,ModConfig/,serverconfig.json) - Redémarrez
⚠️ Ne rouvrez pas le monde migré avec l'ancienne version
Un monde déjà ouvert avec une version plus récente peut avoir été converti. Pour revenir en arrière, repartez toujours de la sauvegarde faite avant la mise à jour. Tout ce qui a été construit depuis sera perdu : c'est pourquoi on teste avant de rouvrir.
Checklist de mise à jour
- Mods vérifiés pour la nouvelle version
- Joueurs prévenus (date, version cible)
-
/genbackupfait et téléchargé hors du serveur - Serveur arrêté proprement
- Serveur mis à jour (et .NET si auto-hébergé)
- Mods remplacés, anciennes versions supprimées
- Test complet avant réouverture
- Version exacte communiquée aux joueurs
Questions fréquentes
Comment mettre à jour un serveur Vintage Story ?
Prévenir, sauvegarder (/genbackup + copie hors serveur), vérifier les mods, arrêter, mettre à jour le serveur, remplacer les mods, tester, rouvrir.
Mes mods vont-ils fonctionner après la mise à jour ?
En général oui pour une version corrective. Pour une version majeure, vérifiez chaque mod sur le ModDB avant de migrer.
Peut-on revenir à une ancienne version ?
Oui, en réinstallant l’ancienne version et en restaurant la sauvegarde d’avant mise à jour.
Pourquoi les joueurs ne peuvent plus se connecter ?
Client et serveur doivent être sur la même version exacte. Voir impossible de rejoindre un serveur.
Changement de version et support en français : découvrez comment bien choisir votre hébergeur Vintage Story.
Équipe HebergTonServ
Administrateurs serveurs de jeux
