# 📖 Das Buch der Gefallenen / The Book of the Fallen
## GuildDeathLog v3.4 - WoW Classic Era Hardcore Addon

---

# 🇩🇪 DEUTSCH

## Was macht dieses Addon?

**Das Buch der Gefallenen** verfolgt und dokumentiert alle Tode von Gildenmitgliedern im Hardcore-Modus. Es zeigt ein elegantes Popup wenn jemand stirbt, synchronisiert die Daten zwischen Gildenmitgliedern und zeigt Todesorte auf der Weltkarte.

---

## ✅ FUNKTIONEN (100%)

### 📖 Das Buch (Hauptfenster)
- Elegantes Pergament-Design im mittelalterlichen Stil
- Statistiken: Gefallene gesamt, heute, diese Woche, Durchschnittslevel
- Scrollbare Liste aller gefallenen Gildenmitglieder
- Klassenfarben und Icons für jeden Eintrag
- Datum und Uhrzeit jedes Todes
- Klick auf Eintrag zeigt das Todes-Popup

### 💀 Todes-Popup (Overlay)
- Erscheint automatisch wenn ein Gildenmitglied stirbt
- Zeigt Name, Level, Klasse und Zone
- 8 Sekunden sichtbar mit sanftem Ausblenden
- Sound-Effekte (Trauerglocke + Raid-Warnung)
- Warteschlange für mehrere Tode gleichzeitig

### 🔄 Gilden-Synchronisation
- Automatischer Sync zwischen allen Addon-Nutzern
- Sendet und empfängt Tode via Gilden-Addon-Kanal
- Koordinaten werden mit übertragen
- Ping/Pong System zeigt wer online ist mit dem Addon
- Versionsprüfung

### 🗺️ Karten-Markierungen
- Todesmarkierungen auf der Weltkarte
- Totenkopf-Symbol mit rotem Glow
- Tooltip mit allen Details
- Klassenfarbe auf dem Icon
- Klick öffnet das Overlay
- 30 Tage Anzeige

### 📊 Deathlog Integration
- Automatische Integration mit dem Deathlog Addon
- Liest `deathlog_data` für historische Tode
- Hook in `DeathNotificationLib` für Live-Tode
- Koordinaten werden extrahiert wenn verfügbar

### 📢 Gildenchat-Ankündigung
- Automatische R.I.P. Nachricht im Gildenchat
- 4 verschiedene zufällige Nachrichten
- Ein/Ausschaltbar

### ⚙️ Einstellungen
1. **Gildenchat-Ankündigung** - R.I.P. Nachrichten senden
2. **Sound abspielen** - Bei jedem Tod
3. **Todes-Popup anzeigen** - Das Overlay
4. **Karten-Markierungen** - Todesmarker auf der Map
5. **Blizzard HC-Channel** - Hardcore Death Channel parsen
6. **Addon-Sync aktiv** - Kommunikation mit anderen Addon-Usern
7. **Debug-Ausgaben** - Für Fehlersuche

### 🔧 Debug-Fenster
- Zeigt Sync-Status und Online-User
- Deathlog-Statistiken
- Kartenmarker-Zähler
- Ereignis-Protokoll

---

## 📜 Befehle

| Befehl | Funktion |
|--------|----------|
| `/gdl` oder `/buch` | Buch öffnen |
| `/gdl hide` | Buch schließen |
| `/gdl settings` | Einstellungen öffnen |
| `/gdl sync` | Manueller Sync anfordern |
| `/gdl debug` | Debug-Fenster öffnen |
| `/gdl scan` | Deathlog neu scannen |
| `/gdl help` | Hilfe anzeigen |

---

## 📋 Koordinaten - Woher?

| Quelle | Beschreibung |
|--------|--------------|
| **Deathlog Addon** | Wenn installiert, liefert Koordinaten für alle Tode |
| **Eigener Tod** | Deine Position wird beim Tod automatisch erfasst |
| **Addon Sync** | Koordinaten werden zwischen Spielern geteilt |
| **⚠️ Instanzen** | Keine Koordinaten möglich (WoW API Limitierung) |

---

## 🔗 Abhängigkeiten

- **Erforderlich:** Keine (funktioniert standalone)
- **Optional:** Deathlog Addon (für mehr Daten und Koordinaten)

---

---

# 🇬🇧 ENGLISH

## What does this addon do?

**The Book of the Fallen** tracks and documents all deaths of guild members in Hardcore mode. It displays an elegant popup when someone dies, synchronizes data between guild members, and shows death locations on the world map.

---

## ✅ FEATURES (100%)

### 📖 The Book (Main Window)
- Elegant parchment design in medieval style
- Statistics: Total fallen, today, this week, average level
- Scrollable list of all fallen guild members
- Class colors and icons for each entry
- Date and time of each death
- Click on entry shows the death popup

### 💀 Death Popup (Overlay)
- Appears automatically when a guild member dies
- Shows name, level, class and zone
- 8 seconds visible with smooth fade-out
- Sound effects (mourning bell + raid warning)
- Queue system for multiple deaths at once

### 🔄 Guild Synchronization
- Automatic sync between all addon users
- Sends and receives deaths via guild addon channel
- Coordinates are transmitted
- Ping/Pong system shows who is online with the addon
- Version check

### 🗺️ Map Markers
- Death markers on the world map
- Skull symbol with red glow
- Tooltip with all details
- Class color on the icon
- Click opens the overlay
- 30 days display

### 📊 Deathlog Integration
- Automatic integration with the Deathlog addon
- Reads `deathlog_data` for historical deaths
- Hook into `DeathNotificationLib` for live deaths
- Coordinates are extracted when available

### 📢 Guild Chat Announcement
- Automatic R.I.P. message in guild chat
- 4 different random messages
- Can be toggled on/off

### ⚙️ Settings
1. **Guild Chat Announcement** - Send R.I.P. messages
2. **Play Sound** - On every death
3. **Show Death Popup** - The overlay
4. **Map Markers** - Death markers on map
5. **Blizzard HC Channel** - Parse Hardcore Death channel
6. **Addon Sync Active** - Communication with other addon users
7. **Debug Output** - For troubleshooting

### 🔧 Debug Window
- Shows sync status and online users
- Deathlog statistics
- Map marker counter
- Event log

---

## 📜 Commands

| Command | Function |
|---------|----------|
| `/gdl` or `/book` | Open book |
| `/gdl hide` | Close book |
| `/gdl settings` | Open settings |
| `/gdl sync` | Request manual sync |
| `/gdl debug` | Open debug window |
| `/gdl scan` | Rescan Deathlog |
| `/gdl help` | Show help |

---

## 📋 Coordinates - Where from?

| Source | Description |
|--------|-------------|
| **Deathlog Addon** | When installed, provides coordinates for all deaths |
| **Own Death** | Your position is automatically captured on death |
| **Addon Sync** | Coordinates are shared between players |
| **⚠️ Instances** | No coordinates possible (WoW API limitation) |

---

## 🔗 Dependencies

- **Required:** None (works standalone)
- **Optional:** Deathlog Addon (for more data and coordinates)

---

## 📦 Installation

1. Download and extract to `World of Warcraft/_classic_era_/Interface/AddOns/`
2. Restart WoW or `/reload`
3. Type `/gdl` to open

---

## 👤 Author

**PsYke86** - Made with ❤️ for the Hardcore Community

---
