WarlordsPvP

The ultimate addon for PvP guilds in World of Warcraft Classic. Combines enemy tracking, honorable kill statistics, guild PvP ranks, bounty hunting, and raid management into one powerful package.

Built for PvP Guilds

WarlordsPvP is designed specifically for guilds focused on world PvP, city raids, and organized PvP content. Whether you're hunting enemies in the open world, tracking your guild's kill counts, or coordinating a raid on an enemy capital, this addon has the tools you need.

Core Features

Enemy Tracking

• Nearby Detection: Alerts when enemy players enter your area with class, level, and guild info
• Kill on Sight List: Mark priority targets for special alerts when detected — synced across all guild members
• Login Catch-Up: When you log in, guild members share their recently detected enemies so you're immediately aware of nearby threats
• Guild Bounties: Officers can place bounties on enemy players or entire guilds - get alerted when bounty targets are nearby

Honorable Kill Tracking

• Detailed Statistics: Track every honorable kill with full details - who, where, when, class, race, level
• Death Tracking: Know exactly who killed you and how many times
• Kill Streaks: Track your current streak and personal records
• Breakdowns: Stats by class, race, zone, guild, and time period
• Honorable vs Total: Distinguishes gray kills from honor-awarding kills

How Kills Are Detected: The addon detects honorable kills in multiple ways to ensure all participants get credit:

1. Honor Gain Events - When you receive honor from a kill, the addon automatically records it. This works for ALL roles including healers who never deal damage.
2. Killing Blows - Direct killing blows you or your party/raid land
3. Assists - Kills where you dealt damage within 60 seconds of death

Only kills against enemies within 2 levels of you are counted as honorable. Very low-level kills (gray enemies) are excluded to keep statistics meaningful. Kills are tracked even if you're honor capped.

Guild PvP Ranks

Earn ranks based on your open world honorable kills while in your guild:

Announce your rank and kills to guild chat, visible on minimap tooltip, with achievements for each rank milestone.

Guild Bounty System

Officers can coordinate guild-wide target priorities:

• Player Bounties: Target specific enemies - one-time or recurring
• Guild Bounties: Alert when ANY member of an enemy guild is detected
• Claim Tracking: Records who kills bounty targets, where, and when
• Auto-Sync: Bounties automatically shared with all online guild members
• Right-Click Integration: Add bounties directly from the Spy window

SOS Emergency Alert

Call for backup when outnumbered in the open world:

• One-Click Alert: Type /wl sos, middle-click the minimap button, or click the on-screen SOS button
• Full Situational Report: Sends your zone, coordinates, and nearest flight path
• Enemy Intel: Lists all nearby detected enemies with name, level, class, and guild
• Guild Chat: Alerts go to guild chat so guildies can fly to help
• Local Defense: Optionally alert the zone's Local Defense channel
• Nearest Flight Path: Automatically tells responders the closest flight point to your location
• On-Screen Button: Compact draggable SOS button - drag to reposition, click X to dismiss
• Configurable: Enable/disable channels and the on-screen button in Options > SOS Alert

PvP Raid Management

Tools for organizing guild PvP raids:

• Guild Raid Indicator: Green dots on raid frames highlight guild members in mixed groups
• Guild Raid Inviter: One-click invite all online guild members to raid with optional guild announcement
• Raid Warnings: Officers create preset /rw messages shared across all guild officers
  • Compact quick-button window appears automatically when you're raid leader/assistant
  • Full configuration UI with add/edit/delete for each warning
  • Warnings sync automatically between officers via guild communication

Guild Master Controls

The Guild Master has a dedicated settings panel to control guild-wide features:

• Guild Map Tracking Toggle: GM can enable or disable position sharing for the entire guild
• Automatic Sync: Settings propagate to all online members immediately
• Offline Catch-Up: Members who log in later receive settings from any online peer
• Peer-to-Peer: No central server needed - settings spread from member to member
• Read-Only for Members: Non-GM members can see settings but cannot change them

Guild Map Tracking

See your guild members on the world map and minimap in real-time:

• GM Controlled: Must be enabled by the Guild Master (disabled by default for security)
• World Map Pins: Guild members show as class-colored icons on the world map
• Minimap Pins: Nearby guild members visible on your minimap
• Rank Indicators: Icons show guild rank (GM, Officer, Veteran, Member)
• Detailed Tooltips: Hover to see name, level, class, rank, and health
• Display Options: Show levels, names, health bars, or use simple dots
• Layer Support: For Classic servers with layers - filter by layer, see layer indicators
• Configurable Sizes: Adjust icon sizes for both world map and minimap
• Secure: Position data is sent only to guild members via guild-only addon channel

