# SequenGladius

**Lightweight arena enemy frames for WoW TBC Anniversary (2.5.5)**

A pure-Lua, zero-dependency arena addon built specifically for TBC Anniversary's modern engine. No libraries, no XML — just one `.lua` file.

![Version](https://img.shields.io/badge/version-1.3.1-green) ![Interface](https://img.shields.io/badge/interface-20505-blue) ![TBC Anniversary](https://img.shields.io/badge/TBC-Anniversary-orange)

---

## Features

### Arena Enemy Frames

- **Health & mana bars** with class-colored names and percentage display

- **Cast bar** overlay (no frame jumping) with spell icon, name, and timer

- **Trinket tracker** — 120s cooldown with visual overlay and countdown

- **Spec detection** — identifies all 27 specs via talent spell recognition (232 spell IDs)

- **Diminishing Returns** — tracks 14 DR categories with color-coded borders (green → yellow → red → immune)

- Supports 2v2, 3v3, and 5v5

- Stealth/invis handling with 50% alpha and periodic scan

- Pre-arena spec detection via `GetArenaOpponentSpec` API

- Draggable anchor, scalable (0.5x–2.0x), grow up or down

### Shadow Sight (Eye) Timer

- Countdown starts when arena gates open (not on zone-in)

- Resets automatically when any player picks up the orb

- Color-coded bar: purple → orange → red → green "SPAWNED!"

- Draggable, position saved

### Incoming CC Alert

- Detects incoming crowd control casts **targeting you** (works everywhere, not just arena)

- Shows cast bar with spell icon, spell name, caster name, and timer

- Supports ~50 CC spells: Polymorph, Fear, Cyclone, HoJ, Blind, Sap, Repentance, and more

- Sound notification on incoming CC

- Draggable, lockable, scalable

### Party Alerts (Arena)

- **Left Combat alert** — sends `/party` message when enemy drops combat

- **Drinking alert** — sends `/party` message when enemy starts drinking

### Raid Markers

- Auto-mark party members on arena enter (Star, Circle, Diamond, Triangle, Moon)

- Manual set/clear commands

### Nameplate Class Icons

- Shows class icons above friendly party members' nameplates

- Uses the standard WoW class icon atlas (same as character creation screen)

- Class-colored border

- Adjustable size and offset

---

## Installation

1. Download and extract the ZIP

2. Copy the `SequenGladius` folder to:

```

World of Warcraft/_anniversary_/Interface/AddOns/SequenGladius/

```

3. Restart WoW or `/reload`

---

## Slash Commands

**`/sg`** or **`/gladius`**

| Command | Description |

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

| `/sg options` | Open settings panel (ESC → Options → AddOns) |

| `/sg show` | Show frames + anchor for positioning |

| `/sg test` [2\|3\|5] | Test mode |

| `/sg lock` | Lock position |

| `/sg unlock` | Unlock position |

| `/sg hide` | Hide all frames |

| `/sg scale <0.5-2.0>` | Set frame scale |

| `/sg grow` | Toggle grow direction (up/down) |

| `/sg castbar` | Toggle cast bar |

| `/sg trinket` | Toggle trinket tracker |

| `/sg dr` | Toggle diminishing returns |

| `/sg spec` | Toggle spec detection |

| `/sg eye` | Toggle Shadow Sight timer |

| `/sg eyetest` | Test eye timer |

| `/sg ooc` | Toggle left-combat alert |

| `/sg drink` | Toggle drinking alert |

| `/sg cc` | Toggle incoming CC alert |

| `/sg cctest` | Test CC alert |

| `/sg ccshow` | Show CC alert for positioning |

| `/sg cclock` / `ccunlock` | Lock/unlock CC alert |

| `/sg marks` | Set party raid marks |

| `/sg clearmarks` | Clear party marks |

| `/sg automarks` | Toggle auto-mark on arena enter |

| `/sg npmarks` | Toggle nameplate class icons |

| `/sg nptest` | Refresh nameplate marks |

---

## Settings Panel

Access via **ESC → Options → AddOns → SequenGladius** or `/sg options`

Three tabs:

- **Arena Frames** — Cast bar, Trinket, DR, Spec, Eye Timer, Scale, Grow direction

- **Alerts & Marks** — Party alerts, raid markers, nameplate icons with size/offset sliders

- **CC Alert** — Enable, scale, bar height, test/position controls

---

## TBC Anniversary Compatibility

Built for the Anniversary engine (2.5.5) which uses modern APIs under the hood:

- `CombatLogGetCurrentEventInfo()` ✓

- `C_NamePlate.GetNamePlateForUnit()` ✓

- `C_Timer.After()` ✓

- `C_Spell.GetSpellInfo()` with `GetSpellInfo` fallback ✓

- `GetArenaOpponentSpec` / `GetSpecializationInfoByID` ✓

- `BackdropTemplate` ✓

- `SetColorTexture` ✓

---

## FAQ

**Q: Frames don't show up in arena?**

A: Type `/sg show` to position them first, then `/sg lock`. Frames only appear for detected enemies in arena.

**Q: CC alert isn't working?**

A: Make sure it's enabled: `/sg cc`. Test with `/sg cctest`. The alert only triggers when an enemy casts CC while targeting you.

**Q: Nameplate icons are blank?**

A: Try `/sg nptest` to refresh. Icons use the built-in WoW class atlas which should work on all clients.

**Q: Can I use this alongside Gladius/GladiusEx?**

A: Yes, but you'll have two sets of arena frames. Disable one if they overlap.

---

## Author

**Sequen** — TBC Anniversary PvP enthusiast

---

## License

Free to use and modify. If you redistribute, please credit the original author.