Zum Hauptinhalt springen

Windrose: World Modifiers

The ideal products for this guide

Get started right away — order the matching product and follow this guide step by step.

Introduction

Windrose custom world modifiers let you adjust combat, naval combat, exploration, quests, and co-op scaling in detail. In this guide, you will learn how to edit the WorldDescription.json file, understand each parameter, and apply custom settings to your Windrose gameserver.

Preparation

Before you begin, make sure you have the following:

  • An active Windrose gameserver at ZAP-Hosting
  • Access to the gameserver management
  • Your server stopped before editing files
  • Access to the Configs or File Manager area in the gameserver management
Configuration File Location

Custom world modifiers are stored in the WorldDescription.json file under the WorldSettings block.

Stop the Server First

You should always stop your server before editing WorldDescription.json. This helps prevent file corruption or overwritten changes during startup or autosave operations.

Understanding World Modifiers

Each custom setting is defined individually inside WorldDescription.json under WorldSettings. The game separates values by type:

  • float for numeric multipliers such as health or damage
  • bool for true or false options
  • tag for named difficulty values such as combat difficulty

This structure is important because each parameter must be placed in the correct section. If you place a float value in bool, or use an invalid tag, the setting may not work as expected.

Parameter Types

If you are unfamiliar with the term parameter, it simply means a configurable value used by the game. In this guide, each parameter controls one part of the world difficulty or gameplay behavior.

Open the World Configuration File

To apply custom world modifiers, you need to edit the correct world file.

  1. Stop your Windrose server in the gameserver management.
  2. Open the File Manager.
  3. Navigate to the following path:
R5/Saved/SaveProfiles/Default/RocksDB/<game_version>/Worlds/<world_id>/WorldDescription.json

Replace the placeholders as follows:

PlaceholderMeaning
[your_game_version]Your current Windrose game version folder
[your_world_id]The ID of the world you want to modify
Finding the Correct World

If you have multiple worlds, make sure you edit the WorldDescription.json file inside the correct [your_world_id] folder. Otherwise, your changes will affect a different save.

Edit the WorldSettings Block

Inside WorldDescription.json, locate the WorldSettings block. Add or adjust your custom values there.

Use the following structure:

"WorldSettings": {
"bool": {
"CoopQuests": true,
"EasyExplore": false
},
"float": {
"MobHealthMultiplier": 1.5,
"MobDamageMultiplier": 1.2,
"ShipHealthMultiplier": 1.0,
"ShipDamageMultiplier": 1.0,
"BoardingDifficultyMultiplier": 1.0,
"Coop_StatsCorrectionModifier": 1.0,
"Coop_ShipStatsCorrectionModifier": 0.5
},
"tag": {
"CombatDifficulty": {
"TagName": "WDS.Parameter.CombatDifficulty.Hard"
}
}
}

After saving the file, start your server again.

Preset Behavior

If you set any custom value manually, WorldPresetType automatically changes to Custom on the next server start. If you want to use a clean preset instead of custom values, you should use the appropriate preset configuration rather than mixing both methods.

Full Parameter Reference

The following tables provide a complete reference for every available custom world modifier.

Combat Parameters

ParameterSectionDefaultRangeEffect
MobHealthMultiplierfloat1.00.2 - 5.0Enemy health multiplier
MobDamageMultiplierfloat1.00.2 - 5.0Enemy damage multiplier
CombatDifficultytagNormalEasy, Normal, HardBoss aggression and encounter difficulty

CombatDifficulty must be written as a tag value, for example:

"tag": {
"CombatDifficulty": {
"TagName": "WDS.Parameter.CombatDifficulty.Hard"
}
}

Available values:

DifficultyTagName value
EasyWDS.Parameter.CombatDifficulty.Easy
NormalWDS.Parameter.CombatDifficulty.Normal
HardWDS.Parameter.CombatDifficulty.Hard
ParameterSectionDefaultRangeEffect
ShipHealthMultiplierfloat1.00.4 - 5.0Enemy ship health multiplier
ShipDamageMultiplierfloat1.00.2 - 2.5Enemy ship damage multiplier
BoardingDifficultyMultiplierfloat1.00.2 - 5.0Number of enemy sailors to defeat in a boarding action

These settings are useful if you want to make sea battles easier for smaller crews or much more demanding for experienced groups.

Co-Op Scaling Parameters

ParameterSectionDefaultRangeEffect
Coop_StatsCorrectionModifierfloat1.00.0 - 2.0Adjusts enemy health and posture loss based on player count
Coop_ShipStatsCorrectionModifierfloat0.00.0 - 2.0Adjusts enemy ship health based on player count

These values are especially useful for larger crews. They allow you to keep combat balanced as more players join the world.