Guild Data Sync

All guild-wide data syncs automatically between members using secure peer-to-peer communication:

• Offline Catch-Up: When you log in, online guild members share their current KOS lists, bounties, raid warnings, GM settings, and recently detected enemies
• Peer-to-Peer: No central server — data spreads from member to member with timestamp-based conflict resolution
• Staggered Sync: Login requests are staggered (3s, 5s, 7s) with randomized response jitter to avoid message floods

Combat Performance

The addon is designed for zero impact during combat:

• All guild sync paused in combat — no outgoing guild broadcasts while you're fighting
• Party/Raid sharing stays active — your group still gets enemy detection intel
• Map tracking suspended — position broadcasting stops during combat
• Achievement calculations deferred — queued until combat ends
• Mouseover throttled — limited to 2x/sec during combat instead of every frame
• Auto-flush on combat end — all queued work processes automatically when you leave combat

Achievements

Over 100 PvP achievements including:

• Kill count milestones by class
• Kill streak achievements
• Zone-specific achievements
• Guild rank achievements

Each achievement awards a point value based on its difficulty. Your total achievement points are summed automatically and stored per-character.

Guild Achievement Points Leaderboard

Compare your PvP achievement progress with the rest of your guild:

• Ranked Window: Open with /wl points or the "Guild Leaderboard" button on the Achievements window
• Class-Colored Roster: See every guild member ranked by total points, with achievement count and level
• Your Rank: Your row is highlighted, and a summary shows your rank within the guild
• Auto-Sync: Your points broadcast to the guild on login and whenever your total changes (rate-limited)
• Minimap Tooltip: Hover the minimap button to see your points (X / total possible), achievements earned, and your guild rank
• Privacy-Safe: Only achievement points and unlock counts are shared — no kill data, no zone data
• Auto-Prune: Members who haven't been seen in 30+ days drop off the board automatically

War Effort

Guild-master / officer-driven donation drive for items the guild needs (mats for a raid push, BGs, recipes, etc.). The GM or any officer sets up a list of items + target quantities, and the whole guild can see what's needed and track progress.

• Setup: Type /wl war to open the progress window. The GM or any officer clicks "Add Item" to add an item by ID (or paste an item link), then enters a target quantity.
• Live Progress: For each item, a colored progress bar shows current count vs. target. Items past 50% turn yellow; past 100% turn green.
• Clickable Item Cards: Each item in the window is a clickable link — left-click for the WoW tooltip card, shift-click to paste into chat.
• Inventory Tracking: Progress is summed from the GM's bags and the guild bank inventory. The bank is snapshotted whenever the GM opens it; everyone sees a "snapshot from X minutes ago" hint so they know how fresh the count is.
• Bag / Bank Highlight: When a War Effort is active, every guild member's bag, bank, and guild bank slots that contain a tracked item get a small gold exclamation-mark icon. Easy to spot what's needed at a glance.
• Minimap Tooltip: The minimap button tooltip shows a "War Effort active" line with the title and overall percentage whenever a drive is underway.
• Minimap Icon: The minimap button's icon also switches to a gold exclamation mark whenever a War Effort is active, so it's recognizable at a glance.
• Options-Panel Section: A "War" tab in /wl config provides status + shortcut buttons (Add Item / Pause / End for officers and the GM) for discoverability.
• Permissions: GM or officers (anyone with edit-officer-note permission) can manage the list. Inventory tracking stays GM-only since only the GM has access to the guild bank.
• Cross-Version: Works on Classic Era 1.15.x and TBC Anniversary 2.5.x.

Event Calendar

Guild-master / officer-managed schedule of upcoming guild events (raids, premades, contests, world-boss attempts), surfaced on the minimap tooltip so everyone sees what's coming up without having to open a window.

