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.
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
Resolution-independent layout
Positions and sizes are described with RelativeRect and Anchor values, so elements scale with the window.
Registration API
Mods register an element with an identifier, resize mode, default rectangle and render layer through FlexHudApi.
Drag and resize editing
The configuration screen moves and resizes elements with handles, with constraints set by the resize mode.
Runtime layout updates
Layouts can be changed while the game runs, and changes apply immediately and persist to the client config.
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.
Only full game releases are shown. This mod publishes no snapshot builds.
Questions
Does Quinn's FlexHUD need to be installed on the server?
How are saved HUD positions stored?
Can another mod add its own HUD element to the library?
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
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…
Official listing
- Modrinth page
- modrinth.com/mod/quinns-flexhud
- Owner
- tt432
- Published
- 2025-11-10
- Updated on Modrinth
- 2025-11-10
- Facts verified
- 2026-10-15
