Guide de Configuration du Serveur Vintage Story

Ce guide explique comment configurer votre serveur dédié Vintage Story hébergé chez Legion Hosting, incluant le premier démarrage, les variables GPanel, la gestion des versions, la configuration du serveur, les paramètres du monde, la connexion des joueurs et la gestion des sauvegardes. Pour l'installation de mods, consultez Installation de Mods Vintage Story. Pour la configuration admin et les commandes, consultez Commandes Admin Vintage Story.

Avant de commencer : Assurez-vous que votre serveur est créé dans GPanel. Si vous avez besoin d'aide pour trouver l'adresse IP et le port de votre serveur, consultez Comment Trouver l'IP et le Port de Votre Serveur.

Premier Démarrage

Lorsque vous démarrez votre serveur Vintage Story pour la première fois depuis GPanel, le serveur téléchargera automatiquement les fichiers du jeu depuis l'API officielle de Vintage Story et générera un monde par défaut. Ce premier démarrage peut prendre plusieurs minutes pendant le téléchargement et l'extraction des fichiers.

Connectez-vous à GPanel et sélectionnez votre serveur Vintage Story.
Avant de démarrer, consultez l'onglet Startup pour confirmer votre branche de version préférée (stable, unstable ou pre-release).
Cliquez sur Start dans l'onglet Console. Surveillez la sortie console pour les messages de progression pendant que le serveur télécharge et installe les fichiers du jeu.
Une fois qu'un message indique que le serveur est en écoute de connexions, le serveur est prêt. Un fichier serverconfig.json par défaut sera généré automatiquement.

Le premier démarrage prend plus de temps que d'habitude. Le serveur doit télécharger le package complet du serveur Vintage Story avant de pouvoir démarrer. Les démarrages suivants seront beaucoup plus rapides, sauf si vous changez la version ou la branche.

Variables de Démarrage GPanel

Les paramètres principaux du serveur sont contrôlés via l'onglet Startup dans GPanel. Vérifiez et ajustez ces paramètres avant de démarrer votre serveur.

Variable	Par défaut	Description
`SERVER_PORT`	(attribué)	Le port de jeu utilisé par les joueurs pour se connecter. Il est automatiquement attribué par GPanel -- vérifiez l'onglet Network pour connaître votre port attribué.
`MAX_CLIENTS`	`16`	Nombre maximum de joueurs simultanés. Peut être défini jusqu'à 256. Doit correspondre aux ressources de votre plan d'hébergement.
`FILES_BRANCH`	`stable`	La branche de publication à utiliser. Options : `stable`, `unstable` ou `pre`. Consultez la section Gestion des Versions ci-dessous pour plus de détails.
`RELEASE_VERSION`	`latest`	La version spécifique à installer. Définissez sur `latest` pour toujours utiliser la version la plus récente de votre branche choisie, ou entrez un numéro de version spécifique (par ex. `1.19.8`) pour verrouiller cette version.
`OPTIONS`	(vide)	Arguments de ligne de commande supplémentaires passés au processus serveur au démarrage. Laissez vide sauf si vous avez besoin de paramètres de démarrage spécifiques.
`SQLITE_TMPDIR`	(auto)	Répertoire temporaire utilisé par SQLite pour les opérations de base de données. N'a généralement pas besoin d'être modifié.

Après avoir mis à jour les variables de démarrage, redémarrez le serveur depuis GPanel pour que les modifications prennent effet.

Gestion des Versions

Vintage Story propose trois branches de publication. Votre choix de branche est défini via la variable de démarrage FILES_BRANCH dans GPanel.

Branche	Valeur	Description
Stable	`stable`	La branche recommandée pour la plupart des serveurs. Ces versions ont été testées de manière approfondie et sont les plus fiables pour les mondes à long terme.
Unstable	`unstable`	Versions bêta avec de nouvelles fonctionnalités et modifications encore en cours de test. Peuvent contenir des bugs. Utilisez cette branche si vous souhaitez un accès anticipé au nouveau contenu et acceptez une certaine instabilité.
Pre-release	`pre`	Versions de développement précoce. Ce sont les moins testées et peuvent présenter des problèmes importants. Recommandé uniquement à des fins de test -- pas pour les serveurs de production.

Verrouiller une Version Spécifique

Par défaut, RELEASE_VERSION est défini sur latest, ce qui signifie que le serveur téléchargera et installera la version la plus récente disponible sur votre branche choisie à chaque démarrage (si une version plus récente est disponible). Pour empêcher les mises à jour automatiques et verrouiller votre serveur sur une version spécifique :

