Bot
What's a bot?
Bots allow you to perform automated actions on your chat. They can help with moderation, respond automatically to select words/phrases, play games and much more.
Creating a Bot
Chat owners can access the bot panel by going to the chat settings page (click the menu above the text box, then click "Chat Settings"). You will see a list of Bot Settings in the menu.
Bots have two tiers: Free Bots, and Premium Bots.
On the Basic plan and higher, premium bots can automatically moderate your chatroom for you, support custom responses and post scheduled messages.
On the Community plan and higher, premium bots also feature support for games.
How it works
The bot will join your chat automatically when users sign in. If all users leave, the bot waits 30 seconds and then also leaves if the chat is still empty.
Commands
| Name | Description | Parameters | Example | Default Minimum Rank | Minimum Plan Required |
|---|---|---|---|---|---|
| !say | Repeats your message in main chat or direct message | [message to say] | !say Hey guys! | Owner | Free |
| !saymain | Repeats your message in main chat | [message to say] | !say Hi everyone! | Owner | Free |
| !nickname | Changes the bot's nickname | [nickname] | !nickname CoolBot | Owner | Free |
| !exit | Turns off the bot. You can turn the bot back on via bot settings | None | !exit | Owner | Free |
| !minrank | Changes the minimum rank to use a specified command | [command name] [rank] | !minrank say visitor | Owner | Free |
| !define | Returns the definition of the word or phrase. | [word/phrase] | !define robot | Visitor | Free |
| !weather | Returns the weather for the given location. | [country/city/zip code] | !weather Miami | Visitor | Free |
| !autoregular | Turn automatically make visitors a regular on or off. This option can be fine tuned in bot settings. | [on/off] | !autoregular on | Owner | Basic and higher |
| !autoban | Turn automatically kicking/banning users for bad words on or off. This option can be fine tuned in bot settings. | [on/off] | !autoban on | Owner | Basic and higher |
| !typerace | Starts the Typerace game. | [easy/medium/hard] | !typerace medium | Moderator | Community and higher |
| !numrace | Starts the Numrace game. | [10-1000000] | !numrace 100 | Moderator | Community and higher |
| !trivia | Starts the Trivia game. | [Category number: 9-32] [Number of questions: 1-50] [Difficulty: easy/medium/hard/any] [Type: multiple/trueorfalse] | !trivia 9 25 easy multiple | Moderator | Community and higher |
| !end | End a Trivia game that's currently progress | None | !end | Moderator | Community and higher |
| !play | Play the game that's running | [message] | !play [message] | Visitor | Community and higher |
| !commands | Sends link to this page | None | !commands | Visitor | Free |
| !8ball | Provides a fun response to a yes/no question | [question here] | !8ball Are you sentient? | Visitor | Free |
| !liedetector | Provides a fun lie detector to check if a statement is true or false | [statement here] | !liedetector I did not eat the last slice of pie. | Visitor | Free |
| !better | Chooses whether option 1 or 2 is better | [option 1] or [option 2] | !better Snapchat or Instagram | Visitor | Free |
| !choose | Chooses an option | [option 1][option 2] [option 3] etc... | !choose Twitter Facebook Google+ | Visitor | Free |
| !urban | Returns the definition of a word or phrase from urban dictionary | [word/phrase] | !urban bot | Moderator | Free |
| !users | Returns how many users are connected to the chat in all channels (if applicable) | None | !users | Visitor | Free |
| !slap | [user you want to slap] | [user you want to slap] | !slap John | Visitor | Free |
| !lovetest | Will provide a percentage chance that a relationship would work out between two users | [user 1] and [user 2] | !lovetest Brian and Ashley | Visitor | Free |
| !coinflip | Flips a coin and gives you the result (heads or tails) | None | !coinflip | Visitor | Free |
| !dice | Rolls a dice and tells you what number was rolled. | [type of dice to roll e.g. a number (2, 6, 10) or a dice syntax (d20, 2d6, 6d10+4)] | !dice 6 | Visitor | Free |
| !countdown | Provides the time remaining until the given date | [date e.g. tomorrow, next week, december 25th, 12/25/20 (MM/DD/YY)] | !countdown 12/25/22 | Visitor | Free |
Premium Functions
The functions listed below are available on the Basic plan and higher.
Auto Regular
You can turn on this feature under the "General Settings" option in bot settings.
This option makes visitors a regular automatically when they join, or if they talk (depending on your settings).
You also have the option to only make visitors who are registered a regular.
Auto Moderation
Auto Moderation (also known as Auto Ban) is a feature that makes the bot automatically kick/ban users when their message contains a bad word.
You can use Minnit's default list of bad words, your chat's existing list of bad words, or both. You can also add up to 100 additional bad words to the bot.
You can also adjust the sensitivity of the filter to avoid false positives. The default sensitivity is medium.
You can use the command !autoban [on/off] to turn this feature on or off.
Phrase Reponses
Phrase Responses (also known as Auto Responses) is a feature that makes the bot send a specific message in public and/or direct message to a user whose message contains a specific word or phrases.
You can add up to 25 responses.
You can also adjust the sensitivity of the filter to avoid false positives. The default sensitivity is low.
You can use the command !autoresp [on/off] to turn this feature on or off.
Personal Responses
You can make your responses more personal by referring to the user's username or nickname in the response.
Simply include %username% or %nickname% in the response and it will be replaced with the user's corresponding username or nickname. For example, a response of "Hey %nickname%." would be replaced with "Hey John." if the user's nickname was set to "John".
Scheduled Messages
Scheduled Messages allow you to add up to 10 messages that repeat themselves on a set timer. The timer stops when everyone signs out, so the bot won't spam the chat while no one is signed in.
The minimum time to repeat a scheduled message is 1 minute and the maximum is 9999 minutes.
The timer also resets when you make changes to your scheduled messages.
Announce Current Song
This option announces the current song that's playing on the radio when it changes.
The supported radio types are:
- Shoutcast V1
- Shoutcast V2
- Icecast V2
If you're not sure what radio type to use, you can try all of the radio types and use the Test button until you find one that works.
If you're still having issues, contact us and we'll try to help.
Games
The functions listed below are available on the Community plan and higher.
Typerace
Get ready, get set, type! Typerace is the first game featured in the Bot. All users in the chat may play. Simply type !typerace to start a match. Players will read a sentence, and have to type it exactly as it's displayed, without a single mistake. First to send the proper response wins!
Numrace
Get ready, get set, guess! All users in the chat may play. Simply type !numrace to start a match. A random number between 1-10 will be picked by the bot. Players will have to guess the bot's number. The player whose guess is closest to the bot's number is the winner!
Trivia
Prove your knowledge with a fun Trivia game. Simply type !trivia to start a game. 10 questions will be asked by default in any category. Users get a point by answering a question correctly. Users with the most points win.