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

Grillos Guild Forge