# RCPartyOrbs Changelog

## Version 73 (Latest)
### New Features
- **Custom Debuff Alert Sounds** - Choose from 24 different sounds for debuff notifications
  - New dropdown menu in settings to select your preferred sound
  - Includes: Affliction Alert (new default), Mario sounds, Zelda sounds, Warcraft peon quotes, and more
  - Preview plays when selecting a new sound
  - Your selection is saved between sessions

- **Improved Death Detection** - Dead party members now show immediately
  - Grey/empty orbs with red "DEAD" text
  - Instant visual feedback via UNIT_FLAGS event
  - Battle rez (Shift+click) is now more responsive

- **Multi-Addon Compatibility** - Now supports hiding/showing frames from multiple unit frame addons:
  - ElvUI
  - Shadowed Unit Frames (SUF)
  - Pitbull4
  - Z-Perl / X-Perl
  - Luna Unit Frames
  - Works automatically - RCPartyOrbs detects which addon you're using

### Fixes
- **Raid Auto-Hide** - ALL orbs now properly hide when converting party to raid
  - Previously only party orbs were hidden, now player orb hides too
  - Orbs automatically return when leaving raid

- **ElvUI Combat Compatibility** - Fixed "action blocked" errors with ElvUI raid frames
  - Now uses SetAlpha instead of Hide/Show to avoid triggering ElvUI's SecureStateDriver
  - No longer causes cascade updates to raid frames during combat
  - Frames become invisible and non-clickable without actually hiding

- **Combat Lockdown Protection** - All unit frame operations check for combat lockdown
  - Prevents protected function errors during combat

### New Commands
- `/fpo restoreui` or `/fpo fixui` - Emergency restore all unit frame addon frames

---

## Version 72
### New Features
- **Separate Target Spacing Slider** - Added independent spacing control for target orbs
  - "Party Spacing" slider controls distance between party member orbs
  - "Target Spacing" slider controls distance between each orb and its target orb
  - Both sliders displayed side-by-side in the settings menu

### Fixes
- Fixed orientation toggle (horizontal/vertical) not working when positions were saved
- Party target orbs now always stay anchored to their corresponding party members
- Role icon repositioned to bottom of mana orb and made smaller

---

## Version 70-71
### New Features
- **Cast Bar Scaled Up** - Arc now matches the outside edge of the mana orb (20 segments)
- **Debuff Sound Notification** - Plays a bell/gong sound when a dispellable debuff is detected
- **Level Display** - Character level now shows after the player name (e.g., "Papawoody 80")
- **Role Icons** - Tank/Healer/DPS icons displayed for party members
  - Shield icon for tanks
  - Cross icon for healers
  - Sword icon for DPS

### New Settings (Orb Visibility Menu)
- Show Level toggle
- Show Role Icon toggle

### Fixes
- Shift-click now passes through for normal spell casting (fixes Soulstone on party members)

---

## Version 68-69
### New Features
- **Arc-Style Cast Bars** - Curved cast bar displayed below each mana orb
  - 16-20 texture segments arranged in a decorative arc
  - Gold color for interruptible spells
  - Grey color for non-interruptible spells
  - Spell name and cast time displayed below arc
  - Supports both normal casts (fills left-to-right) and channeled spells (drains right-to-left)
  - Completely transparent background for clean visual integration

### New Settings
- Show Cast Bars toggle in Orb Visibility menu

---

## Version 66-67
### New Features
- **Offline Detection** - Party members who go offline show:
  - Black/dark grey orbs
  - "Offline" text instead of health percentage
  - Grey name text

- **Out of Range Detection** - Party members out of range show:
  - Greyed/desaturated orb colors
  - Slightly transparent appearance

### Visual Changes
- All fonts changed to white for consistency
- Health percentage font size reduced to 18 (matches health value)

---

## Version 62-65
### New Features
- **Orb Visibility Menu** - New dedicated menu for visibility controls
  - Individual toggles for Player, Party 1-4, and Target orbs
  - Individual toggles for Party 1-4 Target orbs
  - Organized sections: Player & Target, Party Members, Party Targets, Other Options

- **ElvUI Frame Hiding** - Option to hide ElvUI's default unit frames
  - Hides player, target, and party frames when enabled
  - Includes pet frames
  - Toggle in Orb Visibility menu

---

## Version 60-61
### New Features
- **Party Target Orbs** - Shows what each party member is targeting
  - Smaller orbs displayed next to each party member
  - Automatically positioned based on layout orientation
  - Individual visibility toggles for each party target

### Layout Behavior
- Horizontal layout: targets appear below their party member
- Vertical layout: targets appear to the right of their party member

---

## Version 58-59
### UI Improvements
- Reorganized configuration menu layout
- Moved modifier dropdown to Advanced menu
- Repositioned font size slider
- Removed redundant checkboxes
- Fixed button overlap issues

---

## Version 55-57
### New Features
- **Configurable Click Modifier** - Choose between Shift, Alt, or Ctrl for dispel/rez clicks
  - Dropdown selector in Advanced menu
  - Changes apply immediately without /reload

- **Font Size Slider** - Adjustable font scaling (50%-150%)
  - Affects health %, health value, mana value, and name text

---

## Version 52-54
### New Features
- **Battle Resurrection Support** - Modifier+click on dead party members casts:
  - Rebirth (Druid)
  - Raise Ally (Death Knight)
  - Soulstone (Warlock)

### Fixes
- Fixed click-to-dispel targeting (now properly targets the clicked unit)
- Improved combat-safe macro system

---

## Version 49-51
### New Features
- **Click-to-Dispel** - Shift+click on party members to dispel debuffs
  - Automatically detects player's dispel abilities
  - Works in combat using secure macro system

- **Debuff/Dispel Color System** - Orbs change color based on debuff type
  - Purple for Curse
  - Green for Poison  
  - Brown for Disease
  - Blue for Magic
  - Colors apply to both health orb and mana orb

- **Purgeable Buff Detection** - Enemy target orb highlights when target has purgeable buffs

---

## Version 45-48
### New Features
- **Threat Detection** - Fire border appears around orbs when party member has aggro
  - Uses WoW's UnitThreatSituation API
  - Animated fire effect for high threat

### Fixes
- Fixed threat detection using proper API (switched from nameplate iteration to automatic aggregation)

---

## Core Features (All Versions)
- Diablo 3-style health and mana orbs
- Animated galaxy/swirl effects inside orbs
- Class-colored health orbs
- Power type-colored mana orbs (mana, rage, energy, etc.)
- Customizable orb size and spacing
- Horizontal or vertical party layout
- Draggable positioning (drag player orb to move group)
- Minimap button for quick access
- Test mode for configuration
- Frame lock/unlock system
