# Relationships Attune

A lightweight raid / dungeon / misc attunement tracker for **World of Warcraft 1.12** (Vanilla and OctoWoW).

Keep track of every attunement step for yourself — quests, key items, reputation, and level requirements — all in one clean window.

---

## ✨ What it does

Relationships Attune scans your quest log, bags, and reputations to figure out exactly how far along you are in each raid attunement. It then shares that progress with your party, raid, or guild so you can instantly see who's ready for what.

No more asking *"do you have your Onyxia key?"* in guild chat.

---

## 🎯 Features

- **Full attunement tracking** for classic raids:
  - Onyxia's Lair (both Alliance & Horde chains)
  - Molten Core
  - Blackwing Lair
  - Naxxramas
  - AQ40
- **Turtle / Octo WoW custom raids** supported
- **Auto-detection** of your progress by scanning:
  - Quest log (completed & in-progress quests)
  - Bags (key items)
  - Faction reputations
  - Character level
- **Faction-aware** — only shows steps that apply to your character
- **Party / Raid / Guild sync** — see the attunement status of everyone in your group
- **Clean UI** with:
  - Scrollable player list
  - Color-coded progress (green = done, yellow = partial, red = not started)
  - Hover tooltips explaining every step and where to start it
  - Click any step to see extra details
- **Movable, hideable minimap button** — drag it anywhere on your screen
- **Throttled auto-scan** — stays light on performance
- **Per-character progress** saved between sessions

---

## 📦 Installation

1. Download the addon.
2. Extract the `RelationshipsAttune` folder into your WoW addons directory:
   ```
   /Interface/AddOns/RelationshipsAttune/
   ```
4. Restart WoW (or reload with `/reload`).

---

## 🕹️ Usage

Open the window by clicking the minimap button, or use a slash command:

| Command | What it does |
|---|---|
| `/attune` | Toggle the main window |
| `/rattune show` | Show the window |
| `/rattune hide` | Hide the window |
| `/rattune scan` | Rescan your quest log and bags |
| `/rattune sync` | Request attunement data from your group |
| `/rattune reset` | Wipe stored data for this character |

### The main window

- **Left side:** list of players (you + anyone in your group/guild running the addon).
- **Right side:** every attunement broken down step by step.
- **Hover** a step to see what it is and where to start it.
- **Click** a step to expand extra info.
- Completed steps highlight in **green**, in-progress steps in **yellow**, missing steps in **red**.

### Minimap button

- **Left-click:** open/close the window.
- **Drag:** move the button anywhere on your screen.
- Hide it entirely via the options if you prefer a clean UI.

---

## ❓ FAQ

**Does it work on Turtle WoW / Octo WoW?**
Yes — the addon is built for 1.12 clients and is fully compatible with Turtle/Octo. Custom raid attunements are included.

**Will other players see my progress if they don't have the addon?**
No. Sync only happens between players who both have Relationships Attune installed.

**How do I move or hide the minimap button?**
Just click and drag it anywhere. To hide it, use the addon options (or set `minimapHide = true` in the saved variables).

**My progress looks wrong — what do I do?**
Run `/rattune scan` to force a rescan of your quest log, bags, and reputation. If it's still wrong, `/rattune reset` will wipe stored data for that character and rebuild it.

---


**Author:** Relationship