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)“.

Bezahlmodul – einzeln im Shop oder mit Ventoview ProVersion 2.5.0

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. cpu von 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.

Bot elements (editor → “Ventoview bot”)

You build the bot in the editor in the “Ventoview bot” tab – like layers, just for the chat: add an element at the top, select it on the left, adjust it on the right. Everything applies to all overlays and is saved in the app automatically. The eye turns an element off without deleting it; “▶ Preview” shows what the bot would write.

Element	What it does
💬 Command	Reply to a command like `!rank` – to everyone, as a reply or as a whisper, with its own pause. Several command words with commas: `!rank, !elo`. In chat people only write `!rank`.
⏱️ Timer	Message every X minutes – only live or always.
🕗 Time	Message at a fixed time, optionally only on certain weekdays.
⌨️ Shortcut	Message by key, gamepad or MIDI (Shortcuts module).
🔢 Counter	e.g. `!tod` counts up and writes `💀 Deaths: {zaehler}`. Mods also `!tod -`, `!tod reset`, `!tod 12`. Everywhere: `{zaehler_tod}`.
👋 Greeting	Whoever writes for the first time today gets greeted – again next stream.
🎉 Event	Thank-you message on follow, sub, bits, raid or channel points (Alerts module), e.g. `Thanks for the raid, {alertuser}!`

Random generators

“🎲 Generator” is its own element: first give it a name (e.g. gen1), then build the list – for each entry you can set how rarely it comes up. In an element's text you insert it with {gen1}, e.g. Hello {user}, today you play {gen1}! Have fun.

Assign: tick a box under “Belongs to” or drag the generator onto an element in the list – then it appears indented below it. If you add a generator while a command is selected, it's attached right below.
Same name = same generator: a name exists only once. A generator can hang under several elements, all use the same list.
Renaming updates the assignments and {name} in all texts automatically.
Not allowed are names that are already taken: the bot's placeholders (user, text …), the variables of all modules (even inactive ones, e.g. cpu from Basic), built-in variables and your own keywords.
Many entries at once: “Several …” opens a window – separate entries with commas or one per line.
If the same generator appears several times in a message, each draws a different entry.
{gen1} also works in timers, times, greetings and events.
If a module with the same variable comes along later (e.g. you have {metin2skill} and a new module brings {metin2skill}), the app doesn't activate that module and tells you where you use the name. After renaming it starts by itself. The same applies to the app's own keywords.
Included: !lucky with the generator lucky (80 luck sayings from gaming and anime).
Sharing: in the app on the chat bot ⚙ → “Export …” / “Import …” (.vviewbot, without your channel).

In texts you can use {user}, {text}, {glueck}, your generators like {gen1}, {zaehler_name} and all variables of your modules. Commands whose variables no module currently delivers are inactive.

When: live or always

The default “Bot only while you're live” (app → Chat bot → ⚙ or editor → Settings) applies to all elements. Each element can override it under “When”: “Like setting”, “Only live” or “Always”. In the list, 🔴 live marks the elements that only run during the stream.

The module settings (app → Chat bot → ⚙) now only contain channel, bot name, “only when live” and the default pause. Your commands, timers and random generators from older versions automatically become elements.

In the overlay: {chatbotlast} shows the last message, {chatbotzufall} the last random result.

Elementi del bot (editor → “Ventoview bot”)

Il bot lo costruisci nell'editor nella scheda “Ventoview bot” – come i livelli, ma per la chat: aggiungi un elemento in alto, selezionalo a sinistra, regolalo a destra. Tutto vale per tutti gli overlay e viene salvato automaticamente nell'app. L'occhio disattiva un elemento senza eliminarlo; “▶ Anteprima” mostra cosa scriverebbe il bot.

