WORLDCONFIGURATION

How to Configure Vintage Story Map Size

The default world is over a million blocks across in each direction — far more than any group actually needs. Here’s how to size it down, and why that’s usually a good idea.

⚠ Read this before you touch anything

World width, length and seed can only be set before a world is generated. The official wiki is clear that the world settings in serverconfig.json only take effect before a world is created, so changing them later does nothing to the world you already have. If you want a genuinely different size, you need to generate a fresh world, which means your current one is gone unless you back it up first. Still choosing where to run that new world? See our best Vintage Story server hosting comparison.

Also: never edit serverconfig.json while the server is running. The official wiki says the server must be stopped before you edit the file, and changes made while it’s live can be lost. Always stop the server first.


Setting a new map size

1
Back up your current world
If you want to keep what you’ve already built, back up the data/Saves folder now — regenerating a world with a new size deletes it. If you’re bringing this world elsewhere instead of resizing it, see our guide to uploading an existing world to a server instead — you don’t need to resize anything for that.
2
Stop the server
Required, per the warning above — the official wiki says to stop the server before editing serverconfig.json, and edits made while it runs can be lost.
3
Edit worldWidth and worldLength in serverconfig.json
Inside the WorldConfig section, WorldConfiguration is null by default. Replace it with an object that holds both values in blocks (the seed is a separate Seed entry in WorldConfig, not part of WorldConfiguration):
“WorldConfig”: {
  “Seed”: null,
  …
  “WorldConfiguration”: {
    “worldWidth”: “100000”,
    “worldLength”: “100000”
  },
  …
}
serverconfig.json also has separate top-level MapSizeX and MapSizeZ entries (default 1,024,000 each), and some host panels show map size under those names. If you edit the file by hand, set worldWidth/worldLength as above and give MapSizeX/MapSizeZ the same values so the two never disagree. Leave Seed as null for a random world, or set your own value to pick a seed. The wiki notes a seed does not guarantee exactly the same world every time.
4
Remove the old world file and start the server
With your backup safely stored elsewhere, move the old .vcdbs file out of data/Saves (or point SaveFileLocation at a new file name) and start the server. When the file it points to doesn’t exist, the server creates a fresh world there using your new size.
One more option: if the server hasn’t generated a world yet at all, you can also set these values with the /worldconfig worldWidth [number] and /worldconfig worldLength [number] commands, which the wiki lists as available only during the world create stage, rather than editing the file directly.

Smaller than the default, almost always

The default 1,024,000 × 1,024,000 blocks is enormous — designed to never realistically be fully explored. For a normal group, a smaller world isn’t a compromise, it’s usually the better choice. Terrain is only generated where players actually go, so the size limit doesn’t change day-to-day RAM use, but it caps how far people can spread out and how much terrain, and save file, can ever pile up. Day-to-day load comes from the chunks loaded around players, which is covered in our server settings guide — a smaller world and a sensible MaxChunkRadius work together, not separately.

One thing to check if you shrink the world a lot: climate bands are set by polarEquatorDistance, the distance from pole to equator (100,000 blocks in the Standard preset). On a 25,000-block world players only ever see a narrow slice of climates, so lower polarEquatorDistance too if you want hot and cold regions on a small map. Like the world size, it can only be set before the world is created.

Group size Suggested world size Why
2–4 players25,000 × 25,000Plenty of room for a small group
5–10 players50,000 × 50,000Space to spread bases out comfortably
Larger community100,000 × 100,000Still a small fraction of the default, but genuinely vast in practice
Default (not recommended)1,024,000 × 1,024,000Far more than almost any server will use

Vintage Story map size — common questions

No. World width and length only apply when a world is first created. Changing them afterward does nothing to the existing world, so a genuinely different size requires a fresh world. Back up first if you want to keep the current one.
Not directly. Terrain is only generated where players go, so RAM and CPU depend mostly on how many players are online and how many chunks are loaded around them. A smaller world keeps players closer together and caps how much terrain and save data can ever build up. It’s not a substitute for the settings in our server settings guide, but it complements them.
Usually because it was edited while the server was still running, and the official wiki says to stop the server before editing the file. If it was stopped, check that the world already existed: world settings in serverconfig.json only apply when a new world is created. Stop the server, make your edits, then start it again.
Both describe the size of a new world. MapSizeX and MapSizeZ are top-level entries in serverconfig.json (default 1,024,000), while worldWidth and worldLength sit in WorldConfig → WorldConfiguration. If your panel only offers MapSizeX/MapSizeZ, set those. If you edit the file yourself, set worldWidth/worldLength and give MapSizeX/MapSizeZ the same values. Either way it only affects a world that hasn’t been created yet.
No — an existing world keeps whatever size it was generated with. This guide is only relevant if you’re generating a brand new world. See our guide to uploading an existing world if you’re bringing one across instead.

Similar Posts