https://github.com/ragedunicorn/wow-classic-pvpwarn

WoW Classic Addon for alerting visually and acoustically about pvp events
https://github.com/ragedunicorn/wow-classic-pvpwarn

classic classic-wow classic-wow-addons curseforge wago world-of-warcraft wow wow-addon wowup

Last synced: 8 days ago
JSON representation

WoW Classic Addon for alerting visually and acoustically about pvp events

• Host: GitHub
• URL: https://github.com/ragedunicorn/wow-classic-pvpwarn
• Owner: RagedUnicorn
• License: mit
• Created: 2019-06-24T18:16:09.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2025-09-11T18:52:39.000Z (11 months ago)
• Last Synced: 2025-09-11T21:39:47.481Z (11 months ago)
• Topics: classic, classic-wow, classic-wow-addons, curseforge, wago, world-of-warcraft, wow, wow-addon, wowup
• Language: Lua
• Homepage:
• Size: 41.8 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# PVPWarn

![](docs/ragedunicorn_wow_banner.png)

> PVPWarn aims to help players hear and see enemy spells cast on them, as well as spells that an enemy player resisted or that the player themselves resisted

![](docs/wow_badge_classic.svg)

![](docs/wow_badge_tbc.svg)

![](docs/license_mit.svg)

![Lint](https://github.com/RagedUnicorn/wow-classic-pvpwarn/actions/workflows/lint.yaml/badge.svg?branch=master)

PVPWarn uses both visual and acoustic effects to make the player aware of certain events. The addon aims to be configurable to the players preferences and allows customization on exactly what spells should be brought to the attention of the player and in what form.

## Providers

[![](docs/curseforge.svg)](https://www.curseforge.com/wow/addons/pvpwarn)

[![](docs/wago.svg)](https://addons.wago.io/addons/pvpwarn)

## Installation

WoW-Addons are installed directly in your WoW directory:

`[WoW-installation-directory]\Interface\AddOns`

Make sure to get the newest version of the Addon from the releases tab:

[PVPWarn-Releases](https://github.com/RagedUnicorn/wow-classic-pvpwarn/releases)

> Note: If the Addon is not showing up in your ingame Addonlist make sure that the Addon is named `PVPWarn` in your Addons folder

## What is PVPWarn?

PVPWarn's goal is to help the player recognize combat log events in a more visual and acoustic way. PVPWarn can display visual and acoustic cues when a certain event is found in the combat log. As an example, PVPWarn might play a sound both when an enemy warrior activates Recklessness and when it runs out.

## Features of PVPWarn

### Warning

The basic feature of warning the player can be configured for each class and some additional categories such as items, racials and misc.

![](docs/pvpwarn_configure_spell.gif)

### Avoiding Spells

PVPWarn can also detect when certain spells were resisted, either by the player or by an enemy player.

#### Self Avoid

The avoid tab allows you to configure warnings for all spells of a certain category. If you're interested in knowing when you resist a certain spell, such as the silence of a shadow priest, you configure this in the priest category.

![](docs/pvpwarn_configure_self_avoid.gif)

#### Enemy Avoid

To configure the resist warning for your own class, use the `Enemy Avoid` navigation point. This menu contains all spells for your class that can be resisted and are supported by PVPWarn. If you play a different class, the content of that menu will differ.

![](docs/pvpwarn_configure_enemy_avoid.gif)

### Profiles

PVPWarn loads a default profile based on your class when the addon loads for the first time. The default profile can be loaded again at any point. If you start modifying which spells are tracked, however, you can create a new profile, or even keep multiple different profiles that you can load depending on your situation.

#### Loading Profiles with Macros

Once a profile is created, it can be loaded manually or with a macro.

```lua

/run _G["RGPVPW_MACRO_LOADPROFILE"]("[profileName]")

-- e.g.

/run _G["RGPVPW_MACRO_LOADPROFILE"]("Warriorprofile")

```

### Enable/Disable Addon in Zones

The addon can be configured to automatically enable or disable itself in certain zones. This might be useful in zones such as Alterac Valley, where a lot of events are generated.

![](docs/pvpwarn_configure_zones.png)

### Combat State

PVPWarn can track a target's combat state and will display it next to the target frame. The combat icon can be moved to another place if required.

![](docs/pvpwarn_combat.gif)

### Stance State

PVPWarn can track a target's stance state and will display it next to the target frame. The stance icon can be

moved to another place if required. Tracking the stance is limited to certain classes and is only possible if

PVPWarn was able to observe the stance in the combat log.

![](docs/pvpwarn_switching_stance.gif)

If PVPWarn is unable to determine the stance it will display a question mark for an icon.

### Detection Bar

PVPWarn can display detected enemy spells as a stack of bars on the screen. Each bar shows the spell icon with a class-colored border, the detected event and the name of the enemy player. The detection bar is a global feature that can be enabled in the settings, where the scale and the maximum amount of bars shown at once can be configured as well. The bar can also be repositioned, locked, unlocked or tested with `/rgpvpw bar lock/unlock/test`.

### Flash

PVPWarn can flash the edges of the screen with a soft vignette when a spell with a configured visual warning is detected. The flash uses the same color that was chosen for the spell's visual warning. The feature can be enabled in the settings, where the maximum opacity, an additional pulse effect and additive blending can be configured and tested.

### Voice Packs

PVPWarn supports configurable voice packs to customize the audio experience with different character voices. Voice packs are separate addon packages that can be installed alongside PVPWarn to provide alternative audio cues.

#### Available Voice Packs

**VPNFC - Night Elf Female Character**

- Repository: [Nightelf Female Classic](https://github.com/RagedUnicorn/wow-classic-pvpwarn-vpnfc)

- Features audio cues spoken by a Night Elf Female Character voice

**VPUMC - Undead Male Character**

- Repository: [Undead Male Classic](https://github.com/RagedUnicorn/wow-classic-pvpwarn-vpumc)

- Features audio cues spoken by an Undead Male Character voice

**VPGFC - Gnome Female Character**

- Repository: [Gnome Female Classic](https://github.com/RagedUnicorn/wow-classic-pvpwarn-vpgfc)

- Features audio cues spoken by a Gnome Female Character voice

#### Installation and Usage

Voice packs are installed as separate addons in your `Interface\AddOns` directory alongside PVPWarn. Once installed, you can configure which voice pack to use through PVPWarn's settings. Each voice pack provides a unique audio experience while maintaining all of PVPWarn's core functionality.

## FAQ

#### The Addon is not showing up in WoW. What can I do?

Make sure to recheck the installation part of this Readme and check that the Addon is placed inside `[WoW-installation-directory]\Interface\AddOns` and is correctly named as `PVPWarn`.

#### I get a red error (Lua Error) on my screen. What is this?

This is what we call a Lua error, and it usually happens because of an oversight or mistake by the developer (in this case, me). Take a screenshot of the error and create a GitHub issue with it, and I will see if I can resolve it. It also helps if you can add any additional information about what you were doing at the time and which other addons you have active. Additionally, if you are able to reproduce the error, make sure to check whether it still happens when you disable all other addons.

#### PVPWarn spams my chat with messages. How can I deactivate this?

Those obnoxious messages are intended for the development of this addon and means that you download a development version of the addon instead of a proper release. Releases can be downloaded from here - https://github.com/RagedUnicorn/wow-classic-pvpwarn/releases

#### PVPWarn did not warn me about a certain spell. Why?

This can have multiple causes. It might be an actual bug where the addon did not recognize the spell. Before creating a ticket, however, please make sure to check that the spell is actually configured to show a visual or acoustic warning.

#### PVPWarn does not support my Spell. What can I do?

PVPWarn is not complete, and certain spells might have simply been forgotten. If there is a spell that you would like to see supported in a future version of the addon, make sure to create a ticket for it, and I will have a look at it. Attaching a combat log that contains the spell speeds up verification a lot - see [Contributing Combat Logs](CONTRIBUTING.md).

#### PVPWarn shows me a question mark instead of the stance of the player

This is a limitation of the WoW API. Stances can only be observed when a warrior is switching from one stance to

another. It is not possible to query the current stance directly. PVPWarn will, however, display the stance as soon

as it is able to observe it.

## Contributing Combat Logs

You can help make PVPWarn more accurate without writing any code. PVPWarn matches spells by their

spell ID and combat-log events, and these are verified against real in-game combat logs. By

recording a combat log and attaching it to a GitHub issue you help confirm that spells are tracked

correctly across Classic Era, Burning Crusade Anniversary and Season of Discovery.

No tools or analysis are required on your end - just record a log and attach it. See

[CONTRIBUTING.md](CONTRIBUTING.md) for a step-by-step guide on enabling combat logging, where the

file is saved, and how to submit it.

## Development

For detailed development information including environment setup, packaging, deployment procedures, and contribution guidelines, please see [DEVELOPMENT.md](DEVELOPMENT.md).

## License

MIT License

Copyright (c) 2025 Michael Wiesendanger

Permission is hereby granted, free of charge, to any person obtaining

a copy of this software and associated documentation files (the

"Software"), to deal in the Software without restriction, including

without limitation the rights to use, copy, modify, merge, publish,

distribute, sublicense, and/or sell copies of the Software, and to

permit persons to whom the Software is furnished to do so, subject to

the following conditions:

The above copyright notice and this permission notice shall be

included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,

EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF

MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND

NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE

LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION

OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION

WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.