Elemento	Cosa fa
💬 Comando	Risposta a un comando come `!rank` – a tutti, come risposta o come whisper, con pausa propria. Più parole di comando con virgola: `!rank, !elo`. In chat si scrive solo `!rank`.
⏱️ Timer	Messaggio ogni X minuti – solo live o sempre.
🕗 Orario	Messaggio a un orario fisso, se vuoi solo in certi giorni della settimana.
⌨️ Scorciatoia	Messaggio con un tasto, gamepad o MIDI (modulo Scorciatoie).
🔢 Contatore	es. `!tod` conta e scrive `💀 Morti: {zaehler}`. I mod anche `!tod -`, `!tod reset`, `!tod 12`. Ovunque: `{zaehler_tod}`.
👋 Saluto	Chi scrive per la prima volta oggi viene salutato – di nuovo al prossimo stream.
🎉 Evento	Ringraziamento per follow, abbonamento, bits, raid o punti canale (modulo Alerts), es. `Grazie per il raid, {alertuser}!`

Generatori casuali

“🎲 Generatore” è un elemento a sé: prima dagli un nome (es. gen1), poi crea la lista – per ogni voce puoi impostare quanto raramente esce. Nel testo di un elemento lo inserisci con {gen1}, es. Ciao {user}, oggi giochi {gen1}! Buon divertimento.

Assegnare: spunta una casella in “Appartiene a” o trascina il generatore su un elemento nella lista – appare rientrato sotto. Se aggiungi un generatore mentre è selezionato un comando, viene agganciato subito sotto.
Stesso nome = stesso generatore: un nome esiste una sola volta. Un generatore può stare sotto più elementi, tutti usano la stessa lista.
Rinominare aggiorna automaticamente le assegnazioni e {nome} in tutti i testi.
Non sono ammessi nomi già occupati: segnaposto del bot (user, text …), le variabili di tutti i moduli (anche inattivi, es. cpu di Basic), variabili integrate e i tuoi keyword.
Tante voci insieme: “Più voci …” apre una finestra – separa le voci con virgole o una per riga.
Se lo stesso generatore compare più volte in un messaggio, ognuno estrae una voce diversa.
{gen1} funziona anche in timer, orari, saluti ed eventi.
Se in seguito arriva un modulo con la stessa variabile (es. hai {metin2skill} e un nuovo modulo porta {metin2skill}), l'app non attiva quel modulo e ti dice dove usi il nome. Dopo aver rinominato parte da solo. Lo stesso vale per i keyword dell'app.
Già incluso: !lucky con il generatore lucky (80 frasi portafortuna da gaming e anime).
Condividere: nell'app sul chat bot ⚙ → “Esporta …” / “Importa …” (.vviewbot, senza il tuo canale).

Nei testi puoi usare {user}, {text}, {glueck}, i tuoi generatori come {gen1}, {zaehler_name} e tutte le variabili dei tuoi moduli. I comandi le cui variabili nessun modulo fornisce al momento sono inattivi.

Quando: live o sempre

L'impostazione di base “Bot solo quando sei live” (app → Chat bot → ⚙ o editor → Impostazioni) vale per tutti gli elementi. Ogni elemento può cambiarla in “Quando”: “Come impostazione”, “Solo live” o “Sempre”. Nella lista 🔴 live segna gli elementi che girano solo durante lo stream.

Nelle impostazioni del modulo (app → Chat bot → ⚙) ci sono ormai solo canale, nome del bot, “solo quando live” e la pausa predefinita. I tuoi comandi, timer e generatori casuali delle versioni precedenti diventano automaticamente elementi.

Nell'overlay: {chatbotlast} mostra l'ultimo messaggio, {chatbotzufall} l'ultimo risultato casuale.

Elementos del bot (editor → “Bot de Ventoview”)

El bot se construye en el editor en la pestaña “Bot de Ventoview” – como las capas, pero para el chat: añade un elemento arriba, selecciónalo a la izquierda, ajústalo a la derecha. Todo vale para todos los overlays y se guarda automáticamente en la app. El ojo desactiva un elemento sin borrarlo; “▶ Vista previa” muestra lo que escribiría el bot.

