Dialogue Narrator

By
SatyrosPX

DialogueNarrator

Dialogue Narrator `v1.0.0`

Part of the Ultima Suite • Cinematic Dark RPG Dialogue & Quest Interface for World of Warcraft (Retail 12.1 Midnight)

🌟 Overview

Part of the Ultima Suite — engineered to operate 100% standalone with zero mandatory cross-addon dependencies, while providing seamless inter-addon synergies via UltimaBridge when other suite modules are installed.

Dialogue Narrator completely revitalizes the World of Warcraft questing and gossip interaction experience. It replaces Blizzard's default, outdated quest and gossip windows with an immersive, dark-themed cinematic RPG interface. Designed specifically for Retail Patch 12.1.0 (Midnight), it features an animated 3D NPC model, high-readability typography, smooth keyboard navigation, and camera focus.

✨ Key Features

🎭 1. Cinematic Dark RPG Interface

Modern Dark UI: Compliant with the Ultima Suite Modern Dark aesthetic (#141417 core background, subtle slate borders, and glowing warm-gold highlights).
3D NPC Speaker Model: Renders a live 3D animated model of the speaking character with smooth lighting, or falls back to a high-resolution 2D portrait if models are unavailable.
Speaker Context: Displays character name, subtitle, title, and current quest level tags.
Readable Typography: Three selectable font sizes (Normal, Large, Huge) ensuring comfortable reading across 1080p, 1440p, and 4K displays.

⌨️ 2. Rapid Keyboard Navigation

Number Hotkeys [1] – [9]: Directly select gossip choices, available quests, or turn-in quest choice rewards with a single keystroke.
Smart Spacebar [Space]: One-touch progression to accept new quests, continue dialogue stages, or turn in completed quests.
Escape [Esc]: Instantly and cleanly dismisses open dialogues.
Combat Resilient: Automatically releases key capture and closes dialogues upon combat lockdown (PLAYER_REGEN_DISABLED).

🎥 3. Smooth Cinematic NPC Camera Focus

Dynamic Camera Zoom: Gently adjusts camera zoom towards the interacting NPC during conversation for cinematic immersion.
Camera Reversion: Automatically and precisely restores your camera distance and perspective as soon as the conversation ends or combat starts.

🎁 4. Comprehensive Quest Rewards & Objectives

Interactive Choice Selection: Preview choice rewards with full item tooltips, quality borders, and click-to-select gold highlight outlines.
Complete Reward Breakdown: Clearly visualizes fixed rewards, copper/silver/gold currency, experience points, and Warband reputation gains.

⚙️ 5. Two-Tier Navigation Settings

In-Game Configuration: Access options via /dn, /dialogue, or Blizzard's Addon Compartment menu.
Tabbed Settings: Effortlessly customize General behavior, Camera parameters, Controls, and Visual scaling.
Instant Test Preview: Test the dialogue frame at any time with a built-in preview featuring Regent Lord Lor'themar Theron.

⌨️ Slash Commands

Command	Action
`/dn`	Toggle the Settings window
`/dialogue`	Toggle the Settings window (alias)
`/dialoguenarrator`	Toggle the Settings window (alias)
`/dn test` / `/dn preview`	Open the interactive Test Preview dialogue
`/dn toggle`	Toggle Dialogue Narrator on or off

🌐 Supported Languages

Full native localization for all 10 official World of Warcraft client languages:

🇬🇧 English (enUS) — Canonical Base
🇩🇪 German (deDE) — Vollständig lokalisiert
🇫🇷 French (frFR) — Entièrement traduit
🇪🇸 Spanish (esES) — Totalmente traducido
🇲🇽 Latin American Spanish (esMX) — Totalmente traducido
🇮🇹 Italian (itIT) — Completamente localizzato
🇧🇷 Brazilian Portuguese (ptBR) — Totalmente traduzido
🇷🇺 Russian (ruRU) — Полный перевод
🇰🇷 Korean (koKR) — 완벽 번역 지원
🇨🇳 Simplified Chinese (zhCN) — 完整简体中文
🇹🇼 Traditional Chinese (zhTW) — 完整繁體中文

📦 Installation

Copy or extract the DialogueNarrator folder directly into your World of Warcraft AddOns directory:
World of Warcraft\_retail_\Interface\AddOns\DialogueNarrator
Ensure no subfolder nesting exists (the .toc file must reside directly inside AddOns\DialogueNarrator\).
Start or reload World of Warcraft (/reload).

📜 Credits & License

* **Author:** Satyros
* **Suite:** Ultima Suite
* **License:** [MIT License](LICENSE)
* **Framework:** Powered by UltimaBridge for standalone modularity.

### Acknowledgements & Inspirations:
* Built for the **Ultima Suite** ecosystem (`UltimaBridge`).
* Special thanks to the trailblazers of immersive questing and RPG dialogue experiences in World of Warcraft: **Immersion** (*Fyrcs*), **DialogueUI** (*Peterodox*), and **Storyline**.