We are your new 5-Star Hosting Company. At least according to ★ Trustpilot

Following along with a Windrose server? Deploy yours in minutes.

All servers come with a 24-Hour Trial, Free Backups, and 40Gbps DDoS Protection included!

Use code SAVE15 to take 15% OFF Your First Invoice with ChicagoServers! Limited Time!
Windrose guide

Windrose Server Settings Explained: ServerDescription and World Files

By the ChicagoServers team · Updated · 6 min read

Windrose splits its dedicated server settings across two JSON files. ServerDescription.json controls the server itself (name, password, invite code, player cap, world to load). Each world has its own WorldDescription.json that controls difficulty and gameplay multipliers.

Everything here is taken from the developers' official dedicated server guide (last updated May 18, 2026, game version 0.10.0.5.120). The game is in early access and the guide itself says parameter names and ranges may change, so recheck after big patches.

Quick answer
  • On ChicagoServers, Server name, Invite code, Join password and Region are fields on the Startup tab. The rest of ServerDescription.json is the Server description file on the Configs tab.
  • Server-level settings live in R5\ServerDescription.json: ServerName, Password, IsPasswordProtected, InviteCode, MaxPlayerCount, WorldIslandId and more.
  • If you edit the password in the file yourself, you must also set IsPasswordProtected to true. The simplest route is the Join password field on the Startup tab.
  • World difficulty lives in each world's WorldDescription.json: presets Easy, Medium, Hard, or a Custom set of multipliers.
  • Stop the server before editing. WorldDescription.json is edited on the Files tab. The game's R5WorldDescriptionUpdater.exe step cannot be run from the panel, so contact support for it.
  • Never edit PersistentServerId and never rename world folders.
On this page
  1. Where the Windrose server settings files are
  2. ServerDescription.json: every key
  3. Setting a password the right way
  4. World difficulty: presets in WorldDescription.json
  5. Custom world parameters and their ranges
  6. Applying a world change and switching worlds
  7. Frequently asked questions

Where the Windrose server settings files are

Both files are plain JSON, so any text editor works. On ChicagoServers, open ServerDescription.json on the Configs tab (Server description) and WorldDescription.json on the Files tab. Their locations in the official guide:

FileLocationControls
ServerDescription.jsonR5\ServerDescription.json under the server folder (Configs tab, Server description)The server: name, password, code, player cap, region, connection mode, active world
WorldDescription.jsonR5\Saved\SaveProfiles\Default\RocksDB_v2\<game version>\Worlds\<world id>\ (open it on the Files tab)One world: display name, difficulty preset, custom multipliers

Neither file exists until the server has run once. Click Start once, then Stop, then edit; the Configs tab tells you when a file does not exist yet. The save folder name (RocksDB_v2, previously RocksDB) changed with update 0.10.0.5.120, so if you find older guides pointing at a different folder, trust the folder that actually exists on your server.

ServerDescription.json: every key

This is the key list from the official guide's example file. The values shown are the guide's examples, not guaranteed defaults.

KeyWhat it doesExample / default
PersistentServerIdUnique server IDDo not edit
InviteCodeCode players enter to find the server. Letters and digits, 6+ characters, case-sensitived6221bb7
IsPasswordProtectedMust be true if a password is set, false if the password is emptyfalse
PasswordServer passwordempty
ServerNameDisplay name, useful for telling servers apartempty
WorldIslandIdID of the world to load; must match a world's IslandIda 32-character hex ID
MaxPlayerCountMaximum simultaneous players4 in the example
UserSelectedRegionSEA, CIS or EU (EU covers EU and NA). Empty means auto-select by latencyEU
P2pProxyAddressIP address used for listening socketsa LAN IP in the example
UseDirectConnectiontrue for direct IP play, false for ICE peer-to-peer (invite code)false
DirectConnectionServerAddressReserved for future use; currently unusedempty
DirectConnectionServerPortPort for direct connections; open TCP and UDP when direct connection is onPort for direct connections; on your own machine, open TCP and UDP when direct connection is on. On ChicagoServers the panel assigns the port (Startup tab, Network)
DirectConnectionProxyAddressSelects a network interface on the host0.0.0.0
AutoLoadLatestBackupIfHasBrokenOn launch, restores a broken save from backup when truetrue
CanLaunchMultipleServerInstancesPrevents more than one server instance on a PC, protecting against save corruptionfalse

On ChicagoServers, the Server name, Invite code, Join password and Region fields on the Startup tab cover ServerName, InviteCode, Password and UserSelectedRegion. Names, passwords, ports and player slots are written from the Startup tab and your plan at every start, so editing ServerName, Password, InviteCode, the port keys or MaxPlayerCount in the file does not stick. Everything else in the table can be edited on the Configs tab.

In the official example file these keys sit inside a ServerDescription_Persistent object, next to top-level Version and DeploymentId fields that the guide does not explain. Leave those alone.

The player cap deserves a note. The guide does not state a hard maximum for MaxPlayerCount. The Steam page says the game supports up to 8 players and that parties of 4 give the best experience, so treat 8 as the practical ceiling and 4 as the comfortable number, and check the current patch notes before going higher.

