Pedrolust
# PedroLust
**PedroLust** brings the iconic spinning Pedro raccoon animation and music to World of Warcraft whenever a Bloodlust / Heroism effect is active on you! Built as a lightweight, standalone addon for **Retail (Midnight 12.1.x)**.
---
## ✨ Features
- **Automatic Lust Detection:** Automatically triggers on **Bloodlust**, **Heroism**, **Time Warp**, **Primal Rage**, **Fury of the Aspects**, **Harrier's Cry**, and **Drums** (including combat-safe Sated/Exhaustion lockout detection for Retail 12.x).
- **Smooth Sprite Animation:** 64-frame spinning raccoon animation synced to the 40-second Lust duration.
- **Live Countdown Timer:** Displays the active spell name and remaining duration (`MM:SS`).
- **Audio Playback:** Plays the Pedro music track while Lust is active and automatically stops the music if the buff ends early.
- **Customizable UI:** Resize the frame, toggle circular mask clipping, hide/show text, and drag it anywhere on your screen.
---
## 🎮 How to Use & Interact
### Opening the Settings Menu
You can open the **PedroLust** configuration window in three ways:
1. Type `/pedro` or `/pedrolust` in chat.
2. Click **PedroLust** inside the **Addon Compartment** menu (the small dropdown button near your minimap calendar/clock).
3. Open **Game Menu (ESC) → Options → AddOns → PedroLust → Open PedroLust Settings**.
### Moving & Customizing the Display
- **Move the Frame:** Open `/pedro` and uncheck **Lock frame position** (or type `/pedro lock`), then **Left-Click and Drag** the Pedro circle anywhere on your screen. Re-check **Lock frame position** when done so you don't accidentally click it in combat.
- **Resize:** Use the **Size** slider in `/pedro` to scale the animation from `64px` up to `512px`.
- **Test Mode:** Click **Test (40s)** in `/pedro` (or type `/pedro test`) to preview the full 40-second animation and audio out of combat. Click **Stop** (or type `/pedro stop`) to end the preview immediately.
### Slash Commands
| Command | Action |
| :--- | :--- |
| `/pedro` | Open or close the settings window |
| `/pedro test` | Trigger a 40-second test animation + audio |
| `/pedro stop` | Stop the active animation and audio immediately |
| `/pedro lock` | Toggle frame lock (unlock to drag with your mouse) |
| `/pedro reset` | Reset all settings and position back to default |
---
## 🎵 How to Change the Audio File
Want to use your own custom song when Lust pops? You can easily swap the audio file without editing any code:
1. Prepare your custom audio file in **`.mp3`** (or `.ogg`) format (around 40 seconds long works best).
2. Rename your audio file to:
`pedrolust.mp3`
3. Navigate to your World of Warcraft AddOns folder:
`World of Warcraft\_retail_\Interface\AddOns\PedroLust\media\`
4. Replace the existing `pedrolust.mp3` file with your new `pedrolust.mp3`.
5. *(Important)* **Completely close and restart World of Warcraft** (WoW caches media files on launch; a simple `/reload` will not load a newly replaced audio file until the game client restarts).
6. Log in and type `/pedro test` to hear your new track!
*(Advanced: If you want to keep a different filename or `.ogg` extension, open `/pedro` in-game, edit the **Sound path** box to match your file path, press **Enter**, and click **Test Sound**.)*
---
## 📋 Credits
- Addon by **bzmhd**
- Inspired by the original Pedro WeakAura concept
Pedrolust Team
