Bot Befehle

Hier verwaltest du die standardmäßigen und deine eigenen Befehle des Bots, die im Chat genutzt werden können.

Übersicht im Dashboard

Auf dieser Seite verwaltest du in drei Tabs Standardbefehle, eigene Commands und Sound-Commands und passt Rechte, Cooldowns sowie Antworten an.

Standard Befehle

Die Standard-Befehle sind in vier Kategorien unterteilt: Information · Moderation · Stream-Management · Utility

Alle Befehle können im Dashboard individuell konfiguriert werden.

Eigene Befehle

Unter diesem Tab kannst du deine eigenen Befehle anlegen und verwalten. Vergib unter Befehl einen Namen und rechts daneben unter Antwort den Text, den der Bot im Chat posten soll. Du kannst beim Anlegen auch Aliase einstellen, also alternative Namen für den Befehl. Sobald der Befehl angelegt ist, hast du die gleichen Einstellmöglichkeiten wie bei den Standardbefehlen (siehe Konfigurationsfelder unten). Unten rechts findest du den Button Variablen mit allen verfügbaren Platzhaltern.

Vorlagen

Wenn du neu bei Bot-Befehlen bist, hilft dir der Button Vorlagen. Die Vorlagen sind bewusst so gewählt, dass sie dir zeigen, wie Variablen funktionieren, aufgeteilt in Zuschauer ansprechen, Zufall & Spaß und Stream-Infos & Zähler.

Jede Vorlage demonstriert eine Variable, zum Beispiel:

• !lurk – $(sender) (der Name dessen, der den Befehl schreibt)
• !hug – $(sender) und $(touser) (spricht einen anderen Chatter an)
• !slap – $(1) (der Text, den der Zuschauer hinter den Befehl schreibt)
• !dice – $(random 1 6) (Zufallszahl)
• !decide – $(randompick("Ja","Nein","Vielleicht")) (zufällige Auswahl)
• !randomclip – $(randomclip) (verlinkt einen zufälligen Clip aus deinem Kanal)
• !game – $(game) (aktuelle Stream-Kategorie)
• !deaths – $(count deaths +1) (Zähler, der bei jedem Aufruf hochzählt)

Ein Klick auf Übernehmen füllt das Anlage-Formular oben mit der Vorlage aus. Du kannst den Text noch anpassen und klickst dann auf Hinzufügen. Vorlagen werden also nicht direkt gespeichert, sondern dienen als Lern-Startpunkt. Die meisten Beispiele funktionieren sofort, ohne dass du etwas ändern musst.

Sound-Commands

Im Tab Sounds legst du Befehle an, mit denen deine Zuschauer einen Sound im Stream abspielen – zum Beispiel !airhorn oder !applaus. Der Sound kommt aus deiner Mediathek und läuft über eine Browserquelle in OBS.

Einmalig: Sound-Player in OBS einrichten

Damit ein Sound im Stream zu hören ist, braucht OBS den Sound-Player. Dafür gibt es zwei Wege – nimm genau einen, sonst läuft jeder Sound doppelt:

• Als Browserquelle: Kopiere oben im Tab unter OBS-Browserquelle den Link und füge ihn in OBS als Browserquelle hinzu. Die Quelle bleibt unsichtbar, Größe und Position sind egal.
• Im Overlay Builder: Füge deiner Szene das Widget Sound-Player hinzu. Es ist im Stream ebenfalls unsichtbar.

OBS gibt nur den Ton der Szene aus, die gerade läuft. Soll ein Sound in jeder Szene zu hören sein, muss der Sound-Player in jeder dieser Szenen stecken – zum Beispiel als gemeinsame Quelle, die du in alle Szenen einfügst.

Sound-Command anlegen

1. Öffne den Bereich Neuer Sound-Command und gib den Namen des Befehls ein.
2. Wähle unter Sound eine Datei aus deiner Mediathek oder lade über Sound hochladen eine neue hoch (MP3, AAC, M4A oder OGG).
3. Stell die Lautstärke ein.
4. Optional: Trag eine Chat-Antwort ein. Bleibt das Feld leer, spielt der Befehl nur den Sound ab.
5. Mit In OBS testen hörst du den Sound sofort über deinen Sound-Player – auch schon vor dem Speichern.

Danach gelten dieselben Einstellungen wie bei eigenen Befehlen (siehe Konfigurationsfelder und Befehlszugriff für einzelne User weiter unten). Die Cooldowns stehen bei neuen Sound-Commands bewusst höher – 10 Sekunden global, 30 Sekunden pro Zuschauer –, denn ein Sound nervt schneller als eine Chat-Zeile. Der Name darf keinem anderen Befehl in deinem Kanal gleichen, auch keinem eingebauten wie !so oder !clip.

So spielt der Sound-Player ab

• Sounds laufen nacheinander, nie übereinander.
• Es warten höchstens 5 Sounds. Was darüber hinaus ausgelöst wird, fällt weg.
• Ein Sound, der länger als 30 Sekunden warten musste, wird übersprungen, statt verspätet loszulaufen.
• Jeder Sound wird nach spätestens 30 Sekunden beendet.
• Lädst du die Quelle in OBS neu, werden bereits gespielte Sounds nicht wiederholt.

!alerts off schaltet auch die Sound-Commands stumm – bei einem Hate-Raid ist ein Sound genauso ein Angriffsweg wie eine Alert-Einblendung. Mit !alerts on geht es weiter; was in der Zwischenzeit ausgelöst wurde, wird nicht nachgeholt.

Moderatoren

