bg1-ee-voiceover/docs/project-plan.md

Projektplan – BG1EE Dialog-Extraktion & Hook-System (v0.3)

🎯 Ziel

Solide Grundlage schaffen, um später Live-TTS oder Offline-TTS einzubinden – ohne jetzt schon einen TTS-Server zu benötigen.

---

Phase 1 – Extraktion (JETZT)

Zweisprachige Rohdaten aus BGEE exportieren.

Aufgaben

• TLK DE exportieren
• TLK EN exportieren
• Alle DLG-Dateien exportieren
• NPC-Mappings extrahieren (optional)
• Rohdaten nach data/raw/ speichern

Ergebnis

data/raw/tlk/dialog_de.json
data/raw/tlk/dialog_en.json
data/raw/dlg/*.json
data/mappings/npc_map.json

---

Phase 2 – Parser & Datenmodell (ALS NÄCHSTES)

Parser zusammenbauen, der aus TLK & DLG eine vollständige Dialog-Datenbank erzeugt.

Aufgaben

• TLK DE/EN matchen (ID-basiert)
• Dialogbäume verknüpfen
• Sprecher zuordnen (optional)
• finale Struktur in dialogs.json schreiben
• Self-Test entwickeln

Ergebnis

data/processed/dialogs.json

---

Phase 3 – Lua-Hook (PARALLEL ODER DANACH)

Minimaler Hook, der Dialogstart und Dialogknotenwechsel erkennt.

Aufgaben

• dialog.lua schreiben
• mod.ini erstellen
• Hook testweise in BGEE installieren
• Log-Ausgabe sicherstellen (kein TTS!)

Ergebnis

BGEE schreibt z. B.:

Dialog node changed: 47119

---

Phase 4 – (OPTIONAL) Offline-Rendering-Grundlage

Noch kein TTS – aber vorbereiten:

Aufgaben

• Namensschema für WAV-Dateien definieren
• Ordner anlegen: audio_de, audio_en
• Prototyp-Skript render_all.py vorbereiten (noch ohne Engine)

---

Phase 5 – (SPÄTER) TTS-Anbindung

Erst wenn die Datenbank + Hook stabil sind.

---

Aktueller Status

Wir befinden uns am Start von Phase 1.