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. The Premium Bots can automatically moderate your chatroom for you, support custom responses, and feature support for games.
Premium Bots are available on the Basic plan and higher.
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 | Type |
|---|---|---|---|---|---|
| !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 |
| !autoregular | Turn automatically make visitors a regular on or off. This option can be fine tuned in bot settings. | [on/off] | !autoregular on | Owner | Premium only |
| !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 | Premium only |
| !typerace | Starts the Typerace game. | [easy/medium/hard] | !typerace medium | Moderator | Premium only |
| !numrace | Starts the Numrace game. | [10-1000000] | !numrace 100 | Moderator | Premium only |
| !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 | Premium only |
| !end | End a Trivia game that's currently progress | None | !end | Moderator | Premium only |
| !play | Play the game that's running | [message] | !play [message] | Visitor | Premium only |
| !define | Returns the definition of the word or phrase. This command is powered by Oxford Dictionaries and is copyrighted. Reuse of this content is not permitted. | [word/phrase] | !define robot | Visitor | Premium only |
| !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 |
| !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 subrooms (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 |
Functions#
The functions listed below are available on all plans.
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.
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.
Premium Functions#
The functions listed below are available on all paid plans.
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.
Games#
Games are only available for Premium Bots 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.