Grillos Guild Forge

Grillo's Guild Forge                                                                                                                                                                                                                                                                                **The recruitment addon that actually finds people.**                                                                                            
                                                                                                                                                     Four scanners working in parallel — `/who`, LFG Group Finder, public chat, nameplate proximity — feeding one queue with one keybind to fire
  `/ginvite`. Press F6. Invite the next recruit. Repeat.                                                                                           
  
  ---

  ## What makes it different

  Most recruitment addons hand you a `/who` button and call it a day. Same-realm only. Tedious. You're left clicking through invites by hand.      

  **Grillo's Guild Forge runs four scanners simultaneously**, each pulling from a different source the game already exposes:

  - **`/who` Scanner** — sweeps levels 1-90 in batches of 15, auto-subdivides any band that hits Blizzard's 50-result cap so nothing slips through.
  - **LFG Cross-Realm Scanner** — pulls every group-finder listing across Questing, Dungeons, Raids, BGs, Arena, and Delves. *True cross-realm.*   
  - **Public Chat Harvester** — passively listens to Trade / General / LookingForGroup. Pattern-matches phrases like "looking for a guild", "need a
   guild", "guildless". Auto-queues the speaker. *Covers your entire connected-realm cluster in real time.*
  - **Nameplate Proximity Harvester** — anyone unguilded walks past you, they're queued. Stand in Stormwind, watch the names roll in. *Cross-realm 
  naturally.*

  All four feed a single source-coded queue. Press your bound key (default **F6**) to fire `/ginvite` on the next person. Hold the key with OS     
  key-repeat enabled and chain invites at the natural cast rate.

  ---

  ## Is this bannable?

  **No.** Every scanner uses only sanctioned read-only Blizzard APIs:

  - **Chat harvest** reads `CHAT_MSG_CHANNEL` — the same public-chat event WIM, Prat, Elephant, and Total RP have read for over a decade.
  - **Nameplate harvest** uses `NAME_PLATE_UNIT_ADDED` + `GetGuildInfo` — the same APIs Plater, ElvUI, and KuiNameplates use.
  - **Invites** go through `SecureActionButtonTemplate` with `/ginvite <name>` macrotext — the exact chat command a player would type manually.    
  **One keypress = one invite. No automation, ever.**

  No protected calls. No input emulation. No taint. No HTTP requests. Every safety-relevant section of code has a plain-English walkthrough at the 
  top of the file. Moderators are welcome to read `Core.lua`, `UI.lua → CreateInviteButton`, `ChatHarvester.lua`, `ProximityHarvester.lua`, and    
  `LFGScanner.lua` directly.

  ---

  ## Quick start

  1. Install via the CurseForge app (or drop the folder into `_retail_\Interface\AddOns\`)
  2. In game, type `/ggf` to open the window
  3. Click **/who Scan** or **LFG Scan** → click **Start Scan** to fire batches
  4. Chat + proximity harvesters run passively in the background (default ON)
  5. Press **F6** to invite the next queued player
  6. Customize the keybind with `/ggf bind <key>` (e.g. `/ggf bind NUMPAD1`)

  ---

  ## Features

  - Four independent scanners (mix and match)
  - Keybindable one-cast-per-press invites
  - 30-day anti-repeat database (never re-invite someone)
  - Live progress bar + session stats (found / invited / joined)
  - Auto-detects guild joins via system messages → tracks conversion rate
  - Window position persists across sessions
  - Source-coded queue rows (LFG orange / CHAT yellow / NEARBY green / `/who` class-colored)
  - Class-colored names with tooltip showing source + area + race
  - Minimap addon-compartment entry
  - Comprehensive slash commands (see below)

  ---

  ## Who it's for

  - **Guild leaders** running active recruitment drives
  - **Officers** filling raid roster gaps
  - **Small guild founders** trying to crack 10-20 members
  - **Anyone** tired of typing `/who unguilded` by hand for an hour

  ---

  ## Slash commands

  /ggf                  Toggle window
  /ggf scan             /who mode + start scan
  /ggf lfg              LFG mode + start scan
  /ggf bind F6          Set invite keybind
  /ggf chat on|off      Toggle public-chat harvester
  /ggf prox on|off      Toggle nameplate-proximity harvester
  /ggf reset            Confirm + clear invited database
  /ggf stats            Show session + lifetime stats
  /ggf debug            Toggle debug messages

  ---

  ## FAQ

  **Q: Why does GGF find way more people than `/who` alone?**
  A: Because `/who` is same-realm-only by Blizzard's design. The LFG, chat, and proximity harvesters give you the cross-realm coverage `/who`      
  can't.

  **Q: I'm not in a guild. Can I use this to find guilds?**
  A: No — this is built for guild-side recruitment. You need to be a guild member with invite permission for `/ginvite` to fire.

  **Q: Does the chat harvester listen to whispers or party chat?**
  A: No — only public channels (Trade / General / LookingForGroup / World). No private communications are read.

  **Q: I keep seeing the same person harvested.**
  A: The session-level dedup prevents repeats within one play session. After `/reload`, the deduper resets, but the 30-day invite cooldown still   
  prevents re-inviting anyone you already invited.

  **Q: Can I auto-whisper a recruitment message after each invite?**
  A: Not in v1.2.0. Planned for a future release.

  **Q: Will this work on non-English clients?**
  A: The scanners and invite work language-agnostic. The "X has joined the guild" detector is currently English-only — non-EN users will still get 
  invites firing, but the auto-join counter won't increment.

  ---

  ## Author & License

  Built by **Grillo** · 2026