GroupFinder Addon for World of Warcraft

GroupFinder is a powerful and customizable addon designed to help World of Warcraft players quickly find groups for dungeons, raids, and PvP battlegrounds. Whether you're looking for a group (LFG), looking for more members (LFM), or both (LF), GroupFinder automates the process of monitoring chat channels and alerting you to relevant group opportunities.

Key Features

• Smart Chat Monitoring: Automatically scans chat channels (World, General, Trade, LookingForGroup, Guild, Say, Yell, Whisper, and custom channels) for group-forming messages that match your preferences.
• Customizable Filters: Filter messages by role (Tank, Healer, DPS), class, instance type (dungeons, raids, PvP), and custom keywords to ensure you only see relevant group invites.
• Support for Dungeons, Raids, and PvP: Select specific dungeons (e.g., Ragefire Chasm, Blackrock Depths), raids (e.g., Molten Core, Naxxramas), or battlegrounds (e.g., Warsong Gulch, Arathi Basin) to monitor.
• Role-Based Filtering: Specify your role (Tank, Healer, DPS) and DPS type (Melee or Caster) to match groups looking for your specific capabilities.
• Automatic Whisper Responses: Send pre-configured whisper messages to group leaders when a match is found, or opt to only display alerts without responding.
• Centered Alerts: Receive on-screen notifications with a clean, stacked display for group opportunities, with customizable duration.
• Interactive Message Frame: View matched messages in a movable, scrollable frame with clickable player names to whisper, send auto-messages, or invite players (if you're the group leader).
• Blacklist and Exclusion Lists: Avoid unwanted players or filter out messages containing specific words to reduce spam.
• WeakAura Integration: Seamlessly syncs with a companion WeakAura for additional configuration and visual feedback.
• Custom Search Terms: Add custom keywords (comma-separated) to further refine group searches.
• Flexible Configuration: Adjust settings like whisper cooldown, display duration, and window size through an intuitive configuration panel.

How It Works

1. Configure Your Preferences: Use the in-game configuration panel (/gf config) or the companion WeakAura to select your preferred roles, instances, channels, and response settings.
2. Monitor Chat: GroupFinder scans specified chat channels for LFG, LFM, or LF messages that match your filters (e.g., "LFM DPS MC" if you've selected Molten Core and DPS).
3. Receive Alerts: Get on-screen alerts and/or entries in the message frame when a match is found. Click player names to whisper or invite.
4. Automate Responses: Optionally send automatic whispers to group leaders with a custom message (e.g., "DPS available for MC!").
5. Stay Organized: Blacklist players, exclude unwanted keywords, and customize the UI to keep your group-finding experience streamlined.

Installation

1. Download and extract the addon to your World of Warcraft/_retail_/Interface/AddOns/ folder.
2. (Optional) Install the companion WeakAura for enhanced configuration and visual integration.
3. In-game, use /gf config to open the configuration panel and set up your preferences.
4. Enable the addon and start finding groups!

Commands

• /gf config: Open the configuration panel.
• /gf testalert: Test the centered alert display.
• /gf ?: Show help and additional commands.

Compatibility

• Compatible with World of Warcraft Classic and Retail (tested on Classic Era and Season of Discovery).
• Fully integrates with a companion WeakAura for synchronized settings.
• Supports all class roles and major dungeons, raids, and PvP battlegrounds.

Notes

• Ensure you have the necessary permissions to invite players if using the auto-invite feature (must be group leader).
• The addon respects AFK/DND status and will not send whispers or process messages while you're unavailable.
• For detailed configuration, check the in-game panel or the WeakAura settings.

Feedback and Support

Have suggestions or issues? Visit the addon's GitHub page or contact the developer through the CurseForge/Wago.io comments section. Your feedback helps improve GroupFinder!

Happy grouping, and enjoy your adventures in Azeroth!