Setting a password the right way

On ChicagoServers, type the password into Join password on the Startup tab, click Save startup, then Restart. If you edit the file yourself (server stopped), a password needs two edits that must agree. Put the password in Password and set IsPasswordProtected to true. To remove the password, empty the field and set the flag back to false. The official guide is explicit that the flag must match whether the field is empty.

Relevant lines inside ServerDescription_Persistent
"IsPasswordProtected": true,
"Password": "your-password-here",
"ServerName": "Our Crew",
"MaxPlayerCount": 4,

The password is an extra requirement on top of the invite code, so players need both.

World difficulty: presets in WorldDescription.json

Each world file has a WorldPresetType of Easy, Medium or Hard, plus a WorldSettings block that is empty for presets and filled in for a Custom world. Open the file on the Files tab with the server stopped. The preset values in the guide:

PresetMob healthMob damageShip healthShip damageBoardingCombat difficulty
Easy0.70.60.70.60.7Easy
Medium1.01.01.01.01.0Normal
Hard1.51.251.51.251.5Hard

All three presets use Coop.StatsCorrectionModifier of 1 and Coop.ShipStatsCorrectionModifier of 0. The guide notes that custom values force the type to "Custom" on the next launch, so do not expect to nudge one number and still be labeled Medium.

Custom world parameters and their ranges

A Custom world stores its values as tags. The full tag is WDS.Parameter.<name>, and the JSON key is that tag wrapped in a small JSON string, as the guide's Medium example shows. Booleans go under BoolParameters, numbers under FloatParameters, and combat difficulty under TagParameters.

ParameterDefaultRange / notes
Coop.SharedQueststrueCo-op quests complete for all active players when one finishes them
EasyExplorefalseLegacy name; shown in-game as "Immersive exploration". Enabling it removes point-of-interest markers
MobHealthMultiplier1.00.2 to 5.0
MobDamageMultiplier1.00.2 to 5.0
ShipsHealthMultiplier1.00.4 to 5.0
ShipsDamageMultiplier1.00.2 to 2.5
BoardingDifficultyMultiplier1.00.2 to 5.0
Coop.StatsCorrectionModifier1.00.0 to 2.0; scales enemy health and posture loss with player count
Coop.ShipStatsCorrectionModifier0.00.0 to 2.0; scales enemy ship health with player count
CombatDifficultyNormalEasy, Normal or Hard (tag value, for example WDS.Parameter.CombatDifficulty.Normal)
Shape of one float entry, from the official example
"FloatParameters": {
  "{\"TagName\": \"WDS.Parameter.MobHealthMultiplier\"}": 1.5
}

Applying a world change and switching worlds

  1. Back up and stop the server

    On the Backups tab, choose World and settings and click Back up now. Then click Stop at the top of the server page so nothing is writing to the save.

  2. Edit WorldDescription.json

    Open the Files tab, go to the world's folder (the path is in the table above) and click WorldDescription.json to open it in the editor. Change the preset or the custom parameters, then click Save.

  3. Run the updater

    The official guide runs the command below against that world's file before the server starts. There is no panel button for it, so contact support to have it run, then click Start.

    R5WorldDescriptionUpdater.exe <path_to_world>\WorldDescription.json

To load a different world, change WorldIslandId in the Server description file on the Configs tab (server stopped) to that world's ID, click Save, then Restart. The ID must match the world's IslandId and its folder name. Do not rename world folders, because the save database relies on those IDs.

Frequently asked questions

Where is the Windrose server name set?

On ChicagoServers, in the Server name field on the Startup tab (Save startup, then Restart). In the file it is the ServerName key of ServerDescription.json, inside the ServerDescription_Persistent object, and the panel writes it from the Startup tab at every start. It is empty by default and only affects how the server is displayed, so it helps when you run several worlds.

Why is my Windrose server password not working?

Set it in the Join password field on the Startup tab. If you edit the file yourself, the password needs IsPasswordProtected set to true in addition to a value in Password, and if the flag and the field disagree the official guide says to fix the flag. Edit with the server stopped and restart afterwards.

How do I change Windrose difficulty on a dedicated server?

Stop the server, then edit the world's WorldDescription.json on the Files tab, setting WorldPresetType to Easy, Medium or Hard or filling in custom parameters. The official guide then runs R5WorldDescriptionUpdater.exe against that file; contact support to have that step run on ChicagoServers.

Can I change MaxPlayerCount above 4?

The key accepts a value you choose and the official guide gives no hard cap. On ChicagoServers player slots are set by the panel and your plan, so an edit in the file may not stick. The Steam page says up to 8 players are supported with 4 recommended, so stay within that unless a newer patch note says otherwise.

We are your new 5-Star Hosting Company. At least according to ★ Trustpilot

Following along with a Windrose server? Deploy yours in minutes.

All servers come with a 24-Hour Trial, Free Backups, and 40Gbps DDoS Protection included!

We offer quality support, a detailed knowledgebase, video tutorials on most topics, and even live support in case you prefer a live human.

Use code SAVE15 to take 15% OFF Your First Invoice with ChicagoServers! Limited Time!