Tooltip: game-style formatting with section labels, tail alignment, and config options

- Add TooltipSegment and colored formatting (section labels green, status names yellow)
- Sections: Additional Effect, Duration, Maximum Charges, Blood Gauge Cost, Combo, role labels
- Tail text (e.g. 'Cannot be executed while bound.', parenthetical notes) now left-aligned on own line
- Section values (e.g. '2', '50', '30m') stay on same line as labels
- Config: Use Game-style formatting, Section/Status/Secondary colors
- Config: Tooltip Max Width, Line Spacing, Font Scale, Icon Scale, Height Buffer slider
- ActionBarsHud: pass formatted segments to ShowTooltipOnCursor when game-style enabled

Co-authored-by: Cursor <cursoragent@cursor.com>

Config/ConfigurationManager.cs

@@ -675,6 +675,7 @@ namespace HSUI.Config
             // Other Elements
             typeof(ExperienceBarConfig),
             typeof(GCDIndicatorConfig),
+            typeof(MouseGCDIndicatorConfig),
             typeof(HotbarsConfig),
             typeof(Hotbar1BarConfig),
             typeof(Hotbar2BarConfig),

HSUI.csproj

@@ -9,9 +9,9 @@
 
 	<PropertyGroup>
 		<AssemblyName>HSUI</AssemblyName>
-		<AssemblyVersion>1.0.8.12</AssemblyVersion>
-		<FileVersion>1.0.8.12</FileVersion>
-		<InformationalVersion>1.0.8.12</InformationalVersion>
+		<AssemblyVersion>1.0.8.14</AssemblyVersion>
+		<FileVersion>1.0.8.14</FileVersion>
+		<InformationalVersion>1.0.8.14</InformationalVersion>
 	</PropertyGroup>
 
 	<PropertyGroup>

HSUI.json

@@ -2,7 +2,7 @@
   "Author": "Knack117",
   "Name": "HSUI",
   "InternalName": "HSUI",
-  "AssemblyVersion": "1.0.8.12",
+  "AssemblyVersion": "1.0.8.14",
   "Description": "HSUI provides a highly configurable HUD replacement for FFXIV, recreated from DelvUI using KamiToolKit, FFXIVClientStructs, and Dalamud. Features unit frames, castbars, job gauges, nameplates, party frames, status effects, enemy list, configurable hotbars with drag-and-drop, and profiles.",
   "ApplicableVersion": "any",
   "RepoUrl": "https://github.com/Knack117/HSUI",

Helpers/TooltipsHelper.cs

@@ -8,11 +8,27 @@ using HSUI.Interface.GeneralElements;
 using Dalamud.Bindings.ImGui;
 using FFXIVClientStructs.FFXIV.Client.Game.Object;
 using System;
+using System.Collections.Generic;
+using System.Linq;
 using System.Numerics;
 using System.Text;
+using System.Text.RegularExpressions;
 
 namespace HSUI.Helpers
 {
+    /// <summary>Colored segment for game-style tooltip formatting.</summary>
+    public readonly struct TooltipSegment
+    {
+        public readonly string Text;
+        public readonly Vector4 Color;
+
+        public TooltipSegment(string text, Vector4 color)
+        {
+            Text = text ?? "";
+            Color = color;
+        }
+    }
+
     /// <summary>When showing an ID in the tooltip title, use Action for action IDs or Status for status effect IDs.</summary>
     public enum TooltipIdKind
     {
@@ -54,7 +70,7 @@ namespace HSUI.Helpers
         }
         #endregion
 
-        private float MaxWidth => Math.Max(160, 340 * ImGuiHelpers.GlobalScale * _config.TooltipScale);
+        private float MaxWidth => Math.Max(160, _config.TooltipMaxWidth * ImGuiHelpers.GlobalScale * _config.TooltipScale);
         private float Margin => Math.Max(4, 5 * ImGuiHelpers.GlobalScale * _config.TooltipScale);
 
         private TooltipsConfig _config => ConfigurationManager.Instance.GetConfigObject<TooltipsConfig>();
@@ -65,6 +81,7 @@ namespace HSUI.Helpers
         private Vector2 _titleSize;
         private string? _previousRawText = null;
         private uint? _currentIconId = null;
+        private List<TooltipSegment>? _formattedSegments = null;
 
         private Vector2 _position;
         private Vector2 _size;
@@ -73,12 +90,12 @@ namespace HSUI.Helpers
 
         private const float IconSize = 24f;
 
-        public void ShowTooltipOnCursor(string text, string? title = null, uint id = 0, string name = "", uint? iconId = null, TooltipIdKind idKind = TooltipIdKind.None)
+        public void ShowTooltipOnCursor(string text, string? title = null, uint id = 0, string name = "", uint? iconId = null, TooltipIdKind idKind = TooltipIdKind.None, List<TooltipSegment>? formattedText = null)
         {
-            ShowTooltip(text, ImGui.GetMousePos(), title, id, name, iconId, idKind);
+            ShowTooltip(text, ImGui.GetMousePos(), title, id, name, iconId, idKind, formattedText);
         }
 
-        public void ShowTooltip(string text, Vector2 position, string? title = null, uint id = 0, string name = "", uint? iconId = null, TooltipIdKind idKind = TooltipIdKind.None)
+        public void ShowTooltip(string text, Vector2 position, string? title = null, uint id = 0, string name = "", uint? iconId = null, TooltipIdKind idKind = TooltipIdKind.None, List<TooltipSegment>? formattedText = null)
         {
             if (text == null)
             {
@@ -95,6 +112,7 @@ namespace HSUI.Helpers
             }
 
             _currentIconId = iconId;
+            _formattedSegments = formattedText;
 
             // calcualte title size
             _titleSize = Vector2.Zero;
@@ -124,20 +142,42 @@ namespace HSUI.Helpers
                 }
             }
 