Allez dans l'onglet Startup de GPanel.
Changez RELEASE_VERSION de latest au numéro de version exact souhaité (par ex. 1.19.8).
Redémarrez le serveur. Il utilisera uniquement la version verrouillée, indépendamment des nouvelles versions disponibles.

Compatibilité des mods : Si vous utilisez des mods, le verrouillage d'une version spécifique est recommandé. Les mises à jour du jeu peuvent casser la compatibilité des mods, et une mise à jour en cours de partie peut causer des problèmes. Vérifiez que vos mods prennent en charge la version cible avant de mettre à jour. Consultez Installation de Mods Vintage Story pour plus de détails.

Changer de branche peut nécessiter une réinitialisation du monde. Passer d'une branche stable à unstable peut introduire des changements de format de monde. Sauvegardez toujours votre monde avant de changer de branche. Si la nouvelle version est incompatible avec votre monde existant, vous devrez peut-être en créer un nouveau.

serverconfig.json

Le fichier de configuration principal du serveur est serverconfig.json, situé dans le répertoire racine du serveur. Ce fichier est généré automatiquement au premier démarrage. Arrêtez le serveur avant de le modifier, puis redémarrez pour que les modifications prennent effet.

Arrêtez le serveur depuis l'onglet Console de GPanel.
Ouvrez l'onglet Files et cliquez sur serverconfig.json pour le modifier.
Modifiez les paramètres nécessaires (voir le tableau ci-dessous).
Enregistrez le fichier et démarrez le serveur.

Paramètres Principaux

Paramètre	Valeur Exemple	Description
`ServerName`	`"My Legion VS Server"`	Le nom affiché dans le navigateur de serveurs en jeu. Rendez-le descriptif pour que les joueurs puissent trouver votre serveur.
`WelcomeMessage`	`"Welcome to the server!"`	Message affiché aux joueurs lorsqu'ils rejoignent le serveur. Prend en charge le formatage de base.
`MaxClients`	`16`	Nombre maximum de joueurs simultanés. Doit correspondre à la variable de démarrage `MAX_CLIENTS`.
`Password`	`"mysecretpass"`	Mot de passe requis pour rejoindre le serveur. Laissez une chaîne vide (`""`) pour un serveur public.
`AllowPvP`	`true`	Définissez sur `true` pour activer le combat joueur contre joueur, ou `false` pour un serveur PvE uniquement.
`SpawnRadius`	`50`	Rayon (en blocs) autour du point d'apparition du monde où les nouveaux joueurs peuvent apparaître. Une valeur plus grande disperse davantage les joueurs à leur arrivée.
`MapSizeX`	`1024000`	Largeur du monde en blocs. La valeur par défaut crée un monde très grand. Réduire cette valeur limite la distance que les joueurs peuvent parcourir est-ouest.
`MapSizeZ`	`1024000`	Profondeur du monde en blocs. La valeur par défaut crée un monde très grand. Réduire cette valeur limite la distance que les joueurs peuvent parcourir nord-sud.
`WorldSeed`	`"myseed123"`	Graine utilisée pour la génération du monde. La même graine produit le même monde. Laissez une chaîne vide pour une graine aléatoire.

Un exemple minimal des paramètres principaux dans serverconfig.json :

{
  "ServerName": "My Legion VS Server",
  "WelcomeMessage": "Welcome! Enjoy your stay.",
  "MaxClients": 16,
  "Password": "",
  "AllowPvP": true,
  "SpawnRadius": 50,
  "MapSizeX": 1024000,
  "MapSizeZ": 1024000,
  "WorldSeed": ""
}

Le fichier doit être du JSON valide. Assurez-vous que toutes les chaînes sont entre guillemets doubles, que les booléens sont en minuscules (true/false), et qu'il n'y a pas de virgules en fin de liste après le dernier élément d'un objet ou d'un tableau. Si le serveur ne démarre pas après modification, vérifiez les erreurs de syntaxe JSON.

Configuration du Monde

Vintage Story génère son monde en fonction des paramètres dans serverconfig.json. La génération du monde ne se produit qu'au premier démarrage avec un monde donné -- modifier les paramètres de génération après la création du monde ne modifiera pas rétroactivement le terrain existant.

Paramètres de Génération du Monde

WorldSeed : Détermine la disposition du terrain, le placement des biomes et la distribution des ressources. Définissez une graine spécifique pour partager la même disposition de monde avec d'autres, ou laissez-la vide pour un monde généré aléatoirement.
MapSizeX / MapSizeZ : Contrôlent la zone jouable maximale. Des valeurs plus petites créent un monde plus contenu et peuvent réduire l'utilisation des ressources. Les joueurs qui atteignent le bord de la carte ne pourront pas aller plus loin dans cette direction.
WorldConfig : L'objet WorldConfig dans serverconfig.json vous permet d'affiner les paramètres de génération du monde tels que l'échelle des reliefs, les schémas climatiques et les caractéristiques géologiques. Ce sont des paramètres avancés -- les valeurs par défaut conviennent à la plupart des serveurs.

