Mind Your Bubbles is a client-side Fabric mod that makes Minecraft's vanilla air bar easier to see and useful beyond the usual underwater warning.
Why this mod?
Minecraft already stores breath as the entity Air value, but the vanilla HUD only shows it in a few situations. Mind Your Bubbles exists because Air can be more than an underwater warning: it can be a gameplay resource for mods, plugins, maps, and experiments to design around.
Features
- Choose when the vanilla air bar appears:
VANILLAby default, withWHEN_NOT_FULLandALWAYSavailable. - Smooth large or small
Airchanges so bubble transitions stay readable. Enabled by default. - Keep custom Air-drain displays stable in non-vanilla scenarios.
Behavior
Display modes
| Mode | Behavior |
|---|---|
VANILLA |
Uses Minecraft's original air bar behavior. |
WHEN_NOT_FULL |
Shows the air bar when the player's Air value is below its maximum. |
ALWAYS |
Shows the air bar at all times. |
Water Breathing, or similar effects, can keep Air full underwater. In that case, VANILLA shows the bar, while WHEN_NOT_FULL hides it.
Visual smoothing
When Air changes in non-vanilla steps, smooth animation fills in the missing bubble transitions.
| Change | Vanilla | Smoothed |
|---|---|---|
| Large `Air` changes |  |
 |
| Small `Air` changes |  |
 |
Configuration
Generated config file is located in the Minecraft instance config directory:
<instance folder>/config/mind-your-bubbles.json
Requirements
- Fabric Loader
- Java 21 or newer
- A Minecraft version matching the downloaded file
Optional:
- Mod Menu
- Cloth Config API
License
This project is licensed under CC0-1.0.
