Addon CritTracker implementiert (WoW Forever 12.x Beta, Interface 16001)

- Getrennte Erfassung für Schaden und Heilung
- Erkennung schwacher Crits mit einstellbarem Schwellenwert (Standard 30%)
- Audio-Feedback (crit1-4, heal1-4, low.mp3) für Deutsch und Englisch
- Einstellungsmenü mit Cooldown-Slider (1-30s), Sound-Auswahl und Test-Buttons
- Automatischer Reset der Rekorde bei Stufenaufstieg (PLAYER_LEVEL_UP)
- Lokale Chat-Benachrichtigungen (nur für Spieler sichtbar)
- Slash-Befehle /ctr und /crittracker
- Entwickler- & Agenten-Leitfaden (AGENT_GUIDE.md) hinzugefügt
- sounds/English/low.mp3 repariert

README.md

@@ -1,2 +1,46 @@
 # CritTracker
 
+CritTracker ist ein World of Warcraft Addon für **World of Warcraft - Forever (12.x Beta)** (TOC Interface `16001`), das kritische Treffer und Heilungen getrennt erfasst und mit anpassbarem Audio- und lokalem Chat-Feedback versieht.
+
+---
+
+## Features
+
+- **Getrennte Erfassung für Schaden & Heilung:**
+  - Protokolliert höchste kritische Treffer (Rekorde) für Schaden und Heilung getrennt nach Zauber/Angriff.
+  - Nur für den Spieler sichtbare Chat-Ausgabe (`AddMessage`), die in den Einstellungen vollständig deaktiviert werden kann.
+- **Erkennung schwacher kritischer Treffer ("Low Crits"):**
+  - Einstellbarer Schwellenwert (standardmäßig **30%** des aktuellen Rekords).
+  - Spielt bei schwachen Crits die Sound-Datei `low.mp3` ab und gibt eine dezent gefärbte Nachricht aus.
+- **Sicherheits-Mechanismen:**
+  - **Level-Up Reset:** Bei jedem Stufenaufstieg (`PLAYER_LEVEL_UP`) sowie beim ersten Login nach einem Level-Up werden die Rekorde dieses Charakters automatisch auf 0 zurückgesetzt.
+  - **Ausgabe-Cooldown:** Ein Schieberegler (1–30 Sekunden, Standard 5s) verhindert Audio-Überlagerungen und Chat-Spam bei schnellen aufeinanderfolgenden Crits.
+  - **Charakterspezifische Datenspeicherung:** Rekorde werden getrennt nach Charakter & Realm gespeichert, sodass Twinks nicht gegen Endgame-Zahlen antreten.
+- **Audio-Feedback:**
+  - Schadens-Crits: Auswahl zwischen `crit1` bis `crit4` (oder deaktiviert).
+  - Heilungs-Crits: Auswahl zwischen `heal1` bis `heal4` (oder deaktiviert).
+  - Schwache Crits: `low.mp3` (oder deaktiviert).
+  - Wählbarer Sound-Kanal (`Master`, `Dialog`, `SFX`).
+- **Zweisprachigkeit:**
+  - Deutsche Clients (`deDE`): Deutsche Benutzeroberfläche und deutsche Sounds (`sounds/German/`).
+  - Alle anderen Clients: Englische Benutzeroberfläche und englische Sounds (`sounds/English/`).
+  - Optionale manuelle Sprachauswahl in den Einstellungen.
+
+---
+
+## Befehle (Slash Commands)
+
+- `/ctr` oder `/crittracker` – Öffnet das Einstellungsmenü.
+- `/ctr stats` – Zeigt die aktuellen Rekorde des Charakters im Chat an.
+- `/ctr reset` – Setzt die Rekorde des aktuellen Charakters manuell auf 0 zurück.
+- `/ctr test [crit|heal|low]` – Löst einen Test-Sound und eine Chat-Nachricht aus.
+  - `/ctr test crit` (Schadens-Crit Test)
+  - `/ctr test heal` (Heilungs-Crit Test)
+  - `/ctr test low` (Schwacher Treffer Test)
+
+---
+
+## Installation
+
+Kopiere den Ordner `CritTracker` in dein Addon-Verzeichnis:
+`World of Warcraft\_retail_\Interface\AddOns\CritTracker`