Effect Grid

Effect Grid

A client-side HUD mod that 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.

Features

• Grid layout: choose the anchor, scale (0.25–4x), columns, cell width and gaps. The grid can run right-to-left or build rows upward.
• Drag to position: open Settings → Position… and drag the grid anywhere. It snaps to the nearest corner or edge so it stays put when the window is resized. Arrow keys nudge it by 1px, or 10px with Shift.
• Grouping and sorting: buff/debuff rows, buffs first, debuffs first or mixed. Sort by longest, shortest, name or vanilla order.
• Icons and text: names on/off, name size, buff/debuff colours, level shown on the icon, in the name or hidden, icon frame and coloured border.
• Duration styles: text on the icon, text below, radial sweep, sweep plus text, or hidden. Format as 45s/3m or 0:45, with a blink threshold, sweep darkness and shade-remaining vs shade-elapsed.
• Hide the vanilla effect icons, and choose whether beacon/ambient effects and effects with hidden icons are included.

Controls

• K opens the settings (rebindable under Controls → Effect Grid).
• Toggle Effect Grid shows or hides the grid. It has no key by default.

Settings are saved to config/effectgrid.json.

Requirements

• Minecraft 1.21.1
• NeoForge: nothing else needed. Settings are also available from the mod list's Config button.
• Fabric: needs Fabric API. Mod Menu is optional and adds a config button.

Client-side only. Servers don't need it, and you can join servers that don't have it.

A 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 it whenever the effect is re-applied. If you join a world with an effect already active, the sweep starts full from that point.

Source code

github.com/Dawnforger/effect-grid (MIT). Bug reports go in the GitHub issues.

AI disclosure

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.