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
• Disable compact UI tooltips — toggle in General → Appearance to hide all hover tooltips on the compact tray buttons and icons; useful for distraction-free recruiting when you already know what each icon does
• 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 deb

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

v2.0.7 (2026-05-06)

• Compact UI tooltips can now be disabled. New toggle in General → Appearance settings suppresses all hover tooltips on the compact tray (resize grip, scan counters, title icons, row icons, invite-next button, scan button). The compact frame itself stays fully functional — this only hides the tooltip popups. Useful for distraction-free recruiting when you already know what each icon does.
• /fgi v2 now honors the "Open last-used view" setting. Previously /fgi v2 always opened the main window regardless of which view you used last. Now it routes through the same logic as /fgi show so the "Open last-used view" toggle applies consistently — when enabled and you last used the compact tray, /fgi v2 opens the compact tray instead.

v2.0.6 (2026-05-06)

• Declined invites now properly appear in History tab and anti-spam list. Previously only Type 3 invites (Message Only mode) would remember the player immediately — Types 1, 2, and 4 waited for server confirmation that never came on some clients. All four types now add the player to the anti-spam list the moment you click Invite, so every declined invite shows up in History and the next scan skips them.
• Retail decline detection restored. v1.9.9 disabled the CHAT_MSG_SYSTEM event on Retail to avoid taint errors from Blizzard's "secret strings," but decline messages only arrive via that event. Re-enabled with a pcall wrapper that safely catches taint errors without breaking addon execution — declines are now detected and logged on Retail again.
• Auto-reject detection now distinguishes between manual declines and addon-based auto-rejects. The addon now tracks when each invite was sent and checks how quickly the decline arrives. Declines that come back in under 1 second are classified as auto-rejects (player has an auto-decline addon installed); slower responses are manual declines. Each outcome has its own counter in the statistics panel and History tab.
• Scan interval setting now properly applies on Retail. The scan interval slider in settings was being ignored on Retail — the timer always counted down from 8 seconds regardless of your configured value. Fixed; your setting now controls the actual delay between WHO queries on every client version.

v2.0.5 (2026-05-06)

• Blacklisting a player now lets you type a reason. Clicking the blacklist icon on a row (compact tray, v2 main window, or right-click "FGI" in chat) opens a small dropdown right at your cursor with a text box for the reason and OK / Cancel buttons. Press Enter to commit, Escape to cancel. Leave the box empty to fall back to your default reason. With Fast blacklist on (General settings) the prompt is skipped entirely — same one-click silent path as before.
• Blacklist entries now show when each player was added. A new Added column on the Blacklist tab between Name and Reason — click the header to sort chronologically (oldest first) or click again to flip. Old entries from before this update show "—" because their original add-time is unknown; everything added from now on stamps automatically and propagates through guild sync to other FGI users.
• New "Open last-used view" toggle in General → Appearance settings (off by default). When on, the minimap left-click and /fgi show open whichever view (full main window or compact tray) you used last — so if you switch to the compact tray with the − button, the next time you open the addon it'll come up in compact mode without you having to flip the compact-mode preference. Off keeps the long-standing behaviour where compact-mode is the toggle that decides which view opens.
• Scan ">>" button no longer rarely freezes. A few users reported the scan-button cooldown timer occasionally getting stuck, refusing to count down or become clickable, on the compact tray and on the new v2 main window. Both now have a safety timer that re-enables the button if the underlying /who system never reports back — same defensive pattern the old v1 window has had since v1.9.9.
• Alphabetical sort now groups uppercase and lowercase together. Sorting any column on any v2 tab (Blacklist Reason, Custom Scan Name, Filters, etc.) used to scatter "Apple" / "apple" / "Banana" / "banana" all over the place because of how the game compares strings. Now they cluster the way you'd expect.
• Checkboxes in Custom Scan, Filters, and other list tabs no longer visually revert. Toggling the On column (or any checkbox column) on a row used to immediately snap back to its previous state until you tabbed away and back — the underlying data was being written correctly, but the cell repainted from stale data. Fixed; the checkbox now stays in the state you clicked.
• GRM and GIL import-finished chat lines respect the "Mute all sync chat output" setting. The "<FGI> GRM import: N added, ..." / "<FGI> GIL import: N added, ..." lines now go silent when you have mute-sync on. The on-screen banner notification still appears either way so you know the import finished.

v2.0.4 (2026-05-05)

