Quick HUD 2026-09-09

Fixes

Fixed a crash where a bad error message (containing a %) could take down the entire ImGui overlay for every script running, not just Quick HUD.
Fixed the Buffs / Songs / Target Buffs example widgets throwing "Missing End()" and crashing the overlay.
Fixed a crash in the "Custom UI Example" widget on certain targets.
Fixed GM Banner erroring out when there's no GM in zone.
Fixed Time Info settings checkbox controlling the wrong section.
Fixed the Hunter tab in the zone breakdown never updating after you change zones.
Fixed custom widget scripts with a typo just rendering blank instead of showing the error.
Fixed a handful of stray/leftover arguments in ImGui calls that could silently mess with widget behavior (an auto-select-all flag was accidentally on in the script editor, for one).
Replaced a few deprecated calls for better compatibility going forward.
Settings saves are now atomic, so a crash mid-save can't corrupt your config file anymore.
Settings loading no longer takes down the whole script if the config file is corrupted, it just logs it and moves on.
Fixed the hover-to-edit pencil icon on custom widgets flickering.
Fixed the icon picker wrapping one icon too many per row.
Fixed a client crash when opening the Advanced settings tab (used to shell out to cmd.exe on the render thread to list config files).
Settings window is now crash-resilient overall, an error in one settings tab can't wreck the rest of the window.
Fixed an ImGui ID collision on the Lua Info stop buttons when multiple scripts are running.
Fixed custom widget add/delete/save causing visual glitches elsewhere on screen the same frame.
Group HP bars widget (new, see below) showed "Unknown" for your own name, now pulls it correctly.
Cleaned up ~50 stray global variables under the hood, no visible change but less chance of future bugs.
New

Lua Info panel: shows currently running Lua scripts (name, PID, status) with a stop button for each, right in the HUD and in Settings.
7 new example widgets under a new "Utility" category: bag space remaining, platinum on hand, group HP bars, a pull/fight stopwatch, AA/hour rate tracker, low HP self-alert, and an aggro % bar. Grab them from Custom Widgets → Example Widgets.
Titles added to the Buffs/Songs/Worn Equipment/Inventory Equipment example widgets so they're labeled at a glance.
Changed

Default display order: Time/Targets now show above Macro Status/Lua Info.

Put a patch on the crashing clicking the Character Settings.
The icon is still there but, You lose the function to change the character icon. But it works.

- Updated the crash with .new changes
- moved the main lua script to the new init.lua format inside the folder

Added some additional example widgets
- Player buffs
- Target buffs
- Player worn items
- Wearable items in inventory
- Player casting bar

Added a state mechanism to the widgets so that implementations can maintain state across renders.
Added some library code to support the new widgets

Fixed height label in widget editor

This change includes the ability to add custom elements to the HUD.

Thanks to @KingArthur for motivating me to finally implement this feature.

Example: (this is a but ugly but used for demonstration purposes)

There will now but a

button that will now appear in the "Custom Elements" section of the HUD. Clicking this button will add a row to the HUD that will allow you to define your own custom elements in columns.

There are two basic types of elements you can add to the HUD
- Label: Provides information based on the script
- Button: Can perform an action when clicked

The elements have a small amount of customization and can be conditionally displayed. Right now they are layed out in the HUD along rows and columns, the columns allow for resizing width. This works well for now but I might change this paradigm when I advance this feature further.

NOTE: The implementation includes some examples that are available when adding a blank row. Hopefully all the functionality is discoverable enough because I haven't written the documentation yet but if you have any questions please feel free to reach out to me.

Click to expand...

Here are some examples of configuring different types of elements.

Basic Label	Basic Label w/condition	Basic Button	Advanced Button	Advanced Button w/condition	Advanced Custom UI

As always, please let me know if you have any suggestions that you think would be an improvement. I use this tool personally so I try to make it as useful as possible.

There are quite a few changes in this update as I did a poor job at compartmentalizing enhancements. The list below is a summary of a good deal of the changes.

NOTE: If any of the updates break anything or if you find them particularly upsetting please let me know and I'm happy to make improvements.

Click to expand...

Changes​

• changed to use short class names by default (this is configurable)
• categorized settings window settings to reduce clutter
• made macro button labels optional
• removed color from target aggro indicator

New Features​

• added mechanism to lock window in the current position (inspired by an implementation @Sic had in the invisdisplay tool)
  • This allows the window to maintain position when the game window loses focus
  • Can also synchronize position, dimensions and locking with other clients on a DanNet network
• added ability to change window background color
• added ability to change window text color
• added alpha level for combat states background
• added combat states background colors for each individual state
• added con colors to target area
• added status icon for combat state in character row
• added breakout window for zone breakdown that shows additional information of zone entities
  • Note: These operations are expensive so the list for any given table is limited to 200 entries and there is no filter to reduce the set currently.
  • table of players by guild
  • table of all players in zone
  • table of all npcs in zone
  • table of all named npcs in zone
• hud areas in the UI are now reorderable in the advanced settings
• added configuration setting for content spacing
• added configuration setting for showing line separaters between hud areas
• added links to reguides page and code repo for project in the settings window
• added colors to macro controls
• added indicator to display LOS status for targets

Fixes​

• fixed combat state active showing when parent option was disabled
• fixed issue where GM bar would cause an error or crash to occur instead of doing its job
  • The bar will now show up appropriately

Added an optional subscription indicator in the character line, the text is optional as well.

• 
• 

Fixed an issue where the HUD could crash when zoning because of the new window naming scheme.

• Added option for background style for stats area depending on combat state
  
  
• Added toggle for window title (default off)
• Added option for window opacity (does not work when docked)
• Added option for content opacity
  
  
• Rounded corners on widgets
• Applied a default window size
• Fixed issue where window would collapse when clicking bookmark or nav buttons when window wasn't docked

Note:
This change includes a change to the HUD window name used in the mqoverlay and as such it will reset the window position you have saved, I am sorry for this inconvenience.

Click to expand...