# Recruit Pulse

**Recruit Pulse** is a lightweight addon for **WoW TBC Anniversary** (Interface `20504` / `20505`) that repeats your raid recruitment message to a trade (or custom) chat channel on a timer, with optional whisper auto-reply, AFK nudge, and a small status window.

Supports **English** and **Korean** (`koKR`) UI text.

---

## Features

- **Timed channel posts** — Custom message, channel number (`/N`), interval (default 35 seconds)

- **Minimap button** — Left-click: settings · Right-click: toggle posting · Shift+drag: move button

- **Slash commands** — `/rp`, `/rp on`, `/rp off`, `/rp now`, `/rp config`

- **Post queue** — When WoW requires a click/key to send, the next post waits until you interact (same for repeats)

- **Status mini-window** — Post count, anti-AFK count, current channel/interval; draggable with lock

- **Away whisper log** — While auto-posting is on, incoming whispers that receive an auto-reply are saved (original text, class-colored names for in-game whispers, `(BN)` prefix for Battle.net whispers)

- **Whisper auto-reply** — Optional template with `%s` replaced by your Discord URL

- **Anti-AFK nudge** *(optional)* — Small in-place turn while posting only; **use at your own risk** (see disclaimer)

Settings: **ESC → Options → Addons → Recruit Pulse**

---

## Installation

1. Download and extract the **RecruitPulse** folder.

2. Place it in:

- `World of Warcraft/_anniversary_/Interface/AddOns/RecruitPulse`

3. Restart WoW or type `/reload`.

4. Enable **Recruit Pulse** on the character select / in-game AddOns list.

> Auto-posting starts **off** each login/reload until you turn it on (minimap right-click or `/rp on`).

---

## Slash commands

| Command | Description |

|--------|-------------|

| `/rp` | Help |

| `/rp config` | Open settings |

| `/rp on` | Start auto-posting |

| `/rp off` | Stop auto-posting |

| `/rp now` | Send one message immediately |

---

## Whisper auto-reply

- Only runs while **auto-posting is enabled** and a non-empty reply is configured.

- Default reply points recruits to your Discord URL (editable in settings).

- **In-game whispers**: sender name shown in **class color** when the game provides class info (party, guild, friends, GUID).

- **Battle.net whispers**: shown as `(BN)` + the Battle.net display name/tag from the client (not your in-game character name).

---

## Anti-AFK disclaimer

The optional anti-AFK feature is a **convenience only**. It may not work after patches, may conflict with Blizzard rules, and could carry **account risk**. It runs only while auto-posting is on and skips if you moved recently. **You are responsible for how you use it.**

---

## Saved variables

`RecruitPulseDB` — message, channel, intervals, minimap position, whisper log, window positions, etc.

---

## 한국어 요약

레이드 구인 문구를 지정 채널에 **주기적으로 자동 전송**합니다. 미니맵 버튼·`/rp` 명령·전송 현황 창·**자동 전송 중 귓속말 자동 답장**·**부재중 귓말 목록**(직업색 이름, BN 귓말은 `(BN)`+배틀넷 이름)을 지원합니다. TBC Anniversary (`20504`/`20505`)용입니다.

---

## License & support

See **CHANGELOG.md** for version history.

Author: **RecruitPulse**

---

## CurseForge package

Include the entire `RecruitPulse` folder (all `.lua` files, `RecruitPulse.toc`, `README.md`, `CHANGELOG.md`, `Logo-RecruitPulse.png`).