# Devourer Rotation Helper

A World of Warcraft addon that displays the Devourer Demon Hunter ability rotation sequence on screen with Blizzard-style action button UI.

![Version](https://img.shields.io/badge/version-1.0.0-blue) ![WoW](https://img.shields.io/badge/WoW-12.0.1-orange)

## Features

✨ **Professional UI Design**
- Blizzard action button style with proper borders and masks
- Clean, modern interface with dark theme
- Smooth icon highlighting on hover
- Step numbers on each ability

🎮 **Rotation Display**
- All 21 steps of the Devourer opener sequence
- Color-coded abilities by type
- Detailed tooltips with ability names and notes
- Proper spell icons with FileDataIDs

⚙️ **Customization**
- Draggable frame positioning
- Lock/unlock interface
- Adjustable icon size (32-64px)
- Adjustable frame scale (0.5-2.0x)
- Persistent settings across sessions

## Installation

1. **Download** the addon
2. **Extract** the `DevourerRotationHelper` folder
3. **Move** it to your WoW AddOns directory:
   ```
   World of Warcraft\_retail_\Interface\AddOns\
   ```
4. **Restart** WoW or type `/reload` in-game

## Usage

### Slash Commands

All commands can use either `/drh` or `/devourerhelper`:

| Command | Description |
|---------|-------------|
| `/drh` | Show command list |
| `/drh show` | Show the rotation frame |
| `/drh hide` | Hide the rotation frame |
| `/drh toggle` | Toggle frame visibility |
| `/drh lock` | Lock the frame in place |
| `/drh unlock` | Unlock for repositioning |
| `/drh reset` | Reset all settings to defaults |
| `/drh size [32-64]` | Set icon size (e.g., `/drh size 48`) |
| `/drh scale [0.5-2.0]` | Set frame scale (e.g., `/drh scale 1.2`) |

### Moving the Frame

1. Type `/drh unlock` to unlock the frame
2. Click and drag the frame to your desired position
3. Type `/drh lock` to lock it in place

## Rotation Sequence

The addon displays the following 21-step Devourer rotation:

| Step | Ability | Notes |
|------|---------|-------|
| 1 | **Consume** | Precast so it hits as you pull |
| 2 | **Consume** | Cast until 46 Soul Fragments |
| 3 | **Reap** | |
| 4 | **Voidblade** | |
| 5 | **The Hunt** | |
| 6 | **Void Metamorphosis** | |
| 7 | **Cull** | |
| 8 | **Void Ray** | |
| 9 | **Cull** | |
| 10 | **Reaper's Toll** | |
| 11 | **Cull** | |
| 12 | **Vengeful Retreat** | |
| 13 | **Pierce the Veil** | |
| 14 | **Reaper's Toll** | |
| 15 | **Vengeful Retreat** | |
| 16 | **Predator's Wake** | |
| 17 | **Reaper's Toll** | |
| 18 | **Cull** | |
| 19 | **Vengeful Retreat** | |
| 20 | **Devour** | |
| 21 | — | Continue with normal priority |

## Configuration

The addon saves the following settings:

- **Position**: Frame location on screen
- **Lock State**: Whether frame is locked or movable
- **Icon Size**: Size of ability icons (default: 44px)
- **Frame Scale**: Overall scale multiplier (default: 1.0)
- **Visibility**: Whether frame is shown or hidden
- **Step Numbers**: Toggle step number display
- **Tooltips**: Toggle ability tooltips

## Updating Spell IDs

Since Devourer is still in beta/development, some spell IDs are set to 0 as placeholders. Once Midnight launches:

1. Open `Core.lua` in a text editor
2. Find the `DRH.SpellData` table (around line 15)
3. Update the `spellID` fields with correct values from Wowhead
4. Save and `/reload` in-game

### Finding Spell IDs

**From Wowhead:**
1. Search for the ability on Wowhead.com
2. Look at the URL: `wowhead.com/spell=XXXXXX/ability-name`
3. The number `XXXXXX` is the spell ID

**In-Game:**
```lua
/dump C_Spell.GetSpellInfo("Ability Name")
```

### Icon FileDataIDs

The addon uses FileDataIDs for icons, which are more stable than spell IDs:
- Current icons are placeholders using similar existing abilities
- These will work but may not be exact until Midnight launches
- You can find updated FileDataIDs on Wowhead or using texture addons

## Technical Details

**Based on JustAC template structure:**
- Clean, modular code organization
- Proper event handling and frame management
- Blizzard API integration for authentic UI
- SavedVariables for persistent configuration

**UI Components:**
- Action button style frames with proper texture layers
- Icon masking for rounded corners
- Cooldown frame support (ready for future features)
- Tooltip integration with GameTooltip

## Compatibility

- **WoW Version**: 12.0.1+ (Midnight Pre-Patch)
- **Class**: Demon Hunter (Devourer spec)
- **Dependencies**: None (standalone addon)

## Troubleshooting

**Frame not appearing?**
- Type `/drh show` to make sure it's enabled
- Check if it's off-screen: `/drh reset`

**Can't move the frame?**
- Type `/drh unlock` first
- Make sure you're not in combat

**Icons look wrong?**
- Icons will be placeholders until Midnight launches
- Update spell IDs and FileDataIDs once available

**Settings not saving?**
- Check that `DevourerRotationHelperDB` exists in your SavedVariables
- Try `/drh reset` to reinitialize

## Credits

- **Template**: Based on JustAC addon structure by wealdly
- **Rotation**: Devourer guide from Wowhead/community
- **Icons**: Blizzard Entertainment

## License

Free to use and modify for personal use.

## Support

For issues, suggestions, or updates:
- Check for new versions when Midnight launches
- Update spell IDs as they become available
- Join the WoW addon community for help

---

**Version History:**
- **1.0.0** - Initial release (Pre-Midnight)
  - Full rotation sequence display
  - Blizzard-style UI
  - Draggable, lockable interface
  - Customizable sizing and scaling