-            // calculate text size
+            // calculate text size (build combined text from segments for sizing)
             string fontIdForText = _config.FontID ?? FontsConfig.DefaultSmallFontKey;
             using (FontsManager.Instance.PushFont(fontIdForText))
+            {
+                float lineHeight = ImGui.GetTextLineHeight();
+                if (_formattedSegments != null && _formattedSegments.Count > 0)
+                {
+                    var sb = new StringBuilder();
+                    int newlineCount = 0;
+                    foreach (var seg in _formattedSegments)
+                    {
+                        sb.Append(seg.Text);
+                        if (seg.Text == "\n") newlineCount++;
+                    }
+                    _textSize = ImGui.CalcTextSize(sb.ToString(), false, MaxWidth);
+                    // Account for Dummy spacing between sections (each \n adds compactSpacing)
+                    float compactSpacing = Math.Max(2, lineHeight * _config.TooltipLineSpacing);
+                    _textSize.Y += newlineCount * compactSpacing;
+                }
+                else
                 {
                     _textSize = ImGui.CalcTextSize(_currentTooltipText, false, MaxWidth);
                 }
+            }
 
-            float contentWidth = Math.Max(_titleSize.X, _textSize.X);
-            float contentHeight = _titleSize.Y + _textSize.Y;
-            float iconSizeScaled = IconSize * ImGuiHelpers.GlobalScale * _config.TooltipScale;
+            float fontScale = Math.Max(0.7f, _config.TooltipFontScale);
+            float contentWidth = Math.Max(_titleSize.X, _textSize.X) * fontScale;
+            float contentHeight = (_titleSize.Y + _textSize.Y) * fontScale;
+            float iconSizeScaled = IconSize * ImGuiHelpers.GlobalScale * _config.TooltipScale * _config.TooltipIconScale;
             float iconGap = _currentIconId.HasValue && _currentIconId.Value > 0 ? iconSizeScaled + Margin : 0;
+            // Add buffer to prevent clipping (font/scale changes, rounding, padding)
+            float heightBuffer = _config.TooltipHeightBuffer;
+            float minContentHeight = contentHeight + heightBuffer;
             _size = new Vector2(
                 contentWidth + iconGap + Margin * 2,
-                Math.Max(contentHeight, _currentIconId.HasValue && _currentIconId.Value > 0 ? iconSizeScaled : 0) + Margin * 2);
+                Math.Max(minContentHeight, _currentIconId.HasValue && _currentIconId.Value > 0 ? iconSizeScaled + Margin * 2 : 0) + Margin * 2);
 
             // position tooltip using the given coordinates as bottom center
             position.X = position.X - _size.X / 2f;
@@ -270,6 +310,41 @@ namespace HSUI.Helpers
         public void RemoveTooltip()
         {
             _dataIsValid = false;
+            _formattedSegments = null;
+        }
+
+        private void DrawTooltipBody()
+        {
+            if (_formattedSegments != null && _formattedSegments.Count > 0)
+            {
+                bool afterNewline = true;
+                float lineHeight = ImGui.GetTextLineHeight();
+                float compactSpacing = Math.Max(2, lineHeight * _config.TooltipLineSpacing);
+
+                foreach (var seg in _formattedSegments)
+                {
+                    if (seg.Text == "\n")
+                    {
+                        ImGui.Dummy(new Vector2(0, compactSpacing));
+                        afterNewline = true;
+                    }
+                    else if (!string.IsNullOrEmpty(seg.Text))
+                    {
+                        if (!afterNewline)
+                            ImGui.SameLine(0, 0);
+                        string text = afterNewline ? seg.Text.TrimStart() : seg.Text;
+                        if (!string.IsNullOrEmpty(text))
+                        {
+                            ImGui.TextColored(seg.Color, text);
+                            afterNewline = false;
+                        }
+                    }
+                }
+            }
+            else
+            {
+                ImGui.TextColored(_config.TextColor.Vector, _currentTooltipText);
+            }
         }
 
         public void Draw()
@@ -303,6 +378,7 @@ namespace HSUI.Helpers
 
             ImGui.PushStyleVar(ImGuiStyleVar.WindowRounding, 0);
             ImGui.Begin("DelvUI_tooltip", windowFlags);
+            ImGui.SetWindowFontScale(_config.TooltipFontScale);
             var drawList = ImGui.GetWindowDrawList();
 
             drawList.AddRectFilled(_position, _position + _size, _config.BackgroundColor.Base);
@@ -316,7 +392,7 @@ namespace HSUI.Helpers
             float globalScaleCorrection = -15 + 15 * ImGuiHelpers.GlobalScale;
 
             string fontId = _config.FontID ?? FontsConfig.DefaultSmallFontKey;
-            float iconSizeScaled = IconSize * ImGuiHelpers.GlobalScale * _config.TooltipScale;
+            float iconSizeScaled = IconSize * ImGuiHelpers.GlobalScale * _config.TooltipScale * _config.TooltipIconScale;
             float iconGap = (_currentIconId.HasValue && _currentIconId.Value > 0) ? iconSizeScaled + Margin : 0;
             float wrapWidth = (_currentIconId.HasValue && _currentIconId.Value > 0)
                 ? _size.X - iconGap - Margin * 2
