FriendGroups

FriendGroups is a powerful contact manager and list enhancer, optimized for advanced social organization in modern World of Warcraft. It allows you to organize friends into custom groups while introducing a robust Alt-Character tracker, dynamic Guild integration, deep search capabilities, and seamless mass invites.

Whether you are a Raid Leader organizing rosters, a social butterfly managing contacts across realms, or just someone who wants a cleaner Friends List, FriendGroups provides the tools to keep your connections sorted and instantly accessible.

Despite its massive feature set, FriendGroups packs a serious punch without weighing down your game client. The interface is completely zero-garbage and memory-optimized, blending seamlessly with the default WoW UI or adapting beautifully to custom interface skins for a polished, native look.

🕵️‍♂️ NEW: Known Alts & "AKA" Engine

• The Spyglass Engine: We've added a comprehensive background tracker that securely logs and maps your Battle.net friends' WoW characters. Hovering over a friend on the Friends List, Guild Roster, or Communities frame will now display a beautiful static side-panel showing up to 10 of their recent known alts.
• Detailed Tracking: See their alt's class, level, faction, and exactly when and where they were last seen. Alts are automatically pruned after 14 days of inactivity to keep your database lean and fast.
• Dynamic "AKA" Nameplates: Friends logged into alternate characters will now dynamically display their "Main" character name directly on their contact button (e.g., [AltName] aka [MainName]). You'll always know exactly who you're talking to!

🛡️ NEW: Dynamic Guild Folders

• Automated Guildmate Sorting: The addon silently checks your active guild roster. Any Battle.net or WoW friends playing characters in that guild are instantly gathered into a dedicated [Guild] <GuildName> folder with zero setup required.
• Seamless Multi-Guild Support: The addon remembers exactly which alts belong to which guilds, silently building a master database of all your active guilds behind the scenes as you log into different characters.
• Custom Guild Folders (The < > Tag System): Typing a tag into a friend's note (like <Guildname>) dynamically generates a formatted guild folder. Works perfectly for ex-guildies, cross-realm teams, or custom communities.

⚡ Under-The-Hood: Extreme Performance

• Smart Layout Diffing: Say goodbye to your friends list randomly scrolling away from you! The addon seamlessly updates only the elements that changed, completely fixing the frustrating "scroll-jumping desync" bug.
• Combat Lockout Queue: If the Friends List attempts to update while you are actively in combat, the addon safely pauses the update and flawlessly executes it the moment combat drops, entirely avoiding Lua taint and UI errors.

🔍 Advanced Search & Filtering

• Persistent Search Bar: A static, always-visible search bar sits at the top of your Friends Frame for instant filtering.
• Zero-Garbage Smart Search: Our hyper-optimized search engine parses your friends without dropping your framerate. It features "Starts With" logic for classes, fully indexes "Rich Presence" data, and even searches through your friends' hidden Alt Characters!
• Offline Tracker System: Automatically groups friends who have been offline for 30, 60, or 90+ days for easy list cleaning.

👥 Group Management & Smart Invites

• Custom Groups: Create, rename, and delete custom groups using the #GroupName tag system in friend notes.
• Spam-Protected Mass Invites: Right-click any folder to "Invite Group to Party." The addon safely uses a 0.2-second micro-delay between invites to protect you from Blizzard's anti-spam disconnects.
• Accurate Contact Cap Tracker: A sleek new tracker monitors the hard 600 Battle.net cap and 100 WoW-friend cap. Hover over it for a detailed breakdown of your pending invites and unique contact math.
• Smart Copy Menu: Right-click any friend to easily copy a formatted Name-Realm string or their BattleTag to your clipboard.

🤖 Enhanced Automation Suite

• Auto Accept Group Invite: Integrated native automation to securely accept group invites.
• Spirit Behavior: Dedicated options for Auto Accept Resurrection and Auto Release Spirit, featuring smart checks to prevent overlapping conflicts.
• Party Sync: Native support to automatically accept Party Sync requests.

🛠 Modern Settings Hub

• Dedicated Cogwheel: Quick access to all configuration options, categorized by Filters (Hide Offline/AFK), Appearance (Class Colors, Faction Icons), and Behavior.
• Purge Cache: Easily wipe your Known Alts and Guild memory databases with a single click if you ever need a clean slate.

🌍 Supported Languages

FriendGroups features a localization system to ensure text displays correctly across all regions:

• English (US & British)
• French, German, Italian
• Spanish (EU & MX)
• Portuguese, Russian
• Chinese (Simplified & Traditional)
• Korean

Credits

• Maintainer: Rebuilt & Optimized for modern performance by Osiris the Kiwi (Discord: osirisnz).
• Original Concept: Based on the legendary work of mkp_tv, Hayato2846, and Thainii.