Serversettings.xml
![]() |
Data is potentially outdated |
Last updated for an unknown version The current game version is 1.7.7.0 Stub Notes: Missing many attributes, has legacy attributes, attributes are in the wrong order. |
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 |
---|---|---|---|
name | Server | String | Sets server name. |
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. |
password | String | Sets password required to enter the server. Leave blank for no password. | |
enableupnp | false | True/False (Bool) | Sets if the server should attempt to use UPnP to allow players to connect (instead of port-forwarding).
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. |
HiddenSubs | String | Hides selected submarines in the lobby, can be changed in the lobby. | |
ServerMessage | String | Sets the text displayed in the server's description.
Also sets Message of the Day presented in chat upon joining. Due to technical limtations, dedicated servers have maximum of 128 characters displayed in Server Browser, however upon joining description is fully intact. This constraint doesn't affect client-hosted servers. | |
AllowedRandomMissionTypes | AbandonedOutpost,Beacon,Cargo,ClearAlienRuins,EliminateTargets,Escort,KingOfTheHull,Mineral, Monster,Nest,OutpostCombat,OutpostDestroy,Pirate,SalvageCave,SalvageRuin,SalvageWreck, ScanAlienRuins,SubVsSubCombat,jailbreak |
Deprecated, missiontype is able to randomize now. | |
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. |
ServerName | String | Server name.
Edit name field instead. This field's value is duplicated from name field, therefore any changes made to this value won't apply. | |
ServerMessageText | String | Server description/MOTD.
Edit ServerMessage field instead. This field's value is duplicated from ServerMessage field, therefore any changes made to this value won't apply. | |
IsPublic | True | True/False (Bool) | Sets if the server should be visible in Server Browser. Can be changed in the lobby settings.
Note: players can still join private sessions if these are unprotected by a password/whitelist.
|
TickRate | 20 | >0 (Int) | Sets the server's tickrate. |
MaxLagCompensation | 150 | >0 (Int) | The maximum time that the server will compensate hitscan weapons. The server attempts to do do the shot when the client fired the shot, rather than when the server received the message that the client shot. |
RequireAuthentication | True | True/False (Bool) | Enables player authentication via Steam services. |
RandomizeSeed | True | True/False (Bool) | Sets if the server should generate a new seed each round.
|
UseRespawnShuttle | True | True/False (Bool) | Allows or disallows the use of a respawn shuttle for respawning.
Only works if respawning is allowed.
|
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. |
SkillLossPercentageOnDeath | 20 | 0-100 (Int) | Sets skill loss percentage on death. |
SkillLossPercentageOnImmediateRespawn | 10 | 0-100 (Int) | Sets additional skill loss percentage for immediate respawn. |
ReplaceCostPercentage | 100 | 0-100 (Int) | Permadeath specific
Modifies the cost of respawning as a new character at the HR manager. If set to zero - characters are free and no extra permissions are needed to buy them. |
AllowBotTakeoverOnPermadeath | True | True/False (Bool) | Permadeath specific
If enabled - players can take over existing bots instead of having to buy a new character. |
IronmanMode | False | True/False (Bool) | Permadeath specific
Removes all respawn options: once a player dies, they can only spectate. |
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.
|
PvPTeamSelectionMode | PlayerPreference | PlayerPreference/PlayerChoice (String) | PvP gamemode specific
Team selection preferences per player.
|
PvpAutoBalanceThreshold | 1 | 0-3 (Int) | PvP gamemode specific
Auto-balance threshold for teams. Will reset to 0 if the value is invalid.
|
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. |
PvPStunResist | 0 | 0-100 (Int) | PvP gamemode specific
Sets the amount of Stun resistance for players. |
PvPSpawnMonsters | False | True/False (Bool) | PvP gamemode specific
Allows monsters to spawn on the map. Mostly useful in KOTH/Sub vs. Sub mission types. |
PvPSpawnWrecks | True | True/False (Bool) | PvP gamemode specific
Allows wrecks to spawn on the map. Mostly useful in KOTH/Sub vs. Sub mission types. |
Biome | Random | coldcaverns/europanridge/theaphoticplateau/thegreatsea/hydrothermalwastes (String) | Sets the preferred biome. Applies to every gamemode except for Campaign.
Note: Outpost Deathmatch mission type from PvP gamemode is unaffected by this setting. |
SelectedOutpostName | Random | String | PvP gamemode specific
Sets the outpost for Outpost Deathmatch mission type. Unavailable if Outpost Deathmatch is not chosen. |
AllowSpectating | True | True/False (Bool) | Allows or disallows players from spectating.
|
SaveServerLogs | True | True/False (Bool) | Sets if server logs should be saved once the server is turned off.
|
AllowModDownloads | True | True/False (Bool) | Allows or disallows download of missing mods from the server.
Note: if disabled and if server/client has outdated mods, or if server has local mods not present on the client - players won't be able to join the server, since they can't fulfill the requirements.
|
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.
|
VoiceChatEnabled | True | True/False (Bool) | Allows or disallows the use of voicechat.
|
Playstyle | Casual | Serious/Casual/Roleplay/Rampage/SomethingDifferent (String) | Sets server playstyle displayed in the server browser and lobby.
|
LosMode | Transparent | Transparent/Opaque/None (String) | Line of sight mode.
|
ShowEnemyHealthBar | ShowAll | ShowAll/BossHealthBarsOnly/HideAll (String) | Sets if enemy healthbars should be visible.
|
LinesPerLogFile | 800 | >0 (Int) | Maximum length of logfile. |
AutoRestart | false | True/False (Bool) | Allows or disallows the server from auto-starting rounds in the lobby.
Uses time set in AutoRestartInterval. |
AllowVoteKick | True | True/False (Bool) | Allows or disallows players from voting to kick other players.
|
AllowEndVoting | True | True/False (Bool) | Allows or disallows players from voting to end the round.
|
RespawnMode | MidRound | MidRound/BetweenRounds/Permadeath (String) | Sets the respawn mode for players.
|
BotCount | 0 | >0 (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.
|
DisableBotConversations | False | True/False (Bool) | Disables bots from filling the text chat with their flavor dialogue, like random quotes. This setting does not affect callouts, like crying for help. |
SelectedLevelDifficulty | 0 | 0-100 (Int) | Sets the difficulty for the mission. Not configurable during Campaign as it follows a pre-defined difficulty curve. |
AllowDisguises | True | True/False (Bool) | Allows or disallows players to disguise themselves.
|
AllowRewiring | True | True/False (Bool) | Allows or disallows players from rewiring anything.
|
AllowImmediateItemDelivery | True | True/False (Bool) | Enables option of direct item delivery to player's inventory during a purchase. |
LockAllDefaultWires | False | True/False (Bool) | Locks all default connections on a submarine if True. |
AllowLinkingWifiToChat | False | True/False (Bool) | Allows linking wifi signals to chat if True. |
AllowFriendlyFire | True | True/False (Bool) | Allows or disallows friendly fire between players.
|
AllowDragAndDropGive | True | True/False (Bool) | Allows giving items to another player/bot's inventory by dragging and dropping the item on the character. |
DestructableOutposts | False | True/False (Bool) | Allows outposts to be destructible. This setting does not affect Abandoned Outposts, as they're always destructible. |
KillableNPCs | True | True/False (Bool) | Makes NPCs killable if True. |
BanAfterWrongPassword | True | True/False (Bool) | Enables or disables auto-banning after too many failed 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. |
EnableDoSProtection | True | True/False (Bool) | Enables DoS protection, this will kick players who send more packets than specified in MaxPacketAmount. |
MaxPacketAmount | 4000 | >0 (Int) | Sets the maximum amount of packets a player(client) might send before they are regarded as spamming/DoS attempt, one might want to increase this amount when playing with many mods, increasing may cause networking issues, can be changed in the lobby settings |
SelectedSubmarine | Azimuth (Alphabetically picks first submarine) | String | Sets submarine that will be used in a round. |
SelectedShuttle | Hemulen (Alphabetically picks first shuttle) | String | Sets respawn shuttle that will be used in a round. Transports reinforcements. |
TraitorProbability | 0 | 0-100 (Int) | Traitor mode specific
Sets the traitor probability during a new round. If set to 0 - Traitor mode is disabled. |
TraitorDangerLevel | 1 | 1-3 (Int) | Traitor mode specific
Enables more dangerous traitor tasks depending on chosen danger level.
|
TraitorsMinPlayerCount | 1 | 0< (Int) | Traitor mode specific
Sets the minimal number of players required for a traitor to be picked. |
MinPercentageOfPlayersForTraitorAccusation | 50 | 0-100 (Int) | Traitor mode specific
Sets the voting threshold for traitor accusation. If player exceeds the value, they will be accused of being a traitor at the end of a round. |
Language | English | String | Language the game is shown as. |
SubSelectionMode | Manual | Manual/Random/Vote (String) | Sets how the next submarine should be picked.
|
ModeSelectionMode | Manual | Manual/Random/Vote (String) | Sets how the Game Mode should be chosen.
|
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. |
VoteTimeout | 30 | >0 (Int) | Time to vote before it runs out. |
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. |
DespawnDisconnectedPermadeathTime | 10 | >0 (Float) | Permadeath specific
Sets amount of time a player must be disconnected from their body for the character to be despawned. |
KickAFKTime | 120 | >0 (Float) | Sets amount of time a player must be AFK to be auto-kicked. |
MinimumRoundSyncTimeout | 10 | >0 (Float) | Sets amount of time a player must be in desync with the server to be auto-kicked. |
KarmaEnabled | True | 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/pvp (String) | Sets current gamemode. |
MissionTypes | AbandonedOutpost,Beacon,Cargo,ClearAlienRuins,EliminateTargets,Escort,KingOfTheHull,Mineral, Monster,Nest,OutpostCombat,OutpostDestroy,Pirate,SalvageCave,SalvageRuin,SalvageWreck, ScanAlienRuins,SubVsSubCombat,jailbreak" |
(String) | Sets mission types that the server should run, if multiple are selected the server randomly chooses one. |
MaxPlayers | 8 | 1-16 (Int) | Sets the maximum amount of people who can join the server, can be changed in the main menu when hosting |
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. |
LootedMoneyDestination | Bank | Bank/Wallet (String) | Decides wether looted money goes to bank or the player's wallet. |
MaximumMoneyTransferRequest | 999999 | 0< (Int) | Sets the maximum amount of money that may be transfered at once. |
NewCampaignDefaultSalary | 0 | 0-100 (Int) | Sets the default salary for new players. |
TrackOpponentInPvP | True | True/False (Bool) | PvP gamemode specific
STUB |
DisembarkPointAllowance | 7 | STUB | PvP gamemode specific
STUB |
SelectedCoalitionPerks | engineeringshiprepair;armorysmall;airlockbasic;medbayfirstaid;hullupgradestee | STUB | PvP gamemode specific
STUB |
WinScorePvP | 200 | 0-1000 (Int) | PvP gamemode specific
Sets the amount of points that a team needs to score in order to win. |
SelectedSeparatistsPerks | engineeringshiprepair;armorysmall;airlockbasic;medbayfirstaid;hullupgradestee | STUB | STUB |
DisabledMonsters | STUB | STUB | |
PresetName | Normal | Custom/Easy/Normal/Hard/Abyssal | Campaign gamemode specific
Loads the selected campaign difficulty preset when starting campaign. |
TutorialEnabled | True | True/False (Bool) | STUB |
RadiationEnabled | False | True/False (Bool) | Campaign gamemode specific
Enables Jovian radiation in campaign. |
MaxMissionCount | 2 | 0-10 (Int) | Campaign gamemode specific
Limits the number of missions one may take for a route between two stations, beacons are not counted. |
WorldHostility | Medium | Low/Medium/High | Campaign gamemode specific
Affects how dangerous Europa is. Higher hostility means more numerous or tougher enemies, more environmental hazards and new challenging mechanics, such as untreated wounds getting infected. More information can be found in Campaign Settings page. |
StartItemSet | normal | STUB | Campaign gamemode specific
Selects the amount of starting items, additional items may be added to the submarine in the lobby settings. |
StartingBalanceAmount | Medium | Low/Medium/High (String) | Campaign gamemode specific
Starting funds of the campaign. |
CrewVitalityMultiplier | 1 | >0 (Float) | Campaign gamemode specific
Multiplies base Vitality of crew characters by the value. |
NonCrewVitalityMultiplier | 1 | >0 (Float) | Campaign gamemode specific
Multiplies base Vitality of non-crew characters, like monsters, by the value. |
OxygenMultiplier | 1 | STUB | Campaign gamemode specific
STUB |
FuelMultiplier | 1 | STUB | Campaign gamemode specific
Multiplies base Fuel Rod durability by the value |
MissionRewardMultiplier | 1 | STUB | Campaign gamemode specific
Multiplies base mission credit reward by the value. |
ExperienceRewardMultiplier | 1 | STUB | Campaign gamemode specific
Multiplies base mission experience reward by the value. |
ShopPriceMultiplier | 1 | STUB | Campaign gamemode specific
Multiplies base purchase price of items in stores by the value. |
ShipyardPriceMultiplier | 1 | STUB | Campaign gamemode specific
Multiplies base purchase price of upgrades/submarines in the shipyard by the value. |
RepairFailMulitplier | 1 | STUB | Campaign gamemode specific
Multiplies base damage values of unsuccessful repair of electrical devices by the value. |
ShowHuskWarning | True | True/False (Bool) | Campaign gamemode specific
Allows players to see warning messages in the center of their screen if their Husk Infection exceeded certain affliction strength. Note: This setting does not affect the visiblity of the affliction on Health GUI. |
PatdownProbability | Medium | Low/Medium/High/Off (String) | Campaign gamemode specific
Modifies how likely outpost security officers are to inspect crewmembers for stolen items. These patdowns can also be turned off entirely. |
EndRoundAtLevelEnd | True | True/False (Bool) | Sets if the round should be ended once the submarine reaches the end of the level.
Note: likely legacy. |
AllowRagdollButton | True | True/False (Bool) | Deprecated.
Allows or disallows the use of the ragdoll button. (Exact key depends on keybind configuration)
|
AllowRespawn | True | True/False (Bool) | Deprecated, use RespawnMode instead.
Allows or disallows respawning.
|
TraitorsEnabled | No | Yes/No/Maybe (String) | Deprecated, use TraitorProbability instead.
Sets the chance of traitors appearing in a round.
|
TraitorsMinStartDelay | 90 | 0< (Float) | Deprecated.
Sets minimum amount of time that must pass before a traitor is selected, in seconds. |
TraitorsMaxStartDelay | 180 | 0< (Float) | Deprecated.
Sets maximum amount of time that must pass before a traitor is selected, in seconds. |
TraitorsMinRestartDelay | 30 | 0< (Float) | Deprecated.
Sets minimum amount of time that must pass before another traitor is selected, in seconds. |
TraitorsMaxRestartDelay | 90 | 0< (Float) | Deprecated.
Sets maximum amount of time that must pass before another traitor is selected, in seconds. |
Public | false | True/False (Bool) | Deprecated, use IsPublic instead.
Sets if the server should be shown 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. |
LevelDifficulty | 20 | 0-100 (Int) | Deprecated, use SelectedLevelDifficulty instead.
Sets level difficulty. |
Default
Default settings for new game installs.
<?xml version="1.0" encoding="utf-8"?> <serversettings name="Server" port="27015" queryport="27016" password="" enableupnp="false" ServerMessage="" HiddenSubs="" AllowedRandomMissionTypes="AbandonedOutpost,Beacon,Cargo,ClearAlienRuins,EliminateTargets,Escort,KingOfTheHull,Mineral,Monster,Nest,OutpostCombat,OutpostDestroy,Pirate,SalvageCave,SalvageRuin,SalvageWreck,ScanAlienRuins,SubVsSubCombat,jailbreak" AllowedClientNameChars="32-33,38-46,48-57,65-90,91-91,93-93,95-122,192-255,384-591,1024-1279,4352-4607,44032-55215,19968-21327,21329-40959,13312-19903,131072-173791,173824-178207,178208-183983,63744-64255,194560-195103" ServerName="Server" ServerMessageText="" IsPublic="False" TickRate="20" MaxLagCompensation="150" RequireAuthentication="True" RandomizeSeed="True" UseRespawnShuttle="True" RespawnInterval="300" MaxTransportTime="180" MinRespawnRatio="0.2" SkillLossPercentageOnDeath="20" SkillLossPercentageOnImmediateRespawn="10" ReplaceCostPercentage="100" AllowBotTakeoverOnPermadeath="True" IronmanMode="False" AutoRestartInterval="60" StartWhenClientsReady="False" PvpTeamSelectionMode="PlayerPreference" PvpAutoBalanceThreshold="1" StartWhenClientsReadyRatio="0.8" PvPStunResist="0" PvPSpawnMonsters="False" PvPSpawnWrecks="True" Biome="Random" SelectedOutpostName="Random" AllowSpectating="True" SaveServerLogs="True" AllowModDownloads="True" AllowFileTransfers="True" VoiceChatEnabled="True" PlayStyle="Casual" LosMode="Transparent" ShowEnemyHealthBars="ShowAll" LinesPerLogFile="800" AutoRestart="False" AllowVoteKick="True" AllowEndVoting="True" RespawnMode="MidRound" BotCount="0" MaxBotCount="16" BotSpawnMode="Normal" DisableBotConversations="False" SelectedLevelDifficulty="0" AllowDisguises="True" AllowRewiring="True" AllowImmediateItemDelivery="True" LockAllDefaultWires="False" AllowLinkingWifiToChat="False" AllowFriendlyFire="True" AllowDragAndDropGive="True" DestructibleOutposts="False" KillableNPCs="True" BanAfterWrongPassword="True" MaxPasswordRetriesBeforeBan="3" EnableDoSProtection="True" MaxPacketAmount="4000" SelectedSubmarine="" SelectedShuttle="" TraitorProbability="0" TraitorDangerLevel="1" TraitorsMinPlayerCount="1" MinPercentageOfPlayersForTraitorAccusation="50" Language="English" SubSelectionMode="Manual" ModeSelectionMode="Manual" EndVoteRequiredRatio="0.6" VoteRequiredRatio="0.6" VoteTimeout="30" KickVoteRequiredRatio="0.6" DisallowKickVoteTime="120" KillDisconnectedTime="300" DespawnDisconnectedPermadeathTime="10" KickAFKTime="600" MinimumMidRoundSyncTimeout="10" KarmaEnabled="False" KarmaPreset="default" GameModeIdentifier="sandbox" MissionTypes="AbandonedOutpost,Beacon,Cargo,ClearAlienRuins,EliminateTargets,Escort,KingOfTheHull,Mineral,Monster,Nest,OutpostCombat,OutpostDestroy,Pirate,SalvageCave,SalvageRuin,SalvageWreck,ScanAlienRuins,SubVsSubCombat,jailbreak" MaxPlayers="10" AutoBanTime="3600" MaxAutoBanTime="86400" LootedMoneyDestination="Bank" MaximumMoneyTransferRequest="999999" NewCampaignDefaultSalary="0" TrackOpponentInPvP="True" DisembarkPointAllowance="7" SelectedCoalitionPerks="airlockbasic;armorysmall;engineeringshiprepair;medbayfirstaid;hullupgradesteel" WinScorePvP="200" SelectedSeparatistsPerks="airlockbasic;armorysmall;engineeringshiprepair;medbayfirstaid;hullupgradesteel" DisabledMonsters=""> <campaignsettings PresetName="Normal" TutorialEnabled="True" RadiationEnabled="False" MaxMissionCount="2" WorldHostility="Medium" StartItemSet="normal" StartingBalanceAmount="Medium" CrewVitalityMultiplier="1" NonCrewVitalityMultiplier="1" OxygenMultiplier="1" FuelMultiplier="1" MissionRewardMultiplier="1" ExperienceRewardMultiplier="1" ShopPriceMultiplier="1" ShipyardPriceMultiplier="1" RepairFailMultiplier="1" ShowHuskWarning="True" PatdownProbability="Medium" /> </serversettings>
Guides | |||||
---|---|---|---|---|---|
Gameplay | |||||
Hosting | |||||
In-Game | Dedicated Servers | ||||
Tools & Modding | |||||
Editors | XML | Other | |||
XML and how Barotrauma uses it |