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 wear an anechoic suit to enter the deadly echo chambers known as ballast tanks.

Captains - will have to be extremely careful with their use of active sonar, be constantly aware of crew positions, and communicate when it's safe to do repairs or go outside.

Adding to the captain's decision-making and skill ceiling, sonar can now be utilized in new play-styles as a tool to fight off creatures, with the caveat of potentially drawing the attention of more or causing severe 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 nice 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 exceeding a nuclear explosion in the air. Underwater exposure to a single nearby sonar ping could 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
• Active sonar that damages nearby submerged humans and creatures
• Directional sonar that focuses the sonar's pressure waves in one area for amplified damage
• A 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 @Lightness
• 28 human sound effects, voiced by Rirr and Kablecart
• 12 horrific and creative new afflictions to represent the injuries from active sonar
• 12 custom injury overlays for visual feedback
• 3 unique medical treatments to treat injuries and cause lethal "accidents"
• A new sonar-protective diving suit that absorbs sound, hiding players on the radar. By Rirr
• A new AI system for bots to make them behave intelligently around active sonar
• A new craftable tablet that lets the captain remotely control the sonar and engines
• Enemy submarines that will periodically toggle their active sonar
• Adjusted sonar ranges

Bonus: If you want to try a different style of sonar UI, 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
• Português Brasileiro
• Castellano
• 한국어
• 中文(繁體)
• Türkçe

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 basic list of mods with compatibility issues can be found on this Google Doc[t.ly]

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. Even so, wearing the new anechoic diving suit and aiming the station's sonar away from your exit path is recommended. An anechoic suit can be bought from a shop or crafted using 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: 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 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: Am I supposed to take damage from sonar in the ballast tank?
Yes and no. Without Lua, this is the default behaviour. Lua is required to accurately determine if a player is in reach of an active sonar and not just in a body of water.
For this, ensure your server is running the Lua executable, or if you're playing single-player, client-side Lua is installed.

Q: How does this mod play with bots?
Bots will know when a nearby sonar system is active and try to avoid submerged hull breaches until it is safe. They will still repair these breaches, but only if they can access an anechoic suit for protection. The bots will communicate these scenarios (and more) over the radio in chat.
On the medical side, bots can apply all the new treatments to cure sonar afflictions with no problems.

Q: Does active sonar hurt creatures?
Yes. Active sonar does varying amounts of damage to all life forms depending on their distance from the terminal. However, because fish are more hydrodynamic and don't have air-filled cavities like humans, they are far less affected by the sonar's pressure waves and, therefore, take much less damage.

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.

Q: Why isn't the mod working for me? 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: 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 features?
There's a good chance you can create the configuration you're looking for in the settings.

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 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.
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.

If you feel that my mods have meaningfully improved your Barotrauma experience or you just like what I do, you're welcome to contribute to my insomnia by buying me a coffee on ko-fi.[ko-fi.com]
Thank you.