HUDFramework
fallout-4 — Mods & Enhancements
HUDFramework is a scripting library that provides a standardized, mod-friendly API for creating custom HUD (Heads-Up Display) elements in Fallout 4. Instead of directly editing the game's SWF files (which often break with updates or conflict with other mods), modders use HUDFramework to add new widgets like status bars, timers, or custom icons that appear on screen. Players install it as a dependency for many popular mods like 'Sim Settlements 2', 'FallUI', or 'Immersive HUD', because it ensures those mods' HUD elements work reliably and can be repositioned or styled without conflicts.
View on discovermods →Syntax
User InterfaceExample
Downloads: 7,167,859 | Endorsements: 107,220💡 Notes
By registrator2000 | v1.0f | 107,220 endorsements
🎯 Tips & Tricks
On the mod's Nexus page, look for 'Requirements' section. If it lists HUDFramework, you must install it FIRST and load it BEFORE the dependent mod. In Vortex, HUDFramework's ESP should be placed at the top of your load order, right after the base game and DLCs, but before any UI overhaul mods like 'FallUI' or 'DEF_UI'.
Open the file 'Data/F4SE/Plugins/HUDFramework.ini' with a text editor. You can change the default scale, position, and opacity of all HUD elements by editing the 'Scale', 'X', 'Y', and 'Alpha' values under each widget's section. For example, to move a widget to the top-right corner, set 'X=1920' and 'Y=0' (assuming 1080p). After editing, restart the game.
If you have 'Mod Configuration Menu' installed, you'll see a 'HUD Framework' entry in the pause menu. Use it to toggle individual widgets on/off, change their scale, and even set per-widget opacity. This is the easiest way to adjust mod-added HUD elements without editing INIs, and it saves your settings automatically.
🔧 Troubleshooting
Mods that require HUDFramework fail to show their HUD elements, or the game crashes when loading a save with those mods active
This is almost always a load order issue. HUDFramework's ESP must load BEFORE any mod that uses it. In Vortex, right-click the dependent mod and set 'Load After' to 'HUDFramework'. Also, ensure you have the latest version of F4SE installed, as HUDFramework relies on F4SE for its scripting. If the crash persists, try reinstalling HUDFramework and verify the file integrity via Vortex.
HUDFramework conflicts with 'FallUI - HUD' or 'Immersive HUD - iHUD', causing duplicate or overlapping HUD elements
These mods both modify the vanilla HUD layout. You cannot use them simultaneously with HUDFramework without a patch. Use the 'FallUI - HUD' compatibility patch from the 'FallUI' Nexus page, or disable iHUD's 'HUD element' toggles and instead use HUDFramework's own toggle for those elements. The recommended approach: use FallUI instead of iHUD, as it natively supports HUDFramework.
⚠️ Common Mistakes
- [object Object]
- [object Object]
👍 Pros
- 107,220 endorsements
- 7,167,859 downloads
- Category: User Interface
👎 Cons
- Requires mod manager installation
- May conflict with similar mods