
DynamicHUD
A HUD library to create, display, load, save, interact and do much more with HUD elements (aka - widgets).
- Загрузки
- 21K
- Подписчики
- 15
- Обновлён
- 12 августа 2026 г.
- Лицензия
- MIT
Опубликован 13 июня 2023 г.
An in-game HUD engine for mod creators
DynamicHUD is a library. It is an API for developers to create customizable HUD elements for their mods that players can modify and interact with.
Features
| Feature | Description |
|---|---|
| Automatic Saving & Loading | Widgets automatically save their state and reload upon game restart |
| Interactive Context Menus | Right-click widgets supporting menus to open customisable sliders, color pickers, runnables, and lists/enum selection |
| Screen Boundary Clamping | Made to prevent widgets from clipping outside window boundaries |
| Grid Snapping and alignment | Smart snapping along other widgets and alignment grid displayed for your convienence (can be toggled in settings) |
| Rendering Utilities | Use DrawHelper, ColorHelper, and TextureHelper to simplify rendering code like drawing rounded rectangles, textures, chroma text, gradients,outlines, shadows, any shape, scaling utilities and scrollable text |
| Animation system | DynamicHUD comes with a 2D easing based animation system to help your widgets and menus feel smooth |
| Wiki | https://tanishisherewith.gitbook.io/dynamic-hud |
DynamicHUD has a dedicated settings button when you open the option screen beside the 'FOV' slider which you can use to customise your widgets and menus.
Keybinds (v4.0.0+)
Currently these keybinds are unmodifiable.
Open the DynamicHUD Settings Button located next to the FOV Slider in the Minecraft options screen to modify DynamicHUD's settings.
Selection & Grouping
| Action | Control | Details |
|---|---|---|
| Box Select | Click + Drag on canvas |
Selects all widgets inside the drawn boundary box |
| Multi-Select | CTRL + Left Click |
Toggles selection state on individual elements |
| Group / Ungroup | CTRL + G |
Links selected elements together (shows a green dashed outline) |
| Grid Snapping | Shift |
Hold while dragging to lock elements to nearest grid. Grid size can be changed in the settings (Snap Size) |
Note: Locked widgets (
isLocked = true) remain anchored in place and will not move when dragging a group.
Widget Scaling
| Method | How to Use |
|---|---|
| Accurate | Hover over any widget and use CTRL + Scroll Wheel |
| Simple | Click and drag the small white dot on the bottom-right corner of a selected widget |
Showcase
Showcase Video
Quick Setup (For Players)
- Ensure you have Fabric Loader, Fabric API. (Note: You may also need YACL installed for older versions of DynamicHUD).
- Download the latest
.jarfrom the Releases Tab. - Drop the file into your
.minecraft/modsdirectory. - Launch the game and enjoy ;)
Getting Started For Developers
Visit our wiki for more detailed documentation.
To get started, begin with adding DynamicHUD as a dependency in your build.gradle file:
allprojects {
repositories {
maven { url 'https://jitpack.io' }
}
maven {
name 'Xander Maven'
url 'https://maven.isxander.dev/releases'
}
}
dependencies {
// Dynamic HUD
modImplementation 'com.github.V-Fast:DynamicHUD:<Version>'
}
Contributing
Contributions are welcome! If you’re interested to do any help, please review our contributing guidelines. I myself am a solo developer in college and still learning to code. Updating to latest versions may take time. Any help will be greatly appreciated!
License
DynamicHUD is released under the MIT License. Feel free to use and modify it in your mods, with proper attribution back to this repository.
Support
Need assistance or have suggestions? Join our Discord community or submit an issue on our GitHub repository.
Ченджлог
5.0.0Релиз26.1.1, 26.1.2 · 12 августа 2026 г.
Updated to version 26.1.x
Major Highlights for Users:
- Removed YACL: YACL dependency has been removed and replaced.
- Better Minecraft Skin: MinecraftSkin has been enhanced with UI sound effects, better search and cursor change.
- Tooltips: More tooltips have been added for widgets as well as options.
- Customisated: Widgets will now look more customised and smooth.
Major Changes for Developers:
- [Feat.] TextWidget (String -> Component): The text widget now also accepts a component as well as a String through the registry supplier. Components can be styled using MutableComponent when passing to the supplier.
- [Update] DynamicValueReigstry rewritten: The registry has become fully shared and now requires Identifier as key.
- [Fix.] Styled characters in drawChromaText:
drawChromaTextnow accepts and renders components with their original styles. - [Refactor]:
drawScalableTextanddrawTruncatedScaledTexthave been moved toDrawHelper. - [Feat.]
Util.getSearchResults(): The function will either flatten and sort the resultant options, or return sorted option groups + options as per the booleanflattenset in function parameter. - [Refactor.] Change in option
name,descriptionandvalueaccess specifiers: Use the getters for their fields respectively. - [Feat.]
renderTooltipIfHovered(): Function was overloaded and now waits for a specified delay before displaying the tooltip. - [Feat.]
valudIdin WidgetBuilder: For widgets usingDynamicValueWidget, the fieldsregistryKeyandregistryIdhave been replaced withIdentifier valueId - Full Changelog: https://github.com/V-Fast/DynamicHUD/compare/v4.1.0...v5.0.0
The Wiki has also been updated.
4.1.0Релиз1.21.11 · 4 июля 2026 г.
This version comes with many important features.
Major Highlights for Users:
- Smarter Snap & Anchoring: Widgets snapped to screen centers or margins will now adapt correctly and maintain their precise layout positions on screen resize/resolution changes.
- Drag Selection Window: Click and drag on empty space to draw a selection window to select multiple widgets at once and drag them together.
CTRL + LeftClickMulti-selection: HoldCTRLand click on individual widgets to toggle selection, allowing you to select and move multiple custom widgets.- Widget Grouping (
CTRL + G): Select multiple widgets and pressCTRL + Gto group them. Grouped widgets move together. - Dynamic Scaling Tools: Drag the new scale dot on the bottom-right corner of a selected widget, or hover over a widget and press
CTRL + Mouse Wheel Scrollto resize it. - Name Truncation: Long option names are now automatically truncated with
..., preventing overlap in compact context menus. - Locked Widget Fix: Locked widgets now correctly adapt their positions on screen resizing instead of staying at stale coordinates.
- YACL Global Configurations:
Enable Drag Selection: Toggles drawing select-dragging box overlays.Dashed Outline Color & Thickness: Custom colors and width parameters for widget guidelines.Show Lock Button & Lock Size: Custom sizes and display toggles for lock/unlock icons.Scale Dot Size & Scale Sensitivity: Fine-tune size and scale dragging speeds.Smart Snapping & Snap Size: Adjust axis alignments and snap grid sizes.
Major Changes for Developers:
- [Feat.] Node-Based Layouts: The
LayoutEnginenow processes context menu layouts using tree nodes (ColumnNode,GridNode,RowNode, etc.). (Currently used by ClassicSkin) - [Feat.] Properties Cleanup: Cleaned up the redundant
paddingandheightOffsetproperties fromContextMenuProperties, offloading positioning and gaps to layout strategies. - [Feat.] Keybind Options: Added support and documentation for
KeybindOptionallowing GLFW keyboard bindings to have dedicated UI option card renderers. - [Feat.] Widget Groups: Introduced the
WidgetGroupclass for linking multiple widgets together, supporting unlocked member drag propagation and unified outline box rendering. - [Feat.] Better Anchors: Replaced absolute offsets with precise anchoring. Widgets automatically detect their closest screen zone (out of 9 possible zones) to calculate precise relative positioning on window resizing.
- [Fix.] Screen Resize Injections: Fixed a bug in
ScreenMixinwhere the mixin was passing the old screen sizes instead of the new dimensions during a resize callback. - [Fix.] UUID Unique Identifiers: Replaced String-based
UIDunique identifiers in widgets withjava.util.UUID. - [Fix.] Option Name Truncation: Added utility functions
Util.getTruncatedNameandUtil.drawTruncatedScaledTextinUtil.javato support clean text rendering. - [Feat.] Base-Class Skin Renderers: Derived skins can now inherit their option renderers from the base class if not explicitly overridden.
The Wiki has also been updated.
4.0.0Релиз1.21.11 · 26 июня 2026 г.
Update to 1.21.11
DynamicHUD has been updated to minecraft version 1.21.11 with the release of
4.0.0
This version comes with many important patches and improvements.
Major Highlights for Users:
- Neighbouring Widget Snap: An option has been added for users to use
smart snappingwhich enables widgets to snap around each other smoothly and also displays useful screen and widget axis alignment guidelines while dragging. - Color Picker: The color picker has been added back after being removed in previous versions.
- Enhanced Animations: Much more of the DynamicHUD UI comes with smoother and interactive animations.
- Performance Optimisations: This version is set to give a better and seamless experience with widgets.
- More options: We have added more options in the YACL configuration screen to help with more customisability.
- Separated Widget Scaling: Now users will be able to scale each widget separately by simply hovering over the widget and pressing
CTRL + MOUSE-SCROLL. This will allow you to change the size of any scalable widget as per your convenience. This is in addition to the Global Widget Scale in YACL configurations. - No jittering: All jitters are removed.
- Search Bar: A search bar has been added to the top of the context menu for some of the ContextMenu skins.
- GraphWidget Improvements: GraphWidget has been heavily improved to display clearer graph lines and points, better auto-range, sampling time, less intrusive label and more customisability for
ProandEnhancedsetting complexities. - Skins: All skins will now feel faster.
Major Changes for Developers:
The update to 1.21.11 also brings new changes to how things are rendered, so all rendering methods have been changed appropriately.
DynamicHUD now uses
official mojang mappingsinstead ofYarnmappings.
- [Feat.] Graph Control: Added new methods to let you change the timeline points (how long ago values should be displayed) and customize sampling rates. The graph will automatically rebuild its data array on the fly without losing previous values.
- [Feat.] Scaling related: Since widgets now contain localised scaling, you will need to use the widgetBox for current (modified) width and height after providing your raw dimensions.
- [New] Cycle Option: Both
EnumOptionandListOptionare replaced by a singleCycleOption. Hence all your skins need to be updated too. - [New] LayoutEngine: ContextMenu now uses a layout engine for options. A default VerticalFlow layout strategy is provided which is used by Classic, Modern and Minecraft Skins. This layout engine can be used to modify the
padding,spacingandminimum widthof options. - [New] Search: The following function can now be used to obtain search results from a query string through all options and option groups using
FuzzyScorematching:com.tanishisherewith.dynamichud.utils.Util.getSearchResults(String query, int minimumScore, List<Option<?>> options) - [New] MouseColorQuery: MouseColorQuery is a class that can be used to query color at a given mouse position at the end of the client tick. Used by the ColorPicker.
- [Fix.] ScrollHandler logic rewritten: To prevent jittering.
- [Removed] AnimationProperty<>: AnimationProperty was replaced by a consumer in
ValueAnimation. - [New] SquishAnimator: Used for a simple button squish effect in ModernSkin.
- [Fix] Skin.charTyped(...): This function call was missing in contextmenu and has been added.
- [Feat.] Animation Overhaul: Now all appropriate animation is being handled by
ValueAnimationor such instead of hardcoding a linear lerp. For eg. ContextMenu now also use localised scaling. - [Feat.] ModernSkin OptionGroup animation: OptionGroups in ModernSkin now have opening animation handled by static class
GroupAnimData.
And much more in-depth changes which will be updated soon in our Wiki.
3.1.0Релиз1.21.5 · 28 июня 2025 г.
Major Changes
Updated to 1.21.5
Minor Changes
Moved rounded rectangles and its outline code to shaders
Full Changelog: https://github.com/V-Fast/DynamicHUD/compare/v3.0.0...v3.1.0
3.0.0Релиз1.21.4 · 1 июня 2025 г.
Important Changes for users
- Updated to 1.21.4
- Many new options to config screen to improve customisability
- Added option
complexityfor context menu options to allow users focus on their priorities for customisation and remove bloat options. - Using chroma text for TextWidget Rainbow, along with more customisation to the rainbow effect with
enhancedoption complexity. - New Context Menu Skins like ModernSkin, ClassicSkin, MinecraftSkin
- Easier mod management
- Better error reports, with a warning screen to indicate if a mod failed to properly integrate with DynamicHUD
- Removed ColorPicker from ColorOption :(
- Optimised
TODO: Backwards compatibility and forward compatibility.
Important changes for developers:
- API has been updated thoroughly from previous version. Highly recommended to visit the documentation for full guide.
- Gitbook has been updated for this version.
- Complete Guide on migrating to 3.0.0
What's Changed
- Another mega update. Especially to ContextMenu. by @tanishisherewithhh in https://github.com/V-Fast/DynamicHUD/pull/4
Full Changelog: https://github.com/V-Fast/DynamicHUD/compare/v2.2.1...v3.0.0
2.2.1Релиз1.21, 1.21.1 · 16 августа 2024 г.
Updated Gradle to use Java 21 instead of Java 17. Not much code changes.
2.2.0Релиз1.21 · 24 июля 2024 г.
This is the official 1.21 release for minecraft fabric.
Some additional changes were made which are reflected in the GitBook/Wiki.
- New
BooleanPoolclass was added. - Updated constructors for
BooleanOption,RunnableOptionandSubMenuOption - 1.21 related changes.
- Usual dependency update.
2.1.0Релиз1.20.5, 1.20.6 · 6 июля 2024 г.
Updated DynamicHUD to 1.20.6 version.
Should support 1.20.4, 1.20.5 and 1.20.6.
Nothing much else was added.
Primary file contains the demo of DynamicHUD included. Not advised to use.
Комментарии
Загружаем…