Camera Director v1.0.3
Part of the Ultima Suite • Dynamic Cinematic Camera & Perspective Suite for World of Warcraft (Retail & Midnight-Ready)
🌟 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.
Camera Director is an advanced, cinematic dynamic camera engine engineered specifically for World of Warcraft Retail (Patch 12.1.0 / Midnight, Interface 120100). Serving as our proprietary, zero-taint replacement for DynamicCam, Camera Director delivers silky-smooth mathematical easing (Ease-In/Out LERP interpolation) across all gameplay situations, completely eliminating the motion sickness, abrupt snapping, and CVar corruption commonly associated with legacy camera tools.
✨ Key Features
🎬 1. Mathematical LERP Interpolation & Horizontal Yaw Rotation
- Smooth Easing Curves: Transitions between perspectives use quadratic and cubic mathematical easing curves (
EaseInOutQuad) rather than harsh linear steps or abrupt snapping. - Cinematic Camera Rotation (Yaw): Smoothly rotates the camera horizontally (configurable from -90° to +90°). In dialogue, a default +45° swoop creates a filmic framing positioning both your character and the conversation partner centered side by side in the scene.
- Smart Auto-Return on Dialogue Exit: When leaving conversation, the camera smoothly swoops back to its neutral orientation and restores previous exploration zoom.
- Zero-Churn Runner: Interpolation frames automatically sleep upon reaching target positions, ensuring zero idle CPU cycles or memory allocation in hot loops.
- Anti-First-Person Safety Clamp: Strictly enforces a minimum safe third-person zoom floor (
2.8 yards) and clamps single-impulse adjustments to prevent runaway queue accumulation into first-person mode. - Dynamic Zoom Toggle (
manageZoom): Full player sovereignty — choose whether Camera Director manages zoom distance or leave distance 100% to manual mousewheel control while enjoying dynamic shoulder offset, headbob, and pitch.
⚔️ 2. Contextual 3-Way Combat Profiles
- World Combat (
COMBAT_WORLD, Priority 90): Immersive, cinematic over-the-shoulder perspective with natural sway for questing, world bosses, and open-world exploration. - Dungeon & Raid (
COMBAT_DUNGEON, Priority 91): Wide, centered perspective with maximum battlefield overview, zero sway, and high camera elevation for Mythic+, Raids, and Delves. - PvP Arena & Battlegrounds (
COMBAT_PVP, Priority 92): Centered tactical zoom with rapid transition curves and crystal-clear target tracking against opposing players in Arenas, Battlegrounds, or open-world skirmishes. - Seamless Context Switcher: Switch between combat profiles in 1 click in the Studio with dedicated sliders, preview buttons, and automatic game-state detection.
🎭 3. Intelligent Hierarchical Situation Engine
- Priority State Machine: Automatically evaluates contextual situations from highest to lowest priority:
- Dialogue (
100): Intimate framing during NPC conversations with +45° dual-character rotation and Dialogue Narrator synchronization. - PvP Combat (
92): Rapid response tactical view for Arenas, BGs, and PvP engagements. - Dungeon & Raid (
91): Wide tactical battlefield overview for instanced group content and Delves. - World Combat (
90): Action-focused combat for overland questing and rare hunting. - Stealth (
80): Tense, close-quarters immersive framing with automatic zoom restoration upon stealth exit. - Skyriding (
70): Wide cinematic vista with dynamic slope angling. - Mounted (
60): Elevated travel perspective. - Fishing (
50): Serene angling composition. - Indoors (
40): Cozy framing preventing wall clipping in taverns and dungeons. - Resting (
30): Atmospheric city and inn perspectives. - Exploration (
10): Balanced default world camera.
- Dialogue (
🛡️ 4. Safe CVar Guard & Instant Fail-Safe Reset
- Automatic Baseline Snapshot: Automatically archives the player's original Blizzard camera CVars upon initial login (
CameraDirectorDB.blizzardDefaults). - Instant Recovery: Type
/cd resetat any time to instantly restore factory Blizzard camera parameters without reloading your UI or restarting the game.
🔇 5. Automatic Visual Discomfort Warning Suppressor
- Seamless Login Experience: Automatically suppresses Blizzard's intrusive experimental camera warning popup (
EXPERIMENTAL_CVAR_WARNING) upon login and/reload. - Fail-Safe Protection: Neutralizes accidental Blizzard resets (
ResetTestCvars()), preserving your customized camera offsets and situation presets intact. - Configurable: Can be toggled on or off via the official Blizzard Settings panel (
/cd options).
🎛️ 6. Curated 1-Click Presets
- Action RPG: Immersive over-the-shoulder perspective with natural movement sway and dynamic terrain pitch.
- Mythic+ & Raid Pro: Clean, wide-angle tactical view with zero sway and maximum battlefield clarity.
- Cinematic Movie: Dramatic flight angles, cozy indoor compositions, and full situational dynamism.
- Blizzard Classic Enhanced: Standard centered camera enhanced by silky smooth zoom curves.
🏛️ 7. Two-Tier Navigation Studio
- Conforms strictly to the Ultima Dark Theme UI design standards with a 760x540 movable dialog.
- Features real-time sliders for shoulder offset, target zoom, dynamic pitch, head movement bob, and transition duration.
- Live Blizzard Camera CVars Inspector for transparent engine monitoring.
🌉 8. UltimaBridge Synergies
- Dialogue Narrator Handover: Automatically yields camera control to
DialogueNarratorduring NPC discussions to prevent conflicting camera movements.
⌨️ Slash Commands
| Command | Action |
|---|---|
/cd / /cameradirector / /vp |
Open the Camera Director Studio configuration window |
/cd reset |
Safely restore all Blizzard camera defaults |
/cd preset <name> |
Apply preset (ACTION_RPG, MYTHIC_PRO, CINEMATIC, CLASSIC) |
/cd toggle |
Toggle dynamic camera adjustments on or off |
/cd status |
Print current active situation and CVar values in chat |
🌐 Supported Languages
Full localization across all 10 official World of Warcraft client languages:
- 🇬🇧 English (
enUS) - 🇩🇪 German (
deDE) - 🇪🇸 Spanish (
esES/esMX) - 🇫🇷 French (
frFR) - 🇮🇹 Italian (
itIT) - 🇧🇷 Portuguese (
ptBR) - 🇷🇺 Russian (
ruRU) - 🇰🇷 Korean (
koKR) - 🇨🇳 Simplified Chinese (
zhCN) - 🇹🇼 Traditional Chinese (
zhTW)
📦 Installation
- Download the latest release.
- Extract into your World of Warcraft AddOns directory:
World of Warcraft\_retail_\Interface\AddOns\CameraDirector - Launch World of Warcraft and type
/cd(or/vp) to open the studio.
📜 Credits & License
Developed with ❤️ by **Satyros**. Designed for World of Warcraft Retail (Patch 12.1.0 / *Midnight*).
Licensed under the **MIT License**. Part of the **Ultima Suite**.
### Acknowledgements & Inspirations:
* Built for the **Ultima Suite** ecosystem (`UltimaBridge`).
* Special thanks to **DynamicCam** (*mpstark*) for pioneering dynamic situational camera perspectives and smooth zooming transitions in World of Warcraft.

