All systems OKView Status
// STREAMION.BOT DOCS

All about streamion.bot.

Sign-in flow, chat commands, event responses, alerts, music integrations — the full reference for your bot configuration.

Buddies

Buddies is an interactive minigame overlay: each viewer can spawn their own little animated buddy that walks around on your stream, and steer it with chat commands. It runs as a browser source in OBS, on top of your scene — a fun way to get chat onto the screen.

Buddies is a streamion.bot Pro feature. The overlay only runs while Pro is active for your channel. You'll find the page under Games → Buddies (/buddies) once it's unlocked.

Adding the overlay in OBS

The Buddies page shows a Browser source URL with a copy button. To set it up:

  1. In OBS, add a Browser source and paste the URL.
  2. Set its size to 1920×1080.
  3. Add a Chroma Key filter to the source, set to Custom colour #FF00FF (magenta). The overlay renders on a magenta background, and the filter makes it transparent so only the buddies show over your scene.

Buddies uses the same overlay connection as your alert overlays — the token in the URL is your channel's one overlay token. If you regenerate that token (on the Alerts page), every overlay reconnects, so update the URLs together. Keep the URL private: anyone with it can connect to your overlay.

Chat commands

These come built into streamion.bot. Like every built-in, their triggers, permissions, and cooldowns can be changed on the Commands page.

CommandWhoWhat it does
!buddyEveryoneSpawns the viewer's own buddy on the overlay. !buddy 1 / !buddy 2 also picks the body type
!jumpEveryoneMakes their buddy jump
!danceEveryoneMakes their buddy dance
!buddies on / off / clearModeratorEnables, pauses, or clears all buddies

Each viewer gets their own buddy, and the bot remembers how it looks — so it comes back the same each time. The streamer's own buddy is always on stage.

Customising a buddy

Viewers can recolour four parts of their buddy, free and as often as they like:

CommandColours
!skin <colour>Skin
!hair <colour>Hair
!shirt <colour>Top
!pants <colour>Trousers

A colour can be a name (red, blue, green, purple, pink, cyan, white, black, grey, brown, …) or a hex value like #33cc88. German colour names work too, and each command has a German alias (!haut, !haare, !oberteil, !hose).

Magenta and near-magenta shades are rejected — they would disappear against the overlay's background.

If the buddy is already on stage the new colour just appears on it; if not, it's saved for the next !buddy.

The buddy shop

Outfits and weapons are bought once and kept forever, then worn whenever the viewer likes.

CommandWhoWhat it does
!bshopEveryoneLists the items and their prices in chat
!buy <item>EveryoneBuys an item — and puts it on straight away
!outfit <item> / !outfit noneEveryoneWears / removes an owned outfit
!weapon <item> / !weapon noneEveryoneWears / removes an owned weapon

What's on offer, priced in loyalty points:

ItemTypePoints
BeanieOutfit150
CapOutfit150
Wizard HatOutfit500
Iron HelmetOutfit700
ShirtOutfit900
DaggerWeapon250
SwordWeapon400
MaceWeapon550
SpearWeapon650
Battle AxeWeapon700
BowWeapon800

(The outfit called Shirt is body armour — to recolour the buddy's top, use !shirt <colour> instead.)

Three ways to buy

  • Loyalty points!buy sword. Needs Loyalty points switched on for your channel.
  • Bits — cheer and put !buy wizard hat in the cheer message. Only some items have a bits price (Wizard Hat, Iron Helmet, Shirt, Battle Axe, Bow).
  • Channel points — create a Twitch reward with the Buddy item action on the Channel Points page; the viewer types the item name when redeeming. An unknown or already-owned item refunds the points automatically.

An item can't be bought twice, and a viewer can only wear what they own.

Good to know

  • Up to 25 buddies can be on screen at once. When it's full, new !buddy requests are turned away until there's room again.
  • A buddy that's been idle for about 10 minutes leaves the stage on its own (the streamer's stays).
  • Moderators can pause spawning with !buddies off (e.g. during a serious moment) and clear the stage with !buddies clear.