# Overlay mit Streamer.bot verbinden

> Gewinner kassieren automatisch, ganz ohne manuelles Nachbuchen.

published: 2026-07-01 | updated: 2026-08-17 | source: https://twitch-overlays.coding-freaks.com/anleitung/overlay-mit-streamer-bot-verbinden

Ohne Bot zeigt das Overlay nur an, welcher Befehl abgeschickt werden müsste, und du tippst ihn selbst. Mit [Streamer.bot](https://streamer.bot/) fällt dieser Schritt weg, und Spiele mit Einsatz können obendrein Kontostände lesen. Gemeint sind die Punkte deines Chatbots, nicht die [Twitch-Kanalpunkte](https://twitch-overlays.coding-freaks.com/wissen/twitch-kanalpunkte-einrichten).

## 1. Den WebSocket-Server in Streamer.bot starten

Streamer.bot bringt einen kleinen Server mit, über den andere Programme mit ihm sprechen können. Genau den nutzt das Overlay. Geh in Streamer.bot auf Servers/Clients, dann WebSocket Server, setz Auto-Start auf an, Adresse `127.0.0.1` und Port `8080`. Ein Passwort brauchst du für diesen Weg nicht.

## 2. Das Importpaket in Streamer.bot einspielen

Streamer.bot muss drei benannte Aktionen kennen: eine, die eine Nachricht in den Chat schickt, und zwei, die Punkte buchen und Kontostände lesen. Alle drei stecken in einem Paket. Lade [die Datei](https://twitch-overlays.coding-freaks.com/downloads/streamerbot/coding-freaks-overlays.sb) herunter, geh in Streamer.bot oben auf Import und zieh sie in das Feld. Der Dialog zeigt dir, was er einspielt, ein Klick legt die Aktionen in der Gruppe `Overlay` an. Einstellen musst du daran nichts.

Wenn du eine eigene Aktion namens `OverlayChat` schon von Hand angelegt hast, lösch sie vorher. Sonst stehen zwei Aktionen mit demselben Namen in Streamer.bot, und dann ist nicht mehr gesagt, welche der Chatweg trifft.

## 3. Das Overlay auf Streamer.bot umstellen

Im [Config Hub](https://twitch-overlays.coding-freaks.com/einrichten/) wählst du unter Verbindung als Bot Streamer.bot aus. Dann trägst du die Adresse `ws://127.0.0.1:8080/` ein, darunter stehen die drei Aktionsnamen aus Schritt 2 schon richtig da: `OverlayChat`, `Overlay Add Points` und `Overlay Get Points`. Ein Klick auf Änderungen übernehmen schreibt alles in die `config.js` jedes Overlays in deinem Ordner, du machst das also nur einmal. Wer die Datei lieber selbst bearbeitet, setzt dort dieselben Werte: `outputSource` auf `streamerbot`, dazu `streamerbotUrl`, `streamerbotChatAction`, `streamerbotPointsAction` und `streamerbotBalanceAction`.

## 4. Verbindung prüfen

Aktualisiere das Overlay in OBS. Wenn in der `config.js` `debug` auf `true` steht, blendet das Overlay oben ein kleines Statusfeld ein. Steht dort `streamerbot: armed`, ist die Verbindung da. Eine Testrunde zahlt jetzt automatisch aus, und du kannst `debug` danach wieder ausschalten.

## Häufige Fragen

### Was legt das Paket in Streamer.bot an?

Drei Aktionen in der Gruppe Overlay. `OverlayChat` schickt eine übergebene Nachricht in den Chat, das ist der Weg für Ansagen und Auszahlungsbefehle. `Overlay Add Points` bucht Punkte direkt, mit Vorzeichen und ohne eine Zeile in den Chat zu schreiben. `Overlay Get Points` liest einen Kontostand und schickt ihn zurück. Alle drei greifen auf dieselbe Nutzervariable zu wie Currency Core, deine bestehenden Punktebefehle ändern sich also nicht.

Zwei Dinge macht die Buchungsaktion anders als Currency Core: sie lehnt einen Abzug ab, der dein Konto ins Minus schreiben würde, und sie meldet dem Overlay zurück, ob gebucht wurde. Ohne diese Rückmeldung bucht das Overlay gar nicht erst.

### Kann ich die Aktionen auch von Hand anlegen?

Die Chat-Aktion ja: im Reiter Actions per Rechtsklick eine neue Aktion anlegen und `OverlayChat` nennen, rechts daneben per Rechtsklick eine Unteraktion hinzufügen, Twitch, dann Send Message, als Nachricht genau `%text%` eintragen, mit den Prozentzeichen. Das ist der Platzhalter, in den das Overlay seinen Text einsetzt. Die beiden Punkte-Aktionen tragen C#-Code und lassen sich nicht abtippen. Wer nur Auszahlungsbefehle im Chat braucht, kommt mit der Chat-Aktion allein aus.

### Wie spiele ich eine neuere Fassung des Pakets ein?

Erst die Aktion löschen, dann importieren. Streamer.bot ersetzt beim Import zwar die Aktion, lässt den Code darin aber unangetastet: ein einfacher Neuimport bringt dir also die neuen Namen und den alten Inhalt. Gemessen am 17.08.2026. Lösch in Streamer.bot unter Actions die Aktion, um die es geht (bei Punkten `Overlay Add Points`), und importier die Datei danach neu.

### Wofür ist die Kontostand-Aktion gut?

Ein Spiel mit Einsatz muss wissen, ob jemand genug Punkte hat, bevor es abbucht. Ohne diese Aktion kennt das Overlay keinen Kontostand und läuft im Spaßmodus: gespielt wird, aber es bewegt sich nichts. Für Overlays, die nur auszahlen, reicht `Overlay Add Points`.

### Warum der Umweg über eine Aktion und nicht einfach ein Passwort?

Weil der direkte Weg in Streamer.bot 1.0.x gesperrt ist. Die Version fragt beim Verbinden kein Passwort mehr ab, blockiert das direkte Senden von Chatnachrichten aber weiterhin. Ein Passwort einzutragen hilft also nicht, weil es nie abgefragt wird. Der Weg über die Aktion braucht keine Anmeldung und funktioniert.

### Es steht nicht armed da, sondern etwas anderes

Dann erreicht das Overlay den Server nicht. Läuft Streamer.bot überhaupt, steht der WebSocket-Server auf Auto-Start, und stimmen Adresse und Port mit dem überein, was in der `config.js` unter `streamerbotUrl` steht? Der häufigste Fall ist ein anderer Port.

### Geht das auch mit StreamElements oder Firebot?

Ja, und dort sogar direkter: [StreamElements](https://streamelements.com/) und [Firebot](https://firebot.app/) buchen die Punkte über ihre eigene Schnittstelle, ganz ohne sichtbare Chatnachricht. In der `config.js` stellst du `outputSource` auf `streamelements` oder `firebot` und trägst die passenden Zugangsdaten ein. Welcher Dienst wofür taugt, vergleiche ich im [Artikel zu den Alternativen](https://twitch-overlays.coding-freaks.com/wissen/streamelements-alternative).

### Was passiert ganz ohne Bot?

Das Overlay blendet einen fertigen Auszahlungsbefehl ein, zum Beispiel `!addpoints name betrag`. Den kann dein bestehender Loyalty-Bot ausführen, oder du tippst ihn selbst. Es geht also nichts verloren, es ist nur Handarbeit.
