Mind Your Bubbles

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: VANILLA by default, with WHEN_NOT_FULL and ALWAYS available.
• Smooth large or small Air changes 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.