# 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.
  
---
## 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.
The SequenGladius Team
