All in one Helena Bot

Short Description:

Made with Love for Helena_hill

Full Description

Short Description:

All in One Helena-bot includes: Tip Menu, Positions Menu, Token Poll, PMs, VIP List, External Fan Club List, Blocked words, silence levels, graphics levels, Leaderboard, Nice List, Tip Count Display, User Group Icon by name, 5 rotating notifiers

Features:

Private Messaging for mods and broadcasters

Private Messages to other users - Send messages to the broadcaster, moderator group, or specific users in the chat so there is no need to switch to a new tab for PMs.

Silence Level and Graphic Level - Restrict ability to chat or to post graphics by whether users have tokens or have tipped a certain threshold.

Leaderboard - Display a Leaderboard in the chat of top tippers from the current session.

Nice List - Maintain a list of users that are allowed to chat when the silence level is increased. Nice list is also exempt from the gray time-lock.

Tip Count next to name - Show the user's current tip count totals by their name with each chat message.

User Group icons - a defined .gif is displayed next to a user's name in the chat for the 4 groups (mods, CB fan club, external fan club, VIP list).

Tip Leader icons - a defined .gif is displayed next to the user name for the top 3 tippers in the current session.

Silence individual users - Add users to a silence list that prevents them from chatting, advantage of this over regular silencing is that it can easily reversed and sends a note to the user telling them to stop being rude.

Silence individual users without notification (ninja) - Ideal for silencing people who have been tipping but still being rude or demanding, they do not receive a notice. Note that neither of these affects tipnotes the way that silencing through CB will.

Tip Menu (based on 4sci menu) - Tip Menu function with up to 40 slots. Automatic sort by price. Can be split into two sections if too long. Menu displays on a defined interval and you can set the text and background color.

Positions Tip Menu - Similar Tip Menu function with up to 8 slots intended to be used for sex position tipping. Automatic sort by price. Menu displays on a defined interval and you can set the text and background color.

Token Poll (based on 4sci Poll) - Use a token poll to have people vote for options such as cumshot location. Has multiple modes to be ended manually by moderator or broadcaster, ended after a timer, or ended based on hitting a target amount. Poll progress displays on a defined interval and you can set the text and background color.

VIP List - You can add really good tippers or friends to the VIP list and define which level of access they will have (PMs, ticket show, or both) or don't give any special access but still be announced on entry to the room, and get a badge next to their names in the chat.

External FanClub List - Simliar to the VIP list, you can add people who may have bought an external fan club membership to the list and define which level of access they will have (PMs, ticket show, or both) or don't give any special access but still be annuonced on entry to the room, and get a badge next to their names in the chat.

Blocked word list - Add words to this list to prevent rude comments in the chat or use pieces of repetitive spam messages from bots to prevent them from being shown.

Additional Notifiers (up to 5 rotating) - Display up to 5 messages in the chat on a scheduled interval, and you can define the colors used for the text and background.

Ticket prep function - This is used to automate many of the bot functions you do when you switch to a ticket show during a session, such as disable regular tip menu, enable positions menu, enable token poll, enable backup ticket list, add top tippers to the show, and add VIP and Fanclub users to the show. This should be run afetr crazyticket has been turned on, and by a user with authority to the /add command.

Ticket show pre-sales - Sell advance tickets to a Crazyticket show so that you can do a warmup with goal or game apps, and then export the pre-sales list to Crazyticket once started. Typically the advance tickets are discounted and may increase in price as you get closer to the show - encourages not waiting until the last minute to get a ticket.

Hidden ticket show - Similar to Crazyticket, hidden ticket show is integrated into the Helena-Bot.

Media List - Display all of your contact info, social media IDs, and weblink in a recurring post in the chat.

Configurable Tip Response Messages - Display a message to the user when they tip above 5 configurable thresholds.

Simple Dice Game with two 6-sided dice for 12 prizes plus a special rare prize.

Gray time-lock - prevent grays from chatting for the first X minutes they enter the room, prevents a lot of spam from bots.

Nickname feature - display a nickname next to people's usernames in the chat, also provide a text color for user's with nicknames.

Raffle - sell tickets and perform a drawing for a raffle. Multiple prize levels and prize lists avaialble with each level. Multiple modes and automtic drawings and continuous reset available.

On-demand privates - Start a private hidden cam show with a single user, replaces the need for password shows.

Price Overlap checker - automatic checking for duplicate price settings across all bot features.

All-time Tip Leader - Keep track of your all time tip leaders - requires exporting the list and adding back for each new show.

Convert Messages in all Upper Case to Lower Case so people can't 'yell' in chat.

Commands

Most of these are available for moderators and broadcasters only, with some exceptions. Note that you can also type "/fbhelp" within the chat to see the list of commands as well. You can drill down further into a group of commands to see specific details on the syntax and behavior of the command.

A. Chat Control

The silence level and graphic level functions restrict users in the room from chatting in general or posting gifs (graphics) based whether they have tokens or have tipped.

/silencelevel [x]: set silence level where x = 0-3
0 = All users can chat
1 = Only users with tokens can chat
2 = Only users who have tipped can chat
3 = Only users who have tipped 10 tokens can chat

/graphiclevel [x]: set graphic level where x = 0-3
0 = All users can post gifs
1 = Only users with tokens can post gifs
2 = Only users who have tipped can post gifs
3 = Only users who have tipped 10 tokens can post gifs

