Aller au contenu principal

Besoin d'un serveur performant pour vos projets ?

Découvrez nos offres

Configurer le serveur (ServerDescription.json)

Les réglages principaux d'un serveur Windrose se trouvent dans le fichier ServerDescription.json : nom du serveur, mot de passe, nombre maximum de joueurs, code d'invitation et monde chargé. Les réglages de gameplay (difficulté, multiplicateurs) sont, eux, propres à chaque monde : voir Paramètres du monde et difficulté.

Modifier le fichier en toute sécurité​

Arrêtez le serveur avant de modifier

Arrêtez toujours le serveur depuis la Console du panel avant d'éditer ServerDescription.json. Le serveur réécrit ce fichier à l'arrêt : une modification faite serveur allumé est écrasée dès qu'il s'arrête.

  1. Connectez-vous à votre Panel Game : game.yorkhost.fr
  2. Sélectionnez votre serveur et arrêtez-le
  3. Ouvrez l'onglet Files et éditez ServerDescription.json (à la racine du serveur ou dans le dossier R5/, selon la version)
  4. Modifiez uniquement les valeurs voulues, en respectant la syntaxe JSON
  5. Enregistrez, puis démarrez le serveur

Selon la version du serveur, les réglages sont soit à la racine du fichier, soit regroupés dans un objet ServerDescription_Persistent. Modifiez les clés là où elles se trouvent, sans déplacer de bloc. Exemple simplifié :

{
  "ServerDescription_Persistent": {
    "PersistentServerId": "…",
    "InviteCode": "Equipage42",
    "IsPasswordProtected": true,
    "Password": "MotDePasseSecret",
    "ServerName": "Le Pavillon Noir",
    "WorldIslandId": "…",
    "MaxPlayerCount": 8,
    "UserSelectedRegion": ""
  }
}
Gardez une copie et vérifiez la syntaxe

Téléchargez une copie de ServerDescription.json avant toute modification. Une virgule en trop ou un guillemet manquant rend le JSON invalide et empêche le serveur de démarrer. En cas de doute, vérifiez le fichier avec un validateur JSON en ligne.

Paramètres de l'onglet Startup​

Certaines valeurs peuvent aussi être exposées dans l'onglet Startup du panel. Si une modification du fichier semble ignorée, vérifiez si le même réglage n'y est pas défini.

Identité et accès​

CléRôle
ServerNameNom du serveur, pour le distinguer des autres
IsPasswordProtectedtrue pour exiger un mot de passe, false sinon
PasswordMot de passe demandé aux joueurs
MaxPlayerCountNombre maximum de joueurs connectés simultanément
InviteCodeCode d'invitation partagé avec les joueurs
UserSelectedRegionRégion de mise en relation (EU, SEA, CIS) ; vide = sélection automatique

Mot de passe​

Le mot de passe n'est appliqué que si IsPasswordProtected vaut true. Les deux champs doivent être cohérents :

"IsPasswordProtected": true,
"Password": "MotDePasseSecret",

Pour retirer le mot de passe, repassez IsPasswordProtected à false et videz Password.

Nombre de joueurs​

MaxPlayerCount accepte une valeur de 1 à 8 : le serveur dédié officiel est limité à 8 joueurs à ce jour, et cette limite peut évoluer pendant l'accès anticipé. Plus il y a de joueurs, plus le serveur consomme de RAM : restez cohérent avec votre offre (voir Choisir son offre).

Code d'invitation​

Le code est généré automatiquement au premier démarrage. Vous pouvez le remplacer par un code plus facile à retenir :

  • 6 caractères minimum
  • uniquement des chiffres et lettres (0-9, a-z, A-Z), sans espace ni caractère spécial
  • sensible à la casse : Equipage42 et equipage42 sont deux codes différents

Après un changement de code, communiquez le nouveau code à vos joueurs : l'ancien ne fonctionne plus.

Région​

UserSelectedRegion indique la région utilisée pour la mise en relation des joueurs. Laissée vide, elle est choisie automatiquement. Nos serveurs étant hébergés en France, EU est la valeur cohérente si vous souhaitez la fixer.

Réglages à ne pas modifier​

Certaines clés sont gérées par le serveur ou par YorkHost. Ne les modifiez pas :

CléPourquoi
PersistentServerIdIdentifiant unique du serveur, généré automatiquement. Le modifier peut rendre les sauvegardes inaccessibles
WorldIslandIdMonde chargé au démarrage. À modifier uniquement pour importer ou changer de monde
UseDirectConnection, DirectConnectionServerPort, DirectConnectionProxyAddress, P2pProxyAddressRéglages réseau du serveur
CanLaunchMultipleServerInstancesProtection contre le lancement de plusieurs instances sur les mêmes données
Ne touchez pas au réseau

Le serveur doit utiliser le port attribué par le panel (le port par défaut du jeu, 7777, n'est qu'indicatif). Modifier les réglages réseau à la main peut rendre le serveur injoignable. Si vous avez besoin de la connexion directe par IP, contactez le support. Voir Tous les ports sont-ils ouverts ?.

Administration et commandes​

À ce jour, Windrose n'intègre pas de système d'administration ni de commandes serveur : la console du serveur sert à lire les logs, pas à taper des commandes de jeu. La gestion se fait par les fichiers de configuration et par le panel :

BesoinSolution
Limiter l'accès au serveurMot de passe (IsPasswordProtected + Password) ou changement du code d'invitation
Changer la difficultéParamètres du monde
Sauvegarder le mondeOnglet Backups, voir Sauvegardes
Redémarrer régulièrementOnglet Schedules, voir redémarrage automatique
Donner l'accès au panel à un amiSous-utilisateurs

Des outils communautaires ajoutent des commandes d'administration, mais ils ne sont pas officiels et peuvent cesser de fonctionner à chaque mise à jour de l'accès anticipé.

Mods​

Nous installons le serveur dédié officiel, sans mods. Vous disposez toutefois d'un accès complet aux fichiers (gestionnaire de fichiers et SFTP) pour tester un mod compatible avec le serveur :

  • faites toujours une sauvegarde avant d'installer un mod
  • suivez les instructions de l'auteur du mod et vérifiez qu'il est prévu pour le serveur dédié
  • attendez-vous à ce qu'une mise à jour du jeu casse la compatibilité
Ne remplacez pas les fichiers du serveur

N'écrasez pas les exécutables et les fichiers du serveur par des fichiers copiés depuis votre installation du jeu. Si un mod demande de remplacer des binaires, contactez le support avant.

Voir aussi​