Skip to content

Chibionos/TankBars

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

25 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

TankBars

GitHub release CurseForge License

A clean and satisfying World of Warcraft addon for tanks that displays health and absorb shields in a vertical bar format with advanced tank-specific features.

Features

Core Features

  • Vertical Health Bar: Clean vertical display of your health
  • Absorb Shield Tracking: Visual representation of all absorb shields with numbers
  • Percentage Markers: Visual markers at 10%, 20%, and 30% health thresholds
  • Damage Projection: Shows predicted incoming damage based on recent history
  • Smooth Animations: Satisfying smooth transitions for health and shield changes

Advanced Tank Features

  • Threat Indicator: Real-time threat monitoring with color-coded bar
  • Off-Tank Display: Automatic detection and display of other tanks in your group
  • Boss Ability Prediction: Integration with DBM/BigWigs for incoming damage warnings
  • Low Health Warning: Pulsing red glow and skull icon when health drops below threshold

Installation

CurseForge Client (Recommended)

  1. Search for "TankBars" in the CurseForge client
  2. Click Install

Manual Installation

  1. Download the latest release from Releases
  2. Extract the TankBars folder
  3. Copy it to your WoW addons directory:
    • Retail: World of Warcraft\_retail_\Interface\AddOns\
    • Classic: World of Warcraft\_classic_\Interface\AddOns\
  4. Restart WoW or type /reload if already in-game

Configuration

Interface Options

Access the configuration through:

  • System Menu: ESC โ†’ Options โ†’ Addons โ†’ TankBars
  • Slash Command: /tbh config

Quick Commands

  • /tbh or /tankbar - Show help menu
  • /tbh lock - Lock the frame position
  • /tbh unlock - Unlock to move the frame
  • /tbh reset - Reset all settings to default

Screenshots

Tank Bar Helper Main Display Main health and shield bars with threat indicator

Boss Ability Warning Boss ability prediction with damage warning

Development

Building from Source

git clone https://github.com/Chibionos/TankBars.git
cd TankBars
# The TankBars folder contains the addon

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Release Process

This addon uses GitHub Actions for automated releases to:

  • GitHub Releases
  • CurseForge
  • Wago.io (optional)

Releases are triggered by pushing version tags (e.g., v1.1.0).

Support

For issues, suggestions, or questions:

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • Thanks to the WoW addon community for inspiration
  • BigWigsMods for the packaging tools
  • All contributors and testers

Version History

See CHANGELOG.md for a detailed version history.

๐Ÿ›ก๏ธ The Ultimate Tank Awareness Addon for World of Warcraft

Tank Bar Helper is a clean, minimalist addon designed specifically for tanks who need instant visual feedback on their survivability. With its innovative damage projection system and intuitive dual-bar display, you'll always stay one step ahead of incoming damage.

โœจ Key Features

Dual Vertical Bar System

  • Health Bar - Vibrant green bar showing your current health
  • Shield Bar - Bright blue bar displaying total absorb shields
  • Real-time value displays with percentages below each bar
  • Smooth animations for satisfying visual feedback

๐Ÿ”ฎ Advanced Damage Projection

Our unique damage projection system analyzes incoming damage patterns and shows you exactly where your health will be in 5 seconds:

  • Orange/Red projection bar rising from the bottom of your health bar
  • 5-second lookahead with 20% safety buffer
  • Dynamic color coding:
    • ๐ŸŸก Yellow-orange: Safe (>40% projected health)
    • ๐ŸŸ  Orange: Warning (20-40% projected health)
    • ๐Ÿ”ด Red: Danger (<20% projected health)
  • Helps you proactively use defensives before it's too late

๐Ÿ’€ Low Health Warning

  • Animated skull icon with pulsing red circle at 40% health
  • Non-intrusive - only the skull animates, not the bars
  • Impossible to miss when you're in danger

๐ŸŽฏ Clean & Focused Design

  • No unnecessary animations or distractions
  • Compact vertical layout perfect for tank positioning
  • Moveable and lockable frame
  • Customizable through simple slash commands

๐Ÿ“ฆ Installation

  1. Download the TankBarHelper folder
  2. Copy to your WoW AddOns directory:
    • Retail: World of Warcraft\_retail_\Interface\AddOns\
    • Classic: World of Warcraft\_classic_\Interface\AddOns\
  3. Restart WoW or type /reload

๐ŸŽฎ Commands

Command Description
/tbh or /tankbar Show help menu
/tbh lock Lock frame position
/tbh unlock Unlock to drag and reposition
/tbh config Open configuration panel
/tbh scale [0.5-2.0] Adjust size
/tbh width [20-100] Set bar width
/tbh height [100-500] Set bar height
/tbh reset Reset to defaults

๐Ÿš€ How It Helps You Tank Better

Proactive Defensive Usage

The damage projection bar shows you exactly when to use defensives. If you see the orange bar growing, you know damage is ramping up and it's time to mitigate.

Health Management

Keep your actual health bar above the orange projection bar to ensure survival for the next 5 seconds. The built-in safety buffer gives you room for unexpected spike damage.

Healer Communication

Large projection bar? Call for externals. Your healers will appreciate the heads-up before you're actually in danger.

Threat Awareness

Clean, uncluttered design keeps your focus on the fight while providing critical information at a glance.

๐ŸŽจ Visual Features

  • Smart Color System: Health bar (green), Shield bar (blue), Projection (orange-red gradient)
  • Vertical Orientation: Space-efficient design perfect for UI layouts
  • Real-time Updates: Instant response to health and shield changes
  • Professional Polish: Smooth transitions and clean aesthetics

๐Ÿ’ก Pro Tips

  1. Position near your character for peripheral vision monitoring
  2. Watch the projection bar during pull - it learns damage patterns in 5 seconds
  3. Use the skull warning as your emergency cooldown trigger
  4. Monitor shield values to track healer absorbs and your own mitigation

๐Ÿ”ง Advanced Features

  • Damage History Tracking: Analyzes last 5 seconds of incoming damage
  • Intelligent Projection: Calculates average DPS with safety multiplier
  • Performance Optimized: Lightweight with no FPS impact
  • Error Resilient: Comprehensive error handling prevents crashes

๐Ÿ“Š What The Bars Tell You

Visual Indicator Meaning
Green Bar Height Your current health
Blue Bar Height Active absorb shields
Orange Bar Height Projected damage in next 5 seconds
Numbers Below Exact values and percentages
Skull Icon Emergency warning at 40% health

๐ŸŽฏ Perfect For

  • Raid Tanks: Manage tank swaps and cooldowns effectively
  • M+ Tanks: Handle large pulls with confidence
  • PvP Tanks: Track burst damage and respond quickly
  • New Tanks: Learn damage patterns and improve survivability

๐Ÿ“ Version History

v1.0.0

  • Initial release with dual-bar system
  • Advanced damage projection algorithm
  • Low health warning system
  • Full configuration options
  • Smooth animations and visual polish

๐Ÿ‘จโ€๐Ÿ’ป Author

Created by DarthChibi

Designed with love for the tanking community. Stay alive, stay aware, and most importantly - stay ahead of the damage!


"The best tanks don't react to damage - they anticipate it." - Tank Bar Helper

About

Light weight tanking health bars for Health and Shields for World of Warcraft

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages