How To Configure World Settings On Your Vintage Story Server

Vintage Story offers an incredible amount of customization! Whether you want to make the survival experience more forgiving by keeping your inventory on death, or make it brutally realistic with harsher winters and faster food spoilage, you have total control.

Instead of digging through complicated files, Vintage Story allows you to change most of your world settings dynamically using built-in commands. Let us get your server dialed in perfectly for your community!

Step 1: Using World Config Commands

To change an existing setting, you will use the /worldconfig command followed by the name of the setting and the value you want to assign to it. Note that all commands are strictly case-sensitive!

The standard syntax looks like this: /worldconfig [name] [value]

Here are a few of the most popular and useful configurations you can tweak right away:

• Keep Inventory on Death: /worldconfig deathPunishment keep (Change "keep" to "drop" to revert it)
• Player Base Health: /worldconfig playerHealthPoints 15 (Change 15 to any number you prefer)
• Tool Durability: /worldconfig toolDurability 2 (A value of 2 means tools last twice as long!)
• Creature Hostility: /worldconfig creatureHostility passive (Options: aggressive, passive, off)
• Temporal Storms: /worldconfig temporalStorms rare (Options: off, veryrare, rare, sometimes, often, veryoften)
• Cave-ins: /worldconfig caveIns on (Options: on, off)

Step 2: Checking Current Settings

If you are not sure what a setting is currently set to, you can easily check it without making any changes. Just type the command without a value at the end!

For example, typing /worldconfig seasons will output whether the passing of seasons is currently enabled or stuck on a specific time of year.

Step 3: Creating New Configuration Values

There are some advanced settings that aren't included in the default world generation. To change these, you have to use a slightly different command to "create" the variable first. This uses the /worldconfigcreate command, followed by the data type, name, and value.

The syntax looks like this: /worldconfigcreate [datatype] [name] [value]

Here are a few handy examples:

• Disable Death Messages: /worldconfigcreate bool disableDeathMessages true
• Change Crop Growth Rate: /worldconfigcreate double cropGrowthRateMul 2 (Makes crops grow twice as fast)
• Hide Other Players on Map: /worldconfigcreate bool mapHideOtherPlayers true

Advanced: Adjusting World Generation

While the commands above work for active gameplay, world generation settings (like land-to-water ratios) are "baked in" when the map is first created. To change these, you must modify your serverconfig.json file.

1. Log into your MintServers panel and click the Stop button to safely shut down your server.
2. Navigate to the Files tab on the left-hand sidebar.
3. Locate your configuration file using the exact path below:

4. Locate the "WorldConfig" section and adjust the "landcover" value:
   • 1.0: Standard (Large continents)
   • 0.7: Large islands and more inland seas
   • 0.4: Archipelago style (Mostly water with scattered islands)
   • 0.1: Survival Challenge (Tiny islands, vast water distances)
5. Ensure "oceans": "true" is set if you want water generation.

To generate your new world, either delete your existing .vworld file found in VintagestoryData/Saves, or change the "WorldName" value in your serverconfig.json to start a fresh save. Start your server, and a new map will be generated using your custom settings!

Applying Changes

For most configuration commands, the changes apply immediately. However, some deep structural changes might require a quick server restart. Just head to your Console tab and click Restart to be safe.

For a complete list of every available configuration command, we highly recommend checking out the official Vintage Story World Configuration Wiki.