promotional bannermobile promotional banner
premium banner

Subnautica Oxygen Alerts

Plays oxygen warning sounds while underwater

Description

World of Warcraft addon that plays oxygen warning sounds while underwater.

Features

  • Plays custom audio at oxygen thresholds (50%, 25%, 10%, 1%).
  • Uses the BREATH mirror timer and updates even if the timer UI is hidden.
  • Simple slash command for testing.

Installation

1) Copy the SubnauticaOxygenAlerts folder into your WoW AddOns directory:

  • Retail: World of Warcraft/_retail_/Interface/AddOns/
  • Classic: World of Warcraft/_classic_/Interface/AddOns/

2) Ensure Subnautica Oxygen Alerts is enabled on the character select AddOns list.

3) Reload the UI (/reload) if the game is already running.

Usage

  • Dive underwater and the addon will play sounds at the configured thresholds.
  • Sounds are stored in src/ and are played on the SFX channel.

Slash Commands

  • /subnautica test - Play a test sound.

Configuration

Edit SubnauticaOxygenAlerts.lua and adjust PERCENT_THRESHOLDS if you want different timings or sound files.

Development Notes

  • The addon listens to MIRROR_TIMER_START/STOP/PAUSE for the BREATH timer.
  • Remaining oxygen is tracked in milliseconds and updated every 0.1s.

Credits

Author: Nightbert
Subnautica sound assets are owned by Unknown Worlds Entertainment.

Project on Github