Server Config/ru: Difference between revisions

From Vintage Story Wiki
Updating to match new version of source page
(Created page with "Настройки сервера")
 
(Updating to match new version of source page)
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>__TOC__
<languages/>


== serverconfig.json ==
__TOC__
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.
<div class="mw-translate-fuzzy">
Вы можете узнать больше о некоторых значениях на страницах [[List of server commands/ru|Список серверных команд]] и [[Setting up a Multiplayer Server/ru|Настройка многопользовательского сервера]].
</div>


''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 =)''
<div lang="en" dir="ltr" class="mw-content-ltr">
You can learn more about some values on {{ll|List of server commands|List of server commands}} and {{ll|Setting up a Multiplayer Server|Setting up a Multiplayer Server}} pages.
</div>


<syntaxhighlight lang="py">
<div lang="en" dir="ltr" class="mw-content-ltr">
{
<div class="mw-collapsible mw-collapsed">
  #
'''Defaults'''
  "ConfigVersion": "1.3",
</div>


  #
<div lang="en" dir="ltr" class="mw-content-ltr">
  "ServerMonitor": true,
<div class="mw-collapsible-content">
Windows paths:
</div>


   #
<div lang="en" dir="ltr" class="mw-content-ltr">
   "MasterserverUrl": "http://masterserver.vintagestory.at/api/v1/servers/",
<syntaxhighlight lang="json">
"ModPaths": [
   "C:\\Users\\user\\AppData\\Roaming\\VintagestoryData\\Mods",
  ...
],
"WorldConfig": {
   "SaveFileLocation": "C:\\Users\\user\\AppData\\Roaming\\VintagestoryData\\Saves\\default.vcdbs",
  ...
}
</syntaxhighlight>
</div>


  # Makes clients time out after that amount of seconds have passed
<div lang="en" dir="ltr" class="mw-content-ltr">
  "ClientConnectionTimeout": 600,
Full serverconfig.json (Linux paths):
</div>


  # Seems to have no use
<div lang="en" dir="ltr" class="mw-content-ltr">
  "ClientPlayingTimeout": 60,
<syntaxhighlight lang="json">
 
{
  # Has no use
  "BuildLogging": false,
 
  #
   "EntityDebugMode": false,
   "EntityDebugMode": false,
 
  "ConfigVersion": "1.5",
   # Width of the world
   "ServerName": "Vintage Story Server",
   "MapSizeX": 1000000,
   "ServerUrl": null,
 
  "ServerDescription": null,
   # Height of the world
  "WelcomeMessage": "Welcome {0}, may you survive well and prosper",
  "Ip": null,
  "Port": 42420,
  "Upnp": false,
  "CompressPackets": true,
  "AdvertiseServer": true,
  "MaxClients": 16,
  "PassTimeWhenEmpty": false,
  "MasterserverUrl": "http://masterserver.vintagestory.at/api/v1/servers/",
  "ModDbUrl": "https://mods.vintagestory.at/",
  "ClientConnectionTimeout": 150,
  "Password": null,
   "MapSizeX": 1024000,
   "MapSizeY": 256,
   "MapSizeY": 256,
 
   "MapSizeZ": 1024000,
  # Length of the world
   "MapSizeZ": 1000000,
 
  # 2-letter code of localization to use on this server. Determines language of server messages.
   "ServerLanguage": "en",
   "ServerLanguage": "en",
 
  "MaxChunkRadius": 12,
   # This tells the world generator to skip stripes of chunks. Useful for testing ore deposit generation.
   "TickTime": 33.3333321,
   # i.e. if you set SkipEveryChunkRow to 3 and SkipEveryChunkRowWidth to 2, then every 3rd chunk strip there'll be 2 chunk strips missing
  "SpawnCapPlayerScaling": 0.75,
  "BlockTickChunkRange": 4,
   "MaxMainThreadBlockTicks": 10000,
  "RandomBlockTicksPerChunk": 16,
  "BlockTickInterval": 300,
   "SkipEveryChunkRow": 0,
   "SkipEveryChunkRow": 0,
   "SkipEveryChunkRowWidth": 0,
   "SkipEveryChunkRowWidth": 0,
 
  "Roles": [
  # Where server should look for mods. []
    {
      "Code": "suvisitor",
      "PrivilegeLevel": -1,
      "Name": "Survival Visitor",
      "Description": "Can only visit this world and chat but not use/place/break anything",
      "DefaultSpawn": null,
      "ForcedSpawn": null,
      "Privileges": [
        "chat"
      ],
      "RuntimePrivileges": [],
      "DefaultGameMode": 1,
      "Color": "Green",
      "LandClaimAllowance": 0,
      "LandClaimMinSize": {
        "X": 5,
        "Y": 5,
        "Z": 5
      },
      "LandClaimMaxAreas": 3,
      "AutoGrant": false
    },
    {
      "Code": "crvisitor",
      "PrivilegeLevel": -1,
      "Name": "Creative Visitor",
      "Description": "Can only visit this world, chat and fly but not use/place/break anything",
      "DefaultSpawn": null,
      "ForcedSpawn": null,
      "Privileges": [
        "chat"
      ],
      "RuntimePrivileges": [],
      "DefaultGameMode": 2,
      "Color": "DarkGray",
      "LandClaimAllowance": 0,
      "LandClaimMinSize": {
        "X": 5,
        "Y": 5,
        "Z": 5
      },
      "LandClaimMaxAreas": 3,
      "AutoGrant": false
    },
    {
      "Code": "limitedsuplayer",
      "PrivilegeLevel": -1,
      "Name": "Limited Survival Player",
      "Description": "Can use/place/break blocks only in permitted areas (priv level -1), create/manage player groups and chat",
      "DefaultSpawn": null,
      "ForcedSpawn": null,
      "Privileges": [
        "controlplayergroups",
        "manageplayergroups",
        "chat",
        "build",
        "useblock",
        "attackcreatures",
        "attackplayers",
        "selfkill"
      ],
      "RuntimePrivileges": [],
      "DefaultGameMode": 1,
      "Color": "White",
      "LandClaimAllowance": 0,
      "LandClaimMinSize": {
        "X": 5,
        "Y": 5,
        "Z": 5
      },
      "LandClaimMaxAreas": 3,
      "AutoGrant": false
    },
    {
      "Code": "limitedcrplayer",
      "PrivilegeLevel": -1,
      "Name": "Limited Creative Player",
      "Description": "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)",
      "DefaultSpawn": null,
      "ForcedSpawn": null,
      "Privileges": [
        "controlplayergroups",
        "manageplayergroups",
        "chat",
        "build",
        "useblock",
        "gamemode",
        "freemove",
        "attackcreatures",
        "attackplayers",
        "selfkill"
      ],
      "RuntimePrivileges": [],
      "DefaultGameMode": 2,
      "Color": "LightGreen",
      "LandClaimAllowance": 0,
      "LandClaimMinSize": {
        "X": 5,
        "Y": 5,
        "Z": 5
      },
      "LandClaimMaxAreas": 3,
      "AutoGrant": false
    },
    {
      "Code": "suplayer",
      "PrivilegeLevel": 0,
      "Name": "Survival Player",
      "Description": "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.",
      "DefaultSpawn": null,
      "ForcedSpawn": null,
      "Privileges": [
        "controlplayergroups",
        "manageplayergroups",
        "chat",
        "areamodify",
        "build",
        "useblock",
        "attackcreatures",
        "attackplayers",
        "selfkill"
      ],
      "RuntimePrivileges": [],
      "DefaultGameMode": 1,
      "Color": "White",
      "LandClaimAllowance": 262144,
      "LandClaimMinSize": {
        "X": 5,
        "Y": 5,
        "Z": 5
      },
      "LandClaimMaxAreas": 3,
      "AutoGrant": false
    },
    {
      "Code": "crplayer",
      "PrivilegeLevel": 100,
      "Name": "Creative Player",
      "Description": "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.",
      "DefaultSpawn": null,
      "ForcedSpawn": null,
      "Privileges": [
        "controlplayergroups",
        "manageplayergroups",
        "chat",
        "areamodify",
        "build",
        "useblock",
        "gamemode",
        "freemove",
        "attackcreatures",
        "attackplayers",
        "selfkill"
      ],
      "RuntimePrivileges": [],
      "DefaultGameMode": 2,
      "Color": "LightGreen",
      "LandClaimAllowance": 1310720,
      "LandClaimMinSize": {
        "X": 5,
        "Y": 5,
        "Z": 5
      },
      "LandClaimMaxAreas": 6,
      "AutoGrant": false
    },
    {
      "Code": "sumod",
      "PrivilegeLevel": 200,
      "Name": "Survival Moderator",
      "Description": "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.",
      "DefaultSpawn": null,
      "ForcedSpawn": null,
      "Privileges": [
        "controlplayergroups",
        "manageplayergroups",
        "chat",
        "areamodify",
        "build",
        "useblock",
        "buildblockseverywhere",
        "useblockseverywhere",
        "kick",
        "ban",
        "announce",
        "readlists",
        "attackcreatures",
        "attackplayers",
        "selfkill"
      ],
      "RuntimePrivileges": [],
      "DefaultGameMode": 1,
      "Color": "Cyan",
      "LandClaimAllowance": 1310720,
      "LandClaimMinSize": {
        "X": 5,
        "Y": 5,
        "Z": 5
      },
      "LandClaimMaxAreas": 60,
      "AutoGrant": false
    },
    {
      "Code": "crmod",
      "PrivilegeLevel": 500,
      "Name": "Creative Moderator",
      "Description": "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.",
      "DefaultSpawn": null,
      "ForcedSpawn": null,
      "Privileges": [
        "controlplayergroups",
        "manageplayergroups",
        "chat",
        "areamodify",
        "build",
        "useblock",
        "buildblockseverywhere",
        "useblockseverywhere",
        "kick",
        "ban",
        "gamemode",
        "freemove",
        "commandplayer",
        "announce",
        "readlists",
        "attackcreatures",
        "attackplayers",
        "selfkill"
      ],
      "RuntimePrivileges": [],
      "DefaultGameMode": 2,
      "Color": "Cyan",
      "LandClaimAllowance": 1310720,
      "LandClaimMinSize": {
        "X": 5,
        "Y": 5,
        "Z": 5
      },
      "LandClaimMaxAreas": 60,
      "AutoGrant": false
    },
    {
      "Code": "admin",
      "PrivilegeLevel": 99999,
      "Name": "Admin",
      "Description": "Has all privileges, including giving other players admin status.",
      "DefaultSpawn": null,
      "ForcedSpawn": null,
      "Privileges": [
        "build",
        "useblock",
        "buildblockseverywhere",
        "useblockseverywhere",
        "attackplayers",
        "attackcreatures",
        "freemove",
        "gamemode",
        "pickingrange",
        "chat",
        "kick",
        "ban",
        "whitelist",
        "setwelcome",
        "announce",
        "readlists",
        "give",
        "areamodify",
        "setspawn",
        "controlserver",
        "tp",
        "time",
        "grantrevoke",
        "root",
        "commandplayer",
        "controlplayergroups",
        "manageplayergroups",
        "selfkill",
        "worldedit"
      ],
      "RuntimePrivileges": [],
      "DefaultGameMode": 1,
      "Color": "LightBlue",
      "LandClaimAllowance": 2147483647,
      "LandClaimMinSize": {
        "X": 5,
        "Y": 5,
        "Z": 5
      },
      "LandClaimMaxAreas": 99999,
      "AutoGrant": true
    }
  ],
  "DefaultRoleCode": "suplayer",
   "ModPaths": [
   "ModPaths": [
     "Mods",
     "Mods",
     "/absolute/path/to/Mods"
     "/home/user/.config/VintagestoryData/Mods"
   ],
   ],
 
   "AntiAbuse": 0,
   # Can be used for set up parameters of new world
   "WorldConfig": {
   "WorldConfig": {
   
     "Seed": null,
    # Seed. Does not guarantee exactly the same world each time!
     "SaveFileLocation": "/home/user/.config/VintagestoryData/Saves/default.vcdbs",
     "Seed": "1234567890",
     "WorldName": "A new world",
 
     "AllowCreativeMode": true,
    # 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",
     "PlayStyle": "surviveandbuild",
 
     "PlayStyleLangCode": "surviveandbuild-bands",
    # 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",
     "WorldType": "standard",
 
     "WorldConfiguration": null,
    # 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,
     "MapSizeY": null,
 
     "CreatedByPlayerName": null,
     # Anything you want to see in Author field, usually it's nickname
     "DisabledMods": null,
     "CreatedByPlayerName": "John Smith",
     "RepairMode": false
 
    #
     "DisabledMods": []
   },
   },
  #
   "NextPlayerGroupUid": 10,
   "NextPlayerGroupUid": 10,
  #
   "GroupChatHistorySize": 20,
   "GroupChatHistorySize": 20,
  #
   "MaxOwnedGroupChannelsPerUser": 10,
   "MaxOwnedGroupChannelsPerUser": 10,
  "OnlyWhitelisted": false,
  "VerifyPlayerAuth": true,
  "DefaultSpawn": null,
  "AllowPvP": true,
  "AllowFireSpread": true,
  "AllowFallingBlocks": true,
  "HostedMode": false,
  "StartupCommands": null,
  "RepairMode": false,
  "AnalyzeMode": false,
  "CorruptionProtection": true,
  "RegenerateCorruptChunks": false,
  "ChatRateLimitMs": 1000,
  "DieBelowDiskSpaceMb": 400
}
</syntaxhighlight>
</div>
</div>
</div>


  # Set up the server name, visible in the public server listing
<div lang="en" dir="ltr" class="mw-content-ltr">
  "ServerName": "Name of your Vintage Story Server",
<div class="mw-collapsible">
'''Sample with explanations'''
</div>


  # Has no use yet. It's supposed to be used for another piece of information in the public server detail page
<div class="mw-translate-fuzzy">
  "ServerUrl": "https://www.vintagestory.at/",
''Пустые комментарии означают, что значение неясно, поэтому, если вы точно знаете, что оно делает - смело наполняйте комментарий полезными знаниями =)''
</div>


   # Set up the servers description, visible in the public server listing. You can use VTML here (for example, <br> for line break)
