# 🌌 Horizon Suite

![CurseForge Game Versions](https://img.shields.io/curseforge/game-versions/1457844?style=for-the-badge) ![CurseForge Version](https://img.shields.io/curseforge/v/1457844?style=for-the-badge)
![CurseForge Downloads](https://img.shields.io/curseforge/dt/1457844?style=for-the-badge) [![Discord](https://img.shields.io/discord/1471477531805749412?style=for-the-badge&label=Discord)](https://discord.gg/nFabdZmvSB)
[![Patreon](https://img.shields.io/badge/build-donate-orange?&style=for-the-badge&label=patreon)](https://www.patreon.com/c/HorizonSuite) [![Ko-fi](https://img.shields.io/badge/build-tip-purple?&style=for-the-badge&label=Ko-fi)](https://ko-fi.com/horizonsuite)

---

> **One addon. Everything your UI needs.**
> Horizon Suite replaces your objective tracker, zone text, minimap, tooltips, and loot toasts — all in one place, all working together, all built for Midnight.

Stop juggling separate addons with separate option panels. Horizon Suite brings them together under one roof with a shared design language, unified profiles, and a community actively shaping what comes next.

**Eight modules. One options panel. Zero clutter.**

| Module | What it does | Status |
|---|---|---|
| 🎯 **Focus** | Objective tracker | Live |
| 🎬 **Presence** | Zone text & cinematic notifications | Live |
| 🗺️ **Vista** | Minimap with full customisation | Live |
| 🔍 **Insight** | Cinematic tooltips | Live |
| 🎒 **Cache** | Loot toasts & bag organisation | Preview |
| 📜 **Essence** | Character sheet | Preview |
| 💬 **Flow** | Chat frame | Coming Soon |
| 🌅 **Meridian** | Take a Guess! | Coming Soon |

---

## 🎯 Focus — Objective Tracker

![Focus - Objective Tracker](https://preview.redd.it/addon-horizon-suite-midnight-launch-update-new-options-prey-v0-5frvkrwhxhng1.gif?width=489&auto=webp&s=9c6da75805f3cff68cdcf545b22cc6ec082b20c5)

Your tracker shouldn't need babysitting. Focus keeps up with you — surfacing nearby quests, updating as you move, and getting out of the way when you don't need it.

- **Always relevant** — Nearby quests rise to the top automatically. Move zones and the list reorganises around you. Delves, scenarios, raids, and world events get their own sections with live progress bars and timers. Zone event quests appear in Events in Zone before you enter; step inside and they move to Current Event.
- **Tracks everything** — Achievements, Endeavors (housing), Decor, tracked transmog appearances, Recipes (professions), and Traveler's Log objectives. Full achievement progress tracking with criteria parsing and quantity strings. One-click to open the achievement panel, housing dashboard, decor catalog, the Appearances wardrobe for a tracked look (Shift+click opens the map to the source), or Adventure Guide. Under Appearances, you can use the in-game transmog list icon for every row instead of each item's icon.
- **Rare boss alerts** — Super-track nearby rares with one click and optional audio cues.
- **Live quest sync** — World quests, dailies, and weeklies update dynamically. Quests auto-track when you accept them. Choose a radar icon for auto-tracked in-zone entries.
- **Objective progress colours** — Optional gold and green tint on the whole X/Y token, including the slash (not started stays the normal objective colour).
- **Prey section** — Midnight hunting activities appear in a dedicated Prey section with distinct colours, separate from weeklies.
- **Plays well with others** — Full [All The Things](https://www.curseforge.com/wow/addons/all-the-things) integration: collection data shows up right in your objectives.
- **Combat-aware** — Show, fade, or hide in combat. Show or hide in dungeons/raids/BGs. Compact or super-minimal layouts. Show only on mouseover. Your call.
- **Mythic+ and Delves** — Keystone info, affixes, timer, and delve objectives all in the standard layout.
- **Countdown timers by section** — With **Show timer** on, toggle countdowns separately for **Scenarios**, **World Quests**, and **Dailies / Weeklies** (other timed quest log entries use the same switch as dailies and weeklies).
- **Click your way** — Optional classic mode: left-click opens the quest map, right-click shows share/abandon. Or use Shift+Left for quest details and Ctrl+Right to share with your party.
- **Profiles** — Per-character, per-spec, or global. Create, copy, export, and share as text strings.

---

## 🎬 Presence — Zone Text & Notifications

![Presence - Zone Text & Notifications](https://preview.redd.it/addon-horizon-suite-midnight-launch-update-new-options-prey-v0-mj3ii5rnxhng1.gif?width=731&auto=webp&s=e9267169ee7e52bd3276b49114e65047d412037f)

Blizzard's zone text does the job. Presence makes it feel like a moment.

- **Cinematic notifications** — Zone entry, level-ups, boss emotes, achievements, and quest updates arrive as styled toasts with smooth animations, a title/subtitle divider, and an optional "Discovered!" line on first visits.
- **13 notification types** — Zone entry, subzone changes, level-up, boss emotes, achievements, quest accepted/complete/progress, world quest accepted/complete, scenario start, scenario/delve complete, and scenario/delve objective updates.
- **Smart queue** — Up to five notifications queue while one plays. Level-ups and boss emotes cut the line automatically.
- **Mythic+ suppression** — Silence zone, quest, and scenario chatter while you're in a key.
- **Delve suppression** — Hide objective update popups inside Delves while zone entry and completion toasts still show.
- **Per-type toggles** — Turn off anything you don't want. Keep only what you care about.
- **Fully adjustable** — Screen position, scale, font and size for title and subtitle, entrance/exit speed, and hold duration. Tune it to match your playstyle.

---

## 🗺️ Vista — Minimap

![Vista - Minimap](https://preview.redd.it/addon-horizon-suite-3-0-0-released-vista-minimap-is-now-out-v0-adkv296wnblg1.gif?width=325&auto=webp&s=f623b0327377002da3eaa64b3ef78062dc7cfebf)

A minimap that fits your UI — not the other way around.

- **Square or circular** — Pick your shape. Drag it anywhere, lock it in place, resize from 100–400 px. Optional auto zoom-out after zooming.
- **Zone text, coordinates, time, and FPS/latency** — Each element has its own font, size, and colour; show or hide individually. Click the clock to open the stopwatch.
- **Instance info** — Difficulty name and Mythic+ keystone level shown automatically inside instances.
- **Addon button collector** — Minimap buttons from other addons grouped into a mouseover bar, right-click panel, or floating drawer. Per-addon filter so you show only what you want.
- **Built-in controls** — Tracking and calendar buttons. Show always or on mouseover. Draggable, resizable, lockable. Unlock the mail icon to reposition it too.
- **Mail and queue** — New mail and group queue indicators appear automatically when relevant.
- **Mouse wheel zoom** — Scroll over the minimap to zoom in and out.
- **Full typography and colour control** — Border thickness, opacity, panel colours, fonts, SharedMedia support.

---

## 🎒 Cache — Loot Toasts & Bags *(Preview)*

![Cache - Loot Toasts](https://preview.redd.it/addon-horizon-suite-midnight-launch-update-new-options-prey-v0-j62j1wnjyhng1.gif?width=570&auto=webp&s=8c8f42be57e3da4a0f839a6b04da7d8d41d5dcba)

Loot that deserves to be seen — and a bag that keeps itself organised.

- **Styled toasts for everything** — Items, money, currency, and reputation gains slide in with quality-coloured presentation and smooth animations.
- **Epic and legendary treatment** — Extended display time, shine effects, and optional sounds when something worth celebrating drops.
- **Bag organisation** — Clean up your inventory with Cache's built-in bag management.

---

## 🔍 Insight — Tooltips

![Insight - Tooltips](https://preview.redd.it/addon-horizon-suite-midnight-launch-update-new-options-prey-v0-9luqvfjeyhng1.png?width=387&format=png&auto=webp&s=e0816c4ced5581178a50507f8d803adc9a93edde)

Tooltips that actually tell you who you're looking at.

- **Class-coloured names and borders** — Player tooltips tinted to class colour at a glance.
- **Spec, role, faction, and PvP title** — See what someone plays without having to inspect them.
- **Item level and Mythic+ score** — iLvl from inspect cache and colour-tiered M+ rating inline.
- **Mount identification** — Hover a mounted player and see the mount name, source, and whether you own it.
- **Transmog status** — Item tooltips show whether you've already collected the appearance.
- **Cinematic presentation** — Dark backdrop, fade-in animation, cursor or fixed anchor. Stored per profile.
- **Combat mode** — Optional toggle to close styled tooltip frames during combat.

---

## 🎨 Shared Design & Customisation

Every module shares the same design foundations, so they feel like one cohesive UI.

- **Global or per-module scaling** — Set one global scale (50–200%) or dial in each module independently under Axis → Global Toggles.
- **Class tint** — Enable class colours per module or all at once from the Axis panel. Under Global Toggles, set **dashboard font** and **dashboard text size** for the settings window (separate from Focus tracker typography). Dashboard background presets: flat Default, Midnight artwork, or Specialisation (auto) — uses Blizzard's talent UI art for your current spec with a crossfade when you switch.
- **SharedMedia support** — Fonts and progress bar textures from addon packs across all modules. Works without SharedMedia installed too.
- **Per-category colours** — Title, objective, zone, section, and backdrop colours all configurable.
- **Typography and spacing** — Fonts, sizes, outlines, and spacing sliders. Turn-in highlights and quantity strings (e.g. 15/18) at a glance.
- **Progress bars** — Optional bar under objectives with numeric progress (e.g. 3/250). Configurable font, size, colour, and texture. Filter by X/Y, percent-only, or both. Timer layout: bar below, inline beside title, or inline on its own line.
- **Fluid animations** — Smooth entry/exit on tracker and notifications, subtle pulse on quest completion.
- **Scroll indicators** — Optional fade or arrow buttons when the list has more content than visible.
- **High-fidelity icons** — Distinct icons for Campaign, Legendary, and World Quests.

---

## 📥 Installation

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

**Optional:** [SharedMedia](https://www.curseforge.com/wow/addons/sharedmedia) for expanded font choices and progress bar textures. [RondoMedia](https://www.curseforge.com/wow/addons/rondomedia) by RondoFerrari for class icons in Insight tooltips and the Dashboard header icon when class colours are on.

1. Install via [CurseForge](https://www.curseforge.com/projects/1457844), [Wago](https://addons.wago.io/addons/jK8gY56y), or download the [latest release](https://gitlab.com/Crystilac/horizon-suite/-/releases) and extract the `HorizonSuite` folder. ([Beta](https://gitlab.com/Crystilac/horizon-suite/-/releases/beta))
2. Place it in `World of Warcraft\_retail_\Interface\AddOns\`.
3. Enable **Horizon Suite** in your AddOn list.
4. Open the **dashboard** (`/hsd`, the minimap button, or **Options** on the tracker).
5. **Welcome** gives a quick overview of each module. **Quick Start** walks through Focus sections, Presence notifications, and each module in detail. **Home** shows module tiles. Under **Axis** use **Global Toggles** for class colours and UI scale, or **Modules** to toggle modules on/off and control the minimap button.

---

## 💬 Community & Support

Horizon Suite is built with the community, not just for it. Feature requests and bug reports shape every update.

**[Discord](https://discord.gg/nFabdZmvSB)** — The best place to get help, share feedback, or see what's coming next.
**[GitLab Issues](https://gitlab.com/Crystilac/horizon-suite/-/issues)** — Bug reports and feature requests welcome. Use the Bug report or Feature request template. Reports from Discord, Reddit, or CurseForge are also welcome.
**[Patreon](https://patreon.com/HorizonSuite)** | **[Ko-fi](https://ko-fi.com/T6T71TX1Y1)** — Support development and keep the lights on.

---

## 💖 Contributors

Thanks to everyone who has contributed to Horizon Suite:

- **feanor21#2847 — Panoramuxa (Tarren Mill -EU)** — Development
- Marthix — Development
- Swift — Coordinator
- Boofuls — Moderator
- **RondoFerrari** — [RondoMedia](https://www.curseforge.com/wow/addons/rondomedia) — Class icons in Insight tooltips and optional Dashboard header icon when class colours are on (optional)
- **Aishuu** — French localization (frFR)
- **아즈샤라-두녘** — Korean localization (koKR)
- **Linho-Gallywix** — Brazilian Portuguese localization (ptBR)
- **allmoon** — Chinese localization (zhCN)

---

## 🌐 Localizations

The addon UI is localized for: Chinese (zhCN), French (frFR), German (deDE), Korean (koKR), Brazilian Portuguese (ptBR), Russian (ruRU), Spanish (esES).

Contributions for additional locales are welcome — see **[TRANSLATING.md](TRANSLATING.md)** and Discord.

---

## License

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