MaeveBot

Short Description:

Custom Bot for Maeve, featuring fanclubs, user titles, welcome & thank you messages, notices, whispering, notifier, tip menu, leaderboard, cenorship and more.

Full Description

Custom bot for Maeve

Features:

Fanclub
Users in the fanclub get a tag assigned to all their messages and are announced when joining or leaving the room. In addition to that, message color and background color can be changed for fanclub members.

If a user tips the specified amount of tokens during your show, (s)he will get added to the club automatically for the duration of the show - but you have to add the user manually before your next show. Unfortunately bot's cannot save their settings, so there is no way around that. The same is true for any changes made to the fanclub using commands while the bot is running.

Custom Titles
A custom title, color and highlight can be assigned for up to 10 users (an infinite amount of users can be added using commands).
Changes can be done while the bot is running, however due to limits in CB's bot API those changes can not be saved and will be lost when the bot restarts - the settings have to be updated manually when starting the bot. There is no way to avoid that.

Broadcaster Highlight
Chat messages from the broadcaster can optinonally be highlighted in chat with a customizable background color

Welcome Message
A configurable welcome message is displayed to users when they enter the room.

Thank You Messages
Different customizable "thank you" messages are displayed in chat for every tipper after each tip, depending on the amount that was tipped.

Tip Menu
A tip menu (8 items) can be configured. It can be posted manually using a commands, and/or automatically every x minutes.
If a user tips an amount from the tip menu, a notice notifies the room about what was tipped for.

There is another 20 tip menu slots that are not displayed as part of the tip menu, but will still be displayed if the specified amount is tipped.

Tipper Leaderboard
A tipper leaderboard is regularly posted in chat, and can also be brought up by /leaderboard (or /lb).

Rotating Notifier (8 messages)
The broadcaster can set up 8 messages. Those are automatically be posted in a fixed time interval one after another (rotating). They can also be posted manually using commands at any time in any order.

Notices
Broadcasters and moderators can send out notices in chat. Optional color and font weight settings can be applied. Details below.

Whispering
Whispers are like PMs, but work in the nromal chat window. The big advantage is, boradcasters (and users alike) don't have to switch tabs to read them. And THEY have the control over who can send them - not chaturbate.
Only drawback: it requires a little more typing then sending a PM. On the plus side: it requires no clicking. Details below.

Tip Count Display
The amount a user has tipped in total is displayed after the username in chat.

All-Caps Conversion
All-Caps messages from regular users (or, optionally, all users) get converted to lowercase automatically. Messages containing only emoticons are excluded from this to prevent conversion to ":d" and alike or changing graphics to different ones.

No Graphics
Seperate options if greys, users with tokens, fanclub members and mods can use graphics in chat.

Censorship
Allows broadcasters to specify any number of phrases to be censored. This can be single words, multiple words or entire sentences. It can optionally remove the entire message or just replace censored words, and it can also automatically silence the user.
All features can be turned on or off individually for grey users, users with tokens, fanclub members, moderators and the broadcaster.
The broadcaster and, optionally, moderators are notified when a message was censored - optionally they can also see the original message without replacements.

Commands (Broadcaster & mods only):

Fanclub

/fanclub1 add <username>
/fanclub2 add <username>
adds <username> to fanclub 1 / 2 (non-permanent, see above)

/fanclub1 remove <username>
/fanclub2 remove <username>
removs <username> from your fanclub 1 / 2 (non-permanent, see above)

/fanclub1
/fanclub2
lists all current members of the first / second fanclub

Custom Titles

/usertitle <username> <title>
Sets the <title> for <username> (non-permanent, see above)

/usertitle <username>
Removes any title from <username> (non-permanent, see above)

/usercolor <username> <color>
Sets the text <color> for <username> (non-permanent, see above)

/usertitle <username>
Removes any text color set for <username> (non-permanent, see above)

/userhighlight <username> <highlight>
Sets the <highlight> color for <username> (non-permanent, see above)

/usertitle <username>
Removes any highlight color set for <username> (non-permanent, see above)

Welcome Message

/welcome (broadcaster & mods only)
Displays the current welcome message

/welcome <new message> (broadcaster & mods only)
Sets a new welcome message. %n can be used as a substitude for the user's name and will be replaced when the message is displayed.

Thank You Messages

/thankyou text <message>
Changes the thank you message to <message>. Specify no message to turn thank you messages off.

/thankyou color <color>
Changes the text color of thank you messages to <color>

/thankyou background <color>
Changes the background color of thank you messages to <color>

/thankyou weight normal|bolder|bold
Changes the font weight of thank you messages

Tipmenu

/tipmenu [all]
Sends the tipmenu to the user who posted the command.
Broadcasters and moderatros can specify "all" to send the tipmenu to everybody.

Tipper Leaderboard

/leaderboard [<n>] [all]
/lb [<n>] [all]
Displays the leaderboard in chat. By default, the entire leaderboard is displayed. If a number is specified as an optional parameter, only that number of entries will be displayed (for example /lb 10 displays a leaderboard of only the top 10 tippers).
Mods and the broadcaster can add all after the command (with or without a number) to send the leaderboard to everybody.

Rotating Notifier