<div class="mw-translate-fuzzy">
   "ServerDescription": "Sample description.<br>Next line of description.",
<syntaxhighlight lang="py">
{
   #  
   "ConfigVersion": "1.3",
</div>


   # The message shown to players when they join. Placeholder {0} will be replaced with Player's nickname.
   <div lang="en" dir="ltr" class="mw-content-ltr">
   "WelcomeMessage": "Welcome, {0}. Don't forget to follow our rules.",
// Where server should look for mods.  
   "ModPaths": [
    "/absolute/path/to/Mods",
    "Mods"
  ],
</div>


   # What interface server should listen. If you don't specify one, it'll listen on all interfaces
   <div lang="en" dir="ltr" class="mw-content-ltr">
// 2-letter code of localization to use on this server. Determines language of server messages.
  "ServerLanguage": "en",
  // Short string, visible in the public server listing.
  "ServerName": "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": null,
  // Can be longer than name, visible in the public server listing. You can use VTML here (for example, <br> for line break).
  "ServerDescription": null,
  // The message shown to players when they join. Placeholder {0} will be replaced with Player's nickname.
  "WelcomeMessage": "Welcome {0}, may you survive well and prosper",
  // What interface server should listen. If you don't specify one, it'll listen on all interfaces.
   "Ip": null,
   "Ip": null,
 
   // Port what server should listen. You may want to change this if you want to run server on custom port.
   # Port what server should listen. You may want to change this if you want to run server on custom port.
   "Port": 42420,
   "Port": 42420,
  // If server should try to use UPnP for port forwarding.
  "Upnp": false,
</div>


   # If server should try to use upnp for port forwarding
   <div lang="en" dir="ltr" class="mw-content-ltr">
   "Upnp": false,
// Maximum number of players. If an integer value is passed it will set the max concurrent players the server may have. Higher values requires more RAM and CPU.
   "MaxClients": 16,
</div>


   #
   <div lang="en" dir="ltr" class="mw-content-ltr">
   "CompressPackets": true,
// If not null, requires a password for players to log in.
   "Password": "our secret password",
  // Whether or not to only allow whitelisted players to connect to the server.
  "OnlyWhitelisted": false,
</div>


   # Whether or not add this server to the public server listing
   <div lang="en" dir="ltr" class="mw-content-ltr">
// Whether or not add this server to the master server (public server listing).
   "AdvertiseServer": true,
   "AdvertiseServer": true,
  // 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,
</div>
  <div lang="en" dir="ltr" class="mw-content-ltr">
// If players can hit each other.
  "AllowPvP": true,
  // Disables fire spreading if false.
  "AllowFireSpread": true,
  // If false, completely disables any falling block behavior.
  "AllowFallingBlocks": true,
</div>


   # 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
   <div lang="en" dir="ltr" class="mw-content-ltr">
   "MaxClients": 16,
// If true, this features are disabled: "MaxChunkRadius", "MaxClients", "Upnp", "EntityDebugMode", "TickTime", "RandomBlockTicksPerChunk"
  "HostedMode": false,
  // Sends additional debug information to the client, which displays it if it also has entity debug mode enabled.
  "EntityDebugMode": false,
  //
  "RepairMode": false,
  //
  "AnalyzeMode": false,
</div>
 
  <div lang="en" dir="ltr" class="mw-content-ltr">
// Whether to compress data when sending it to the client.
  "CompressPackets": true,
  // Sets antiabuse level, this protects against a range of malicious player operations, but it is pretty glitchy in v1.7.
   "AntiAbuse": 0,
</div>


   # Require a password for players to log in
   <div lang="en" dir="ltr" class="mw-content-ltr">
   "Password": "my secret password",
// Width of the world.
  "MapSizeX": 1024000,
  // Height of the world.
  "MapSizeY": 256,
  // Length of the world.
  "MapSizeZ": 1024000,
  // 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
  },
