PotionHud
by bobsniffer9
PotionHud draws a countdown timer, a draining progress bar and a level numeral onto each potion effect icon, so players can read remaining time without guessing.
What it does
Each active effect keeps its vanilla potion sprite, now with a timer that shifts from green to yellow and then red as it runs low. A bar along the bottom of the icon drains over the duration. Amplified effects show a Roman numeral, so Speed II and Strength III are distinguishable at a glance, and infinite effects display a symbol in place of the timer. The vanilla effect list in the top-right corner is hidden, and only PotionHud's overlay is shown.
The overlay can be placed horizontally or vertically, and its position saves automatically after a drag and release. Icon size, padding, scale and background opacity are adjustable, and two icon styles are available: a default panel tinted to match the potion color, and a transparent minimal icon. The mod was built with a Steam Deck in mind, using large touch-friendly controls and drag-to-move that works with touch input, and it also works on PC.
PotionHud is a Fabric mod for Minecraft 1.21 only and needs Fabric Loader 0.16 or later together with Fabric API. It runs on the client alone, so servers need nothing installed. Its code is under the MIT License, and the project is not open source.
Key features
Countdown timers
Each effect shows its remaining time, colored green while safe, yellow as it fades and red when nearly gone.
Draining progress bar
A bar at the bottom of each icon empties as the effect runs down, giving a visual sense of duration.
Level indicator
Amplified effects display a Roman numeral, such as Speed II or Strength III, on their icon.
Adjustable overlay
Icon size, padding, scale, background opacity and horizontal or vertical layout can be changed in the options.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Who it’s for: Players on Minecraft 1.21 who use potions often and want effect timers on screen, especially on a Steam Deck or touch device.
How it compares
Potion Bar is a Client-side only Fabric and NeoForge mod, open source under the MIT License, for 1.20.1 – 26.3. PotionEffects is also Client-side only and uses the MIT License, with Fabric files for 1.21.11 – 26.2. Potions++ runs client and server on 1.21.11 with All rights reserved, so it is not open source and both sides need it.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| PotionHud | Fabric | 1.21 | Client-side only | 2026-06-11 |
| Potion Bar | Fabric and NeoForge | 1.20.1 – 26.3 | Client-side only | 2026-09-15 |
| PotionEffects | Fabric | 1.21.11 – 26.2 | Client-side only | 2026-07-25 |
| Potions++ | Fabric | 1.21.11 | Client and server | 2026-06-14 |
Questions
Does PotionHud need Fabric API?
Does the server need PotionHud installed?
Can the vanilla effect list stay visible?
In the catalog
PotionHud is one of 17,631 Equipment mods on ModsFinder, and one of 8,894 Equipment mods for Fabric. 15,770 mods support Minecraft 1.21.
Similar mods
What the author says
PotionTimer overlays countdown timers and progress bars directly on your potion effect icons — always know exactly when to repot, no guessing. Features - Vanilla potion sprites — every effect is instantly recognisable - Countdown timer per effect — green when safe, yellow when fading, red when almost gone (thresholds…
Official listing
- Modrinth page
- modrinth.com/mod/potionhud
- Owner
- bobsniffer9
- Published
- 2026-06-07
- Updated on Modrinth
- 2026-06-11
- Facts verified
- 2026-10-15