Fast Guild Invite - Revived

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 with dedicated tabs for Scan, Custom Scan, Filters, Blacklist, Anti-Spam, History, Statistics, Quiet Zones, and Announce
• Compact tray — slim floating window with just the scan / invite buttons, queue counters, and per-row action icons; toggle between the full window and the compact tray from either view
• Minimap button — left-click opens the main window (or compact tray, depending on your last used view), right-click opens the addon settings panel
• All settings live in WoW's standard in-game Options panel (ESC → Options → AddOns → FastGuildInvite)
• 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 compact tray; 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

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 (or compact tray, depending on your last used view)
• /fgi intro — re-open the "What's new" release-notes popup
• /fgi invite — invite the next player in the queue
• /fgi nextSearch — fire the next /who in the queue
• /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 dump — open the diagnostic dump window
• /fgi resetWindowsPos — reset all addon window positions
• /fgi debug — toggle verbose debug logging to chat

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.5.3 (2026-05-30)

• Bottom-row icons are now fully clickable. The icons along the bottom edge of the main window — the announce horn, copy-names page, compact-mode button, settings gear, and the help “i” — only responded to clicks and mouseover in a small spot at their center; the rest of each icon looked clickable but did nothing. The cause was the window's invisible resize strip sitting on top of the icons and stealing the clicks. v2.5.3 lifts every bottom-row icon above that strip so the whole icon is live for both clicking and hover tooltips.
• Guild Roster percentages no longer clipped on narrow screens. The percent-of-guild column added in v2.5.1 could render under the scrollbar space on smaller resolutions, cutting off the “%” digits. The count and percentage columns now anchor to the right edge of each section so they stay fully visible at any window width.

v2.5.2 (2026-05-30)

