BetterTargetHud

BetterTargetHud (BTH) /bth

1. Introduction & Reason for Development

BetterTargetHud (BTH) is a high-fidelity, lightweight Target HUD designed to provide critical combat information directly on the player's target frame. Built from the ground up in the World of Warcraft 12.0 Midnight environment, it prioritizes "Zero Taint" performance and crash-proof stability while offering deep visual customization.

This project was born out of necessity following the discontinuation of WeakAuras, which left a massive void in the UI customization landscape. Specifically, the loss of complex, script-heavy HUD WeakAuras forced the community to seek a dedicated, standalone solution. By utilizing dynamic resource bars and reactive combat text without the overhead of a legacy framework, BTH reclaims that lost functionality. It is engineered to be a native, optimized replacement for the HUD setups players relied on for over a decade, providing top-notch UX without the strain on the game client.

2. Key Definitions

• Zero-Taint Engineering: A design philosophy strict to BTH that entirely avoids manipulating 12.0 "Secret Values" (restricted API data) in Lua, ensuring the addon never throws a combat lockdown error or freezes the UI.

• Opaque Payload Router: The custom-built engine handling debuff tracking. Instead of reading restricted spell names, it securely funnels raw visual data directly into native Blizzard C++ frames.

• Stack Manager: An intelligent parent-child anchoring framework that provides the spatial logic for the HUD. Rather than forcing restrictive anti-clipping rails, it empowers users with precise X/Y offset controls and dynamic routing (Inside, Outside, Above, Below) to construct their own pixel-perfect 2D visual hierarchy.

• Snapshot Memory Core: The backend database structure that saves layout parameters into distinct profiles, allowing the HUD to seamlessly reconstruct itself on the fly without a loading screen.

3. The Zero-Taint Debuff Tracker

Navigating the 12.0 Midnight API requires bypassing aggressive restrictions on aura data. BTH features a bulletproof, user-defined tracker that entirely sidesteps "Secret Value" crashes.

• Sequential Slot Logic: Users simply enable up to 8 tracking slots and place them on the canvas. During combat, the Opaque Router automatically catches player-cast debuffs and feeds them into the active slots from left to right.

• Native C-Side Timers: To prevent Lua math errors when calculating pandemic windows or expiration times, BTH hands the Opaque durationObject directly to Blizzard’s native secure UI engine, ensuring frame-perfect, taint-free cooldown wipes and text timers.

• Live Configuration Previews: When the options menu is open, the engine intelligently drops out of combat-scanning mode and projects live dummy icons onto the screen, allowing players to perfectly align their borders, fonts, and spacing before ever pulling a boss.

4. Next-Gen Class Power Engine

A robust, custom-built resource tracker that automatically adapts to every specialization in the game. BTH goes beyond standard combo points, featuring unique geometry for complex modern mechanics:

• The River of Souls (Demon Hunter): A specialized visualizer designed to track the flow of Void Metamorphosis and Soul Fragments.

• Stagger Mechanics (Monk): A fully restored dynamic Stagger Bar that utilizes intelligent threshold coloring to indicate damage delay severity.

• Adaptive Spacing: Built-in logic that automatically adjusts pixel spacing depending on the active class (e.g., flush layouts for Paladin Holy Power vs. spaced layouts for Rogue Combo Points).

5. Modular Architecture & Granular Control

Every element of BTH is designed to be decoupled and repositioned at will. The engine utilizes an intelligent parent-child anchoring system, but it does not restrict user freedom with forced anti-clipping rails.

• Pixel-Perfect Customization: Because a 2D interface can easily become cluttered, BTH provides granular X/Y offset controls, scaling, and dynamic anchor routing (Inside, Outside, Above, Below) for every module. This empowers users to manually construct a clean, overlapping-free layout tailored exactly to their spatial preferences.

• Dynamic Debuff Canvas: Exercise complete spatial authority over the debuff tracking widgets. Users can dictate specific X/Y coordinate offsets for each active slot, scale icon sizes, toggle crisp 1-pixel borders, and adjust custom font properties without globally affecting the rest of the HUD.

• Class Power Spatial Tuning: The Class Power resource engine features fully unlocked anchor routing, allowing users to define exactly where combo points or holy power generate (e.g., tethered to the health bar or cast bar), along with granular sliders to manipulate the exact pixel spacing between each individual resource point.

• Advanced Text Elements: Complete control over health, power, and name formatting with an integrated "Tag Injector" for effortless text customization without needing to write custom Lua strings.

6. Intelligent Style System & Automation

BTH ships with three distinct visual themes out of the box: Standard, Sexy, and Souls (a heavy, immersive dark-fantasy layout).

• Zone Automation: An integrated automation module detects your current instance type (Raid, PvP, Dungeon, or Open World) and instantly triggers the Snapshot Memory Core to swap to your designated layout.

• AceDB Profile Management: Maintain character-specific settings, allowing users to build hyper-specific HUD layouts for Tanking, Healing, and DPS roles.

7. Open Development

This addon is currently in open development by a single author. Community feedback is the lifeblood of this project; any requests for additions, feature tweaks, or new class modules are highly encouraged and will be implemented as able to ensure the tool evolves with the player base.

A Tribute to WeakAuras: For years, WeakAuras stood as the absolute pinnacle of interface customization, empowering millions of players to visualize the game in ways the developers never imagined. We offer our deepest gratitude to the WeakAuras team for lighting the path; your legacy is the foundation upon which all modern UI design is built.