Chat bot and commands

The bot takes song requests from chat and replies to viewers on its own: added to the queue, song not found, queue full.

How to enable the bot

  1. Open Settings → Bot and enable the bot (or use the switch on the "General" page).
  2. In your Twitch chat, run the /mod command with the bot's login. It is shown on the page and can be copied with a button.
  3. Done. The bot joins the chat by itself when your stream starts. Setup is one-off: you do not need to do anything for each stream.

If you do not see the bot in the settings, the chat bot is not included in your project's plan.

The bot on YouTube

On YouTube the bot posts from a separate channel, BardWayBot, and joins the chat when your stream starts. Make it a moderator of your channel, once:

  1. Open YouTube Studio → Settings → Community.
  2. In the "Standard moderators" block press "Manage" and add the bot's channel by this link https://www.youtube.com/channel/UCf99y9DDs7EFsKLhPFymGiQ (you can copy it on the Settings → Bot page, the YouTube tab).

The standard moderator level is enough. Without it YouTube's filters (links, slow mode, members-only mode) can hide the bot's replies from viewers.

When the chat is quiet, the bot's reply on YouTube may take up to a minute; when the chat is busy, the bot replies quickly.

Built-in commands

CommandWhat it does
!srRequest a song, for example !sr Zombie
!songShow which song is playing now
!nextShow the next songs in the queue
!sqA link to the song queue
!srs on / !srs offOpen and close the queue
!balance / !coinsTell the viewer how many coins they have. Template only, see Activities and minted coins
!answer, !voteAnswer and vote in Music break games. Template only, see Music break

The "Postpone order" command (!defer) and "I'm back" (!back, !resume) are also added from the "Templates" in the command editor: they do not appear in the project on their own. !defer 5 and !defer 10 postpone a viewer's orders for 5 and 10 minutes, !defer without a number postpones them until removed, and !back removes the postponement. More: How to request a song.

The list of commands for viewers is also shown on the "Bot commands" page of your channel. You and the administrators also see the "admins only" commands there, with a mark. Viewers do not see them.

Your own commands and aliases

In Settings → Bot → Commands you can:

  • add a command: a key (for example !sr), the bot's reply text and a description;
  • add aliases, that is, other names for the same command;
  • make a command admins and owner only. In chat, such a command can be run by you, the moderators of your Twitch channel and the channel administrators in BardWay, if they write from the Twitch account they use to sign in to the site;
  • insert placeholders into the reply text with buttons (viewer name, song and so on);
  • pick a ready-made template: its settings fill the form, and you only need to save.

The action type "Just reply" outputs text only, with no side effects.

Events

The bot also replies to queue events. They fire when something happens on the channel: the queue is full, the song has already been played, a viewer has used up their limit. In Settings → Bot → Events you can change the reply text or pick a ready-made template. You can turn events off entirely with one switch.

Coin events, "Manual award" and "New shop request", are turned on in the activities settings, see Activities and minted coins.

Plans

On Free the built-in commands and up to 5 of your own are available. On Pro the number of your own commands is unlimited. Details: Plans.

Frequently asked questions

What should I do if the bot does not reply in chat?

Check that the bot is enabled, that you ran /mod with its login, and that the stream is on: the bot joins the chat when the stream starts. On YouTube also check that the bot's channel is made a moderator.

How does a viewer request a song?

Write !sr and the song title in chat, or pick a song on your public page.

How do I close the queue with a command?

The !srs off command closes the queue, and !srs on opens it.