Focused! - PvP / WPVP / PvE Focus Frame, Castbars & Macros

Focused! - PvP, WPvP & PvE Focus Frame, Castbars & Macros (Classic Era) v1.0.15

Focused! is the definitive PvP, WPvP and PvE Focus Unit Frame for Classic Era and Hardcore. Built from the ground up to overcome the limitations of the Classic API, it restores the missing Blizzard focus frame functionality required for high-stakes competitive play.

Track AND target your focus—and your focus's target—through a fully customizable UI. Choose between a sleek Modern Layout with intelligent sorting or an authentic Classic-Style Frame that feels native to the original game.

The addon's most powerful feature is its Dynamic Class Macro Generator. This tool automatically creates secure, class-specific macros for your Interrupts, Crowd Control (CC), and utility spells (e.g., Kick, Polymorph, Fear, Blind, Counterspell). These macros allow you to instantly cast on your focus without ever dropping your primary target—giving you the critical "focus cast" advantage exactly as intended!

To get started, simply type /focused.

Key Features

Core Focus Frame

• Displays: Focus unit's Name, Health, Resources (Mana, Rage, Energy), Buffs and Debuffs, Raid Markers, and Cast Bar.
• Fully Interactive: The Portrait, Name, Health, and Resource bars are all clickable to target the unit directly. This includes the Target-of-Focus frame.
• Customizable Clicks: You can configure which mouse button/modifier combinations are used to Target the focus or Open settings, preventing conflicts with other addons.

Clique Support & Integration

• Full Clique Integration: The frame is now fully compatible with the Clique addon for click-casting.
• Smart Handling:
  • Stable Units: Bind any spell to any click for Party, Raid, or Pet members (works 100% like Retail).
  • Unstable Units: Includes specific protection logic for enemies in the open world (Classic API limitation), ensuring you can still target them efficiently.
• Conflict Resolution: If you use Clique on Left/Right click, you can change the Focused! interaction to Shift+Click (or Alt/Ctrl) via the Options menu to avoid overlapping bindings.

Layout Styles

• Modern Layout: Features a compact design with dedicated Health and Resource bars for the Focus's Target (also clickable), along with a priority-sorted vertical Aura stack for Buffs and Debuffs.
• Classic Layout: A faithful recreation of the Blizzard Focus Frame and Target-of-Focus frame, enhanced with class-colored names and difficulty-colored level text. Includes authentic Buff and Debuff rows.

Intelligent Aura Tracking

• Smart Priority System: Both layouts utilize a sorting system designed for PvP and high-level PvE. Critical spells—such as Crowd Control (e.g., Polymorph, Fear), Major Defensives (e.g., Shield Wall, Ice Block), and Dispelable Debuffs—always float to the top of the list.
• Unified Stream (Modern): Combines buffs and debuffs into a single, efficient vertical stack under the settings button, ensuring important info is never buried by "trash" buffs.
• Classic Layout Support: Full support for standard Blizzard-style buff and debuff rows, using authentic templates for a native look and feel.

Advanced Unit Tracking & Nameplates

• Logic: Uses sophisticated logic to find the most stable unit token (partyX, raidX, arenaX) for reliable tracking. The addon will track units and restore information automatically if the unit is lost and relocated.
• Nameplate Integration: When stable tokens aren't available (e.g., World PvP, Solo play), the addon intelligently uses nameplate information to keep track of your focus. Enabling nameplates (V key by default) significantly increases tracking reliability when units are not in your party or raid.

Secure Targeting & Casting

• Dynamic Class-Specific Macros: Running /fc macro auto-generates a full set of Crowd Control and Interrupt macros for your character's class (e.g., FC Polymorph, FC Kick, FC Entangling Roots).
• Secure Updates: These macros are dynamically updated by the addon (while out of combat) to always target your current focus using the most reliable command:
  • /cast [@party1] SpellName (if your focus is a stable party member).
  • /targetexact FocusName (if your focus is a non-stable unit).
• "Target Focus" Macro: Creates a simple keybind macro to target your focus.
• "Custom Target" Macro: Users can create custom macros using /click FC_Target to combine any spell with targeting the focus unit.
• Mouseover Support: Optional toggles to prioritize mouseover units for both Target and Focus logic in class macros.
• "One-Button" Playstyle: Configure a modifier (Alt, Ctrl, or Shift) in options:
  • Normal Press: Casts on your Target.
  • Modifier Press: Instantly targets and casts on your Focus.
• Smart Filtering: Only generates macros for spells you have actually learned.

Supported Class Macros & Spells

Focused! automatically detects your class and generates macros for your specific abilities, including:

• Mage: Polymorph, Counterspell, Ice Block
• Rogue: Kick, Blind, Gouge, Kidney Shot
• Warlock: Fear, Spell Lock, Seduction
• Druid: Bash, Feral Charge, Entangling Roots
• Priest: Silence, Psychic Scream, Dispel Magic
• Shaman: Earth Shock, Purge
• Warrior: Pummel, Shield Bash, Intercept, Disarm
• Paladin: Hammer of Justice, Repentance
• Hunter: Scatter Shot, Silencing Shot, Wyvern Sting

Critical Threshold Warnings

The Focused! frame visually reacts when your Focus target drops below critical levels, ensuring you never miss a moment to heal, peel, or execute.

• Low Health Alert: The frame border glows Red and displays a warning icon when health drops below your defined threshold (Default: 25%).
• Low Mana Alert: The frame border glows Blue with a warning icon when mana drops below your defined threshold (Default: 20%).
• Smart Prioritization: If a unit is low on both, the Low Health warning takes priority to ensure survival needs are addressed first.
• Customizable: You can adjust percentage triggers, toggle pulsing animations, or disable specific warnings in the Display tab.

