Command: !replay (Replay-Buffer speichern)¶
Speichert den OBS Replay-Buffer als Video-File. Replay-Buffer muss in OBS aktiv sein.
Voraussetzung:
- OBS-Verbindung (siehe setup.md)
- OBS Replay-Buffer konfiguriert: Settings → Output → Replay Buffer aktiv, gewünschte Dauer (z.B. 30s)
- Replay-Buffer läuft (Start Replay Buffer Button in OBS oder via Sub-Action)
Patterns: Set Replay Buffer State Sub-Actions: 1-3 Permissions: Broadcaster + Mods (sonst Disk-Spam-Risk)
Action: [Cmd] !replay¶
Sub-Action 1: Set Replay Buffer State — Save¶
Pfad: OBS Studio → Replay → Set Replay Buffer State
| Feld | Wert |
|---|---|
| Connection | Default |
| State | Save |
Speichert den aktuellen Replay-Buffer als Video-File in OBS' konfiguriertem Replay-Ordner (Output-Settings).
Sub-Action 2: Send Message¶
| Feld | Wert |
|---|---|
| Message | 💾 Replay gespeichert! Check den Replay-Ordner. |
| Send using bot account | aktiv |
Action-Tree¶
Command-Einstellungen¶
| Feld | Wert |
|---|---|
| Name | !replay |
| Group | AzaCraft OBS |
| Commands | !replay!save |
| Location | Start |
| Sources | Twitch Message |
| Global Cooldown | 5 |
| User Cooldown | 15 |
| Grant Type | Allow |
| Groups | Moderators |
Mod-Only weil sonst Viewer dir die Disk vollspammen.
Replay-Buffer Setup-Erinnerung (OBS-Seite)¶
Im OBS:
- Settings → Output → Mode: Advanced
- Tab Replay Buffer → Enable Replay Buffer
- Maximum Replay Time: 30 Sekunden (oder mehr, je nach Bedarf)
- Replay Buffer Output Path: wählst du selbst (z.B.
D:\OBS-Replays) - Apply
Replay-Buffer manuell starten: Controls-Pane → Start Replay Buffer (das große blaue Symbol).
Replay-Buffer Auto-Start bei Stream Online¶
Damit du nicht jeden Stream-Start manuell starten musst, eine Helper-Action:
Action: [Sys] Replay Buffer Auto-Start¶
Trigger: Twitch → Channel → Stream Online
Sub-Action: OBS Studio → Replay → Set Replay Buffer State → State: Start
Bei Stream-Online läuft der Replay-Buffer automatisch.
Variante: !replay + Discord-Webhook¶
Wenn du den Replay zusätzlich auf Discord ankündigen willst (Datei kannst du nicht direkt via Webhook hochladen, aber Notification):
[Cmd] !replay
├── 1. Set Replay Buffer State: Save
├── 2. Delay 1000 ms (warten bis OBS gespeichert hat)
├── 3. Send Message: "💾 Replay gespeichert!"
└── 4. Discord Basic Webhook
Content: "💾 Neuer Replay aus dem Stream — frag im Discord nach"
Variante: Auto-Save bei Bits-Cheer¶
Statt manuell, auto-save wenn jemand z.B. >500 Bits cheert. Im Bits-Cheer Event als Erweiterung:
1. (existing) If/Else %bits% Greater Than 499
├── (existing) Send Message
├── Set Replay Buffer State: Save ← NEU
└── Break
So bekommst du automatisch einen Replay zu jedem "big moment".
Häufige Fallen¶
- Replay-Buffer nicht aktiv — Save schlägt fehl ohne Fehlermeldung. OBS-Status-Bar prüfen
- Disk-Spam — bei sehr aktivem Stream kann Replay-Ordner schnell voll werden. Disk-Watcher einrichten
- Trim / Edit — OBS gibt dir das volle Buffer-Window. Trimmen musst du selbst (DaVinci, OBS Edit, etc.)
- Permissions öffnen — wenn jeder Viewer
!replaytriggern darf, hast du nach 10 Min 100+ Files. Mod-Only oder Channel-Point-Reward statt Chat-Command
Quellen¶
- Set Replay Buffer State: https://docs.streamer.bot/api/sub-actions/obs-studio/replay/set-replay-buffer-state