OMC STREAM TOOLS – Kurzanleitung
================================

Was ist das?
  Overlays, Alerts und Chat-Spielereien für OBS Studio und Streamer.bot – mit Balduur, dem Maskottchen des
  Old Mens Club. Ein Paket, ein Streamer.bot-Import, jedes Modul einzeln an- und abschaltbar.

Voraussetzungen
  - Windows 10/11
  - OBS Studio 32 (getestet: 32.2.2), regulär oder portable
  - Streamer.bot 1.0 (getestet: 1.0.7)
  - Twitch und/oder YouTube in Streamer.bot verbunden (für echte Ereignisse; Tests gehen auch ohne)

Installation (empfohlen)
  1. ZIP entpacken, z. B. nach Downloads\OMC-STREAM-TOOLS
  2. installer\Start-OMC-Tool-Manager.bat doppelklicken → 1) Installieren
  3. Der Assistent findet OBS und Streamer.bot, legt eine Sicherung an, kopiert die Dateien nach
     %LOCALAPPDATA%\OMC-STREAM-TOOLS und erklärt die zwei Handgriffe in OBS und Streamer.bot:
       OBS:          Szenensammlung → Importieren → "OMC STREAM TOOLS.json"
       Streamer.bot: Import → Text einfügen (liegt in der Zwischenablage) → Import
                     Servers/Clients → WebSocket Server → Auto Start + Start Server
  4. Tool Manager → 3) Prüfen. Grün = fertig.

Ohne Assistent
  - Ordner irgendwo ablegen, omc-config.beispiel.js nach omc-config.js kopieren und anpassen
  - In OBS eine Browserquelle 1920×1080 mit der Datei omc-overlay.html anlegen
    (einzelne Module: URL-Modus mit file:///…/omc-overlay.html?module=alerts,shoutout)
  - Dock: Docks → Benutzerdefinierte Browser-Docks → omc-event-dock.html
  - Streamer.bot: streamerbot\OMC-STREAM-TOOLS-Streamerbot.txt importieren

Ausprobieren ohne Stream
  - Overlay mit ?demo=1 öffnen (Browser oder OBS) → spielt alle Module der Reihe nach ab, ?ton=0 ohne Ton
  - Event Dock → Testknöpfe je Modul (läuft über Streamer.bot, also wie echt)

Chatbefehle (alle abschaltbar, Cooldowns eingebaut)
  !lurk  !back  !love [@name]  !so @name (Mods)  !punkte  !top  !meme  !lastyt  !foto (Mods)
  !notiz text (Mods)  !alarm (Mods)  !subathon (Mods)  !ziel (Mods)  !timer (Mods)  !tools

Eigene Bilder und Töne
  Bild mit gleichem Namen nach eigene\bilder\ legen (z. B. ALERT-FOLLOW.png) – hat Vorrang.
  Töne nach eigene\sounds\ (z. B. omc-follow.mp3). Lautstärke in omc-config.js.

Update
  Neues Paket entpacken → Tool Manager → 2) Update. Deine omc-config.js, eigene\ und daten\ bleiben.
  Von dir geänderte Paketdateien werden nicht überschrieben (neue Fassung liegt als *.neu daneben).
  In Streamer.bot den neuen Import-Text importieren – Punkte, Subathon usw. bleiben erhalten.

Sicherung
  Tool Manager → 4) Sicherung / 5) Wiederherstellen. Event Dock → Sichern speichert die OMC-Spielstände.
  Stream-Schlüssel (OBS service.json) und Streamer.bot-Zugänge werden nie mitgesichert.

Deinstallation
  Tool Manager → 7) Deinstallieren. Entfernt nur Paketdateien. Danach in OBS die Sammlung und in
  Streamer.bot die Gruppe "OMC Tools" löschen (der Assistent sagt wie).

Probleme?
  Tool Manager → 6) Diagnose. Häufig: WebSocket-Server in Streamer.bot nicht gestartet, oder Passwort
  gesetzt, aber nicht in omc-config.js eingetragen.

Lizenz
  Programmcode und Töne: MIT-Lizenz – LIZENZ-CODE.txt
  Balduur-Grafiken: eigene Nutzungsbedingungen, NICHT MIT – NUTZUNGSBEDINGUNGEN-GRAFIKEN.txt
  (Nutzung im eigenen Stream erlaubt; Weitergabe außerhalb des Pakets und Vermarktung nur mit Genehmigung)
  Übersicht: LIZENZ.txt

Bekannte Einschränkungen von 1.0.0
  Geprüft in einer abgeschotteten Testumgebung (OBS Studio 32.2.2, Streamer.bot 1.0.7) – noch NICHT geprüft:
  - echte Twitch- und YouTube-Ereignisse (Follow, Abo, Raid, Super Chat …), Chat-Antworten und der
    Twitch-eigene Shoutout mit angemeldeten Konten
  - OBS Control (Szenenwechsel mit Rückkehr) und Foto mit einem verbundenen OBS
  - Stream Deck und Companion (keine eigene Tastenbelegung enthalten)
  - Hörtest der Töne (Tests liefen bewusst ohne Ton)
  Rückmeldungen gern im Discord des Old Mens Club.
