# 🌌 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) 

**Horizon Suite** is a core addon with pluggable modules: **Focus** (objective tracker), **Presence** (zone text & notifications), **Insight** (cinematic tooltips), **Vista** (minimap), and **Cache** (loot toasts). 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://preview.redd.it/addon-horizon-suite-midnight-launch-update-new-options-prey-v0-5frvkrwhxhng1.gif?width=489&auto=webp&s=9c6da75805f3cff68cdcf545b22cc6ec082b20c5)

- **Smart zone tracking** – Nearby quests float to the top; list updates as you move. Delves, scenarios, raids, and world events get their own sections with progress bars and timers. Zone event quests appear in Events in Zone before you enter; once you step in, they move to the Current Event section. World quests you're actively doing also appear in Current Event.
- **Events in Zone section** – Turn it off under Focus → Sorting & Filtering → Grouping to hide nearby unaccepted and zone-event quests from the tracker (like turning off world quests for content you have not accepted).
- **Track what matters** – Achievements, Endeavors (housing), Decor, tracked transmog appearances, Recipes (professions), and Traveler's Log objectives appear in the tracker. Full achievement progress tracking with criteria parsing and quantity strings. One-click to open 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.
- **Recipe reagents** – By default, tracked recipes show a compact shopping list (Basic reagent slots only, first item per slot—similar to typical AH shopping flows). Enable **Full reagent detail** under Focus → Recipes to list optional and finishing sections, every choice variant, and non-Basic reagents. With **Auctionator** and the Auction House open, the magnifying glass runs a shopping search; **right-click** it to enter how many crafts you want and multiply every line’s quantity.
- **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. 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 (Prey hunts) appear in a dedicated Prey section with distinct colours, separate from weeklies.
- **All The Things integration** – Collection data appears directly in your objectives.
- **Profiles** – Create, switch, copy, and delete named profiles. Per-character, per-specialization, or global (account-wide) modes. Import and export profiles as shareable text strings.
- **Combat-ready** – Show, fade, or hide in combat; show or hide in dungeons/raids/BGs; compact or super-minimal layouts.
- **Show only on mouseover** – Fade the tracker when not hovering; move the mouse over it to reveal.
- **Mythic+ and Delves** – Banner for keystone info, timer, and affixes. Delve objectives 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 profile** – Under Focus → Click Options, pick **Blizzard+** (default), **Horizon+** (super-track first, Custom for per-combo shortcuts), or **Custom**. Optional **classic click behaviour** still adjusts icon-style clicks where enabled.

## 🎬 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)

- **Cinematic notifications** – Replaces Blizzard's default zone text, level-up banner, boss emote frame, and achievement alerts with styled toasts: smooth entrance and exit animations, a dividing line between title and subtitle, and an optional "Discovered!" third line on first visits.
- **Full notification coverage** – Zone entry, subzone changes, level-up, boss emotes, achievements, quest accepted/complete/progress, world quest accepted/complete, scenario start, scenario or delve complete, and scenario or delve objective updates — 13 types in total.
- **Per-type toggles** – Enable or disable each notification type individually. Mythic+ suppression silences zone, quest, and scenario notifications while inside a keystone dungeon.
- **Delve suppression** – Toggle to hide objective update popups while in a Delve. Zone entry and completion toasts still show.
- **Prioritised queue** – Up to five notifications queue when one is already playing; higher-priority events (level-up, boss emotes, achievements) play ahead of routine quest updates.
- **Visual customisation** – Vertical screen position, frame scale, and independent font types and sizes for title and subtitle. Entrance speed, exit speed, and hold-duration multiplier are all adjustable.

## 🗺️ 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)

- **Square or circular minimap** – Choose a square or circular mask. Adjust size (100–400px), lock position, or drag to relocate. Optional auto zoom-out after zooming.
- **Zone text, coordinates, time, and FPS/latency** – Zone name, player coordinates, game time, and optional FPS/latency (ms) below the minimap. Each element has its own font, size, and colour; show or hide individually. Click the time to open the stopwatch.
- **Instance difficulty** – Difficulty name and Mythic+ keystone level shown when in an instance. Position it above or below the minimap independently of zone text; drag to fine-tune like other overlays.
- **Mail and queue indicators** – New mail icon and queue status button appear automatically when relevant. Unlock the mail icon in options to drag and reposition it.
- **Built-in buttons** – Tracking and calendar buttons. Show always or on mouseover. Each is draggable and resizable; lock to prevent accidental movement.
- **Addon button collector** – Minimap buttons from other addons are grouped and presented in one of three modes: mouseover bar below the minimap, right-click panel, or floating drawer button. Per-addon filter to show only selected buttons.
- **Customizable appearance** – Border (thickness, colour, opacity), panel background and border colours for button panels, and per-element typography. SharedMedia support for fonts.
- **Mouse wheel zoom** – Scroll over the minimap to zoom in and out.

## 💎 Cache (Loot Toasts) - BETA

![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)

- **Cinematic loot notifications** – Items, money, currency, and reputation gains appear as styled toasts with quality-based colours and smooth slide-in animations.
- **Epic and legendary flair** – Extra entrance time, shine effects, and optional sounds for high-value loot.

## 🔍 Insight (Tooltips) - BETA

![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)

