Serversettings.xml: Difference between revisions

From Official Barotrauma Wiki
Jump to: navigation, search
(Created page with "'''serversettings.xml''' is a file that stores all the settings for the Barotrauma dedicated and client-hosted server. It is located in the Barotrauma root directory (same pl...")
 
m (to previous edit, might be worth mentioning)
 
(12 intermediate revisions by 6 users not shown)
Line 1: Line 1:
'''serversettings.xml''' is a file that stores all the settings for the Barotrauma dedicated and client-hosted server.
<samp>'''serversettings.xml'''</samp> is a file that stores all the settings for the Barotrauma dedicated and client-hosted server.


It is located in the Barotrauma root directory (same place as the Barotrauma.exe).
It is located in the Barotrauma root directory (same place as the <samp>Barotrauma.exe</samp>).
 
==serversettings.xml==
Default settings for new game installs.
<pre>
<?xml version="1.0" encoding="utf-8"?>
<serversettings
tickrate="20"
randomizeseed="True"
userespawnshuttle="True"
respawninterval="300"
maxtransporttime="180"
minrespawnratio="0.2"
autorestartinterval="60"
startwhenclientsready="False"
startwhenclientsreadyratio="0.8"
allowspectating="True"
endroundatlevelend="True"
saveserverlogs="True"
allowragdollbutton="True"
allowfiletransfers="True"
voicechatenabled="True"
playstyle="Serious"
allowvotekick="True"
allowendvoting="True"
allowrespawn="True"
botcount="0"
maxbotcount="16"
botspawnmode="Normal"
allowdisguises="True"
allowrewiring="True"
allowfriendlyfire="True"
selectedsubmarine=""
selectedshuttle=""
traitorsenabled="No"
traitorsminplayercount="1"
traitorsminstartdelay="90"
traitorsmaxstartdelay="180"
traitorsminrestartdelay="30"
traitorsmaxrestartdelay="90"
subselectionmode="Manual"
modeselectionmode="Manual"
endvoterequiredratio="0.6"
kickvoterequiredratio="0.6"
killdisconnectedtime="30"
kickafktime="120"
karmaenabled="False"
karmapreset="default"
gamemodeidentifier="sandbox"
missiontype="All"
autobantime="3600"
maxautobantime="86400"
name="Server"
public="false"
port="27015"
queryport="27016"
maxplayers="10"
enableupnp="false"
autorestart="false"
LevelDifficulty="20"
AllowedRandomMissionTypes="Salvage,Monster,Cargo,Combat"
AllowedClientNameChars="32-33,38-46,48-57,65-90,91-91,93-93,95-122,192-255,384-591,1024-1279,19968-40959,13312-19903,131072-15043983,15043985-173791,173824-178207,178208-183983,63744-64255,194560-195103"
ServerMessage="" />
</pre>