@@ -342,19 +418,19 @@ namespace HSUI.Helpers
                     ImGui.PopTextWrapPos();
                 }
 
-                // text
+                // text (formatted or plain)
                 using (FontsManager.Instance.PushFont(fontId))
                 {
                     cursorPos = new Vector2(textBlockX, Margin + _titleSize.Y);
                     ImGui.SetCursorPos(cursorPos);
                     ImGui.PushTextWrapPos(cursorPos.X + wrapWidth + globalScaleCorrection);
-                    ImGui.TextColored(_config.TextColor.Vector, _currentTooltipText);
+                    DrawTooltipBody();
                     ImGui.PopTextWrapPos();
                 }
             }
             else
             {
-                // text
+                // text (formatted or plain)
                 using (FontsManager.Instance.PushFont(fontId))
                 {
                     var cursorPos = new Vector2(textBlockX, Margin);
@@ -362,11 +438,12 @@ namespace HSUI.Helpers
 
                     ImGui.SetCursorPos(cursorPos);
                     ImGui.PushTextWrapPos(cursorPos.X + textWidth + globalScaleCorrection);
-                    ImGui.TextColored(_config.TextColor.Vector, _currentTooltipText);
+                    DrawTooltipBody();
                     ImGui.PopTextWrapPos();
                 }
             }
 
+            ImGui.SetWindowFontScale(1f);
             ImGui.End();
             ImGui.PopStyleVar();
 
@@ -375,6 +452,211 @@ namespace HSUI.Helpers
             RemoveTooltip();
         }
 
