Forever Raid Frames

# Forever Raid Frames
**Custom Raid & Party Frames for WoW: Forever**

Forever Raid Frames is a free, lightweight replacement for party and raid frames, built for World of Warcraft: Forever. It's clean, readable and easy to set up, with useful extras for healers.

> ⚠️ **Alpha release:** this is an early test build. Please report anything that breaks (see *Feedback* below).

---

## Why Forever Raid Frames?
- **Readable at a glance:** class-colored health, names, power bars, role icons, and clear Dead, Ghost and Offline states
- **Built for healers:** your own HoT and shield indicators, debuff icons, a dispel highlight, and optional click-casting
- **Fits your screen:** adjust size, spacing, group layout, orientation, scale and position
- **Safe in combat:** follows Forever's combat rules, so changes you make mid-fight wait until combat ends instead of causing errors

---

## Features

### 🛡️ Party & Raid Frames
- Party (you plus up to 4) and raids of up to 40, sorted by raid group
- Class colors, names, power bars, and tank and healer role icons
- Absorb shield bar (when the game provides absorb data)
- Out-of-range players fade

### ✨ Healer Tools
- Corner indicators for **your own** heals-over-time and shields
  - **Priest:** Renew, Power Word: Shield, Weakened Soul
  - **Druid:** Rejuvenation, Regrowth
- Up to 5 debuff icons, or only the debuffs you can dispel
- Colored dispel border for Magic, Curse, Disease and Poison
- Optional health-deficit number

### 🖱️ Click-Casting
- Bind any mouse button, with Shift, Ctrl or Alt, to a spell, to targeting, or to the unit menu
- Default: left-click targets, right-click opens the menu
- The **Healer Pro** preset sets up heals for Priest, Druid, Paladin and Shaman
- Example: `/ff bind shift-left Greater Heal`

### 🎨 Presets
- **Compact Grid:** small, tidy tiles for big raids
- **Healer Pro:** bigger frames, power bars, deficit text and click-cast heals for your class
- **Minimal Dark:** dark bars with class-colored missing health

### ⚙️ Setup Tools
- Settings window (`/ff`), also listed in the game's AddOns settings
- **Test mode** with 1–40 sample players (`/ff test 20`), so you can set up while solo
- Lock and unlock to drag the frames
- **Profiles:** per character, with create, switch, copy, delete and reset

---

## Installation
1. Install with the CurseForge app, or unzip into `World of Warcraft/_forever_/Interface/AddOns/`
2. Fully restart the game
3. Type `/ff`

## Slash Commands
| Command | What it does |
|---|---|
| `/ff` | Open settings |
| `/ff help` | List all commands |
| `/ff test [1-40\|off]` | Show sample players |
| `/ff unlock` / `/ff lock` | Move the frames |
| `/ff preset compact\|healer\|minimal` | Apply a preset |
| `/ff set width 90` | Change a size setting |
| `/ff toggle darkmode` | Turn an option on or off |
| `/ff bind <click> <spell>` | Set a click-cast binding |
| `/ff binds` | List your bindings |
| `/ff profile list\|use\|copy\|delete\|reset` | Manage profiles |
| `/ff debug` | Info for bug reports |

`/foreverframes` works too.

---

## Supported Game Versions
- **World of Warcraft: Forever** only. Not built for Retail, Classic Era or Anniversary.

## Known Limitations
- Forever hides some combat information from addons. Health and power bars stay live, but some details may pause until combat ends: aura indicators, the dispel border, and the deficit number.
- Layout and binding changes made during combat apply when combat ends. This is a game rule.
- Blizzard's own raid frames aren't hidden automatically. You can turn them off in the game's settings.
- No heal-prediction bar yet. English spell names only.

## Troubleshooting
- **Nothing shows when solo?** That's normal. Try `/ff test` or `/ff toggle solo on`.
- **Can't move the frames?** Use `/ff unlock`, out of combat.
- **A click doesn't cast?** Check `/ff binds`. The spell name must match your spellbook exactly.
- **Marked "out of date"?** Tick *Load out of date AddOns* at character select, and let us know.

## Feedback & Bug Reports
Leave a comment with:
- your `/ff debug` output
- the full Lua error (BugSack helps)
- what you were doing when it happened
- your other addons

## Roadmap (planned, not yet available)
- Heal-prediction bar
- Custom indicator lists per class
- Sort raids by role
- Pet frames
- More languages

---

## Credits & License
Made by **ForeverForge**. Free forever, with no ads and no premium features.
Licensed under **MIT**. ForeverFrames is a fan project, not affiliated with or endorsed by Blizzard Entertainment.