Elemento	Qué hace
💬 Comando	Respuesta a un comando como `!rank` – a todos, como respuesta o como susurro, con pausa propia. Varias palabras de comando con comas: `!rank, !elo`. En el chat solo se escribe `!rank`.
⏱️ Temporizador	Mensaje cada X minutos – solo en directo o siempre.
🕗 Hora	Mensaje a una hora fija, si quieres solo ciertos días de la semana.
⌨️ Atajo	Mensaje con una tecla, mando o MIDI (módulo Atajos).
🔢 Contador	p. ej., `!tod` suma y escribe `💀 Muertes: {zaehler}`. Los mods también `!tod -`, `!tod reset`, `!tod 12`. En todas partes: `{zaehler_tod}`.
👋 Saludo	Quien escribe por primera vez hoy recibe un saludo – de nuevo en el próximo stream.
🎉 Evento	Mensaje de agradecimiento por follow, suscripción, bits, raid o puntos de canal (módulo Alerts), p. ej., `¡Gracias por el raid, {alertuser}!`

Generadores aleatorios

“🎲 Generador” es un elemento propio: primero dale un nombre (p. ej., gen1) y luego crea la lista – en cada entrada puedes ajustar lo rara que es. En el texto de un elemento lo insertas con {gen1}, p. ej., ¡Hola {user}, hoy juegas {gen1}! Que te diviertas.

Asignar: marca una casilla en “Pertenece a” o arrastra el generador a un elemento de la lista – aparece sangrado debajo. Si añades un generador con un comando seleccionado, se cuelga justo debajo.
Mismo nombre = mismo generador: un nombre existe solo una vez. Un generador puede colgar de varios elementos, todos usan la misma lista.
Renombrar ajusta automáticamente las asignaciones y {nombre} en todos los textos.
No se permiten nombres ya ocupados: marcadores del bot (user, text …), las variables de todos los módulos (también inactivos, p. ej., cpu de Basic), variables integradas y tus keywords.
Muchas entradas a la vez: “Varias …” abre una ventana – separa entradas con comas o una por línea.
Si el mismo generador aparece varias veces en un mensaje, cada uno saca una entrada distinta.
{gen1} también funciona en temporizadores, horas, saludos y eventos.
Si más tarde llega un módulo con la misma variable (p. ej., tienes {metin2skill} y un módulo nuevo trae {metin2skill}), la app no activa ese módulo y te dice dónde usas el nombre. Tras renombrar arranca solo. Lo mismo vale para los keywords de la app.
Incluido: !lucky con el generador lucky (80 frases de suerte de gaming y anime).
Compartir: en la app en el bot del chat ⚙ → “Exportar …” / “Importar …” (.vviewbot, sin tu canal).

En los textos puedes usar {user}, {text}, {glueck}, tus generadores como {gen1}, {zaehler_name} y todas las variables de tus módulos. Los comandos cuyas variables ningún módulo entrega ahora están inactivos.

Cuándo: en directo o siempre

El ajuste básico “Bot solo cuando estás en directo” (app → Bot del chat → ⚙ o editor → Ajustes) vale para todos los elementos. Cada elemento puede cambiarlo en “Cuándo”: “Como el ajuste”, “Solo en directo” o “Siempre”. En la lista, 🔴 directo marca los elementos que solo funcionan durante el stream.

En los ajustes del módulo (app → Bot del chat → ⚙) ya solo están el canal, el nombre del bot, “solo en directo” y la pausa estándar. Tus comandos, temporizadores y generadores de versiones anteriores se convierten automáticamente en elementos.

En el overlay: {chatbotlast} muestra el último mensaje, {chatbotzufall} el último resultado aleatorio.

Éléments du bot (éditeur → « Bot Ventoview »)

Tu construis le bot dans l'éditeur, onglet « Bot Ventoview » – comme des calques, mais pour le chat : ajoute un élément en haut, sélectionne-le à gauche, règle-le à droite. Tout vaut pour tous les overlays et est enregistré automatiquement dans l'app. L'œil désactive un élément sans le supprimer ; « ▶ Aperçu » montre ce que le bot écrirait.