• Setup: Type /wl events (or open the Events tab in /wl config) to see the event list. Officers and the GM see an Add Event button.
• Add Event Dialog: Title field + date picker (year / month / day in server time) + time picker (hour / minute) + +1 day / +7 days shortcut buttons. A live preview shows both the absolute date and the relative form ("in about 2 days") so there's no guessing.
• Minimap Tooltip Surfacing: The next 3 upcoming events appear on the minimap-button tooltip with weekday + time + relative form — "SW Raid · Monday 20:00 (in about 2 days)", "Premade Group · Wednesday 19:30 (in about 4 hours)".
• Grace Window: Events stay on the tooltip for 2 hours after they start ("started 15m ago") so members can confirm whether they're already underway. After that they drop off the tooltip and auto-purge from storage after a week.
• Permissions: View — anyone in the guild with the addon. Add / remove — Guild Master and officers (anyone with edit-officer-note permission).
• Sync: Officer / GM edits propagate via the addon's existing AceComm channel. New members request the current list at login from any officer / GM who's online.

Installation

1. Download and extract to your Interface/AddOns folder
2. Ensure the folder is named WarlordsPvP
3. Restart WoW or /reload

Commands

All commands use /wl:

General

Raid Management

Bounties (Officer)

War Effort (GM / Officer)

Event Calendar (GM / Officer)

Minimap Button

Tooltip shows your guild rank, progress to next rank, achievement points (with your guild leaderboard rank), an active War Effort summary when one is underway, the next 3 upcoming guild events with weekday + time + relative form, and recent kill statistics.

The Windows

Spy Window - Nearby enemy players with class, level, guild. Right-click for KOS, bounties, and more.

Statistics - Complete PvP stats with filters by class, zone, time period. Shows honorable vs total kills.

Kill History - Searchable log of every kill. Filter by class, level, zone, or name.

Bounty Window - Active bounties and recent claims. Officers can manage bounties here.

Raid Warnings - Compact window with preset warning buttons. Appears automatically when you're raid leader/assistant with warnings configured. Click any button to send that message as a /rw. No cap on the number of templates — the window scrolls past 12.

Raid Warnings Config - Full management UI for raid warnings. Add new warnings with name and message, edit existing ones, or delete with confirmation. Access via Options Panel > Raid Management > Manage Raid Warnings.

Guild Achievement Leaderboard - Ranked window of guild members by PvP achievement points. Open with /wl points or the button on the Achievements window.

War Effort - GM- or officer-managed donation drive. Lists items with target quantities, shows progress bars summed from the GM's bags + guild bank, and highlights wanted items in everyone's bags. Open with /wl war.

Event Calendar - GM- or officer-managed schedule of upcoming guild events. Title + date + time picker; events appear on the minimap tooltip with weekday + time + relative form ("SW Raid · Monday 20:00 (in about 2 days)"). Open with /wl events.

Settings

All settings live under Options → AddOns → WarlordsPvP (open via /wl config, /wl options, or left-click the minimap button). The tree is organized into one cohesive hierarchy:

(A legacy custom tabbed window is still reachable via /wl legacy-config for one release as a safety hatch and will be removed in a future update.)

Data Storage

• Kill statistics: Per-character
• KOS lists: Per-character, synced to guild
• Bounties: Account-wide, synced to guild
• Raid warnings: Account-wide, synced to officers
• War Effort: Per-guild, synced guild-wide; inventory snapshot owned by GM
• Event Calendar: Per-guild, synced guild-wide; auto-purges events older than a week
• Guild Master settings: Per-guild, synced P2P
• Window positions: Per-character

Compatibility

Works on both game versions from a single install:

• Classic Era (1.15.x) - Season of Discovery included
• TBC Anniversary (2.5.x)

All features work on both versions. Map-related features (map notes, guild map tracking) gracefully adapt to each version's map system.

Security

All guild communication uses WoW's GUILD addon message channel, which is server-enforced and invisible to non-guild players. Enemy players cannot intercept guild sync data.

• Position tracking: Guild-only channel, disabled by default, GM-controlled
• KOS lists: Guild-only channel
• Bounties: Guild-only channel
• Raid warnings: Guild-only channel
• SOS alerts: Guild chat by default. Local Defense is optional but is a public channel — enemies can read it. Use with caution.
• Spy detection sharing: Shared to party/raid during combat (non-guild members in your group can see enemy names). Guild-wide sharing is paused during combat.

Credits

Built from:

• Spy by Slipjack - Enemy detection
• PvPStats by Severussnipe & Hkfarmer - Kill tracking
• GuildRaidIndicator - Raid frame highlighting
• GuildRaidInviter - Mass invites
• MapMate - Guild member map tracking

Support

Issues? Open a ticket on the repo with error details.