Commands and Announcements

Commands and announcements

Use Custom commands to teach the bot new chat replies, keep simple counters, and send reminders automatically.

Before you begin

1. Select the correct channel.
2. Open Channel setup.
3. Turn on Custom commands under Chat tools.
4. Open Custom commands, then Settings.

Create a reply

A reply is a saved message that one or more commands can use.

1. Expand Replies.
2. Select Add reply.
3. Give it a clear Reply name, such as welcome.
4. Write Message 1.
5. Use Add message if you want several possible messages.
6. Choose How the bot chooses those messages.

A reply must exist before you can add a chat command or announcement.

Create a chat command

1. Expand Chat commands.
2. Select Add command.
3. Enter a Command name for the dashboard.
4. Enter Command words (without !). Separate alternatives with commas, such as hello, hi.
5. Leave Turned on selected.
6. Choose whether Only moderators can use this.
7. Set Wait between uses and Who waits? if the command needs a cooldown.
8. Under What happens?, choose the action and saved Reply.
9. Select Save changes at the top of the page.

Viewers use the command by typing ! followed by one of its command words.

Add live details to a reply

BlokeBot replaces words in braces when it sends a message:

• {user} - the viewer's name.
• {channel} - the channel name.
• {args} - everything typed after the command.
• {arg1} through {arg9} - individual words after the command.
• {count} - the new value used by a counter command.

Create a counter command

1. Expand Counters and select Add counter.
2. Give the counter a name and starting Current number.
3. Add or edit a chat command.
4. Choose the counter action under What happens?.
5. Choose the counter and a reply that uses {count}.
6. Select Save changes.

Counters work well for deaths, wins, drinks, or anything else that changes one step at a time.

Create an announcement

1. Create the reply that should be sent.
2. Expand Announcements and select Add announcement.
3. Name it, choose Reply to send, and turn it on.
4. Choose When to send:
   • on a repeating timer;
   • after enough chat activity;
   • once a week.
5. Fill in the timing fields shown for that choice.
6. For weekly announcements, check the Time zone section.
7. Select Save changes.

The page shows when each announcement was last sent and how many chat messages have arrived since then. Open its Alerts section when an announcement is not being delivered.