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

Wingman — Hands-Free Recruiting

• Toggle Wingman (the people-icon button on the main window's bottom row and the compact tray, or /fgi wingman), then just play — each of your normal mouse clicks fires one queued recruiting step: a /who scan when one is due, otherwise an invite to the next player matching your filters
• Uses the filters, invite Mode, and scan interval you've already set; throttled to one action per click; stops the moment you stop clicking (so it idles while you're AFK)
• Not automation — one click is always one action, never a burst — it just frees you from hammering the scan and invite buttons by hand while you quest, farm, or run dungeons
• While active it greys out the manual scan/invite controls and locks your Filters and Custom Scan for the session, so the targeting is frozen until you toggle it off — the live queue, counters, and scan countdown keep updating so you can watch it work

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 (The War Within 11.2.7 / Midnight pre-patch)

Recent Updates

v2.6.2 (2026-06-10)

• Retail: the “Accepted” count is reliable again. On retail, players who accepted your guild invite weren't always credited to your stats — the counter could sit at 0 or under-count. FGI now counts an accept whether the game reports it through the join message or the guild roster, never double-counts, and remembers who you invited even across a /reload so a later accept still counts. Classic, TBC, Wrath, and Cataclysm were already accurate.
• New: show or hide FGI's button in the addon compartment. Retail's top-bar addon menu (the icon next to the minimap) now has an “Addon compartment button” switch in Settings → General, so you can add or remove FGI's entry there — just like the minimap icon toggle.
• New: pick the language FGI uses for its own text. Settings → General → “UI Language Override” lets you set FGI's interface language separately from your WoW client, including Dutch and Filipino, which WoW doesn't support on its own. Game terms like race and class names still come from the game in your client's language. (More of the newer panels become translatable in a later update.)

v2.6.1 (2026-06-09)

• Retail: FGI no longer triggers the Lua-error floods on the world map, Crafting Orders, and item-link tooltips. FGI could set these off two ways — its old single-page “legacy” window quietly building itself on every login (which tripped Blizzard's old dropdown menus), and reading the game's system messages during instanced content (Mythic+, raid encounters, PvP) while those messages are temporarily protected. Both are now fixed. Note: these are shared-game errors that any add-on can set off the same way, so if you still see them after updating FGI, the cause is a different add-on — not FGI.
• Wingman now keeps recruiting in combat. Before, Wingman's scanning and invites could stop or throw errors while you were fighting — exactly when you're clearing a dungeon and want to invite the group. That's fixed: scanning, inviting, and whispering all keep working mid-fight.
• Wingman's “on” message now tells you what it will recruit. When you switch it on, it lists your active filters, any selected custom scans, and the level range it will sweep — so you can see what the session is locked in to before you start clicking.
• LibGuildRoster is now a separate add-on. FGI uses the standalone LibGuildRoster add-on for guild-join tracking instead of bundling its own copy. CurseForge installs it automatically; if you install FGI manually, grab LibGuildRoster too or join tracking won't run.
• Fixed anti-spam whispering the same person multiple times. In Whisper-Only mode, a player who was AFK/away, or on a connected/cross-realm (Name-Server), could get whispered again on later scans even though they were already on your anti-spam list — the entry was being cleared whenever they auto-replied AFK or the game reported a (false) “player not found.” Now, once FGI whispers someone, they stay on the anti-spam list for your full expiry window no matter what.

v2.6.0 (2026-06-05)

• New: Wingman — hands-free recruiting while you play. Flip Wingman on (the new people-icon toggle on the main window's bottom row and on the compact tray, or /fgi wingman) and then just play normally. Each of your ordinary mouse clicks sends out one queued recruiting step — a /who scan when one is due, otherwise a guild invite to the next player who matches your filters. It rides the scan interval, invite Mode, and filters you've already set up; it's throttled to one action per click; and it stops the instant you stop clicking, so it idles whenever you step away from the keyboard. It is not automation — one click is always one action, never a burst — it just spares you from hammering the scan and invite buttons by hand while you're out questing, farming, or running dungeons.
• While Wingman is on, the manual controls lock so nothing fights it. The normal scan/invite buttons grey out (with a tooltip explaining why), and your Filters and Custom Scan tabs show a “locked” cover for the duration of the session — so the session's targeting is frozen to whatever you had selected when you switched it on. Toggle Wingman off to change who it invites, then toggle it back on. Your scan counters, the live queue, and the scan countdown keep updating throughout, so you can watch it work — especially handy on the compact tray.
• New: a master “Disable all sync” switch. If you'd rather keep your blacklist, leavers, and invited-players lists entirely on your own character, tick Disable all sync in Settings → Advanced → Sync. FGI then stops both sending your data to the guild and receiving anyone else's. Off by default, so existing sharing is unchanged unless you opt out.
• Clearer sync settings, and a fixed Reset button. The chat-output sync toggles were relabeled so they read honestly — a broad “Mute addon chat messages” versus the sync-only mute — and the “Reset settings (keep anti-spam + blacklist)” button no longer throws an error when clicked; it now shows its confirmation prompt as intended.

v2.5.8 (2026-06-02)

• New: invite your party or raid from a pop-up window — even inside dungeons and raids. Hold Ctrl and left-click the minimap button (or the addon compartment) to open a small “Invite Group” window. It lists everyone in your current party or raid who can still be invited (class-coloured), and a single click sends them a guild invite. This works in places where right-clicking a unit frame can't — Mythic+, raids, and other instances — so you can recruit the pugs you just ran a dungeon with.
• Retail: right-click recruiting is back on unit frames out in the world. v2.5.6 had to remove FGI's right-click invite/blacklist menu from target, party, raid, and player frames on retail to stop it interfering with raid markers. We found that interference only happens inside instances, so the menu is back on those frames in the open world (where you do most recruiting). Inside dungeons and raids FGI stays out of that menu so your raid markers keep working — use the new Ctrl+click Group Invite window there instead. Chat names, friends list, and guild roster right-click are unchanged everywhere.
• Retail: fixed repeated errors when hovering recipes on the Crafting Orders page. Hovering a crafting order (or other profession tooltips that show a money amount) could spam a Lua error tied to FGI. The cause is removed: on retail FGI no longer adds its “joined / level at join” lines to the game's unit tooltips. That member info is still available on retail by hovering a name in chat and on the Guild Roster tab. Classic, TBC, Wrath, and Cataclysm still show the lines on unit tooltips as before.

v2.5.7 (2026-06-02)

• Updated for the latest retail patch. FastGuildInvite now reports as up-to-date on the current retail client (The War Within 11.2.7 and the Midnight pre-patch), so it no longer shows the “Out of Date” warning on the character-select AddOns list. This is a compatibility update only — there are no behaviour changes, and Classic Era, TBC, Wrath, and Cataclysm are unaffected.

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.