</div>


   # 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
   <div lang="en" dir="ltr" class="mw-content-ltr">
// If true, the calendar will never stop even if there are no players online.
  "PassTimeWhenEmpty": false,
  // Makes clients time out after that amount of seconds have passed.
  "ClientConnectionTimeout": 150,
  // 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,
   "MaxChunkRadius": 12,
  // Shutdowns the server if only such amount of disk space is left.
  "DieBelowDiskSpaceMb": 400,
  //
  "SpawnCapPlayerScaling": 0.75,
</div>


   #
   <div lang="en" dir="ltr" class="mw-content-ltr">
// 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,
  // Desired amount of milliseconds between each server tick. Default value is 30 ticks per second, i.e. 1000/30 = 33.333ms.
   "TickTime": 33.3333321,
   "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,
  // The interval of time in ms between each execution of the random tick system.
  "BlockTickInterval": 300,
</div>


   #
   <div lang="en" dir="ltr" class="mw-content-ltr">
   "BlockTickChunkRange": 3,
// 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,
  //
  "CorruptionProtection": true,
  //
  "RegenerateCorruptChunks": false,
</div>


   #
   <div lang="en" dir="ltr" class="mw-content-ltr">
   "MaxMainThreadBlockTicks": 10000,
// Anti-spam for the chat window. How many milliseconds are required between 2 messages. 1000 ms = 1 second.
  "ChatRateLimitMs": 1000,
  // The max amount of group channels a player can create
  "MaxOwnedGroupChannelsPerUser": 10,
  // Has no use currently.
   "GroupChatHistorySize": 20,
