FocusScore

Classic Encounter Performance, Avoidable Damage & Interrupt Tracker

Author: Kornel Kowalski
Version: 1.0.0
Dependencies: Zero (100% standalone, pure Blizzard API)
Supported Clients: WoW Classic Era (1.14+ / 1.15+), WoW Forever (1.60.1), Season of Discovery, Hardcore, and Vanilla 1.12.1 legacy.

What is FocusScore?

FocusScore is a lightweight, zero-dependency combat performance evaluator built specifically for World of Warcraft Classic raid and dungeon encounters (Molten Core, Blackwing Lair, Ahn'Qiraj AQ20/AQ40, Naxxramas, and level 60 dungeons).

Unlike standard damage meters that solely reward raw DPS (often encouraging players to stand in environmental fire just to squeeze out one extra hit), FocusScore evaluates raid execution and survivability. Every encounter begins with a 1000-point pool. As boss mechanics trigger, your score updates dynamically and awards a post-combat Letter Rank (S, A, B, C, or D).

Key Features

1. Avoidable Damage Tracking (-50 to -100 pts)

Taking damage from environmental hazards, void zones, and boss spells that should be avoided heavily penalizes your score:

• Molten Core: Rain of Fire (Gehennas), Lava Bomb (Magmadar), Living Bomb & Inferno (Baron Geddon), Magma Splash (Golemagg), Arcane Explosion (Shazzrah).
• Blackwing Lair: Shadow Flame (Nefarian, Ebonroc, Flamegor), Flame Buffet (Firemaw LoS), Corrupted Blood (Razorgore).
• Ahn'Qiraj (AQ40/AQ20): Void Zone / Meteor (C'Thun), Sand Blast (Ossirian), Poison Cloud, Exploding Scarabs.
• Naxxramas: Void Zone (Kel'Thuzad), Poison Cloud (Grobbulus), Rain of Fire (Faerlina), Plague Wave (Noth), Mutating Injection.
• Level 60 Dungeons: Scholomance, Stratholme, Dire Maul, and Blackrock Spire hazards.

2. Failed Interrupt Penalty (-40 pts)

If a critical boss or elite creature cast finishes successfully while you are targeting the mob, have your interrupt off-cooldown, and hold enough resources (Energy >= 25, Rage >= 10, Mana), points are deducted for missing the interrupt rotation.

3. Rewards for High-Performance Play

• Successful Interrupt (+20 pts): Landing Kick, Pummel, Earth Shock, Counterspell, or Shield Bash.
• Offensive Dispel / Purge (+20 pts): Removing enemy buffs with Purge, Dispel Magic, or Cleanse.
• Mechanic Dodging (+10 pts): Stepping out of ground telegraphs and targeted hazards before impact.

4. Authentic Blizzard Post-Combat Report

• Automatically appears when leaving combat with a boss (PLAYER_REGEN_ENABLED / ENCOUNTER_END).
• Displays a prominent letter rank with authentic Blizzard styling:
  • Rank S (>= 950 pts): Flawless execution (Golden)
  • Rank A (850 - 949 pts): Solid mechanics (Green)
  • Rank B (700 - 849 pts): Minor mistakes (Blue)
  • Rank C (500 - 699 pts): Noticeable damage taken (Yellow)
  • Rank D (< 500 pts): Multiple avoidable mechanics eaten (Red)
• One-Click Sharing: Click the "Share" button or Shift + Click anywhere on the window to broadcast your breakdown to /raid, /party, /guild, or /say without UI errors.

5. Draggable Circular Minimap Button & Menu Panel

• Left-Click: Open / close combat report.
• Right-Click: Open the Settings & Menu panel (/fs menu).
• Shift + Click: Quick-broadcast the latest report to chat.
• Drag: Hold left or right click to position the button anywhere along your minimap rim (the angle is persistently saved across sessions).
• Settings GUI: Toggle auto-show, toggle chat broadcast, toggle minimap button, instant language switcher, and run mock test reports.

6. Dual-Engine Zero-Dependency Compatibility

• Classic Era & Modern (1.14+, 1.15+, 1.60.1): Reads high-precision COMBAT_LOG_EVENT_UNFILTERED (CLEU) events and native ENCOUNTER_START / ENCOUNTER_END hooks.
• Legacy 1.12.1 Client: Uses optimized zero-garbage-collection pattern matching over combat chat channels (CHAT_MSG_SPELL_*).
• 100% Zero-Dependency: Does not require Ace2, Ace3, LibStub, or any external libraries.

Slash Commands

Installation

1. Download FocusScore-v1.0.0.zip.
2. Extract the archive into your World of Warcraft directory:
   • Classic Era / Forever: World of Warcraft\_classic_era_\Interface\AddOns\ (or _forever_\Interface\AddOns\)
   • Vanilla 1.12.1: World of Warcraft\Interface\AddOns\
3. Verify that the folder name is exactly FocusScore.
4. Launch the game or type /reload in chat.

[PL] Wersja Polska

FocusScore - Analiza Unikania Mechanik i Przerywania Czarow w WoW Classic

Autor: Kornel Kowalski
Wersja: 1.0.0
Zaleznosci: Zero (100% samodzielny kod na czystym API Blizzarda)

FocusScore to lekki dodatek oceniajacy bezpieczenstwo i jakosc gry w dungeonach oraz rajdach Classic (Molten Core, BWL, AQ, Naxxramas, dungeony 60 lvl). Zamiast promowac bezmyslny DPS kosztem stania w ogniu, dodatek nagradza mechaniczna dyscypline.

Najwazniejsze Cechy:

• Unikanie Obrazen Obszarowych (-50 do -100 pkt): Otrzymanie obrazen od Deszczu Ognia, Stref Prozni, Bomb Geddona czy Cienia Nefariana odejmuje punkty z puli 1000 pkt.
• Pilnowanie Rotacji Kickow (-40 pkt): Jezeli boss rzuci wazny czar, a Ty miales cel na bossie, brak cooldownu i wystarczajaco energii/szalu/many – otrzymujesz kare punktowa.
• Nagrody za Dobra Gre: +20 pkt za udany Interrupt, +20 pkt za Purge/Dispel wrogiego buffa, +10 pkt za bezpieczne wyjscie ze strefy wybuchu.
• Rangi Literowe: S (od 950 pkt), A (850-949 pkt), B (700-849 pkt), C (500-699 pkt), D (<500 pkt).
• Ikonka przy Minimapie: Okragla ikonka tarczy. Lewy klik otwiera raport, prawy klik otwiera menu (/fs menu), Shift+Klik udostepnia wynik na czacie, a przeciaganie pozwala ustawic ja w dowolnym miejscu minimapy.
• Udostepnianie na Czacie: Bezpieczne wysylanie statystyk bez bledow escape-code na kanaly /raid, /party lub /say.
• Zero Zaleznosci: Addon nie wymaga Ace2/Ace3 i dziala ultra-plynnie na kazdym komputerze.