Creator Goals: Multi-Type Fortschrittsziele mit Overlay und Auto-Progress #46

New issue

Open

opened 2026-07-15 19:12:52 +02:00 by frank · 0 comments

frank commented

2026-07-15 19:12:52 +02:00

Owner

Kontext

Twitch Creator Goals (Twitch Helix API: GET /goals) erlauben Streamern, Ziele für Follower, Subs, Bits oder benutzerdefinierte Metriken zu setzen. Der Fortschritt wird auf der Kanalseite und in Overlays als Fortschrittsbalken angezeigt.

Streamlabs, StreamElements und andere Tools haben ähnliche Goal-Widgets (Follower Goal, Donation Goal, Sub Goal).

Streamertool hat aktuell Goal-Features nur implizit:

#30: Donation/Tip-System (Donation Goal)
#39: Erweiterte Widget-Overlays (Follower Goal, Viewer Count)
#33: Loyalty-System (Levels)

Es fehlt ein einheitliches, flexibles Creator-Goals-System, das mehrere Goal-Typen gleichzeitig unterstützt.

Ziel

Ein Creator Goals System ähnlich Twitch Creator Goals mit:

1. Multi-Type Goals

Follower Goal: Ziel-X Follower erreichen
Subscriber Goal: Ziel-X Subs erreichen (Tier 1/2/3, total)
Bit/Cheer Goal: Ziel-X Bits erreichen
Donation Goal: Ziel-X Spendensumme erreichen (via #30)
Custom Goal: Freie Metrik mit manuellem Fortschritt

2. Mehrere gleichzeitige Goals

Admin kann mehrere Goals parallel aktivieren
Jedes Goal hat eigenen Fortschrittsbalken

3. Auto-Progress

Follower: automatisch via EventSub (#1)
Subs: automatisch via EventSub (#1)
Bits: automatisch via EventSub (#1)
Donations: automatisch via #30
Custom: manuell editierbar in Admin-UI

4. Goal-Overlays

Progress Bar Widget: Anpassbarer Fortschrittsbalken (Farbe, Größe, Text)
Goal List Widget: Alle aktiven Goals als Liste
Goal Completion Overlay: Animation wenn Goal erreicht wird
Konfigurierbar via URL-Parameter

5. Goal Completion

Alert-Integration: Bei Goal-Erreichung wird Alert (#24) ausgelöst
Chat-Notification: Bot postet Goal-Erfolg im Chat (via #32)
Sound-Effekt: Optionaler Sound bei Goal-Erreichung (via #40)

6. Admin-UI

Goals erstellen, bearbeiten, aktivieren/deaktivieren
Typ, Zielwert, Startwert, Titel, Farbe konfigurieren
Reihenfolge per Drag-and-Drop
Historie abgeschlossener Goals

Technische Leitplanken

Daten in SQLite (#13)
Event-Bus Events: goal.* (goal.created, goal.progress, goal.completed)
Alert-System (#24) auf goal.completed Event reagieren lassen
Chatbot (#32) um !goal-Command erweitern
Overlay als eigenständiges Widget oder via Custom Widget API (#38)
Twitch Creator Goals API zusätzlich als Datenquelle nutzbar (Helix GET /goals)

Akzeptanz

Mehrere Goal-Typen können angelegt werden (Follower, Subs, Bits, Donation, Custom)
Auto-Progress funktioniert für alle integrierten Quellen (EventSub, #30)
Goal-Overlay zeigt Fortschrittsbalken live
Goal Completion löst Alert aus
!goal Command zeigt Goal-Status im Chat
Admin-UI erlaubt volle Goal-Verwaltung
Twitch Creator Goals API kann als externe Quelle angebunden werden

## Kontext Twitch Creator Goals (Twitch Helix API: GET /goals) erlauben Streamern, Ziele für Follower, Subs, Bits oder benutzerdefinierte Metriken zu setzen. Der Fortschritt wird auf der Kanalseite und in Overlays als Fortschrittsbalken angezeigt. Streamlabs, StreamElements und andere Tools haben ähnliche Goal-Widgets (Follower Goal, Donation Goal, Sub Goal). Streamertool hat aktuell Goal-Features nur implizit: - #30: Donation/Tip-System (Donation Goal) - #39: Erweiterte Widget-Overlays (Follower Goal, Viewer Count) - #33: Loyalty-System (Levels) Es fehlt ein **einheitliches, flexibles Creator-Goals-System**, das mehrere Goal-Typen gleichzeitig unterstützt. ## Ziel Ein **Creator Goals System** ähnlich Twitch Creator Goals mit: ### 1. Multi-Type Goals - **Follower Goal**: Ziel-X Follower erreichen - **Subscriber Goal**: Ziel-X Subs erreichen (Tier 1/2/3, total) - **Bit/Cheer Goal**: Ziel-X Bits erreichen - **Donation Goal**: Ziel-X Spendensumme erreichen (via #30) - **Custom Goal**: Freie Metrik mit manuellem Fortschritt ### 2. Mehrere gleichzeitige Goals - Admin kann mehrere Goals parallel aktivieren - Jedes Goal hat eigenen Fortschrittsbalken ### 3. Auto-Progress - Follower: automatisch via EventSub (#1) - Subs: automatisch via EventSub (#1) - Bits: automatisch via EventSub (#1) - Donations: automatisch via #30 - Custom: manuell editierbar in Admin-UI ### 4. Goal-Overlays - **Progress Bar Widget**: Anpassbarer Fortschrittsbalken (Farbe, Größe, Text) - **Goal List Widget**: Alle aktiven Goals als Liste - **Goal Completion Overlay**: Animation wenn Goal erreicht wird - Konfigurierbar via URL-Parameter ### 5. Goal Completion - **Alert-Integration**: Bei Goal-Erreichung wird Alert (#24) ausgelöst - **Chat-Notification**: Bot postet Goal-Erfolg im Chat (via #32) - **Sound-Effekt**: Optionaler Sound bei Goal-Erreichung (via #40) ### 6. Admin-UI - Goals erstellen, bearbeiten, aktivieren/deaktivieren - Typ, Zielwert, Startwert, Titel, Farbe konfigurieren - Reihenfolge per Drag-and-Drop - Historie abgeschlossener Goals ## Technische Leitplanken - Daten in SQLite (#13) - Event-Bus Events: `goal.*` (goal.created, goal.progress, goal.completed) - Alert-System (#24) auf `goal.completed` Event reagieren lassen - Chatbot (#32) um !goal-Command erweitern - Overlay als eigenständiges Widget oder via Custom Widget API (#38) - Twitch Creator Goals API zusätzlich als Datenquelle nutzbar (Helix GET /goals) ## Akzeptanz - [ ] Mehrere Goal-Typen können angelegt werden (Follower, Subs, Bits, Donation, Custom) - [ ] Auto-Progress funktioniert für alle integrierten Quellen (EventSub, #30) - [ ] Goal-Overlay zeigt Fortschrittsbalken live - [ ] Goal Completion löst Alert aus - [ ] !goal Command zeigt Goal-Status im Chat - [ ] Admin-UI erlaubt volle Goal-Verwaltung - [ ] Twitch Creator Goals API kann als externe Quelle angebunden werden

frank added the

effort:medium

priority:high

area:analytics

labels

2026-07-15 19:22:51 +02:00

frank added this to the Analytics & Creator Goals milestone

2026-07-15 21:08:18 +02:00