Adjusting World-Related Settings

Adjusting world-related config settings allows you to customize the in-game terrain and game rules.

World Config Settings are now in serverconfig.json automatically

You no longer need to manually paste the template on this page. The settings are generated automatically and can be found under the WorldConfiguration object in your serverconfig.json file. (Use CTRL+F and search for 'WorldConfiguration' in the file.)

These settings are created the first time the server starts, after which you can edit them directly in the config file. If you delete the config file, the server will regenerate it, including all available WorldConfiguration settings. If you still can't find the settings, follow the steps below.

Adjusting World-Related Settings (File Manager)

World settings are also able to be edited in the serverconfig.json file, which you can access in the server's File Manager under Quick Access, or by navigating directly to the file path at data/serverconfig.json. Once you're in the file, scroll down to the "WorldConfiguration" section. This is where world-related settings can be adjusted. Not all settings will be present in the file by default. If the setting(s) you wish to change aren't in the file, you can copy and paste them from Vintage Story's serverconfig.json template, which we have provided here. If the WorldConfiguration object in serverconfig.json is already populated with the settings, you don't need to paste the template.

Replace "WorldConfiguration": null, in serverconfig.json with the template below.

    "WorldConfiguration": {
      "gameMode": "survival",
      "startingClimate": "temperate",
      "spawnRadius": "50",
      "graceTimer": "0",
      "deathPunishment": "drop",
      "droppedItemsTimer": "600",
      "seasons": "enabled",
      "playerlives": "-1",
      "lungCapacity": "40000",
      "daysPerMonth": "9",
      "harshWinters": "true",
      "blockGravity": "sandgravel",
      "caveIns": "off",
      "allowUndergroundFarming": false,
      "noLiquidSourceTransport": false,
      "bodyTemperatureResistance": "0",
      "creatureHostility": "aggressive",
      "creatureStrength": "1",
      "creatureSwimSpeed": "2",
      "playerHealthPoints": "15",
      "playerHungerSpeed": "1",
      "playerHealthRegenSpeed": "1",
      "playerMoveSpeed": "1.5",
      "foodSpoilSpeed": "1",
      "saplingGrowthRate": "1",
      "toolDurability": "1",
      "toolMiningSpeed": "1",
      "propickNodeSearchRadius": "6",
      "microblockChiseling": "stonewood",
      "allowCoordinateHud": true,
      "allowMap": true,
      "colorAccurateWorldmap": false,
      "loreContent": true,
      "clutterObtainable": "ifrepaired",
      "lightningFires": false,
      "allowTimeswitch": false,
      "temporalStability": true,
      "temporalStorms": "sometimes",
      "tempstormDurationMul": "1",
      "temporalRifts": "visible",
      "temporalGearRespawnUses": "20",
      "temporalStormSleeping": "0",
      "worldClimate": "realistic",
      "landcover": "1",
      "oceanscale": "1",
      "upheavelCommonness": "0.3",
      "geologicActivity": "0.05",
      "landformScale": "1.0",
      "worldWidth": "1024000",
      "worldLength": "1024000",
      "worldEdge": "traversable",
      "polarEquatorDistance": "100000",
      "globalTemperature": "1",
      "globalPrecipitation": "1",
      "globalForestation": "0",
      "globalDepositSpawnRate": "1",
      "surfaceCopperDeposits": "0.12",
      "surfaceTinDeposits": "0.007",
      "snowAccum": "true",
      "allowLandClaiming": true,
      "classExclusiveRecipes": true,
      "auctionHouse": true
    },

Adjusting World-Related Settings (Admin Commands)

You can adjust world settings through certain admin commands. In order to use admin commands, you need to be a server admin, which is covered in this article. Using the main /worldconfig command, you can adjust world settings. General usage is /worldconfig <name> [value], replacing name with the configuration value, and value with the value you wish to set (either a string, boolean, or number). A full list of world config commands is available on the Vintage Story wiki, but here are a some common ones:

• /worldconfig spawnRadius [number] - Sets how far players spawn in a radius from the world spawnpoint.

• /worldconfig deathPunishment [drop|keep] - Determines whether to drop your inventory upon death. Default is "drop"

• /worldconfig playerHealthPoints [1-999] - Sets the base health points for players. This setting does not affect players who have already joined. Default is 15.

We recommend trying to adjust settings with the admin commands first for ease of access. However, not all settings can be edited through commands (such as settings that require a new world to be generated). For those settings, you would need to use the file manager.

Once the setting has been adjusted, restart the server to ensure it applies. If the setting affects terrain generation, you may need to generate a new world.