Configurer son serveur Windrose : ServerDescription.json et WorldDescription.json expliqués
Vous venez de lancer votre serveur Windrose et voulez personnaliser la difficulté, le mot de passe, les multiplicateurs de combat ou le nombre de joueurs ? Toute la configuration se joue dans deux fichiers JSON : ServerDescription.json et WorldDescription.json.
Ce guide détaille chaque champ, ses valeurs autorisées et l’impact gameplay associé. Les infos sont issues de la documentation officielle Windrose.
Si vous n’avez pas encore de serveur, commencez par notre guide complet pour héberger un serveur Windrose.
🚀 Panel pro inclus
Édition JSON simplifiée via File Manager
Notre offre hébergeur Windrose pas cher à 12,90 €/mois inclut un panel Pterodactyl complet : éditeur de fichiers en ligne, sauvegardes auto, redémarrages programmés et accès SFTP — fini les transferts manuels.
⚠️ Règle d’or : toujours arrêter le serveur avant d’éditer ces fichiers, sinon vos modifications peuvent être écrasées à l’arrêt.
Où se trouvent les fichiers de configuration ?
ServerDescription.json
- Emplacement : à la racine du dossier serveur
- Accès HebergTonServ : Panel Pterodactyl → onglet File Manager → racine
WorldDescription.json
- Emplacement :
R5/Saved/SaveProfiles/Default/RocksDB/<version>/Worlds/<world_id>/ - Un fichier par monde : chaque monde créé a son propre
WorldDescription.json
Sur HebergTonServ, ouvrez le File Manager depuis le panel, naviguez dans le dossier, cliquez sur le fichier pour l’éditer dans le navigateur, puis Save Content et Restart le serveur depuis la page Console.
ServerDescription.json : tous les champs
Ce fichier contient les paramètres globaux du serveur (identité, accès, monde actif).
| Champ | Type | Description | Recommandation |
|---|---|---|---|
PersistentServerId | string | Identifiant unique généré automatiquement | Ne jamais modifier |
InviteCode | string | Code d’invitation que les joueurs saisissent pour rejoindre | 6+ caractères, a-z/A-Z/0-9, sensible à la casse |
IsPasswordProtected | bool | Active la protection par mot de passe | true pour serveur privé |
Password | string | Mot de passe d’accès (si protégé) | 12+ caractères aléatoires |
ServerName | string | Nom affiché dans la liste serveur | Unique et identifiable |
WorldIslandId | string | ID du monde chargé au démarrage | Doit correspondre au dossier Worlds/<id>/ |
MaxPlayerCount | int | Nombre maximum de joueurs | 4 recommandé (max technique 10) |
P2pProxyAddress | string | Adresse socket d’écoute | Selon votre infra, laisser par défaut chez un hébergeur |
Exemple concret
{
"PersistentServerId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"InviteCode": "PirateCrew2026",
"IsPasswordProtected": true,
"Password": "MotDePasseLong&Fort!42",
"ServerName": "Le Repaire des Corsaires",
"WorldIslandId": "default-world-001",
"MaxPlayerCount": 4
}Bonnes pratiques : Gardez un
InviteCodemémorisable pour vos joueurs, et unPasswordaléatoire fort siIsPasswordProtectedesttrue.
WorldDescription.json : structure générale
Ce fichier contrôle la difficulté et le gameplay du monde.
| Champ | Type | Description |
|---|---|---|
IslandId | string | ID unique du monde (doit matcher le nom du dossier) |
WorldName | string | Nom d’affichage du monde |
CreationTime | string | Horodatage de création |
WorldPresetType | string | "Easy", "Medium", "Hard" ou "Custom" |
WorldSettings | object | Paramètres avancés (utilisé si WorldPresetType: "Custom") |
Les 3 presets de difficulté
| Preset | Style de jeu | Public |
|---|---|---|
Easy | Ennemis affaiblis, exploration guidée | Débutants, RP tranquille |
Medium | Équilibre vanilla | Majorité des joueurs |
Hard | Mobs boostés, navires tenaces | Vétérans, hardcore |
Custom | Multiplicateurs modifiables à la main | Serveurs communautaires sur-mesure |
Multiplicateurs personnalisés (mode Custom)
Quand WorldPresetType vaut "Custom", vous pouvez régler précisément chaque paramètre dans WorldSettings :
Combat et ennemis
| Paramètre | Plage | Effet |
|---|---|---|
MobHealthMultiplier | 0.2 – 5.0 | Santé des mobs (1.0 = vanilla) |
MobDamageMultiplier | 0.2 – 5.0 | Dégâts infligés par les mobs |
CombatDifficulty | Tag | WDS.Parameter.CombatDifficulty.Easy/Normal/Hard |
Navires et abordages
| Paramètre | Plage | Effet |
|---|---|---|
ShipHealthMultiplier | 0.4 – 5.0 | Résistance des navires IA |
ShipDamageMultiplier | 0.2 – 2.5 | Dégâts des canons IA |
BoardingDifficultyMultiplier | 0.2 – 5.0 | Nombre de marins à vaincre lors d’un abordage |
Scaling multijoueur (très important)
| Paramètre | Plage | Effet |
|---|---|---|
Coop_StatsCorrectionModifier | 0.0 – 2.0 | Ajuste dynamiquement la santé des ennemis selon le nombre de joueurs |
Coop_ShipStatsCorrectionModifier | 0.0 – 2.0 | Même logique pour les navires IA |
Astuce serveur coop : sur un serveur 4 joueurs, laissez
Coop_StatsCorrectionModifierà1.0pour un scaling équilibré. Montez-le à1.5pour un challenge renforcé.
Exploration et quêtes
| Paramètre | Valeurs | Effet |
|---|---|---|
CoopQuests | true / false | Synchronise la progression des quêtes entre joueurs |
EasyExplore | true / false | true = masque les marqueurs de carte (exploration plus dure) |
Configurations types selon le style de serveur
Serveur “découverte” (débutants, RP cool)
{
"WorldPresetType": "Custom",
"WorldSettings": {
"MobHealthMultiplier": 0.7,
"MobDamageMultiplier": 0.7,
"ShipHealthMultiplier": 0.8,
"CoopQuests": true,
"EasyExplore": false
}
}Serveur “équilibré 4 joueurs”
{
"WorldPresetType": "Medium"
}Serveur “hardcore pirate”
{
"WorldPresetType": "Custom",
"WorldSettings": {
"MobHealthMultiplier": 2.5,
"MobDamageMultiplier": 1.8,
"ShipHealthMultiplier": 2.0,
"ShipDamageMultiplier": 1.5,
"BoardingDifficultyMultiplier": 2.5,
"EasyExplore": true,
"Coop_StatsCorrectionModifier": 1.5
}
}Workflow : modifier une configuration sans casser le monde
- Arrêtez le serveur depuis la page Console du panel Pterodactyl
- Ouvrez le File Manager
- Naviguez jusqu’au fichier à éditer
- Cliquez sur le fichier pour l’ouvrir dans l’éditeur intégré
- Modifiez les valeurs souhaitées (respectez la syntaxe JSON : virgules, guillemets, accolades)
- Cliquez sur Save Content
- Redémarrez le serveur depuis la Console
Tip anti-erreur : avant chaque modification, copiez le fichier original en
.bakvia le File Manager. En cas de JSON invalide, le serveur refuse de démarrer.
Valider votre JSON
Un simple oubli de virgule peut empêcher le démarrage. Avant de sauvegarder, copiez-collez votre JSON dans un validateur comme jsonlint.com pour vérifier la syntaxe.
Erreurs fréquentes :
- Virgule en trop après le dernier champ (interdit en JSON strict)
- Guillemets simples au lieu de doubles (
'→") - Valeur booléenne avec majuscule (
Trueau lieu detrue)
Et les commandes admin in-game ?
Windrose étant en Early Access, les outils admin in-game (commandes console, kick, ban, téléportation) sont encore très limités et évoluent à chaque mise à jour majeure. Aujourd’hui, la modération passe essentiellement par :
- La configuration de
ServerDescription.json(invite code, mot de passe) - Les arrêts/redémarrages depuis le panel Pterodactyl
- Les sauvegardes/restaurations via l’onglet Backups
Pour sécuriser votre serveur sans commandes admin, lisez : Sécuriser son serveur Windrose : invite code, mot de passe et protection.
FAQ Configuration Windrose
Puis-je modifier WorldIslandId pour changer de monde ?
Oui, à condition que le nouveau dossier existe dans Worlds/ avec un WorldDescription.json valide dont IslandId correspond.
Faut-il redémarrer après chaque modification ?
Oui, les fichiers JSON ne sont lus qu’au démarrage du serveur. Aucun reload à chaud.
Peut-on changer le preset de difficulté en cours de partie ?
Oui, mais cela s’applique au monde entier au prochain redémarrage. Les créatures déjà spawnées gardent leurs stats actuelles jusqu’à respawn.
Pourquoi les devs recommandent max 4 joueurs ?
Au-delà, les performances serveur et la synchronisation se dégradent. Le serveur supporte jusqu’à 10 joueurs mais ce n’est pas optimisé.
Où est le SteamID des joueurs autorisés ?
Il n’y a pas de système de whitelist par SteamID dans Windrose actuellement. La protection se fait via InviteCode + Password.
Conclusion
Bien configurer ServerDescription.json et WorldDescription.json vous permet de créer l’expérience pirate exacte que vous imaginez — du serveur RP détendu au serveur hardcore. Pour passer à la sécurité maintenant, enchaînez sur Sécuriser son serveur Windrose.
Pour un serveur Windrose pré-configuré avec panel intuitif, File Manager JSON-ready et support 24/7, HebergTonServ est l’hébergeur Windrose de référence en France dès 12,90€/mois.