</div>


   # How many random ticks per chunk should be executed. Simply said, a higher value makes grass grow back faster.
   <div lang="en" dir="ltr" class="mw-content-ltr">
   "RandomBlockTicksPerChunk": 16,
// Run a command when server starts. For example, players without access to the server console can op themselves. Can run multiple commands by separating them with linebreaks.
   "StartupCommands": "/time \n /info seed",
</div>


   #
   <div lang="en" dir="ltr" class="mw-content-ltr">
   "BlockTickInterval": 300,
// Internal value.
   "NextPlayerGroupUid": 10,
</div>


   #
   <div lang="en" dir="ltr" class="mw-content-ltr">
// Default role for new players.
  "DefaultRoleCode": "suplayer",
   "Roles": [
   "Roles": [
     {
     {
       # Role ID
       // Role ID.
       "Code": "suvisitor",
       "Code": "suvisitor",
 
      //
       # Role readable name
      "PrivilegeLevel": -1,
       // Role readable name.
       "Name": "Survival Visitor",
       "Name": "Survival Visitor",
      #
       "Description": "Can only visit this world and chat but not use/place/break anything",
       "Description": "Can only visit this world and chat but not use/place/break anything",
 
       // (should be similar to global DefaultSpawn, but for role)
       #
      "PrivilegeLevel": -1,
 
      # (should be similar to global DefaultSpawn, but for role)
       "DefaultSpawn": null,
       "DefaultSpawn": null,
 
       //
       #
       "ForcedSpawn": null,
       "ForcedSpawn": null,
 
       // List of granted priveleges (full list may be shown by "/list privileges" command).
       # list of granted priveleges (full list may be shown by "/list privileges" command)
       "Privileges": [ "chat" ],
       "Privileges": [
       //
        "chat"
      ],
 
       #
       "RuntimePrivileges": [],
       "RuntimePrivileges": [],
 
       // 0 - Guest, 1 - Survival, 2 - Creative, 3 - Spectator. (see /gamemode command).
       #
       "DefaultGameMode": 1,
       "DefaultGameMode": 1,
 
       //
       #
       "Color": "Green",
       "Color": "Green",
 
       // Volume allowed in cubic meters for the land claims of each player who has this role (default: 4 chunks = 4*32*32*32 cubic meters = 131072 blocks)
       # 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,
       "LandClaimAllowance": 0,
 
       // The smallest cuboid a player may claim (default 5x5x5)
       # The smallest cuboid a player may claim (default 5x5x5)
       "LandClaimMinSize": { "X": 5, "Y": 5, "Z": 5 },
       "LandClaimMinSize": {
       // The max quantity of non adjacent-areas a player may claim.
        "X": 5,
        "Y": 5,
        "Z": 5
      },
 
       # The max quantity of non adjacent-areasa a player may claim (default: 3)
       "LandClaimMaxAreas": 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
       # "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
       "AutoGrant": false
     },
     },
     ...
     ...
   ],
   ],
