Vintage Story : configuration, administration et mods

Les serveurs Vintage Story sont configurés via serverconfig.json, administrés avec des commandes en jeu et étendus avec des mods du ModDB officiel. Ce guide couvre les trois.

Configurer serverconfig.json

1. Ouvrez votre serveur et cliquez sur File Manager.
2. Ouvrez serverconfig.json (à la racine, ou sous un chemin data/Playersets affiché dans la console).
3. Modifiez les valeurs, enregistrez, puis redémarrez depuis l'onglet Console.

Paramètres que vous modifierez couramment :

• ServerName — nom affiché dans le navigateur de serveurs.
• Password — à définir pour rendre le serveur privé.
• MaxClients — limite de joueurs.
• WorldConfig — options de génération de monde (climat, hauteur du monde, seed) appliquées lors de la première création du monde.
• AllowPvP / drapeaux liés au mode de jeu — combat et règles.

Préférez les commandes en jeu lorsque c'est possible. De nombreux paramètres peuvent être modifiés en direct avec les commandes /serverconfig une fois que vous êtes administrateur, ce qui évite d'éditer manuellement le JSON (une virgule mal placée corrompt le fichier).

Vous accorder les droits d'administrateur

L'administration (op) débloque les commandes de gestion. L'endroit le plus sûr pour l'exécuter est l'onglet Console, qui est déjà fiable :

/op VotreNomDeJoueur

Vous pouvez maintenant utiliser /gamemode, /time set day, /give, les commandes d'édition de monde et la famille /serverconfig en jeu. Supprimez les droits d'administrateur avec /deop VotreNomDeJoueur.

Liste blanche / contrôle d'accès

Pour restreindre l'accès du serveur aux joueurs approuvés, activez la liste blanche et ajoutez des personnes (depuis la Console ou en tant qu'administrateur en jeu) :

/whitelist on
/player VotreAmi whitelist on

Vous pouvez également définir un Password dans serverconfig.json pour une simple porte d'accès à secret partagé.

Installer des mods depuis le ModDB

Vintage Story dispose d'une base de données de mods officielle.

1. Téléchargez le mod (un fichier .zip ou .cs) depuis le Vintage Story ModDB.
2. Dans le File Manager, déposez-le dans le dossier Mods/.
3. Redémarrez. Le serveur charge les mods au démarrage et affiche chacun d'eux dans la console.
4. Chaque joueur doit avoir les mêmes mods installés pour se connecter — la plupart des mods de contenu sont client+serveur.
5. Vérifiez que la version du mod correspond à la version du jeu de votre serveur ; une incompatibilité est la raison habituelle pour laquelle un mod ne se charge pas.

Problèmes courants

• Le serveur ne démarre pas après la modification de la configuration : JSON invalide — une virgule, une guillemet ou une accolade manquante. Restaurez une sauvegarde ou corrigez la syntaxe avec soin.
• Modifications ignorées : vous n'avez pas redémarré, ou vous avez modifié une configuration qui est remplacée par une valeur /serverconfig en jeu.
• Le mod ne se charge pas : incompatibilité de version avec le jeu, ou un mod de dépendance manquant — vérifiez la page ModDB du mod pour les exigences.
• Les joueurs ne peuvent pas se connecter : le Password est défini, la liste blanche est activée, ou leur ensemble de mods ne correspond pas à celui du serveur.