Zum Inhalt

File I/O — Übersicht

Streamer.bot kann lokale Files lesen und schreiben — für Quotes-Pools, Audit-Logs, Game-Log-Auswertung. Plus File-Watcher als Trigger wenn sich was ändert.

Sub-Actions im Überblick

Sub-Action Pfad
Read Lines From File Core → File I/O → Read Lines From File
Read Random Line From File Core → File I/O → Read Random Line From File
Read Specific Line From File Core → File I/O → Read Specific Line From File
Write To File Core → File I/O → Write To File
File Exists Core → File I/O → File Exists
Folder Exists Core → File I/O → Folder Exists

Plus File Tail: | Sub-Action | Pfad | |-----------|------| | Set File Tail State | Core → File Tail → Set File Tail State |

Trigger

Trigger Pfad Wann
File Tail Core → File I/O → File Tail Bei jeder neuen Zeile in einem Tail-File
Changed Core → File Folder Watcher → Changed File-Inhalt ändert sich
Created Core → File Folder Watcher → Created Neue Datei im Ordner
Deleted Core → File Folder Watcher → Deleted Datei gelöscht
Renamed Core → File Folder Watcher → Renamed Datei umbenannt

Typische Use-Cases

Use-Case Sub-Action / Trigger
!quote-ähnliche Random-Spruch-Sammlung aus Text-Datei Read Random Line From File
Audit-Log für Mod-Aktionen Write To File (Append)
Game-Death-Detection durch Log-Watcher File Tail Trigger
Stream-Config (Spieler-Liste, etc.) aus File Read Specific Line From File
Auto-Backup von Globals in JSON Write To File

Pfade auf Windows

Pfade in den Sub-Actions als absolute Windows-Pfade:

  • C:\sb-data\quotes.txt
  • D:\stream-tools\death-log.txt

Backslashes funktionieren. Wenn dynamisch via Variable: aufpassen mit Escaping. Pragmatisch: einfache Pfade ohne Special Chars nutzen.

Watcher in der UI anlegen

Bevor du File-Folder-Watcher-Trigger nutzen kannst, musst du den Watcher in SB anlegen:

  1. Links Services → File/Folder Watcher
  2. Rechtsklick → + Add Watcher
  3. Felder:
Feld Bedeutung
Name Custom Identifier
Path Pfad zur Datei/Ordner
Watch File Toggle: Datei oder Ordner
Include Subdirectories bei Ordner-Watch optional
  1. Save

Im Trigger-Dialog dann den Watcher-Namen auswählen.

Inhalte in dieser Sektion

MD Was
read-random-line.md !advice / !fortune mit Random-Sprüchen aus TXT
file-watcher.md Game-Log auswerten via File-Tail-Trigger
write-to-file.md Audit-Log für Mod-Aktionen

Häufige Fallen

  • Pfad existiert nicht — Sub-Action setzt %fileFound% = false. Mit If/Else prüfen
  • File-Lock wenn ein anderes Programm gerade schreibt — Read kann fehlschlagen. Cache via Read Lines, dann später verarbeiten
  • Newline-Encoding — Windows-Files mit CRLF, manche Linux-Tools wollen LF. SB ist tolerant, manche Workflows nicht
  • Pfad mit Spaces — funktioniert in SB ohne Quotes. Bei externen Commands aufpassen
  • Watcher feuert nicht — Path-Falsch eingegeben oder File noch nicht existent beim Anlegen des Watchers

Quellen