ModsFinder

Quinn's FlexHUD

by tt432

Quinn's FlexHUD is a NeoForge library for placing and resizing HUD elements in a way that holds up across screen resolutions and aspect ratios.

NeoForgeClient-side onlyMIT LicenseOpen source1.21.1

What it does

Other mods that draw on the HUD can register their elements with the library through a simple registration API. Each element is described by an identifier, a resize mode, a default rectangle expressed as a RelativeRect with Anchor layouts, and a render layer. Because positions are stored relative to the screen rather than in pixels, an element keeps its place when the window size or aspect ratio changes. Before rendering, the library updates the current screen dimensions and converts each relative rectangle into an absolute one, so drawing code always works with the resolution in use.

The library includes an interactive configuration screen, FlexHudConfigScreen, where elements can be dragged and resized with handles. A resize mode limits the allowed shape of an element: free, a fixed aspect ratio, horizontal only, vertical only or fixed size. Changes apply at once without a restart, and saved positions are written through NeoForge's ModConfig system, so they persist between sessions. A saved layout overrides the default rectangle a mod registered. The library is client-side only, so servers do not need it. Quinn's FlexHUD is released under the MIT License and is open source, with its source code published publicly.

Key features

  1. Resolution-independent layout

    Positions and sizes are described with RelativeRect and Anchor values, so elements scale with the window.

  2. Registration API

    Mods register an element with an identifier, resize mode, default rectangle and render layer through FlexHudApi.

  3. Drag and resize editing

    The configuration screen moves and resizes elements with handles, with constraints set by the resize mode.

  4. Runtime layout updates

    Layouts can be changed while the game runs, and changes apply immediately and persist to the client config.

  5. Freely resizable Hotbar

    The library registers a freely resizable Hotbar element that players can reposition and scale.

Compatibility

Latest build for each game version and loader.

1.21.11.0
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Questions

Does Quinn's FlexHUD need to be installed on the server?

No. Players add it to their own game, and a server needs no copy.

How are saved HUD positions stored?

Layouts are saved through NeoForge's ModConfig system. A saved layout takes priority over the default rectangle a mod registered.

Can another mod add its own HUD element to the library?

Yes. A mod calls the FlexHudApi registration method with an identifier, resize mode, default rectangle and render layer, and the element then appears in the configuration screen.

In the catalog

Quinn's FlexHUD is one of 3,514 Library mods on ModsFinder, and one of 1,449 Library mods for NeoForge. 32,366 mods support Minecraft 1.21.1.

More from tt432

All projects

Similar mods

What the author says

An extensible HUD layout and rendering library built on NeoForge. It uses “RelativeRect + Anchor” to describe HUD element positions and sizes in a resolution‑independent way, provides an interactive config screen for drag/resize with constraints, and persists layout to client config while auto‑recomputing on screen…
tt432, on the Modrinth page

Official listing

Owner
tt432
Published
2025-11-10
Updated on Modrinth
2025-11-10
Facts verified
2026-10-15

Tags