background image

Barotrauma Troubleshooting Guide - Knowledgebase

  1. Rent A Game Server
  2. Knowledgebase
  3. Barotrauma
  4. Barotrauma Troubleshooting Guide
Knowledge Base Submit Ticket Open Tickets
Game Servers 380 7 Days to Die 4 Abiotic Factor 2 Aloft 2 alt:V 2 Americas Army Proving Grounds 2 Among Us 2 Archean 2 ARK Survival Ascended 6 ARK Survival Evolved 3 Arma 3 3 Arma Reforger 2 Aska 2 AssaultCube 2 Assetto Corsa 3 Astro Colony 2 Astroneer 2 Automobilista 2 2 Avorion 2 Banana Shooter 2 Barotrauma 3 BATTALION Legacy 2 BeamNG.drive (BeamMP) 2 Black Mesa 2 Brickadia 2 Call of Duty 2 Citadel: Forged with Fire 2 ClassiCube 2 Clone Hero 2 Colony Survival 2 Conan Exiles 4 Contagion 2 Core Keeper 2 Counter-Strike 2 3 Craftopia 2 CryoFall 2 CS2D 2 Cube 2: Sauerbraten 2 Cubic Odyssey 2 DayZ 4 DDNet 2 DDRaceNetwork 2 Dead Matter 2 Dont Starve Together 4 Eco 2 Empyrion Galactic Survival 2 Enshrouded 3 Escape from Tarkov 2 Euro Truck Simulator 2 2 Factorio 2 Farming Simulator 25 2 Fistful of Frags 2 FiveM 3 FortressCraft Evolved 2 Foundry 2 Foundry VTT 2 Frozen Flame 2 FTL Tachyon 2 Garrys Mod 3 Ground Branch 2 Half-Life 2 Deathmatch 2 Hogwarp 2 Holdfast: Nations at War 2 HumanitZ 2 Hurtworld 2 Hytale 1 Icarus 2 Insurgency Sandstorm 2 IOSoccer 2 Just Cause 3 Multiplayer 2 Kerbal Space Program 2 Killing Floor 2 3 LeagueSandbox 2 Left 4 Dead 2 Left 4 Dead 2 3 Longvinter 2 Los Angeles Crimes 2 Medal of Honor 2 Midnight Ghost Hunt 2 Mindustry 2 Minecraft 4 Minetest 2 Modiverse 2 Mordhau 3 Mount & Blade II: Bannerlord 2 Myth of Empires 2 Nazi Zombies Portable 2 Necesse 2 NeosVR 2 Neverwinter Nights EE 2 Night of the Dead 2 Nightingale 2 No Love Lost 2 No More Room in Hell 2 No One Survived 2 Nova-Life Amboise 2 Nuclear Option 2 Onset 2 Open Fortress 2 OpenArena 2 OpenRA 2 OpenRCT2 2 OpenTTD 2 Operation Harsh Doorstop 2 Palworld 3 Path of Titans 2 Pavlov VR 3 PixARK 2 Plains of Pain 2 Portal Knights 2 Post Scriptum 2 Project Zomboid 8 Puck 2 Quake Live 2 R5Reloaded 2 RedM 2 Renown 2 Resonite 2 Return to Moria 2 Rimworld Together 2 Rising World 2 Risk of Rain 2 1 Rust 4 Satisfactory 1 SCP Secret Laboratory 3 SCUM 2 Smalland 2 Solace Crafting 2 Soldat 2 Soldat 2 2 Sonic Robo Blast 2 2 Sons of the Forest 2 Soulmask 2 SourceCoop 2 Space Engineers 3 Space Station 14 2 Squad 3 Starbound 3 StarMade 2 Stationeers 2 Stormworks 2 Subnautica Nitrox 2 Sunkenland 2 SuperTuxKart 2 Sven Co-op 2 Swords 'n Magic and Stuff 2 Team Fortress 2 3 Teeworlds 2 Terraria 3 TerraTech Worlds 2 TF2 Classified 2 The Forest 3 The Front 2 The Isle 2 Tower Unite 2 Trackmania 2 Unturned 4 Urban Terror 2 V Rising 3 Valheim 3 VEIN 2 Veloren 2 Vintage Story 3 Voyagers of Nera 2 Wolfenstein: Enemy Territory 2 Wreckfest 2 Wurm Unlimited 2 Xonotic 2 Zandronum 2 Getting Started 2 Network & Connectivity 1 Server Management 2
Support
Categories

Barotrauma Troubleshooting Guide

barotrauma troubleshooting crashes connection performance 0 found this helpful
Available in: ESPAÑOL PORTUGUÊS PORTUGUÊS (BRASIL)

Barotrauma Troubleshooting Guide

This guide covers common issues you may encounter when running a Barotrauma dedicated server on Legion Hosting, along with step-by-step solutions. For initial server setup, see the Barotrauma Dedicated Server Setup Guide.

Before troubleshooting: Check your server console in GPanel for error messages. Lines containing [ERROR] or Exception will point you to the cause in most cases.

