Heavily Inspired by other addons like DjLust, and Built Using AI.

# 🎵 LustMix – Custom Animations & Music Guide

LustMix lets you personalize your Bloodlust/Heroism experience with **your own music** and **your own animations**.
Adding custom files is simple — just follow the steps below.

---

# 📁 Folder Structure

Your addon should contain these folders:

```
LustMix/
├─ Animations/
│ └─ *.tga (your custom animation sprite sheets)
├─ Music/
│ └─ *.mp3 (your custom music files)
├─ FileList.lua
├─ Settings.lua
├─ Music.lua
├─ Animation.lua
└─ ...
```

LustMix automatically loads files placed in:

- `LustMix/Animations/`
- `LustMix/Music/`

---

# 🎨 Adding Custom Animations

LustMix supports **TGA sprite sheets** for animations.

### ✔ Requirements
- File format: **.tga**
- Must be a **sprite sheet** (multiple frames arranged in a grid)
- Power‑of‑two dimensions recommended (512×512, 1024×1024, etc.)
- No compression
- 32‑bit TGA (with alpha) recommended

### ✔ How to add your animation

1. Place your `.tga` file into:

```
Interface/AddOns/LustMix/Animations/
```

2. Open `FileList.lua`.

3. Add your file name to the `CUSTOM_ANIMATIONS` table:

```lua
CUSTOM_ANIMATIONS = {
"LunaSnow.tga",
"SP_Guy.tga",
"MyCustomAnimation.tga", -- Add yours here
}
```

4. Save and **/reload** in-game.

Your animation will now appear in the LustMix settings dropdown.

---

# 🎵 Adding Custom Music

LustMix supports **MP3 files**, but WoW is strict about audio formatting.

### ✔ Requirements
- File format: **.mp3**
- Constant bitrate (CBR)
- 44.1 kHz
- Stereo
- No embedded album art
- ID3v2.3 tags (not v2.4)

### ✔ How to add your music

1. Place your `.mp3` file into:

```
Interface/AddOns/LustMix/Music/
```

2. Open `FileList.lua`.

3. Add your file name to the `CUSTOM_SONGS` table:

```lua
CUSTOM_SONGS = {
"LunaSnow.mp3",
"Running90s.mp3",
"MyCustomSong.mp3", -- Add yours here
}
```

4. Save and **/reload** in-game.

Your song will now appear in the LustMix settings dropdown.

---

# 🧪 Testing Your Files

Inside the LustMix settings:

- **Test Animation** previews your animation.
- **Test Music** plays your selected song.

Music playback includes:
- Fade‑in
- Preview duration timer
- Fade‑out

If nothing plays, check the troubleshooting section below.

---

# 🛠 Troubleshooting

### ❌ My MP3 doesn’t play
This is almost always a formatting issue.

Try exporting with **Audacity**:

```
File → Export → Export as MP3
Bitrate Mode: Constant
Quality: 192 kbps
Channel Mode: Stereo
ID3 Tags: v2.3
```

Or with **ffmpeg**:

```
ffmpeg -i input.mp3 -codec:a libmp3lame -b:a 192k -id3v2_version 3 output.mp3
```

### ❌ My animation doesn’t show
Check:
- File is `.tga`
- No compression
- Power‑of‑two dimensions
- Added to `CUSTOM_ANIMATIONS`
- UI reloaded

### ❌ My file doesn’t appear in the dropdown
Make sure:
- The filename matches exactly (case‑sensitive)
- No extra spaces
- You saved `FileList.lua`
- You reloaded the UI

---

# 🎯 Advanced Options

LustMix also supports:

- Custom animation FPS
- Custom animation size
- Fade‑in duration
- Fade‑out duration
- Preview duration
- Audio channel selection (Master, SFX, Dialog, etc.)
- Minimap button lock/unlock
- Debug mode

Explore the settings panel for full control.

---

# ❤️ Thanks for using LustMix!

If you create cool animations or music setups, feel free to share them with the community!