Mind Your Bubbles
Mind Your Bubbles is a client-side Fabric mod for Minecraft that turns the vanilla air bar into a more consistent survival indicator.
⬇ Download on Modrinth
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.
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21.11
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as mind-your-bubbles-1.2.2+mc1.21.11.jar — drop this file into the mods folder
- Download size: 56 KB
- Download link checked 24 Aug 2026 — working
These come from our own check of the pack file, not from the source page.