How to Configure Your Windrose Server

Complete guide to ServerDescription.json and WorldDescription.json — server name, invite code, password, player limit, world difficulty, and multipliers.

Windrose uses two config files: ServerDescription.json for how players find and connect to your server, and WorldDescription.json for per-world gameplay settings.

⚠️ Always stop your server before editing config files. The server may automatically overwrite changes if it detects an issue while running.

File Locations

ServerDescription.json

WorldDescription.json

Editing Config Files

Stop your server from the Dashboard.

In the panel sidebar, click File Manager.

Navigate to R5/Saved/SaveProfiles/Default/ and open ServerDescription.json.

Make your changes, then click Save Content.

Start your server. Changes take effect on the next startup.

ServerDescription.json

This file controls how players find and connect to your server.

{
  "Version": 1,
  "ServerDescription_Persistent": {
    "PersistentServerId": "1B80182E460F727CEA080C8EEBB1EA0A",
    "InviteCode": "d6221bb7",
    "IsPasswordProtected": false,
    "Password": "",
    "Note": "",
    "WorldIslandId": "DB57768A8A7746899683D0EEE91F97BF",
    "MaxPlayerCount": 10,
    "P2pProxyAddress": "127.0.0.1"
  }
}

Setting	Description
`PersistentServerId`	Unique server ID — do not edit, auto-generated by the server
`InviteCode`	The code players use to join. Min 6 characters, case-sensitive. Allowed: `0-9`, `a-z`, `A-Z`
`IsPasswordProtected`	`true` to require a password, `false` for public
`Password`	The join password — only used when `IsPasswordProtected` is `true`
`Note`	Optional server description, shown to players with similar invite codes
`WorldIslandId`	The active world ID — must match a `WorldDescription.json`'s `IslandId`
`MaxPlayerCount`	Maximum simultaneous players (default `10`)
`P2pProxyAddress`	Set to your server's IP address

WorldDescription.json

Each world has its own WorldDescription.json at:

R5\Saved\SaveProfiles\Default\RocksDB\<game_version>\Worlds\<world_id>\WorldDescription.json

Difficulty Presets

Set WorldPresetType to one of:

Preset	Description
`Easy`	Lower enemy health and damage, easier ship combat and boarding
`Medium`	Balanced defaults — the standard Windrose experience
`Hard`	Higher enemy health and damage, tougher encounters

If any values are present in WorldSettings, the preset automatically changes to "Custom" on next server launch.

Custom World Settings

Fine-tune individual multipliers by adding them to the WorldSettings block:

Parameter	Description	Default	Range
`WDS.Parameter.Coop.SharedQuests`	Co-op quests auto-complete for all players when one finishes	`true`	`true` / `false`
`WDS.Parameter.EasyExplore`	Disables map markers for POIs (Immersive Exploration — makes exploration harder)	`false`	`true` / `false`
`WDS.Parameter.MobHealthMultiplier`	Enemy health multiplier	`1.0`	`0.2 – 5.0`
`WDS.Parameter.MobDamageMultiplier`	Enemy damage multiplier	`1.0`	`0.2 – 5.0`
`WDS.Parameter.ShipsHealthMultiplier`	Enemy ship health multiplier	`1.0`	`0.4 – 5.0`
`WDS.Parameter.ShipsDamageMultiplier`	Enemy ship damage multiplier	`1.0`	`0.2 – 2.5`
`WDS.Parameter.BoardingDifficultyMultiplier`	Sailors needed to win a boarding action	`1.0`	`0.2 – 5.0`
`WDS.Parameter.Coop.StatsCorrectionModifier`	Scales enemy health/posture by player count	`1.0`	`0.0 – 2.0`
`WDS.Parameter.Coop.ShipStatsCorrectionModifier`	Scales enemy ship health by player count	`0.0`	`0.0 – 2.0`
`WDS.Parameter.CombatDifficulty`	Boss and enemy aggression level	`Normal`	`Easy`, `Normal`, `Hard`

Custom WorldDescription.json Example

{
  "Version": 1,
  "WorldDescription": {
    "IslandId": "DB57768A8A7746899683D0EEE91F97BF",
    "WorldName": "My Server",
    "CreationTime": 6.3905278455349005e+17,
    "WorldPresetType": "Custom",
    "WorldSettings": {
      "BoolParameters": {
        "{\"TagName\": \"WDS.Parameter.Coop.SharedQuests\"}": true,
        "{\"TagName\": \"WDS.Parameter.EasyExplore\"}": false
      },
      "FloatParameters": {
        "{\"TagName\": \"WDS.Parameter.MobHealthMultiplier\"}": 1.5,
        "{\"TagName\": \"WDS.Parameter.MobDamageMultiplier\"}": 1.2,
        "{\"TagName\": \"WDS.Parameter.ShipsHealthMultiplier\"}": 1.0,
        "{\"TagName\": \"WDS.Parameter.ShipsDamageMultiplier\"}": 1.0,
        "{\"TagName\": \"WDS.Parameter.BoardingDifficultyMultiplier\"}": 1.0,
        "{\"TagName\": \"WDS.Parameter.Coop.StatsCorrectionModifier\"}": 1.0,
        "{\"TagName\": \"WDS.Parameter.Coop.ShipStatsCorrectionModifier\"}": 0.5
      },
      "TagParameters": {
        "{\"TagName\": \"WDS.Parameter.CombatDifficulty\"}": {
          "TagName": "WDS.Parameter.CombatDifficulty.Hard"
        }
      }
    }
  }
}

Managing Multiple Worlds

You can run multiple worlds on one server and switch between them:

Create a new folder under R5/Saved/SaveProfiles/Default/RocksDB/<version>/Worlds/
Add a WorldDescription.json with a unique IslandId matching the folder name
In ServerDescription.json, set WorldIslandId to the new world's ID
Restart your server

How to Configure Your Windrose Server

On this page