Skip to content

How to Change the World Settings on Your Windrose Server

World settings are stored in the WorldDescription.json file inside your server's world folder. You can set difficulty via a preset (Easy, Medium, Hard) or via custom values (Custom).

Recommended

The easiest way is to set up the world in-game and copy the file to your server — see Configure settings in-game. This way you don't have to write the verbose JSON format by hand.

Configure settings in-game and transfer

The easiest way: create a world in Windrose with your desired settings and copy the finished file to your server.

  1. Create world in-game
    Launch Windrose and create a new world with the desired settings (preset or custom).

  2. Find the local world file
    Open the folder of your world on your PC:

    %LOCALAPPDATA%\R5\Saved\SaveProfiles\Default\RocksDB_v2\<GameVersion>\Worlds\<WorldID>\
    %LOCALAPPDATA%\R5\Saved\SaveProfiles\Default\RocksDB_v2\<GameVersion>\Worlds\<WorldID>\
  3. Stop the server
    Stop your server via the dashboard.

  4. Connect via SFTP
    Connect to your server via SFTP.

  5. Copy WorldDescription.json
    Copy your local WorldDescription.json into your server's world folder:

    /R5/Saved/SaveProfiles/Default/RocksDB_v2/<GameVersion>/Worlds/<WorldID>/WorldDescription.json
    /R5/Saved/SaveProfiles/Default/RocksDB_v2/<GameVersion>/Worlds/<WorldID>/WorldDescription.json
  6. Adjust the island ID
    Set the island ID in the dashboard to the value of the copied world so your server loads it.

  7. Start the server
    Start your server.

Edit the file directly on the server

If you prefer editing the file manually:

  1. Stop the server
    Stop your server via the dashboard.

  2. Connect via SFTP
    Connect to your server via SFTP.

  3. Open WorldDescription.json
    Open the file inside the world folder:

    /R5/Saved/SaveProfiles/Default/RocksDB_v2/<GameVersion>/Worlds/<WorldID>/WorldDescription.json
    /R5/Saved/SaveProfiles/Default/RocksDB_v2/<GameVersion>/Worlds/<WorldID>/WorldDescription.json
  4. Adjust values
    Adjust WorldPresetType and/or the individual WorldSettings parameters (see tables below).

  5. Start the server
    Save the file and start your server.

Note

You don't have to set WorldPresetType to Custom manually. As soon as you enter custom values in WorldSettings and restart the server, the server automatically switches WorldPresetType to Custom on the next launch.

General fields

FieldDescriptionValues
IslandIdUnique ID of the world — must match the folder name and the value in WorldSettings.jsonAlphanumeric string
WorldNameDisplayed name of the worldAny text
WorldPresetTypeDifficulty presetEasy, Medium, Hard, Custom

WorldSettings parameters (only for Custom)

Warning

WorldSettings are only evaluated if WorldPresetType is set to Custom. For the presets Easy, Medium and Hard, WorldSettings should stay empty — the server uses the preset values.

Bool parameters

ParameterDescriptionDefault
Coop.SharedQuestsQuests are automatically completed for all active co-op players when one player finishes themtrue
EasyExploreKnown in-game as "Immersive Exploration". When enabled, point-of-interest markers are hidden — exploration becomes harder. The parameter name is misleading.false

Float parameters (multipliers)

ParameterDescriptionDefaultRange
MobHealthMultiplierEnemy health1.00.25.0
MobDamageMultiplierEnemy damage1.00.25.0
ShipsHealthMultiplierEnemy ship health1.00.45.0
ShipsDamageMultiplierEnemy ship damage1.00.22.5
BoardingDifficultyMultiplierNumber of enemies to defeat during boarding1.00.25.0
Coop.StatsCorrectionModifierScales enemy health and posture loss with the player count1.00.02.0
Coop.ShipStatsCorrectionModifierScales enemy ship health with the player count0.00.02.0

Tag parameters

ParameterDescriptionDefaultValues
CombatDifficultyDifficulty of bosses and overall enemy aggressivenessNormalEasy, Normal, Hard

Example: WorldDescription.json with Custom preset

Parameters are stored in the file not as plain names, but as TagName-style keys. Here is what a full WorldDescription.json with a custom preset looks like:

json
{
    "Version": 1,
    "WorldDescription":
    {
        "islandId": "E24A22C9C8D3448951AFD002162576D5",
        "WorldName": "My World",
        "CreationTime": 6.3910902400911002e+17,
        "WorldPresetType": "Custom",
        "WorldSettings":
        {
            "BoolParameters":
            {
                "{\"TagName\": \"WDS.Parameter.Coop.SharedQuests\"}": true,
                "{\"TagName\": \"WDS.Parameter.EasyExplore\"}": false
            },
            "FloatParameters":
            {
                "{\"TagName\": \"WDS.Parameter.MobHealthMultiplier\"}": 1.0,
                "{\"TagName\": \"WDS.Parameter.MobDamageMultiplier\"}": 1.0,
                "{\"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.0
            },
            "TagParameters":
            {
                "{\"TagName\": \"WDS.Parameter.CombatDifficulty\"}":
                {
                    "TagName": "WDS.Parameter.CombatDifficulty.Normal"
                }
            }
        }
    }
}
{
    "Version": 1,
    "WorldDescription":
    {
        "islandId": "E24A22C9C8D3448951AFD002162576D5",
        "WorldName": "My World",
        "CreationTime": 6.3910902400911002e+17,
        "WorldPresetType": "Custom",
        "WorldSettings":
        {
            "BoolParameters":
            {
                "{\"TagName\": \"WDS.Parameter.Coop.SharedQuests\"}": true,
                "{\"TagName\": \"WDS.Parameter.EasyExplore\"}": false
            },
            "FloatParameters":
            {
                "{\"TagName\": \"WDS.Parameter.MobHealthMultiplier\"}": 1.0,
                "{\"TagName\": \"WDS.Parameter.MobDamageMultiplier\"}": 1.0,
                "{\"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.0
            },
            "TagParameters":
            {
                "{\"TagName\": \"WDS.Parameter.CombatDifficulty\"}":
                {
                    "TagName": "WDS.Parameter.CombatDifficulty.Normal"
                }
            }
        }
    }
}

Warning

Do not change IslandId — the value must match the folder name and the IslandId in WorldSettings.json. To load a different world, see Set Island ID.