/ninja [user]: Silence a user without notification. The ninja feature is helpful for silencing obnoxious users when you don't want to notify them that they are silenced. They may have already tipped a significant amount or be potential tippers, so best not to notify them, their comments just simply won't show up to the general chat.
They will still be able to send comments in tip notes however. Users can be added and removed from the ninja list interactively during the show as described below, and repeat offenders should be added to the permanent ninja list that is saved on the bot start page (also be sure to save the list in a separate document in case the bot configuration is lost).

/unninja [user]: remove ninja silence

/ninjalist: display the ninja list

/silence [user]: Silence a user with notification. The silence feature is helpful for silencing really obnoxious users that you do want to notify that they are silenced. They will receive a notification that they have been rude or demanding when they are silenced and will be notified each time they attempt to chat.
They will still be able to send comments in tip notes however, which is different from the CB silence feature where tip comments are not shown. Really Really obnoxious users that you don't want to hear from at all can be silenced through the CB silence.
Users can be added and removed from the silence list interactively during the show as described below, and repeat offenders should be added to the permanent silence list that is saved on the bot start page (also be sure to save the list in a separate document in case the bot configuration is lost).

/unsilence [user]: remove from silence list

/silencelist: display the silence list

B. Gray Chat Time Lock

The Gray Chat Time lock feature is intended to silence the spam bots and grays that come in only to make obnoxious comments and then leave. When enabled, users will not be able to chat for the defined period of time, which is also changeable during the show. A list is kept of each gray user with their entry time into the room, and once the defined time expires, they are able to chat. Note that silence level would still prevent them from chatting after time expires if it is used.
The time lock does not apply to broadcasters, moderators, CB fan club, external fan club, nice list, or VIP users.

/usegraylock [on/off]: toggle the gray chat timelock feature on and off, overriding the initial setting from the bot start page.

/chggraytime [X]: Change the gray chat time lock threshold to a new value of [X] minutes before they can chat upon entering the room. Overrides the initial setting from the bot start page.

/clrgraylock: clear out all gray chat time lock data, and restart tracking (essentially resilences all grays for the defined time threshold).

/addgraylock [user]: restart a specific gray user time lock timer. They will not be able to chat again until the time elapses.

/rmvgraylock [user]: release a specific gray user from their time lock. They will be able to chat right away (assuming sience level allows).

C. Timer Functions

There is a general timer feature available for anything you would like to initiate a count down for, such as performing a prize for X minutes. There are separate functions available for starting ticket shows (/starttimer in the crazyticket app) or starting a timer to end the token poll (/pollstarttimer).

/startclock [x]: start a timer for x minutes... timer will display a notice at 15, 10, 5, 4, 3, 2, 1 min and 30, 10, 5, 4, 3, 2, 1 sec remaining

/clockadd [x]: add x minutes to the timer

/clocktimeleft: display the time left on the timer

/chgclockdesc [newtext]: change the text used in the timer description to the new value [newtext], overrides the initial value set on the launch page of the Helena-Bot

/stopclock: end the timer before the time runs out

D. Private Messaging

/pm [user] [msg]: send a message to a specific user

/reply [msg]: send reply to someone who has PM'd you

/bc [msg]: send a message to the broadcaster

/tm [msg]: send a message to the moderator group

/tbm [msg]: send a message to the broadcaster and the moderator group

E. Chat Notices

/cn [msg]: send a notice to the chat.

/cnd [msg]: send a notice to the chat with dashed line separators

/cnh [msg]: send a notice to the chat with highlighting

/cndh [msg]: send a notice to the chat with dashed line separators and highlighting

/chgmsg1 [msg]: update the notifier message in Slot 1 to a value of [msg]

/chgmsg2 [msg]: update the notifier message in Slot 2 to a value of [msg]

/chgmsg3 [msg]: update the notifier message in Slot 3 to a value of [msg]

/chgmsg4 [msg]: update the notifier message in Slot 4 to a value of [msg]

/chgmsg5 [msg]: update the notifier message in Slot 5 to a value of [msg]

/dspmsg [X]: Display the current value for the message in notifier Slot [X], where [X] can be the integers 1-5 or "all".

/usenotifier [on/off]: enable or disable the display of the notifier... however, the recurrence can only be set when activating the bot.

/usetipresponse [on/off]: enable or disable the display of the tip response messges when users tip at the configured thresholds.

F. Nice List
The nicelist enables users who would otherwise not be allowed to chat due to the silence level setting to still chat.

/addnice [user1, user2, etc]: Add a user or list of users to the nice list, separate user names by a comma.

/rmvnice [user]: Remove a single user from the nice list (individual names only, does not support removal of a user list).

/nicelist: display the nice list

G. Leaders and Tippers

/leaders [group]: display the leaderboard on-demand... does not require that the leaderboard be enabled. Displays to [group] from list:
'mods' - display to moderators
'tbm' - display to moderators and broadcaster
'bc' - display to broadcaster
'all' - display to public chat
...defaults to current user if none selected.

/useleaderboard [on/off]: toggle the recurring display of the leaderboard on and off, overriding the initial config setting... recurrence from initial config is still used

/usetipcount [on/off]: toggle the display of the tip count in front of a user's name on and off, overriding the initial config setting... tips are still counted when off as long as the bot is active

/tippers [group] [x]: display a list of the top [x] number of tippers since the bot was activated. Displays to [group] from list:
'mods' - display to moderators
'tbm' - display to moderators and broadcaster
'bc' - display to broadcaster
'all' - display to public chat
...defaults to current user if none selected.

See later section for the All-Time Tipper List feature.

H. Tip Menu

/tipmenu: (all users) Display the tip menu in chat, only shown to the user that requests it.