Élément	Ce qu'il fait
💬 Commande	Réponse à une commande comme `!rank` – à tous, en réponse ou en chuchotement, avec sa propre pause. Plusieurs mots de commande avec des virgules : `!rank, !elo`. Dans le chat, on écrit seulement `!rank`.
⏱️ Minuteur	Message toutes les X minutes – seulement en live ou toujours.
🕗 Heure	Message à heure fixe, si tu veux seulement certains jours de la semaine.
⌨️ Raccourci	Message par touche, manette ou MIDI (module Raccourcis).
🔢 Compteur	ex. `!tod` compte et écrit `💀 Morts : {zaehler}`. Les modos aussi `!tod -`, `!tod reset`, `!tod 12`. Partout : `{zaehler_tod}`.
👋 Accueil	Qui écrit pour la première fois aujourd'hui est accueilli – à nouveau au prochain stream.
🎉 Événement	Message de remerciement pour follow, abonnement, bits, raid ou points de chaîne (module Alerts), ex. `Merci pour le raid, {alertuser} !`

Générateurs aléatoires

« 🎲 Générateur » est un élément à part : donne-lui d'abord un nom (ex. gen1), puis crée la liste – pour chaque entrée, tu règles sa rareté. Dans le texte d'un élément, tu l'insères avec {gen1}, ex. Salut {user}, aujourd'hui tu joues {gen1} ! Amuse-toi bien.

Associer : coche une case sous « Appartient à » ou glisse le générateur sur un élément de la liste – il apparaît alors en retrait dessous. Si tu ajoutes un générateur pendant qu'une commande est sélectionnée, il s'y accroche directement.
Même nom = même générateur : un nom n'existe qu'une fois. Un générateur peut être rattaché à plusieurs éléments, tous utilisent la même liste.
Renommer met à jour automatiquement les associations et {nom} dans tous les textes.
Interdits : les noms déjà pris – espaces réservés du bot (user, text …), les variables de tous les modules (même inactifs, ex. cpu de Basic), les variables intégrées et tes keywords.
Beaucoup d'entrées d'un coup : « Plusieurs … » ouvre une fenêtre – sépare les entrées par des virgules ou une par ligne.
Si le même générateur apparaît plusieurs fois dans un message, chacun tire une entrée différente.
{gen1} fonctionne aussi dans les minuteurs, heures, accueils et événements.
Si un module avec la même variable arrive plus tard (ex. tu as {metin2skill} et un nouveau module apporte {metin2skill}), l'app n'active pas ce module et t'indique où tu utilises le nom. Après le renommage, il démarre tout seul. Il en va de même pour les keywords de l'app.
Inclus : !lucky avec le générateur lucky (80 phrases porte-bonheur tirées du gaming et des animes).
Partager : dans l'app, sur le bot du chat ⚙ → « Exporter … » / « Importer … » (.vviewbot, sans ta chaîne).

Dans les textes, tu peux utiliser {user}, {text}, {glueck}, tes générateurs comme {gen1}, {zaehler_name} et toutes les variables de tes modules. Les commandes dont aucun module ne fournit actuellement les variables sont inactives.

Quand : en live ou toujours

Le réglage de base « Bot seulement quand tu es en live » (app → Bot du chat → ⚙ ou éditeur → Réglages) s'applique à tous les éléments. Chaque élément peut le remplacer sous « Quand » : « Comme le réglage », « Seulement en live » ou « Toujours ». Dans la liste, 🔴 live marque les éléments qui ne tournent que pendant le stream.

Les réglages du module (app → Bot du chat → ⚙) ne contiennent plus que la chaîne, le nom du bot, « seulement en live » et la pause par défaut. Tes commandes, minuteurs et générateurs des anciennes versions deviennent automatiquement des éléments.

Dans l'overlay : {chatbotlast} affiche le dernier message, {chatbotzufall} le dernier tirage.

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

Editor öffnen