Line 83: Line 20:
|True/False (Bool)
|True/False (Bool)
|Sets if the server should generate a new seed each round.
|Sets if the server should generate a new seed each round.
*True - Server randomizes seed when starting a new round.
*'''True''' - Server randomizes seed when starting a new round.
*False - Server doesn't randomize seed, uses the same seed set in the lobby.
*'''False''' - Server doesn't randomize seed, uses the same seed set in the lobby.
|-
|-
|userespawnshuttle
|userespawnshuttle
Line 91: Line 28:
|Allows or disallows the use of a respawn shuttle for respawning.
|Allows or disallows the use of a respawn shuttle for respawning.
'''Only works if respawning is allowed.'''
'''Only works if respawning is allowed.'''
*True - Uses respawn shuttle, respawning players spawn in a shuttle a distance from the main submarine and must dock or otherwise merge with the crew.
*'''True''' - Uses respawn shuttle, respawning players spawn in a shuttle a distance from the main submarine and must dock or otherwise merge with the crew.
*False - Doesn't use respawn shuttle, players are spawned in the submarine on certain job spawnpoints, depending on their job.
*'''False''' - Doesn't use respawn shuttle, players are spawned in the submarine on certain job spawnpoints, depending on their job.
|-
|-
|respawninterval
|respawninterval
|300
|300
|0< (Int)
|0< (Int)
|Sets time inbetween each respawn wave, in seconds.
|Sets time between each respawn wave, in seconds.
|-
|-
|maxtransporttime
|maxtransporttime
Line 121: Line 58:
|True/False (Bool)
|True/False (Bool)
|Allows or disallows the server to automatically start a round if enough players are ready.
|Allows or disallows the server to automatically start a round if enough players are ready.
*True - Starts automatically if the set client ratio is met.
*'''True''' - Starts automatically if the set client ratio is met.
*False - Ignores ready clients, must be manually started.
*'''False''' - Ignores ready clients, must be manually started.
|-
|-
|startwhenclientsreadyratio
|startwhenclientsreadyratio
Line 134: Line 71:
|True/False (Bool)
|True/False (Bool)
|Allows or disallows players from spectating.
|Allows or disallows players from spectating.
*True - Dead players can spectate.
*'''True''' - Dead players can spectate.
*False - Dead players cannot spectate and are sent into the lobby.
*'''False''' - Dead players cannot spectate and are sent into the lobby.
|-
|-
|endroundatlevelend
|endroundatlevelend
|True
|True
|True/False (Bool)
|True/False (Bool)
|Sets if the round should be ended once the submarine reaches the end of the level. (Doesn't dock)
|Sets if the round should be ended once the submarine reaches the end of the level.
*True - Once the submarine docks, or is close to the last outpost and a player entered the outpost the round is automatically ended.
*'''True''' - Once the submarine docks, or is close to the last outpost and a player entered the outpost the round is automatically ended.
*False - Players must vote to end or an admin must use the endround command to manually end the round.
*'''False''' - Players must vote to end or an admin must use the <samp>endround</samp> command to manually end the round.
|-
|-
|saveserverlogs
|saveserverlogs
Line 148: Line 85:
|True/False (Bool)
|True/False (Bool)
|Sets if server logs should be saved once the server is turned off.
|Sets if server logs should be saved once the server is turned off.
*True - Server logs are saved in the ServerLogs folder upon server shutdown.
*'''True''' - Server logs are saved in the ServerLogs folder upon server shutdown.
*False - Server logs aren't saved.
*'''False''' - Server logs aren't saved.
|-
|-
|allowragdollbutton
|allowragdollbutton
|True
|True
|True/False (Bool)
|True/False (Bool)
|Allows or disallows the use of the ragdoll button. (Exact key is dependant on keybind configuration)
|Allows or disallows the use of the ragdoll button. (Exact key depends on [[Barotrauma#Controls|keybind configuration]])
*True - Players can ragdoll on their own if they hold the button down.
*'''True''' - Players can ragdoll on their own if they hold the button down.
*False - Players cannot ragdoll on their own, players must be stunned (or be dead) to ragdoll.
*'''False''' - Players cannot ragdoll on their own, players must be stunned (or be dead) to ragdoll.
|-
|-
|allowfiletransfers
|allowfiletransfers
Line 162: Line 99:
|True/False (Bool)
|True/False (Bool)
|Allows or disallows file transfers for server files to clients.
|Allows or disallows file transfers for server files to clients.
'''Note: currently only .sub files can be transfered, if a client is missing a content package they won't be able to connect at all.'''
'''Note: currently only .sub files can be transferred, if a client is missing a content package they won't be able to connect at all.'''
*True - Server will send missing files to clients.
*'''True''' - Server will send missing files to clients.
*False - Server won't send missing files to clients, if a client is missing the required files they will not be able to spawn and will be kicked back into the lobby.
*'''False''' - Server won't send missing files to clients, if a client is missing the required files they will not be able to spawn and will be sent back into the lobby.
|-
|-
|voicechatenabled
|voicechatenabled
Line 170: Line 107:
|True/False (Bool)
|True/False (Bool)
|Allows or disallows the use of voicechat.
|Allows or disallows the use of voicechat.
*True - Players can use voicechat.
*'''True''' - Players can use voicechat.
*False - Players cannot use voicechat.
*'''False''' - Players cannot use voicechat.
|-
|-
|playstyle
|playstyle
|Serious
|Casual
|Serious/Casual/Roleplay/Rampage/SomethingDifferent (String)
|Serious/Casual/Roleplay/Rampage/SomethingDifferent (String)
|Sets server playstyle displayed in the server browser and lobby.
|Sets server playstyle displayed in the server browser and lobby.
*Serious - "The crew should focus on working together efficiently and completing their objective. No unnecessary messing around."
*'''Serious''' - "The crew should focus on working together efficiently and completing their objective. No unnecessary messing around."
*Casual - "Having fun is more important than completing the objective. A good choice for new players."
*'''Casual''' - "Having fun is more important than completing the objective. A good choice for new players."
*Roleplay - "The crew should aim to act like a real submarine crew. Chain of command is important, as is taking care of your responsibilities and following orders. Speaking out-of-character should be avoided when a round is running."
*'''Roleplay''' - "The crew should aim to act like a real submarine crew. Chain of command is important, as is taking care of your responsibilities and following orders. Speaking out-of-character should be avoided when a round is running."
*Rampage - "Get ready to fight for your life! A server heavily geared toward combat. This can mean player-versus-player combat, PvE or both—the server description should include guidelines as to what kind of violence is allowed on the server."
*'''Rampage''' - "Get ready to fight for your life! A server heavily geared toward combat. This can mean player-versus-player combat, PvE or both—the server description should include guidelines as to what kind of violence is allowed on the server."
*SomethingDifferent - "Gameplay differs significantly from the usual Barotrauma gameplay. Modded servers, very unconventional subs, battle royale rounds, shuttle racing, deathrun maps... Anything goes!"
*'''SomethingDifferent''' - "Gameplay differs significantly from the usual Barotrauma gameplay. Modded servers, very unconventional subs, battle royale rounds, shuttle racing, deathrun maps... Anything goes!"
|-
|-
|allowvotekick
|allowvotekick
Line 187: Line 124:
|True/False (Bool)
|True/False (Bool)
|Allows or disallows players from voting to kick other players.
|Allows or disallows players from voting to kick other players.
*True - Players can vote to kick.
*'''True''' - Players can vote to kick.
*False - Players cannot vote to kick.
*'''False''' - Players cannot vote to kick.
|-
|-
|allowendvoting
|allowendvoting
Line 194: Line 131:
|True/False (Bool)
|True/False (Bool)
|Allows or disallows players from voting to end the round.
|Allows or disallows players from voting to end the round.
*True - Players can vote to end the round.
*'''True''' - Players can vote to end the round.
*False - Players cannot vote to end the round, the tickbox also doesn't appear at all.
*'''False''' - Players cannot vote to end the round, the tick box also doesn't appear at all.
|-
|-
|allowrespawn
|allowrespawn
Line 201: Line 138:
|True/False (Bool)
|True/False (Bool)
|Allows or disallows respawning.
|Allows or disallows respawning.
*True - Players can respawn once dead.
*'''True''' - Players can respawn once dead.
*False - Players cannot respawn and will have to spectate until the round ends.
*'''False''' - Players cannot respawn and will have to spectate until the round ends.
|-
|-
|botcount
|botcount
Line 218: Line 155:
|Normal/Fill (String)
|Normal/Fill (String)
|Sets how bots should be spawned.
|Sets how bots should be spawned.
*Normal - Bots fill the amount of slots set in botcount.
*'''Normal''' - Bots fill the amount of slots set in botcount.
*Fill - Bots skip the botcount value and fill the maximum amount of set slots.
*'''Fill''' - Bots skip the botcount value and fully fill the rest of the empty player slots.
|-
|-
|allowdisguises
|allowdisguises
Line 225: Line 162:
|True/False (Bool)
|True/False (Bool)
|Allows or disallows players to disguise themselves.
|Allows or disallows players to disguise themselves.
*True - Players can disguise themselves by using another player's id card.
*'''True''' - Players can disguise themselves by using another player's [[id card]].
*False - Players cannot disguise themselves and will always have their names above them even when covering their face.
*'''False''' - Players cannot disguise themselves and will always have their names above them even when covering their face.
|-
|-
|allowrewiring
|allowrewiring
Line 232: Line 169:
|True/False (Bool)
|True/False (Bool)
|Allows or disallows players from rewiring anything.
|Allows or disallows players from rewiring anything.
*True - Players can rewire anything except if it has been set otherwise in the submarine.
*'''True''' - Players can rewire anything except if it has been set otherwise in the submarine.
*False - Players cannot rewire anything in a submarine.
*'''False''' - Players cannot rewire anything in a submarine.
|-
|-
|allowfriendlyfire
|allowfriendlyfire
Line 239: Line 176:
|True/False (Bool)
|True/False (Bool)
|Allows or disallows friendly fire between players.
|Allows or disallows friendly fire between players.
*True - Players can deal damage to eachother.
*'''True''' - Players can deal damage to each other.
*False - Players don't deal damage to eachother.
*'''False''' - Players don't deal damage to each other.
|-
 
|banafterwrongpassword
|True
|True/False (Bool)
|Enables or disables auto-banning after too many failed password retries.
*'''True''' - Players are auto-banned after exceeding max password retries, set in maxpasswordretriesbeforeban.
*'''False''' - Players can't be auto-banned for too many password retries.
|-
|maxpasswordretriesbeforeban
|3
|0< (Int)
|Sets after how many failed password retries the player is auto-banned.
'''Only works if "banafterwrongpassword" is set to True.'''
|-
|-
|selectedsubmarine
|selectedsubmarine
|N/A (Alphabetically picks first submarine)
|N/A (Alphabetically picks first submarine)
Line 256: Line 208:
|Yes/No/Maybe (String)
|Yes/No/Maybe (String)
|Sets the chance of traitors appearing in a round.
|Sets the chance of traitors appearing in a round.
*Yes - Traitors definitely appear in a round.
*'''Yes''' - Traitors definitely appear in a round.
*No - Traitors do not appear in a round.
*'''No''' - Traitors do not appear in a round.
*Maybe - Traitors have a 50/50 chance of appearing a round.
*'''Maybe''' - Traitors have a 50/50 chance of appearing in a round.
|-
|-
|traitorsminplayercount
|traitorsminplayercount
Line 296: Line 248:
|Manual
|Manual
|Manual/Random/Vote (String)
|Manual/Random/Vote (String)
|Sets how a gamemode should be chosen.
|Sets how the [[Game Mode]] should be chosen.
*'''Manual''' - Only a client with the [[Permissions|SelectMode permission]] can select the gamemode.
*'''Manual''' - Only a client with the [[Permissions|SelectMode permission]] can select the game mode.
*'''Random''' - Gamemode is randomized on round start.
*'''Random''' - Game mode is randomized on round start.
*'''Vote''' - All players can vote to pick a gamemode.
*'''Vote''' - All players can vote to pick a game mode.
|-
|-
|endvoterequiredratio
|endvoterequiredratio
Line 305: Line 257:
|0.0-1.0 (Float)
|0.0-1.0 (Float)
|Sets amount of endround votes required to end the round.
|Sets amount of endround votes required to end the round.
'''Only works if "allowendvoting" is set to True.'''
'''Only used if "allowendvoting" is set to True.'''
|-
|-
|kickvoterequiredratio
|kickvoterequiredratio
Line 311: Line 263:
|0.0-1.0 (Float)
|0.0-1.0 (Float)
|Sets amount of votekick votes required to kick a player.
|Sets amount of votekick votes required to kick a player.
'''Only works if "allowvotekick" is set to True.'''
'''Only used if "allowvotekick" is set to True.'''
|-
|-
|killdisconnectedtime
|killdisconnectedtime
|30
|120
|0< (Float)
|0< (Float)
|Sets amount of time a player must be disconnected from their body for the character to be killed.
|Sets amount of time a player must be disconnected from their body for the character to be killed.
Line 337: Line 289:
|sandbox
|sandbox
|Sandbox/Mission/Campaign (String)
|Sandbox/Mission/Campaign (String)
|Sets gamemode
|Sets game mode
|-
|-
|missiontype
|missiontype
Line 347: Line 299:
|3600
|3600
|0< (Float)
|0< (Float)
|Sets ban length for players who are votekicked, in seconds.
|Sets ban length for players who are vote-kicked, in seconds.
|-
|-
|maxautobantime
|maxautobantime
|86400
|86400
|0< (Float)
|0< (Float)
|Sets maximum autoban length that can be set in the lobby host UI.
|Sets maximum auto-ban length that can be set in the lobby host UI.
|-
|-
|name
|name
Line 392: Line 344:
'''Note: Not all routers support UPnP'''
'''Note: Not all routers support UPnP'''


'''This is also unnecessary if hosting from a client (not dedicated server), as client-hosting uses Steam matchmaking for connections.'''
'''This is also unnecessary if hosting from a client (not dedicated server), as client-hosting uses Steam P2P for connections.'''
|-
|-
|autorestart
|autorestart
|false
|false
|True/False (Bool)
|True/False (Bool)
|Allows or disallows the server from autostarting rounds in the lobby.
|Allows or disallows the server from auto-starting rounds in the lobby.
*'''True''' - Server autorestarts rounds after the interval passes.
*'''True''' - Server auto-restarts rounds after the interval passes.
*'''False''' - Server doesn't autorestart rounds, rounds must be started in another way (Players ready-ing up/manually starting).
*'''False''' - Server doesn't auto-restart rounds, rounds must be started in another way (Players readying up/manually starting).
Uses time set in '''autorestartinterval'''.
Uses time set in '''autorestartinterval'''.
|-
|-
Line 420: Line 372:
|
|
|String
|String
|Sets the text displayed in the server's info box.
|Sets the text displayed in the server's info box. Due to technical limtations, dedicated servers have maximum of 128 characters displayed in Server Browser, however upon joining info box is fully intact. This constraint doesn't affect client-hosted servers.
|-
|-
|Password
|Password
|'''By default doesn't appear in the config file.'''
|
|String
|String
|Sets password required to enter the server.
|Sets password required to enter the server.
|-
|-
|}
|}
[[Category:Server Hosting]]
 
==Default==
Default settings for new game installs.
<pre>
<?xml version="1.0" encoding="utf-8"?>
<serversettings
name="Server"
public="false"
port="27015"
queryport="27016"
password=""
enableupnp="false"
autorestart="false"
LevelDifficulty="20"
ServerMessage=""
AllowedRandomMissionTypes="Salvage,Monster,Cargo,Combat,All"
AllowedClientNameChars="32-33,38-46,48-57,65-90,91-91,93-93,95-122,192-255,384-591,1024-1279,19968-40959,13312-19903,131072-15043983,15043985-173791,173824-178207,178208-183983,63744-64255,194560-195103"
tickrate="20"
randomizeseed="True"
userespawnshuttle="True"
respawninterval="300"
maxtransporttime="180"
minrespawnratio="0.2"
autorestartinterval="60"
startwhenclientsready="False"
startwhenclientsreadyratio="0.8"
allowspectating="True"
endroundatlevelend="True"
saveserverlogs="True"
allowragdollbutton="True"
allowfiletransfers="True"
voicechatenabled="True"
playstyle="Casual"
allowvotekick="True"
allowendvoting="True"
allowrespawn="True"
botcount="0"
maxbotcount="16"
botspawnmode="Normal"
allowdisguises="True"
allowrewiring="True"
allowfriendlyfire="True"
banafterwrongpassword="True"
maxpasswordretriesbeforeban="3"
traitorsenabled="No"
traitorsminplayercount="1"
traitorsminstartdelay="90"
traitorsmaxstartdelay="180"
traitorsminrestartdelay="30"
traitorsmaxrestartdelay="90"
subselectionmode="Manual"
modeselectionmode="Manual"
endvoterequiredratio="0.6"
kickvoterequiredratio="0.6"
killdisconnectedtime="120"
kickafktime="120"
karmaenabled="False"
karmapreset="default"
gamemodeidentifier="sandbox"
missiontype="All"
maxplayers="10"
autobantime="3600"
maxautobantime="86400" />
</pre>
 
 
{{Guides nav}}
[[Category:Server Files]]

Latest revision as of 02:03, 15 February 2024

serversettings.xml is a file that stores all the settings for the Barotrauma dedicated and client-hosted server.

It is located in the Barotrauma root directory (same place as the Barotrauma.exe).


Configuration Fields

Config Field Default Value Allowed Values Description
tickrate 20 0< (Int) Sets the server's tickrate.
randomizeseed True True/False (Bool) Sets if the server should generate a new seed each round.
  • True - Server randomizes seed when starting a new round.
  • False - Server doesn't randomize seed, uses the same seed set in the lobby.
userespawnshuttle True True/False (Bool) Allows or disallows the use of a respawn shuttle for respawning.

Only works if respawning is allowed.

  • True - Uses respawn shuttle, respawning players spawn in a shuttle a distance from the main submarine and must dock or otherwise merge with the crew.
  • False - Doesn't use respawn shuttle, players are spawned in the submarine on certain job spawnpoints, depending on their job.
respawninterval 300 0< (Int) Sets time between each respawn wave, in seconds.
maxtransporttime 180 0< (Int) Sets maximum time the respawn shuttle has to dock to the submarine, in seconds.

If time runs out before the shuttle docks it will automatically return to the first outpost.

minrespawnratio 0.2 0.0-1.0 (Float) Sets minimum percentage of dead players required for the respawn timer to start.
autorestartinterval 60 0< (Float) Sets time for automatic starting of a round, in seconds.

Only works if "autorestart" is set to True.

startwhenclientsready False True/False (Bool) Allows or disallows the server to automatically start a round if enough players are ready.
  • True - Starts automatically if the set client ratio is met.
  • False - Ignores ready clients, must be manually started.
startwhenclientsreadyratio 0.8 0.0-1.0 (Float) Sets minimum ratio of players required to be ready for a round to be automatically started.

Only works if "startwhenclientsready" is set to True.

allowspectating True True/False (Bool) Allows or disallows players from spectating.
  • True - Dead players can spectate.
  • False - Dead players cannot spectate and are sent into the lobby.
endroundatlevelend True True/False (Bool) Sets if the round should be ended once the submarine reaches the end of the level.
  • True - Once the submarine docks, or is close to the last outpost and a player entered the outpost the round is automatically ended.
  • False - Players must vote to end or an admin must use the endround command to manually end the round.
saveserverlogs True True/False (Bool) Sets if server logs should be saved once the server is turned off.
  • True - Server logs are saved in the ServerLogs folder upon server shutdown.
  • False - Server logs aren't saved.
allowragdollbutton True True/False (Bool) Allows or disallows the use of the ragdoll button. (Exact key depends on keybind configuration)
  • True - Players can ragdoll on their own if they hold the button down.
  • False - Players cannot ragdoll on their own, players must be stunned (or be dead) to ragdoll.
allowfiletransfers True True/False (Bool) Allows or disallows file transfers for server files to clients.

Note: currently only .sub files can be transferred, if a client is missing a content package they won't be able to connect at all.

  • True - Server will send missing files to clients.
  • False - Server won't send missing files to clients, if a client is missing the required files they will not be able to spawn and will be sent back into the lobby.
voicechatenabled True True/False (Bool) Allows or disallows the use of voicechat.
  • True - Players can use voicechat.
  • False - Players cannot use voicechat.
playstyle Casual Serious/Casual/Roleplay/Rampage/SomethingDifferent (String) Sets server playstyle displayed in the server browser and lobby.
  • Serious - "The crew should focus on working together efficiently and completing their objective. No unnecessary messing around."
  • Casual - "Having fun is more important than completing the objective. A good choice for new players."
  • Roleplay - "The crew should aim to act like a real submarine crew. Chain of command is important, as is taking care of your responsibilities and following orders. Speaking out-of-character should be avoided when a round is running."
  • Rampage - "Get ready to fight for your life! A server heavily geared toward combat. This can mean player-versus-player combat, PvE or both—the server description should include guidelines as to what kind of violence is allowed on the server."
  • SomethingDifferent - "Gameplay differs significantly from the usual Barotrauma gameplay. Modded servers, very unconventional subs, battle royale rounds, shuttle racing, deathrun maps... Anything goes!"
allowvotekick True True/False (Bool) Allows or disallows players from voting to kick other players.
  • True - Players can vote to kick.
  • False - Players cannot vote to kick.
allowendvoting True True/False (Bool) Allows or disallows players from voting to end the round.
  • True - Players can vote to end the round.
  • False - Players cannot vote to end the round, the tick box also doesn't appear at all.
allowrespawn True True/False (Bool) Allows or disallows respawning.
  • True - Players can respawn once dead.
  • False - Players cannot respawn and will have to spectate until the round ends.
botcount 0 0-maxbotcount (Int) Sets number of bots that should be spawned in a round.
maxbotcount 16 0-16 (Int) Sets maximum allowed bots in a round.
botspawnmode Normal Normal/Fill (String) Sets how bots should be spawned.
  • Normal - Bots fill the amount of slots set in botcount.
  • Fill - Bots skip the botcount value and fully fill the rest of the empty player slots.
allowdisguises True True/False (Bool) Allows or disallows players to disguise themselves.
  • True - Players can disguise themselves by using another player's id card.
  • False - Players cannot disguise themselves and will always have their names above them even when covering their face.
allowrewiring True True/False (Bool) Allows or disallows players from rewiring anything.
  • True - Players can rewire anything except if it has been set otherwise in the submarine.
  • False - Players cannot rewire anything in a submarine.
allowfriendlyfire True True/False (Bool) Allows or disallows friendly fire between players.
  • True - Players can deal damage to each other.
  • False - Players don't deal damage to each other.
banafterwrongpassword True True/False (Bool) Enables or disables auto-banning after too many failed password retries.
  • True - Players are auto-banned after exceeding max password retries, set in maxpasswordretriesbeforeban.
  • False - Players can't be auto-banned for too many password retries.
maxpasswordretriesbeforeban 3 0< (Int) Sets after how many failed password retries the player is auto-banned.

Only works if "banafterwrongpassword" is set to True.

selectedsubmarine N/A (Alphabetically picks first submarine) String Sets submarine that will be used in a round.
selectedshuttle N/A (Alphabetically picks first shuttle) String Sets respawn shuttle that will be used in a round.
traitorsenabled No Yes/No/Maybe (String) Sets the chance of traitors appearing in a round.
  • Yes - Traitors definitely appear in a round.
  • No - Traitors do not appear in a round.
  • Maybe - Traitors have a 50/50 chance of appearing in a round.
traitorsminplayercount 1 0< (Int) Sets minimum number of players required for a traitor to be picked.
traitorsminstartdelay 90 0< (Float) Sets minimum amount of time that must pass before a traitor is selected, in seconds.
traitorsmaxstartdelay 180 0< (Float) Sets maximum amount of time that must pass before a traitor is selected, in seconds.
traitorsminrestartdelay 30 0< (Float) Sets minimum amount of time that must pass before another traitor is selected, in seconds.
traitorsmaxrestartdelay 90 0< (Float) Sets maximum amount of time that must pass before another traitor is selected, in seconds.
subselectionmode Manual Manual/Random/Vote (String) Sets how the next submarine should be picked.
  • Manual - Only a client with the SelectSub permission can select a submarine.
  • Random - Submarine is randomly picked on round start.
  • Vote - All players can vote for a submarine.
modeselectionmode Manual Manual/Random/Vote (String) Sets how the Game Mode should be chosen.
  • Manual - Only a client with the SelectMode permission can select the game mode.
  • Random - Game mode is randomized on round start.
  • Vote - All players can vote to pick a game mode.
endvoterequiredratio 0.6 0.0-1.0 (Float) Sets amount of endround votes required to end the round.

Only used if "allowendvoting" is set to True.

kickvoterequiredratio 0.6 0.0-1.0 (Float) Sets amount of votekick votes required to kick a player.

Only used if "allowvotekick" is set to True.

killdisconnectedtime 120 0< (Float) Sets amount of time a player must be disconnected from their body for the character to be killed.
kickafktime 120 0< (Float) Sets amount of time a player must be AFK to be auto-kicked.
karmaenabled False True/False (Bool) Enables or disables the Karma system.
karmapreset default default/strict/custom (String) Sets the karma rules preset that should be used.

Only works if "karmaenabled" is set to True.

gamemodeidentifier sandbox Sandbox/Mission/Campaign (String) Sets game mode
missiontype All Salvage/Monster/Cargo/Combat/All (String) Sets mission types that the server should run, if multiple are selected the server randomly chooses one. All includes all.
autobantime 3600 0< (Float) Sets ban length for players who are vote-kicked, in seconds.
maxautobantime 86400 0< (Float) Sets maximum auto-ban length that can be set in the lobby host UI.
name Server String Sets server name.
public false True/False (Bool) Sets if the server should be shown in the server browser.
  • True - Server is visible in the server browser.
  • False - Server isn't visible in the server browser.

Note: Even if the server isn't public any player can still connect to it unless it has a whitelist or password.

port 27015 Valid port (Int) Sets server's port for player connections.

Port must be port-forwarded for the server to be connectable and visible in the server browser.

queryport 27016 Valid port (Int) Sets server's port for querying with steam for connections.

Port must be port-forwarded for the server to be connectable and visible in the server browser.

maxplayers 10 1-16 (Int) Sets max players.
enableupnp false True/False (Bool) Sets if the server should attempt to use UPnP to allow players to connect (instead of port-forwarding).
  • True - Server attempts UPnP.
  • False - Server doesn't attempt UPnP.

Note: Not all routers support UPnP

This is also unnecessary if hosting from a client (not dedicated server), as client-hosting uses Steam P2P for connections.

autorestart false True/False (Bool) Allows or disallows the server from auto-starting rounds in the lobby.
  • True - Server auto-restarts rounds after the interval passes.
  • False - Server doesn't auto-restart rounds, rounds must be started in another way (Players readying up/manually starting).

Uses time set in autorestartinterval.

LevelDifficulty 20 0-100 (Int) Sets level difficulty.
AllowedRandomMissionTypes Salvage,Monster,Cargo,Combat,All Deprecated, missiontype is able to randomize now. N/A
AllowedClientNameChars 32-33,38-46,48-57,65-90,91-91,93-93,95-122,192-255,384-591,1024-1279,19968-40959,13312-19903,
131072-15043983,15043985-173791,173824-178207,178208-183983,63744-64255,194560-195103
UTF-16 character code ranges (Int) Sets characters that are allowed in player's names.
ServerMessage String Sets the text displayed in the server's info box. Due to technical limtations, dedicated servers have maximum of 128 characters displayed in Server Browser, however upon joining info box is fully intact. This constraint doesn't affect client-hosted servers.
Password String Sets password required to enter the server.

Default

Default settings for new game installs.

<?xml version="1.0" encoding="utf-8"?>
<serversettings
name="Server"
public="false"
port="27015"
queryport="27016"
password=""
enableupnp="false"
autorestart="false"
LevelDifficulty="20"
ServerMessage=""
AllowedRandomMissionTypes="Salvage,Monster,Cargo,Combat,All"
AllowedClientNameChars="32-33,38-46,48-57,65-90,91-91,93-93,95-122,192-255,384-591,1024-1279,19968-40959,13312-19903,131072-15043983,15043985-173791,173824-178207,178208-183983,63744-64255,194560-195103"
tickrate="20"
randomizeseed="True"
userespawnshuttle="True"
respawninterval="300"
maxtransporttime="180"
minrespawnratio="0.2"
autorestartinterval="60"
startwhenclientsready="False"
startwhenclientsreadyratio="0.8"
allowspectating="True"
endroundatlevelend="True"
saveserverlogs="True"
allowragdollbutton="True"
allowfiletransfers="True"
voicechatenabled="True"
playstyle="Casual"
allowvotekick="True"
allowendvoting="True"
allowrespawn="True"
botcount="0"
maxbotcount="16"
botspawnmode="Normal"
allowdisguises="True"
allowrewiring="True"
allowfriendlyfire="True"
banafterwrongpassword="True"
maxpasswordretriesbeforeban="3"
traitorsenabled="No"
traitorsminplayercount="1"
traitorsminstartdelay="90"
traitorsmaxstartdelay="180"
traitorsminrestartdelay="30"
traitorsmaxrestartdelay="90"
subselectionmode="Manual"
modeselectionmode="Manual"
endvoterequiredratio="0.6"
kickvoterequiredratio="0.6"
killdisconnectedtime="120"
kickafktime="120"
karmaenabled="False"
karmapreset="default"
gamemodeidentifier="sandbox"
missiontype="All"
maxplayers="10"
autobantime="3600"
maxautobantime="86400" />
v·d·e·h
Guides
Gameplay
Hosting
In-Game Dedicated Servers

Campaign Settings

Karma

Permissions

Console Commands

Hosting a Dedicated Server

List of Config Files

Enabling Mods on a Dedicated Server

Tools & Modding
Editors XML Other

Submarine Editor

Official Guide to the Submarine Editor (Diving deeper)

Character Editor

Official Guide to the Character Editor

Creating mods

XML and how Barotrauma uses it

Content packages (Content types)

Overrides

Installing mods

Publishing to Steam Workshop

Troubleshooting