NameplateDPS (Classic Era)

Shows a per-enemy damage-per-second number beside enemy nameplates. Each visible enemy nameplate gets its own DPS value based on all damage taken by that unit (any source) during a rolling time window.

Version control

This project uses Git. To connect to GitHub, see docs/GITHUB_SETUP.md.

Requirements

• World of Warcraft Classic Era (Interface 11508)
• Enemy nameplates enabled (Esc → Interface → Names)

Installation

Copy this folder to:

World of Warcraft\_classic_era_\Interface\AddOns\NameplateDPS\

Enable NameplateDPS on the character select AddOns screen, then /reload in game.

Verify interface version

If the addon fails to load after a game patch, check your client interface number:

/run print((select(4, GetBuildInfo())))

Update ## Interface: in NameplateDPS.toc to match.

Commands

Command	Action
/npdps	Toggle overlays on/off
/npdps on	Enable
/npdps off	Disable
/npdps reset	Clear combat tracking data

Configuration

Saved in NameplateDPSDB:

• enabled (default true)
• windowSeconds (default 3) — rolling DPS window
• fontObject (default GameFontNormalSmall) — matches UI font styling

How it works

1. NAME_PLATE_UNIT_ADDED / REMOVED attach a small text overlay beside each hostile nameplate.
2. COMBAT_LOG_EVENT_UNFILTERED records damage events by destination GUID.
3. DPS = sum of damage in the last 3 seconds ÷ 3. During the first second after the first hit on a mob, the display shows that first hit's damage value.

API reference for contributors

In-game Lua API notes used by this project live in docs/API_REFERENCE.md. Battle.net REST APIs are documented in docs/NOT_REST_API.md and are not used by this addon.

Manual test checklist

See docs/TESTING.md.

Performance notes

• Combat log parsing runs only on damage subevents to hostile destinations.
• Overlay text updates on dirty GUIDs and on a 0.1s throttle for rolling-window decay.
• Overlay frames are pooled (max 20).