Visual Alerts & Threat Indicators

Focused! uses a prioritized "Traffic Light" system to communicate status and danger instantly. The frame border and status icon (!) change color based on the most critical condition.

• Aggro (Pulsing Yellow): Danger. The unit is targeting YOU. This overrides all other alerts (Health/Mana).
• High Threat (Solid Yellow): Warning. You are generating high threat and are about to pull aggro.
• Low Health (Red): The unit is below your health threshold (Default: 25%).
• Low Mana (Blue): The unit is below your mana threshold (Default: 20%).

Note: Threat indicators are Disabled by Default to keep the UI clean during solo leveling. You can enable them in Options -> Display -> Thresholds.

Raid Marker Display

• Shows the assigned raid marker icon next to both your focus and your focus's target.
• Stale Persistence: Markers remain visible (frozen) even when the unit goes out of range, showing the last known assignment.
• Intelligent Clearing: Automatically hides a stale marker if it detects the marker has been moved to a different unit.

Enemy Cast Bar

• Displays what your focus unit is currently casting or channeling.
• Hybrid System:
  • Utilizes spell events for "static" units (player, party, etc.) for interrupt detection (red flash).
  • Uses reliable polling for "dynamic" units (raid, arena, nameplate) where events aren't available.

Focus Sharing & Adoption

• Broadcasting: Automatically broadcasts your focus (GUID & Name) to party/raid members using the addon to ensure tracking regardless of line of sight.
• Adopt Focus: Optionally set your focus based on broadcasts from group members (Disabled by default).

Helper Modes (Auto-Marking)

Flexible system to automatically apply a Cross icon to your focus's target.

• Auto-Mark Target: Marks whatever your focus is targeting (includes Chain Marking).
• Auto-Mark Dispelable: Marks target only if they are a Friend with a debuff you can Dispel.
• Auto-Mark Interrupts: Marks target only if they are an Enemy casting a dangerous spell (PvP/WPvP/PvE toggles).
• Note: Will not overwrite existing raid markers set by players.

Simplified UI & Customization

• Context Menus: Adds "Set as Focus" and "Clear Focus" to unit right-click menus.
• Dynamic Button: Main button switches between "Set (+)" and "Clear (X)".
• Settings Dropdown: Quick access to Helper Modes, Clearing Markers, Macro Management, and Options.
• Visual Customization:
  • Scale frame (50% - 200%).
  • Flip Portrait (Modern or Classic).
  • Swap Set/Clear button placement.
  • Adjust opacity, toggle bar visibility, class-color health bars, and Threshold Warnings.
  • Lock Frame and Click-Through mode.

Automation & Visibility

• Auto-Hide: Configurable options to hide the frame if Focus is Lost or Cleared after a user-selected duration (e.g., Instant, 30s, 2m).
• Combat Fading: Optional setting to hide interface buttons during combat.
• LDB / Minimap Icon: Displays current focus name and status.

Important: Combat Restrictions

Due to Blizzard's API restrictions (InCombatLockdown), certain actions are blocked while you are in combat:

• Cannot Set Focus: You cannot use /fc set, the "Set" button, or right-click menu.
• Cannot Clear Focus: You cannot use /fc clear, the [X] button, or right-click menu.
• Macros & Targeting are Locked: The "Target" button and all "FC" macros are locked to whoever your focus was before combat started.
• Cannot Create/Edit Macros: Commands like /fc macro will not function.

Plan ahead! Set or clear your focus before engaging in combat.

Installation

1. Download the latest .zip file.
2. Extract the folder. Ensure the folder inside is named Focused.
3. Move the Focused folder into your WoW AddOns directory:
   • Classic Era / SoD: World of Warcraft\_classic_era_\Interface\AddOns\
4. Libraries: This addon requires LibStub, CallbackHandler-1.0, LibDataBroker-1.1, and LibDBIcon-1.0 (included in the libs folder).
5. Restart World of Warcraft or type /reload.

How to Use

Set a Focus

1. Target the desired unit.
2. Click the Set (+) icon button on the frame, OR
3. Type /fc set, OR
4. Right-click the unit frame/model and choose "Set as Focus".

Create Your Macros

1. Type /fc macro in chat OR select "Generate Macros" from the Settings dropdown.
2. This creates "SetFocus", "Target Focus", and class-specific "FC" macros.

Targeting & Casting (Keybinds)

1. Open your WoW Macro Book (U key).
2. Drag the new macros (Target Focus, FC Polymorph, etc.) onto your action bar.
3. Assign keybinds.

Targeting (Mouse)

• Click the unit portrait, name, or health/resource bar on the focus frame.
• Note: You can customize this click in Options -> Frame Tab (e.g., change to Shift+Click to allow other addons like Clique to use the main click).

Clearing Focus

• Click the [X] icon button, type /fc clear, right-click the focus frame and choose "Clear Focus" from the Settings menu or right-click a unit and choose "Clear Focus".

Accessing Options

• Type /fc options, click the Settings Icon on the frame, or use the Minimap/LDB icon.

Slash Commands

All commands are consolidated under /focused and /fc.

• /fc help: Shows list of available commands.
• /fc set: Sets current target as focus (out of combat).
• /fc clear: Clears current focus (out of combat).
• /fc macro: Creates/updates macros.
• /fc options: Opens the options panel.
• /fc toggle: Shows or hides the focus frame.
• /fc lock: Toggles locking the frame's position.
• /fc reset: Resets all settings to defaults.

Special thanks to Mr_Ghoosty for their individual efforts and inspirational add-on.