Activities and minted coins
Activities turn viewers' requests and votes into a game. A viewer earns minted coins for requesting songs and voting, and then spends them in your shop: pays for a paid song, takes a "Shout-out on stream", or buys any other item you came up with.
What you need to know right away:
- Coins cannot be bought for money, passed to another viewer or withdrawn. There is no "rubles to coins" rate: donations, subscriptions and bits do not give coins.
- Coins work only in your channel: every streamer has their own viewer coin box.
- Rewards are fixed, and you set their size. It does not depend on the donation amount.
- You can award coins by hand and take them away (a penalty), with a reason. All of this goes into a log that cannot be edited after the fact.
- The feature is available on all plans and is off by default.
How it looks for viewers: Minted coins for viewers.
How to turn it on
- Open Settings → Activities and switch on "Activities are on".
- All the settings appear below it. They save on their own a couple of seconds after you change them; there is no "Save" button.
- A new item "Activities" appears in the channel menu (between "Learn" and "Stats"). It is a page for viewers, and for you it also holds a hidden control panel.
Right after you turn it on, three rules work: the reward for a request, progression per stream and the reward for a vote in Learn. The other rules, the shop and paying with coins are off until you turn them on.
What happens if you turn it off
Viewers' balances are kept, and everything else stops: coins are not awarded or spent, the "Activities" page and the coin box icon disappear for viewers, and paying with a coin is not offered in the request and voting windows. Shop requests that are waiting for your answer are returned to viewers immediately: if there are any, the switch asks for confirmation first, and viewers get a notification. Turn the feature on again and everything continues with the same balances.
The viewer's coin box
Coins are collected in a coin box. A viewer opens it themselves with the "Open the coin box" button on the "Activities" page or at the icon next to the bell. You do not get a list of everyone who visited your channel: the list contains only those who opened a coin box.
- A coin box can only be opened after signing in to the site. Anonymous viewers do not collect coins, even if they request songs.
- The channel owner has no coin box: there is nothing to collect in your own channel. The owner sees the shop on the "Activities" page the same way viewers do, but view-only: the buy buttons are disabled. Administrators see the same until they open their own coin box.
- An administrator can open a coin box. Coins come into it only through manual awards (from you or another administrator) and are spent in the shop. An administrator gets no automatic rewards: not for their own requests, not for votes in Learn, and no welcome bonus. Paying with a coin for songs and votes is not offered to them: requests and votes are free for administrators anyway. More: Administration.
- Every coin box gets a random code of eight characters. You use it to choose the recipient of a reward, and it reveals nothing about the person.
Rules and rewards
In Settings → Activities → "What earns coins" you switch on the rules you need and set the reward (from 0 to 100,000 coins; zero means "award nothing").
| Rule | When it is awarded | Default |
|---|---|---|
| A requested song is played | You marked a viewer's request as "played" | 5, on |
| Progression per stream | The number of a viewer's played requests during one stream reached a threshold | +5 on the 3rd request and +10 on the 5th, on |
| A vote in Learn a song | The vote is counted, once per vote round | 10, on |
| First request of the stream | A viewer's first played request of the stream | 5, off |
| Welcome coins | The viewer opened a coin box and has a confirmed platform | 5, off |
| A win in Learn a song | The song the viewer voted for won the draw | 5, off |
| An original song is played | Your song marked "Original song" and requested by a viewer was played | 5, off |
What to know about the rules:
- Progression adds to the reward for a request. With the default values, three played requests per stream give 5 + 5 + 5 + 5 = 20 coins, and five requests give 40 coins. The thresholds and their rewards can be edited. A threshold counts when the number of requests equals it exactly, and a skipped threshold is not paid later.
- "Per stream" means "during one broadcast". Progression and per-stream limits work while a broadcast is going on (BardWay learns about it from the platform). If a request is played outside a broadcast, or BardWay considers the broadcast lost (it has been going on for more than a day), the reward for the request is still paid, but progression is not. "First request of the stream" is then paid once a day, by UTC.
- A vote in Learn works while the Learn block is on. Only signed-in viewers get coins: a guest's vote (when voting is open to guests) does not bring them. A vote held back by banned words brings coins when you allow it. If you later exclude the song, the coins for the vote stay with the viewer. A viewer gets the reward for a vote once per vote round.
- Welcome coins are paid only at the moment the coin box is opened, and only if the viewer already has a confirmed platform (Identity confirmation). If they confirm it later, they get no coins for it.
- The reward for a song is awarded at the moment you mark it "played", and only if the person who requested it has a coin box open by then. Pressing again does not award a second reward. Coins are not paid retroactively to those who opened a coin box later.
Whose requests bring coins
| Where the request came from | Coins |
|---|---|
| The site, the viewer is signed in | Yes, if they have a coin box open |
| Twitch chat | Yes, if the nick has a coin box and this nick is confirmed for the viewer in BardWay |
| A donation with a name the donor entered | Only if the name matches the confirmed Twitch nick of a viewer with a coin box open |
| A donation without a name | No |
| An anonymous request on the site | No |
| The Twitch extension panel | Yes, if the viewer allowed the extension to show their Twitch name and it matched the confirmed nick (without the permission Twitch does not say who it is, and there are no coins) |
| A request by the channel owner | No |
| A request by an administrator added in BardWay | No, such requests are free and without limits |
The size of the reward for a song does not depend on the donation amount: it is a reward for a request, not an exchange of money for coins. A request paid for with coins is rewarded by the same rules.
Limits
The "Limits" block protects the economy from abuse. Zero in all the fields means "no limit".
- At most per stream: how many coins a viewer can get automatically during one broadcast.
- At most per day: the same for a calendar day by UTC.
- Manual award maximum: the cap for a single award from the panel, 1000 by default.
The per-stream and per-day limits apply to all automatic rewards, including the games of Music break. If less is left before the cap than the rule says, the viewer gets the remainder. Manual awards and refunds are not subject to them. When the cap is reached, the viewer sees it on their "Activities" page: "This stream's coin limit is reached" or "Today's coin limit is reached".
Your own tasks
The "Your own tasks" block is what you come up with yourself: "Idea for the stream", "Guess what I play". All viewers see the tasks in the "How to earn coins" list, and the ones you marked "Show on the board" are also on the notice board.
- You count a task as done yourself: the reward is shown to viewers as a guide, and you award the coins by hand from the control panel (you can pick any amount). Coins are not awarded for a task by themselves. The reward for the number of requests per stream is given by the system rule "Progression per stream".
- A task has a title and a description in Russian and English (filling in one language is enough: the other will use the same text), an icon from a set, an "Enabled" switch and "Show on the board".
- The list can hold at most 50 tasks.
The shop
The shop is what viewers spend coins on. On the "Activities" page it has two places:
- Stalls: at most 10 items.
- Notice board: at most 5 cards, with tasks and activity items.
On a wide screen the shop looks like a drawn scene with stalls and a board, and on a narrow one like an ordinary list. A viewer can switch to the list themselves.
The counters "Shelf places taken: X of 10" and "On the board: X of 5" are shown in the settings. If you try to switch on something over the limit, the switch will not let you, and saving will not go through until you free up space. Switched-off items and tasks do not take up space.
Paying with coins for songs and votes
The "Shop and prices" block contains four ready-made ways to pay with coins. They take up places on the stalls when they are on and available:
| Way | Default price | Where the viewer sees it |
|---|---|---|
| Paid song | 500 | In the request window of a paid song, next to the donation |
| Paid vote in Learn a song | 100 | In the voting form, instead of a donation |
| Extra vote in Learn a song | 50, up to 1 per viewer per vote round | In the voting form, a vote for another song on top of the free ones |
| Request over the limit | 500 | In the request window, when the viewer has run out of their limit and buyout is on |
The price is from 1 to 1,000,000. The number of extra votes per viewer per vote round can be set from 1 to 10.
When the roulette is on, the same block has one more item, "Buy a roulette spin", with the price of one spin. It does not take up places on the stalls and does not need donations: see the "Activity roulette" section below.
These ways appear only if donations are available for the channel and there is something to pay for. Otherwise they are simply not in the settings, and the viewer is not offered the button:
- Paid song: donations are available (Pro plan and above) and switched on, and the catalog has at least one active song with the "Paid request (via donation service)" flag. Like a request for a donation, it does not count against the viewer's limit only if you have "Paid songs bypass limits" on.
- Request over the limit: donations are available and "Buyout when the limit is exhausted" is on in Settings → Queue. Coins pay only for the buyout itself. They do not unlock a paid song beyond the limit.
- Paid and extra vote: donations are available, Learn is on and "Donation votes" is on in it. A vote can be paid for while songs are being collected.
A song paid for with coins goes into the queue at once, and the coins are taken at that same moment. If you remove an unplayed song paid for with coins from the queue, the coins go back to the viewer automatically (a played song is not refunded). A vote paid for with a coin is returned when you exclude the song or cancel the vote round in Learn. If you later allow the song back, the coins are not taken again. In the Learn panel such votes are marked with a coin icon and counted separately from donations.
Administrators and the owner do not need to pay with coins: requests and votes are free for them.
Your own items and activities
The "Your own goods and activities" block is what you sell for coins yourself. For each item:
- a title and a description in two languages (80 and 300 characters), an icon;
- the price in coins;
- the kind: goods (you do something for the viewer) or activity (an action on stream, shown in the overlay as the chosen activity);
- where to show it: on a stall or on the board;
- a limit per viewer and a total limit: when the stock runs out, the item shows as sold out. Pending and fulfilled requests are counted; refunded ones free up the spot;
- the "Enabled" switch.
The list can hold at most 50 items in total.
How a purchase goes:
- The viewer clicks an item and confirms. The coins are taken at once, and the request gets the status "Waiting to be fulfilled".
- You get a notification in the bell, "New shop order". If you switched on the bot event in the settings, the chat will also announce it.
- On the "Activities" page, in the "Shop requests" panel, you click "Done" or "Reject". When rejecting you can give a reason, and the coins go back at once to the viewer.
- Until the request is handled, the viewer can cancel it themselves, and the coins go back.
- If you do not answer in time, the coins go back on their own. The period is set by the "How many days a request waits" field: from 1 to 30 days, 7 by default. It is checked once an hour.
The viewer gets a notification for every outcome: done, rejected (with your reason), a refund on timeout or because activities were switched off.
Ready-made templates
The "From a template" button in the tasks and items blocks opens a ready-made catalog. The added copy is switched off, you can change its title, reward and price, and a later update of the catalog will not affect your copy. A template you have already added is marked "Added". A template you renamed is still recognized as added.
- Tasks: "Guess what I play" (20, on the board), "Idea for the stream" (10), "Help the stream" (15), "Best song of the evening" (10, on the board). The "Guess the melody" game with automatic checking of answers is in Music break (PRO+), and its reward is set there.
- Items: "Song outside the catalogue" (300), "Shout-out on stream" (150), "Pick the next game or topic" (200, an activity on the board), "Question to the streamer" (100), "Choose a song to break down" (400), "Repeat a song today" (150).
The amount in task templates is a suggested reward: you award the coins by hand.
The control panel
On the "Activities" page the owner and administrators have a hidden panel, "Coins: management". Viewers do not see it. The panel can be collapsed, and the screen shows the number of pending requests and open coin boxes.
Manual award
The "Manual award" button opens a window:
- Choose the recipient from the list of open coin boxes. You see the name, avatar, balance and the viewer's platforms marked "confirmed" or "not confirmed". Under an unconfirmed nick a viewer could have used someone else's name: check that the reward goes to the right person.
- Enter an amount from 1 to the manual award maximum (1000 by default).
- Enter a reason (up to 200 characters). The viewer will see it in the notification.
You cannot award coins to yourself: neither an administrator nor the owner (the owner has no coin box anyway). You can award another administrator. The viewer gets a notification in the bell. If the "Manual award" bot event is on, the chat will also announce it (the bot does not write about automatic rewards).
Penalty
The "Penalty" button takes coins away. The reason is required and goes into the viewer's notification. If the balance is less than what you wanted to take, everything available is taken: the balance never goes negative. You cannot penalize yourself either.
Freezing
In the award window you can freeze a coin box. A frozen coin box does not receive coins and does not spend them. Refunds and penalties still go through. You cannot freeze your own coin box.
Events in the overlay
When a viewer pays with a coin, you can show it on stream: a spinning coin drops from the top, and next to it a short caption, "Nick paid for a song request with a minted coin". Events appear for:
- a paid song and a request over the limit;
- a paid and an extra vote;
- buying an item or choosing an activity (at the moment of purchase, not of fulfillment);
- the result of a Music break game.
Switch on "Show events in the overlay" in the "Events in the overlay" block. It is off by default. This switch does not depend on the queue overlay: events are shown even if the queue in OBS is off. The events block is part of the main overlay link, "All blocks: queue, draw, events and roulette". Where on the frame the events appear (top center by default) is set in Settings → Overlay → Position on screen: OBS overlay.
The caption shows only the nick of the confirmed platform. If the platform is not confirmed or the viewer chose "Anonymous", the word "Anonymous" is shown. There are no balances or personal data in it. An event that happened before the source was opened in OBS is not shown, and events are kept only for a few minutes. If the events block is not connected in OBS, purchase requests are visible to you only in the panel and in notifications.
Activity roulette
The roulette is part of the activities. You make a list of things to do ("play the next song slower", "do 10 squats"), and the channel collects a shared progress. When enough is collected for a spin, you spin a guitar neck with your activities, and what lands is visible on stream. Viewers can also buy a whole spin for coins. The feature is available on all plans and is off by default.
How to turn it on and set it up
The roulette works only when "Activities are on" is switched on. Open Settings → Activities, the "Activity roulette" card:
- "Cost of one spin": when the progress reaches this amount, a spin becomes available. You can change it at any time, and the accumulated progress stays.
- "Sectors": the activities that can land. At most 12, a title in Russian or English (one is enough, up to 80 characters), and the order is changed with the up and down buttons. You can spin when there are at least two sectors. Viewers do not see the list, only what lands on stream.
- "Repeats": "Free" (a sector can land again right away), "Cooldown" (a sector that landed sits out the next few spins; you set the number in the "Spins a sector sits out" field, from 1 to the number of sectors minus one), "Once" (the sector will not land until a reset: a manual one or on a stream change). If all the sectors are sitting out, the circle starts over.
- "Link for OBS" leads to the overlay page: the ribbon is part of the main link, and its place on the screen and width (the ribbon scales as a whole) are set in the same place, in "Position on screen". By default the ribbon sits at the bottom center: OBS overlay.
Buying a spin with coins is set up in the "Shop and prices" block: the "Buy a roulette spin" switch and "Spin price in coins" (from 1 to 1,000,000, 500 by default). There is no rate: one purchase is one whole spin. This way does not take up places on the stalls, and it does not need donations. The item is visible while the roulette is on.
The panel on the "Activities" page
The owner and administrators get the "Activity roulette" block on the "Activities" page (viewers do not see it, and it is not available in the demo project). It shows the progress, the number of ready spins and how many of them were bought with coins:
- "Progress": set an exact number, with the "Set" button. A nonzero number changes only the progress. 0 is a full reset, like the "Reset progress" button.
- "Top up": add to the progress, with the "Add" button. You cannot subtract: fix a mistake through the "Progress" field.
- "Reset progress" (with confirmation) is available when there is something to reset. It clears everything: the progress, the spins bought by viewers, the history of repeats and the landed result (it disappears from the overlay). Bought spins burn, and coins are not returned to viewers.
- "Spin" first uses a spin bought with coins (the progress does not change), and when there are no bought ones, the cost of one spin from the progress. "Spin early" is free and spends nothing.
- While the landed result is not handled, a new spin is closed: click "Done" or "Re-spin". A re-spin is free and replaces the result (the previous one counts as landed for the repeat rules).
- The "Landed this stream" list shows the history, and the "Change log" shows the last 20 actions: top-ups, spins, spin purchases with coins and resets (manual, at the start or at the end of a stream).
The result stays on the overlay until you click "Done" or spin again. The bot writes nothing in chat about what landed.
How progress is counted
- Ready spins = how many times the spin cost fits into the progress plus those bought with coins. A spin from progress subtracts the cost, and the remainder stays for the next one.
- A bought spin does not touch the progress and is used first. You can hold at most 99 bought spins at a time.
- Changing the spin cost does not change the progress.
A viewer buying a spin
A viewer with an open coin box clicks the "Buy a spin for N coins" button in the "Saving up for a spin" block. One click is one spin, the coins are taken at once, and a repeated request from the same click will not take them a second time. Buying is possible only during a stream and only when the roulette has at least two sectors.
- You get a notification in the bell: who bought a spin and for how many coins.
- If "New shop request" is on in the "Bot messages" block, the bot writes a line about the purchase in chat ("… asked in the shop for: Roulette spin"). There is no separate bot event for the roulette.
- For the viewer the purchase shows up in "Your requests" as "Roulette spin", with no cancel or refund.
What viewers see
Only the progress with the number of ready spins (on the "Activities" page and in the overlay) and what lands on stream. If you switched on buying with coins, the "Saving up for a spin" block gets a buy button with a warning that coins are not returned. More: Minted coins.
The bot
The Twitch bot can do two things about coins. Both belong to the optional chat bot: if the bot is off, everything else in activities works.
- The
!balancecommand (alias!coins) tells the viewer how many coins they have. It answers only those who have a coin box open and a confirmed Twitch nick, and stays silent for the others. Add it from the templates in Settings → Bot → Commands. - Bot events are switched on in the "Bot messages" block on the activity settings page: "Manual award" (when you awarded a viewer by hand) and "New shop request" (it also reports a roulette spin bought with coins). Until you switch them on, the chat writes nothing. The texts are edited on the bot page.
Economy estimate
The "Economy estimate" block is at the very end of the settings page and shows what your rewards and prices look like in numbers. It calculates from the saved settings and your latest finished streams (up to 10, at least 10 minutes long):
- how many coins a viewer earns per stream on average and how many at the maximum, if they use the whole request limit;
- how many streams a viewer needs to save up for a paid song, a vote or a buyout;
- a table by viewer type: viewer, follower, subscribers of three tiers.
If there are fewer than three finished streams or fewer than five people who requested songs, the estimate is marked as an estimate and uses the default values (2 requests and 1 vote per viewer per stream).
Below it are risk hints. They are not prohibitions, and the settings are saved in any case:
- no reward is switched on;
- the reward for a paid song or vote is not less than its price, meaning the viewer pays back the purchase themselves;
- the progression step is unreachable at the viewer's highest request limit;
- saving up for an item takes too long (100 streams or more) or is too fast (less than one stream);
- the stalls are almost full (9 of 10).
The viewer's way to the coin box
The "The viewer's way to a coin box" counters (the step at which guests drop off on the way to their coin box) are not in the settings but on the "Stats" page, as the last block. Only the owner and admins see them, and the "Stats" page itself is part of the PRO+ plan. More: Channel stats.
FAQ
Can I sell coins for money?
No, neither directly nor indirectly. Coins appear only as a reward for actions and as your awards, and viewers cannot pass them to each other or withdraw them.
A viewer says they requested a song, but the coins did not arrive.
Check in order: whether they had a coin box open before you marked the song "played"; whether they requested from the site after signing in, and if from chat, whether their Twitch nick is confirmed in BardWay and whether the channel has a second connected platform (see the warning above); whether the "A requested song is played" rule is on and whether you hit the limits. If needed, award the coins by hand.
What happens to the coins if a viewer merged accounts?
Their coin boxes are kept: if both accounts had coins in your channel, they are added together.
Can I give coins for an idea or help?
Yes. That is what manual awards and one-off tasks are for.
A viewer paid for an item, but I do not see it.
Requests are shown in the "Shop requests" panel and in the bell. If you switched activities off, all waiting requests have gone back to viewers.