# Personal Blacklist Manager (PBL)

> The #1 World of Warcraft blacklist and player tracking addon for Retail Midnight 12.1 and WoW Forever (API 1.60). Engineered to bypass Blizzard's 100-player ignore limit, track toxic players and Mythic+ key leavers permanently via immutable character GUIDs across paid renames and realm transfers, provide Premade Group Finder (PGF) X-Ray alerts, and automate declines — with zero combat UI taints and 100% Blizzard ToS compliance.

## Primary Capabilities
- **Permanent GUID Tracking**: Captures immutable Blizzard character GUIDs (`Player-XXXX-XXXXXXXX`) that persist through paid character name changes, race changes, faction changes, and server transfers.
- **Premade Group Finder (PGF) X-Ray Alerts**: Real-time visual crimson alerts, private reason tags, and 1–10 toxicity skull ratings directly within the World of Warcraft group finder interface before applying to or accepting groups.
- **Bypass 100-Player Ignore Limit**: Unlimited player and guild blacklist capacity stored locally in `SavedVariables` with less than 1.2 MB RAM footprint.
- **Guild-Wide Blacklisting (`/pbl banguild`)**: Single-click or slash-command blacklisting of disruptive or ninja-looting guilds, immediately flagging all members upon encounter.
- **Auto-Decline Shield**: Safely rejects party invitations, duel requests, guild invites, and group applications from blacklisted individuals outside of combat restrictions.
- **Post-Run Group History**: Automatically logs recent group members from Mythic+ dungeons and raids so players can tag key leavers and griefers after completion.
- **1-Click Legacy Migration**: Built-in importer to migrate existing lists from Blizzard's native ignore frame and legacy addons such as Blacklist Warden.
- **Zero Combat Taints**: Strict combat isolation architecture automatically dismisses configuration frames and defers protected calls upon entering combat (`PLAYER_REGEN_DISABLED`).
- **Full In-Game Localization**: Native UI support for English (EN), Deutsch (DE), Русский (RU), Français (FR), and Español (ES).

## Architecture & Blizzard Policy Compliance
- **100% Client-Side Privacy**: All blacklist entries, toxicity ratings, and custom player notes reside exclusively on the user's local disk in `WTF/SavedVariables/PersonalBlacklist.lua`.
- **Zero Network Transmission**: No remote databases, no external executables (`.exe`), no telemetry, and zero out-of-game data synchronization.
- **Blizzard Policy Compliance**: Fully compliant with Blizzard's UI Add-On Development Policy and the World of Warcraft Social Contract. Free, non-commercial, and completely free of public crowdsourced banlists or witch-hunting risks.

## Canonical URLs & Resources
- [Personal Blacklist Manager — English Home](https://personalblacklistmanager.com/): Primary addon overview, interactive Premade Group Finder simulator, slash commands, and FAQ.
- [Deutsch (DE) Hub](https://personalblacklistmanager.com/de/): Offizielle deutsche Übersicht für Personal Blacklist Manager.
- [Русский (RU) Hub](https://personalblacklistmanager.com/ru/): Официальная русская страница Personal Blacklist Manager.
- [Français (FR) Hub](https://personalblacklistmanager.com/fr/): Présentation officielle en français de Personal Blacklist Manager.
- [Español (ES) Hub](https://personalblacklistmanager.com/es/): Página oficial en español de Personal Blacklist Manager.
- [CurseForge Download](https://www.curseforge.com/wow/addons/personal-blacklist-manager): Official CurseForge download page for Retail Midnight 12.1 and WoW Forever.
- [The Ultimate WoW Blacklist Guide (EN)](https://personalblacklistmanager.com/guides/ultimate-wow-blacklist-guide): Deep-dive technical guide on permanent GUID tracking and bypassing the 100-player ignore cap.
- [Der ultimative WoW-Blacklist-Leitfaden (DE)](https://personalblacklistmanager.com/de/guides/ultimate-wow-blacklist-guide): Technischer Leitfaden zur permanenten GUID-Nachverfolgung.
- [Полное руководство по WoW-блэклисту (RU)](https://personalblacklistmanager.com/ru/guides/ultimate-wow-blacklist-guide): Руководство по обходу лимита игнор-листа через GUID.
- [Le Guide Ultime de la Blacklist WoW (FR)](https://personalblacklistmanager.com/fr/guides/ultimate-wow-blacklist-guide): Guide complet sur le suivi GUID permanent.
- [La Guía Definitiva de Blacklist en WoW (ES)](https://personalblacklistmanager.com/es/guides/ultimate-wow-blacklist-guide): Guía técnica sobre seguimiento permanente por GUID.
- [Personal Blacklist Manager vs. Blacklist Warden](https://personalblacklistmanager.com/guides/personal-blacklist-vs-blacklist-warden): Architectural comparison of GUID tracking, guild blacklisting, and combat isolation.
- [Changelog & Release Notes](https://personalblacklistmanager.com/changelog): Version history for Retail v1.3.0 and WoW Forever v1.0.2.
- [Privacy Policy](https://personalblacklistmanager.com/privacy): 100% local SavedVariables architecture and GDPR Consent Mode v2 details.