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). Loyalty points are free for every channel.

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>. Manage the items on Loyalty Points → Shop (/loyalty/shop); 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.

Everything else lives on Loyalty Points → Leaderboard (/loyalty/leaderboard): your top viewers by balance with a search box, and below them the redemptions queue, where you mark each redemption fulfilled once you've delivered it, or refund it to return the points.

Importing points

Coming from another bot? The Import points card on the settings page takes a points list and writes the balances into streamion.bot.

• File — .csv, .json, or .txt, up to 16 MB.
• CSV — username in the first column, points in the second. Column names don't matter (a header row is skipped automatically), and comma, semicolon, or tab all work as the separator. A leading @ on the name is stripped.
• JSON — an array of entries, each with a username and a points value.

The import only raises balances, never lowers them: if a viewer already has more points here than the file says, their balance stays as it is. Viewers who don't exist yet are created. Running the same file twice changes nothing, so re-importing after a failed attempt is safe.

Rows without a name, with zero or negative points, or with a value that isn't a number are skipped; if a name appears twice in the file, the higher value wins. When it's finished, the card reports what happened and remembers the date of the last import.

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.

!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.