Table of Contents

  1. Submarine Not Loading / Server Stuck on Startup
  2. Mod Conflicts and Crashes
  3. Server Not Appearing in Browser
  4. Connection Timeout / Cannot Direct Connect
  5. Campaign Save Not Found After Restart
  6. Server Lag and Performance Issues

Submarine Not Loading / Server Stuck on Startup

Symptom: The server starts but players cannot join, or the server log shows an error about the submarine not being found.

Solutions

  • Check the name exactly: The Submarine attribute in serversettings.xml must match the filename (without the .sub extension) exactly, including capitalisation. For example, Humpback is correct but humpback is not.
  • Verify the file exists: Connect to your server via SFTP or the GPanel file manager and confirm the .sub file is present in the Submarines/ directory.
  • Workshop submarine? If the submarine came from a Workshop mod, it must be installed in LocalMods/ and registered in the server settings before it can be used. See the Mod Installation Guide.
  • Test with a default submarine: Switch to a built-in submarine (e.g. Humpback) to confirm the server starts correctly. If it does, the issue is with the custom submarine file.

Mod Conflicts and Crashes

Symptom: Server crashes on startup, disconnects players on join, or the console shows errors referencing specific content IDs.

Solutions

  • Isolate the problem mod: Disable all recently added mods and restart the server. If it runs stable, re-enable mods one at a time, restarting each time, to find the conflict.
  • Version mismatch: Ensure all mod files on the server match the versions installed on client machines. Re-download and re-upload mods if uncertain. See the Mod Installation Guide for the update process.
  • Client-only mods: Some Workshop mods are client-side only and should not be installed on the server. Check the mod's Workshop description page for this information.
  • Check the server log: Open the console in GPanel and look for [ERROR] or Exception lines. These usually reference the specific mod or content file causing the crash.
Tip: If you are running many mods and cannot identify the conflict, try a binary search approach: disable half the mods at a time rather than one by one. This narrows down the problem much faster.

Server Not Appearing in Browser

Symptom: Your server is running but does not appear in the in-game server browser.

Solutions

  • Wait a few minutes: The Steam server browser can take several minutes to list a newly started server. Try a direct connect first to confirm the server is reachable.
  • Verify the server is fully started: Open GPanel and confirm the server shows as running with no errors in the console.
  • Check your query port: The QueryPort value in serversettings.xml must match the query port assigned to your service. Check the Network tab in GPanel for the correct port assignment.
  • Confirm with direct connect: Try connecting directly using your server IP and main port (check GPanel Network tab for your assigned port) to rule out a browser-specific issue.

Connection Timeout / Cannot Direct Connect

Symptom: Attempting to join via direct connect results in a timeout or "connection failed" error.

Solutions

  • Verify your IP and port: Check the Network tab in GPanel for your server's IP address and port. See How to Find Your Server IP and Port.
  • Use the correct port: Connect to the main game port, not the query port. The main port is the one listed as the primary port in GPanel.
  • Confirm the server is running: Check GPanel to ensure the server has not crashed or stopped.
  • Check your serversettings.xml: Ensure the Port value in serversettings.xml matches the port assigned in GPanel. If they differ, the server will bind to the wrong port.
  • Firewall on your end: On rare occasions, your local network or ISP may block outbound UDP traffic on non-standard ports. Try connecting from a different network or using a VPN to test.

Campaign Save Not Found After Restart

Symptom: After restarting the server, the campaign is gone and players must start a new one.

Solutions

  • Verify the save files exist: Connect via SFTP and check that the campaign folder still exists in Saves/Multiplayer/.
  • Check for migration issues: If you recently migrated your server or restored from a backup, ensure the save folder was uploaded to the correct path inside the Barotrauma server directory.
  • Unclean shutdown: If the server was force-killed (rather than stopped cleanly via GPanel), the final save state may not have been written. Always use the Stop button in GPanel rather than force-killing the process.
  • Restore from backup: If you previously backed up the campaign, stop the server, upload the backup folder to Saves/Multiplayer/ via SFTP, and start the server. See the main setup guide for detailed backup/restore instructions.

Server Lag and Performance Issues

Symptom: Players experience rubber-banding, delayed inputs, or the server becomes unresponsive during gameplay.

Solutions

  • Reduce player count: Lower the MaxPlayers value in serversettings.xml if your server plan does not have enough resources for the current player count.
  • Reduce mod count: Some mods, especially those adding many new creatures or complex systems, significantly increase server resource usage. Remove non-essential mods.
  • Check server resources: In GPanel, monitor CPU and memory usage. If you are consistently near the limit, consider upgrading your server plan.
  • Restart the server: Long-running sessions can accumulate memory usage. A scheduled restart between play sessions can help maintain performance.

Related Articles

Still having trouble? Open a support ticket at legionhosting.net/submitticket.php and include your server name, the error messages from the GPanel console, and the steps you have already tried.
Was this article helpful?
Help Improve

Related Articles

Barotrauma Dedicated Server Setup Guide
Barotrauma Dedicated Server Setup Guide This guide walks you through configuring and running yo... Barotrauma Mod Installation Guide
Barotrauma Mod Installation Guide This guide covers how to install, manage, and update Steam Wo...
Back

Ready to Get Started?

The servers are booted, select your plan and become our latest satisfied client.