Exploration Parameters

ParameterSectionDefaultEffect
EasyExploreboolfalseDisables map markers for points of interest
EasyExplore Naming

Despite the name, setting EasyExplore to true makes exploration harder because it disables map markers for points of interest. This is effectively an immersive exploration mode.

Quest Parameters

ParameterSectionDefaultEffect
CoopQuestsbooltrueWhen one player completes a co-op quest, it auto-completes for all other players who have it active

This setting is useful if you want to simplify group progression or require each player to complete objectives individually.

Multiplier Scale Reference

If you are unsure how a float value changes gameplay, use this quick scale reference.

ValueEffect
0.550% - noticeably easier
1.0100% - default or normal
2.0200% - noticeably harder
5.0500% - extremely difficult

This table is a practical parameters example for balancing your world. Lower values reduce difficulty, while higher values increase it significantly.

Start With Small Adjustments

If you are testing balance changes, increase or decrease one parameter at a time. This makes it easier to understand which setting caused the gameplay difference.

Example Configurations

The following examples can help you build your own custom setup.

Casual Crew

This setup lowers combat pressure, keeps quest sharing enabled, and makes boarding easier.

"float": {
"MobHealthMultiplier": 0.6,
"MobDamageMultiplier": 0.6,
"BoardingDifficultyMultiplier": 0.5
}

Hardcore Seas

This setup increases both land and naval difficulty, disables shared quest completion, and enables immersive exploration.

"bool": {
"CoopQuests": false,
"EasyExplore": true
},
"float": {
"MobHealthMultiplier": 2.0,
"MobDamageMultiplier": 1.5,
"ShipHealthMultiplier": 2.0,
"ShipDamageMultiplier": 1.5
}

Large Group Scaling

This setup is useful for larger groups, such as 8 players, where default scaling may feel too easy.

"float": {
"MobHealthMultiplier": 1.0,
"MobDamageMultiplier": 1.0,
"Coop_StatsCorrectionModifier": 2.0,
"Coop_ShipStatsCorrectionModifier": 2.0
}

Best Practices for Editing Values

Use Valid Ranges

Each float parameter only supports a defined range. Staying inside the documented range helps avoid unexpected behavior.

ParameterMinimumMaximum
MobHealthMultiplier0.25.0
MobDamageMultiplier0.25.0
ShipHealthMultiplier0.45.0
ShipDamageMultiplier0.22.5
BoardingDifficultyMultiplier0.25.0
Coop_StatsCorrectionModifier0.02.0
Coop_ShipStatsCorrectionModifier0.02.0
Invalid Values

If you use unsupported values, incorrect formatting, or place a parameter in the wrong section, the game may ignore the setting or fail to apply it correctly.

Keep JSON Formatting Correct

When editing WorldDescription.json, make sure that:

  • All keys remain in double quotes
  • Commas are placed correctly
  • Braces {} and brackets are closed properly
  • true and false are written in lowercase
  • Decimal values use a period, for example 1.5

A broken JSON file may prevent the world configuration from loading correctly.

Restart After Saving

After you finish editing:

  1. Save WorldDescription.json
  2. Start your server again
  3. Join the server and test the changes in gameplay

Some values are easiest to verify in combat, boarding, or co-op sessions rather than immediately at login.

Managing Configs in the Gameserver Management

You can manage Windrose configuration files directly in the ZAP-Hosting gameserver management under the available config and file options. This is the recommended way to edit WorldDescription.json if you do not want to use external tools.

If the exact config entry is not listed directly, use the File Manager and navigate manually to the world file path shown earlier in this guide.

Config Management

Depending on the current gameserver interface and your existing world setup, the exact file listing may vary. If a specific config entry is not visible, use the file path directly instead of assuming a missing feature.

Troubleshooting

Changes Do Not Apply

If your modifiers are not active after restarting, check the following:

  • You edited the correct WorldDescription.json
  • The server was stopped before editing
  • The JSON syntax is valid
  • Each parameter is in the correct section: float, bool, or tag
  • The server was fully restarted after saving

Difficulty Feels Unchanged

Some modifiers are more noticeable than others. For example:

  • MobHealthMultiplier is easiest to notice in regular combat
  • ShipHealthMultiplier is only noticeable during naval combat
  • Coop_StatsCorrectionModifier is most visible with multiple players
  • EasyExplore only affects exploration behavior and map markers

Preset Changed to Custom

This is expected behavior once you manually set custom values. The game automatically switches the world preset type to Custom on the next startup.

Conclusion

Congratulations, you have successfully configured Windrose world modifiers. For further questions or assistance, please don't hesitate to contact our support team, which is available daily to assist you!