Admin

Chat Moderator Bot

mooBot

You need Adobe Flash Player to watch this video.
Download it from Adobe.
mooBot | 81,281 4,474
about.png

mooBot is a chat moderator bot made for cleaning up your chat, making it a friendlier place without the need for your constant interaction and attention.

The bot can among other things be made to trigger commands that display information to your viewers. This information could be, as an example, links you would like to advertise, but also dynamic data like a countdown, or maybe updated information about what game you are currently playing on Xbox Live. In these cases you don't have to change anything, the bot just fetches the correct data and displays it.

If also enabled you can automatically remove spammers the instant they break your rules. You just select what kind of spam you want to get rid of and the bot handles the rest. With the bot handling all the repetitive spam automatically, your human moderators can focus their attention on better things. If you want to protect specific users from getting removed by the bot, you can either permanently add them as a regular, or you can temporarily permit them to break your rules. You can also permanently allow certain URLs, so users who link to for example your website will not be removed by the bot.

The spam filters are set up to punish repeat offenders, by giving them a fair warning first, and then a ten minute timeout on the second offence. This means that no one will ever be permanently blocked from your chat, always giving them a chance to behave if they wish to. As everyone is punished equally there is no question if rules were broken or not, and the bot also works as a perfect scapegoat, keeping angry spammers off your back.

All the available functionality can easily, from your chat, be enabled, disabled or in some cases tailored to your broadcasting style, making it fit to how you want your own chat to be.


setup.png

Setting up mooBot is very straightforward; all you really have to do is learn how to use the commands, and then use the join-command to send moobot to your chat.
To use commands you prefix them with the character "!", like "!moobot", which will return a command list. In the list you will likely see the command "!moobot join", which will send moobot to your chat. Type this command into a chat that has moobot in it, and go to your own chat to set up moobot.

When moobot has joined your chat you should read through the features and command list to figure out what you would like to enable.
When moobot says a command description like "Usage: !moobot commands [add/remove/example]" it means that you can use the command like "!moobot commands add" OR "!moobot commands remove" OR "!moobot commands example". As you can see, the "[" and "]" characters are separators and should be removed when you are issuing the command.

Play with the commands and get a feel for how they work. Also remember to read the command list in detail as many features are not enabled by default. If you have any problems either contact someone who has a moobot in their chat, or ask on twitter @themoobot.


  • Purge functionality
    Removing user spam messages automatically
  • Custom commands
    Giving users repetitive information
  • Regulars
    Protecting users who you don't want to mod
  • Data insertion
    Inserting dynamic data into your custom commands
  • Repeating text and commands
    Repeating text or commands (like running a commercial) automatically after a set time
  • Mass unbanning
    Clearing the channel banlist with just one command

  • Contributors

  • Donate through PayPal

    Whether you just want to show some appreciation, or further the development of the bot, you can give however much you like below.

    The bot will never be profitable as it will always stay free to use, but as a thank you for helping out your channel will get some extra convenient bonuses:

    • Joined first on reconnect
    • Never leaves your channel due to inactivity
    • Double amount of custom commands
    • Double amount of regulars and owners
    • Double amount of perma permitted links
 

User commands

   
  Command   Description
 
moobot
 
Lists all commands you can use.
 
moobot join
 
Sends moobot to your chat.
 
moobot part
 
Removes moobot from your chat.
 

Moderator commands

   
  Command   Description
 
permit [user]
 
Temporarily allows the user to not get removed by the spam filters.
 

Owner commands

   
  Command   Description
 
moobot commands add [identifier]
 
Adds the command which can be triggered by using "!identifier".
 
moobot commands remove [identifier]
 
Removes the command.
 
moobot commands example [command]
 
Adds an example command so you can see how a specific command is set up. Can be any of these, which will behave differently:
  • commercial - runs a commercial
  • game - sets the game name
  • gamertag - displays information about your Xbox Live gamertag
  • status - sets the channel status
  • topic - displays and sets a channel topic
 
