Fast Guild Invite (Revived) - Automated Guild Recruitment for WoW

Tired of manually typing /who, scrolling through results, checking each player's level and class, then whispering them one at a time? Fast Guild Invite automates every step of guild recruitment — scanning for candidates, filtering by your exact criteria, sending personalized whispers, and queuing invitations — so you can focus on the conversation while the addon handles the busywork.

The Problem

Guild recruitment in WoW is slow and repetitive by design. The built-in /who system returns at most 50 results, gives no way to filter by multiple criteria at once, and offers no way to track who you've already contacted. Officers end up spamming the same searches over and over, accidentally re-inviting players who already declined, and managing a mental list of who's been messaged this week.

On multi-officer guilds it's even worse — two officers can independently find and message the same player within minutes of each other, creating a poor first impression and potentially getting your whispers flagged as spam.

The Solution

Fast Guild Invite replaces the manual loop with an intelligent scan engine. It splits your search across multiple /who queries to work around WoW's 50-result cap, applies your filters locally, and works through the candidate queue automatically. An anti-spam sync system shares the invited-players list between all FGI users in your guild in real time, so two officers working at the same time will never double-contact the same person.

Core Features

Automated Player Scanning

• Smart /who query engine splits searches across multiple queries to bypass WoW's 50-result cap
• Results are collected, deduplicated, and filtered client-side before any action is taken
• Real-time progress bar and live statistics (found / filtered / invited / declined) during scanning
• Scrollable candidate queue — all found players shown in a 10-row list with per-row Invite and Decline buttons; act on any candidate, not just the front of the queue
• Background processing — scanning continues while you move, fight, or chat

Advanced Filtering System

• Level range — set minimum and maximum level to target specific brackets
• Race & Class filters — include or exclude any combination of races and classes
• Location-based search — filter by zone or sub-area for targeted recruitment drives
• Multiple filter profiles — save and switch between different recruiting configurations
• Custom WHO queries — write your own advanced query string when you need full control
• RaiderIO score filtering (when the RaiderIO addon is installed)

Invitation Modes

• Invite Only — send guild invitations silently with no message
• Message + Invite — send a recruitment whisper, then invite when they respond
• Message Only — broadcast a recruitment message without sending an invite
• Conditional — only whisper when an invitation is declined

Message Customization

• Multiple message templates — create and store as many recruitment messages as you need
• Dynamic %player% placeholder auto-fills the target's name
• Message preview before sending
• Multi-line support — long messages are split across multiple whispers automatically
• ChatThrottleLib integration prevents messages from being rate-limited or dropped

Player Management

• Blacklist — permanently exclude specific players; persists across sessions
• Anti-Spam List — tracks every player you've whispered; configurable memory window (1 day → permanent)
• Anti-Spam List UI — browse and manage your invited-players list; right-click to remove entries; "Clear All" with confirmation
• Quiet List — invite these players silently without sending any message
• Custom List — priority candidates; processed before the general scan queue
• Auto-blacklist leavers — players who leave your guild are automatically added to the blacklist
• Auto-kick on blacklist — optionally kick a player from the guild the moment they're blacklisted

Guild Sync (Anti-Duplicate System)

• Automatically shares the invited-players list and blacklist between all FGI users in your guild
• Uses a lightweight hash comparison on login — data is only transferred when a mismatch is detected
• No visible chat spam — all communication uses WoW's hidden addon message channel
• Manual Start Sync button in settings to trigger a sync on demand without relogging
• Configurable via the "Remember All" setting — opt out if you prefer per-character lists

Guild Integration

• Auto guild notes — automatically writes the join date/time to a new member's public note
• Officer notes — optionally write the recruiter's name or other info to the officer note
• Officer chat notifications — posts a message to officer chat when a player is blacklisted
• Works with Classic Era, TBC, Wrath, Cata, and Retail guild APIs automatically

User Interface

• Tabbed main window: Scan, Filters, Messages, Guild, Blacklist, Keybindings, Settings
• Minimap button — left-click to invite the next queued player, shift-left-click to pause scanning, right-click to toggle the main window
• All frames are draggable — position the main window and scan overlay wherever you want
• Context menu integration — right-click any player name in chat for a quick FGI invite / blacklist option
• Debug mode — verbose logging to chat for troubleshooting
• ESC closes windows — pressing Esc closes the main window and scan frame; a "Keep open on Esc" toggle in Settings disables this if you prefer the old behaviour
• Invite testing mode — simulate the full invite flow without sending invitations or whispers; useful for testing message templates without contacting real players
• Configurable scan interval — set the delay between WHO queries (2–30 seconds) directly in Settings to tune scan speed for your server
• Filter overwrite confirmation — saving a filter with a duplicate name shows a yes/no prompt instead of silently blocking

Keybindings

• Quick Invite — hotkey to invite the next player in queue
• Next Search — hotkey to resume or start the next scan cycle
• Fully customizable via the in-game WoW keybind interface

Multi-Language Support

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

How It Works

Scan Engine

1. Start Scan — FGI builds a set of /who queries from your active filters and submits them in sequence
2. Collect results — each response is merged into the candidate pool; players already in your anti-spam list or blacklist are discarded
3. Work the queue — FGI moves through the remaining candidates one at a time: send whisper (if enabled), send guild invite, record the player in the anti-spam list
4. Handle responses — declined invites are noted; FGI moves on to the next candidate automatically

Sync System

1. On login — FGI broadcasts a hash of your local leave, invited, and blacklist data to the guild
2. Mismatch detected — if another FGI user's hash differs from yours, a full data exchange is initiated via whisper
3. Merge — new entries from the peer are merged into your local database; your entries are sent back
4. Manual trigger — the Start Sync button in Settings → Main repeats this process on demand

