promotional bannermobile promotional banner

Check-PvP Assistant

Addon that adds convenient access to Check-PvP.fr player profiles through right-click context menus.

File Details
DownloadInstall

CheckPvPAssistant-1.0.0.zip

ByKirom
  • R
  • Jul 1, 2025
  • 27.52 KB
  • 15
  • 11.1.7
  • Retail

File Name

CheckPvPAssistant-1.0.0.zip

Supported Versions

  • 11.1.7

CheckPvPAssistant v1.0.0 Release Notes

Release Date: July 1, 2025
Type: Initial Release
Compatibility: World of Warcraft: The War Within (11.1.7)

🎉 Initial Release

Welcome to the first release of CheckPvPAssistant! This addon seamlessly integrates Check-PvP.fr player lookups directly into World of Warcraft's context menu system, making PvP profile checks quick and convenient.

🚀 Core Features

Right-Click Menu Integration

  • Universal access - "Copy Check-PvP URL" option appears in player context menus
  • One-click convenience - Right-click any player to generate their Check-PvP.fr URL
  • Copy-ready dialog - URL appears in a dialog box, pre-selected for immediate copying (Ctrl+C)

Comprehensive Player Support

Works seamlessly across all player interaction contexts:

Context Description
Target Players Any player you have targeted
Party Members Players in your current party
Raid Members Players in your current raid
Guild Members Players from your guild roster
Community Members Players from community member lists
Friends List Regular friends from your friends list
Battle.net Friends Cross-realm Battle.net friends
LFG Creators Group leaders in LFG browser
LFG Seekers Players looking for groups in LFG
Enemy Players Opposing faction players
Self Your own character

LFG Integration

  • Search results - Right-click group leaders in the LFG browser
  • Applicant management - Right-click applicants when reviewing group applications
  • Cross-realm support - Handles players from different realms in LFG scenarios

Intelligent Region & Realm Handling

  • Automatic region detection - Uses character GUID analysis (same method as RaiderIO)
  • Supported regions - US, EU, KR, TW, CN
  • Comprehensive realm database - 1000+ realm name translations
  • Smart realm translation - Converts WoW internal names to Check-PvP.fr format
    • Example: AeriePeak → Aerie Peak
    • Example: Blade'sEdge → Blades Edge

🛠️ Configuration & Commands

Slash Commands

  • /checkpvp or /cpvp - Show available commands
  • /checkpvp debug - Toggle debug output for troubleshooting

Debug Mode

Enable detailed logging to help diagnose issues:

  • Region detection process
  • Realm translation results
  • Menu context data
  • URL generation details

Persistent Settings

  • Debug preferences automatically saved
  • Settings persist between game sessions
  • Stored in CheckPvPAssistantDB saved variable

🔧 Technical Architecture

Clean Modular Design

The addon follows clean architecture principles with focused modules:

src/
├── config.lua      # Configuration management
├── db/
│   ├── db_realms.lua   # 1000+ realm translations
│   └── db_regions.lua  # Region ID mappings
├── utils.lua       # Debug utilities and helpers
├── region.lua      # Region detection logic
├── url.lua         # URL generation logic
├── ui.lua          # UI components and dialogs
├── menu.lua        # Menu system integration
├── events.lua      # Event handling coordination
├── commands.lua    # Slash command handling
└── core.lua        # Main initialization

Modern WoW Integration

  • Menu API - Uses TWW's new Menu system for context menu hooks
  • Event handling - Proper event registration and cleanup
  • Performance optimized - Minimal memory footprint and efficient lookups
  • Error resilient - Graceful handling of missing data or edge cases

📖 Usage Instructions

  1. Right-click any player from any supported context
  2. Select "Copy Check-PvP URL" from the context menu
  3. Dialog appears with the Check-PvP.fr URL pre-selected
  4. Press Ctrl+C to copy the URL to your clipboard
  5. Press Enter or Escape to close the dialog
  6. Open the URL in your browser to view PvP statistics

Character Not Found?

If Check-PvP.fr shows "character not found":

  1. Copy the character name and realm from the error message
  2. Use the manual search on Check-PvP.fr
  3. This fetches the latest data from Blizzard's servers

⚠️ Known Issues

  • Regional testing - Only EU, US, and TW regions thoroughly tested
  • Future testing needed - KR and CN regions require additional validation

🎯 Requirements

  • World of Warcraft - The War Within (11.1.7)
  • Menu System - Uses the new Menu API introduced in TWW
  • No dependencies - Standalone addon with no external requirements

🔮 Future Plans

  • Distribution expansion - CurseForge and Wago integration
  • Localization - Multi-language support

💝 Acknowledgments

Special thanks to the Check-PvP.fr team for providing the excellent PvP statistics platform that makes this addon valuable to the WoW PvP community.

📞 Support & Feedback

For bug reports, feature requests, or general feedback:

  • GitHub Issues - CheckPvPAssistant Issues
  • Documentation - See README.md for detailed usage instructions and screenshots

Happy PvP hunting! 🗡️⚔️