FramingLib
by PlagueTR
FramingLib is a client-side configuration library for Fabric, Forge and Quilt that lets developers build interactive draggable HUD layout screens.
What it does
Mods built on FramingLib can let players reposition HUD and GUI elements by dragging them with the mouse, across a nine-point screen anchor grid with optional snapping. The library offers a simple builder pattern for developers, and a complete configuration API for creating configuration screens, so a mod can expose its layout without writing the interface from scratch.
Elements are recalculated when the GUI scale or the window size changes, and positions are cached so only the values that need updating are recomputed each frame. The mod is installed only on the client, and a server needs no footprint to run with it. Files are published for 1.16.5 – 1.19.4 on Fabric, Forge and Quilt, and Mod Menu is optional for the settings screen. Chat Positioner requires it.
The jar goes into the mods folder. Mod Menu is an optional dependency that adds a menu entry for opening the configuration screens. The project is open source under the MIT License and its source code and issue tracker are public.
Key features
Draggable HUD layout
Players drag HUD and GUI elements with the mouse to place them wherever they prefer on screen.
Nine-point anchoring
Elements snap to one of nine screen positions automatically, with optional snapping while dragging.
Recalculated layouts
Positions update when the GUI scale or window size changes, keeping elements in place after a resize.
Custom rendering support
Colors, icons and custom rendering functions can be used for the elements a mod places on screen.
Builder pattern API
A builder-style API lets developers register elements and configuration screens with little setup.
Compatibility
Latest build for each game version and loader.
1.19.x5 of 5 versions with builds
1.18.x3 of 3 versions with builds
1.17.x1 of 1 version with builds
1.16.x1 of 1 version with builds
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Optional 1
Required by 1 mod
Use cases
Moving the chat window
Chat Positioner uses the library to let players move the chat box around the screen.
Who it’s for: Mod developers who want players to reposition their HUD or GUI elements, and players who want to arrange those elements on their own screen.
How it compares
Simple GUI API is a Fabric, Forge and NeoForge library for 1.21 – 26.2 under a custom license, and it is not open source. Resource Bar API targets Fabric only for 1.20.1 – 26.1.2 and runs on client and server, with the MIT License. Bento GUI is open source under the GNU Lesser General Public License v3.0 only, targets Fabric for 1.21 – 1.21.1 and is client-side only. Fatigue's GUI lib is for Fabric and 1.21.11 and is not open source.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| FramingLib | Fabric, Forge and Quilt | 1.16.5 – 1.19.4 | Client-side only | 2026-08-25 |
| Simple GUI API | Fabric, Forge and NeoForge | 1.21 – 26.2 | Client-side only | 2026-08-20 |
| Resource Bar API | Fabric | 1.20.1 – 26.1.2 | Client and server | 2026-04-15 |
| Bento GUI | Fabric | 1.21 – 1.21.1 | Client-side only | 2026-03-30 |
| Fatigue's GUI lib | Fabric | 1.21.11 | Client or server, optional | 2026-04-18 |
Questions
Does FramingLib need a server install?
Which loaders does FramingLib support?
Is Mod Menu required?
In the catalog
FramingLib is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 9,374 mods support Minecraft 1.19.4.
More from PlagueTR
Similar mods
What the author says
A lightweight, client-sided configuration screen library for creating interactive, draggable HUD layout screens! This is a client-side configuration screen library for creating draggable HUD layout screens.
Official listing
- Modrinth page
- modrinth.com/mod/framinglib
- Owner
- PlagueTR
- Published
- 2026-07-17
- Updated on Modrinth
- 2026-08-25
- Facts verified
- 2026-10-15