Slash Commands

• /fgi or /fgi help — show all available commands
• /fgi show — open the main window
• /fgi invite — invite the next player in the queue
• /fgi nextSearch — resume scanning
• /fgi blacklist <name>-<reason> — add a player to the blacklist
• /fgi unblacklist <name> — remove a player from the blacklist
• /fgibl <name>-<reason> — quick blacklist shorthand
• /fgi debug — toggle debug output

Requirements

• Ace3 (AceAddon-3.0, AceGUI-3.0, AceDB-3.0, AceComm-3.0, AceTimer-3.0, AceConsole-3.0, AceLocale-3.0, AceConfig-3.0)
• Guild membership with invitation permissions
• WoW version: Classic Era (11508) · TBC Classic (20505) · Wrath Classic (30403) · Cataclysm Classic (40400) · Retail (11.0.7+)

Recent Updates

v1.9.1 (2026-04-19)

• Minimap button — simpler clicks. Left-click opens and closes the main window. Right-click opens and closes the settings window. The old Shift+Left-click pause shortcut has been removed — the main window already has a big Pause/Play button. No more accidentally firing invites when you mean to open the UI.
• Main window size is remembered between sessions. The window already remembered where you put it; now it remembers how big you made it too. Resize it once, reload, and it comes back exactly as you left it.

v1.9.0 (2026-04-19)

• Full candidate list in the main window. Instead of seeing one player at a time, you now see every candidate the scan has found in a scrollable list with Name / Level / Class columns. Mouse-wheel to scroll, right-click for quick Invite / Blacklist actions, hover for RaiderIO tooltips, names are coloured by class.
• Act on any row, not just the first. Each row has its own Invite / Skip / Decline icons, so you can pick out the one person you actually want to invite without declining everyone above them.
• New Skip button. Skip removes a player from the current queue without adding them to any blacklist — useful when you just want to pass on someone for now without any lasting effect.
• Everything the scan popup used to show is now in the main window. Progress bar, Start/Pause, countdown timer, and the Found / Sent / Accepted / Filtered stats row are all in one place. The old floating scan popup has been retired.
• New 3D-style level spinner. The Level Filter min/max numbers are now clearly interactive: outlined font with up/down arrow buttons above and below each value, plus the existing mouse-wheel support (hold Shift to change by 5).
• Cleaner layout and clearer labels. "Level Range" is now "Level Filter" so it's obvious it actually filters who shows up. The filter controls across the top row now sit on the same line instead of being staggered.
• Helpful tooltips on every button. Hover any button (Invite, Pause, Decline, Settings, Statistics, and the per-row icons) to see a short description of what it does and any side effects — for example, Decline respects your "Remember skipped" setting while Skip doesn't.
• Resizable, with sensible minimums. Drag the window wider and the progress bar, stats, and button row stretch with it. The window can no longer be shrunk below a usable size, so the list and controls always stay visible.
• Retail: fixed flood of taint errors. Retail 11.x was spamming "secret string" errors every time the game posted any system message (loot rolls, zone changes, achievements). Fixed — your chat frame is quiet again.
• Fixed the main window failing to load. A scroll-bar compatibility issue caused the player list and some buttons to be missing at login. The list now loads correctly on every version.

v1.8.0 (2026-04-19)

• Whisper welcome for new guild members. A new Guild-settings control lets you send a private whisper to anyone who joins your guild 2.5 seconds after they arrive. Use the NAME token to personalise it. Independent of the existing guild-chat welcome — turn either on or off on its own.
• Session + all-time stats in the Statistics window. Two summary rows below the graph: your totals since tracking began (searches, found, sent, accepted, rejected) and your live stats for this session. Declines and auto-declines are now tracked as well.
• Fixed a sync crash and broadcast storm on large guilds. On busy guilds (or whenever someone was in combat at login), the addon could either crash inside the sync routine or trigger endless back-to-back sync sessions between guildmates. Both paths are fixed — sync now goes through the same safety checks regardless of how it was started.

v1.7.11 (2026-04-18)

• Fixed endless "Sync failed: disconnected" loop in TBC. If two or more of your sync tables were out of date, the sync process would stall in the middle, time out, print "Sync failed", and immediately retry — forever. The sync now advances to the next table correctly, so a full sync completes instead of looping.
• Fixed sync data corruption from duplicate handshakes. A delayed or out-of-order sync handshake could restart a mid-transfer handoff and corrupt the receiver's data, also producing the "Sync failed" error. Delayed messages are now ignored once the transfer is already underway.
• New tooltips on every Settings > Main option. Hovering any checkbox or dropdown now shows a description of what it does — including minimap button click behaviour, chat context menu, queue/search alerts, the update changelog popup, and anti-spam list expiry.

v1.7.10 (2026-04-18)

• Fixed "Sync failed: disconnected" spam when two guildmates sync at once. On TBC, if two people running the addon tried to sync with each other at the same moment, the handshake would cross mid-air, both sides would send duplicate data, the receive buffer would get garbled, and both would print "Sync failed" and immediately retry — looping forever. The handshake now ignores messages that arrive out of order, so simultaneous syncs complete cleanly.

Older patch notes are kept in CHANGELOG.md.

Credits

Knoot0279 — original author of Fast Guild Invite; designed and built the core scan engine, filter system, sync architecture, and guild integration that the addon is built on.

Pimptasty — revival, ongoing maintenance, Retail compatibility layer, blacklist system overhaul, Anti-Spam List UI, multi-version TOC, and new feature development.

Community

Bug reports, feature requests, and pull requests are welcome! Open an issue or PR on GitHub.