+        /// <summary>
+        /// Parses action/ability description text into colored segments for game-style tooltips.
+        /// Adds newlines before section headers and colors: section labels (Additional Effect, Duration) green,
+        /// status names (e.g. Blood of the Dragon) yellow, secondary labels grey.
+        /// </summary>
+        public static List<TooltipSegment> FormatActionTooltip(string description, Vector4 textColor, Vector4 sectionLabelColor, Vector4 statusNameColor)
+        {
+            var result = new List<TooltipSegment>();
+            if (string.IsNullOrEmpty(description))
+                return result;
+
+            // Pattern: section labels to color (Additional Effect, Duration, X Effect, Maximum Charges, Blood Gauge Cost, Combo, roles)
+            var sectionRegex = new Regex(@"\b(Additional Effect:|Duration:|Maximum Charges:|Blood Gauge Cost:|Combo Action:|Combo Potency:|Combo Bonus:|Tank:|Melee:|Ranged:|Caster:|Healer:|[A-Za-z][A-Za-z0-9\s]+ Effect:)", RegexOptions.None);
+            // Pattern: "Grants X X Effect:" - captures status name X
+            var grantsRegex = new Regex(@"Grants\s+(.+?)\s+\1\s+Effect:", RegexOptions.Singleline);
+
+            int lastEnd = 0;
+            foreach (Match m in sectionRegex.Matches(description))
+            {
+                string chunk = description.Substring(lastEnd, m.Index - lastEnd).TrimEnd();
+                if (!string.IsNullOrEmpty(chunk))
+                {
+                    // Check for "Grants StatusName" in this chunk to color status name yellow
+                    var grantsMatch = grantsRegex.Match(chunk);
+                    if (grantsMatch.Success)
+                    {
+                        string statusName = grantsMatch.Groups[1].Value.Trim();
+                        string grantsPrefix = "Grants " + statusName;
+                        int idx = chunk.IndexOf(grantsPrefix, StringComparison.Ordinal);
+                        if (idx >= 0)
+                        {
+                            if (idx > 0)
+                                result.Add(new TooltipSegment(chunk.Substring(0, idx), textColor));
+                            result.Add(new TooltipSegment("Grants ", textColor));
+                            result.Add(new TooltipSegment(statusName + " ", statusNameColor));
+                            int after = idx + grantsPrefix.Length;
+                            if (after < chunk.Length)
+                                result.Add(new TooltipSegment(chunk.Substring(after), textColor));
+                        }
+                        else
+                            result.Add(new TooltipSegment(chunk, textColor));
+                    }
+                    else
+                        result.Add(new TooltipSegment(chunk, textColor));
+                }
+
+                result.Add(new TooltipSegment("\n", textColor));
+                result.Add(new TooltipSegment(m.Value + " ", sectionLabelColor));
+                // Add newline so description wraps below label like stock game (not floating beside it)
+                if (m.Value.IndexOf("Effect:", StringComparison.OrdinalIgnoreCase) >= 0)
+                    result.Add(new TooltipSegment("\n", textColor));
+                lastEnd = m.Index + m.Length;
+            }
+            if (lastEnd < description.Length)
+            {
+                string tail = description.Substring(lastEnd).TrimStart();
+                if (!string.IsNullOrEmpty(tail))
+                {
+                    string valuePart = "";
+                    string notePart = "";
+                    bool hasValue = false;
+
+                    int newlineIdx = tail.IndexOf('\n');
+                    if (newlineIdx >= 0)
+                    {
+                        // "2\nCannot be executed..." - value on first line, note on next
+                        valuePart = tail.Substring(0, newlineIdx).TrimEnd();
+                        notePart = tail.Substring(newlineIdx + 1).TrimStart();
+                        hasValue = Regex.IsMatch(valuePart, @"^\d+[ms]?$");
+                    }
+                    else
+                    {
+                        // "2 Cannot be executed while bound." - value + space + note (no newline)
+                        var valueNoteMatch = Regex.Match(tail, @"^(\d+[ms]?)\s+([A-Z].+)$", RegexOptions.Singleline);
+                        if (valueNoteMatch.Success)
+                        {
+                            valuePart = valueNoteMatch.Groups[1].Value;
+                            notePart = valueNoteMatch.Groups[2].Value;
+                            hasValue = true;
+                        }
+                        else if (Regex.IsMatch(tail, @"^\d+[ms]?$"))
+                        {
+                            // Plain value only: "50" (Blood Gauge Cost), "2" (charges) - stay on same line as label
+                            valuePart = tail;
+                            hasValue = true;
+                        }
+                    }
+
+                    // Add valuePart when present - section content (e.g. "Restore party HP..." for Healer, "2" for charges)
+                    if (!string.IsNullOrEmpty(valuePart))
+                    {
+                        result.Add(new TooltipSegment(valuePart, textColor));
+                    }
+                    if (!string.IsNullOrEmpty(notePart))
+                    {
+                        result.Add(new TooltipSegment("\n", textColor));
+                        result.Add(new TooltipSegment(notePart, textColor));
+                    }
+                    else if (!hasValue)
+                    {
+                        // Standalone note: "(Duration can be extended...)", "Cannot be executed...", footnotes
+                        result.Add(new TooltipSegment("\n", textColor));
+                        result.Add(new TooltipSegment(tail, textColor));
+                    }
+                }
+            }
+
+            return result;
+        }
+
+        /// <summary>
+        /// Builds formatted segments from a full action tooltip body (stats + description).
+        /// Used when UseGameStyleFormatting is enabled.
+        /// Stats are placed first, then exactly one newline, then description below.
+        /// </summary>
+        public static List<TooltipSegment>? BuildFormattedActionTooltipBody(string body, TooltipsConfig config)
+        {
+            if (string.IsNullOrEmpty(body) || !config.UseGameStyleFormatting)
+                return null;
+
+            var result = new List<TooltipSegment>();
+            var textColor = config.TextColor.Vector;
+            var sectionColor = config.SectionLabelColor.Vector;
+            var statusColor = config.StatusNameColor.Vector;
+            var secondaryColor = config.SecondaryLabelColor.Vector;
+
+            var blocks = body.Split(new[] { "\n\n" }, StringSplitOptions.None);
+            int descStart = 0;
+            bool hasStats = false;
+
+            // Stats block: may contain "Potency: X" and "Cast: ... | Recast: ..." on separate lines
+            for (int i = 0; i < blocks.Length; i++)
+            {
+                string block = blocks[i].Trim();
+                var lines = block.Split(new[] { '\n' }, StringSplitOptions.RemoveEmptyEntries);
+                bool blockIsStats = false;
+                foreach (string line in lines)
+                {
+                    string part = line.Trim();
+                    if (part.StartsWith("Potency:", StringComparison.OrdinalIgnoreCase))
+                    {
+                        if (hasStats) result.Add(new TooltipSegment("\n", textColor));
+                        result.Add(new TooltipSegment("Potency:", secondaryColor));
+                        result.Add(new TooltipSegment(" " + part.Substring(8).TrimStart(), textColor));
+                        hasStats = true;
+                        blockIsStats = true;
+                    }
+                    else if (part.Contains("Cast:") || part.Contains("Recast:"))
+                    {
+                        if (hasStats) result.Add(new TooltipSegment("\n", textColor));
+                        var statsSegs = FormatActionStats(part, textColor, secondaryColor);
+                        result.AddRange(statsSegs);
+                        hasStats = true;
+                        blockIsStats = true;
+                    }
+                }
+                if (!blockIsStats)
+                {
+                    descStart = i;
+                    break;
+                }
+                descStart = i + 1;
+            }
+
+            // Description: exactly one newline after stats, then description with compact section spacing
+            string desc = string.Join("\n", blocks.Skip(descStart)).Trim();
+            if (!string.IsNullOrEmpty(desc))
+            {
+                if (hasStats) result.Add(new TooltipSegment("\n", textColor));
+                var descSegs = FormatActionTooltip(desc, textColor, sectionColor, statusColor);
+                result.AddRange(descSegs);
+            }
+
+            return result.Count > 0 ? result : null;
+        }
+
+        /// <summary>
+        /// Formats action stats (Cast, Recast, Range, Radius) as colored segments.
+        /// </summary>
+        public static List<TooltipSegment> FormatActionStats(string statsLine, Vector4 textColor, Vector4 secondaryLabelColor)
+        {
+            var result = new List<TooltipSegment>();
+            if (string.IsNullOrEmpty(statsLine))
+                return result;
+
+            // statsLine format: "Cast: Instant | Recast: 60.0s | Range: 15y | Radius: 15y"
+            var parts = statsLine.Split(new[] { " | " }, StringSplitOptions.None);
+            for (int i = 0; i < parts.Length; i++)
+            {
+                if (i > 0)
+                    result.Add(new TooltipSegment(" | ", textColor));
+                int colonIdx = parts[i].IndexOf(':');
+                if (colonIdx >= 0)
+                {
+                    result.Add(new TooltipSegment(parts[i].Substring(0, colonIdx + 1), secondaryLabelColor));
+                    result.Add(new TooltipSegment(parts[i].Substring(colonIdx + 1), textColor));
+                }
+                else
+                {
+                    result.Add(new TooltipSegment(parts[i], textColor));
+                }
+            }
+            return result;
+        }
+
         private Vector2 ConstrainPosition(Vector2 position, Vector2 size)
         {
             var screenSize = ImGui.GetWindowViewport().Size;
@@ -412,21 +694,57 @@ namespace HSUI.Helpers
         public string? FontID = null;
 
         [DragFloat("Tooltip Scale", min = 0.5f, max = 2f, help = "Scale the tooltip window size. Useful for large resolutions.")]
-        [Order(6)]
+        [Order(5)]
         public float TooltipScale = 1f;
 
-        [Checkbox("Show Status Effects IDs")]
+        [DragFloat("Tooltip Max Width", min = 160f, max = 600f, help = "Maximum width of the tooltip box in pixels.")]
+        [Order(6)]
+        public float TooltipMaxWidth = 340f;
+
+        [DragFloat("Line Spacing", min = 0.2f, max = 1.5f, help = "Spacing between lines and sections (1 = normal, lower = compact).")]
         [Order(7)]
+        public float TooltipLineSpacing = 0.6f;
+
+        [DragFloat("Font Scale", min = 0.7f, max = 1.5f, help = "Scale factor for tooltip font size.")]
+        [Order(8)]
+        public float TooltipFontScale = 1f;
+
+        [DragFloat("Icon Scale", min = 0.5f, max = 2f, help = "Scale factor for the ability/status icon in tooltips.")]
+        [Order(9)]
+        public float TooltipIconScale = 1f;
+
+        [DragFloat("Height Buffer", min = 0f, max = 80f, help = "Extra space at bottom of tooltip to prevent clipping. Adjust if text is cut off.")]
+        [Order(10)]
+        public float TooltipHeightBuffer = 28f;
+
+        [Checkbox("Show Status Effects IDs")]
+        [Order(11)]
         public bool ShowStatusIDs = false;
 
         [Checkbox("Show Action ID", help = "Show action ID in hotbar and action tooltips.")]
-        [Order(8)]
+        [Order(12)]
         public bool ShowActionIDs = false;
 
         [Checkbox("Show Source Name")]
-        [Order(10)]
+        [Order(13)]
         public bool ShowSourceName = false;
 
+        [Checkbox("Game-style formatting", help = "Color section labels (Additional Effect, Duration) green, status names yellow, and add new lines between sections like the base game tooltips.")]
+        [Order(14)]
+        public bool UseGameStyleFormatting = true;
+
+        [ColorEdit4("Section Label Color", help = "Color for labels like 'Additional Effect:', 'Duration:'.")]
+        [Order(15)]
+        public PluginConfigColor SectionLabelColor = new PluginConfigColor(new(0f, 255f / 255f, 0f, 1f));
+
+        [ColorEdit4("Status Name Color", help = "Color for buff/status effect names like 'Blood of the Dragon'.")]
+        [Order(16)]
+        public PluginConfigColor StatusNameColor = new PluginConfigColor(new(255f / 255f, 255f / 255f, 0f, 1f));
+
+        [ColorEdit4("Secondary Label Color", help = "Color for Cast, Recast, Range, Radius labels.")]
+        [Order(17)]
+        public PluginConfigColor SecondaryLabelColor = new PluginConfigColor(new(204f / 255f, 204f / 255f, 204f / 255f, 1f));
+
         [ColorEdit4("Background Color")]
         [Order(15)]
         public PluginConfigColor BackgroundColor = new PluginConfigColor(new(19f / 255f, 19f / 255f, 19f / 255f, 190f / 250f));

Interface/GeneralElements/ActionBarsHud.cs

@@ -370,7 +370,9 @@ namespace HSUI.Interface.GeneralElements
                             if (!string.IsNullOrEmpty(title) || !string.IsNullOrEmpty(text))
                             {
                                 string body = string.IsNullOrEmpty(text) ? title : text;
-                                TooltipsHelper.Instance.ShowTooltipOnCursor(body, title, slot.ActionId, "", slot.IconId > 0 ? slot.IconId : null, Helpers.TooltipIdKind.Action);
+                                var tooltipConfig = ConfigurationManager.Instance?.GetConfigObject<HSUI.Helpers.TooltipsConfig>();
+                                var formatted = tooltipConfig != null ? TooltipsHelper.BuildFormattedActionTooltipBody(body, tooltipConfig) : null;
+                                TooltipsHelper.Instance.ShowTooltipOnCursor(body, title, slot.ActionId, "", slot.IconId > 0 ? slot.IconId : null, Helpers.TooltipIdKind.Action, formatted);
                                 if (IsTooltipDebugEnabled())
                                     Plugin.Logger.Information($"[HSUI Tooltip DBG] ActionBar tooltip (main overlay): slot={i} title='{title}'");
                             }
@@ -429,7 +431,9 @@ namespace HSUI.Interface.GeneralElements
                         if (!string.IsNullOrEmpty(title) || !string.IsNullOrEmpty(text))
                         {
                             string body = string.IsNullOrEmpty(text) ? title : text;
-                            TooltipsHelper.Instance.ShowTooltipOnCursor(body, title, slot.ActionId, "", slot.IconId > 0 ? slot.IconId : null, Helpers.TooltipIdKind.Action);
+                            var tooltipConfig = ConfigurationManager.Instance?.GetConfigObject<HSUI.Helpers.TooltipsConfig>();
+                            var formatted = tooltipConfig != null ? TooltipsHelper.BuildFormattedActionTooltipBody(body, tooltipConfig) : null;
+                            TooltipsHelper.Instance.ShowTooltipOnCursor(body, title, slot.ActionId, "", slot.IconId > 0 ? slot.IconId : null, Helpers.TooltipIdKind.Action, formatted);
                             if (IsTooltipDebugEnabled())
                                 Plugin.Logger.Information($"[HSUI Tooltip DBG] ActionBar tooltip (overlay): slot={i} title='{title}'");
                         }
@@ -1441,13 +1445,13 @@ namespace HSUI.Interface.GeneralElements
 
             if (slot.SlotType == RaptureHotbarModule.HotbarSlotType.Item)
             {
-                var row = Plugin.DataManager.GetExcelSheet<Item>()?.GetRow(slot.ActionId);
-                if (row.HasValue)
+                uint baseItemId = slot.ActionId >= 1000000 ? slot.ActionId - 1000000 : slot.ActionId;
+                if (Plugin.DataManager.GetExcelSheet<Item>()?.TryGetRow(baseItemId, out var itemRow) == true)
                 {
-                    string name = row.Value.Name.ToString();
+                    string name = itemRow.Name.ToString();
                     try
                     {
-                        string desc = row.Value.Description.ToDalamudString().ToString();
+                        string desc = itemRow.Description.ToDalamudString().ToString();
                         if (!string.IsNullOrEmpty(desc))
                             desc = EncryptedStringsHelper.GetString(desc);
                         return (name, desc);

Interface/GeneralElements/MouseGCDIndicatorConfig.cs

@@ -0,0 +1,74 @@
+using HSUI.Config;
+using HSUI.Config.Attributes;
+using HSUI.Enums;
+using System.Numerics;
+
+namespace HSUI.Interface.GeneralElements
+{
+    [DisableParentSettings("Position")]
+    [Section("Other Elements")]
+    [SubSection("Mouse GCD Indicator", 0)]
+    public class MouseGCDIndicatorConfig : MovablePluginConfigObject
+    {
+        [Checkbox("Always Show")]
+        [Order(3)]
+        public bool AlwaysShow = false;
+
+        [ColorEdit4("Background Color")]
+        [Order(16)]
+        public PluginConfigColor BackgroundColor = new PluginConfigColor(new Vector4(0f / 255f, 0f / 255f, 0f / 255f, 50f / 100f));
+
+        [ColorEdit4("Color")]
+        [Order(17)]
+        public PluginConfigColor FillColor = new PluginConfigColor(new(220f / 255f, 220f / 255f, 220f / 255f, 100f / 100f));
+
+        [Checkbox("Show Border")]
+        [Order(18)]
+        public bool ShowBorder = true;
+
+        [Checkbox("Instant GCDs only", spacing = true)]
+        [Order(19)]
+        public bool InstantGCDsOnly = false;
+
+        [Checkbox("Only show when under GCD Threshold", spacing = true)]
+        [Order(20)]
+        public bool LimitGCDThreshold = false;
+
+        [DragFloat("GCD Threshold", velocity = 0.01f)]
+        [Order(21, collapseWith = nameof(LimitGCDThreshold))]
+        public float GCDThreshold = 1.50f;
+
+        [Checkbox("Show GCD Queue Indicator", spacing = true)]
+        [Order(24)]
+        public bool ShowGCDQueueIndicator = true;
+
+        [ColorEdit4("GCD Queue Color")]
+        [Order(25, collapseWith = nameof(ShowGCDQueueIndicator))]
+        public PluginConfigColor QueueColor = new PluginConfigColor(new(13f / 255f, 207f / 255f, 31f / 255f, 100f / 100f));
+
+        [DragInt("Radius")]
+        [Order(35)]
+        public int CircleRadius = 40;
+
+        [DragInt("Thickness")]
+        [Order(40)]
+        public int CircleThickness = 10;
+
+        [DragInt("Start Angle", min = 0, max = 359)]
+        [Order(45)]
+        public int CircleStartAngle = 0;
+
+        [Checkbox("Rotate CCW")]
+        [Order(50)]
+        public bool RotateCCW = false;
+
+        [DragInt2("Cursor Center Offset", min = -64, max = 64)]
+        [Order(55)]
+        public Vector2 CursorCenterOffset = new Vector2(8, 16);
+
+        [NestedConfig("Visibility", 70)]
+        public VisibilityConfig VisibilityConfig = new VisibilityConfig();
+
+        public new static MouseGCDIndicatorConfig DefaultConfig() { return new MouseGCDIndicatorConfig() { Enabled = false, Strata = StrataLevel.MID_HIGH }; }
+    }
+}

Interface/GeneralElements/MouseGCDIndicatorHud.cs

@@ -0,0 +1,140 @@
+using System;
+using HSUI.Helpers;
+using Dalamud.Bindings.ImGui;
+using System.Collections.Generic;
+using System.Numerics;
+using HSUI.Config;
+using Dalamud.Game.ClientState.Objects.SubKinds;
+using Dalamud.Game.ClientState.Objects.Types;
+
+namespace HSUI.Interface.GeneralElements
+{
+    public class MouseGCDIndicatorHud : DraggableHudElement, IHudElementWithActor, IHudElementWithVisibilityConfig
+    {
+        private MouseGCDIndicatorConfig Config => (MouseGCDIndicatorConfig)_config;
+        public VisibilityConfig VisibilityConfig => Config.VisibilityConfig;
+
+        public IGameObject? Actor { get; set; } = null;
+
+        private float _lastTotalCastTime = 0;
+
+        public MouseGCDIndicatorHud(MouseGCDIndicatorConfig config, string displayName) : base(config, displayName) { }
+
+        protected override (List<Vector2>, List<Vector2>) ChildrenPositionsAndSizes()
+        {
+            return (new List<Vector2>(), new List<Vector2>());
+        }
+
+        protected override void DrawDraggableArea(Vector2 origin)
+        {
+            return;
+        }
+
+        public override void DrawChildren(Vector2 origin)
+        {
+            if (!Config.Enabled || Actor == null || Actor is not IPlayerCharacter)
+            {
+                return;
+            }
+
+            GCDHelper.GetGCDInfo((IPlayerCharacter)Actor, out var elapsed, out var total);
+
+            if (!Config.AlwaysShow && total == 0)
+            {
+                _lastTotalCastTime = 0;
+                return;
+            }
+
+            if (_lastTotalCastTime == 0 && Utils.IsActorCasting(Actor))
+            {
+                _lastTotalCastTime = ((IBattleChara)Actor).TotalCastTime;
+            }
+
+            var scale = elapsed / total;
+            if (scale <= 0)
+            {
+                _lastTotalCastTime = 0;
+                return;
+            }
+
+            bool instantGCDsOnly = Config.InstantGCDsOnly && _lastTotalCastTime != 0;
+            bool thresholdGCDs = Config.LimitGCDThreshold && _lastTotalCastTime > Config.GCDThreshold;
+
+            if (instantGCDsOnly || thresholdGCDs)
+            {
+                if (Config.AlwaysShow)
+                {
+                    elapsed = 0;
+                    total = 0;
+                }
+                else
+                {
+                    return;
+                }
+            }
+
+            Vector2 center = ImGui.GetMousePos() + Config.CursorCenterOffset;
+            AddDrawAction(_config.StrataLevel, () =>
+            {
+                DrawCircularIndicator(center, Config.CircleRadius, elapsed, total);
+            });
+        }
+
+        private void DrawCircularIndicator(Vector2 position, float radius, float current, float total)
+        {
+            total = Config.AlwaysShow && total == 0 ? 1 : total;
+            current = Config.AlwaysShow && current == 0 ? total : current;
+
+            var size = new Vector2(radius * 2);
+            DrawHelper.DrawInWindow(ID, position - size / 2, size, false, (drawList) =>
+            {
+                current = Math.Min(current, total);
+
+                const int segments = 100;
+                const float queueTime = 0.5f;
+                float startAngle = 0f;
+                float endAngle = 2f * (float)Math.PI;
+                float offset = (float)(-Math.PI / 2f + (Config.CircleStartAngle * (Math.PI / 180f)));
+
+                if (Config.RotateCCW)
+                {
+                    startAngle *= -1;
+                    endAngle *= -1;
+                }
+
+                if (Config.AlwaysShow && current == total)
+                {
+                    drawList.PathArcTo(position, radius, startAngle + offset, endAngle + offset, segments);
+                    drawList.PathStroke(Config.FillColor.Base, ImDrawFlags.None, Config.CircleThickness);
+                }
+                else
+                {
+                    float progressAngle = Math.Min(current, total - (Config.ShowGCDQueueIndicator ? queueTime : 0f)) / total * endAngle;
+
+                    drawList.PathArcTo(position, radius, startAngle + offset, progressAngle + offset, segments);
+                    drawList.PathStroke(Config.FillColor.Base, ImDrawFlags.None, Config.CircleThickness);
+
+                    if (Config.ShowGCDQueueIndicator && current > total - queueTime)
+                    {
+                        float oldAngle = progressAngle - 0.0003f * total * endAngle;
+                        progressAngle = current / total * endAngle;
+                        drawList.PathArcTo(position, radius, oldAngle + offset, progressAngle + offset, segments);
+                        drawList.PathStroke(Config.QueueColor.Base, ImDrawFlags.None, Config.CircleThickness);
+                    }
+
+                    drawList.PathArcTo(position, radius, progressAngle + offset, endAngle + offset, segments);
+                    drawList.PathStroke(Config.BackgroundColor.Base, ImDrawFlags.None, Config.CircleThickness);
+                }
+
+                if (Config.ShowBorder)
+                {
+                    drawList.PathArcTo(position, radius - Config.CircleThickness / 2f, 0, endAngle, segments);
+                    drawList.PathStroke(0xFF000000, ImDrawFlags.None, 1);
+
+                    drawList.PathArcTo(position, radius + Config.CircleThickness / 2f, 0, endAngle, segments);
+                    drawList.PathStroke(0xFF000000, ImDrawFlags.None, 1);
+                }
+            });
+        }
+    }
+}

Interface/HudManager.cs

@@ -379,6 +379,11 @@ namespace HSUI.Interface
             _hudElements.Add(gcdIndicatorConfig, gcdIndicator);
             _hudElementsUsingPlayer.Add(gcdIndicator);
 
+            var mouseGcdIndicatorConfig = ConfigurationManager.Instance.GetConfigObject<MouseGCDIndicatorConfig>();
+            var mouseGcdIndicator = new MouseGCDIndicatorHud(mouseGcdIndicatorConfig, "Mouse GCD Indicator");
+            _hudElements.Add(mouseGcdIndicatorConfig, mouseGcdIndicator);
+            _hudElementsUsingPlayer.Add(mouseGcdIndicator);
+
             var mpTickerConfig = ConfigurationManager.Instance.GetConfigObject<MPTickerConfig>();
             var mpTicker = new MPTickerHud(mpTickerConfig, "MP Ticker");
             _hudElements.Add(mpTickerConfig, mpTicker);

changelog.md

@@ -1,3 +1,9 @@
+# 1.0.8.14
+- **Mouse GCD Indicator**: New HUD element (Other Elements → Mouse GCD Indicator) — circular GCD ring drawn around the cursor. Configurable radius, thickness, colors, queue indicator, and cursor center offset so the ring aligns with the cursor graphic.
+
+# 1.0.8.13
+- **Hotbars**: Fixed item tooltips not showing — use TryGetRow for Item sheet and base item ID so tooltip no longer fails for some items.
+
 # 1.0.8.12
 - **Hotbars**: Fixed item icons not drawing on hotbar — game encodes HQ items as iconId + 1000000; now use iconId % 1000000 and itemHq flag so item icons (including HQ) display correctly.
 

pluginmaster.json

@@ -1 +1 @@
-[{"Author":"Knack117","Name":"HSUI","Punchline":"A modern HUD replacement built for customization.","Description":"HSUI provides a highly configurable HUD replacement for FFXIV, recreated from DelvUI using KamiToolKit, FFXIVClientStructs, and Dalamud. Features unit frames, castbars, job gauges, nameplates, party frames, status effects, enemy list, configurable hotbars with drag-and-drop, and profiles.","Changelog":"1.0.8.12: Item/HQ icons now draw on hotbar. 1.0.8.11: Hotbar tooltip crash fix (Lumina GetRow). 1.0.8.10: Hotbar crash fix when dragging inventory items; Release builds strip PDBs. 1.0.8.9: Gearset persists on slot (fix CommandId 0 treated as empty). 1.0.8.8: Gearset drag-drop fix; allow first gearset (index 0) on bar. 1.0.8.7: Fixed Gearset/Job Gear Set icon clearing when first equipment slot changes. 1.0.8.6: Crafting action tooltips now show full description instead of action name. 1.0.8.4: Alliance Frames 1 and 2 fix in raids; crafting action tooltips; Hide in duty no longer hides alliance frames. 1.0.8.3: Fix left-click staying broken after disable. 1.0.8.2: Charge icons stay lit until all charges spent.","InternalName":"HSUI","AssemblyVersion":"1.0.8.12","RepoUrl":"http://brassnet.ddns.net:33983/KnackAtNite/HSUI","ApplicableVersion":"any","Tags":["UI","HUD","Unit Frames","Nameplates","Party Frames","Hotbars"],"CategoryTags":["UI"],"DalamudApiLevel":14,"IconUrl":"http://brassnet.ddns.net:33983/KnackAtNite/HSUI/raw/branch/main/Media/Images/icon.png","ImageUrls":[],"DownloadLinkInstall":"http://brassnet.ddns.net:33983/KnackAtNite/HSUI/releases/download/v1.0.8.12/latest.zip","IsHide":false,"IsTestingExclusive":false,"DownloadLinkTesting":"http://brassnet.ddns.net:33983/KnackAtNite/HSUI/releases/download/v1.0.8.12/latest.zip","DownloadLinkUpdate":"http://brassnet.ddns.net:33983/KnackAtNite/HSUI/releases/download/v1.0.8.12/latest.zip","LastUpdate":"1760400000"}]
+[{"Author":"Knack117","Name":"HSUI","Punchline":"A modern HUD replacement built for customization.","Description":"HSUI provides a highly configurable HUD replacement for FFXIV, recreated from DelvUI using KamiToolKit, FFXIVClientStructs, and Dalamud. Features unit frames, castbars, job gauges, nameplates, party frames, status effects, enemy list, configurable hotbars with drag-and-drop, and profiles.","Changelog":"1.0.8.14: Mouse GCD Indicator (ring around cursor). 1.0.8.13: Item tooltips now show. 1.0.8.12: Item/HQ icons now draw on hotbar. 1.0.8.11: Hotbar tooltip crash fix (Lumina GetRow). 1.0.8.10: Hotbar crash fix when dragging inventory items; Release builds strip PDBs. 1.0.8.9: Gearset persists on slot (fix CommandId 0 treated as empty). 1.0.8.8: Gearset drag-drop fix; allow first gearset (index 0) on bar. 1.0.8.7: Fixed Gearset/Job Gear Set icon clearing when first equipment slot changes. 1.0.8.6: Crafting action tooltips now show full description instead of action name. 1.0.8.4: Alliance Frames 1 and 2 fix in raids; crafting action tooltips; Hide in duty no longer hides alliance frames. 1.0.8.3: Fix left-click staying broken after disable. 1.0.8.2: Charge icons stay lit until all charges spent.","InternalName":"HSUI","AssemblyVersion":"1.0.8.14","RepoUrl":"http://brassnet.ddns.net:33983/KnackAtNite/HSUI","ApplicableVersion":"any","Tags":["UI","HUD","Unit Frames","Nameplates","Party Frames","Hotbars"],"CategoryTags":["UI"],"DalamudApiLevel":14,"IconUrl":"http://brassnet.ddns.net:33983/KnackAtNite/HSUI/raw/branch/main/Media/Images/icon.png","ImageUrls":[],"DownloadLinkInstall":"http://brassnet.ddns.net:33983/KnackAtNite/HSUI/releases/download/v1.0.8.14/latest.zip","IsHide":false,"IsTestingExclusive":false,"DownloadLinkTesting":"http://brassnet.ddns.net:33983/KnackAtNite/HSUI/releases/download/v1.0.8.14/latest.zip","DownloadLinkUpdate":"http://brassnet.ddns.net:33983/KnackAtNite/HSUI/releases/download/v1.0.8.14/latest.zip","LastUpdate":"1760486400"}]