Dynamic Breath

What does it do?

This is a mod that makes the lung capacity of the Dragonborn scale with their max Stamina. The objective was to mimic how the breath meter worked on earlier TES games. Daggerfall and up had your lung capacity scale with the Endurance stat. Since this stat doesn't exist anymore, I decided to use the Base Stamina stat instead.

It also aims to be configurable, so an MCM menu is available to make changes to how the breath meter is scaled. Check the Usage section for more information.

With default values, a freshly created level 1 character will hold their breath for 20 seconds, like in vanilla Skyrim. Each time you level up the Stamina stat, you get 5 extra seconds of lung capacity.

Why?

I always felt that the game didn't really allow for underwater exploration unless you had waterbreathing, which was an annoyance. With mods like Depths of Skyrim and Underwater Treasure, I felt like the older diving systems were more appropriate. I also thought that it was lame that a legendary and powerful hero could hold their breath for only 20 seconds before drowning.

Since I couldn't find any mod that did exactly what I wanted, I ended up doing it myself.

Prerequisites

This mod needs SKSE for it to work at all, and also needs SkyUI for MCM functionality.

Installation

Simply install with the mod manager of your choice. There is no special step required. A single ESL-flagged ESP file is required for the mod to function. This mod also works with Oxygen Meter 2 so when lung capacity is changed, the oxygen meter will reflect the changes.

Usage

This mod is plug-and-play. It is pre-configured with values that I found coherent. An MCM menu is available to you so you can tweak the mod's values. There are several settings :

Stamina Lung Capacity Multiplier (default 5s)
How much more lung capacity you get per stamina level up. Possible values are 0 to 10 seconds per stamina levels. At 0, lung capacity scaling will be disabled. At 10, you get 10s of lung capacity for each stamina level up.

Base Lung Capacity (default 20s)
How much lung capacity you have at 100 stamina (level 1). Possible values are 10 to 120 seconds.

"Gasping" Threshold (default 50%)
In the base game, the Dragonborn will gasp for air when returning to the surface if they have been underwater for longer than 4 seconds. This mod makes it dynamic as well. When the remaining air is below the set threshold, the Dragonborn will gasp for air when returning at the surface. Possible values are 0% to 75%. 0% will make the Dragonborn gasp for air only when they have started drowning.

Ignore Stamina Buffs (default on)
With this setting on, the mod will only use Base Stamina for lung capacity calculations, ignoring any buffs applied to Stamina. With the setting off, lung capacity will take into account the total Stamina stat, which includes buffs.
NOTE: If this setting is off, the mod will recalculate the lung capacity every 3 seconds. If this is a performance concern to you, please leave the setting on. This also means that a delay of up to a couple of seconds can occur between a stamina buff being applied and the mod recalculating the lung capacity accordingly.

Used Attribute for Lung Capacity (default "Stamina")
This lets you choose which attribute to use in lung capacity calculations. You can choose between Health, Stamina, and Magicka. By default, the mod uses the Stamina attribute for calculations.

Debug Mode (default off)
Display debug messages every time lung capacity is recalculated (e.g. when leveling up or changing gear). This is only for testing or development purposes, so it's better to leave this setting off.

Credits

Bethesda for the awesome games.
The SKSE team, this mod wouldn't have been possible without them.
The Arcane University discord server for giving me a hand on an issue I had while creating the mod.

This is my first mod! I hope you'll have fun with it!