Client-side mod for Minecraft 1.21.1, built for both Fabric and NeoForge from one codebase. It shows every active potion effect as a configurable grid of icons with their names underneath. Time left can be shown as text, as a radial cooldown sweep over the icon, or both.
- NeoForge: put
dist/effect-grid-neoforge-1.0.0+1.21.1.jarinmods/. Nothing else is needed. Open settings from the mod list's Config button, or press K. - Fabric: put
dist/effect-grid-fabric-1.0.0+1.21.1.jarand Fabric API inmods/. Mod Menu is optional and adds a config button.
The mod is client-only, so servers don't need it and you can join servers that don't have it.
- K: open settings. You can rebind this under Controls → Effect Grid.
- Toggle Effect Grid: shows or hides the grid. It has no key by default.
- Settings → Position...: drag the grid anywhere on screen. It snaps to the nearest corner or edge so it stays in place when the window is resized. Arrow keys move it 1px, or 10px with Shift.
| Section | Options |
|---|---|
| General | show grid, hide vanilla icons, beacon/ambient effects, effects with hidden icons |
| Layout | anchor, scale (0.25–4x), columns, cell width, column/row gap, right-to-left, rows upward, grouping (buff/debuff rows, buffs first, debuffs first, mixed), sort (longest, shortest, name, vanilla) |
| Icons & Text | names on/off, name size, buff/debuff colors, level (on icon / in name / hidden), icon frame, colored border |
| Duration | style (text on icon, text below, radial sweep, sweep + text, hidden), format (45s/3m or 0:45), text size, blink threshold, sweep darkness, shade-remaining vs shade-elapsed |
Settings are saved to config/effectgrid.json.
Note on the radial sweep: the server only tells the client how much time an effect has left, not how long it lasted when applied. The mod records the duration when it first sees an effect and resets that whenever the effect is re-applied. If you join a world with an effect already active, the sweep starts full from that point.
| Folder | Contents |
|---|---|
common/ |
All of the grid, config and screen code, using vanilla Minecraft classes only (Mojang names) |
fabric/ |
Fabric entrypoint, Mod Menu hook, and a mixin that hides the vanilla effect icons |
neoforge/ |
NeoForge entrypoint. It uses GUI layer events, so no mixin is needed |
./gradlew buildThe jars land in fabric/build/libs/ and neoforge/build/libs/. If no JDK 21 is installed, Gradle downloads one. Test clients: ./gradlew :fabric:runClient or ./gradlew :neoforge:runClient.
This mod was developed with AI assistance. The code, documentation and logo were made with help from Claude, an AI assistant by Anthropic. The logo is pixel art drawn by a script, not by an AI image generator.