Les paramètres de génération du monde sont verrouillés après la création. Les paramètres comme WorldSeed, MapSizeX et MapSizeZ ne prennent effet que lors de la première génération du monde. Pour appliquer de nouveaux paramètres de génération, vous devez créer un nouveau monde (voir Gestion des Sauvegardes ci-dessous).

Choisir une Graine

La graine peut être n'importe quelle chaîne de texte ou nombre. Les joueurs de la communauté Vintage Story partagent des graines pour des dispositions de monde intéressantes. Si vous souhaitez un type de terrain ou un emplacement d'apparition spécifique, recherchez des graines recommandées sur les forums ou sites communautaires de Vintage Story.

Comment se Connecter

Les joueurs se connectent à votre serveur Vintage Story via le menu multijoueur en jeu.

Connexion Directe

Lancez Vintage Story et cliquez sur Multiplayer depuis le menu principal.
Cliquez sur Direct Connect.
Entrez l'adresse IP et le port de jeu de votre serveur au format :
```
your.server.ip:port
```
Vérifiez l'onglet Network dans GPanel pour connaître votre IP et port attribués.
Cliquez sur Connect. Si le serveur a un mot de passe, entrez-le lorsque demandé.

Navigateur de Serveurs

Lancez Vintage Story et cliquez sur Multiplayer depuis le menu principal.
Le navigateur de serveurs chargera une liste de serveurs publics. Utilisez la barre de recherche pour trouver votre serveur par nom (la valeur ServerName de serverconfig.json).
Cliquez sur votre serveur dans la liste et cliquez sur Join.

Le serveur n'apparaît pas dans le navigateur ? Le navigateur de serveurs peut prendre plusieurs minutes pour indexer un serveur récemment démarré. Utilisez la Connexion Directe pour un accès immédiat. Vérifiez également que vous n'avez pas défini de mot de passe -- les serveurs protégés par mot de passe peuvent ne pas apparaître dans le navigateur public selon les paramètres du serveur.

Gestion des Sauvegardes

Les données du monde Vintage Story sont stockées sur votre serveur et sauvegardées automatiquement pendant le jeu.

Emplacement des Données du Monde

Les fichiers de sauvegarde du monde sont stockés dans le répertoire data/ de votre serveur. Le chemin exact dépend du nom de votre monde. Vous pouvez accéder à ces fichiers via l'onglet Files de GPanel ou via SFTP.

Sauvegarder Votre Monde

Arrêtez le serveur pour garantir une sauvegarde propre (aucun fichier en cours d'écriture).
Connectez-vous à votre serveur via SFTP. Consultez Comment Transférer des Fichiers via SFTP pour les instructions de connexion.
Téléchargez l'intégralité du répertoire data/ sur votre machine locale.
Conservez la sauvegarde dans un emplacement sûr. Envisagez de garder plusieurs sauvegardes datées au cas où vous auriez besoin de revenir à un point spécifique.

Des sauvegardes régulières sont fortement recommandées. La corruption du monde, le grief accidentel ou les mises à jour de mods échouées peuvent tous entraîner une perte de données. Sauvegardez votre monde avant d'effectuer tout changement important tel que la mise à jour de la version du jeu, l'ajout ou la suppression de mods, ou la modification des paramètres du monde.

Réinitialiser le Monde

Pour démarrer un monde entièrement nouveau :

Arrêtez le serveur depuis l'onglet Console de GPanel.
Sauvegardez les données du monde existant si vous souhaitez les conserver (voir ci-dessus).
Naviguez vers le répertoire data/ dans le gestionnaire de fichiers de GPanel et supprimez les fichiers de sauvegarde du monde.
Optionnellement, mettez à jour le WorldSeed dans serverconfig.json pour générer une disposition de monde différente.
Démarrez le serveur. Un nouveau monde sera généré à partir de zéro en utilisant vos paramètres de configuration actuels.

La suppression des fichiers du monde est permanente. Une fois supprimé, le monde ne peut pas être récupéré sauf si vous disposez d'une sauvegarde. Téléchargez toujours une sauvegarde avant d'effectuer une réinitialisation du monde.

Besoin d'Aide ?

Si vous rencontrez un problème non couvert dans ce guide, ouvrez un ticket de support en incluant l'adresse IP de votre serveur, une description du problème et toute sortie console pertinente de GPanel.

Guide de Configuration du Serveur Vintage Story - Base de connaissances

Support

Catégories

Guide de Configuration du Serveur Vintage Story