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)
• DeltaSync (v4.0.0+) and AceCommQueue — the guild-sync libraries — plus GuildRoster and LibLocaleOverride. CurseForge installs all of these automatically; manual installers must add them too.
• 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.10.2 (2026-07-16)

• Retail fix: chat that FGI sends automatically no longer throws a “blocked” error. On the current retail patch, any chat FGI sent on a timer or in response to an event got blocked by the game — so only the first of your spaced-out announcements went through, the guild-chat welcome failed, the “player blacklisted” officer-chat notice failed when someone was auto-blacklisted on leaving, and “whisper on decline” invites failed (all with an ADDON_ACTION_BLOCKED error). FGI now uses the game's supported chat call everywhere, so they all go through. Classic isn't affected.
• New: Wingman no longer spams “announcement didn't post” notices. If you clicked with Wingman on but your announcement couldn't go out — you're not your guild's designated announcer, or you'd left the channel it targets — FGI used to print the reason on almost every click. Those “skip” notices are now hidden by default (a new Mute announce skip notices toggle on the Wingman settings page, on out of the box). Turn it off if you'd rather see them. The “posted to N channels” confirmation is never hidden.
• New: Wingman follows your recruiting duty. If your guild uses a designated announcer or inviter list, FGI now offers to turn Wingman on the moment duty is yours — shortly after you log in, or when it hands over to you because the person ahead of you logs off (a quick Turn on Wingman button; there's a Don't ask again option and a matching toggle in settings). And it works the other way too: if you're running Wingman and you're no longer on recruiting duty (someone above you logs on, or the Guild Master changes the list), Wingman turns itself off — so it only runs while you're the one on duty. Guilds not using those lists are unaffected.
• Fixed: non-designated members could still slip a public announcement through. When your guild set a designated announcer, a member who wasn't the designate could occasionally still post their own announcement to a public channel. FGI now decides who's on duty purely from who's online in your guild roster — which the game tracks live — so every member agrees on the designate instantly, with no lag and no leak. Duty still hands to the next person the moment the one above them logs off. (You can see who your client considers on duty under Settings → Guild Policy.)

v2.10.1 (2026-07-09)

• New: only one FGI user sends the guild welcome now. If several members ran FGI with auto-welcome on, a new member got the same welcome two or three times over. Guild Policy now has a Designated welcomer list (separate from the announcer and inviter lists) — whoever is online, running FGI, and highest on it is the only one who greets new joiners, so they get exactly one welcome. Empty list = everyone's own welcome works as before.
• New: the GM can force a standard welcome for the whole guild. On the Guild Policy tab, tick Enforce a standard welcome and set the guild-chat line and/or private whisper (with NAME filled in). It replaces everyone's own welcome wording — pair it with the Designated welcomer for one identical welcome, from one member, every time someone joins.

v2.10.0 (2026-07-09)

• New: your announcements go out one at a time instead of all at once. Before, a single click could dump the same recruiting line into General, Trade, LookingForGroup and Guild in the same second — a wall of text. Now FGI spaces them out, posting one every couple of seconds until they're all sent, then stops (it runs through the list once and doesn't repeat). A new Announcement spacing slider on the Wingman settings page sets the gap.
• Fixed: no more “couldn't post” spam when you're not in a channel. If an announcement targeted a channel you hadn't joined, every click printed another “couldn't post to that channel” line. Now FGI tells you once and then quietly keeps retrying in the background (spaced out, not on every click) until you're back in the channel and it goes through.
• New: a separate “designated inviter” for random invites. Just like the designated announcer for announcements, Guild Policy now has its own list for who sends random (scan-driven) invites — usually a throwaway alt, not your main. So you can be top of the announce list on your main yet leave inviting to the alt. Whoever is online, running FGI, and highest on the inviter list is the only one sending random invites; it opens back up to everyone when nobody listed is online, and it never touches invites you send by right-clicking a specific player.
• Wingman shows a brief “loading” countdown at login when your guild uses a designated announcer/inviter. For a few seconds after you log in, it syncs up who's online and running FGI across the guild, so it won't accidentally double-post announcements or double-send invites before everyone's client agrees on who's covering. Once the countdown clears, Wingman works as normal. Guilds not using those lists never see it.
• Clearer Guild Policy tooltips, plus a Clear button on each list. The Designated announcer (formerly “Designated recruiter”) and new Designated inviter settings now spell out exactly what they affect and what they don't — the announcer controls public-channel announcements (never Guild or Officer chat), the inviter controls random invites, and each opens back up to everyone when nobody listed is online. Hover the section title for the full explanation. Each list also has a Clear button, and names you type are matched to your guild roster automatically (use Name-Realm for connected realms).

v2.9.1 (2026-07-05)

• Fixed: adding a guild announcement no longer throws an error. In v2.9.0, clicking “Add announcement” on the Guild Policy tab produced a Lua error and didn't add anything. It now adds a blank announcement you can fill in.

v2.9.0 (2026-07-05)

• New: put Wingman's actions in the order you want. Settings → Wingman now has a Priority order section where you rank its three actions — announce, scan, and invite. On each click, Wingman does the highest-ranked one that's ready right now. So you can put Invite above Scan to make Wingman finish inviting everyone in your queue before it goes looking for new players with a fresh /who. Announce always waits for its own cooldown, so it never spams no matter where you rank it.
• New: Guild Policy has its own tab, and the Guild Master picks who edits it. Guild Policy moved out of the Guild tab into its own Guild Policy settings tab. The Guild Master can now grant policy-editing rights to a chosen guild rank and/or to specific named members — not just the top ranks — under “Who can edit guild policy”, then Push policy to guild to share it. (First step of a larger Guild Policy update arriving in pieces.)
• New: push standard announcements to the whole guild. The Guild Policy tab can now carry forced announcements — a message with its channels (General, Trade, LookingForGroup, Guild, Officer), a cooldown, and an activity threshold. Push it, and every member broadcasts that same announcement through FGI's horn button or Wingman, keeping your guild's recruiting message consistent.
• New: a single “designated announcer” so your guild doesn't spam Trade. List member names in priority order under Guild Policy. Whoever is online, running FGI, and highest on the list becomes the only person allowed to post announcements to public channels (LFG / Trade / General) — everyone else's public announcements are held until it's their turn, and the next person down takes over automatically when the top one logs off. Guild and Officer chat are never restricted. Leave the list empty to let everyone announce as before.

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.