Skip to content

RagedUnicorn/wow-classic-pvpwarn

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PVPWarn

PVPWarn aims to help the player to hear and see enemy spells cast on himself and also spells that an enemy player resisted or spells that the player himself resisted

Lint

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

WoW Classic Support

This Addon supports WoW Burning Crusade Classic see - bcc-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

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?

PVPWarns goal is to help the player recognizing combat log events in a more visual and acoustical way. PVPWarn can display visual and acoustical 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.

Avoiding Spells

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

Self Avoid

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

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 use a different class the content of that menu is different.

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 however start modifying what spells are tracked you can create a new profile, or you can even have multiple different profiles that you can then load based on your situation.

Loading Profiles with Macros

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

/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 in certain zones. This might be useful in Zones such as Alterac Valley where a lot of events are getting generated.

Combat State

PVPWarn can track a targets combat state and will display this next to the targetframe. The combat icon can be moved to another place if required.

Stance State

PVPWarn can track a targets stance state and will display this next to the targetframe.The stance icon can be moved to another place if required. Tracking the stance is limited to certain classes and can only be tracked if PVPWarn was able to observe the stance in the combatlog.

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

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

VPUMC - Undead Male Character

VPGFC - Gnome Female Character

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 error by the developer (in this case me). Take a screenshot off 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 of what you were doing at the time and what other addons you have active. Additionally, if you are able to reproduce the error make sure to check if it still happens if you disable all others 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 errors. 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 acoustical warning.

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

PVPWarn is not complete and certain spells might have simply forgotten. If you have a certain 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.

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 get infos about the current stance. PVPWarn will however display the stance as soon as it is able to observe it.

Development

For detailed development information including environment setup, packaging, deployment procedures, and contribution guidelines, please see 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.

About

WoW Classic Addon for alerting visually and acoustically about pvp events

Topics

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •