Des centaines d’heures de jeu, une base fortifiée, un réseau de mécanismes patiemment construit… et tout ça dans un seul fichier. Ce guide vous montre comment sauvegarder, restaurer et transférer votre monde Vintage Story, notamment pour passer d’une partie solo à un serveur.
Comprendre le fichier de monde
Vintage Story stocke tout le monde dans un fichier unique au format .vcdbs (une base de données SQLite) : terrain, constructions, coffres, inventaires et données des joueurs.
| Élément | Emplacement |
|---|---|
| Monde du serveur | Saves/default.vcdbs (clé SaveFileLocation de serverconfig.json) |
| Sauvegardes générées | Dossier Backups/ |
| Mondes solo (Windows) | %appdata%\VintagestoryData\Saves\ |
| Mondes solo (Linux) | ~/.config/VintagestoryData/Saves/ |
💡 Sauvegardez aussi la configuration
Pour une restauration complète, gardez aussi serverconfig.json, le dossier Mods et le dossier ModConfig. Un monde moddé chargé sans ses mods perd les blocs et objets correspondants.
Faire une sauvegarde manuelle
Avec /genbackup (serveur allumé)
La méthode recommandée, sans couper le serveur :
/genbackupLe serveur crée une copie complète du monde dans le dossier Backups. Vous pouvez aussi nommer la sauvegarde :
/genbackup avant-maj-1-22Avec le panel de votre hébergeur
Chez HebergTonServ, l’onglet Sauvegardes du panel crée une archive des fichiers du serveur en un clic, et permet de la restaurer tout aussi simplement. Pensez à faire un /autosavenow juste avant pour que les derniers changements soient bien écrits sur le disque.
En copiant le fichier (serveur arrêté)
- Arrêtez le serveur (
/stop) - Téléchargez
Saves/default.vcdbsvia le gestionnaire de fichiers ou SFTP - Redémarrez
⚠️ Ne copiez pas le fichier à chaud
Copier le .vcdbs pendant que le serveur tourne peut donner une copie incohérente. Serveur allumé : utilisez /genbackup. Copie de fichier : serveur arrêté.
Importer un monde solo sur un serveur
Vous avez commencé en solo et vos amis veulent vous rejoindre ? Voici comment transférer votre monde.
Étape 1 : vérifier les versions
Le serveur doit être sur la même version que celle de votre partie solo (ou plus récente). Si votre monde utilise des mods, installez les mêmes mods sur le serveur (voir installer des mods).
Étape 2 : récupérer le fichier du monde
Sur votre PC, fermez le jeu et ouvrez :
- Windows : Win + R, tapez
%appdata%\VintagestoryData\Saves - Linux :
~/.config/VintagestoryData/Saves
Repérez le fichier .vcdbs qui porte le nom de votre monde.
Étape 3 : l’envoyer sur le serveur
- Arrêtez le serveur
- Faites une sauvegarde de l’ancien
Saves/default.vcdbs(ou supprimez-le si le monde actuel ne vous intéresse pas) - Envoyez votre fichier dans le dossier
Savesdu serveur (SFTP recommandé : un monde exploré pèse souvent plusieurs Go) - Renommez-le
default.vcdbs
Alternative : gardez son nom et indiquez son chemin dans serverconfig.json :
"WorldConfig": {
"SaveFileLocation": "/chemin/vers/Saves/mon-monde.vcdbs"
}Étape 4 : démarrer et vérifier
Démarrez le serveur, connectez-vous : vous retrouvez votre base, votre inventaire et votre position. Pensez à vous redonner les droits avec /op VotrePseudo si besoin.
ℹ️ Créer un monde sur mesure
Cette méthode est aussi le moyen le plus simple de lancer un serveur avec des réglages de monde précis : créez le monde en solo via Customize (saisons, tempêtes temporelles, taille du monde…), quittez aussitôt, puis importez-le.
Récupérer le monde du serveur en solo
Le chemin inverse fonctionne aussi : téléchargez Saves/default.vcdbs (serveur arrêté), renommez-le par exemple monde-serveur.vcdbs, et placez-le dans votre dossier Saves local. Il apparaît dans la liste des mondes solo.
Restaurer une sauvegarde
- Arrêtez le serveur
- Renommez le monde actuel (par exemple
default-casse.vcdbs) pour le garder au cas où - Copiez la sauvegarde voulue depuis
Backups/versSaves/et renommez-ladefault.vcdbs - Redémarrez le serveur
Automatiser les sauvegardes (VPS Linux)
Si vous gérez votre propre serveur avec server.sh (voir installer un serveur sur VPS Linux), programmez un /genbackup automatique avec cron.
sudo -u vintagestory crontab -e# Sauvegarde toutes les 6 heures
0 */6 * * * /home/vintagestory/server/server.sh command "/genbackup"
# Supprime les sauvegardes de plus de 7 jours chaque nuit à 4h
0 4 * * * find /home/vintagestory/data/Backups -type f -mtime +7 -delete🚨 Une sauvegarde sur le même disque n'est qu'à moitié une sauvegarde
Si le disque ou le serveur est perdu, les sauvegardes locales partent avec. Copiez régulièrement vos backups ailleurs (votre PC, un stockage externe) avec SFTP ou rsync.
Monde corrompu : que faire ?
Un arrêt brutal ou un disque plein peut abîmer des chunks. Avant de restaurer une sauvegarde :
- Vérifiez l’espace disque : le serveur s’arrête volontairement sous 400 Mo libres (
DieBelowDiskSpaceMb) serverconfig.jsonproposeRegenerateCorruptChunks(régénère les chunks endommagés) etRepairMode(mode de réparation avancé). Faites toujours une copie du monde avant de les activer, et désactivez-les ensuite.- En dernier recours, restaurez la sauvegarde la plus récente
Questions fréquentes
Où est sauvegardé le monde d’un serveur Vintage Story ?
Dans Saves/default.vcdbs, un fichier unique dont le chemin est défini par SaveFileLocation dans serverconfig.json.
Comment mettre mon monde solo sur un serveur ?
Serveur arrêté, envoyez votre .vcdbs dans Saves, renommez-le default.vcdbs (ou modifiez SaveFileLocation) puis redémarrez.
Comment faire une sauvegarde ?
/genbackup dans la console, sans arrêter le serveur. La copie est placée dans Backups.
Les inventaires des joueurs sont-ils conservés ?
Oui, ils sont stockés dans le fichier .vcdbs et suivent le monde lors du transfert.
Sauvegardes automatiques incluses sur nos serveurs de jeux. Découvrez comment bien choisir votre hébergeur Vintage Story.
Équipe HebergTonServ
Administrateurs serveurs de jeux
