# Lifeweaver Forever

**Lifeweaver Forever** is a compact and customizable healing-frame addon designed for **World of Warcraft: Forever**.

It focuses on fast and clear healing in 5-player content while combining party frames, click-casting, healing information and dispel tools in one lightweight interface.

The goal is simple: give healers the information and controls they actually need without covering the screen with unnecessary UI elements.

---

## Features

### Healing Frames
- Compact party healing frames
- Class-colored health bars
- Optional class and role icons
- Adjustable frame width, height and spacing
- Adjustable player name and health text size/position
- Optional header above the healing frames
- Optional role sorting:
  **Tank → Healer → Damage**
- Optional hiding of Blizzard's default party frames
- Out-of-range players are automatically faded

### Health Display
Choose exactly what you want to see:

- Percentage
- Current / Maximum health
- Percentage + Current / Maximum health together
- Or hide health text completely

When both displays are enabled, percentage is shown above the numeric health values.

### Healing Information
Lifeweaver can display important healing information directly on the group frames:

- HoTs and healing buffs
- Dispellable debuffs
- Dispel highlighting
- Long-duration/class buffs
- Optional filter to only show class buffs your character can provide
- Incoming heals
- Absorb shields
- Heal absorbs
- Player status information

### Click-Casting
Cast directly on Lifeweaver frames without changing your current target.

Supported bindings include:

- Left Click
- Right Click
- Middle Mouse Button
- Shift + mouse buttons
- Ctrl + mouse buttons
- Additional mouse buttons
- Mouse Wheel Up
- Mouse Wheel Down
- Keyboard / Mouseover bindings

Spells can be dragged directly from the spellbook onto the desired binding.

Lifeweaver also preserves the exact dragged spell rank, making intentional downranking possible where supported.

### Custom Target Click
Target selection is no longer permanently tied to Left Click.

You can freely assign targeting to a mouse combination such as:

- Alt + Left Click
- Shift + Middle Mouse Button
- Mouse Button 4
- or another supported mouse-button combination

This allows healers to use normal Left Click for a healing spell while keeping target selection available elsewhere.

If a spell is already stored on the selected Target Click combination, it is not deleted. It becomes available again when Target Click is moved to another combination.

### Mouse Wheel Casting
Mouse Wheel Up and Mouse Wheel Down can be assigned to spells.

These bindings are only active while the cursor is over a Lifeweaver group frame, so your normal mouse-wheel behavior remains available elsewhere.

### Dispel Center
Lifeweaver includes a compact Decursive-style Dispel Center.

- Up to two configurable dispel spells
- Left and Right Click bindings
- Compact player tiles
- Movable and scalable
- Horizontal or vertical layout
- Lockable position
- Designed for fast reaction without searching through the normal party frames

### Combat-Safe
Lifeweaver uses secure WoW frame handling for spell casting and unit interaction.

Changes that cannot safely be applied during combat are automatically deferred until combat ends instead of risking protected-action errors.

### Character-Specific Settings
Click-Casting and spell assignments are stored per Forever character using the character's full **First Name + Last Name** identity.

### Localization
- German WoW client → German automatically
- All other client languages → English automatically
- German / English can also be switched manually
- Language changes apply immediately without `/reload`
- Manual language selection is saved

### Minimap Button
The included minimap launcher provides quick access to Lifeweaver.

- Left Click: Show/hide healing frames and Dispel Center
- Right Click: Open settings

All required libraries are bundled directly with the addon.

No additional library addon is required.

---

## Slash Commands

`/lw options`
Open Lifeweaver settings.

`/lw toggle`
Show or hide the healing frames.

`/lw lock`
Lock the healing-frame position.

`/lw unlock`
Unlock the healing-frame position.

`/lw reset`
Reset the healing-frame position.

`/lw dispel`
Show or hide the Dispel Center.

---

## Feedback

Lifeweaver Forever is actively developed based on real gameplay and community feedback.

If you find a bug, have an idea for a useful healer feature or notice something that could be improved, feel free to leave a comment on CurseForge.

---

# Deutsch

**Lifeweaver Forever** ist ein kompaktes und anpassbares Heilerframe-Addon für **World of Warcraft: Forever**.

Der Fokus liegt auf übersichtlichem und schnellem Heilen in 5-Spieler-Gruppen. Partyframes, Click-Casting, Heilerinformationen und Dispel-Funktionen werden dafür in einer gemeinsamen, schlanken Oberfläche kombiniert.

Das Ziel: Heiler sollen genau die Informationen und Funktionen bekommen, die sie benötigen, ohne dass der Bildschirm mit unnötigen Elementen überladen wird.

---

## Funktionen

### Heilerframes
- Kompakte Gruppenframes
- Lebensbalken in Klassenfarben
- Klassen- und Rollenicons optional
- Breite, Höhe und Abstand einstellbar
- Name und Lebensanzeige in Größe und Position anpassbar
- Kopfzeile über den Frames optional
- Optionale Sortierung nach Rolle:
  **Tank → Heiler → DD**
