You are viewing a potentially older version of this package. View all versions.
tony4twenty-Stamina_Panic-2.0.0 icon

Stamina Panic

Stamina too low? No need to panic right!? Now includes flashing stamina bars, extra stamina warnings and an affliction only setting!

Date uploaded 3 weeks ago
Version 2.0.0
Download link tony4twenty-Stamina_Panic-2.0.0.zip
Downloads 339
Dependency string tony4twenty-Stamina_Panic-2.0.0

This mod requires the following mods to function

BepInEx-BepInExPack_PEAK-5.4.75301 icon
BepInEx-BepInExPack_PEAK

BepInEx pack for PEAK. Preconfigured and ready to use.

Preferred version: 5.4.75301

README

Stamina Panic

Sound the alarm when your stamina gets too low.

Version 2.0.0 — full rebuild. The bar outline flashes when you are in the red, and you can pick separate sounds for stamina and extra stamina. Extra stamina is flash only by default. Photosensitivity is already respected: if that vanilla option is on, the outline gets a static tint instead of pulsing.

Use ModConfig to tweak it live.

The pack still comes with audio files. Drop extras next to the plugin and pick them in the config.

Find the mod in the Peak Modding Discord under #mod-releases for issues, reports, or thanks. If you are already a part of the PEAK modding discord then use this link to go directly to the post Stamina Panic


Features

  • Main stamina outline flashes the whole time you are in the red zone
  • Extra-stamina outline flashes while extra stamina is low and being drained
  • Optional warning sounds for each bar, with their own volume, fade, loop, and duration cap
  • Extra-stamina sound is off by default (flash only)
  • Dropdown audio picker in ModConfig — both cues default to Panic.ogg when that file is present
  • Volume follows the vanilla Master Volume slider
  • Optional AfflictionOnly (off by default): only warn when afflictions have eaten the bar, not when you sprint / climb / jump
  • CueLoop off = play once until that bar goes back above the threshold
  • Optional duration cap so a long affliction stretch does not loop forever (off by default; 180 seconds when enabled)
  • Fades out if you pass out or die while a cue is playing
  • Ignores the empty-bar moment on spawn / revive
  • No lobby noise — only during level scenes

Installation

  1. Download via Thunderstore
  2. Place the files in BepInEx/plugins/
  3. Launch the game — config is generated on first run 🔥 or use a Mod Manager 🔥

Drop extra .ogg or .wav files next to the plugin DLL (subfolders are fine). Reopen ModConfig if you add files while the menu is already open.


Configuration

Config file:

BepInEx/config/tony4twentys.Stamina_Panic.cfg

Or configure live with ModConfig.

This is a 2.0.0 rebuild, so old Audio / General.StaminaThreshold keys will not carry over. Re-check settings after updating.

General

Setting Default Description
Enabled true Master toggle
EnableLogging false Write stamina / extra-stamina debug lines to the BepInEx log

Stamina

Setting Default Description
Threshold 0.2 Red-zone threshold (0–1)
AfflictionOnly false If true, only afflictions eating the bar count (injury, hunger, poison, weight, etc.). Sprinting / climbing / jumping will not trigger it
PlayAudio true Main warning sound. Off = flash only
AudioFile Panic.ogg Dropdown of .ogg / .wav files next to the plugin
CueVolume 100 0–100, also scaled by Master Volume
FadeOutTime 1.5 Seconds to fade out when it should stop
CueLoop true Loop while in the red zone. Off = play once until stamina goes back above the threshold
LimitCueDuration false Stop the sound after the cap even if you stay in the red zone. Flash is not capped
CueDurationLimitSeconds 180 How long the sound may play per red-zone stretch

Extra Stamina

Setting Default Description
Threshold 0.2 Extra bar is low at or below this (0–1)
PlayAudio false Extra warning sound. Off by default so extra stamina only flashes
AudioFile Panic.ogg Separate dropdown; same file list as stamina
CueVolume 100 0–100, also scaled by Master Volume
FadeOutTime 1.5 Seconds to fade out
CueLoop false Loop while extra stamina stays below the threshold. Off = play once until it goes back above
LimitCueDuration false Cap the extra sound only
CueDurationLimitSeconds 180 How long the extra sound may play per low stretch
FlashColor #FFB02A Extra outline flash color (#RRGGBB)

Visual

Setting Default Description
FlashBarOutline true Flash bar outlines (not affliction fills)
FlashColor #FF2A2A Main stamina outline flash color
FlashSpeed 2.5 Flash pulses per second
RespectPhotosensitivity true If vanilla photosensitivity is on, use a static tint instead of pulsing

How it works

  • Main bar: remaining usable stamina (current + extra), so afflictions that shrink the bar also count. Turn on AfflictionOnly if you only want the warning when injury / hunger / poison / weight / etc. have squeezed the bar, not from sprinting / climbing / jumping
  • Extra bar: the bonus stamina pip. Outline flashes while that pip is low and draining. Sound stays off unless you enable PlayAudio
  • Passing out or dying fades a playing cue (loop is forced off for that fade). Spawn / revive empty-bar moments are ignored
  • Audio is local. Nobody else hears your panic

Dependencies

Required

Recommended

  • ModConfig for in-game settings and the audio dropdown

Feedback

Suggestions, ideas, or issues? Reach out via the PEAK Modding Discord


Credits

CHANGELOG

Changelog

[2.0.0] - 2026-09-20

  • Full rebuild
  • AfflictionOnly off now stays in the red zone while remaining stamina is actually below the threshold, including when injury / hunger have squeezed the bar (previously it treated a “full remaining” bar as recovered and stopped the loop)
  • Pick stamina and extra-stamina audio from a ModConfig dropdown (drop .ogg / .wav files next to the plugin; both default to Panic.ogg when present)
  • Main stamina outline flash while in the red zone; extra-stamina outline flash while extra stamina is low and being drained
  • Extra-stamina sound is off by default (flash only)
  • Optional AfflictionOnly mode (off by default) so sprinting / climbing / jumping do not trigger the main warning
  • Volume follows the vanilla Master Volume slider
  • Optional duration cap so a long red-zone stretch does not loop forever (off by default; 180 seconds when enabled)
  • Loop can be turned off so a cue plays once until stamina goes back above the threshold
  • Audio toggles if you want flash with no sound
  • Fades out if you pass out or die while a cue is playing; ignores the empty-bar moment on spawn / revive
  • No more 30-second startup delay or extra-files folder workaround

[1.0.4] - 2025-09-16

  • Added check so audio would not loop forever if you were dead or passed out

[1.0.3] - 2025-09-07

  • Updated to dynamically check the plugins root directory for the audio file to play (this means you must add a folder to seperate the extra audio files from the root directory)
  • removed config for audio path
  • updated README to make user aware of having to choose the audio they want and move others into a seperate folder they create

[1.0.2] - 2025-08-12

  • Fix after Mesa update
  • Audio now routes through the game's audio mixer for better compatibility with recent PEAK updates.
  • Ensured the audio source is 2D, ignoring spatial attenuation for consistent cue volume.
  • Introduced a smooth fade-out effect when stamina recovers above the threshold instead of abruptly stopping the audio.
  • Fade-out duration is configurable via the new FadeOutTime setting in the config file.

[1.0.0] - 2025-08-05

  • Initial release.