Server Config

From Vintage Story Wiki
This page contains changes which are not marked for translation.
Other languages:


This is sample of serverconfig.json with explanations.

You can learn more about some values on List of server commands and Setting up a Multiplayer Server pages.

Empty comments means that the value meaning is unclear, so if you know exactly what it does - feel free to fill comment with useful knowledge =)

  "ConfigVersion": "1.3",

  # Unused
  "ServerMonitor": true,

  "MasterserverUrl": "",

  # Makes clients time out after that amount of seconds have passed
  "ClientConnectionTimeout": 600,

  # Sends additional debug information to the client, which displays it if it also has entity debug mode enabled
  "EntityDebugMode": false,

  # Width of the world
  "MapSizeX": 1000000,

  # Height of the world
  "MapSizeY": 256,

  # Length of the world
  "MapSizeZ": 1000000,

  # 2-letter code of localization to use on this server. Determines language of server messages.
  "ServerLanguage": "en",

  # This tells the world generator to skip stripes of chunks. Useful for testing ore deposit generation.
  # i.e. if you set SkipEveryChunkRow to 3 and SkipEveryChunkRowWidth to 2, then every 3rd chunk strip there'll be 2 chunk strips missing
  "SkipEveryChunkRow": 0,
  "SkipEveryChunkRowWidth": 0,

  # Where server should look for mods. []
  "ModPaths": [

  # Can be used for set up parameters of new world
  "WorldConfig": {
    # Seed. Does not guarantee exactly the same world each time!
    "Seed": "1234567890",

    # Point to world file which should be loaded on server start (or created if not exists)
    "SaveFileLocation": "/absolute/path/to/Save/wold_file.vcdbs",

    # Defines a world name for new world
    "WorldName": "Sample World Name",

    # There used to be a "Allow cheats" toggle in the create world screen that forbids the use of /gamemode creative even if you are an admin. The config for it is still there
    "AllowCreativeMode": false,

    # Defines preset of parameters for new world. Possible values: "creativebuilding","surviveandbuild", "exploration" and "wildernesssurvival" (theoretically - any string value)
    "PlayStyle": "surviveandbuild",

    # A reference to an entry in the en.json. Basically, id for human-readable names for PlayStyle. Possible values: "preset-surviveandbuild", "preset-exploration", "preset-wildernesssurvival" and "creativebuilding"
    "PlayStyleLangCode": "surviveandbuild",

    # World generation type. Possible values: "standard", "superflat"
    "WorldType": "standard",

    # Settings of new world. Basically can use the same properties as with /worldconfig
    "WorldConfiguration": {
      "worldClimate": "realistic",
      "gameMode": "survival",
      "temporalStability": true,
      "temporalStorms": "sometimes",
      "graceTimer": "0"

    # Height of the world
    "MapSizeY": null,

    # Anything you want to see in Author field, usually it's nickname
    "CreatedByPlayerName": "John Smith",

    # List of mods that should be ignored
    "DisabledMods": []

  # Internal value
  "NextPlayerGroupUid": 10,

  # Has no use currently
  "GroupChatHistorySize": 20,

  # The max amount of groups a player can create
  "MaxOwnedGroupChannelsPerUser": 10,

  # Set up the server name, visible in the public server listing
  "ServerName": "Name of your Vintage Story Server",

  # Has no use yet. It's supposed to be used for another piece of information in the public server detail page
  "ServerUrl": "",

  # Set up the servers description, visible in the public server listing. You can use VTML here (for example, <br> for line break)
  "ServerDescription": "Sample description.<br>Next line of description.",

  # The message shown to players when they join. Placeholder {0} will be replaced with Player's nickname.
  "WelcomeMessage": "Welcome, {0}. Don't forget to follow our rules.",

  # What interface server should listen. If you don't specify one, it'll listen on all interfaces
  "Ip": null,

  # Port what server should listen. You may want to change this if you want to run server on custom port.
  "Port": 42420,

  # If server should try to use upnp for port forwarding
  "Upnp": false,

  # Whether to compress data when sending it to the client. 
  "CompressPackets": true,

  # Whether or not add this server to the public server listing
  "AdvertiseServer": true,

  # Maximum number of players. If an integer value is passed it will set the maxclients, which is the max concurrent players the server may have. Higher values requires more RAM and CPU
  "MaxClients": 16,

  # Require a password for players to log in
  "Password": "my secret password",

  # Max chunk radius. If an integer value is passed it will set the max chunk radius, which is the highest view distance a player may have. Higher values require more RAM
  "MaxChunkRadius": 12,

  # Desired amount of milliseconds between each server tick. Default value is 30 ticks per second, i.e. 1000/30 = 33.333ms 
  "TickTime": 33.3333321,

  # How far away from the player chunks should receive random ticks (4 chunks means up to 4*32=128 blocks away)
  "BlockTickChunkRange": 4,

  # How many blocks to tick at most each server tick
  "MaxMainThreadBlockTicks": 10000,

  # How many random ticks per chunk should be executed. Simply said, a higher value makes grass grow back faster.
  "RandomBlockTicksPerChunk": 16,

  # The interval of time in ms between each execution of the random tick system
  "BlockTickInterval": 300,

  "Roles": [
      # Role ID
      "Code": "suvisitor",

      # Role readable name
      "Name": "Survival Visitor",

      "Description": "Can only visit this world and chat but not use/place/break anything",

      "PrivilegeLevel": -1,

      # (should be similar to global DefaultSpawn, but for role)
      "DefaultSpawn": null,

      "ForcedSpawn": null,

      # list of granted priveleges (full list may be shown by "/list privileges" command)
      "Privileges": [

      "RuntimePrivileges": [],

      "DefaultGameMode": 1,

      "Color": "Green",

      # Max allowed claimable area in cubic meters for every player that has this role (default: 4 chunks = 4*32*32*32 cubic meters = 131072)
      "LandClaimAllowance": 0,

      # The smallest cuboid a player may claim (default 5x5x5)
      "LandClaimMinSize": {
        "X": 5,
        "Y": 5,
        "Z": 5

      # The max quantity of non adjacent-areasa a player may claim (default: 3)
      "LandClaimMaxAreas": 3,

      # "Super admin" parameter. If true, any privilege that has been registered by the game engine or any mod is automatically granted to this role
      "AutoGrant": false

  # Default role for new players
  "DefaultRoleCode": "suplayer",

  # Sets antiabuse level, this protects against a range of malicious player operations, but is currently pretty glitchy in the current state (v1.7)
  "AntiAbuse": 0,

  # Wether or not to only allow whitelisted players to connect to the server
  "OnlyWhitelisted": false,

  # If true, every time a player joins the server verifies if that player is a valid, logged in, registered buyer of the game. 
  "VerifyPlayerAuth": true,

  # Shows or sets the default spawn point. y can be omitted to automatically use the surface position at given x/z location.
  "DefaultSpawn": {
    "x": 500025,
    "y": 113,
    "z": 499954,
    "yaw": null,
    "pitch": null,
    "roll": null

  # If players can hit each other
  "AllowPvP": true,

  "AllowFireSpread": true,

  # Completely disables any falling block behavior
  "AllowFallingBlocks": true,

  # Run a command when server starts. For example, players without access to the server console can op themselves. [probably can run multiple commands by separating them with linebreaks(\n), need to test]
  "StartupCommands": "/op Tyron"
  "RepairMode": false,
  "ChatRateLimitMs": 1000


  #The range an entity has to be in order for clients to receive regular updates for it. May be overriden by entities. The value is the max chunk distance. (e.g. 2 => update all entities not further away than 2 chunks in x/y any dir from a player)
  #This value is capped by each players max chunk range.
  "DefaultEntityTrackingRange": 4,

  #Cubic size of the chunks on the server (width, length and height)
  "ServerChunkSize": 32,

  #This is ServerChunkSize - 1 if ServerChunkSize is a multiple of 2 (which it really should be)
  "ServerChunkSizeMask": 31,

  #Size of the chunk column request buffer. Every chunk column of WorldGenPass Done needs to be surrounded by chunks of pass PreDone (3x3). 
  #Every PreDone chunk needs to be surrounded by Vegetation (5x5), every Vegetation chunk needs to be surrounded by terrainfeatures (7x7)
  #So in order to complete at least chunk column we have to keep 7x7=49 chunk columns in the queue
  "RequestChunkColumnsQueueSize": 2000,

  #Size of the chunk ready buffer. If buffer is full, the chunk gen thread no longer generates new chunks. 
  #This value can probably stay fairly small because if the main thread is not the bottleneck it will never fill up, but when it is the bottleneck we don't want to overburden it with sending gazillions of chunks to clients.
  "ReadyChunksQueueSize": 200,

  #Amount of chunks the SendChunks System may request per tick. Setting this value too high might fill the buffer too quickly and give a disadvantage to other players chunk loading speed.
  "ChunksColumnsToRequestPerTick": 1,

  #Amount of chunks the SendChunks System may send per tick. Setting this value too high might overburden the client or the network.
  "ChunksToSendPerTick": 32,

  #How often (at most) the SendChunks system should be called in ms (thread sleep time)
  "ChunkRequestTickTime": 40,

  #Amount of chunks the LoadChunks System may generate per tick. Setting this value too might overburden the server.
  "ChunkColumnsToGeneratePerThreadTick": 7,

  #How many seconds between each autosave of the game world.
  "ServerAutoSave": 300,

  #Width and Length of the cube of chunks to load for the spawn area. Setting this value to high will overflow the request buffer.
  "SpawnChunksWidth": 7,

  #Amount of entities each client can track at most. If the number of spawned entitites near the player goes beyond this number the player will only see the first ones that spawned until some of them despawned
  "TrackedEntitesPerClient": 1500,

  #Width and Length of Chunk regions
  "ChunkRegionSizeInChunks": 16,

  #After how many seconds a new calendar packet should be sent out to the client. You might want to reduce this interval for very laggy server / client in order for server and client game time to stay in sync.
  "CalendarPacketSecondInterval": 60,

  #After how many ms all the chunks should be checked if they can be unloaded
  "ChunkUnloadInterval": 4000,

  #After how many milliseconds the chunk should get packed
  "UncompressedChunkTTL": 15000,

  #After how many unused milliseconds the chunk should get unloaded
  "CompressedChunkTTL": 45000,

  #How much meter of the client position should leak into sever position (every 150ms), used as motion every 200ms
  "PlayerDesyncTolerance": 0.02,

  #How many intervalls (=150m) shall we toleratate clients position out of sync with servers position before we kick him (not used)
  "PlayerDesyncMaxIntervalls": 20.0,

  #How often the chunk generator should run in ms (thread sleep time)
  "ChunkThreadTickTime": 10