• Settings panel: Guild, Advanced, and Messages sub-pages now have all their controls. Section headings show their description as a hover tooltip instead of a wall of text underneath, and the per-field labels in Guild (Welcome message, Welcome whisper, Public note, Officer note) work the same way — hover the label to read what the field does without burying the input.
• "Add FGI to player right-click menus" toggle moved to General → Invite behaviour. It was buried in Advanced → Debug before, where almost nobody found it.
• Right-click "FGI" in chat is now a hover-open submenu. Right-click a name in chat (or in friends list, raid frames, etc.) and hover the "FGI »" entry — the three actions (Guild Invite, Blacklist, Unblacklist) now nest inside the same menu instead of popping a separate dropdown that dismissed everything else. Each action still has its own hover tooltip explaining what it does. You can move the cursor away from the submenu and keep using the rest of the menu normally.
• Main window scan progress is back to a real graphical fill bar. The orange fill grows left-to-right inside the status panel at the bottom of the window, just like the old v1 window. Replaces the text bar that appeared to "grow in width" as scanning progressed (the filled and empty characters were rendering at different widths).
• Decline now always remembers the player. Clicking Decline on a player row adds them to the anti-spam list so the next scan skips them, regardless of any toggle. Skip stays a soft removal — the Decline-vs-Skip distinction is now spelled out clearly on the Advanced sub-page.
• Compact tray is resizable. Hover the bottom-right corner — a small dotted grip fades in. Drag to widen or narrow. Width persists across reloads. The minimum keeps the title-row icons from overlapping the counters in the middle. The help "i" tooltip on the tray lists Move and Resize so the affordance is discoverable.
• "Show update info on login" popup actually appears now. The toggle has been silently broken since the addon launched — two compounding bugs prevented the popup from ever rendering for any user. Both fixed.
• New Filter quiet zones checkbox on the Quiet Zones tab. Master switch for the scan engine's zone filter — when off, the addon ignores both the built-in instance filter (raids, dungeons, arenas, battlegrounds) AND your custom zones list, and scans players regardless of where they are. Was only reachable from the legacy popup before.
• Tooltips prefer ABOVE the frame they describe. Previously many tooltips appeared below the icon or button you hovered, covering the queue rows and other content underneath. The addon now anchors tooltips above by default, falling back to below only when the frame sits too close to the top of the screen for the tooltip to fit.
• ElvUI dropdown spacing fixed. A user on TBC Classic with ElvUI reported a visible gap between the radial slot and the label inside the addon's dropdowns. Fixed across every dropdown in the addon — Quiet Zones, Statistics, blacklist confirmation, the right-click chat follow-on, Custom Scan add-member, and others all collapse the unused slot now.
• Security sub-page in settings removed. Its two toggles never did anything — their values were never read by any sync code. One fewer stub to navigate past.

v2.0.3 (2026-05-05)

• Custom Scans can now be bundled into named groups. The Custom Scan tab gains an Add Group button. Each group holds an ordered list of scans; the same scan can live in multiple groups; each membership has its own On checkbox so you can enable a scan in one group and leave it disabled in another. Members can be reordered with up/down arrows. When you start a scan, groups run sequentially — group A finishes (every query plus any subdivisions) before group B starts — with standalone scans running last.
• FGI lives inside the in-game right-click menu now. Right-click a player name in chat (or in the friends list, raid frames, etc.) and you'll see an "FGI" entry alongside Whisper, Invite, and the rest. Clicking it opens a small dropdown with Guild Invite, Blacklist, and Unblacklist. Replaces the older parallel popup that used to overlap the native menu.
• Blacklist confirmation moved out of the centre of the screen. When you click the blacklist icon on a player row (and Fast blacklist is off), a small Yes / Cancel choice now opens right next to the icon you clicked instead of a popup window. Same one-click confirmation, no cursor travel. The blacklist icon on every player row in the main window and compact tray also respects the Fast blacklist setting now — previously it bypassed the toggle.
• On-screen Queue notification and Scan-ready alert popups now actually appear. Both notification toggles in General settings have been silently doing nothing since the addon launched. They now show an animated banner near the top of the screen for a few seconds — "Players found: N" when a scan adds people to the invite queue, "Search Unlocked" when the scan cooldown expires.
• Per-tier control over /who scan subdivision. When a /who hits the 50-result cap, the addon narrows the query and tries again in stages: Level » Race » Class » Zone. New General settings section lets you turn off any of those stages individually if you don't want that level of fan-out. Defaults match the previous behaviour (all on); turning one off means capped queries at that stage accept the truncated 50 and the chain stops there.
• Settings General sub-page filled out. ESC > Options > AddOns > FastGuildInvite now has real settings on the General sub-page: scan interval, level-range priority, window opacity, minimap icon, keep open on Esc, auto-kick blacklist, Fast blacklist, queue / scan-ready notifications, and the new /who subdivision toggles. The Credits sub-page has a copyable Discord invite link. The legacy popup window is still reachable via right-click on the minimap button if you prefer it.

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.