Windrose JSON Config Validator

ServerDescription.json Field Reference

One ServerDescription.json lives in the server root and tells the Windrose dedicated server which world to load, what slot count to expose, and how to accept connections.

WorldDescription.json Field Reference

Each world has its own WorldDescription.json inside its world folder. The islandId is the primary key — it must exactly match the world folder name and the WorldIslandId in ServerDescription.

Common Windrose Config Mistakes

• IslandId mismatch between ServerDescription.WorldIslandId and WorldDescription.islandId — server boots but the world never loads. The most common failure mode after copying save folders between servers.
• MaxPlayerCount over 10 — the engine silently caps to 10. Setting 16 or 20 does not increase slot count.
• Invalid UserSelectedRegion — anything other than "SEA", "CIS", "EU", or the empty string is ignored. Typos like "US" or "NA" fall back to auto-select.
• Non-alphanumeric InviteCode — dashes, spaces, and punctuation will not be accepted by the client UI, even if the server writes them.
• WorldPresetType label doesn't match settings — if you set multipliers but leave WorldPresetType as "Easy", the server will rewrite it to "Custom" on next boot. Harmless but often confusing.
• Multiplier out of range — values outside the documented ranges may still load but often produce broken scaling (e.g. ShipDamageMultiplier above 2.5 is untested territory).
• Privileged DirectConnectionServerPort — ports below 1024 require elevated privileges on Linux and will fail to bind. Stick to 7777 or another unprivileged port.
• Editing PersistentServerId — this value is tied to the server's registration. Do not hand-edit it, or you will lose listing status.

File Locations

Frequently Asked Questions