Vintage Story

Introduction

Here we show you where to set up your server.

Settings

IP and Port

serverconfig.json

Path: /home/container/data/serverconfig.json

To make your server publicly available, you need to give your server a name and replace the port.

{ "ConfigVersion": "1.4", "ServerMonitor": true, "PassTimeWhenEmpty": false, "MasterserverUrl": "http://masterserver.vintagestory.at/api/v1/servers/", "ClientConnectionTimeout": 120, "EntityDebugMode": false, "MapSizeX": 1024000, "MapSizeY": 256, "MapSizeZ": 1024000, "ServerLanguage": "en", "SkipEveryChunkRow": 0, "SkipEveryChunkRowWidth": 0, "ModPaths": [ "Mods", "./data/Mods" ], "WorldConfig": { "Seed": null, #-> here you can enter a world seed "SaveFileLocation": "./data/Saves/default.vcdbs", "WorldName": "A new world", "AllowCreativeMode": true, #-> enable "PlayStyle": "surviveandbuild", "PlayStyleLangCode": "surviveandbuild-bands", "WorldType": "standard", "WorldConfiguration": null, "MapSizeY": null, "CreatedByPlayerName": null, "DisabledMods": null, "RepairMode": false }, "NextPlayerGroupUid": 10, "GroupChatHistorySize": 20, "MaxOwnedGroupChannelsPerUser": 10, "ServerName": "Gamer_Kap", #-> give your server a name "ServerUrl": null, "ServerDescription": null, #-> your server-description "WelcomeMessage": "Welcome {0}, may you survive well and prosper", #-> Welcome message "Ip": null, "Port": 42420, #-> here you insert the port of your server "Upnp": false, "CompressPackets": true, "AdvertiseServer": true, "MaxClients": 16, "Password": null, #-> make a password for your server "MaxChunkRadius": 12, "TickTime": 33.3333321, "BlockTickChunkRange": 4, "MaxMainThreadBlockTicks": 10000, "RandomBlockTicksPerChunk": 16, "BlockTickInterval": 300, "Roles": [ {

Worldconfig

⇓⇓⇓The following list was taken from the official wiki of Vintage Story (Link )⇓⇓⇓

General usage

/worldconfig name -> Show current configuration value

/worldconfig name value -> Set a configuration value

/worldconfigcreate datatype name value -> Creates a new configuration value. This is necessary when setting some configurations for the first time (datatype can be float double int string and bool)

Please note: Commands are case-sensitive. Type them exactly as you see, except for the [ ] shown in below command syntax, which is intended only to show which values can be changed! The pipe (\|) symbol is there to separate allowed values, e.g. [true\|false] means you can set true or false here

Player spawn and death

The configs starting climate and grace timer can only be set during world creation.

/worldconfig deathPunishment [drop|keep] -> Whether to drop your inventory upon death (default: drop)

/worldConfig spawnRadius [number] -> Sets how far players spawn in a radius from world spawn.

Survival challenges

/worldConfig seasons [enabled or spring] -> If enabled, seasons will pass over time, otherwise 'spring' will make the climate always stay at spring (default: enabled)

/worldConfig playerlives [-1 .. 99] -> Set the amount of lives a player has before he can no longer respawn. -1 means infinite. (default: infinite)

/worldConfig daysPerMonth [1-99] -> Set the amount of days each month has. Setting it to a higher value will make seasons go by slower (default: 12)

/worldConfig harshWinters [true|false] -> If true, cold temperatures will damage crops, reduce animal spawn during winter and reduce meat harvested from animals (default: true)

/worldconfig blockGravity [sandgravel|sandgravelsoil] -> Set the block gravity behavior for either just sand and gravel or additionally also soil (default: sandgravel)

/worldConfig allowUndergroundFarming [true|false] -> If true, plants can be grown deep underground, given enough sunlight. (default: false)

/worldconfig bodyTemperatureResistance [-40.. 40] -> Sets the temperature an undressed seraph can bear without starting to freeze

/worldconfig creatureHostility [aggressive|passive|off] -> Set default creature hostility (default: aggressive)

/worldconfig creatureStrength [0-99] -> Sets the creature damage multiplier (default: 1)

/worldconfig playerHealthPoints [1-999] -> Set the players base health points (default: 15)

/worldconfig playerHungerSpeed [0-10] -> Set the players hunger rate multiplier (default: 1)

/worldconfig playerMoveSpeed [0-10] -> Set the players move speed multiplier (default: 1.5)

/worldconfig foodSpoilSpeed [0-10] -> Set the spoilage rate multiplier of all perishable foods, e.g. 0.5 means all food lasts twice as long (default: 1)

/worldconfig saplingGrowthRate [0.1-20] -> Set the sapling growth rate multiplier of all trees. (default: 1)

/worldconfig toolDurability [0-99] -> Set the tool durability multiplier, e.g. 2 means all tools have double durability. (default: 1)

/worldconfig toolMiningSpeed [0-99] -> Set the tool mining speed multiplier, e.g. 2 means all tools have break blocks twice as fast. (default: 1)

/worldConfig propickNodeSearchRadius [0-12] -> If above zero, a second prospecting mode will be enabled that allows for exact searches at the defined radius (default: 0)

/worldConfig globalDepositSpawnRate [0.1 - 5] -> Set a global ores and mineral deposit spawn rate (default: 1)

/worldconfig microblockChiseling [off|stonewood|all] -> Whether to allow microblock chiseling. 'stonewood' means all stone and wood materials are allowed. 'all' means most cubic blocks are allowed. (default: stonewood)

/worldconfig allowCoordinateHud [true|false] -> Whether or not players are allowed to used the coordinate hud. (default: true)

/worldconfig allowMap [true|false] -> Whether or not players are allowed to used the world map. (default: true)

Temporal stability

/worldconfig tempstormDurationMul value -> Command to change the duration of temporal storms

/worldconfig temporalStability [false|true] -> Whether or not the temporal stability mechanic should apply (default: true)

/worldconfig temporalRifts [off|invisible|visible] -> Defines temporal rift behavior (default: visible)
Off: No rifts spawn, which also means there will be no surface drifters.
Invisible: Rifts are not visible to the player, make no sound and do not affect players in any way, but do spawn drifters.
Visible: Rifts are visible to the player, make sound, drain stability on nearby players and spawn drifters.

/worldconfig temporalStability [false|true] -> Whether or not the temporal stability mechanic should apply (default: true)

/worldconfig temporalGearRespawnUses [-1 .. 9999] -> How many times you can respawn from a spawnpoint set by the temporal gear. -1 means infinite. (default: infinite)

/worldconfig temporalStormSleeping [false|true] -> Whether or not to allow sleeping during temporal storms (default: false)

World generation

The configs world climate, world size and polar-equator distance can only be set during world creation.

/worldconfig worldEdge [blocked|traversable] -> Wether you can fall off the world edge (default: traversable)

/worldconfig globalTemperature [0-5] -> Sets the global temperature multiplier for world generation. Does not affect already generated chunks. Useful values are between 0.1 and 5, where 0.1 is super cold, and 5 is super hot. (default: 1)

/worldconfig globalPrecipitation [0-5] -> Sets the global rainfall multiplier for world generation. Does not affect already generated chunks. Useful values are between 0.1 and 5, where 0.1 is super dry and 5 is super wet (default: 1)

/worldconfig globalForestation [-1 .. 1] -> Sets the global forestation offset for world generation. -1 means there will be no forests, 1 means there will be only forests, the value 0 means default forestation density (default: 0)

/worldconfig surfaceCopperDeposits [0-5] -> Set chance of surface copper spawning for each chunk column (default: 0.1)

/worldconfig surfaceTinDeposits [0-5] -> Set chance of surface tin spawning for each chunk column (default: 0.07)

/worldConfig snowAccum [true|false] -> If true, snow will accumulate during winter (default: true)

Multiplayer

/worldconfig allowLandClaiming [true|false] -> Whether or not players are allowed to use the land claiming system. (default: true)

/worldConfig classExclusiveRecipes [true|false] -> If true, class exclusive recipes are enabled (default: true)

/worldConfig auctionHouse [true|false] -> Whether or not the auction house is available to players (default: true)

Configurations not in the customize world screen

These configs need to be created first. Subsequent edits to those can be done with /worldconfig name value

/worldconfigcreate bool disableDeathMessages [true|false] -> Whether or not death messages will be displayed.

/worldconfigcreate bool windAffectedEntityMovement [true|false] -> Whether or not wind affects player and creature movement.

/worldconfigcreate bool allowCropDeath [true|false] -> Whether or not crops can die.

/worldconfigcreate float auctionHouseDeliveryPriceMul [0..10] -> A multiplier on the delivery costs for purchased items in the auction house (default: 1)

/worldconfigcreate int auctionHouseDurationWeeksMul [1,2,3,4...] -> A multiplier on how many weeks a auction can stay listed before expiring, does change the cost of listing (e.g. doubling this value will have items listed twice as long for the same cost). Can not use decimal numbers. (default: 1)

/worldconfigcreate float auctionHouseSalesCutRate [0..1] -> The sales cut the trader takes for a sold item on the auction. (default: 0.1, which is 10%)

Administration

Assign Roles: /player [playername] role [rolename] Example: /player LeeroyK role admin
    Roles:
    suvisitor -> Can only visit this world and chat but not use/place/break anything
    crvisitor -> Can only visit this world, chat and fly but not use/place/break anything
    limitedsuplayer -> Can use/place/break blocks only in permitted areas (priv level -1), create/manage player groups and chat
    limitedcrplayer -> Can use/place/break blocks in only in permitted areas (priv level -1), create/manage player groups, chat, fly and set his own game mode (= allows fly and change of move speed)
    suplayer -> Can use/place/break blocks in unprotected areas (priv level 0), create/manage player groups and chat. Can claim an area of up to 8 chunks.
    crplayer -> Can use/place/break blocks in all areas (priv level 100), create/manage player groups, chat, fly and set his own game mode (= allows fly and change of move speed). Can claim an area of up to 40 chunks.
    sumod -> Can use/place/break blocks everywhere (priv level 200), create/manage player groups, chat, kick/ban players and do serverwide announcements. Can claim an area of up to 4 chunks.
    crmod -> Can use/place/break blocks everywhere (priv level 500), create/manage player groups, chat, kick/ban players, fly and set his own or other players game modes (= allows fly and change of move speed). Can claim an area of up to 40 chunks.
    admin -> Has all privileges, including giving other players admin status.

Time: /time set Example: /time set day
    morning
    day
    afternoon
    night
    more...

Gamemode: /gamemode [0..3] Example: /gamemode 2 -> you are now in creative mode
    morning
    0 -> guest (cant interact with blocks)
    1 -> survival (the "normal" mode)
    2 -> creative (fly, have all blocks and that stuff...)
    3 -> spectator (fly and cant do anything(and you have no body!))

Players: /list clients -> Shows a List of all Players on the Server.

Last modified: 16 March 2025