Potion Overlay
by Heisenkebab
Potion Overlay shows a potion's length, type and amplifier on the screen while a player has an effect active, and its display can be adjusted in a config menu.
What it does
Potion Overlay is a client mod for Fabric. Players see the remaining duration, potion type and amplifier of each active effect, and the readout can be styled with its own text color. Blinking can be turned off, or set to begin after a chosen number of seconds, and the shadow behind the text can be disabled. Only the client needs it, so a server can run without it.
The settings are reached through Mod Menu when it is installed, or through the controls menu, where the default key has been changed. The mod needs Fabric API, Kotlin for Forge and YetAnotherConfigLib (YACL). Kotlin for Forge is listed among the requirements, so it must be installed next to Potion Overlay as well. Files cover 1.20 – 1.21.8 across 15 release versions, and the code is open source under the MIT License.
Key features
Effect duration readout
Remaining time for each active potion effect is shown on the overlay.
Potion type and amplifier
The overlay displays the potion type and its amplifier next to each effect.
Blinking control
Blinking can be switched off, or set to start after a chosen number of seconds.
Text styling
The shadow behind the text can be turned off and the text color can be changed.
Config menu access
Settings open from Mod Menu when installed, or from the controls menu under a changed default key.
Gallery
Compatibility
Latest build for each game version and loader.
1.21.x9 of 9 versions with builds
1.20.x6 of 6 versions with builds
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 3
Optional 1
Use cases
Tracking short effects
Players who drink several potions in a row can read how long each one lasts without opening the inventory.
Tuning the display
Players who find blinking distracting can switch it off or delay it, and change the text color to suit their resource pack.
Who it’s for: Players on Fabric who want to see the duration and strength of their active potion effects. Only the client needs the mod, so it is suited to single-player and multiplayer clients alike.
How it compares
Potion Duration HUD is a Fabric mod for 1.21.4 with client and server environment, under All rights reserved, so it is not open source. Key Overlay is also a Fabric client mod, but it covers 1.20 – 26.3 and is not open source. Potion Overlay is open source under the MIT License and covers 1.20 – 1.21.8, which is the difference in range and licensing.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Potion Overlay | Fabric | 1.20 – 1.21.8 | Client-side only | 2025-09-06 |
| Potion Duration HUD | Fabric | 1.21.4 | Client and server | 2026-08-13 |
| Key Overlay | Fabric | 1.20 – 26.3 | Client-side only | 2026-09-20 |
Questions
Does Potion Overlay need Fabric API?
Does the server need Potion Overlay?
Where are the options changed?
In the catalog
Potion Overlay is one of 8,016 Management mods on ModsFinder, and one of 5,930 Management mods for Fabric. 17,695 mods support Minecraft 1.21.8.
Similar mods
Official listing
- Modrinth page
- modrinth.com/mod/potionoverlay
- Owner
- Heisenkebab
- Published
- 2024-10-30
- Updated on Modrinth
- 2025-09-06
- Facts verified
- 2026-10-15