promotional bannermobile promotional banner

PvP Profile

Provides convenient access to multiple PvP websites through right-click context menus. Supports multiple providers and allows users to choose which they want to use. Generates full URLs for the player that can be copied with Ctrl+C.

File Details

v1.0.0.zip

  • R
  • Jul 31, 2025
  • 36.81 KB
  • 11
  • 11.1.7+1
  • MoP Classic + 1

File Name

v1.0.0.zip

Supported Versions

  • 11.1.7
  • 5.5.0
# PvP Profile v1.0.0 Release Notes

**Release Date:** July 31, 2025  
**Type:** Initial Release  
**Compatibility:** World of Warcraft: The War Within (11.1.7) | MoP Classic (5.5.0)

---

## 🎉 Initial Release

Welcome to the first release of **PvP Profile**! This addon seamlessly integrates multiple PvP tracking websites 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 PvP Profile URL" option appears in player context menus
- **One-click convenience** - Right-click any player to generate their PvP Profile 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
- **Supported regions** - US, EU, KR, TW, CN
- **Comprehensive realm database** - 1000+ realm name translations
- **Smart realm translation** - Converts WoW internal names to PvP Profile format
  - Example: `AeriePeak` → `Aerie Peak`
  - Example: `Blade'sEdge` → `Blades Edge`

## 🛠️ Configuration & Commands

### Slash Commands
- `/pvpprofile` or `/pvp` - Show available commands
- `/pvpprofile 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 `PvPProfileDB` saved variable

## 🔧 Technical Architecture

### Clean Modular Design
The addon follows clean architecture principles with focused modules:

```
PvPProfile/
├── PvPProfile.toc                  # Retail addon metadata and load order
├── PvPProfile_Classic.toc          # MoP Classic addon metadata and load order
├── .github/                        # GitHub Actions configuration
├── assets/                         # Images and screenshots
│   └── README.md                   # Image documentation
├── ReleaseNotes/                   # Release notes for each version
├── scripts/                        # Scripts for automated testing and release
├── src/                            # Source code
│   ├── config.lua                  # Configuration management and version detection
│   ├── db/                         # Database files
│   │   ├── db_realms.lua           # Retail realm name translations
│   │   ├── db_classic_realms.lua   # MoP Classic realm additions
│   │   ├── db_regions.lua          # Retail region ID mappings
│   │   └── db_classic_regions.lua  # MoP Classic region additions
│   ├── 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
│   ├── options.lua                 # In-game options menu
│   ├── events.lua                  # Event handling coordination
│   ├── commands.lua                # Slash command handling
│   └── core.lua                    # Main initialization and coordination
├── CHANGELOG.md                    # Version history and changes
├── README.md                       # This file
└── LICENSE                         # License file
```

### 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. **Copy profile URL** from the context menu
3. **Dialog appears** with the PvP Profile 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

## 🎯 Requirements

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

---

## 💝 Acknowledgments

### **Website Creators & Providers**
- **[Check-PvP.fr](https://check-pvp.fr/)** - Retail and [classic support](https://check-pvp-classic.fr/)
- **[Drustvar.com](https://drustvar.com/)** - Retail only
- **[Seramate.com](https://seramate.com/)** - Retail only

### **Special Thanks**
- The creators and maintainers of Check-PvP.fr, Drustvar.com, and Seramate.com for providing excellent PvP tracking services
- BigWigs team for their excellent addon packaging and distribution tools

## 📞 Support & Feedback

For bug reports, feature requests, or general feedback:
- **GitHub Issues** - [PvP Profile Issues](https://github.com/Kirom/PvP-Profile/issues)
- **Documentation** - See README.md for detailed usage instructions and screenshots

---

**Happy PvP hunting!** 🗡️⚔️