ImmersionBridge

A bridge addon for World of Warcraft Classic TBC Anniversary edition that combines the best features of: Immersion and DialogueUI addons

Description

ImmersionBridge seamlessly integrates Immersion's animated 3D NPC portrait system with DialogueUI's elegant quest scroll presentation. The animated portrait appears in the top-left corner of DialogueUI's quest frame, with all quest text and options displayed below it, creating an immersive and visually appealing questing experience.

Features

Animated 3D Portraits: Displays animated 3D models of NPCs during quest interactions, borrowed from Immersion
Quest Scroll UI: Uses DialogueUI's beautiful parchment-style quest presentation
Smart Integration: Portrait is positioned as an overlay in the top-left corner of the quest frame
Text Padding: Automatically adjusts scroll content to prevent text from being covered by the portrait
Event Support: Works with gossip, quest details, quest progress, quest completion, and quest greeting events
UI Independence: Portrait remains visible even when DialogueUI's "HideUI" setting is enabled

Requirements

World of Warcraft Classic TBC Anniversary Edition (Interface version 20505)
Immersion addon (must be installed and enabled)
DialogueUI addon (must be installed and enabled)

Installation

Download or clone this addon to your World of Warcraft Interface/AddOns/ directory
Ensure both Immersion and DialogueUI are installed and enabled
Restart World of Warcraft or type /reload in-game
The addon will automatically initialize when both dependencies are loaded

The addon folder structure should look like:

Interface/AddOns/
  ├── Immersion/
  ├── DialogueUI/
  └── ImmersionBridge/
      ├── ImmersionBridge.toc
      ├── ImmersionBridge.lua
      ├── PortraitFrame.xml
      └── README.md

Usage

Once installed, ImmersionBridge works automatically. Simply interact with NPCs as you normally would:

Talk to quest givers
Accept quests
Turn in quests
Browse gossip options

The animated portrait will appear automatically in the top-left corner of DialogueUI's quest frame.

Commands

/ib show - Manually show the portrait
/ib hide - Manually hide the portrait
/ib test - Test the portrait with your player model
/ib status - Display addon status and dependency information

How It Works

ImmersionBridge:

Disables Immersion's UI: Prevents Immersion's quest frame from showing, using only its portrait system
Hooks into DialogueUI: Monitors when DialogueUI's quest frame is shown/hidden
Displays Portrait: Shows the animated 3D NPC portrait in the top-left corner of DialogueUI's frame
Adjusts Layout: Automatically adds padding to push quest text below the portrait
Maintains Visibility: Ensures the portrait remains visible even when DialogueUI's HideUI setting is active

Technical Details

The portrait frame uses ignoreParentAlpha to remain visible when DialogueUI's HideUI is enabled
Portrait positioning is handled via frame parenting and anchoring to DUIQuestFrame
Scroll content padding is applied by offsetting DialogueUI's ContentFrame position
The addon uses Immersion's ModelMixin for NPC model animations and lip-sync

Author

Brostafa

License

This addon is provided as-is. It integrates functionality from Immersion and DialogueUI but does not modify their core files.

Credits

Immersion - For the animated portrait system and model animation code
DialogueUI - For the beautiful quest scroll presentation

Version

1.0.0

Support

For issues or questions, please check that both Immersion and DialogueUI are properly installed and enabled. The addon requires both dependencies to function correctly.

Immersion and Dialogue UI Bridge