FriendGroups

FriendGroups is a powerful contact manager and list enhancer, optimized for advanced social organization in modern World of Warcraft. It lets you sort friends into custom groups and arrange them exactly how you like, while introducing a robust Alt-Character tracker, dynamic Guild integration, deep search, full settings backups, 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, personalized, 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: Manual Group Ordering

Arrange Your List Your Way: Right-click any group header to "Move Up" or "Move Down," breaking free from forced alphabetical sorting. Put your most important groups, raid teams, close friends and your main guild exactly where you want them.
Easy Resets: "Reset Position" returns a single group to its default spot, while a "Reset Group Order" button restores the full alphabetical order in one click.
Remembered & Portable: Your custom order is saved per account and is included in the new Settings Backup.

💾 NEW: Settings Backup (Export & Import)

One-Code Full Backup: A new "Settings Backup" menu exports your entire configuration. Every appearance and behavior setting, list size, group order, banner colors, nicknames, selected mains, and your complete known-alts database into a single copy/paste code.
Restore or Transfer: Paste a code into the Import window to instantly restore everything. It's the perfect safety net before a reinstall or new PC, and an easy way to copy your exact setup across your own accounts.
Date Stamped: Every backup records when it was created. The Advanced menu shows your "Last backup" date at a glance, and importing confirms the backup's age.
Slash Commands: /fg export and /fg import open the backup windows directly.

🕵️‍♂️ Known Alts, Mains & the "AKA" Engine

The Spyglass Engine: A comprehensive background tracker securely logs and maps your Battle.net friends' WoW characters. Hovering a friend on the Friends List, Guild Roster, or Communities frame displays a clean side-panel of up to 10 of their recent known alts.
Detailed Tracking: See each 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 on alternate characters dynamically display their Main's name on their contact button (e.g. [AltName] aka [MainName]) so you always know who you're talking to.
Pin a Main: Right-click a friend to "Select Main" from their known alts (class-colored and sorted). The chosen main is pinned to the top of their alt panel and drives the "aka" tag.
Custom Nicknames: Give any friend a personal display name in bright green (#00ff00) that replaces their BattleTag or account name. Clear it instantly by saving an empty box.

🛡️ Dynamic Guild Folders

Automated Guildmate Sorting: The addon silently checks your active guild roster and gathers any Battle.net or WoW friends in that guild into a dedicated [Guild] <GuildName> folder with zero setup.
Add or Remove Manually: Right-click any friend and choose "Add to Guild Group" to place them into any guild folder, including auto-guild folders or "Remove from Guild Group" to take them out. (Friends sorted automatically by the live roster stay automatic.)
Mains Define the Guild: Selecting a friend's Main now determines their guild folder based on that main's guild even a guild your own character isn't in and keeps it consistent across your accounts.
Custom Guild Folders (the < > Tag System): Typing <GuildName> into a friend's note generates a formatted guild folder. Perfect for ex-guildies, cross-realm teams, or custom communities.
Seamless Multi-Guild Support: The addon remembers which alts belong to which guilds, quietly building a master database of all your active guilds as you play.

🎨 Personalized Group Banners

Custom Header Colors: Right-click any group header including Favorites, Auto-Guild, and manual #note groups to apply a custom background banner color.
Live Preview: Dragging around the hex color picker updates the banner in real time with zero UI lag, and remembers your last-chosen color. A "Clear Banner Color" button removes it instantly.

🔍 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 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.
Streamlined Menus: The group header menu is organized into clear sections, with the destructive "Remove Group" isolated at the bottom and colored red. Ungrouped friends drop the redundant options for a cleaner right-click.
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 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

Streamlined Cogwheel Menu: A redesigned, compact settings menu keeps the frequently-used Filter and Appearance toggles on the first layer for instant, live tweaking, while tucking Contact List Size, Group Behavior, and an Advanced section (Automation, Spirit, Alt Characters, Settings Backup, System & Reset) into tidy sub-menus.
At-a-Glance Info: The Advanced sub-menu displays your installed version number and your last backup date.
Alt Tracking Control: "Enable Alt Character Tracking" cleanly toggles the entire tracking system, with a hover tooltip explaining exactly what it does and that disabling it clears stored alt data.
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 full 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.

FriendGroups - Custom folders, known alt tracking, auto guild groups, smart search, mass invites, and rich realm/class info