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.

Loyalty points

Loyalty points are a channel currency your viewers earn by watching and chatting, and spend in a shop you run. You set the earn rates, name the currency, and decide what's in the shop; the bot tracks every viewer's balance and the redemption queue.

It's off by default. Turn it on and configure it on Settings → Loyalty Points (/settings/loyalty), which needs the points.manage permission — granted to the Owner and every Admin by default, and to Moderators only if you grant it on the Team page. Loyalty points are free for every workspace.

How viewers earn points

Two sources, both configurable (set either to 0 to switch it off):

  • Per minute watched — default 5 points a minute. This is presence-based: while you're live, the bot credits everyone currently in chat about once a minute, whether or not they type.
  • Per chat message — default 10 points, awarded at most once per cooldown window (default 60 seconds), so a viewer earns for chatting without farming points by spamming.

Per-minute earning needs the bot to be a moderator. Like Watchtime, it reads Twitch's "who's in chat" list, which requires the streamionbot account to be a moderator in your channel. Type /mod streamionbot in your chat, otherwise only the per-message reward works.

Naming your currency

By default the currency is called Points. Rename it (up to 32 characters) on the settings page — "Coins", "Gems", whatever fits your channel — and the new name shows up in every chat message right away, e.g. "@alice, you have 100 Gems."

The shop

The shop is the list of things viewers can buy with !redeem <item>. Add items on the settings page; each one has:

  • a name (what viewers type after !redeem),
  • a cost in points,
  • an optional custom response the bot posts when someone redeems it,
  • an active toggle.

Every redemption lands in a queue on Loyalty Points → Redemptions (/loyalty/redemptions), where you mark each one fulfilled once you've delivered it, or refund it to return the points. A leaderboard of your top viewers by balance lives on Loyalty Points → Leaderboard (/loyalty/leaderboard), with a search box to find someone specific.

Chat commands

These come built into streamion.bot and only respond while loyalty points are enabled. Like every built-in, their triggers, aliases, permissions, and cooldowns can be changed on the Commands page.

CommandAliasesWhoWhat it does
!points!balanceEveryoneShows the caller's balance
!top!leaderboardEveryoneTop viewers by balance
!shop!rewardsEveryoneLists the active shop items and their cost
!redeem <item>—EveryoneSpends points on a shop item
!givepoints <user> <amount>!addpointsModeratorGrants points to a viewer
!takepoints <user> <amount>!removepointsModeratorRemoves points from a viewer

!redeem checks the balance first: if the viewer can't afford the item, or types a name that doesn't exist, the bot tells them and nothing is spent. Balances never go below zero.