Sound-Commands spielen Ton direkt auf deinem Stream. Deshalb brauchen Mods dafür ein eigenes Recht: Sound-Commands. Es ist standardmäßig aus und steht in deinem Account unter Mod-Rechte im Abschnitt Weitere Rechte. Ohne das Recht sehen Mods den Tab Sounds nicht und können bestehende Sound-Commands weder ändern noch löschen noch dafür Freigaben verteilen.

In deiner öffentlichen Befehlsübersicht sind Sound-Commands mit 🔊 Sound gekennzeichnet. Welche Datei dahintersteckt, sehen deine Zuschauer dort nicht.

Wenn kein Ton kommt

• Der Test meldet „An OBS geschickt“, aber du hörst nichts: Prüfe, ob der Sound-Player in der Szene steckt, die gerade läuft, und ob die Browserquelle in OBS stummgeschaltet ist. Steht stattdessen Alerts stummgeschaltet da, sind die Alerts per !alerts off pausiert.
• Der Player-Link ist in einem normalen Browser-Tab offen: Browser blockieren Ton, bis du einmal auf die Seite klickst. Der Sound-Player zeigt dafür einen Hinweis. In OBS passiert das nicht.
• Die Datei wurde aus der Mediathek gelöscht: Die Mediathek zeigt Dateien, die ein Sound-Command nutzt, als verwendet an. Löschst du sie trotzdem, bleibt der Befehl stumm, bis du ihm einen neuen Sound gibst.

Öffentliche Befehlsübersicht

Oben auf der Seite findest du den Link zu deiner öffentlichen Befehlsübersicht unter https://bytemate.me/commands/[deinkanal]. Über den Aktiv/Inaktiv-Schalter daneben kannst du diese Seite für deine Zuschauer ein- oder ausschalten. Wenn die Übersicht deaktiviert ist, sehen Besucher stattdessen eine kurze Hinweismeldung.

Während du live bist, zeigt die Übersicht unter deinem Namen ein Live-Abzeichen mit Streamtitel und Kategorie. Der Status wird alle zwei Minuten aktualisiert.

Konfigurationsfelder

Bei jedem Befehl können folgende Felder konfiguriert werden:

• User Level: Hier kannst du einstellen, wer diesen Befehl benutzen darf. Die eingestellte Rolle und die höher gestellten Rollen dürfen den Befehl dann auslösen.
• Moderationsbefehle: !settitle, !setgame, !nuke, !permit und die Subathon-Befehle kann nur der Kanalinhaber unter Moderator stellen, also für VIPs oder Zuschauer öffnen. Mods können den Cooldown trotzdem ändern. !settitle und !setgame stehen standardmäßig auf Moderator.
• Wann aktiv?: Befehl immer aktiv oder nur, wenn der Stream online/offline ist
• Cooldown Global/User: Die insgesamte Zeitspanne oder pro Zuschauer, bis der Befehl erneut genutzt werden darf
• Command Aliase: Alternative Namen für den Befehl, unter denen dieser auch aufrufbar ist (mit ! oder ohne eingeben und hinzufügen)
• Antwort: Hier kannst du deine eigene Antwort für die jeweiligen Befehle eingeben, ein Klick auf den Standard Button rechts oben setzt die Antwort auf die Standardeinstellung zurück. Unter der Textbox findest du die jeweiligen Variablen, die du nutzen kannst
• Länge der Antwort: Twitch nimmt 500 Zeichen pro Chat-Nachricht, und genau so viel nimmt das Feld an. Der Zähler über der Textbox zeigt dir den Stand; ist die Antwort zu lang, wird sie nicht gespeichert und du bekommst einen Hinweis. Wird eine bereits gespeicherte Antwort dennoch länger (etwa weil Variablen wie {channel} beim Posten durch längere Werte ersetzt werden), verteilt der Bot sie auf zwei Chat-Nachrichten und trennt dabei zwischen zwei Wörtern

Der Aktiv Schieberegler bei jedem Befehl aktiviert/deaktiviert diesen für den Chat.

Pro Kanal sind bis zu 500 Befehle möglich. Ist die Grenze erreicht, springt ein Schalter, der nicht gespeichert werden konnte, zurück, und du bekommst einen Hinweis.

Befehlszugriff für einzelne User (Grants)

Mit dem Grant-System kannst du einzelnen Zuschauern Zugriff auf bestimmte Befehle erteilen – auch wenn deren User-Level eigentlich zu niedrig wäre.

Im Dashboard

Jeder Befehl hat einen aufklappbaren Bereich „Spezielle Nutzerberechtigungen". Dort siehst du alle aktiven Grants für diesen Befehl und kannst:

• Einen Twitch-Login eintragen und eine Ablaufzeit wählen (Permanent, 1 Stunde, 24 Stunden, 7 Tage oder 30 Tage)
• Grants über den Entfernen-Button widerrufen

Per Chat-Befehl

Grant erteilen:

!grant @username befehl [Dauer]

• @username – Twitch-Login des Nutzers (@ ist optional)
• befehl – Name des Befehls ohne ! (z. B. uptime, so)
• Dauer – optional: 30m, 2h, 1d – ohne Angabe gilt der Grant dauerhaft

Grant entziehen:

!revoke @username befehl

!grant und !revoke sind auf Moderatoren beschränkt. Abgelaufene Grants werden automatisch deaktiviert; ein erneutes !grant verlängert die Laufzeit.

Variablen

Eine komplette Liste aller Variablen findest du im Bereich Bot Variablen. Du kannst Variablen mit $(...) oder ${...} schreiben; Positionsargumente funktionieren auch mit {1}, {2} usw.