Barotrauma

This tutorial explains how to set up a Barotrauma server in the Cobalt dashboard.

Changing configs

Open the servers page.
Find the server you want to change settings in the table and click the first button in the actions column.
Click the stop button in the control block.

Open the files tab at the top.

`serversettings.xml`

Open the serversettings.xml file in the file editor.
Update the settings.

List of settings

This table refers to version 23799137. Some settings may not be available in earlier versions. Cobalt overrides some default values when a server is created.

Key	Type	Default	Description
`name`	string	`Server`	Sets server name.
`port`	integer	`27015`	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`	integer	`27016`	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	(blank)	Sets password required to enter the server. Leave blank for no password.
`enableupnp`	boolean	`false`	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. Also unnecessary when hosting from a client (uses Steam P2P).
`HiddenSubs`	string	(blank)	Hides selected submarines in the lobby, can be changed in the lobby.
`ServerMessage`	string	(blank)	Sets the text displayed in the server's description. Also sets Message of the Day presented in chat upon joining.
`AllowedRandomMissionTypes`	string	`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`	integer	`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`	Sets characters (UTF-16 code ranges) that are allowed in player's names.
`ServerName`	string	(blank)	Server name. Edit `name` field instead — changes to this value won't apply, it's duplicated from `name`.
`ServerMessageText`	string	(blank)	Server description/MOTD. Edit `ServerMessage` field instead — changes to this value won't apply, it's duplicated from `ServerMessage`.
`IsPublic`	boolean	`true`	Sets if the server should be visible in Server Browser. Can be changed in lobby settings. `true` - Public server, displayed on Server Browser. `false` - Private server, not visible on the list. Note: players can still join private sessions if unprotected by password/whitelist.
`TickRate`	integer	`20`	Sets the server's tickrate. Not recommended to go above default, as game already struggles with networking. Lowering may cause issues with mods.
`MaxLagCompensation`	integer	`150`	The maximum time the server will compensate hitscan weapons for.
`RequireAuthentication`	boolean	`true`	Enables player authentication via Steam services.
`RandomizeSeed`	boolean	`true`	Sets if the server should generate a new seed each round. `true` - Randomizes seed each round. `false` - Uses the same seed set in the lobby.
`UseRespawnShuttle`	boolean	`true`	Allows or disallows the use of a respawn shuttle for respawning (only if respawning is allowed). `true` - Respawning players spawn in a shuttle and must dock/merge with the crew. `false` - Players spawn on the submarine at job spawnpoints.
`RespawnInterval`	integer	`300`	Sets time between each respawn wave, in seconds.
`MaxTransportTime`	integer	`180`	Sets maximum time the respawn shuttle has to dock to the submarine, in seconds. If time runs out it returns to the first outpost.
`MinRespawnRatio`	number	`0.2`	Sets minimum percentage of dead players required for the respawn timer to start.
`SkillLossPercentageOnDeath`	integer	`20`	Sets skill loss percentage on death.
`SkillLossPercentageOnImmediateRespawn`	integer	`10`	Sets additional skill loss percentage for immediate respawn.
`ReplaceCostPercentage`	integer	`100`	Permadeath specific. Modifies the cost of respawning as a new character at the HR manager. If `0` — characters are free and no extra permissions are needed to buy them.
`AllowBotTakeoverOnPermadeath`	boolean	`true`	Permadeath specific. If enabled, players can take over existing bots instead of buying a new character.
`IronmanMode`	boolean	`false`	Permadeath specific. Removes all respawn options: once a player dies, they can only spectate.
`AutoRestartInterval`	number	`60`	Sets time for automatic starting of a round, in seconds. Only works if `AutoRestart` is `true`.
`StartWhenClientsReady`	boolean	`false`	Allows or disallows the server to automatically start a round if enough players are ready.
`PvPTeamSelectionMode`	string	`PlayerPreference`	PvP gamemode specific. `PlayerPreference` - server balances teams by preference. `PlayerChoice` - players choose freely, subject to auto-balance if enabled.
`PvpAutoBalanceThreshold`	integer	`1`	PvP gamemode specific. `0` - disable auto-balancing. `1-3` - enable and set threshold of extra players needed to trigger auto-balance. Resets to `0` if invalid.
`StartWhenClientsReadyRatio`	number	`0.8`	Sets minimum ratio of players required to be ready for auto-start. Only works if `StartWhenClientsReady` is `true`.
`PvPStunResist`	integer	`0`	PvP gamemode specific. Sets the amount of Stun resistance for players.
`PvPSpawnMonsters`	boolean	`false`	PvP gamemode specific. Allows monsters to spawn on the map. Mostly useful in KOTH/Sub vs. Sub mission types.
`PvPSpawnWrecks`	boolean	`true`	PvP gamemode specific. Allows wrecks to spawn on the map. Mostly useful in KOTH/Sub vs. Sub mission types.
`Biome`	string	`Random`	Sets the preferred biome (`coldcaverns`/`europanridge`/`theaphoticplateau`/`thegreatsea`/`hydrothermalwastes`). Applies to every gamemode except Campaign.
`SelectedOutpostName`	string	`Random`	PvP gamemode specific. Sets the outpost for Outpost Deathmatch mission type. Unavailable if that mission type isn't chosen.
`AllowSpectating`	boolean	`true`	Allows or disallows players from spectating. `true` - Dead players can spectate. `false` - Dead players are sent into the lobby.
`SaveServerLogs`	boolean	`true`	Sets if server logs should be saved once the server is turned off.
`AllowModDownloads`	boolean	`true`	Allows or disallows download of missing mods from the server. If disabled and files mismatch, players won't be able to join.
`AllowFileTransfers`	boolean	`true`	Allows or disallows file transfers for server files to clients (currently only `.sub` files). If disabled, clients missing required files can't spawn and are sent back to the lobby.
`VoiceChatEnabled`	boolean	`true`	Allows or disallows the use of voicechat.
`Playstyle`	string	`Casual`	Sets server playstyle displayed in the server browser/lobby (`Serious`/`Casual`/`Roleplay`/`Rampage`/`SomethingDifferent`).
`LosMode`	string	`Transparent`	Line of sight mode. `Transparent` - dim view through walls. `Opaque` - walls block line of sight. `None` - players see through walls.
`ShowEnemyHealthBar`	string	`ShowAll`	`ShowAll`/`BossHealthBarsOnly`/`HideAll` — sets if enemy healthbars should be visible.
`LinesPerLogFile`	integer	`800`	Maximum length of logfile.
`AutoRestart`	boolean	`false`	Allows or disallows the server from auto-starting rounds in the lobby, using time set in `AutoRestartInterval`.
`AllowVoteKick`	boolean	`true`	Allows or disallows players from voting to kick other players.
`AllowEndVoting`	boolean	`true`	Allows or disallows players from voting to end the round.
`RespawnMode`	string	`MidRound`	`MidRound` - respawn during a round. `BetweenRounds` - only at start of a new round. `Permadeath` - characters die permanently (see Permadeath settings).
`BotCount`	integer	`0`	Sets number of bots that should be spawned in a round.
`MaxBotCount`	integer	`16`	Sets maximum allowed bots in a round.
`BotSpawnMode`	string	`Normal`	`Normal` - bots fill `BotCount` slots. `Fill` - bots fully fill the rest of empty player slots.
`DisableBotConversations`	boolean	`false`	Disables bots from filling text chat with flavor dialogue (doesn't affect callouts like crying for help).
`SelectedLevelDifficulty`	integer	`0`	Sets the difficulty for the mission. Not configurable during Campaign (follows a pre-defined difficulty curve).
`AllowDisguises`	boolean	`true`	Allows or disallows players to disguise themselves using another player's id card.
`AllowRewiring`	boolean	`true`	Allows or disallows players from rewiring anything on a submarine.
`AllowImmediateItemDelivery`	boolean	`true`	Enables option of direct item delivery to a player's inventory during a purchase.
`LockAllDefaultWires`	boolean	`false`	Locks all default connections on a submarine if true.
`AllowLinkingWifiToChat`	boolean	`false`	Allows linking wifi signals to chat if true.
`AllowFriendlyFire`	boolean	`true`	Allows or disallows friendly fire between players.
`AllowDragAndDropGive`	boolean	`true`	Allows giving items to another player/bot's inventory by dragging and dropping the item on the character.
`DestructableOutposts`	boolean	`false`	Allows outposts to be destructible (doesn't affect Abandoned Outposts, always destructible).
`KillableNPCs`	boolean	`true`	Makes NPCs killable if true.
`BanAfterWrongPassword`	boolean	`true`	Enables or disables auto-banning after too many failed password retries, set in `MaxPasswordRetriesBeforeBan`.
`MaxPasswordRetriesBeforeBan`	integer	`3`	Sets after how many failed password retries the player is auto-banned. Only works if `BanAfterWrongPassword` is `true`.
`EnableDoSProtection`	boolean	`true`	Enables DoS protection, kicking players who send more packets than `MaxPacketAmount`.
`MaxPacketAmount`	integer	`4000`	Sets the maximum amount of packets a client might send before being regarded as spamming/DoS. May need increasing with many mods; increasing too much may cause networking issues.
`SelectedSubmarine`	string	`Azimuth` (alphabetically picks first submarine)	Sets submarine that will be used in a round.
`SelectedShuttle`	string	`Hemulen` (alphabetically picks first shuttle)	Sets respawn shuttle that will be used in a round.
`TraitorProbability`	integer	`0`	Traitor mode specific. Sets the traitor probability during a new round. `0` disables traitor mode.
`TraitorDangerLevel`	integer	`1`	Traitor mode specific. `1` - harmless tasks. `2` - tasks that may cause injuries/damage. `3` - tasks with high chance of injuries, damage or casualties.
`TraitorsMinPlayerCount`	integer	`1`	Traitor mode specific. Sets the minimal number of players required for a traitor to be picked.
`MinPercentageOfPlayersForTraitorAccusation`	integer	`50`	Traitor mode specific. Sets the voting threshold for traitor accusation.
`Language`	string	`English`	Language the game is shown as.
`SubSelectionMode`	string	`Manual`	`Manual` - only a client with SelectSub permission can pick. `Random` - randomized on round start. `Vote` - all players vote.
`ModeSelectionMode`	string	`Manual`	`Manual` - only a client with SelectMode permission can pick. `Random` - randomized on round start. `Vote` - all players vote.
`EndVoteRequiredRatio`	number	`0.6`	Sets amount of endround votes required to end the round. Only used if `AllowEndVoting` is `true`.
`VoteTimeout`	integer	`30`	Time to vote before it runs out.
`KickVoteRequiredRatio`	number	`0.6`	Sets amount of votekick votes required to kick a player. Only used if `AllowVoteKick` is `true`.
`KillDisconnectedTime`	number	`120`	Sets amount of time a player must be disconnected from their body for the character to be killed.
`DespawnDisconnectedPermadeathTime`	number	`10`	Permadeath specific. Sets time a player must be disconnected from their body for the character to be despawned.
`KickAFKTime`	number	`120`	Sets amount of time a player must be AFK to be auto-kicked.
`MinimumRoundSyncTimeout`	number	`10`	Sets amount of time a player must be in desync with the server to be auto-kicked.
`KarmaEnabled`	boolean	`true`	Enables or disables the Karma system.
`KarmaPreset`	string	`default`	Sets the karma rules preset (`default`/`strict`/`custom`). Only works if `KarmaEnabled` is `true`.
`GamemodeIdentifier`	string	`sandbox`	Sets current gamemode (`sandbox`/`mission`/`campaign`/`pvp`).
`MissionTypes`	string	`AbandonedOutpost,Beacon,Cargo,ClearAlienRuins,EliminateTargets,Escort,KingOfTheHull,Mineral,Monster,Nest,OutpostCombat,OutpostDestroy,Pirate,SalvageCave,SalvageRuin,SalvageWreck,ScanAlienRuins,SubVsSubCombat,jailbreak`	Sets mission types the server should run; if multiple are selected, the server randomly chooses one.
`MaxPlayers`	integer	`8`	Sets the maximum amount of people who can join the server; can be changed in the main menu when hosting.
`AutoBanTime`	number	`3600`	Sets ban length for vote-kicked players, in seconds.
`MaxAutoBanTime`	number	`86400`	Sets maximum auto-ban length settable in the lobby host UI.
`LootedMoneyDestination`	string	`Bank`	Decides whether looted money goes to bank or the player's wallet (`Bank`/`Wallet`).
`MaximumMoneyTransferRequest`	integer	`999999`	Sets the maximum amount of money that may be transferred at once.
`NewCampaignDefaultSalary`	integer	`0`	Sets the default salary for new players.
`TrackOpponentInPvP`	boolean	`true`	PvP gamemode specific. STUB.
`DisembarkPointAllowance`	STUB	`7`	PvP gamemode specific. STUB.
`SelectedCoalitionPerks`	STUB	`engineeringshiprepair;armorysmall;airlockbasic;medbayfirstaid;hullupgradestee`	PvP gamemode specific. STUB.
`WinScorePvP`	integer	`200`	PvP gamemode specific. Sets the amount of points that a team needs to score in order to win.
`SelectedSeparatistsPerks`	STUB	`engineeringshiprepair;armorysmall;airlockbasic;medbayfirstaid;hullupgradestee`	STUB.
`DisabledMonsters`	STUB	(blank)	STUB.
`PresetName`	string	`Normal`	Campaign gamemode specific. Loads the selected campaign difficulty preset (`Custom`/`Easy`/`Normal`/`Hard`/`Abyssal`) when starting campaign.
`TutorialEnabled`	boolean	`true`	STUB.
`RadiationEnabled`	boolean	`false`	Campaign gamemode specific. Enables Jovian radiation in campaign.
`MaxMissionCount`	integer	`2`	Campaign gamemode specific. Limits the number of missions one may take for a route between two stations (beacons not counted).
`WorldHostility`	string	`Medium`	Campaign gamemode specific (`Low`/`Medium`/`High`). Affects how dangerous Europa is — enemies, hazards, and new mechanics like untreated infections.
`StartItemSet`	STUB	`normal`	Campaign gamemode specific. Selects the amount of starting items.
`StartingBalanceAmount`	string	`Medium`	Campaign gamemode specific (`Low`/`Medium`/`High`). Starting funds of the campaign.
`CrewVitalityMultiplier`	number	`1`	Campaign gamemode specific. Multiplies base Vitality of crew characters.
`NonCrewVitalityMultiplier`	number	`1`	Campaign gamemode specific. Multiplies base Vitality of non-crew characters (e.g. monsters).
`OxygenMultiplier`	STUB	`1`	Campaign gamemode specific. STUB.
`FuelMultiplier`	STUB	`1`	Campaign gamemode specific. Multiplies base Fuel Rod durability.
`MissionRewardMultiplier`	STUB	`1`	Campaign gamemode specific. Multiplies base mission credit reward.
`ExperienceRewardMultiplier`	STUB	`1`	Campaign gamemode specific. Multiplies base mission experience reward.
`ShopPriceMultiplier`	STUB	`1`	Campaign gamemode specific. Multiplies base purchase price of items in stores.
`ShipyardPriceMultiplier`	STUB	`1`	Campaign gamemode specific. Multiplies base purchase price of upgrades/submarines in the shipyard.
`RepairFailMulitplier`	STUB	`1`	Campaign gamemode specific. Multiplies base damage values of unsuccessful electrical repairs.
`ShowHuskWarning`	boolean	`true`	Campaign gamemode specific. Shows a warning on screen if Husk Infection exceeds a certain strength (doesn't affect visibility on Health GUI).
`PatdownProbability`	string	`Medium`	Campaign gamemode specific (`Low`/`Medium`/`High`/`Off`). Modifies how likely outpost security is to inspect crewmembers for stolen items.
`EndRoundAtLevelEnd`	boolean	`true`	Sets if the round should be ended once the submarine reaches the end of the level. Likely legacy.
`AllowRagdollButton`	boolean	`true`	Deprecated. Allows or disallows the use of the ragdoll button.
`AllowRespawn`	boolean	`true`	Deprecated, use `RespawnMode` instead. Allows or disallows respawning.
`TraitorsEnabled`	string	`No`	Deprecated, use `TraitorProbability` instead (`Yes`/`No`/`Maybe`).
`TraitorsMinStartDelay`	number	`90`	Deprecated. Sets minimum time before a traitor is selected, in seconds.
`TraitorsMaxStartDelay`	number	`180`	Deprecated. Sets maximum time before a traitor is selected, in seconds.
`TraitorsMinRestartDelay`	number	`30`	Deprecated. Sets minimum time before another traitor is selected, in seconds.
`TraitorsMaxRestartDelay`	number	`90`	Deprecated. Sets maximum time before another traitor is selected, in seconds.
`Public`	boolean	`false`	Deprecated, use `IsPublic` instead. Sets if the server should be shown in the server browser.
`LevelDifficulty`	integer	`20`	Deprecated, use `SelectedLevelDifficulty` instead. Sets level difficulty.

WARNING

Do not change the port and queryport settings.

Click the save button in the bottom left corner.

`clientpermissions.xml`

Open the Data/clientpermissions.xml file in the file editor.
Update the settings.

List of settings

This table refers to version 23799137. Some settings may not be available in earlier versions.

Key	Type	Default	Description
`name`	string	(blank)	Player name.
`accountid`	string	(blank)	A player's Steam ID in the format `STEAM64_<steam_id>`.
`permissions`	string	(blank)	List of permissions. `ManageRound` - Allows players to start and end rounds. `Kick` - Allows players to kick other players. `Ban` - Allows players to ban other players. `Unban` - Allows players to unban other players. `SelectSub` - Allows players to select the sub when the selection mode is on "Manual". `SelectMode` - Allows players to select the gamemode. `ManageCampaign` - Same as giving ManageMoney, SellInventoryItems, SellSubItems, ManageMap, and ManageHires permissions. `ConsoleCommands` - Allows players to use Console Commands. Permissions for individual console commands are also required. `ServerLog` - Allows players to read the server logs. `ManageSettings` - Allows players to change the server's settings. `ManagePermissions` - Allows players to change the permissions of other clients. Players can only grant permissions that they already have. `KarmaImmunity` - Immunizes players against the effects of Karma. `ManageMoney` - Allows players to take money from the bank without needing a vote, set salaries, and take money from other player's wallets. `SellInventoryItems` - Allows players to sell items to shops from their inventories. `SellSubItems` - Allows players to sell items to shops directly from the submarine. `ManageMap` - Allows players to select missions and destinations on the campaign map. `ManageHires` - Allows players to hire and fire NPC crewmates. `ManageBotTalents` - Allows players to select talents for NPC crewmates. `All` - Grants players all permissions.

Example

For more details, see the official Wiki.

xml

<?xml version="1.0" encoding="utf-8"?>
<ClientPermissions> 
  <Client
    name="Artorias"
    accountid="STEAM64_1234567890"
    permissions="All">
  </Client>
</ClientPermissions>

Click the save button in the bottom left corner.

Open the overview tab at the top.
Click the restart button in the control block.

Adding mods

Open the servers page.
Find the server you want to add mods in the table and click the first button in the actions column.
Click the stop button in the control block.
Upload mods using one of the following methods:

File manager

Open the files tab at the top.
Open the LocalMods folder in the file manager.
Click the upload button in the bottom left corner.

TIP

You can find mods on Steam Workshop.

Select the mods files from your device.
Open the config_player.xml file in the file manager.
Add the mod paths to the list inside the <contentpackages> block:

xml

<contentpackages>
  <!--Vanilla-->
  <corepackage
    path="Content/ContentPackages/Vanilla.xml" />
  <regularpackages> 
    <package
      path="LocalMods/3756243869/filelist.xml" /> 
    <package
      path="LocalMods/3756485107/filelist.xml" /> 
  </regularpackages> 
</contentpackages>

Click the save button in the bottom right corner.

Open the overview tab at the top.
Click the start button in the control block.

Barotrauma ​

Changing configs ​

serversettings.xml ​

clientpermissions.xml ​

Adding mods ​

Barotrauma

Changing configs

`serversettings.xml`

`clientpermissions.xml`

Adding mods