# 🌌 Horizon Suite

**Horizon Suite** is a core addon with pluggable modules: **Focus** (objective tracker) and **Presence** (zone text & notifications). Designed for the Midnight era—clean, cinematic, player-in-control. It replaces static, cluttered lists with a fluid interface that grants you total agency over your goals. Additional suites will appear as modules in the same options panel.

---

## 🎯 Focus (Objective Tracker)

![Focus - Objective Tracker](https://raw.githubusercontent.com/Crystilac93/Horizon-Suite/main/docs/Focus.png)

- **Smart zone tracking** – Nearby quests float to the top; list updates as you move. Delves, scenarios, and world events get their own sections with progress bars and timers.
- **Track what matters** – Achievements, Endeavors (housing), and Decor appear in the tracker. One-click to open achievement panel, housing dashboard, or decor catalog.
- **Rare boss alerts** – Super-track nearby rares with one click and optional audio alerts.
- **Live quest sync** – World quests, dailies, and weeklies update dynamically. Quests auto-track when you accept them.
- **All The Things integration** – Collection data appears directly in your objectives.
- **Combat-ready** – Hide in combat, show or hide in dungeons/raids/BGs, compact or super-minimal layouts.
- **Mythic+ and Delves** – Banner for keystone info, timer, and affixes. Delve objectives in the standard layout.

## 🎬 Presence (Zone Text & Notifications)

![Presence - Zone Text & Notifications](https://raw.githubusercontent.com/Crystilac93/Horizon-Suite/main/docs/Presence.png)

- **Cinematic notifications** – Zone text, subzone changes, "Discovered" lines. Level-up, boss emotes, achievements, quest accept/complete, and scenario start appear as styled toasts with smooth animations.

## 🎨 Visuals & UI Design

- **High-fidelity icons** – Distinct icons for Campaign, Legendary, and World Quests.
- **Customizable colours** – Per-category colour control (title, objective, zone, section).
- **Typography and spacing** – Fonts, sizes, outlines, and spacing sliders. Turn-in highlights and progress counts (e.g. 15/18) at a glance.
- **Fluid motion** – Smooth entry/exit animations and a subtle pulse on objective completion.

---

## ⌨️ Basic Commands

| Command             | Action                                        |
| ------------------- | --------------------------------------------- |
| `/horizon options`  | Open the options panel (search bar included). |
| `/horizon toggle`   | Toggle the tracker on or off.                 |
| `/horizon collapse` | Collapse or expand the tracker.               |
| `/horizon nearby`   | Toggle the Nearby (Current Zone) grouping.    |
| `/horizon test`     | Preview your styling with sample data.        |
| `/horizon reset`    | Clear test data.                              |
| `/horizon resetpos` | Reset the tracker position.                   |

**Mouse:** Left-click to focus a quest (and complete auto-complete quests). Right-click to untrack. Shift+left-click for quest log and map. Shift+right-click to abandon. Drag the corner grip to resize.

---

## 📦 Modules & Roadmap

**Focus** is the objective tracker. **Presence** adds cinematic zone text and notifications (enable it in options). More modules are planned: Quest Log, Minimap, Loot Hub, Combat Alerts, Unit Frames, Tooltips, Chat.

---

## 📥 Installation

**Requirements:** World of Warcraft Retail (The War Within or later).

1. Install via Wago, or download from [GitHub](https://github.com/Crystilac93/Horizon-Suite/releases) and extract the `HorizonSuite` folder.
2. Place it in `World of Warcraft\_retail_\Interface\AddOns\`.
3. Enable **Horizon Suite** in your AddOn list.
4. Type `/horizon options` to customize.

---

## 💖 Support

[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/T6T71TX1Y1) **[Patreon](https://patreon.com/HorizonSuite?utm_medium=unknown&utm_source=join_link&utm_campaign=creatorshare_creator&utm_content=copyLink)** | **[Discord](https://discord.gg/RkkYJgB3PA)** — Bug reports, feature requests, and community.

---

## License

Distributed under the MIT License. See `LICENSE` for more information.