- Blizzard-Gruppenframes optional ausblendbar
- Spieler außerhalb der Reichweite werden automatisch ausgeblendet/abgedunkelt

### Lebensanzeige
Du entscheidest selbst, welche Lebensinformationen angezeigt werden:

- Prozent
- Aktuelles / maximales Leben
- Prozent + Zahlen gleichzeitig
- Oder gar keine Lebenszahlen

Sind Prozent und Zahlen gleichzeitig aktiviert, stehen die Prozentwerte oben und die Zahlen darunter.

### Heilerinformationen
Lifeweaver kann wichtige Informationen direkt auf den Gruppenframes darstellen:

- HoTs und Heilbuffs
- Dispellbare Debuffs
- Dispel-Hervorhebung
- Langzeit-/Klassenbuffs
- Optional nur Klassenbuffs anzeigen, die der eigene Charakter selbst bereitstellen kann
- Eingehende Heilung
- Absorb-Schilde
- Heal-Absorbs
- Spielerstatus

### Click-Casting
Zauber können direkt auf den Lifeweaver-Frames gewirkt werden, ohne vorher das Ziel wechseln zu müssen.

Unterstützt werden unter anderem:

- Linksklick
- Rechtsklick
- Mittlere Maustaste
- Shift + Maustaste
- Strg/Ctrl + Maustaste
- Weitere Maustasten
- Mausrad hoch
- Mausrad runter
- Tastatur / Mouseover

Zauber können direkt aus dem Zauberbuch auf die gewünschte Belegung gezogen werden.

Dabei bleibt auch der exakt gezogene Zauberrang erhalten, wodurch – sofern unterstützt – gezieltes Downranking möglich ist.

### Frei belegbarer Target-Klick
Die Zielauswahl ist nicht mehr fest an den normalen Linksklick gebunden.

Du kannst selbst festlegen, mit welcher Mauskombination ein Spieler als Ziel ausgewählt wird, zum Beispiel:

- Alt + Linksklick
- Shift + Mittlere Maustaste
- Maustaste 4
- oder eine andere unterstützte Mauskombination

Dadurch kann beispielsweise der normale Linksklick vollständig für einen Heilzauber genutzt werden.

Ist auf der gewählten Target-Kombination bereits ein Zauber gespeichert, wird dieser nicht gelöscht. Sobald der Target-Klick auf eine andere Kombination gelegt wird, steht der Zauber wieder zur Verfügung.

### Mausrad-Casting
Mausrad hoch und Mausrad runter können ebenfalls mit Zaubern belegt werden.

Die Belegung ist nur aktiv, solange sich der Mauszeiger über einem Lifeweaver-Gruppenframe befindet. Außerhalb der Frames funktioniert das Mausrad weiterhin normal.

### Dispel-Center
Lifeweaver enthält ein kompaktes Dispel-Fenster im Stil von Decursive.

- Zwei frei belegbare Dispel-Slots
- Linksklick und Rechtsklick
- Kompakte Spielerfelder
- Verschiebbar und skalierbar
- Horizontal oder vertikal
- Position sperrbar
- Für schnelles Dispellen ohne langes Suchen im normalen Gruppenframe

### Kampfsicher
Lifeweaver verwendet sichere WoW-Frames für Zauber und Spielerinteraktionen.

Änderungen, die während des Kampfes nicht sicher vorgenommen werden dürfen, werden automatisch bis nach Kampfende zurückgestellt, statt geschützte Aktionen zu verursachen.

### Charakterbezogene Einstellungen
Click-Casting und Zauberbelegungen werden pro Forever-Charakter gespeichert und verwenden dabei den vollständigen **Vorname + Nachname** des Charakters.

### Deutsch / Englisch
- Deutscher WoW-Client → automatisch Deutsch
- Alle anderen Clients → automatisch Englisch
- DE / EN kann zusätzlich jederzeit manuell gewechselt werden
- Kein `/reload` nötig
- Die gewählte Sprache wird gespeichert

### Minimap-Button
Über den integrierten Minimap-Button ist Lifeweaver schnell erreichbar.

- Linksklick: Heilerframes + Dispel-Center ein-/ausblenden
- Rechtsklick: Einstellungen öffnen

Alle benötigten Libraries werden direkt mit Lifeweaver ausgeliefert.

Es muss kein zusätzliches Library-Addon installiert werden.

---

## Slash Commands

`/lw options`
Lifeweaver-Einstellungen öffnen.

`/lw toggle`
Heilerframes ein- oder ausblenden.

`/lw lock`
Position der Heilerframes sperren.

`/lw unlock`
Position der Heilerframes entsperren.

`/lw reset`
Position der Heilerframes zurücksetzen.

`/lw dispel`
Dispel-Center ein- oder ausblenden.

---

## Feedback

Lifeweaver Forever wird aktiv anhand eigener Spielerfahrung und des Feedbacks aus der Community weiterentwickelt.

Wenn du einen Fehler findest, eine Idee für eine sinnvolle Heilerfunktion hast oder dir etwas auffällt, das verbessert werden könnte, kannst du gerne einen Kommentar auf CurseForge hinterlassen.