Patron auto GZ congratulater

V1.0.0 - Initial release

Patron GZ automatically congratulates your guild members when they earn achievements. No more missing someone's big moment - Patron GZ Congratulater has your back.

## Features

Two Modes 

- **Auto Mode** — Sends a grats message to guild chat automatically. A randomized delay (default 2-5 sec) makes it feel natural, not bot-like.
- **Manual Mode** — A clickable [Grats!] button appears in your chat window. You decide who gets the love. Click to send, or ignore — nothing goes out without your say-so.

**Customizable Messages**

Set up your own message templates with placeholders:

- `%player%` — the guild member's name
- `%achievement%` — clickable achievement link
- `%name%` — achievement name (plain text)
- `%points%` — achievement point value

Add as many templates as you want. When multiple exist, Patron GZ picks one at random each time — so it never looks copy-pasted in guild chat.

Default message: `[PATRON GZ] Grats %player% on %achievement%!`

**Smart Throttling**

When a guild member completes a meta-achievement and 5 cheevos pop at once, Patron GZ doesn't spam. A configurable per-player cooldown (default 10 sec) batches rapid achievements into a single grats.

**Randomized Send Delay**

Messages don't fire instantly. A configurable random delay window (default 2-5 seconds) adds natural variance so your grats feel human-typed, not automated.

**Clean Settings Panel**

Custom dark-themed UI with minimap button. Left-click the minimap icon to open settings, right-click to quick-toggle on/off. Everything is also accessible via `/gz` slash commands.

## Slash Commands

- `/gz` — Open settings panel
- `/gz toggle` / `on` / `off` — Enable or disable
- `/gz auto` / `manual` — Switch mode
- `/gz add <message>` — Add a message template
- `/gz remove <#>` — Remove a message by number
- `/gz list` — List all message templates
- `/gz throttle <seconds>` — Set per-player cooldown
- `/gz test` — Preview your message and test the clickable button
- `/gz help` — Show all commands

## How It Works

Patron GZ listens for the `CHAT_MSG_GUILD_ACHIEVEMENT` event. When a guild member earns an achievement:

1. Checks it's not you (no self-grats)
2. Checks the per-player throttle window
3. In Auto mode: waits a random delay, then sends your message to /g
4. In Manual mode: shows a clickable [Grats!] link in your chat — click to send

That's it. Lightweight, no dependencies, no libraries.

## Installation

Drop the `PatronGZ` folder into your `Interface/AddOns/` directory. The minimap button appears automatically on login.

## Compatibility

- Built for WoW 12.0 (The War Within Season 2+)
- Uses only stable APIs that have existed since patch 3.0
- No combat-related APIs, no protected functions, no hardware event requirements
- SendChatMessage to GUILD works freely from addon event handlers