Zomar's

Party Portraits Unit Frame/Buff Reminder Bar

Description:
-------------

PartyPortraits adds a movable row of portraits for you and your party members (player, party1–party4). Which completely replaces or enhances Blizzard’s default party frames with compact class-color bordered portrait units that include integrated buff reminders, left-click-casting (unit targeting in portrait only mode), right-click unit menus, level indicators, role icons, leader marker, above-portrait debuff indicators and under-portrait health & mana/resource bars. With ability to easily enable/disable most integrated features. Each portrait also clearly indicates if a unit is disconnected or dead, and if out-of-range for unapplied reminder buff.

FIve operating modes are available, which may be enabled or disabled:

1. **Portraits Mode** – Displays portraits with class-color borders, level indicators, resting indicator (player), combat indicator (player), role icons, leader marker, unit tooltip on hover, left-click targeting and right-click displaying of standard Blizzard unit menu.
2. **Overlay Mode** – Adds interactive buff reminder icon or out of cast range warning buff reminder icon overtop of unit portrait, gear icon for right-click displaying of standard Blizzard unit menu.
3. **Above Mode** – Displays up to 15 active debuffs above unit portrait, debuff tooltip on icon hover.
4. **Below Mode** – Displays health & mana/resource bars with class-color borders below unit portrait.
5. **Totems Mode** – Displays up to 4 icons for totem, mushroom, or statue tracking. Displayed on the left side of player portrait with multiple layout options: Horizontal, Vertical, and Cluster.

Features:

Player Totem Icons
---------------------
Introduced full player Totem module expansion for totem, mushroom, or statue tracking.
Includes command set with multiple layout options: Horizontal, Vertical, and Cluster.

Player Resting & Combat Icons
----------------------------------
The player’s portrait mirrors Blizzard’s own resting and combat indicators:
Shows a Zzz bubble when resting in an inn or city.
Shows crossed swords while in combat.

Buff Overlay System
------------------------
If you are a buffing class (Druid, Priest, Mage, Monk, Paladin, Warlock), portraits will display reminder overlays when party members are missing your key buff.

Overlay logic:
• In range (needs buff): normal spell icon color + Blizzard-style outer glow
• Out of buff cast range (<100 yds): orange spell icon color • Far/not within vicinity (>100 yds): blue spell icon color
• Has buff: portrait only, no spell icon displayed
• Disconnected: desaturated grey portrait with red bolt overtop, no spell icon displayed (no casting)
• Dead: desaturated blue portrait, no spell icon displayed (no casting)

Left-clicking an overlay spell icon will cast your class buff directly on that unit.
*Click-casting should be allowable in combat as long as the overlay existed before combat began*

Right-click Gear Menu
------------------------
• In Overlay Mode, each portrait shows a small gear icon in the lower-right corner when hovered.
• Right-clicking the gear opens the standard Blizzard unit menu.
• Tooltip displays class-colored unit name and the hint: “Right-click: Unit Menu”.
• Gear automatically hides when not hovered and disappears entirely in Portraits Mode.

Supported Buffs
-------------------
Buff missing reminders when playing the following classes & click to cast buff:
Druid (Mark of the Wild)
Mage (Arcane Brilliance)
Monk (Legacy of the Emperor)
Paladin (Blessing of Might)
Priest (Power Word: Fortitude)
Warlock (Dark Intent)

Full In-Game Config Window (NEW)
-----------------------------------------

Opened via minimap button, slash command: /ppconfig, or Blizzard's Game Menu: Esc → Options → AddOns Tab

Chat Slash Commands
-------------------------

/pp -- Lists available commands
/pp on -- Enable addon
/pp off -- Disable addon
/ppconfig -- Open configuration window
/pp lock -- Lock frames (disable dragging)
/pp unlock -- Unlock frames (enable dragging)
/pp reset -- Reset position to default (and lock)
/pp show -- Show your portrait when solo
/pp hide -- Hide your portrait when solo
/pp above on -- Enable active debuffs above unit portraits
/pp above off -- Disable active debuffs above unit portraits
/pp over on -- Enable buff reminder mode
/pp over off -- Disable buff reminder mode
/pp below on -- Enable health & resource bars below unit portraits
/pp below off -- Disable health & resource bars below unit portraits
/pp totems on -- Enable totem icons left of player portrait
/pp totems off -- Disable totem icons left of player portrait
/pptotems -- Prints current totems layout and help command list.
/pptotems horizontal -- Classic row layout (icons flow right→left beside portrait).
/pptotems vertical -- Column layout (icons stack top→bottom beside portrait).
/pptotems cluster -- 2×2 cube layout (default).

Behavior
----------
- Frames are locked by default.
- Unlocking shows a faint blue background behind the portrait row for positioning.
- Reset restores the bar to its default center-top offset (X=0, Y=318) and locks frames.
- Mode settings are saved per character and persist through reloads.

Future Considerations
------------------------
- Support for *equivalence groups* (e.g., MotW ↔ Legacy of the Emperor).
- In-game GUI configuration option for choosing buff spell
- Right-click overlay option for secondary buff spells for Paladin & Monk.
- Optional sound alert when a missing buff is detected.
- Additional overlay groups for short-duration buffs.
- Reset commands to defaults.