[custom command] [text]
 
Sets the text tag of the command.
 
[custom command] help
 
Displays the command list for this custom command.
 
[custom command] format [set / unset] [format]
 
Sets the format of your command, which will determine how the command is displayed when called. Use tags in your format to insert dynamic data like countdowns, usernames etc. See the tags command for available tags, and the example commands for examples on different formats.
 
[custom command] toggle [on / off]
 
Sets if normal users are able to use this command.
 
[custom command] command [command]
 
Sets a special command that will be performed every time this custom command is called. Can be any of the following:
  • clear - clears the chat
  • commercial - runs a commercial
  • game - sets the current game
  • massunban - runs a massunban
  • title - sets the title/status of the channel
  • unset - removes any set special commands
 
[custom command] repeat [on / off / chatlines / time]
 
Sets if the command will automatically repeat after a set amount of time and chat lines passed. The special command associated with the command will always be performed after the set time, even if the chat lines have not been passed.
 
[custom command] tags
 
Displays all the tags you can use in your command's format. These tags will then insert the data when the command is called, and can be as follows:
  • <text> - the text stored when calling the command like "!command [text]"
  • <by> - what username set the text
  • <user> - what username is calling the command
  • <when> - when the last text was set
  • <status> - the current channel status
  • <game> - the current set game
  • <title> - the current channel title
  • <countdown> - time remaining on the set countdown
  • <followers> - number of followers the channel has
  • <gt.gamertag> - the set Xbox Live gamertag
  • <gt.gamerscore> - the gamerscore of the Xbox Live gamertag
  • <gt.lastplayed.title> - title of the last played Xbox Live game
  • <gt.lastplayed.when> - time since the last played Xbox Live game was played
  • <gt.lastplayed.percentage> - percent completed of the last played Xbox Live game
  • <lol.rank> - League of Legends rank of the set summoner
  • <lol.elo> - League of Legends ELO of the set summoner
 
moobot kick toggle [on / off]
 
Enables or disables all types of spam filters.
 
moobot kick toggle [type] [on / off]
 
Enables or disables the specific type of spam filter, which can be:
  • Caps - Excessive use of capital letters
  • Censor - Censored words by the chat censor filter
  • Fakepurge - Fake purges
  • Links - Links and garbled links
  • Repeat - Repeat spam messages
  • Signs - Excessive use of signs and symbols
  • Smilies - Excessive use of smilies
 
moobot kick warning [on / off]
 
Enables or disables if the user will get a warning before getting timed out.
 
moobot kick notify [on / off]
 
Enables or disables sending a private IRC message when someone is timed out. Only works when connected through IRC.
 
moobot kick msg [on / off]
 
Enables or disables giving a public kick message when someone is timed out.
 
moobot kick msg [type] [message]
 
Sets a custom kick message for the given kick type.
 
moobot kick permit [add / remove] [valid URL]
 
Sets a permanently permitted URL so anyone who link to it will not get removed by the bot. You can use the "*" character as a wildcard in the URL, like so:
 
moobot kick rates [type]
 
Sets what it takes for certain kick types to classify a user as a spammer. So basically sets how the bot purges.
 
moobot regulars [add / remove] [username]
 
Permanently allows the user to not get purged by the bot.
 
moobot owners [add / remove] [username]
 
Sets owners who will be treated as a channel owner and can perform any commands on the bot. Be careful with who you add with this command.
 
moobot massunban
 
Unbans all the users who have been previously banned on the channel.
 
moobot follow
 
Gets the bot to follow you.
 

Admin & staff commands

   
  Command   Description
 
moobot join [channel]
 
Sends moobot to the given user's chat.
 
moobot part [channel]
 
Removes moobot from the given user's chat.
    chat options chatters
    You need Adobe Flash Player to watch this video.
    Download it from Adobe.