Handbuch › Chat-Bot
Chat-Bot
Handbuch zum Modul Chat-Bot
Dieses Modul ist bald erhältlich.
Schreibt mit deinem Twitch-Konto in den Chat. Im Editor unter „Ventoview-Bot“ baust du ihn aus Elementen: Befehle wie !rank, Zufallsgeneratoren wie !lucky, Timer, feste Uhrzeiten, Tastenkürzel, Zähler (z. B. !tod), Begrüßung und Danke-Nachrichten bei Follows, Abos und Raids. Vor jeder Nachricht steht „(Ventoview)“.
Bot-Elemente (Editor → „Ventoview-Bot“)
Den Bot baust du im Editor im Tab „Ventoview-Bot“ – wie Ebenen, nur für den Chat: oben ein Element hinzufügen, links auswählen, rechts einstellen. Alles gilt für alle Overlays und wird automatisch in der App gespeichert. Das Auge schaltet ein Element aus, ohne es zu löschen; „▶ Vorschau“ zeigt, was der Bot schreiben würde.
| Element | Was es macht |
|---|---|
| 💬 Befehl | Antwort auf einen Befehl wie !rank – an alle, als Antwort oder als Whisper, mit eigener Pause. Mehrere Befehlswörter mit Komma: !rank, !elo. Im Chat schreibt man nur !rank. |
| ⏱️ Timer | Nachricht alle X Minuten – nur live oder immer. |
| 🕗 Uhrzeit | Nachricht zu einer festen Uhrzeit, auf Wunsch nur an bestimmten Wochentagen. |
| ⌨️ Tastenkürzel | Nachricht per Taste, Gamepad oder MIDI (Modul Tastenkürzel). |
| 🔢 Zähler | z. B. !tod zählt hoch und schreibt 💀 Tode: {zaehler}. Mods auch !tod -, !tod reset, !tod 12. Überall: {zaehler_tod}. |
| 👋 Begrüßung | Wer heute zum ersten Mal schreibt, wird begrüßt – beim nächsten Stream wieder. |
| 🎉 Ereignis | Danke-Nachricht bei Follow, Abo, Bits, Raid oder Kanalpunkten (Modul Alerts), z. B. Danke für den Raid, {alertuser}! |
Zufallsgeneratoren
„🎲 Generator“ ist ein eigenes Element: zuerst einen Namen vergeben (z. B. gen1), dann die Liste bauen – pro Eintrag einstellbar, wie selten er kommt. Im Text eines Elements setzt du ihn mit {gen1} ein, z. B. Hallo {user}, heute spielst du {gen1}! Viel Spaß.
- Zuordnen: unter „Gehört zu“ einen Haken setzen oder den Generator in der Liste auf ein Element ziehen – dann steht er eingerückt darunter. Fügst du einen Generator hinzu, während ein Befehl gewählt ist, hängt er gleich darunter.
- Gleicher Name = gleicher Generator: Einen Namen gibt es nur einmal. Ein Generator kann unter mehreren Elementen hängen, alle nutzen dieselbe Liste.
- Umbenennen passt die Zuordnungen und
{name}in allen Texten automatisch an. - Nicht erlaubt sind Namen, die schon belegt sind: Platzhalter des Bots (
user,text…), die Variablen aller Module (auch nicht aktiver, z. B.cpuvon Basic), eingebaute Variablen und deine eigenen Keywords. - Viele Einträge auf einmal: „Mehrere …“ öffnet ein Fenster – Einträge mit Komma oder pro Zeile trennen.
- Kommt derselbe Generator mehrmals in einer Nachricht vor, zieht jeder einen anderen Eintrag.
{gen1}funktioniert auch in Timern, Uhrzeiten, Begrüßung und Ereignissen.- Kommt später ein Modul mit derselben Variable dazu (z. B. du hast
{metin2skill}und ein neues Modul bringt{metin2skill}mit), lässt die App dieses Modul nicht aktivieren und sagt dir, wo du den Namen benutzt. Nach dem Umbenennen startet es von selbst. Dasselbe gilt für eigene Keywords der App. - Fertig dabei: !lucky mit dem Generator
lucky(80 Glückssprüche aus Gaming und Anime). - Weitergeben: in der App beim Chat-Bot ⚙ → „Exportieren …“ / „Importieren …“ (.vviewbot, ohne deinen Kanal).
In Texten gehen {user}, {text}, {glueck}, deine Generatoren wie {gen1}, {zaehler_name} und alle Variablen deiner Module. Befehle, deren Variablen gerade kein Modul liefert, sind inaktiv.
Wann: live oder immer
Die Grundeinstellung „Bot nur, wenn du live bist“ (App → Chat-Bot → ⚙ oder Editor → Einstellungen) gilt für alle Elemente. Jedes Element kann sie unter „Wann“ überschreiben: „Wie Einstellung“, „Nur live“ oder „Immer“. In der Liste markiert 🔴 live die Elemente, die nur im Stream laufen.
In den Modul-Einstellungen (App → Chat-Bot → ⚙) stehen nur noch Kanal, Bot-Name, „nur wenn live“ und die Standard-Pause. Deine Befehle, Timer und Zufallsgeneratoren aus älteren Versionen werden automatisch zu Elementen.
Im Overlay: {chatbotlast} zeigt die letzte Nachricht, {chatbotzufall} den letzten Zufallstreffer.
Loslegen
- Modul aktivieren (App oder Home → Module).
- In der App beim Modul auf „Overlay einrichten“ – oder Editor öffnen.
- Eine Vorlage wählen, anpassen, speichern und den Overlay-Link in deiner Streaming-Software einfügen.
Einstellungen
In der App beim Modul auf ⚙ – oder im Editor unter „Einstellungen“.
| Einstellung | Bedeutung |
|---|---|
| Kanal | Leer = dein Twitch-Kanal aus der App. In fremden Kanälen musst du schreiben dürfen. |
| „(Ventoview-Bot)“ statt „(Ventoview)“ | So steht es vor jeder Nachricht des Bots. |
| Bot nur, wenn du live bist | Grundeinstellung für alle Bot-Elemente (Befehle, Timer, Uhrzeiten, Begrüßung …). Jedes Element kann sie unter „Wann“ überschreiben: nur live oder immer. |
| Standard-Abklingzeit (Sekunden) | Gilt für Befehle ohne eigene Zahl. So lange reagiert ein Befehl nicht noch einmal – bei Antworten und Whispers pro Nutzer. |
| Bot-Elemente | Befehle, Zufallsgeneratoren (!lucky), Timer, feste Uhrzeiten, Tastenkürzel, Zähler, Begrüßung und Danke-Nachrichten – im Editor unter „Ventoview-Bot“ bearbeiten. |
Variablen
In Texte und Bedingungen einsetzen, z. B. {chatbotname}. Die Beispielwerte siehst du im Editor, solange keine echten Daten da sind.
Bot
| Variable | Bedeutung | Beispiel |
|---|---|---|
{chatbotname} | Bot-Name (vor jeder Nachricht) | Ventoview |
{chatbotlast} | Letzte Nachricht des Bots (ohne Namen) | Danke für den Follow! |
{chatbotlastcommand} | Befehl, auf den zuletzt geantwortet wurde | !rank |
{chatbotlastuser} | Wer den Befehl schrieb | Zuschauer123 |
{chatbotcount} | Nachrichten seit dem Start | 12 |
{chatbotcommands} | Alle Befehle | !rank · !befehle · !discord |
Zufall
| Variable | Bedeutung | Beispiel |
|---|---|---|
{chatbotzufall} | Letzter Zufallstreffer | Heute droppt das legendäre Item. |
{chatbotzufallname} | Welcher Zufallsgenerator | lucky |
{chatbotzufalluser} | Wer ihn ausgelöst hat | Zuschauer123 |
Verbindung
| Variable | Bedeutung | Beispiel |
|---|---|---|
{chatbotconnected} | Verbunden (ja, nein) | ja |
{chatbotlive} | Du bist live (ja, nein) | ja |
{chatbotchannel} | Kanal | deinkanal |
Verhalten
- Ausblenden: Wenn der Bot nicht verbunden ist
- Abspielen: Einmal pro Bot-Nachricht
- Abspielen: Einmal pro Zufallstreffer
Test-Knöpfe
Im Editor unter Einstellungen und in der App – lösen ein echtes Ereignis aus, auch in deiner Streaming-Software:
- Vorschau: Antworten anzeigen (schreibt nichts)
- Testnachricht in den Chat schreiben
- Zufallsgenerator würfeln (schreibt nichts)
Vorlagen
| Vorlage | Beschreibung |
|---|---|
| Bot-Antwort einblenden | Jede Antwort des Bots erscheint kurz im Bild – mit Befehl und Fragendem |
| Befehle-Leiste | Zeigt dauerhaft, welche Befehle der Bot kennt |
| Bot-Status | Kleines Abzeichen, solange der Bot verbunden ist – mit LIVE-Hinweis |