</div>


   # Default role for new players
   <div lang="en" dir="ltr" class="mw-content-ltr">
  "DefaultRoleCode": "suplayer",
"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/world_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", "homosapiens" 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", "preset-homosapiens" and "creativebuilding".
    "PlayStyleLangCode": "surviveandbuild",
    // World generation type. Possible values: "standard", "superflat".
    "WorldType": "standard",
</div>


  # Sets antiabuse level, this protects against a range of malicious player operations, but is currently pretty glitchy in the current state (v1.7)
    <div lang="en" dir="ltr" class="mw-content-ltr">
  "AntiAbuse": 0,
// Settings of new world. Basically can use the same properties as with /worldconfig
    "WorldConfiguration": {
      "worldClimate": "realistic",
      "gameMode": "survival",
      "temporalStability": true,
      "temporalStorms": "sometimes",
      "graceTimer": "0"
    },
</div>


  # Wether or not to only allow whitelisted players to connect to the server
    <div lang="en" dir="ltr" class="mw-content-ltr">
  "OnlyWhitelisted": false,
// Height of the world.
 
     "MapSizeY": null,
  # If true, every time a player joins the server verifies if that player is a valid, logged in, registered buyer of the game.
     // Anything you want to see in Author field, usually it's nickname.
  "VerifyPlayerAuth": true,
     "CreatedByPlayerName": "John Smith",
 
     // List of mods (IDs) that should be ignored.
  # Shows or sets the default spawn point. y can be omitted to automatically use the surface position at given x/z location.
     "DisabledMods": [ "expandedfoods" ],
  "DefaultSpawn": {
    //
     "x": 500025,
    "RepairMode": false
     "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
}
}
</syntaxhighlight>
</syntaxhighlight>
</div>
</div>
</div>


== servermagicnumbers.json ==
== servermagicnumbers.json ==
Line 257: Line 657:
<syntaxhighlight lang="py">
<syntaxhighlight lang="py">


<div class="mw-translate-fuzzy">
{
{
   #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)
   #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.
   #This value is capped by each players max chunk range.
   "DefaultEntityTrackingRange": 4,
   "DefaultEntityTrackingRange": 4,
</div>


   #Cubic size of the chunks on the server (width, length and height)
   #Cubic size of the chunks on the server (width, length and height)
Line 324: Line 726:


</syntaxhighlight>
</syntaxhighlight>
{{Game navbox}}
43,146

edits