PvP Watch

PvP Watch is a World of Warcraft PvP awareness addon focused on open-world PvP, War Mode, battlegrounds, arena, and general hostile-player tracking.

The addon is designed to help players keep track of nearby enemy players, lost-contact situations, last-seen information, KoS targets, important enemy cooldowns, visible aura information, team cooldowns, and configurable alerts.

It is intended as a modern PvP awareness tool inspired by classic hostile-player tracking addons, but built around the data that the current Blizzard addon API makes available.

PvP Watch does not read hidden server-side information. It only uses information exposed to the client through normal addon-accessible sources such as visible units, nameplates, target, mouseover, focus information, arena tokens where available, battleground score data where available, visible auras, combat-log information available to addons, addon messages, and other allowed UI data.

---

---

Main Features

---

Hostile Player Awareness

PvP Watch can detect and track hostile players from available client-side sources and display them in a configurable watch window.

Tracked information may include:

• Enemy player name and realm
• Class information when available
• Guild information when available
• Last seen location
• Detection source
• Recent sightings
• Lost-contact events
• KoS status
• Guild KoS status
• Shared sighting marker
• Notes

The Main Watch window can be configured to automatically appear when relevant PvP data is detected and hide again after a configurable delay when no matching targets remain.

---

Watch Modes

PvP Watch includes several watch modes to make the main window useful in different PvP situations.

Available modes include:

• Watch
• Active
• Recent
• Lost
• KoS
• All

Watch is the main operational mode. It can show active, recent, lost or held, KoS-relevant, and shared-recent hostile players.

Active focuses on currently live-detected enemy players.

Recent shows enemy players seen within the configured recent-time window.

Lost shows contacts that were recently lost or held by lost-contact and stealth logic.

KoS shows the full KoS and Guild-KoS management view.

All shows the local enemy history and is mainly useful for review, cleanup, and maintenance.

Shared sightings are no longer a separate primary mode. They are folded into Watch and Recent and marked with a shared icon.

---

Lost Contact Alerts

PvP Watch can warn when a previously visible hostile player disappears from available tracking sources.

This is useful for cases such as:

• Rogue stealth
• Druid stealth
• Hunter camouflage
• Mage invisibility
• Invisibility effects
• Line-of-sight loss
• Range loss
• Phasing or other visibility changes

Lost-contact alerts can be configured to trigger either for:

• Stealth-capable classes only
• All classes

Lost-contact behavior can also be filtered by PvP context, such as open world, battlegrounds, arena, and other PvP situations.

The lost-contact system is intentionally conservative. A disappearing nameplate alone does not always mean that a player is truly lost. PvP Watch rechecks available sources before treating a contact as lost.

---

KoS and Player Notes

Players can be marked as KoS, and guilds can be marked as Guild KoS. PvP Watch can highlight these players more prominently and warn when they are detected again.

You can also store notes for individual players.

KoS entries, Guild-KoS entries, and noted players are protected from automatic cleanup.

KoS alerts are throttled to reduce repeated alarm spam when the same KoS player remains nearby or is repeatedly detected within a short time.

---

Enemy Cooldown Tracking

PvP Watch can track observed enemy cooldown usage when the client is able to see the spellcast, combat-log event, visible aura, or related addon-accessible data.

This includes support for:

• Important defensive cooldowns
• Interrupts
• Crowd-control cooldowns
• PvP trinket-style cooldowns
• Selected PvP item effects
• Configurable cooldown categories
• Exact-spell cooldown filtering

The Enemy Cooldowns window shows observed cooldown activity across detected enemy players.

Expired cooldown entries are automatically removed.

---

Target Cooldown Panel

The Target Cooldown Panel can show cooldown information for your current hostile target and filter known cooldowns by detected class where possible.

Active cooldowns can display an icon overlay and remaining-time indicator when the addon has observed cooldown usage.

This panel is intended to make relevant cooldown information easier to see for your current target without overloading the Main Watch window.

---

Cooldown Bars

PvP Watch includes cooldown bar support for observed cooldowns.

The display is configurable and can be adjusted for:

• Size
• Icon count
• Icon spacing
• Opacity
• Visibility
• Automatic hiding behavior

Cooldown bars are intended as a compact way to keep track of important observed cooldowns.

---

Important Auras and Debuffs

PvP Watch includes lightweight aura and debuff awareness inspired by BigDebuffs-style functionality.

It can display important visible effects such as:

• Crowd-control effects
• Defensive effects
• Immunities
• High-priority PvP auras

Only visible and addon-accessible aura data is used.

---

Diminishing Returns Tracker

PvP Watch includes a lightweight diminishing returns tracker for visible crowd-control information where available.

