CurseForge · Minecraft mod

FramingLib

A lightweight, client-sided configuration library for creating interactive, draggable HUD layout screens

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which FramingLib release should I use?

Updated today

Latest stable file 1.0.2+1.16.5-Forge

Game version 1.16.5

Loader Forge

FramingLib 1.0.2+1.16.5-Forge targets 1.16.5 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is FramingLib required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say

Dedicated server Source doesn’t say

Loader for this release Forge

Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

Understand client and server requirements Read the Minecraft installation guide

What else does FramingLib 1.0.2+1.16.5-Forge need?

1.0.2+1.16.5-Forge. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

Mod Menu Optional for FramingLib 1.0.2+1.16.5-Forge

optional

No matching file

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add FramingLib without breaking your instance.

Built for FramingLib 1.0.2+1.16.5-Forge. Pick another file and the loader, install side or required mods may change.

01
Stick to this file

Use 1.0.2+1.16.5-Forge. It targets 1.16.5 with Forge; another release may have different loader, side or dependency requirements.
02
Bring the mods it needs

This file does not list any required mods. Do not add a library just because a different file uses it.
03
Put it on the correct side

The project page does not say whether this file belongs on the client, dedicated server, or both.
04
Pick the file you checked

Use the “Get this file” button beside 1.0.2+1.16.5-Forge. It opens that exact file at the source.

About this project

What does FramingLib add?

Framing Lib

A lightweight, client-sided configuration screen library for creating interactive, draggable HUD layout screens!

📖 What is this mod?

This is a client-side configuration screen library for creating draggable HUD layout screens.

It allows developers to create configuration screens with interactive, draggable elements to make positioning their HUD/GUI elements easier for the player. This is not a complete configuration API, it is simply for creating configuration screens.

Basically, this is for other mods that rely on it to work.

Here are some visuals to help show what this does:

Features Showcase

Demo Screen

A more practical example, moving chat around:

Example Move Chat

✅ Features

Multi-Loader Support: Fully compatible with Fabric, Quilt, Forge and NeoForge
Intuitive for Players: Allows repositioning HUD/GUI elements by simply dragging them around with the mouse
Developer-Friendly API: Uses a simple builder pattern, making integration easy for any HUD/GUI mod
Dynamic Alignment: Anchors HUD/GUI elements to nine screen positions automatically, with optional snapping
Smart Recalculation: Recalculates HUD/GUI locations when GUI scale or window size changes
Lightweight & Performant: Caches and only recalculates positions when necessary to save frames
Client-Side Only: Installed only on the client, no server-side footprint or installation required
Extensively Customizable: Supports custom colors, icons, and even using your own custom rendering functions

⚠️ To remain flexible, this library does not automatically save or load layout data to the disk. Developers are responsible for serializing the layout object (into JSON/YAML/INI/your preferred config format) and deserializing it when the game initializes.

📖 Usage

📖 For Players

⚠️️ This is a library mod, and does nothing on its own.

Put the jar file in your mods folder and you're good to go!

For Fabric and Quilt version, you probably also need to put ModMenu in your mods folder.

📖 For Developers

Developer documentation can be accessed here

🚀 Supported Versions

Minecraft	Fabric	Quilt	Forge	NeoForge
26.2	⏳	⏳	⏳	⏳
26.1.2	⏳	⏳	⏳	⏳
26.1.1	⏳	⏳	⏳	⏳
26.1	⏳	⏳	⏳	⏳
1.21.11	⏳	⏳	⏳	⏳
1.21.10	⏳	⏳	⏳	⏳
1.21.9	⏳	⏳	⏳	⏳
1.21.8	⏳	⏳	⏳	⏳
1.21.7	⏳	⏳	⏳	⏳
1.21.6	⏳	⏳	⏳	⏳
1.21.5	⏳	⏳	⏳	⏳
1.21.4	⏳	⏳	⏳	⏳
1.21.3	⏳	⏳	⏳	⏳
1.21.2	⏳	⏳	⏳	⏳
1.21.1	⏳	⏳	⏳	⏳
1.21	⏳	⏳	⏳	⏳
1.20.6	⏳	⏳	⏳	⏳
1.20.5	⏳	⏳	⏳	⏳
1.20.4	⏳	⏳	⏳	⏳
1.20.3	❌	❌	❌	❌
1.20.2	⏳	⏳	⏳	⏳
1.20.1	⏳	⏳	⏳	⏳
1.20	⏳	⏳	⏳	❌
1.19.4	⏳	⏳	⏳	❌
1.19.3	⏳	⏳	⏳	❌
1.19.2	⏳	⏳	⏳	❌
1.19.1	⏳	⏳	⏳	❌
1.19	⏳	⏳	⏳	❌
1.18.2	⏳	⏳	⏳	❌
1.18.1	⏳	⏳	⏳	❌
1.18	⏳	⏳	⏳	❌
1.17.1	⏳	⏳	⏳	❌
1.17	⏳	⏳	⏳	❌
1.16.5	✅(1.0.2)	✅(1.0.2)	✅(1.0.2)	❌