BlizzNameplatesPlus/README.md

⚔️ Blizz Nameplates+

Blizz Nameplates+ enhances the original Blizzard nameplates for Vanilla WoW / WoW 1.12 while preserving their classic look and feel.

It adds reliable multi-target aura tracking, Crowd Control, castbars, Combo Points, PvP totem indicators and additional visual customization without replacing the original Blizzard nameplate design.

Current version: v1.0.8
Required: SuperWoW.dll and ClassicAPI.dll

---

✨ Features

🎯 Nameplates

• Adjustable nameplate scale and Y offset
• Adjustable non-target alpha
• Enemy class colors
• Tank Mode
• Health text options
• Foreign-tagged mobs shown with a neutral grey healthbar
• Target Glow with selectable glow color
• Target Plate on Top
• Clean nameplate and aura layering

☠️ Auras & Debuffs

• GUID-based multi-target debuff and DoT tracking
• Numeric aura timers
• Stack counters
• Reliable tracking across multiple visible nameplates
• Adjustable aura icon size
• Debuff positioning:
  • Top
  • Left
  • Right
• Instant target-alpha updates

🌀 Crowd Control

• Dedicated Crowd Control tracking
• Optional supported CC effects from other players
• Separate CC Icon Size
• Optional dedicated CC row when using the Top aura layout
• Side layouts automatically keep CCs compact with the other aura icons

🔥 Totem Indicators

Shaman totems can now be displayed as clean, easily recognizable icons instead of full nameplates.

• Automatically detects supported Shaman totems
• Replaces the entire totem nameplate with the corresponding spell icon
• No healthbar, name or level clutter
• Adjustable Totem Icon Size
• Designed especially for clearer PvP situations
• Supports ranked totems without requiring separate configuration

✨ Class Features

• Blizzard-style Combo Points for:
  • Rogue
  • Druid

🔥 Castbars

• Enemy castbars
• Spell icons
• Adjustable castbar height
• Adjustable spacing
• Castbar test mode

---

🆕 What's New in v1.0.8

New Aura Positioning

Aura icons can now be positioned:

• Top
• Left
• Right

This is especially useful when many nameplates overlap and a horizontal layout provides better visibility.

Separate CC Icon Size

Crowd Control icons now have their own independent size setting.

You can keep regular DoTs compact while making important CC effects larger and easier to recognize.

Totem Icon Mode

Shaman totem nameplates can now be automatically replaced by their spell icons.

Instead of several small 5 HP nameplates filling the screen, important battlefield objects remain immediately recognizable with significantly less visual clutter.

Redesigned Options Menu

The settings menu has been reorganized into compact tabs:

• Nameplates
• Auras
• Totems
• Castbar
• Target
• Tools

This keeps the interface much cleaner as Blizz Nameplates+ continues to grow.

---

🔎 Missing Spell / Aura Recorder

Missing a spell, DoT, proc or custom-server aura?

The built-in recorder creates one complete, copyable diagnostic report — no screenshots or manual chat commands required.

1. Open the BNP settings.
2. Go to Tools.
3. Click Missing Spell / Aura...
4. Select the affected unit.
5. Click Start Recording.
6. Apply the aura.
7. Refresh it while it is active.
8. Let it expire or remove it.
9. Click Stop.
10. Click Copy Report.
11. Paste the report into your bug report or support message.

The report can include:

• Spell IDs
• Aura timing
• Target information
• Refresh events
• Relevant aura state changes

The recorder is completely inactive until Start Recording is pressed and stops when the recorder window is closed.

---

📦 Requirements

Both DLLs are required and must be loaded before the game starts.

SuperWoW.dll

Provides the GUID, unit, combat and cast information used for:

• Multi-target tracking
• Castbars
• Nameplate identification
• Unit tracking

Download SuperWoW

ClassicAPI.dll

Provides exact nameplate resolution and more reliable aura information, including:

• Spell IDs
• Aura durations
• Expiration times
• Exact nameplate resolution
• Instant target updates
• Recorder functionality

Download ClassicAPI

Keep both DLLs up to date.
Without SuperWoW and ClassicAPI, Blizz Nameplates+ is not supported.

---

📥 Installation

1. Install SuperWoW.dll and ClassicAPI.dll using the instructions supplied with those projects.

2. Make sure both DLLs are enabled in your DLL loader or dlls.txt.

3. Delete any older BlizzNameplatesPlus addon folder.

4. Extract the new addon folder into:

   Interface\AddOns\

5. Verify that the final path is:

   Interface\AddOns\BlizzNameplatesPlus\BlizzNameplatesPlus.toc

6. Start the game through your DLL-enabled launcher.

7. Enable enemy nameplates.

---

⚙️ Settings

Open the settings through the BN+ minimap button or type:

/bnp

Nameplates

• Nameplate Scale
• Y Offset
• Non-Target Alpha
• Class Colors
• Tank Mode
• Health Text
• Combo Points

Auras

• Aura Icon Size
• Debuffs
• Aura Position: Top / Left / Right
• Crowd Control
• CC Icon Size
• Separate CC Row
• CCs from other players

Totems

• Enable Totem Icons
• Totem Icon Size

Castbar

• Enable Castbars
• Castbar Height
• Castbar Spacing
• Test Castbars

Target

• Target Glow
• Glow Color
• Target Plate on Top

Tools

• Missing Spell / Aura Recorder

Most changes are applied immediately.

---

❤️ Credits

Created by Wurmschwanz.

Thanks to everyone who tested Blizz Nameplates+, reported bugs, suggested features and supplied recorder data.

Special thanks to everyone helping test different classes, PvP situations and large raid environments. ❤️