Subscribe to download
Real Sonar

Warning: This mod can contain flashing lights and loud sounds. If you have photosensitive epilepsy or are sensitive to high-frequency sounds, do not use this mod.

Based on real-life military submarine sonar, this mod overhauls the in-game sonar system to make it more dangerous and challenging to manage.
Crewmates - will need to be more aware of their surroundings, stay away from hull breaches while the sonar is active, and be careful of the deadly echo chambers known as ballast tanks.
Captains - will have to be extremely careful with their use of active sonar, be aware of crew positions, and communicate when it's safe to do repairs.
Sonar can be used to fight off creatures, but it can also draw the attention of more and cause serious injury to the crew if there's a surprise hull breach.
Active sonar now sounds different for each player, depending on their situation, distance, and level of protection. It might sound calm inside the submarine, but I wouldn't recommend stepping outside to get a better listen.

When submerged, a submarine's active sonar can reach volumes of 235db, which is 724x louder and 3.16 billion times the intensity of a jet engine. This makes active sonar one of the loudest man-made sounds in existence, almost preceding a nuclear explosion in the air. Underwater exposure to a single nearby sonar ping would cause severe internal damage, rupture organs, and even melt your brain.

This mod adds the following:
• Fresh new UI for the Nav Terminal, Sonar Monitor, and Shuttle Terminal. Includes clock positions & distance.
• Active sonar now damages nearby submerged humans and creatures.
• New sound system, allowing sonar pings to sound different for each player.
• 246 total custom sound effects.
• 199 different sonar pings, made by professional audio engineer @Gaming.
• 28 human sound effects, voiced by Rirumia and Kablecart.
• 12 horrific and creative new afflictions to represent the injuries from active sonar.
• 12 custom injury overlays for visual feedback.
• 10 different supported languages.
• 3 unique medical treatments to treat injuries and cause lethal "accidents".
• A new, specialized diving suit to protect against active sonar. Drawn by Rirumia.
• A handheld tablet that lets the captain remotely control the submarine's sonar and engines.
• Increases Nav Terminal range by 20%, and decreases the Sonar Monitor range by 20%.
• And more!

Bonus: If you want to try a different style of sonar UI (with degrees), check out M's Immersive Sonar UI mod!

Supported languages:
• English
• Русский - by routerchain
• 中文(简体) - by Aunt_Su
• 日本語 - by Dutch & d3
• Polski - by Sqor
• Español Latinoamericano - by King Kongrio
• Français - by Thespirou54
• Deutsch - by some_william
• Italiano - by Fuoco1306
• Português Brasileiro
• Castellano
• 한국어
• 中文(繁體)
• Türkçe

If your question isn't listed here, try reading the questions discussion.

Q: How do I activate beacon stations with this mod?
Beacon stations do half the damage and have 33% less range than a standard sonar system. Wearing an Anechoic Diving Suit is recommended. An Anechoic Suit can be bought or crafted with a standard diving suit, titanium-aluminum alloy, and six rubber, which can all be obtained by deconstructing or stealing at the start of the game.

Q: Why did I take damage in the ballast tank without a hull breach?
Make sure the server has Lua for Barotrauma enabled for accurate hull detection. Without it, you will take damage from active sonar in any body of water within range. Note: If you're playing single-player, features like this require installing client-side Lua.

Q: Where can I find the in-game settings/config menu?
The in-game settings menu requires client-side Lua to access. Once installed, you can find the Real Sonar settings menu at the bottom of the pause menu.[imgur.com] If the menu still isn't there, ensure "Prefer To Use Workshop Lua Setup" is enabled in the LuaCs settings menu in the top left of the main menu.

Q: How do I add/edit sonar terminals or diving suit protections?
If server-side Lua is enabled, then all vanilla diving suits already have some built-in protection. Note that the protection modifier isn't visible when hovering over the item because it's applied using Lua rather than overriding the item itself.
These values can all be edited in the config or through the in-game menu like so:

Value limits:
For custom terminals, the "damage" preset can be "high", "medium", or "low". The "sounds" preset can be "default" or "shuttle". If you can hear the old ping sound playing with the new one, try enabling the Low Latency Mode setting.
For wearables, the damage multiplier ranges from 0.0 to 1.0, with 1 being 100% protection.
If "anechoic" is set to true, then the item will play muffled sounds, disable visual impacts, and be prioritized by bots for hull breaches.

Q: How do I treat the afflictions in this mod?
The medical side of this mod is simple by design to blend with vanilla. There's a basic breakdown of all the afflictions and items here!

Q: Is there a version of this mod with only X or Y features?
If something isn't to your liking, I encourage you to look through the in-game settings menu for a configuration that fits your preference. For example, if you only want the UI and inside versions of the sounds, you could disable all three sonar terminals.

Q: Why isn't the mod working? The sonar still behaves like vanilla.
This is likely due to another mod overriding the navigation terminal. Try putting Real Sonar at the top of your load order.

Q: Can I enable this mod in an already-active campaign?
The short answer is yes! However, the sonar-related medical items and diving suit won't spawn in the world or be available in shops, meaning you will have to craft them.

Real Sonar is compatible with the vast majority of mods, including Neurotrauma. Real Sonar does NOT require Lua For Barotrauma, but it is highly recommended.
A comprehensive list of mods with compatibility issues can be found on this Google Doc[t.ly]

This is an updated list of upcoming features and goals:
☑ A volume menu for Lua users.
☑ Proper hull breach detection for Lua users.
☑ Bots no longer repair hull breaches when the sonar is on without protection.
☑ Being hit with a directional ping deals extra damage.
☑ The Anechoic Diving Suit hides the wearer on active sonar.
☑ Custom sounds, visuals, and behavior for the shuttle nav terminal.
☑ Pirate submarines have a chance to turn their active sonar on.
☐ Optional patches for Neurotrauma, Robotrauma and vanilla-only afflictions.
(The following additions are on hold until @Gaming can continue working on sonar sounds)
☐ Unique sounds for beacon stations.
☐ New sounds and behavior for depth decoy shells.
☐ New sounds for the handheld sonar and sonar beacon.