/grouphud¶

Script-provided

Registered by grouphud. Start it with /lua run grouphud.

Syntax¶

/grouphud status|far <n>|self [on|off]|cures [on|off]|casting [on|off]|sort [on|off]|peers|reset|save

Description¶

Tune the ImGui group-status overlay: name, level, HP%, power%, distance, cures, and casting for every group member, with an optional self row.

Subcommands¶

Subcommand	What
`status` (default)	Print the current settings and the full usage line.
`far <n>`	Metres (1-500) past which the Distance cell turns amber.
`self [on\\|off]`	Show/hide the synthesized row for the local player. Bare form toggles.
`cures [on\\|off]`	Show/hide the Cures column. Bare form toggles.
`casting [on\\|off]`	Show/hide the Casting column, fed by the peer mesh. Bare form toggles.
`sort [on\\|off]`	Sort rows by distance instead of roster order. Bare form toggles.
`peers`	List who is currently reporting cast state over the peer mesh, with the age of their last report — the diagnostic for a blank Casting column.
`reset`	Restore every setting to its default and snap the window back to its default position/size.
`save`	No-op beyond the save every other subcommand already performs; confirms the current settings persisted.

[on|off] also accepts true/false/1/0. Every subcommand except status and peers reprints the status line after applying its change.

Where the data comes from¶

Roster — mq.TLO.Group, backed by the persistent client state blob. Five non-self members; the local player is never in it, which is why self is a synthesized row from mq.TLO.Me.
Distance — the member's actor entry vs. your position. A member outside actor range (different zone, or simply not loaded) shows -, never 0.

Distance fails open

Actor.Distance() returns 0.0 on any failed resolve, including a failed read of the local player — grouphud treats a distance as real only when it is > 0. See Actor for the same trap elsewhere.

Settings and window state¶

Display settings (far_range, show_self, show_cures, show_casting, sort_by_dist) are global — one config/grouphud/settings.lua shared by every character on the box. Window position/size is per-character instead, in config/grouphud/<Character>/windows.lua, since it depends on that character's own UI layout. /grouphud reset restores the shared settings and also re-centers the live window for the character running it.

Examples¶

/lua run grouphud
/grouphud status
/grouphud far 20
/grouphud casting off
/grouphud sort on
/grouphud peers
/grouphud reset