// Overlays
Free download
Guide

Connect your overlay to Streamer.bot

Winners get paid automatically, with no manual bookkeeping.

Without a bot the overlay only shows which command would have to be sent, and you type it yourself. With Streamer.bot that step disappears, and games with a stake can read balances on top of that. That means your chat bot's own points, not Twitch channel points.

10 minutes Advanced OBS Browser Source

Step by step

// How it works

  1. 01

    Start the WebSocket server in Streamer.bot

    Streamer.bot ships a small server that lets other programs talk to it. That is exactly what the overlay uses. In Streamer.bot go to Servers/Clients, then WebSocket Server, set Auto-Start on, address 127.0.0.1 and port 8080. You do not need a password for this route.

  2. 02

    Import the package into Streamer.bot

    Streamer.bot needs to know three named actions: one that sends a message to chat, and two that book points and read balances. All three sit in one package. Download the file, go to Import in the top menu of Streamer.bot and drag it into the field. The dialog shows you what it is about to add, one click puts the actions into the Overlay group. There is nothing to configure afterwards. If you already created an action called OverlayChat by hand, delete it first. Otherwise two actions share a name in Streamer.bot, and which one the chat route hits is no longer defined.

  3. 03

    Point the overlay at Streamer.bot

    In the Config Hub, pick Streamer.bot as your bot under Connection. Then enter the address ws://127.0.0.1:8080/; below it the three action names from step 2 are already filled in correctly: OverlayChat, Overlay Add Points and Overlay Get Points. Clicking Apply changes writes all of it into the config.js of every overlay in your folder, so you only do this once. If you would rather edit the file yourself, set the same values there: outputSource to streamerbot, plus streamerbotUrl, streamerbotChatAction, streamerbotPointsAction and streamerbotBalanceAction.

  4. 04

    Check the connection

    Refresh the overlay in OBS. If debug is set to true in config.js, the overlay shows a small status pill at the top. If it reads streamerbot: armed, the connection is live. A test round now pays out automatically, and you can switch debug back off afterwards.

Frequently asked

// In short

What does the package add to Streamer.bot?

Three actions in the Overlay group. OverlayChat sends a supplied message to chat, which is the route for announcements and payout commands. Overlay Add Points books points directly, sign included, without writing a line to chat. Overlay Get Points reads a balance and sends it back. All three use the same user variable as Currency Core, so your existing point commands keep working unchanged. The booking action does two things Currency Core does not: it refuses a deduction that would push an account below zero, and it reports back whether the booking happened. Without that acknowledgement an overlay will not book at all.

Can I create the actions by hand instead?

The chat action, yes: in the Actions tab, right-click to add a new action and name it OverlayChat, then right-click in the panel on the right to add a sub-action, Twitch, then Send Message, and enter exactly %text% as the message, percent signs included. That is the placeholder the overlay fills with its text. The two point actions carry C# code and are not worth retyping. If all you need is payout commands in chat, the chat action alone is enough.

How do I install a newer version of the package?

Delete the action first, then import. Streamer.bot replaces the action on import but leaves the code inside it untouched, so a plain re-import gives you the new names with the old contents. Measured on 2026-08-17. In Streamer.bot, delete the action in question under Actions (for points that is Overlay Add Points), then import the file again.

What is the balance action for?

A game with a stake has to know whether someone has enough points before it deducts any. Without that action the overlay sees no balance and runs in fun mode: you can play, but nothing moves. Overlays that only pay out are fine with Overlay Add Points.

Why go through an action instead of just using a password?

Because the direct route is gated in Streamer.bot 1.0.x. That version no longer asks for a password when you connect, but still blocks sending chat messages directly. Entering a password does not help, because it is never requested. The action route needs no authentication and works.

It does not say armed, it says something else

Then the overlay cannot reach the server. Is Streamer.bot actually running, is the WebSocket server set to Auto-Start, and do address and port match what streamerbotUrl says in config.js? The most common case is a different port.

Does this work with StreamElements or Firebot too?

Yes, and there it is even more direct: StreamElements and Firebot book the points through their own interface, with no visible chat message at all. In config.js set outputSource to streamelements or firebot and fill in the matching credentials. Which service is good for what I compare in the article on the alternatives.

What happens with no bot at all?

The overlay shows a ready-made payout command, for example !addpoints name amount. Your existing loyalty bot can run it, or you type it yourself. Nothing is lost, it is just manual.

Last updated on August 17, 2026.

All overlays