- **Cinematic tooltips** – Dark backdrop, class-colored player names and borders, faction icons, spec/role display, and fade-in animation.
- **Profile-backed settings** – Anchor mode (cursor or fixed) and position stored per profile.
- **Hide tooltips in combat** – Optional toggle under Insight → Global Tooltips to close styled tooltip frames during combat.

## 🎨 Visuals & UI Design

- **High-fidelity icons** – Distinct icons for Campaign, Legendary, and World Quests.
- **Customizable colours** – Per-category colour control (title, objective, zone, section). Panel backdrop colour and opacity.
- **Global Toggles (Axis)** – Under **Axis → Global Toggles**, enable class tint per module or all at once (dashboard, Focus, Presence, Vista, Insight, Cache, Essence), pick a **dashboard background** preset (flat Default, Midnight artwork, or **Specialisation (auto)** using Blizzard’s talent UI art for your current spec—with a short crossfade when you change preset or spec), choose **dashboard font** and **dashboard text size** for the settings window (independent of Focus typography), and set global UI scale (50–200%) or per-module scale sliders for Focus, Presence, Vista, Insight, and Cache.
- **Typography and spacing** – Fonts, sizes, outlines, and spacing sliders. Optional SharedMedia support for fonts from addon packs. Turn-in highlights and progress counts (e.g. 15/18) at a glance.
- **Progress bar** – Optional bar under objectives with numeric progress (e.g. 3/250). Configurable font, size, colours, and texture (SharedMedia support: Blizzard status bar, Solid, or addon packs). Filter to show for X/Y objectives (e.g. 3/10), percent-only objectives (e.g. 45%), or both.
- **Timer layout** – Bar below objectives, inline beside the title, or inline on its own line below the title.
- **Fluid motion** – Smooth entry/exit animations and a subtle pulse on objective completion.
- **Scroll indicators** – Optional fade or arrow buttons when the list has more content than visible.

---

## 📦 Modules & Roadmap

**Focus** is the objective tracker. **Presence** adds cinematic zone text and notifications. **Insight** adds cinematic tooltips with class colors, spec display, and faction icons. **Vista** adds a cinematic minimap (square or circular) with zone text, coordinates, time, optional FPS/latency, addon button collector, and full customisation. **Cache** adds cinematic loot toasts (items, money, currency, reputation). Enable them in options. More modules are planned: Quest Log, Combat Alerts, Unit Frames, Chat.

---

## 📥 Installation & Support

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

**Optional:** [SharedMedia](https://www.curseforge.com/wow/addons/sharedmedia) (e.g. SharedMedia Additional Fonts) for expanded font choices in Typography and statusbar textures for progress bars. If not installed, the font dropdown shows only Game Font and any custom path you enter; progress bars use Solid texture. [RondoMedia](https://www.curseforge.com/wow/addons/rondomedia) by RondoFerrari for class icons in Insight tooltips and, when Dashboard class colours are on, for the Dashboard header class icon (Axis → Class Colours → Dashboard class icon style—separate from Insight).

1. Install via [CurseForge](https://www.curseforge.com/projects/1457844), [Wago](https://addons.wago.io/addons/jK8gY56y), or download the [latest release](https://github.com/Tacit-Labs/Horizon-Suite/releases/latest) and extract the `HorizonSuite` folder. ([Beta](https://github.com/Tacit-Labs/Horizon-Suite/releases/tag/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** is the first sidebar item with a short overview of each module (Preview items are labelled); **Quick Start** (under Welcome) explains Focus sections, Presence notifications, and each module in more detail. **Search** in the sidebar (above **Patch Notes**) opens a dedicated page to find any setting by name. **Home** shows module tiles. Under **Axis** use **Global Toggles** (class colours and UI scale) or **Modules** (module on/off and minimap button). After your first visit, the dashboard opens on **Home** by default; **Welcome** and **Quick Start** stay in the sidebar.

[ko-fi](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/nFabdZmvSB)** — Bug reports, feature requests, and community.

---

## 🤝 Contributing

**Issues** — **[GitHub Issues](https://github.com/Tacit-Labs/Horizon-Suite/issues)**. Reports and requests can be directly filed [here](https://github.com/Tacit-Labs/Horizon-Suite/issues/new/choose). Reports from Discord, Reddit, or CurseForge are also welcome.

---

## 💖 Contributors

Thanks to everyone who has contributed to Horizon Suite:

- **feanor21#2847 — Panoramuxa (Tarren Mill -EU)** — Development
- **Marthix** — Development
- **Swift** — Coordinator
- **Boofuls** — Moderator
- **Diva** — Innovator
- **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 localisation (frFR)
- **아즈샤라-두녘** — Korean localisation (koKR)
- **Linho-Gallywix** — Brazilian Portuguese localisation (ptBR)
- **allmoon** — Chinese localisation (zhCN)

---

## 🌐 Localisations

The addon UI is localised for:

- **German (deDE)** — `localisation/horizon/deDE.lua`
- **English (enUS)** — `localisation/horizon/enUS.lua`
- **Spanish (esES)** — `localisation/horizon/esES.lua`
- **French (frFR)** — `localisation/horizon/frFR.lua`
- **Korean (koKR)** — `localisation/horizon/koKR.lua`
- **Brazilian Portuguese (ptBR)** — `localisation/horizon/ptBR.lua`
- **Chinese (zhCN)** — `localisation/horizon/zhCN.lua`

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

---

## License

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