/usemenu [on/off]: (mods/bc only) Toggle the setting for whether the Tip Menu is "on" or "off". Overrides the initial setting to turn the Tip Menu on or off during the show.

/tipmenurequests: (mods/bc only) Show recent tip menu requests, defaults to a maximum of the 10 most recent when no quantity is entered.

/tipmenurequests X: (mods/bc only) Show the last "X" requests.

/tipmenurequests all: (mods/bc only) Show all the requests, maximum of 50.

/tipmenuadd X Y: (mods/bc only) Add an item name "Y" with a price of "X" tokens to the menu.

/tipmenurmv X: (mods/bc only) Removes every item with a price of "X" tokens.

/tipmenurmv Y: (mods/bc only) Will removed any item labeled "Y" regardless of price.

I. Positions Tip Menu

/posmenu: (all users) Display the tip menu in chat, only shown to the user that requests it.

/useposmenu [on/off]: (mods/bc only) Toggle the setting for whether the Positions Tip Menu is "on" or "off". Overrides the initial setting to turn the Positions Tip Menu on or off during the show.

/posmenurequests: (mods/bc only) Show recent tip menu requests, defaults to a maximum of the 10 most recent.

/posmenuadd X Y: (mods/bc only) Add an item name "Y" with a price of "X" tokens to the positions menu.

/posmenurmv X: (mods/bc only) Removes every item from the positions menu with a price of "X" tokens.

/posmenurmv Y: (mods/bc only) Will removed any item labeled "Y" regardless of price from the positions menu.

J. Token Poll

The Token Poll is used to allow users to vote on different poll choices to choose an audience selected winner.
Most often this is used for voting on a cumshot location but can be used for any set of choices you want the audience to vote on.
There are two levels of control, enabling the Poll, and whether the poll is running or not. The Poll is enabled if turned on when starting the bot and it is also running by default.
Within the show, the poll can be ended to declare a winner, and is therefore no longer running but poll commands can still be executed, including restarting the poll, and poll messages will still be shown.
The poll can be completely disabled as well, after which no poll commands can be used and no messages will be shown.

/poll: (all users) Display the current poll results board in the chat for the requesting user. Displayed to all when requested by moderators.

/usepoll [on/off]: (mods/bc only) Toggle the setting for whether the Token Poll is "on" or "off". Overrides the initial setting to turn the Token Poll on or off during the show.

/endpoll: (mods/bc only) When running under manual control, end the poll and display the winner.

/restartpoll: (mods/bc only) If the poll is accidentally ended, or suspended, it can be restarted using this command.

/addvote X Y: (mods/bc only) Add or remove "Y" number of votes to the poll item with a price of "X". If "Y" is not specified, defaults to one vote added or removed. Number can be shown as negative (-2) to remove votes. Moderators have to be enabled to use this command.

/polloptadd X Y: (mods/bc only) Add an item named "Y" with a price of "X" tokens to the poll.

/polloptrmv Y: (mods/bc only) Will remove any item labeled "Y" from the token poll.

/pollstarttimer X: (mods/bc only) Starts a timer for "X" minutes for the poll when run under timed mode. Poll will automatically end when time runs out.

/polladdtime X: (mods/bc only) Adds "X" minutes to the poll timer if a timer is running.

/pollstoptimer: (mods/bc only) Ends the timer if running under timed mode.

/pollleader: (all users) Post the poll leader message to the chat for the requesting user. Displayed to all when requested by moderators.

K. External Fan Club

This allows for setting a list of users that will have special access from purchasing a Fan Club membership on an external site such as FanCentro, justfor.fans, etc.
Adding a user to the External Fan Club list gives them a badge icon in the chat, PM ability, and includes them in the export list sent to the ticket show (future feature).
Users can be added and removed within a session, but a master list should be maintained and updated on the bot's configuration page so it is saved (updates made within the session are not permanent).
The list should also be saved externally in case the configuration page is ever reset.
Only broadcasters have the ability to maintain the Fan Club List.

/addfan [user]: (bc only) Adds a user to the External Fan Club list where [user] is the person you want to add.

/rmvfan [user]: (bc only) Removes a user from the External Fan Club List where [user] is the person you want to remove.

/fanlist: (mods/bc only) Displays the list of users currently in the External Fan Club list.

/exportfan: (mods/bc only) Displays the list of users currently in the External Fan Club list in a format that can easily be repasted in the chat to add users to a ticket show.
Note that this logic will also be executed using the /prepticket command.
Also note that exporting the list will add these users to the backup ticket show list as well (tlist).

L. VIP List

This allows for setting a list of users that will have special access though they may not be in the Fan Club (friends and all-time high tippers, etc).
Adding a user to the VIP list gives them a badge icon in the chat, PM ability, and includes them in the export list sent to the ticket show (future feature).
Users can be added and removed within a session, but a master list should be maintained and updated on the bot's configuration page so it is saved (updates made within the session are not permanent).
The list should also be saved externally in case the configuration page is ever reset.
Only broadcasters have the ability to maintain the VIP List.

/addvip [user]: (bc only) Adds a user to the VIP list where [user] is the person you want to add.

/rmvvip [user]: (bc only) Removes a user from the VIP List where [user] is the person you want to remove.

/viplist: (mods/bc only) Displays the list of users currently in the VIP list.

/exportvip: (mods/bc only) Displays the list of users currently in the VIP list in a format that can easily be repasted in the chat to add users to a ticket show.
Note that this logic will also be executed using the /prepticket command.
Also note that exporting the list will add these users to the backup ticket show list as well (tlist).

M. Blocked Word List

This allows for setting a list of words that will cause a user's message to be suppressed if they use one.
Words can be added and removed within a session, but a master list should be maintained and updated on the bot's configuration page so it is saved (updates made within the session are not permanent).
The list should also be saved externally in case the configuration page is ever reset.
Also it only works for single words, not phrases.

/addword [word]: (bc only) Adds a word to the Blocked Word list where [word] is the word you want to add.

/rmvword [word]: (bc only) Removes a word from the Blocked Word list where [word] is the word you want to remove.

/wordlist: (all users) Displays the list of words currently in the Blocked list.

N. Ticket Show Support

Note that the Helena-Bot can support 3 types of ticket shows. (1) There is a ticket show bot built into the Helena-Bot, (2) it supports working with Dorothy's UltraApp ticket show, and (3) it supports some features to assist with the standalone CrazyTicket App. **** So it is very important when setting up ticket show related features to define which type of Ticket show you are doing using the settings on the launch page. ****
The first section below outlines the Helena-Bot Ticket Show mode, followed by separate Ticket App Support.
Helena-Bot Ticket Show

As noted, the Helena-Bot's built-in ticket show can be used rather than an external stand alone app if you like, however, the app features are usually a better fit for ticket shows, so it is suggested to use Dorothy's UltraApp rather than the bot if possible. Both have the benefit of not giving anyone you don't know access to your shows. Most of the CrazyTicket features are duplicated into both of them, with some tweaks and improvements.
Since it is not expected to have both the Helena-Bot Ticket Show and the UltraApp (or CrazyTicket) running at the same time, the same commands are used for many of the features to make it easier to manage the show for those familiar with the CrazyTicket commands.
An Outstanding Ticket feature is included, which lets you maintain a list of users that have outstanding tickets that they can use for future shows, in the event they have to leave before the show starts, or there is a problem with a show and you'd like to grant the ticket holders a free ticket to a future show. ** IMPORTANT: The list can be viewed during the show using the "/otlist" command, and the "/otchanges" command can be used to see which users have saved a ticket or used a saved ticket during the show, as these changes need to updated in the outstanding ticket list on the launch page for the next show. The list should also be saved outside of CB.
Note there are multiple places to set a ticket price within the launch page, one for each of the types of shows, and also a Pre-sales price when using that feature. When using the Helena-Bot hidden show, the price defined is actually controlling the show... when using a ticket app, you are duplicating the price setup in that app, and mainly that is only for pre-sales validations to not exceed the show price (since the bot cannot see the ticket app setup).
Also, it is not advisable to put the ticket price in the show description, as those are not automatically updated if the price is changed. The notices that are displayed show the current ticket price and are updated automatically when the price changes.

/useshow (or /useticketshow) [on/off]: (mods/bc only) Toggle the setting for whether the Helena-Bot Ticket Show feature is "on" or "off". Overrides the initial setting, and allows you to turn the Ticket Show feature on or off during the show. Note that turning the show off will suspend the display of the notice, and tips will no longer buy a ticket, however, the existing ticket purchases are kept until the Helena-Bot is restarted.

/tickets : (mods/bc only) Display the list of users that have bought a ticket. If the parameter of 'alpha' is added, the list is displayed alphabetically. Note that viewers can be added back to the show using the /add or /addticket commands and pasting the list that is shown from the /tickets command.

/useot [on/off]: (mods/bc only) Toggle the setting for whether the Outstanding Ticket feature of the Ticket Show is "on" or "off". Overrides the initial setting, and allows you to turn the Outstanding Ticket usage feature on or off during the show. .

/otlist : (all users) Display the list of outstanding ticket holders, can be used by anyone if the Outstanding Ticket feature is enabled.

/otchanges : (mods/bc only) ** IMPORTANT when using the OT feature ** Displays a list of tickets that have been saved or used during the current session so the permanent list can be updated.

/saveticket: (all ticket buyers) If the broadcaster has enabled Outstanding Tickets (and is tracking them) - If you've bought a ticket and will not be able to stay for the show, you can save it for a future show. You will no longer be able to see the current show. IMPORTANT: If in the same session, the ticket will be available automatically. However for future shows or if the broadcaster restarts the bot, the broadcaster must add the saved tickets to the outstanding ticket list to be able to use them with /useticket.

/useticket: (all users with an outstanding ticket) If the broadcaster has enabled Outstanding Tickets (and is tracking them) - Redeem an outstanding ticket and use it for access to this show. You can use the command /otlist to view the list of outstanding ticket holders if the broadcaster has enabled this feature.

/addot : (mods, bc if granted privileges) If the outstanding ticket feature is in use, the broadcaster can manually give a user an outstanding ticket. Moderators can also add if they have authority. The addition still must be made permanent by updating the launch page outstanding ticket list.

/rmvot : (mods/bc only) Remove a user from the outstanding ticket list within the current show. The removal still must be made permanent by updating the launch page outstanding ticket list.

/addticket or (/add) [user]: (bc only, moderator when granted privileges) Manually add a user to the ticket show list. Can be a specific user or a list of users separated by a comma. Note that /add is the CrazyTicket command but also works with the Ticket show.

/rmvticket (or /del or /delticket) [user]: (mods/bc only) Manually remove a specific user from the ticket show list, only used for one user at a time.

/startshow: (mods/bc only) Start the ticket show when not set to automatic start. Once started, the show will only be visible to ticket holders. Hint: start the show when you're in a good position for the preview pic to be frozen that will attract more ticket buyers. Note that /startshow is the CrazyTicket command but also works with the Helena-Bot Ticket show.

/showwarn (or /showover): (mods/bc only) Display a warning that the show will be ending soon and ticket purchases are allowed but not recommended. If configured, this can also end the positions menu, and reduce the ticket price. Note that /showover is the CrazyTicket command but also works with the Helena-Bot Ticket show.

/showend (or /stopsales): (mods/bc only) Suspend ticket sales, no more automatic ticket purchases can be made. Recommended to always do this once you are less than a few minutes from the end of the show so people don't buy at the last second and are disappointed by getting a short show. If configured, this can also end the positions menu, and reduce the ticket price. Note that /showend is the CrazyTicket command but also works with the Helena-Bot Ticket show.

/stopshow: (mods/bc only) End the hidden show and return to a public broadcast.

/newticketshow: (mods/bc only) Completely refresh the ticket show to start a brand new show. This will remove all the ticket holders from the list, and re-initialize all settings using the configuration from the launch page.

/restartshow: (mods/bc only) Go back into hidden cam mode if the show was accidentally ended too soon, or the broadcaster wanted to go back to public to sell more tickets. The ticket holder list and all settings are kept intact.

/ticketprice (or /ctprice, or /chgticketprice) [newprice]: (mods/bc only) Update the ticket price to the [newprice]. Note that /ctprice is the CrazyTicket command but also works with the Helena-Bot Ticket show.

/starttimer (or /ticketstarttimer, or /starttickettimer) [time]: (mods/bc only) Start a [time] minute timer for the raffle drawing when in 'timer' mode with the drawing to be triggered by the /raffledrawing command. The timer will count down but not automatically perform the drawing (unless set to automatic mode but the auto-timer was ended, and this is a restart of that timer)

/addtime (or /ticketaddtime, or /addtickettime) [time]: (mods/bc only) Add [time] minutes to the timer for either automatic or manual drawing mode. The [time] value can be a negative number to subtract time, but cannot be greater than the remaining time.

/stoptimer (or /ticketstoptimer, or /stoptickettimer): (mods/bc only) Stop the raffle timer for either automatic or manual drawing mode.

/tickettimeleft : (mods/bc only) Display the time left on the ticket show countdown for either automatic or manual starting mode.

/showtime : (all users) Display a message showing how long the current show has been hidden.

/chgticketmode [manual/timer/ticketgoal/tokengoal]: (mods/bc only) Switch between the modes being used to determine when to start the ticket show. If switching from a timer show to a non-timer show, the timer will be ended. Ticket count and Tip Count are being tracked regardless of mode, so switching to a 'goal' mode should not require starting progress at 0.

/chgticketmodeauto [auto/bc]: (mods/bc only) Switch between the modes being used to define if the show starts automatically when a goal is reached or timer expires, or if the broadcaster or mods still control the start of the show.

/giftticket [user]: (all users, once you have extra tickets) If the 'gifting' feature is enabled, when you tip enough to buy extra tickets, you can gift those tickets to other users using this command. Each time you gift, it removes one of your 'extra' tickets. You can only gift extra tickets with this command, to give away your own ticket, you can use /givemyticketto as noted below. Be sure to type the user name correctly for the person you are gifting to, extra tickets cannot be recovered once they are gifted. This can be done before and during the show.

/givemyticketto [user]: (all ticket buyers) If you can't stay for a show, and outstanding ticket feature is no used to allow saving your ticket, you can give your ticket to another user. This can only be done before the show starts, and you will be removed from the ticket show list!

/ticketsubject [newsubject]: (mods/bc only) Change the room description/subject/title to a new value. Note that this command is only used for the Helena-Bot ticket show. The command for use with CrazyTicket is /ctsubject or /subject.

/addlbtop [X]: (bc/mods) Add the top [X] number of tippers for the current session to the ticket show. Moderators may only use this if allowed per configuration. This can be used with the Helena-Bot Ticket show or in support of a ticket app. The /add command is executed, which will add them to the show if the user executing them has authority to the /add command

/addlbamt [X]: (bc/mods) Add tippers who have tipped at least [X] number of tokens for the current session to the ticket show. Moderators may only use this if allowed per configuration. This can be used with the Helena-Bot Ticket show or in support of a ticket app. The /add command is executed, which will add them to the show if the user executing them has authority to the /add command

Ticket App Support

There are a few features added to support the use of an external Ticket App, such as UltraApp or the CrazyTicket App alongside the Helena-Bot (when the Helena-Bot ticket show is not used).

/usetlist [on/off] : (bc/mods only) When the tlist (backup ticket list) is enabled, any tips of the ticket price or greater will add that user to a backup list for the show.
This allows the ticket holder list to be be saved within the Helena-Bot in the event the ticket app crashes or is ended.
If this happens, the ticket list can be restored using the commands below.
The ticket app "/add" commands will also add users to the backup list (tlist).
The VIP and external fan list will also be added to the tlist if they are added to the show through /prepticket or the export commands for each.
Note that the /prepticket function will automatically enable the tlist if it is not already on.

/prepticket: (mods/bc only) Prepare for a ticket show by performing the following actions (note that there is control for each of these actions on the config page so you can turn them on or off individually):
- disabling the regular Tip Menu if running
- enabling the Positions Menu if not already enabled
- enabling the Token Poll if not already enabled
- performing the export of the pre-sale list to the ticket show
- performing the export of the VIP List and/or the External Fan Club list to the ticket show if they are used and granted these privileges
- performing the add of the VIP List and/or the External Fan Club list to the backup ticket list if they are used and granted these privileges
If the ticket show is running this will add the lists to the show if the user executing them has authority to the /add command in the ticket app.

/ticketprice (or /ctprice) [price]: (bc/mods only) Manually change the ticket price for the Helena-Bot updates the price used for the Backup list when an external ticket app is used.
Users are added to the backup list anytime they tip more than the amount currently defined as the show price, so it needs to be kept up to date as it is changed in the ticket app.

/tlistprice [price] or /ticketprice [price]: (bc/mods only) This can be used apart from the /ctprice command being used to set the comparison amount for adding people to the Backup list as well as the expected ticket price for the actual show when doing pre-sales at a discounted amount.
This would commonly be used if turning on the Backup list without the price being set on the initial configuration screen, it can be updated later when the ticket app is started even if not changing the price in the ticket app.

/dsptlist: (bc/mods) Displays the backup ticket list.

/exptlist: (bc/mods) If a ticket show has failed or the app was ended, once the ticket app is restarted, use this command to add the users from the tlist back into the show.
The Crazyticket /add command is executed, which will add them to the show if the user executing them has authority to the /add command in the ticket app

/addlbtop [X]: (bc/mods) Add the top [X] number of tippers for the current session to the ticket show. Moderators may only use this if allowed per configuration.
The Crazyticket /add command is executed, which will add them to the show if the user executing them has authority to the /add command in the ticket app

/addlbamt [X]: (bc/mods) Add tippers who have tipped at least [X] number of tokens for the current session to the ticket show. Moderators may only use this if allowed per configuration.
The Crazyticket /add command is executed, which will add them to the show if the user executing them has authority to the /add command in the ticket app

O. Ticket Show Pre-sales

In addition to the above commands, there is a subset of ticket show related functions related to pre-sales for a ticket show (can use the Helena-Bot Ticket Show, UltraApp Ticket Show, or CrazyTicket).

/usepresale [on/off] : (bc/mods only) When the Ticket Show pre-sales are enabled and an initial price is set, any tips of the pre-sale ticket price or greater will add that user to a pre-sale list for the show that can automatically be added to the ticket show once started later.

/presalelist: (mods/bc only) Display the list of users on the pre-sale list.

/presaleprice [price]: (mods/bc only) Set the pre-sales ticket price to a value of [price]. This can either be done to set the initial price before the pre-sales start, if not set in the bot start page, or it can be used after pre-sales start to change the price to a new price. Note the timer can also be set to change the price using the command below.

/presalepricetimer [time] [price]: (mods/bc only) When using manual mode, set the pre-sales ticket price to a new value of [price] when the timer for [time] minutes runs out. Timer warnings will be displayed and the price will automatically update at the end of the timer. Time can be added or removed from the timer using the command below.

/presalestarttimer [time]: (mods/bc only) When using manual mode, start a timer to increase the price at the end of the timer by the pre-defined increment value specified on the start page.

/presaleaddtime [time]: (mods/bc only) Add [time] minutes to the timer. If a negative number is used, time is subtracted.

/presalestoptimer: (mods/bc only) Stops the pre-sale timer and no price update is made.

/presaletimeleft: (mods/bc only) Displays the time left on the current pre-sale timer, whether started manually or automated.

/chgpresalemode [mode]: (mods/bc only) Change the presale mode that is currently running. The default value is set on the start page, and can be change on the fly during the show to "manual", "timer", or "count".
Manual Mode: The broadcaster or moderator controls the price increases (or there are no price increases). Price can either be changed immediately using /presaleprice, or a timer can be started to change it by a specified amount (/presalepricetimer) or by the default increment amount (/presalestarttimer).
Timer Mode: The price is changed automatically on a recycling timer as defined on the start page. The broadcaster or a moderator can add or remove time from the timer as needed, or stop the timer. At the end of each cycle, the price will increase by the configured increment and a new timer will be kicked off as long as it does not exceed the maximum number of increments and would not exceed the ticket price with the next cycle.
Count Mode: The price is changed automatically on a recycling ticket count as defined on the start page. At the end of each cycle when the defined number of tickets is sold, the price will increase by the configured increment as long as it does not exceed the maximum number of increments and does not exceed the ticket price with the next cycle.'
/exppresale: (mods/bc only) Exports the pre-sale ticket list to Crazyticket once the Crazyticket app is started, by entering the "/add" command plus the ticket list. Assumes the current user has authority to the /add command.

/addpresale: (mods/bc only) Add a user or list of users to the pre-sale ticket list.

/rmvpresale: (mods/bc only) Remove an individual user from the pre-sale list.

R. Dice Game

The Dice Games allows viewers to tip a specified amount to roll a pair of 6-sided dice, and win one of 12 possible prizes. Viewers must tip the exact amount of the Dice Roll price that is configured.
There is also a setting to define if a viewer can tip for multiple rolls with a single tip by tipping a multiple of the single roll amount, and what the maximum multiple is. Any slots not filled in will yield no prize if that amount is rolled.
There are two modes, you can either keep all prizes intact or have prizes removed from the board as they are won. Removing the prizes from the board is not a commonly used mode as it reduces the chances of winning a prize with each roll.
There are three color settings available, one for the notice background, one for the regular roll result background, and one for the special prize result background. The text color is always black.
As with all other portions of the ultrabot, be sure to not use an overlapping token amount for the dice roll price that may have already been used for the tip menu, token poll, etc.

/prizes: (all users) Display the available prizes in the Dice Roll game, only shown to the user that requests it, unless requested by a moderator or broadcaster, then it is displayed to the room.

/usedice [on/off]: (mods/bc only) Toggle the setting for whether the Dice Game is "on" or "off". Overrides the initial setting to turn the Dice Game on or off during the show. Note that turning the game off will suspend the display of the notice, and tips will no longer win a prize, however, the roll history is kept until the bot is restarted.

/dicerolls: (all users) Display a listing of the last (up to) 20 dice rolls. Especially helpful if there have been several rolls in succession, prevents the need to have to scroll up to find the prizes won.

/chgdice [amt]: (mods/bc only) Change the price of the dice roll within the show, where [amt] is the new amount to use.

S. Raffle
The Raffle feature allows viewers to tip a specified amount to buy a raffle ticket at one of up to 5 levels. If using the raffle, the prize list should be defined when starting the bot. You can specify a single prize at each level (or only one level), or a list of prizes that are all available for drawing at that level.
Some examples:
- If doing a raffle for a single prize, just list that prize description in the Level 1 Prize List, and assign a ticket price for each raffle ticket to be bought for drawing a winner of that prize.
- If doing a raffle for multiple prizes, but you want the ticket price to be different for each, put one prize in each of the up to 5 levels, and assign a ticket price for each level. This may be done to have more expensive tickets for more valuable prizes.
- If doing a raffle for multiple prizes, and more than one prize is available at each ticket price level, enter a list of prizes with commas separating them (no spaces between prizes), such as: "video bundle,snapchat for life,polaroids in the mail". When the drawing is performed, a winner will be assigned for each prize in the list.
Tickets are 'used' when a winner is drawn - winning tickets are removed from the pool of available tickets if there are multiple drawings. If there are more prizes than there are entries within a given level, the drawing will only assign as many prizes as there are tickets sold.
There are four modes that can be used to define the length of the raffle, and then separate control for whether the actual drawing is performed automatically or by the broadcaster triggering it with a command. The mode can also be changed during the show using the /chgrafflemode command (see below).
- Broadcaster's discretion - There is no pre-defined length of the raffle, tickets are sold until the broadcaster decides to perform the drawing. This would commonly be used if selling tickets over multiple days and a set date in the future has been decided for the raffle drawing.
- Timer - Tickets will be sold within the current show while a timer is running and then the drawing performed at the end of the time. The default timer length is defined on the start page but time can be added or removed during the countdown. The drawing can be automatic, or the broadcaster can trigger the drawing with the /raffledrawing command per the setup.
- Ticket Goal - The drawing will be performed when a total number of tickets threshold is met. The drawing can be automatic (a 2 minute countdown is started when the goal is hit), or the broadcaster can trigger the drawing with the /raffledrawing command per the setup.
- Token Goal - The drawing will be performed when a total number of tips threshold is met (only includes raffle ticket purchases). The drawing can be automatic (a 2 minute countdown is started when the goal is hit), or the broadcaster can trigger the drawing with the /raffledrawing command per the setup.
In addition to defining the mode and automatic/manual drawing, you can also define if there is a single drawing or continous goal reset with a drawing at the end of each cycle. For example, you could set it to perform a drawing every hour, and start a new one hour countdown each time. If doing a continuous drawing show, there is a setting for whether the pool of tickets bought should be cleared after each drawing, or kept intact and ticket holders have a chance to win in multiple drawings (preferred).
As with all other portions of the ultrabot, be sure to not use an overlapping token amount for the raffle ticket price that may have already been used for the tip menu, token poll, dice game, etc.
*** If doing a raffle over multiple shows, be sure to save the ticket list before ending the show or the bot! The list cannot be saved permanently within the show, so you must use the "/entries" command to display the current list, copy the list, save it externally, and paste it back into the raffle ticket list field when next launching the Helena-Bot. Completely replace the previous list each time. You can also end the Helena-Bot and paste the results and restart the bot at the end of the show, but I would still save the list externally as CB sometimes clears bot memories.
Note that each ticket purchase is an indvidual entry in the list, so one user may have multiple entries. Tickets can only be bought for the exact ticket price, there is no multiple ticket purchase from a single tip of a multiple of the ticket price.

/useraffle [on/off]: (mods/bc only) Toggle the setting for whether the Raffle Feature is "on" or "off". Overrides the initial setting, and allows you to turn the Raffle on or off during the show. Note that turning the raffle off will suspend the display of the notice, and tips will no longer buy a ticket, however, the ticket purchase history is kept until the Helena-Bot is restarted.

/entries (or /raffletickets, or /raffleentries): (mods/bc only) Display the list of raffle ticket entries in a format that can be pasted directly into the bot launch page "previous show" raffle list. As noted above, this must be done to track ticket purchases between shows, or restarts of the Helena-Bot.

/previousentries : (mods/bc only) Display the same list of previous ticket purchases that was specified when launching the bot, mainly for informational purposes if there is a question of what was bought in previous shows vs the current total list.

/resetraffle (or /clearraffle): (bc only) Delete all raffle ticket purchase history and start a new raffle with the existing settings. Obviously be careful using this command as you will lose all outstanding tickets. It will display a list of ticket holders in the chat for the broadcaster in case this is done by mistake, the list could be put back in.

/addraffletkt [level] [user]: (bc only) Manually add a user to the specified ticket purchase level. The synatx would be "/addraffle 2 john" to give user name john a ticket for the level 2 drawing.

/rmvraffletkt [level] [user]: (bc only) Manually remove a user from the specified ticket purchase level. The synatx would be "/rmvraffle 2 john" to remove user name john's ticket for the level 2 drawing. Note that it will only remove the first occurrence of that user's ticket for that level, the command must be executed multiple times if they have multiple tickets.

/raffleprizes: (all users) Display the available prizes in the Raffle, by level, only shown to the user that requests it.

/setraffleprice [level] [newprice]: (mods/bc only) Change the price of the specified [level] raffle tickets, setting it to a value of [newprice]. Note this can also be used when adding a price to a level that was not previously set. In order to add prizes to a level, there must first be a price set.

/raffledrawing: (bc, mods when configured) Perform the raffle drawing when not set to Automatic Drawing mode. The parameter value should be "all" to perform the drawing for all levels, or a specific level number. For example "/raffledrawing all" or "/raffledrawing 1". When the drawing is performed, the winners from each level will be chosen and displayed in the chat. Note that the winner history is not tracked, so you must distribute the prizes or make note of the winners as they are shown in the chat. If continuous mode is selected, the goals are reset and the next cycle is started, which may clear the ticket pool if configured to do so in continuous mode.

/rafflestarttimer (or /startraffletimer) [time]: (mods/bc only) Start a [time] minute timer for the raffle drawing when in 'timer' mode with the drawing to be triggered by the /raffledrawing command. The timer will count down but not automatically perform the drawing (unless set to automatic mode but the auto-timer was ended, and this is a restart of that timer)

/raffleaddtime (or /addraffletime) [time]: (mods/bc only) Add [time] minutes to the timer for either automatic or manual drawing mode. The [time] value can be a negative number to subtract time, but cannot be greater than the remaining time.

/rafflestoptimer (or /stopraffletimer): (mods/bc only) Stop the raffle timer for either automatic or manual drawing mode.

/raffletimeleft : (mods/bc only) Display the time left on the raffle timer for either automatic or manual drawing mode.

/chgrafflemode [manual/timer/ticketgoal/tokengoal]: (mods/bc only) Switch between the modes being used to determine when to perform the raffle drawing. If switching from a timer show to a non-timer show, the timer will be ended. Ticket count and Tip Count are being tracked regardless of mode, so switching to a 'goal' mode should not require starting progress at 0.

/addraffleprize [level] [prize]: (mods/bc only) Add a raffle prize to the specified [level] (1-5) with a description of [prize]. Note this does not validate the existing entries in the list, so you can add the same prize to the list multiple times if you want to give it away multiple times as a prize in the same drawing.

/rmvraffleprize [level] [prize]: (mods/bc only) Remove the specified raffle [prize] from the specified [level] (1-5), the text must match the existing prize exactly (case and punctuation). Note this will remove all occurrences of the the prize in the list that have the same name.

T. All-Time Tipper List
This feature allows you to keep track of all-time tippers and display notices in the chat for the Top 10 all-time tippers. As with the raffle, the list must be maintained externally since there is no way with CB bots to permanently store the data captured during the show. Therefore, at the end of each show, be sure to use the "/alltime" command to output the current list to the chat so you can copy and paste it for the next show. This list should also be saved outside of CB in case the CB bot settings are lost.

/usealltime [on/off]: (mods/bc only) Toggle the setting for whether the tracking of all-time tipper information is "on" or "off". Overrides the initial setting, and allows you to turn the tracking on or off during the show. Note that tip totals are only extracted when the "/alltime" command is used, so it can be enabled anytime during the show without losing any information. The toggle mainly controls if the commands are allowed to be executed.

/top10 (or /alltimetop10, or /dsptop10) : (all users) Display a listing of the top 10 all time tippers. Sent to the user that requested, unless requested by moderator or broadcaster, then sent to all. This list is presented in the same format as the notice, not in the format needed to paste into the previous show totals field on the launch page (use the "/alltime" command for that).

/alltime (or /listalltime, or /alltimelist) : (mods/bc only) Display the all-time tipper totals, including previous show totals and current totals, in a formatted list that can be copied and pasted into the previous show all time list on the launch page. As noted previously, this list should also be saved outside CB.

U. On-demand Private Shows

This feature allows you to initiate a one-on-one private with a user who may have paid for a show outside of CB, and takes the place of needing to do a password show and provide the password to the user. The cam will be hidden in the same way a ticket show or private does, however there is no tipping required or per minute charge. Also there is no spying on the show.

/startprivate (or /goprivate) [user]: (bc only) The broadcaster initiates the private, and only the user name entered will be able to see the show. The room will be immediately hidden in the same way as a ticket show. Make sure to enter the user's name correctly!

/stopprivate (or /endprivate) : (bc only) End the private hidden cam show and immediately return to public chat.

V. Other Commands

/newsubject [title]: (mods/bc only) Update the room subject to a new value [title].

/checkcolor [bg],[fg]: (mods/bc only) Display a sample message using the colors entered for purposes of experimenting with colors to find a combination you like.
The [bg] is the background or highlight color and the [fg] is the foreground or text color.
The value entered can either be the text value of one of the colors defined in the drop down lists for the bot, or can be a 6 character hex code, including the '#' sign, (something like #FFFFFF).
For example, you could use the command "/checkcolor #cdcdff,#0000ff" or "/checkcolor Light Pink,Dark Pink".

/dumpsettings: (mods/bc only) send a listing of the full configuration settings list to the chat for the current user. Will eventually be able to send the dump for individual config sections.

/pricechecklist: (mods/bc only) Display a listing of all the entries in the price checker tool that validates duplicate entries and common tip amounts.

/nocaps [on/off]: (mods/bc only) Toggle the suppression of capitals on and off. One word with capitals is allowed when on, any more than that converts the whole message to lower case and displays a warning to the user.

/nnlist: (mods/bc only) Display the nickname list that is defined on the bot start page.