/notifier interval <seconds>
Change the interval of the rotating notifier to <seconds>. 0 disables the automatic notifier, but you can still post the defined messages manually.

/notifier1 text <text>
Change the text of the first notifier to <text>.
/notifier2, /notifier3, /notifier4, /notifier5, /notifier6, /notifier7, and /notifier8 work accordingly.

/notifier1 color <color>
Set the text color of the first notifier to <color>. Colors can be predifined names like "green" or "black", or HTML color codes.
/notifier2, /notifier3, /notifier4, /notifier5, /notifier6, /notifier7, and /notifier8 work accordingly.

/notifier1 background <color>
Set the background color of the first notifier to <color>. Colors can be predifined names like "green" or "black", or HTML color codes.
/notifier2, /notifier3, /notifier4, /notifier5, /notifier6, /notifier7, and /notifier8 work accordingly.

/notifier1 weight <fontWeight>
Set the font weight of the first notifier to <fontWeight>. Valid values are "normal", "bolder" and "bold".
/notifier2, /notifier3, /notifier4, /notifier5, /notifier6, /notifier7, and /notifier8 work accordingly.

/notifier1
Posts the first notifier manually. It does not affect automatic posting if enabled.
/notifier2, /notifier3, /notifier4, /notifier5, /notifier6, /notifier7, and /notifier8 work accordingly.

Notices

/notice [~group] [+c<color>] [+b<color>] [+w<weight>] <text>
sends <text> as a notice out to all users.

Formatting is possible:
- specify +c<color> before the text to set the text color.
- specify +b<color> before the text to set the background color
- specify +w<weight> to set the font weight

You can also specify ~orange, ~red, ~green or ~cyan to send the notice to all users with that color.

Examples:
/notice Hey y'all! Go tip, it's fun, trust me!
(sends "Hey y'all! Go tip, it's fun, trust me!" to all users, dark blue text on yellow background (default settings)

/notice ~red +b#e99 Hello Moderators!
(sends "Hello Moderators!" to all moderators, black text on light red background)

/notice ~cyan +wbold +cblue Wanna spend your tokens?
(sends "Wanna spend your tokens?" to all users with tokens, bold blue text on white background)

Whispering

/whisper <user> <text>
/w <user> <text>
Sends <text> as a private notice to one user. Other users cannot see the message appearing in chat.
Broadcasters and mods (by default, configurable) can also use ~orange, ~red, ~green, ~blue, ~cyan or ~all to send the whisper to all users of that group.

/reply <text>
/r <text>
Sends <text> as a private notice as a response to the last user who whispered you. It works the same why as /whisper but does not require you to specify a name, to make it easier to reply to whispers.

/ignore <user>
Ignores incoming whispers from <user>. Not that broadcast whispers sent by mods/broadcasters cannot be ignored (this is on purpose and not a bug).

/unignore <user>
Removes <user> from the ignore list to receive his/her whsipers again.

Tip Count Display

/tipcount off|on
Turns the display of tip counts after usernames off or on. Other common keywords can be used instead of on and off

/tipcount
Displays the status of tip count display

All-Caps Conversion

/allcaps off|on|everybody
Turns conversion of all-Caps messages off, on for regular users (all but mods and broadcaster), or on for everybody. Other common keywords can be used instead of on and off

/allcaps
Displays the status of all-caps to lowercase conversion

No Graphics

/graphics (broadcaster & mods only)
Displays the permissions for all user groups

/graphics mods|fanclub|token|grey (broadcaster & mods only)
Displays if mods / fanclub members / users with tokens / greys can currently use graphics in chat or not

/graphics mods|fanclub|token|grey on|off (broadcaster & mods only)
turn graphics for mods / fanclub members / users with tokens / greys on or off

Censorship

/list (broadcasters and mods only)
Displays a list of all censored words (only to the user who issued the command)

/censor <term> (broadcasters and mods only)
Adds the term <term> to the list of censored phrases.

/uncensor <term> (broadcasters and mods only)
Removes the term <term> from the list of censored phrases.

/silence <user> (broadcasters and mods only)
Manually silences the user <user>. This silence is only active as long as the bot is running, due to limitations of chaturbate's interface bots cannot use CB's internal silence methods.

/unsilence <user> (broadcasters and mods only)
Unsilences the user <user>. This silence can only revert automatic silences by this bot or manual silnces by the /silence command, due to limitations of chaturbate's interface bots cannot use CB's internal silence methods.

/autosilence on|off (broadcasters and mods only)
Turns automatic silencing of users who used censored words on/off. This silence is only active as long as the bot is running, due to limitations of chaturbate's interface bots cannot use CB's internal silence methods.

/autoremove on|off (broadcasters and mods only)
Turns removal of messages with censored words on/off. If off, censored words are instead starred out. Removal does not alert the user, which makes it the recommended setting for anti-harrasment.

/censorship broadcaster on|off (broadcasters and mods only)
Turns censorship for the broadcaster on/off.

/censorship mods, /censorship fanclub and /censorship token can be used to change the settings for moderators, fanclub members and users with tokens.

/notifications broadcaster none|notice|original (broadcasters and mods only)
Changes the notification type the broadcaster receives when a message was changed.

/notifications mods can be used to change the settings for moderators

Changelog:

• October 19th, 2016
  • Initial upload