• New: Backfill races (online guildies) button. v2.5.1 added race to the chat-name hover tooltip but only for guildies you /who'd via FGI after the upgrade. v2.5.2 adds a one-click backfill button in Settings → Guild → Member-history tooltips that sends a single /who g-<your guild> and fills in race for every online guildmate's anti-spam + join-record entries from the response. Idempotent — running it twice does nothing the second time. Limits: covers only currently-online guildies (offline players can't be queried via /who); capped at /who's 50-result cap, so guilds with 50+ online may need a second pass when fewer are online; cross-realm anti-spam entries on retail aren't reachable via /who and will stay unfilled. Refuses to run while a recruitment scan is in progress so it doesn't trample the scan engine. After running, hover names in chat and the tooltip should now show race for everyone the backfill covered.

v2.5.1 (2026-05-30)

• Guild Roster sections now show a percent-of-guild column. Each row in By Class, By Level, and By Rank on the Guild Roster tab gains a greyed-out percentage to the right of its count (e.g. Hunter   60   10% when 60 of your 582 guildmates are Hunters). The denominator is the guild-wide total, not the section sum, so a "5%" in By Class reads exactly like a "5%" in By Rank — cross-section glance comparisons work without recalculating. Floor rounding (a 1-member rank in a 582-member guild renders as 0% rather than <1%) keeps the column width predictable.
• New: race shown on chat-name hover tooltip. Player request: when you hover a name in chat (e.g. [Bob] in /g), the FGI tooltip now reads Level 60 Tauren Druid — Officer instead of just Level 60 Druid — Officer. Race is sourced from FGI's own scan / invite history: any candidate FGI /who'd before inviting carries their race forward into the anti-spam list, and forward again into the member-history table at guild-join time. Coverage: any guildie joined via FGI invite after v2.5.1, plus any non-guildie still in your recent anti-spam list, gets a race on hover. Guildies who joined pre-v2.5.1 (or were hand-invited and never appeared in an FGI /who) won't show a race until the next time FGI scans them. Gated by the existing Settings → Guild → Member-history tooltips → Show FGI tooltip on chat-name hover toggle — off-by-default since v2.5.0.
• Sync-failure message no longer guesses at the cause. Field-reported: a user saw Sync failed: PartnerName timed out — Orgrimmar (may be in a raid, instance, or combat) while standing in a city, not in a raid / instance / combat. The “may be in a raid, instance, or combat” suffix was the fallback wording whenever the sync partner was online but didn't reply, even when FGI had no evidence about why. v2.5.1 drops the speculation: the message now reads Sync failed: PartnerName timed out — they were online in Orgrimmar but didn't reply. Sync will reattempt automatically the next time any peer triggers a sync. — states only what FGI actually knows (the partner's zone) and what happens next (sync re-attempts opportunistically when any other FGI-using guildmate broadcasts their hash, e.g. on login / manual Sync / end-of-successful-sync). No need to click anything. No behaviour change — only the message text.

v2.5.0 (2026-05-29)

• Retail: chat-crash fix during dungeons + raids. Field-reported: an FGI-tagged Lua error fired ~90 times per fight when a monster yelled or shouted (M+, raids, world bosses). Cause: when FGI processed incoming whisper / AFK / DND events, it sometimes touched a Blizzard "secret string" value without first asking permission to read it; that quietly marked the addon's execution as tainted, and every later message that needed to read a protected-string sender (monster yells / says) failed inside Blizzard's chat-history code. v2.5.0 follows the canonical Blizzard pattern documented in their own chat-frame source: gate the read through canaccessvalue first, and bail cleanly when the value can't be safely accessed. No more cascade crashes during dungeon / raid content.
• New: Messages tab in the main window. Previously the recruitment whisper templates lived in Settings → Messages as a single dropdown plus an editor, which made it hard to see and manage multiple variants. v2.5.0 moves the editor to a proper Messages tab on the main window, alongside Filters / Blacklist / Anti-Spam etc. Each template gets its own row with an On checkbox, a Name, and a Body preview; the random-pick pool for outgoing whispers now draws only from checked entries. Click a row to edit it in the top-strip form, click Save to update in place, click Add new to start a fresh entry. Settings keeps the “Share templates across all characters” toggle (an account-wide preference); the per-template editing all happens in the new tab. Existing per-template strings auto-upgrade on first /reload after the patch — nothing to migrate manually.
• New: tie a Message template to a specific Filter. Want recruits matched by your “Hunters 30-40” filter to receive a Hunter-themed whisper, and recruits matched by your “Healers” filter to receive a Healer-themed one? A new Message dropdown on each Filters tab row lets you pick the template that should send when this filter accepts a candidate. Default is “(none — use random pool)” (existing behaviour). When a candidate matches multiple bound filters, the alphabetically-first filter's template wins (predictable, no fragile priority field to manage). If you delete a template that a filter was bound to, the dropdown shows the binding as “(deleted)” in red so you can re-bind it instead of silently falling back.
• Scan tab gets bulk actions for selected players. The strip on the scan tab grew a second row with Sel All, +(N)sel (existing — moved down for grouping), Skip (N), Decline (N), Blacklist (N). Check players you want to act on, then click the matching batch button to do it in one click. Skip and Decline are pure record-keeping (no protected calls, can fire all in one click); Blacklist pops a single confirmation (“Blacklist N selected players?”) before iterating. +(N)sel still invites one-per-click because WoW's /who-to-invite path is hardware-event-gated and can't be batched; the rest are unbounded. Selecting / clicking actions no longer snaps the row list back to the top — the view stays where you were.
• New: only welcome players I invited via FGI. Two new toggles under Settings → Guild → Welcome on join: one gates the guild-chat welcome message, one gates the private welcome whisper. When on, the corresponding welcome only fires for new members FGI sent an invite to recently (they're in your Anti-Spam list). Hand-invites by you, and recruits brought in by other officers, won't get the welcome posted / whispered. Useful if your guild has multiple recruiters and your auto-welcome line is FGI-flavoured. Defaults off (preserves the welcome-everyone-on-join behaviour from before).
• New: copy any list to the clipboard. A new note-page icon on the main window's status row (next to the announce horn) opens a popup with every name from the currently-viewed tab pre-selected. Press Ctrl+C to copy, Esc to close — export your Anti-Spam list, your Blacklist, the scan queue, or History to a spreadsheet / Discord post / external tool in two keystrokes. The popup respects sort order: Anti-Spam and Blacklist export alphabetically, History dedupes and exports in chronological order, the scan queue exports in queue order. Tooltip on the icon shows what would be exported live before you click.
• New: let other addons render above (or below) FGI. Field request: “my WIM whisper windows appear under FGI's UI”. New Window layer slider in Settings → General → Appearance dials FGI's render-stack position from 0 to 100 — 50 is the default and matches the pre-v2.5.0 behaviour (FGI above WIM / Details / most addons). Drag the slider below 50 to let WIM whisper windows, Blizzard popups, and other addon UI render above FGI. Drag above 50 to push FGI even further to the top of the stack (above other top-strata addons at their default level). Changes apply live; no /reload required. The default value is called out in the slider's name so you know where to snap back to.
• Bug fix: multiple active filters no longer hide valid recruits. Field-reported: turning on two filters (e.g. “Hunters 30-40” and “Druids 30-40”) returned an empty scan queue even though there were plenty of Hunters and Druids on the server. Cause: FGI was combining active filters with AND semantics — a candidate had to pass every active filter, so no class could satisfy both a Hunters filter and a Druids filter at the same time. The original design intent was “compose by dimension” (one filter for class, another for level, intersection), but nobody used Filters that way. v2.5.0 flips active filters to OR: a candidate makes the queue if at least one active filter accepts them. Self-contained “I want this kind of recruit” filters now stack up naturally — turn on five filters, see candidates that match any of them. If you actually want the AND-style intersection, put every criterion (class + level + race + etc.) in a single filter. Deny-list (legacy v1) filters still reject on any match because the “exclude” semantic doesn't fit OR.
• Classic-family clients can scan faster: minimum scan interval drops to 2 seconds. Field-validated against GuildRecruiter running 2 s on Anniversary realms without throttle. v2.5.0 brings back per-version scan-interval minimums (something v2.2.4 tried and crashed the settings panel doing): Retail stays at 8 seconds because its /who server-side rate-limiting is stricter (below 8 s triggers stuck scans, cached identical responses, and the chunk-2 echo cascade that v2.2.4 first reported); Classic Era / TBC / Wrath / Cata / MoP / Anniversary drop to a 2-second minimum because their /who rate-limiting is looser. Default stays at 8 seconds globally — fresh installs on every client land at the safe value — so Classic users have to drag the slider down explicitly. Open Settings → General → Scanning → Scan interval and pull the slider lower to bump your recruitment cadence on Classic.
• Guild Roster polish: scrollbars hide when not needed + max-level count in the header. Two field requests bundled into one polish pass. (1) The three side-by-side sections (By Class / By Level / By Rank) used to always show their scrollbars in the right gutter even when the content fit in view, wasting horizontal space on narrow tab layouts. v2.5.0 auto-hides each section's scrollbar when its content fits, then brings it back when content grows (e.g. a guild import or the “Online only” toggle changes shape). (2) The header summary now reads Total: N   Online: N   Offline: N   Total <maxLevel>s: N — the last segment shows how many guild members are at the current expansion's level cap (e.g. “Total 80s: 47” on TWW retail, “Total 60s: 12” on Classic Era). Distinct from the By Level section's 5-level bucket because cap members specifically are what most recruiters track. Auto-adapts on future level-cap bumps.
• Guild Roster: fixed double-counted rank when two ranks have the same name. Reporter on a guild with two distinct ranks both named “Guild Master” (one real GM, one custom rank at a different index) saw the Guild Roster tab show Guild Master 61 twice instead of 1 and 60 separately. Underlying bug: the breakdown bucketed by rank name, so the two ranks shared a single inflated count rendered once per index. v2.5.0 buckets by rank index, so duplicate-named ranks now show their separate counts correctly.
• Guild policy “Never expire” minimum. The Guild Master / officer-only Minimum anti-spam retention dropdown gains a Never expire option at the end of the list. When set, every guild member's anti-spam retention is locked to permanent — FGI-confirmed recruits never get re-attempted on future scans. The per-member Anti-spam expiry dropdown in Settings → Main shows “Locked to Never expire by guild policy” when this is in effect.
• Classic Hardcore: fixed Guild Policy editable by everyone. Reporter on Classic Hardcore (Anniversary realm) noticed the Settings → Guild → Guild Policy controls weren't locking for regular guild members — anyone could push policy. Cause: FGI was using a WoW API (CanGuildPromote) that's unreliable on Classic Era / Anniversary — it returns true for non-officer guild members when the guild has the promote permission toggled on for lower ranks. v2.5.0 replaces that check with a direct rank-index check: GM (rank 0) or rank 1 (the conventional officer tier) can edit policy; everyone else is locked. Trade-off: guilds where the actual officer rank is index 2 or 3 will need their officers promoted to rank 1 to push policy — the alternative is “everyone edits policy” which is worse.
• Scan tab no longer snaps to the top when you check a row. Field-reported: checking a checkbox on row 30 of the scan queue bounced the view back to row 1, making batch selection effectively impossible on large queues. The same was happening on per-row Invite / Skip / Decline / Blacklist clicks. Fixed: in-place mutations preserve the scroll position; new scans and filter changes still scroll to the top as before.
• Chat-name hover tooltip default flipped to OFF. Per user preference: the standalone FGI tooltip that appeared when you hovered a player name in chat (e.g. [Bob] in /g) is now opt-in instead of opt-out. Re-enable it in Settings → Guild → Member-history tooltips → Show FGI tooltip on chat-name hover.
• Anti-Spam tab tooltip: arrow replaced with ASCII >. The breadcrumb in the Name column header tooltip used a Unicode arrow that didn't render on every client. Now reads as Settings > Main > 'Clear DB after' everywhere.

v2.4.0 (2026-05-29)

• Retail: empty popup tabs and AFK auto-response leaks from FGI invites — gone for good. v2.3.2 closed most of the popup-tab leak but a small number of conditions still slipped through: long whispers under heavy chat load could leak the final chunk, and AFK / DND auto-responses from recruits would still create dedicated popup tabs AND leak their "[Name] is Away" text into chat. v2.4.0 replaces the older “count chunks and clear when the conversation ends” design with a simpler one: once FGI has whispered a recruit, every outgoing chunk and every away-status auto-response from that person stays suppressed for the rest of the session. Cleared automatically when the recruit actually replies to you, on /reload, or via the new manual /fgi clearwhispers command (see below). No more empty tabs, no more "Player is Away:AFK" lines, no more half-leaked chunks.
• Retail fix: accept counter was inflated by 5x or more. Field-reported: S:33 A:188 — sent 33 whispers but the “Accepted” counter showed 188. Cause: the retail accept detector was firing during the roster-streaming phase right after login or any addon-triggered roster refresh, mis-identifying dozens of existing guild members as fresh joiners and counting each one as a new accept. v2.4.0 switches retail accept tracking to LibGuildRoster's purpose-built “first time we've seen this name” system, which has a proper guard against the login-streaming case. Your accept count now matches the number of people who actually joined the guild after being invited.
• New: extended invite outcomes — "not found", "AFK", "DND", "unresolved", "already in a guild", "guild rejection". Previously FGI tracked only Accept / Decline / Anti-spam / Blacklist. v2.4.0 adds six more outcomes that the addon now detects automatically and routes through the same anti-spam / history pipeline. The scan tray's counter strip gains new buckets so you can see at a glance how many recruits in this session were AFK / DND / never replied / are already guilded / hit a trial-account or faction-restriction rejection. The History and Statistics tabs distinguish all outcomes separately.
• New: Anti-Spam tab search box. The Anti-Spam list can grow to thousands of entries on a long-running recruitment account; finding a specific name to remove used to mean scrolling. New search box at the top of the Anti-Spam tab filters the list as you type (case-insensitive substring match).
• New: FGI Debug chat tab. Diagnostic output (scan-debug, popup-debug, whisper-debug, decline-debug etc) used to flood your General chat whenever Debug mode was on, making it hard to recruit while diagnosing a bug. New /fgi debugtab command creates a dedicated “FGI Debug” chat tab and routes all FGI debug output there instead of your main chat. Remove it with /fgi debugtabremove. Tabs don't persist across /reload — re-run the command after each reload (by design; keeps the tab opt-in).
• New: /fgi clearwhispers command. Manual escape valve for the rare case where you want to manually /w a recruit who already got an FGI whisper this session. Wipes the in-memory “FGI just whispered these names” list so your typed reply to them displays normally and opens a popup tab if you have popouts enabled.
• New: mute toggles for announce and scan debug output. Two new toggles in Settings: General → Notifications → “Mute announce messages” hides the addon's announce-feature confirmation prints; General → Scan → “Mute scan messages” hides the scan-result and scan-cooldown prints. Useful if you find the addon's chatter distracting during heavy recruiting sessions.

Older patch notes are in the addon's CHANGELOG.md file (ships with the addon).

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, questions, or chatting with other guild recruiters: Join the FGI Discord.