{"id":26473106,"url":"https://github.com/ragedunicorn/wow-classic-pvpwarn","last_synced_at":"2026-07-16T23:33:11.390Z","repository":{"id":96252068,"uuid":"193556600","full_name":"RagedUnicorn/wow-classic-pvpwarn","owner":"RagedUnicorn","description":"WoW Classic Addon for alerting visually and acoustically about pvp events","archived":false,"fork":false,"pushed_at":"2025-09-11T18:52:39.000Z","size":43794,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-09-11T21:39:47.481Z","etag":null,"topics":["classic","classic-wow","classic-wow-addons","curseforge","wago","world-of-warcraft","wow","wow-addon","wowup"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RagedUnicorn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-06-24T18:16:09.000Z","updated_at":"2025-09-11T18:52:40.000Z","dependencies_parsed_at":"2024-12-27T14:18:28.055Z","dependency_job_id":"42124d78-b7e1-4b2d-97a8-f88c9e6e8c1f","html_url":"https://github.com/RagedUnicorn/wow-classic-pvpwarn","commit_stats":null,"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"purl":"pkg:github/RagedUnicorn/wow-classic-pvpwarn","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RagedUnicorn%2Fwow-classic-pvpwarn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RagedUnicorn%2Fwow-classic-pvpwarn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RagedUnicorn%2Fwow-classic-pvpwarn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RagedUnicorn%2Fwow-classic-pvpwarn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RagedUnicorn","download_url":"https://codeload.github.com/RagedUnicorn/wow-classic-pvpwarn/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RagedUnicorn%2Fwow-classic-pvpwarn/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279016930,"owners_count":26085889,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-13T02:00:06.723Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["classic","classic-wow","classic-wow-addons","curseforge","wago","world-of-warcraft","wow","wow-addon","wowup"],"created_at":"2025-03-19T21:50:55.623Z","updated_at":"2026-07-16T23:33:11.384Z","avatar_url":"https://github.com/RagedUnicorn.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PVPWarn\n\n![](docs/ragedunicorn_wow_banner.png)\n\n\u003e 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\n\n![](docs/wow_badge_classic.svg)\n![](docs/wow_badge_tbc.svg)\n![](docs/license_mit.svg)\n![Lint](https://github.com/RagedUnicorn/wow-classic-pvpwarn/actions/workflows/lint.yaml/badge.svg?branch=master)\n\nPVPWarn 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.\n\n## Providers\n\n[![](docs/curseforge.svg)](https://www.curseforge.com/wow/addons/pvpwarn)\n[![](docs/wago.svg)](https://addons.wago.io/addons/pvpwarn)\n\n## Installation\n\nWoW-Addons are installed directly in your WoW directory:\n\n`[WoW-installation-directory]\\Interface\\AddOns`\n\nMake sure to get the newest version of the Addon from the releases tab:\n\n[PVPWarn-Releases](https://github.com/RagedUnicorn/wow-classic-pvpwarn/releases)\n\n\u003e Note: If the Addon is not showing up in your ingame Addonlist make sure that the Addon is named `PVPWarn` in your Addons folder\n\n## What is PVPWarn?\n\nPVPWarn'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.\n\n## Features of PVPWarn\n\n### Warning\n\nThe basic feature of warning the player can be configured for each class and some additional categories such as items, racials and misc.\n\n![](docs/pvpwarn_configure_spell.gif)\n\n### Avoiding Spells\n\nPVPWarn can also detect when certain spells were resisted, either by the player or by an enemy player.\n\n#### Self Avoid\n\nThe 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.\n\n![](docs/pvpwarn_configure_self_avoid.gif)\n\n#### Enemy Avoid\n\nTo 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.\n\n![](docs/pvpwarn_configure_enemy_avoid.gif)\n\n### Profiles\n\nPVPWarn 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.\n\n#### Loading Profiles with Macros\n\nOnce a profile is created, it can be loaded manually or with a macro.\n\n```lua\n/run _G[\"RGPVPW_MACRO_LOADPROFILE\"](\"[profileName]\")\n-- e.g.\n/run _G[\"RGPVPW_MACRO_LOADPROFILE\"](\"Warriorprofile\")\n```\n\n### Enable/Disable Addon in Zones\n\nThe 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.\n\n![](docs/pvpwarn_configure_zones.png)\n\n### Combat State\n\nPVPWarn 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.\n\n![](docs/pvpwarn_combat.gif)\n\n### Stance State\n\nPVPWarn can track a target's stance state and will display it next to the target frame. The stance icon can be\nmoved to another place if required. Tracking the stance is limited to certain classes and is only possible if\nPVPWarn was able to observe the stance in the combat log.\n\n![](docs/pvpwarn_switching_stance.gif)\n\nIf PVPWarn is unable to determine the stance it will display a question mark for an icon.\n\n### Detection Bar\n\nPVPWarn 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`.\n\n### Flash\n\nPVPWarn 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.\n\n### Voice Packs\n\nPVPWarn 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.\n\n#### Available Voice Packs\n\n**VPNFC - Night Elf Female Character**\n- Repository: [Nightelf Female Classic](https://github.com/RagedUnicorn/wow-classic-pvpwarn-vpnfc)\n- Features audio cues spoken by a Night Elf Female Character voice\n\n**VPUMC - Undead Male Character**\n- Repository: [Undead Male Classic](https://github.com/RagedUnicorn/wow-classic-pvpwarn-vpumc)\n- Features audio cues spoken by an Undead Male Character voice\n\n**VPGFC - Gnome Female Character**\n- Repository: [Gnome Female Classic](https://github.com/RagedUnicorn/wow-classic-pvpwarn-vpgfc)\n- Features audio cues spoken by a Gnome Female Character voice\n\n#### Installation and Usage\n\nVoice 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.\n\n## FAQ\n\n#### The Addon is not showing up in WoW. What can I do?\n\nMake 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`.\n\n#### I get a red error (Lua Error) on my screen. What is this?\n\nThis 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.\n\n#### PVPWarn spams my chat with messages. How can I deactivate this?\n\nThose 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\n\n#### PVPWarn did not warn me about a certain spell. Why?\n\nThis 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.\n\n#### PVPWarn does not support my Spell. What can I do?\n\nPVPWarn 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).\n\n#### PVPWarn shows me a question mark instead of the stance of the player\n\nThis is a limitation of the WoW API. Stances can only be observed when a warrior is switching from one stance to\nanother. It is not possible to query the current stance directly. PVPWarn will, however, display the stance as soon\nas it is able to observe it.\n\n## Contributing Combat Logs\n\nYou can help make PVPWarn more accurate without writing any code. PVPWarn matches spells by their\nspell ID and combat-log events, and these are verified against real in-game combat logs. By\nrecording a combat log and attaching it to a GitHub issue you help confirm that spells are tracked\ncorrectly across Classic Era, Burning Crusade Anniversary and Season of Discovery.\n\nNo tools or analysis are required on your end - just record a log and attach it. See\n[CONTRIBUTING.md](CONTRIBUTING.md) for a step-by-step guide on enabling combat logging, where the\nfile is saved, and how to submit it.\n\n## Development\n\nFor detailed development information including environment setup, packaging, deployment procedures, and contribution guidelines, please see [DEVELOPMENT.md](DEVELOPMENT.md).\n\n## License\n\nMIT License\n\nCopyright (c) 2025 Michael Wiesendanger\n\nPermission is hereby granted, free of charge, to any person obtaining\na copy of this software and associated documentation files (the\n\"Software\"), to deal in the Software without restriction, including\nwithout limitation the rights to use, copy, modify, merge, publish,\ndistribute, sublicense, and/or sell copies of the Software, and to\npermit persons to whom the Software is furnished to do so, subject to\nthe following conditions:\n\nThe above copyright notice and this permission notice shall be\nincluded in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\nEXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\nMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\nNONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE\nLIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION\nOF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION\nWITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fragedunicorn%2Fwow-classic-pvpwarn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fragedunicorn%2Fwow-classic-pvpwarn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fragedunicorn%2Fwow-classic-pvpwarn/lists"}