Créer un serveur Vintage Story : mods, réglages du monde et RAM

Un serveur Vintage Story se met en place avec un seul fichier et quelques commandes. serverconfig.json contient le nom, le port (42420 par défaut), le nombre maximal de joueurs (16 par défaut) et un éventuel mot de passe. Vous choisissez le monde avec un préréglage de style de jeu, puis vous l'ajustez plus tard avec /worldconfig. Les mods sont des fichiers .zip dans le dossier Mods, et les joueurs les récupèrent automatiquement en rejoignant. Pour la mémoire, le wiki officiel compte 1 Go plus 300 Mo par joueur : 2 Go pour trois joueurs, 4 Go pour une dizaine. La version stable actuelle est la 1.22.7.

Un serveur dédié, c'est pour quand vous n'êtes pas là

Jouer ensemble est aussi possible sans serveur séparé : ouvrez votre monde et choisissez Open to LAN ou Open to Internet. Cette seconde option tente d'ouvrir un port sur votre box via UPnP ; selon les développeurs, cela fonctionne d'emblée dans environ 60 % des cas. Sinon, vous devez rediriger vous-même le port 42420 (TCP et UDP). Et le monde n'est accessible que tant que votre jeu est ouvert.

Un serveur dédié tourne indépendamment de votre PC : vos amis continuent de construire pendant que vous dormez, et vous pouvez accueillir plus de joueurs qu'un PC de jeu ne peut en supporter en parallèle. Une nuance : PassTimeWhenEmpty est désactivé par défaut, donc sans joueurs, le calendrier s'arrête. Si vous voulez que les saisons avancent pendant que personne n'est connecté, passez-le à true.

Quand s'en passer : vous jouez toujours à deux ou trois en même temps et Open to Internet fonctionne chez vous ? Alors vous n'avez pas besoin de serveur.

serverconfig.json : d'abord arrêter, ensuite modifier

Chez nous, le fichier se trouve dans data/serverconfig.json, via l'onglet Files du panel. Le wiki est clair : arrêtez le serveur avant de le modifier, et les changements ne s'appliquent qu'après un redémarrage. Vous préférez éviter le JSON ? Beaucoup de champs se règlent aussi en direct avec /serverconfig dans la console. Les principaux champs, avec leurs valeurs par défaut :

"ServerName": "Vintage Story Server",
"Port": 42420,
"MaxClients": 16,
"Password": null,
"AdvertiseServer": false,
"WhitelistMode": 0,
"PassTimeWhenEmpty": false,
"WorldConfig": {
  "SaveFileLocation": ".../Saves/default.vcdbs",
  "WorldName": "A new world",
  "PlayStyle": "surviveandbuild"
}

• ServerName : 4 à 80 caractères, obligatoire si vous voulez figurer dans la liste publique des serveurs.
• MaxClients : des valeurs plus élevées coûtent plus de RAM et de CPU.
• Password : null signifie pas de mot de passe.
• AdvertiseServer : désactivé par défaut depuis 1.20 : votre serveur n'apparaît pas dans la liste publique.
• WhitelistMode : 0 = par défaut, 1 = désactivée, 2 = activée. Depuis 1.20, « par défaut » signifie activée sur un serveur dédié. C'est la raison classique pour laquelle vos amis ne peuvent pas entrer.
• MapSizeX et MapSizeZ : largeur et longueur, 1 024 000 blocs par défaut ; MapSizeY est la hauteur (256).
• WorldConfig : SaveFileLocation pointe vers le fichier du monde (.vcdbs) chargé ou créé au démarrage ; WorldName et PlayStyle ne valent que pour un nouveau monde.

Attention sur un serveur hébergé : la ligne de démarrage transmet --port et --maxclients, qui écrasent ce qui figure dans le fichier. Le port vous est attribué par le panel, et le nombre de joueurs se règle via la variable de démarrage Max Clients.

Choisissez le style de jeu avant le premier démarrage

Les réglages du monde dans serverconfig.json ne fonctionnent que tant que le monde n'existe pas encore. Il existe cinq préréglages :

• Standard (surviveandbuild) : l'expérience de survie normale, pas vraiment tendre avec les débutants.
• Exploration (exploration) : pas de tempêtes temporelles, vous gardez votre inventaire en mourant et les créatures n'attaquent que si vous les frappez. Un bon choix pour les nouveaux joueurs.
• Wilderness Survival (wildernesssurvival) : pas de carte, sol et roche qui s'effondrent, et des créatures 50 % plus fortes.
• Homo sapiens (homosapiens) : ni lore ni stabilité temporelle ; vous êtes le premier humain sur la planète.
• Creative Building (creativebuilding) : terrain plat, vol et blocs illimités.

La voie la plus simple selon le wiki : créez le monde en solo via Customize, arrêtez le serveur et envoyez le fichier .vcdbs dans data/Saves. Renommez-le en default.vcdbs ou faites pointer SaveFileLocation vers lui.

Ensuite, vous modifiez beaucoup de réglages en direct avec /worldconfig nom valeur (sensible à la casse, redémarrage ensuite). Les plus connus :

• temporalStorms : off, veryrare, rare, sometimes (par défaut, environ tous les 10 à 20 jours de jeu), often ou veryoften.
• deathPunishment : drop (par défaut) ou keep.
• blockGravity : sandgravel (par défaut) ou sandgravelsoil, plus caveIns on ou off pour la roche qui s'effondre.
• creatureHostility : aggressive, passive ou off.

Tout ne se change pas après coup : startingClimate, graceTimer, worldClimate, worldWidth et worldLength sont figés dès que le monde est créé.

Mods : un .zip dans le dossier, tout le monde sur la même version

La source officielle est la ModDB, sur mods.vintagestory.at ; vérifiez pour chaque mod la version du jeu pour laquelle il a été conçu. Il en existe trois sortes : les content mods (JSON sans C# : blocs, objets, créatures), les code mods (C#, pour de nouveaux systèmes) et les theme packs (apparence uniquement). Chaque mod indique aussi où il tourne : Server, Client ou Universal.

1. Arrêtez le serveur et placez le .zip dans data/Mods. Ne le décompressez pas.
2. Redémarrez le serveur. Vous pouvez aussi installer depuis la console avec /moddb install modid.
3. En rejoignant, les joueurs acceptent la liste des mods ; le jeu télécharge alors les mods Server et Universal dans un dossier à part (ModsByServer). Les mods Client, chaque joueur les installe lui-même.

Le piège, ce sont les versions. La version du jeu des joueurs doit être identique à celle du serveur, et après une mise à jour du jeu, vous mettez aussi vos mods à jour. Faites une sauvegarde avant d'ajouter ou de retirer des mods : après la suppression d'un mod, des blocs de votre monde peuvent être endommagés.

Administration : vous nommer admin et laisser entrer vos amis

Tapez ces commandes dans la console du panel, ou dans le chat en tant qu'admin :

• /op VotreNom : vous nommer admin (équivaut à /player VotreNom role admin).
• /player Ami whitelist on : ajouter un joueur à la whitelist, vous y compris.
• /player Ami role suplayer : changer le rôle d'un joueur.
• /serverconfig password secret : définir un mot de passe ; /serverconfig nopassword le supprime.
• /serverconfig advertise 0 : ne pas apparaître dans la liste publique.
• /genbackup : copie complète du monde.
• /stop : arrêt propre du serveur.

La whitelist s'applique immédiatement, sans redémarrage. Les nouveaux joueurs reçoivent le rôle défini dans DefaultRoleCode (suplayer par défaut). Réglez-le sur suvisitor si les nouveaux venus doivent d'abord se contenter de regarder et de discuter.

Version 1.22.7 et mise à jour en toute sécurité

Au 23 septembre 2026, la 1.22.7 est la version stable. Le wiki est strict sur les mises à jour : supprimez d'abord les anciens fichiers d'installation, mais jamais votre dossier de données, sinon le comportement devient imprévisible. Dans notre panel, la branche (stable, unstable ou pre) et la version (latest par défaut) sont des variables de démarrage, de sorte qu'une réinstallation récupère la dernière version. Faites une sauvegarde avant, mettez vos mods à jour et faites jouer tout le monde sur la même version. Vous remarquez un petit à-coup toutes les cinq minutes ? C'est probablement la sauvegarde automatique, qui a lieu toutes les 300 secondes par défaut.

Combien de RAM : le calcul officiel

Le wiki donne une estimation prudente pour un monde de survie où les joueurs se dispersent : 1 Go de base plus 300 Mo par joueur, quatre threads, et 1 GHz plus 100 MHz de fréquence par joueur. Comptez les joueurs connectés en même temps, pas la longueur de votre whitelist :

À cela s'ajoutent les mods et la distance d'affichage. MaxChunkRadius (12 par défaut) détermine jusqu'où les joueurs peuvent charger le monde, et une valeur plus haute coûte plus de RAM. Avec une liste de mods conséquente, prenez l'offre au-dessus. Soyons honnêtes aussi : le wiki qualifie ce calcul de conservateur, et avec quelques réglages on peut descendre plus bas. Et si votre serveur bute sur le processeur plutôt que sur la mémoire, davantage de RAM n'y changera rien. /stats vous montre ce que le serveur utilise réellement.

Pour les groupes plus importants, les offres Vintage Story vont jusqu'à Chief avec 16 Go pour 24,00 € par mois, avec protection DDoS et résiliables chaque mois. Choisissez un emplacement proche de vos joueurs (Hengelo, Francfort, Varsovie ou Beauharnois) : selon le wiki, jouer depuis un autre continent entraîne de la latence. La commande et le démarrage sont expliqués dans Comment démarrer un serveur Vintage Story ?, le travail au quotidien dans gérer votre serveur via le panel.

Questions fréquentes

Quel port utilise un serveur Vintage Story ?

Par défaut le port 42420. Chez vous, redirigez-le en TCP et, depuis la version 1.20, aussi en UDP. Sur un serveur hébergé, le port vous est attribué par le panel.

De combien de RAM un serveur Vintage Story a-t-il besoin ?

Le wiki officiel compte 1 Go de base plus 300 Mo par joueur connecté en même temps. Cela donne 2 Go pour trois joueurs, 4 Go pour une dizaine et 6 Go pour seize. Les mods et une plus grande distance d'affichage en demandent davantage.

Pourquoi mes amis ne peuvent-ils pas rejoindre mon serveur Vintage Story ?

Le plus souvent à cause de la whitelist : depuis la version 1.20, elle est activée par défaut sur les serveurs dédiés. Ajoutez chaque joueur avec /player nom whitelist on dans la console. Vérifiez aussi que tout le monde joue sur la même version du jeu que le serveur.

Comment me nommer admin sur un serveur Vintage Story ?

Tapez /op votrenom dans la console du serveur ; c'est l'équivalent de /player votrenom role admin. Sans console, ajoutez "StartupCommands": "/op votrenom" dans serverconfig.json et redémarrez.

À lire aussi

• VPS ou serveur de jeu : de quoi avez-vous vraiment besoin ?
• Serveur et ping : pourquoi les Pays-Bas sont un bon hub