# Bear Alert — World of Warcraft Retail 12.x Addon

Displays a **visual and sound alert** whenever a **Guardian Druid (Tank)**
enters combat outside of **Bear Form**.

---

## How it works

The alert triggers automatically when **all** of the following conditions are true:

| Condition | Check |
|---|---|
| Class | Druid |
| Specialization | Guardian (Tank) |
| In combat | Yes |
| Bear Form active | **No** |

The alert stops automatically when:
- Bear Form is activated
- Combat ends
- Specialization is changed

---

## Installation

1. Copy the `BearAlert` folder to:
   ```
   World of Warcraft/_retail_/Interface/AddOns/
   ```
2. Restart the game or reload the UI (`/reload`).
3. Make sure the addon is **enabled** on the character selection screen.

---

## Settings

Type `/bearalert` or `/ba` in chat, or click the bear icon on the minimap, to open the settings panel.

Also available under **Esc > Options > AddOns > Bear Alert**.

### Text

- **Alert text** — customize the displayed message
- **Font size** — from 10 to 72 px
- **Text color** — color picker with live preview
- **Font** — choose from 11 built-in fonts:
  - Archivo Black, Arial Narrow, Bitcount Grid, Expressway, Fascinate,
    Friz Quadrata (default), Morpheus, Open Sans, Playwrite Ireland, Roboto, Skurri
- **Pulse animation** — fade effect on the text
- **Position (X / Y)** — enter coordinates manually or drag the text on screen

### Sound

- **Sound alert** — enable/disable
- **Sound** — choose from 6 built-in sounds:
  - Bear Aggro, Bell, Raid Warning, WereBear Attack, WereBear Attack Crit, WereBear Wound
- **Sound interval** — 1 to 10 seconds between each playback

### Moving the alert

With the settings panel **open**, drag the alert text freely across the screen.
The position is saved automatically and persists between sessions.
Use the **Reset Position** button to restore the default position (1/4 from the top of the screen).

---

## Chat commands

| Command | Action |
|---|---|
| `/bearalert` or `/ba` | Open settings |
| `/ba test` | Show alert for 5 seconds |
| `/ba stop` | Hide alert manually |
| `/ba reset` | Reset all settings and reload the UI |

---

## LibSharedMedia-3.0 (optional)

If the **SharedMedia** addon (or any addon that registers fonts via LibSharedMedia-3.0) is
installed, the extra fonts will appear automatically in Bear Alert's font list,
sorted together with the built-in fonts.

---

## Compatibility

- **Interface:** 120001 (WoW Retail 12.x)
- **Class:** Druid — Guardian (Spec ID 104)
- **Bear Form detection:** via Spell ID 5487

---

## Localization

The addon is translated into the following languages:

| Locale | Language |
|---|---|
| enUS | English (default) |
| ptBR | Português do Brasil |
| esES / esMX | Español |
| frFR | Français |
| zhTW | 繁體中文 |
| zhCN | 简体中文 |

---

## File structure

```
BearAlert/
├── BearAlert.toc
├── BearAlert.lua
├── lib/
│   ├── LibStub.lua
│   ├── CallbackHandler-1.0.lua
│   ├── LibDataBroker-1.1.lua
│   └── LibDBIcon-1.0.lua
├── locales/
│   ├── enUS.lua
│   ├── ptBR.lua
│   ├── esES.lua
│   ├── frFR.lua
│   ├── zhTW.lua
│   └── zhCN.lua
└── media/
    ├── fonts/   ← built-in fonts
    └── img/     ← minimap icon
```