DR display behavior and icon sizing can be adjusted in the options.

---

Enemy Frames Light

PvP Watch can show a compact enemy-frame style window with relevant enemy information gathered from sightings, cooldowns, debuffs, and active PvP data.

This window can be configured for:

• Size
• Visibility
• Opacity
• Filtering
• Table layout
• Automatic hiding behavior

Enemy Frames Light is intended as a compact overview, not as a full arena-frame replacement.

---

Team Cooldowns

PvP Watch includes a lightweight team cooldown tracker for party, raid, and instance-group situations.

It can help track:

• Party cooldowns
• Interrupt availability
• Shared cooldown information
• Optional addon sync with other PvP Watch users

The Team Cooldowns window does not open while solo.

Your own cooldowns can be shared to group members but are not shown locally in your own Team Cooldowns window.

Sharing can be configured separately depending on PvP context.

---

Configurable Alerts

PvP Watch supports configurable alerts through:

• Chat messages
• Raid-warning-style popups
• Sounds
• Per-event sound settings
• No-sound option per event
• Context-specific behavior for open world, battlegrounds, arena, and other PvP contexts

Sound alerts can be disabled globally or individually per event type.

---

UI Customization

Most windows can be adjusted through the options menu.

Configurable UI elements include:

• Main Watch window
• Enemy Cooldowns
• Enemy Frames Light
• Target Cooldown Panel
• Team Cooldowns
• Cooldown bars
• Target Crosshair
• Minimap button
• Window opacity
• Font size
• Row count
• Scaling
• Icon size
• Column visibility
• Lock and unlock state
• Auto-hide behavior

Numeric settings are primarily handled through sliders for easier configuration.

The options menu has been reorganized around major windows and systems to make configuration easier to understand.

---

Target Crosshair

PvP Watch includes a configurable target crosshair for dangerous hostile targets.

The crosshair can be adjusted for:

• Size
• Thickness
• Gap
• Alpha
• Color
• Text visibility
• KoS-only behavior

---

PvP-Themed Icons

PvP Watch uses a custom dark fantasy and PvP-themed icon set for its windows, buttons, and status indicators.

The icon style is designed to fit a fantasy PvP addon instead of looking like a generic software interface.

---

Basic Commands

---

Main command:

• /dpvp

Common commands:

• /dpvp options
• /dpvp guide
• /dpvp commands
• /dpvp toggle
• /dpvp status
• /dpvp minimap
• /dpvp mode
• /dpvp view watch|active|recent|lost|kos|all

Player tracking:

• /dpvp kos NAME
• /dpvp guildkos GUILD
• /dpvp note NAME TEXT
• /dpvp where NAME
• /dpvp history NAME

Lost-contact mode:

• /dpvp lostmode stealth
• /dpvp lostmode all
• /dpvp lostdelay SECONDS

Cooldown and display tests:

• /dpvp cdtest
• /dpvp bdtest
• /dpvp drtest
• /dpvp teamtest
• /dpvp targetcds
• /dpvp crosshair
• /dpvp enemies
• /dpvp teamcds

Support and debug:

• /dpvp errors
• /dpvp dump
• /dpvp bugreport
• /dpvp perf
• /dpvp sources
• /dpvp scanstatus
• /dpvp tokens

---

Important API and Targeting Note

---

PvP Watch stays inside Blizzard's protected UI rules.

Table-click targeting can only use secure Blizzard-compatible paths such as live UnitTokens or prepared real macro actions.

Direct arbitrary targeting by stored name or GUID is not reliable and may be blocked by combat lockdown, secret values, or protected action rules.

PvP Watch does not use hidden server-side data, memory reading, automation, or external scanning tools.

---

Current Status

---

PvP Watch is a live release, but still benefits from ongoing PvP testing and feedback.

More real PvP testing is especially useful in:

• Open-world PvP
• War Mode
• Battlegrounds
• Arena
• Group PvP
• Different classes
• Different client languages
• Different UI scale and layout setups

Bug reports, Lua errors, layout issues, balance suggestions, and feature ideas are welcome.

If you report an issue, please include:

• What happened
• What you expected to happen
• Your PvP Watch version
• Any Lua error text
• Steps to reproduce the issue if possible
• Whether the issue happened in combat or out of combat
• Whether enemy nameplates were visible

The built-in debug and error tools can help generate useful information:

• /dpvp errors
• /dpvp dump

---

Donations

---

PvP Watch is a free addon. If you like the project and want to support the time and work going into development, testing, debugging, and future improvements, donations are welcome but completely optional.

CurseForge: https://www.curseforge.com/wow/addons/pvp-watch