## Description

**DynamicBar** is a smart consumable action bar for TBC Classic that automatically shows the right items at the right time.

### How It Works

DynamicBar creates a single action bar with 12 slots, each dedicated to a specific consumable category. The bar automatically:

- **Shows your best available item** in each slot (highest-level health potion you have, best food, etc.)

- **Reveals alternatives on hover** - mouse over a slot to see all items you have for that category

- **Hides prep-only items during combat** - elixirs, flasks, food, and drink buttons are cleared when combat starts (no accidental buff food clicks mid-fight)

- **Fades depleted items** - when you use your last potion, the button fades to show it's empty

### The 12 Slots

|------|----------|---------|-------|

| 1 | Health Potion | ✓ | Shows best healing potion |

| 2 | Mana Potion | ✓ | Shows best mana potion |

| 3 | Rejuv Potion | ✓ | Dual health+mana pots |

| 4 | Healthstone | ✓ | Warlock stones |

| 5 | Bandage | ✓ | First aid |

| 11 | Utility | ✓ | Limited Invulnerability Potion, etc. |

| 12 | Hearthstone | ✓ | Always available |

### Flyout System

**Hover over any slot** to see a flyout with all matching items in your bags. Items are sorted by quality/level with the best at the bottom (closest to your cursor).

Example: Hover over Health Potion slot → see all your healing potions from best to worst.

---

## Features

### Smart Display Modes

Choose how empty slots behave:

- **Smart (Default)** - Empty buttons are hidden but keep their position. Your keybinds stay stable.

- **Static** - All 12 slots always visible, even when empty. Keybinds stable.

- **Dynamic** - Bar auto-sizes to only show available items. **Warning:** This mode shifts button positions, which breaks keybinds.

### Combat Safety

- Prep-only slots (elixirs, flasks, food, drink) are **completely cleared** during combat

- Keybinds on cleared slots do nothing - no risk of wasting buff food mid-fight

- Items fade when depleted so you know at a glance what's empty

### Customization

- Adjust button count (1-12)

- Change button size

- Choose button skin (Blizzard default or Minimal)

- Lock/unlock bar position

- Show/hide tooltip on item hover

---

## FAQ

### Q: Do my keybinds follow the items or the button positions?

**A: Keybinds follow button positions.** If you bind "E" to button slot 1, it will always activate whatever is in slot 1 (Health Potion category), regardless of which specific potion is shown.

This is intentional - your muscle memory stays consistent. "E" always means "use a health potion."

### Q: Why did my elixir buttons disappear during a fight?

**A: This is by design.** Elixirs, flasks, food, and drink are "prep-only" items. During combat:

- These buttons are cleared (no icon shown)

- Keybinds on these slots do nothing

- This prevents accidentally using buff food/elixirs mid-combat

The buttons return when you leave combat.

### Q: How do I see all my potions, not just the "best" one?

**A: Hover over the slot.** A flyout menu appears showing all items you have in that category. Click the one you want to use.

### Q: What does "Smart" display mode do?

**A: Smart mode hides empty buttons while keeping keybinds stable.**

- If you have no mana potions, the mana potion slot is hidden

- But slot 3 (Rejuv Potion) is still in position 3 on the bar

- Your keybind for slot 3 still works

Compare to "Dynamic" mode which removes empty slots entirely and shifts everything - this breaks keybinds.

### Q: Why does a button turn faded/grey?

**A: You ran out of that item during combat.** The macro still exists (can't change secure buttons in combat) but the button fades to show the item is depleted.

### Q: Can I reorder the slots?

**A: Not in v0.6.5.** Slot order is fixed by design to keep keybinds predictable. Custom ordering is planned for a future version.

### Q: Why English only?

**A: Item classification relies on tooltip parsing.** The addon reads tooltip text to categorize items (e.g., detecting "Battle Elixir" vs "Guardian Elixir"). This only works with English-language game clients currently.

Localization is planned for a future version.

### Q: The bar is stuck and I can't move it!

**A: The bar is locked.** Type `/db` or `/dynamicbar` to open settings, then uncheck "Lock Bar Position" to move it.

### Q: How do I open the settings?

**A: Type `/db` or `/dynamicbar` in chat.**