Dorothy's UltraApp

Short Description:

App for Ticket Show, Single Goal, Progressive Goals (Multi-goal), Goal Counter, Tip Sequence, and Tip Jar

Full Description

Current Version 2.4 (7/30/2019). Note: The Change Log of fixes and enhancements in each release is at the bottom of the page. Please follow me on twitter @thechelsea2950 for app and bot updates.

Summary

The purpose of this "Ultra" App is to provide many of the most commonly used app features on Chaturbate in one place, specifically goal and ticket shows, and give the broadcasters and trusted moderators the ability to change many of the settings being used on-the-fly, without restarting the app. This includes the ability to add and edit goals and change settings. It is recommended to start this at the beginning of each show and not reset it unless truly necessary, as you will lose the data accumulated in the current session.
This app does not contain many common bot-driven features such as leaderboard, chat control, timers, etc, as it is expected you will be using an ultrabot like Dorothy's Ultra Fembot (or Dorothy's Easy Fembot for shorter setup) to perform those functions.
Another reason I started doing my own development was to create apps and bots that do not have developer backdoors giving people you don't know access to your show, in particular hidden cam shows. As you can see, the source for my apps an bots will always be visible, I don't encode it or try to hide the source like many others do, so you can see that no one, including me, is granted access to anything without your permission.

As you use the app, one thing to keep in mind is that the changes you make using the commands within a show are not permanently updated to the start page - you have to make those changes there for them to be saved. This includes things like goal changes, changes to the outstanding ticket list, etc.
I recommend keeping all of these lists in a separate notepad document so you can update them as you go, and copy and paste them into the boxes on the setup page when you start a show, especially in case something happens and the configuaration page gets reset.

The App features are:

1. UltraApp Ticket Show - Sell tickets to a hidden ticket show. Pre-sales are also supported.


2. Single / Progressive Goals - Similar to the Single Goal or Tip Multi-Goal apps, setup one or more goals for people to tip toward.


3. Goal Counter - Use smaller incremental goals with prizes at intermediate goal counts.


4. Tip Sequence Goals - People tip in an ascending or descending sequence with prizes at intermediate sequence numbers.


5. Tip Jar - Tip to a goal, and once the goal is reached, perform the prize until the tip jar runs out. Multiple goals with ability to recycle each one. Can speed up or slow down the drain rate on the tip jar.


6. Goal Race - Tip to one of two competing goals, First one completed wins!


7. Spank-a-thon - Tip using the menu for up to 5 types of spanks to be performed when goal is reached. App keeps track of the accumulated totals for each type, and goal progress.


8. Peep Show - Another type of hidden show that uses a "pay as you go" format rather than buying a ticket.

Note that when the UltraApp is started, you'll set the 'current' app to be one of the 8 choices above. Most commonly, users will start with one of the goals to help drive the show. Goals help keep things moving towards an end goal, which could be done in public or sometimes it may make sense to do a hidden ticket show if there are enough people in the room (recommend at least 1500 total viewers) and tipping has slowed down or there are privacy concerns. If that is the plan, you can then easily switch from the goal show to the ticket show.
The App also allows you to switch between each feature without losing your progress in the previous feature, so you can switch back and forth and continue where you left off. So if you wanted to start with goals, and during the goal show, switch to spank-a-thon, or a peep show, you can do those features and then switch back to goals and resume your progress.
If there are errors when attempting to start the current app (usually settings missing or not entered correctly - you'll see an error message in yellow), no feature is started and the draw panel (box below the video window) will show that no app is running. You can either re-launch the bot and update the settings, or manually update using the commands below and then use the /chgapp command to initiate the feature you want to use. It is also possible to turn off the apps and just track total tips if you change the current app to 'none'.
In general, with all of the goal app features, it's important to enter the goals in the slots 1 thru 10 (or 20) in the order they will be performed during the show. You can either specify a final goal in the room description, or set it as the last goal defined in the settings.
I've also added the ability to control your background and text color in the draw panel, if you'd like a personalized background, just contact me, and if you'd like to make it yourself, send me a 270 x 69 pixel image to use as the background.
There are External Fan Club and VIP lists that you can use to assign users that will have special access in the app, which would be duplicated in teh setup for the Ultra Fembot and Gamebot. If users are added to these lists during the show using a command, they are automatically added to all 3 bots/apps since they share the same command.
There is also a "App Moderator" status that can be assigned so that non-CB mods can still have moderator authority within the app, the same as the "bot Mod" feature in the Ultra Fembot and the Gamebot.

All Bots and Apps by chelsea2950
Link for Easy Fembot: Dorothy's Easy Fembot - Simpler ultrabot for newer cammers with minimal config, most features related to chat control.
Link for Ultra Fembot: Dorothy's Ultra Fembot - Messaging for mods and broadcasters, Private Messages to other users, Silence Level and Graphic Level, Leaderboard, Nice List, Tip Count next to name, Silence individual users, Silence individual users without notification (ninja), Tip Menu 1 & 2, Positions Tip Menu, Token Poll, VIP List, External FanClub List, Blocked word list, Additional Notifiers (up to 5 rotating), User Group icons next to name (mods, CB fan club, external fan club, VIP list), Color control of most messaging, Ticket prep function (disable regular tip menu, enable positions menu and token poll), Lush/Nora/Domi Menu, Media Contact List, Ticket show pre-sales, Hidden Ticket Show, Dice Game, Gray Chat Time Lock, Raffle, Price Checker - ensure same price not used across features, All time tippers, Assign nicknames
Link for UltraApp: Dorothy's UltraApp - This app...
Link for Dice game: Dorothy's Dice Game - Roll 2 6-sided dice to win prizes, plus a rare special roll of '13'. Note this same version of the game is also already built in to the Ultra Fembot.
Link for Ticket Show App: Dorothy's Ticket Show - Same as the ticket show portion of this App - Sell tickets and then lock the room for a private show.
Link for Tip Goals App: Dorothy's Tip Goals - Run a goal show with either a single goal or multiple progressive goals. Same as the goal feature of the Ultra App in its own separate App. Like the UltraApp, the Tip Goals App also has customizable draw panel backgrounds.
Link for Ultra Gamebot: Dorothy's Ultra Gamebot - Includes Dice, Wheelspin, Keno, War! (High Card), Russian Roulette, Press Your Luck, all with a common prize list that can be used across all the games so you don't have to keep setting up prizes in different bots

Please let me know if you find any issues or have recommendations for improvement, you can usually find me on the couples rooms on the site, or on twitter @thechelsea2950, please feel free to message me there with questions and ideas!

Commands

Most of these are available for moderators and broadcasters only, with some exceptions. Note that you can also type "/uahelp" within the chat to see the list of commands as well.
The App allows assignment of "App Moderators" that have same privileges as CB assigned moderators within the app, but do not show as red names.
The commands to add mods, remove mods and show the mod list are the same within the UltraApp, Gamebot and Ultra Fembot, so running these three commands will execute in all 3 apps/bots at the same time.

A. General commands across most or all App features

The primary command noted below is the /chgapp command, which lets you switch between each of the 5 apps that are built into the UltraApp so far. You can switch at any time, but you if you change in the middle of a goal, you cancel any open goals in that app when you do.
Total tipping and time online stats are also kept and can be accessed anytime. There is also a parameter in the 'General Settings' section to turn on/off the display of the total tips accumulated so far for each app on the draw panel (you can still see them in the /stats info).

1. /chgapp [newapp]: switch from one app to another, or turn off the current app. The values used for [newapp] are 'goals', 'goalcount', 'sequence', 'tipjar', and 'ticket' to go along with the 5 types of shows, or the value of 'none' to turn off the current app feature and not start a new one immediately.


2. /stats : Display a listing of your time online (with the app running), total tips, and tips broken down by app.


3. /skip and /next: These are available in most of the apps, so they are are listed within each section with specifics of what they do for that app. In all of the apps except the ticket show, use the /skip function to bypass the rest of the current goal and start the next goal fresh. Note it can be used with the tip jar, but not while the tip jar is actually draining. With the sequence app, it just advances to the next sequence.


4. /addtips [tokens]: Within the goal apps (Progressive Goal, Goal Count, and Tip Jar), this can be used to simulate users having tipped and advance the token count within a goal. Indicate the number of tokens you are adding as the [tokens] parameter, and note the value can be negative. You can add more than the current goal, but you cannot subtract less than has been tipped in the current goal.


5. /listgoals (also /lg): List the current setup of the goals for the App feature that is active.


6. /chgpanelbg [imagename]: Change the background of the drawpanel to one of the valid images. Images are updated regularly, so you can see the current list by entering this command with no parameter and the error message will show the current valid choices. Note that you can also see the images by going to the 'Source Code' tab for the app and clicking the link for 'App Images'.


7. /chgpaneltext [newcolor]: Change the color of the text in the drawpanel to either a hex code (#0000ff) or the exact text of one of the color choices from the menu ('Dark Green', 'Dark Red', etc). You can lookup hex codes for any color on a site such as Color-hexa: https://www.colorhexa.com/


8. /paneltext1 [newtext] (also /paneltext2, /paneltext3) : When there is no App running, change the text displayed in the draw panel, separate commands for lines 1-3, max of 50 characters each. If an app is running but completed, can change to no app running with "/chgapp none".


9. /addfan [user]: (bc only) From within the show, adds a user to the External Fan Club list where [user] is the person you want to add. Normally these users are entered in the Fan Club List field on the launch page, but the command can be used if there is a new fan during the show.


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


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


12. /addvip [user]: (bc only) From within the show, adds a user to the VIP list where [user] is the person you want to add. Normally these users are entered in the VIP List field on the launch page, but the command can be used if there is a new VIP during the show.


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


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


15. /addmod [username]: (bc only) Add users to the UltraApp Moderator List.


16. /rmvmod [username]: (bc only) Remove users from the UltraApp Moderator List.


17. /modlist: (mods/bc only) Displays the list of users currently in the UltraApp Moderator list (list will also include broadcaster and CB mods).

B. Single / Progressive Goals

For the progressive goal show, you can setup a single goal, or multiple goals that will be progressed through in sequence as users tip. There is a configuration flag that defines if the app automatically moves from one goal to the next, or requires the use of the /next command to advance after the goal is met. If set to automatic advance, tips that exceed the goal will carry over to the next goal. If set to advance by command, the tips do not roll over.
By default, the room subject will show the current goal amount and description, the next goal description and a configurable block of text that you can use to describe what happens at the last goal or after the goals, or even just put searchable hashtags to draw more people into the show. This room subject text can be edited using the "/setgoaltext" command as noted below.
Any changes you make are not stored permanently, they are only stored within the current session. They will be kept if you switch between app features, but not if you deactivate the app.
Also, you must keep the goals in sequence, and cannot add an entry that would leave an empty level. For example, if goal levels 1-3 are filled in, you can't add a level 5, you must add a level 4 first.

1. /restartgoal : If you'd like to repeat a goal (common if you have a single goal you're recycling), you can use this command at any time to reset the tip count on the current goal to 0 (even if already complete)


2. /setgoal1, /setgoal2, /setgoal3...(thru /setgoal20) [goal] [description]: These are the commands that let you edit the goals for your show. Both the [goal] and [description] parameters must be entered every time and will update both values. Note this is also only a temporary change made within the session, it does not permanently update the launch page config.

--The 1-20 designation as part of the command identifies which entry you are modifying.
--The [goal] parameter is the new value you are setting for the goal amount. Even if you are not changing the goal (only changing the description, you must still enter the existing value for the goal.
--The [description] Parameter is the new value you are setting for the goal description. Even if you are not changing the description (only changing the goal amount), you must still enter the existing value for the description.
--An example of the syntax for this command would be "/setgoal4 400 Blow job", which would set goal 4 to be a Blow Job once you reach 400 tokens.
--Note that you can't make updates to the current goal or past goal, only future goals.


3. /rmvgoal [level]: Remove the goal entry for goal level of [level] (amount and description are both removed). Note this is also only a temporary change made within the session, it does not permanently update the launch page config.


4. /setgoaltext [newsubject]: Update the text that is shown in the Room Subject between the current goal and the next goal.


5. /next : Used to advance to the next goal once the current goal is complete, when auto advance is turned off.


6. /skip : Advance to the next goal regardless of the status of the current goal.

C. Goal Counter

For the Goal Counter show, you define the smaller goal amount that will be tipped repeatedly, and then define prizes that will occur at a certain number of goals reached. For example, you may define that each goal will be 99 tokens, and then at 5 goals you take off your shirt, 10 goals take off your pants, etc. If there is a final/end goal, set it up as the highest of the goal level thresholds in the configuration list, the app will stop counting once the highest goal count is met.
By default, the room subject will show the remaining goals levels and their descriptions/prizes, plus a configurable block of text that you can use to describe what happens at the last goal or after the goals, or even just put searchable hashtags to draw more people into the show. This room subject text can be edited using the "/setcounttext" command as noted below.

1. /setcount1, /setcount2, /setcount3...(thru /setcount15) [goal] [description]: These are the commands that let you edit the goal levels for your show. Both the [goal] and [description] parameters must be entered every time and will update both values. Note that you can use these commands to add or edit an entry, however they cannot be used to delete an entry (use the /rmvcount).

--The 1-10 designation as part of the command identifies which Goal Level entry you are adding or modifying.
--The [goal] parameter is the new value you are setting for the goal level (such as '10' for doing a prize at the 10th goal). Even if you are not changing the goal level (only changing the description, you must still enter the existing value for the goal level.
--The [description] Parameter is the new value you are setting for the goal level description. Even if you are not changing the description (only changing the goal level), you must still enter the existing value for the description.
--An example of the syntax for this command would be "/setcount5 20 Blow job", which would set goal level 5 to be a Blow Job, to be done after you've hit the individual goals 20 times.
--Note that you can't make updates to the current goal level or past goal levels, only future goal levels.


2. /rmvcount [level]: Remove the goal from goal counter level of [level] (amount and description are both removed). Note this is also only a temporary change made within the session, it does not permanently update the launch page config.


3. /setcounttext [newsubject]: Update the text that is shown in the Room Subject after the listing of the remaining goal levels.


4. /chgcountgoal [amt] : Change the amount that is being used for the individual goal levels (99 in the above example) to a new value of [amt]. If changing the value after the tipping has already started, it cannot be set to a value that is less than the tips received against the current goal.


5. /skip : Advance to the next individual goal regardless of the status of the current goal. Note this will only do one individual goal at a time, you can use the command /skiplevel described below to skip past the current goal level threshold


6. /skiplevel : Advance to the point the next goal level is complete, regardless of the status of the current goal. If there are no more goal level prizes, this will skip to the end of the show, so check the goal list (/lg) to be sure you know how what levels remaining have goals. As an example, if you are on goal 7, and there are prizes every 5 goals, it will skip ahead to having completed goal 10.

D. Tip Sequence Goals

For the Tip Sequence goal show, you can setup the starting and ending points in a sequence that users will tip through, and there can be intermediate goals defined at certain sequence thresholds. The tip sequence can be ascending or descending. For example, you could define the sequence as ascending from 1 to 50, with a goal threshold at 15, 20, 30, and 40... you could also define a sequence as descending from 60 to 10, with goal thresholds at 50, 40, 30, 20, 10, the direction, the range, and the goal levels are all configurable.
By default, the room subject will show the remaining goals sequence levels and their descriptions/prizes, plus a configurable block of text that you can use to describe what happens at the last goal or after the goals, or even just put searchable hashtags to draw more people into the show. This room subject text can be edited using the "/setsequencetext" command as noted below.
Group tipping is available, which allows smaller tips to be accumulated against the current tip sequence number, and advancing when the accumulation meets or exceeds the next number.
There is also a parameter to turn on/off the display of the total tips that will result for the range.

1. /setseq1, /setseq2, /setseq3...(thru /setseq10) [goal] [description]: These are the commands that let you edit the goal levels for your show. Both the [goal] and [description] parameters must be entered every time and will update both values. Note that you can use these commands to add or edit an entry, however they cannot be used to delete an entry (use the /rmvseq).

--The 1-10 designation as part of the command identifies which Sequence Goal Level entry you are adding or modifying.
--The [goal] parameter is the new value you are setting for the goal level (such as '10' for doing a prize once the count sequence reaches and exceeds the number 10). Even if you are not changing the sequence goal level (only changing the description), you must still enter the existing value for the sequence goal level.
--The [description] Parameter is the new value you are setting for the goal level description. Even if you are not changing the description (only changing the goal level), you must still enter the existing value for the description.
--An example of the syntax for this command would be "/setcount5 20 Blow job", which would set goal level 5 to be a Blow Job, to be done after you've hit the individual goals 20 times.
--Note that you can't make updates to the current sequence goal level or past sequence goal levels, only future sequence goal levels.


2. /rmvseq [level]: Remove the goal from sequence goal level of [level] (amount and description are both removed). Note this is also only a temporary change made within the session, it does not permanently update the launch page config.


3. /setsequencetext [newsubject]: Update the text that is shown in the Room Subject after the listing of the remaining goal sequence levels.


4. /usechatmsg [on/off] : Toggle the flag on and off for whether a message is posted in the chat for each sequence as it is achieved.


5. /usegrouptips [on/off] : Toggle the flag on and off for whether group tipping is allowed.


6. /skip : Advance to the next sequence regardless of the status of the current sequence.


7. /chgendseq [newseq]: Update the value for the end of the sequence. When ascending this is the higher number of the range, and when descending it is the low number of the range. The value cannot be updated to a sequence that has already been passed, or affect the current goal level target.

For reference, here are the total number of tips for several common sequence ranges:
from 1-10=55
1-20=210
1-30=465
1-40=820
1-50=1275
1-60=1830
1-70=2485
1-80=3240
1-90=4095
1-100=5050

E. Tip Jar

For the Tip Jar show, you can setup a single goal, or multiple goals that will be progressed through in sequence as users tip. As each goal is reach, a countdown begins using the number of tokens in the jar (total tips when goal was hit or passed). Tokens begin to 'drain' out of the jar at the specified rate of tokens per second. During this time, the user is performing the prize for that goal, and they would stop performing once the tip jar runs out/empties. While it is draining, users can continue to tip to keep it full and keep the performance going.
One the jar is empty, there is a configuration flag that defines if the app automatically moves from the completed goal to the next, or requires the use of the /next command to advance after the goal is met. If set to automatic advance, user will now be able to tip towards the next goal.
The goals also have a recyle count setting, which lets the broadcaster identify that some goals will be repeated over and over, to the defined threshold. Note that a recycle of '1', means that the goal will be performed twice (two cycles).
By default, the room subject will show the current goal amount and description, and a configurable block of text that you cn use to describe what happens when the tip jar is running, or even just put searchable hashtags to draw more people into the show. This room subject text can be edited using the "/setjartext" command as noted below.

1. /setjar1, /setjar2, /setjar3...(thru /setjar10) [goal] [recyc] [description]: These are the commands that let you edit the goals for your show. All three of the [goal], [recyc], and [description] parameters must be entered every time and it will update all three values. Note that you can use these commands to add or edit an entry, however they cannot be used to delete an entry (use the /rmvjar for that).
   The 1-10 designation as part of the command identifies which entry you are modifying
   The [goal] parameter is the value you are setting for the goal amount. Even if you are not changing the goal (only changing the description), you must still re-enter the existing value for the goal.
   The [recyc] parameter is the value you are setting for the recycle count. Even if you are not changing the recycle count (only changing the goal amount or description), you must still re-enter the existing value for the recycle count. Note that the default for recycle is '0', which means the goal is done once. With a recycle of '1', the goal is done twice, and if the recycle is '2', the goal is done three times, etc.
   The [description] Parameter is the value you are setting for the goal description. Even if you are not changing the description (only changing the goal amount), you must still re-enter the existing value for the description.
   And example of the syntax for this command would be "/setjar2 400 Blow job", which would set goal 2 to begin a Blow Job once you reach 400 tokens and continue that prize as long as the tip jar has tokens in it.
   Note that you can't make updates to the current goal or past goals, only future goals.


2. /rmvjar [level]: Remove the goal for the tip jar goal level of [level] (amount and description are both removed). Note this is also only a temporary change made within the session, it does not permanently update the launch page config.


3. /setjartext [newsubject]: Update the text that is shown in the Room Subject after the current goal.


4. /faster [levels]: Speeds up the drain rate by the specified number of levels. If no level is specified it is assumed to be by one level. If a level is specified beyond the maximum, the maximum is used.


5. /slower [levels]: Slows down up the drain rate by the specified number of levels. If no level is specified it is assumed to be by one level. If a level is specified below the minimum, the minimum is used.


6. /next : Used to advance to the next goal once the current goal is complete, when auto advance is turned off.


7. /skip : Advance to the next goal regardless of the status of the current goal. This will also bypass the prize/draining of the jar for the current goal. Note that for the Tip Jar goals, the /skip and /next work in a similar fashion.

As noted, the drain rate can be increased or decreased, and below are the available rates. You set the default on the launch page, and then you can change it during the show using the /faster and /slower commands:
Level 1: 5 tokens per second (fastest)
Level 2: 4 tokens per second
Level 3: 3 tokens per second
Level 4: 2 tokens per second
Level 5: 1 token per second
Level 6: 1 token every 2 seconds
Level 7: 1 token every 3 seconds
Level 8: 1 token every 4 seconds
Level 9: 1 token every 5 seconds
Level 10: 1 token every 10 seconds (slowest)

F. UltraApp Ticket Show

As noted, the Fembot'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 the UltraApp Ticket Show rather than the bot if possible. Both have the benefit of not giving anyone you don't know access to your shows.
Since it is not expected to have both the Fembot Ticket Show and the UltraApp Ticket Show 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 other ticket show app 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.
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.
Note that a "Fan Appreciation Mode" has been added with will only allow fans and VIP members into the show and not advertise any ticket sales or prices.
Pre-sales have also been added to the UltraApp. When enabled, pre-sales can be started while the other goal features are still running - users will be added to the ticket show list as they tip the pre-sales price. No need to export the presale list from one app to another.
A separate section is documented below for pre-sales - note that since it is not expected to have pre-sales running in both the Fembot and the UltraApp at the same time, the commands remain the same for both.

1. /tickets : (all users) 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.


2. /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.


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


4. /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.


5. /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.


6. /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.


7. /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.


8. /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.


9. /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.


10. /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.


11. /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.


12. /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.


13. /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.


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


15. /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.


16. /restartshow: (mods/bc only) Go back into hidden cam mode if the show was accidentally ended too soon. The ticket holder list, ticket price and show description are kept intact.


17. /restartsales: (mods/bc only) Restart ticket sales either during the show (after /showend was used), or after you've ended the show to go back to the ticket sales stage. The ticket holder list, ticket price and show description are kept intact.


18. /ticketprice (or /ctprice, or /chgticketprice) [newprice]: (mods/bc only) Update the ticket price to the [newprice].


19. /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)


20. /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.


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


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


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


24. /chgticketmode (or /chgtktmode) [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.


25. /chgticketauto (or /chgtktauto) [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.


26. /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.


27. /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!


28. /ticketsubject (or /ctsubject) [newsubject]: (mods/bc only) Change the room description/subject/title to a new value.


29. /ctn: (bc/mods) Post a one-time notice in the chat. The syntax for using this type of notice is "/cn [X]", where [X] is the message you want to send. This is the plain notification without any separators or highlighting.


30. /ctnd: (bc/mods) Post a one-time notice in the chat. The syntax for using this type of notice is "/cnd [X]", where [X] is the message you want to send. This notification includes a dash separator before and after the message, but no highlighting.


31. /ctnh: (bc/mods) Post a one-time notice in the chat. The syntax for using this type of notice is "/cnh [X]", where [X] is the message you want to send. This notification includes highlighting, but no separators.


32. /ctndh: (bc/mods) Post a one-time notice in the chat. The syntax for using this type of notice is "/cndh [X]", where [X] is the message you want to send. This notification includes both separators and highlighting.


33. /prepticket : (mods/bc only) From single command, makes updates in both Fembot and UltraApp. In UltraApp, does same thing as "/chgapp ticket" plus based on config on launch page can also start the ticket show countdown timer. The default timer can be overridden by specifying a timer duration on the command, such as "/prepticket 15" for a 15 min timer.


34. /previewers : (all users) Display a list of the user names currently seeing a free preview of the show.

G. Ticket Show Pre-sales

In addition to the above commands, there is a subset of ticket show related functions related to pre-sales for an UltraApp ticket show.
As noted above, since it is not expected to have pre-sales running in both the Fembot and the UltraApp at the same time, the commands remain the same for both (DO NOT RUN PRE-SALES FROM BOTH AT THE SAME TIME).

1. /uapresale [on/off]: (bc/mods only) Overrides the launch page setting for whether Pre-sales are conducted in the UltraApp or the Fembot. Using a parameter of "on" enables presales in the UltraApp. Note you can still start and stop the actual pre-sale of tickets once enabled for the ultraApp using the two commands below.


2. /startpresale: (bc/mods only) Begin selling pre-sales tickets. Only allowed if Pre-sales are enabled for the UltraApp (see above command).


3. /stoppresale: (bc/mods only) Stop selling pre-sales tickets. Only allowed if Pre-sales are enabled for the UltraApp (see above command). Note the ticket list remains intact, but new pre-sale purchases are disabled.'


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


5. /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.


6. /pspricetimer [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.


7. /presaletimer [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.


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


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


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


11. /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.


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


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

H. Goal Race

In the goal race, the broadcaster sets two competing goals (like panties off vs bra off, or oral for him vs oral for her), and the users select which goal they want to tip toward.
When this app is active and a user tips, the tip panel will show a choice of the two goals to tip toward, they can choose one of the two goals, or not make a selection.
The user can also toggle on and off a personal setting that allows them to either send votes or regular tip notes.
The goals, goal descriptions, room subject text, and panel subject text are configurable on the launch page and also through the commands below, so you don't have to restart the app to make changes.
There is also a feature for the user to add their 'unclaimed' tips toward one of the goals later if they did not indicate a goal when they actually tipped.

1. /restartrace: Lets you restart the goal race (reset tip amounts to 0) with the same settings.


2. /setrace1, /setrace2 [amount] [description] : These are the commands that let you edit the goal amounts and goal descriptions for your show. Both the [amount] and [description] parameters must be entered every time and will update both values.

--The "1" or "2" designation as part of the command identifies which Goal Choice entry you are modifying.
--The [amount] parameter is the new value you are setting for the goal amount (such as "500" for a goal amount). Even if you are not changing the goal amount (only changing the description), you must still enter the existing value for the goal amount as both will be updated.
--The [description] parameter is the new value you are setting for the goal description (such as "Bra Off"). Even if you are not changing the description (only changing the goal amount), you must still enter the existing value for the description.
--An example of the syntax for this command would be "/setrace2 500 Bra Off", which would set goal #2 to be the choice of "Bra Off".
--Note that you can't make updates to the goal amount that would be less than what is already tipped for that goal.


3. /addrace1, /addrace2: If someone has tipped during the Goal Race and did not specify a goal at the time, these tips are accumulated and can be "claimed" by that person later for either goal 1 or goal 2 using one of these two commands. The accrued amount cannot be split, the whole amount will go toward the goal selected.


4. /tipnoteon, /tipnoteoff: This command lets you toggle whether the popup window for tipping lets you send regular tip notes to the broadcaster or shows the selection list for casting votes for the goals.


5. /setracetext [newsubject]: Update the text that is shown in the Room Subject after the competing race goals.


6. /setracepaneltext [newsubject]: Update the text that is shown in the first Line of the Draw Panel.

I. Spank-a-thon

The Spank-a-thon is a combination of Tip Menu and Goals. The broadcaster can configure up to 5 types of spankings to be administered (such as hand spanks, paddle spanks, riding crop, etc). For each type, a price is defined per spank, and there is configuration available for 2 more "bundle" prices as well.
Goals can also be setup to set a point at which the spanks will be done. Only one goal is required and up to 5 goals can be configured.
There is a setting to define if all tips count toward the goal or if only spank tips count.
When spanks are completed, the /spanked command can be used to mark them off from the 'to do' list.
The spank menu will be shown periodically in the chat in the same manner as most tip menus.

1. /setspankgoal1, /setspankgoal2, /setspankgoal3...(thru /setspankgoal5) [goal] [description]: These are the commands that let you edit the spank goals for your show. Both the [goal] and [description] parameters must be entered every time and will update both values. Note this is also only a temporary change made within the session, it does not permanently update the launch page config.

--The 1-5 designation as part of the command identifies which entry you are modifying.
--The [goal] parameter is the new value you are setting for the goal amount. Even if you are not changing the goal (only changing the description), you must still enter the existing value for the goal.
--The [description] Parameter is the new value you are setting for the goal description. Even if you are not changing the description (only changing the goal amount), you must still enter the existing value for the description.
--An example of the syntax for this command would be "/setspankgoal2 500 Administer Spanks Round 2", which would set goal 2 to be the described text once you reach 500 tokens.
--Note that you can't make updates to the current goal or past goal, only future goals.

2. /rmvspankgoal [level]: Remove the goal entry for goal level of [level] (amount and description are both removed). Note this is also only a temporary change made within the session, it does not permanently update the launch page config.


3. /setspanktext [newsubject]: Update the text that is shown in the Room Subject between the current goal and the next goal.


4. /spanktotals: Display the current totals for spanks tipped for and administered per spank type


5. /spankmenu: Display the spank menu on demand, note it also shows in the chat notice periodically.


6. /spanktips: Display the history of the spank tips.


7. /spanked X Y: (bc/mods with authority) Update the number of completed spanks for the spank type X, adding Y spanks to the current total.

J. Peep Show

The Peep Show is another type of hidden show, where instead of buying a ticket for the whole show, a viewer can buy time in the show at a per minute rate.
It is expected that this feature would be used for types of shows where you plan to do an activity for a fairly specific length of time, and there's not a likelihood of finishing early.
People will potentially be buying time for most or all of the planned show length, so you should try to make sure you use the full time allotted, and also not go over and make people continually buy more and more time in small chunks and risk missing a part of the show.
As with a ticket show, you can grant Fans, Mods, and VIPs free access to the entire show.
The planned length of the show and purchase rate (tokens/min) can be updated whenever the app is running.
The same commands are used for managing the Peep Show as in the ticket show. When ready to start, you use /startshow to make the cam hidden. Then you can use /showwarn to let people know you are nearing the end, and /showend to suspend further time purchases (just make sure not to do this when people make still need to buy more time). Finally you can revert back to the public show with /stopshow.

1. /mytime: (all users) display the amount of time you have purchased so far, and time remaining.


2. /peepviewers (or /pv) : (all users) Display the list of all users with access to the hidden show. Prior to show start, this will be anyone granted free access (mods, Fans, VIPs, etc). After the hidden peep show starts, it will be all users with access - free viewers and viewers who have purchased time remaining.


3. /peepbuyers (or /pb) : (all users) Display the list of all users who have purchased time in the show, either before show start or during the show. The list will also show the amount of time remaining for each viewer. After a viewer\'s time expires, they are still in this list with 0 time remaining (but will not be in the viewer list above).


4. /peepadd [user]: (mods/bc only) Manually add a specific [user] to the Peep Show Free Viewer list - they will be able to see the whole show.


5. /peeprmv [user]: (mods/bc only) Manually remove a specific user from the Peep Show. Applies to both Free Viewers or viewers with purchased time.


6. /startshow: (mods/bc only) Start the Peep Show when not set to automatic start. Once started, the show will only be visible to Free Viewers and those who have purchased time. Hint: start the show when you are in a good position for the preview pic to be frozen that will attract more buyers after the show starts.


7. /showwarn (or /showover): (mods/bc only) Display a warning that the Peep Show will be ending soon and that time purchases are allowed but not recommended.


8. /showend (or /stopsales): (mods/bc only) Suspend Peep Show sales, no more time 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 do not buy at the last second and are disappointed by getting a short show.


9. /stopshow: (mods/bc only) End the hidden Peep Show and return to a public broadcast if not configured to autmatically end.


10. /peeprestart: (mods/bc only) Go back into hidden cam mode if the show was accidentally ended too soon. The viewer list and time purchase amounts are kept intact.


11. /peepprice [newprice]: (mods/bc only) Update the peep show per minute price to the [newprice] in tokens per minute. If changed during the show, it will not affect viewers who have already purchased time. Once a purchase is made, they are locked in to the time they have bought.


12. /peeplength [time]: (mods/bc only) Update the planned length of the peep show to [time] in terms of minutes. This is only an estimate.


13. /peeptimer [time]: (mods/bc only) Start a [time] minute timer for the start of the peep show when in "timer" mode The timer will count down but not automatically start the show.


14. /peepaddtime [time]: (mods/bc only) Add [time] minutes to the timer for the Peep Show start countdown. The [time] value can be a negative number to subtract time, but cannot be greater than the remaining time.


15. /peepstoptimer: (mods/bc only) Stop the Peep Show Start timer for either automatic or manual drawing mode.


16. /peeptimeleft : (mods/bc only) Display the time left in the Peep Show based on the broadcaster\'s planned show length (estimate).


17. /peepsubject [newsubject]: (mods/bc only) Change the room description/subject/title to a new value. This keeps the standard Peep Show Room Subject formatting and only changes the configurable part of the subject.

Latest enhancements and fixes:

7/30/2019 Version 2.4 (current version):
- ** Peep Show Feature added **
- Added Spank-a-thon totals to the "/stats" info
- Added recurring chat notice for Ticket Show Price (regular price plus Fan/VIP list prices)
- Added "tickets sold" and "tickets sold from free preview" period to the "/stats info", as well as notice at "/stopshow" for tickets sold from preview
- Added "App Mod" privileges for broadcaster defined users, similar to the bot mods in the Ultra Fembot and Gamebot. App Mods have the same privileges as CB red named mods within the App if granted authority. The commands to add mods, remove mods and show the mod list are the same within the UltraApp, Gamebot and Ultra Fembot, so running these three commands will execute in all 3 apps/bots at the same time.
- Fixed all user entered user name lists (VIP List, Fan Club, Mod List) to update with lowercase to match CB conventions
- Added ability to add a new goal after all current goals completed in Progressive Goals feature, and have the app automatically start that goal if it is the next goal number. Previously had to reset the current goal then skip after the new goal was added.

7/24/2019 Version 2.3:
- Changed refresh and added info on draw panel for better display of free preview viewers
- Added logic to manually update line 3 in ticket show after show using /paneltext3 command

7/15/2019 Version 2.2:
- ** Added Spank-a-thon feature ** includes both goals and spank menu to be used together
- Moved the External Fan and VIP lists to the "General Settings" section since these are not specific only to ticket shows
- Added ability to change the panel text when no app is running
- Changed to dynamic positioning of panel text based on length of string. Should allow for better centering of panel text lines.
- Added ability to keep the current progress of the goal features so that if you switch between them and switch back, you can resume from where you left off. Does not apply to Ticket Show and Peep Show, these always start fresh when they are started
- Fixed some issues with the presale timer, added abilty to subtract time from presale timer

7/9/2019 Version 2.1:
- Added Free Preview feature for ticket shows. Can now define a length of time that viewers can see the hidden ticket show when joining the room before the room goes hidden for them. Can also define if users without tokens get the free preview.
- Updated goal counter max thresholds from 100 to 1000

5/19/2019 Version 2.0:
- Increase goal counter to 15 slots
- Add custom panel background for Ashlynn and Jack
- Fix the "white" text color for panel
- Added support for cumulative tips to purchase pre-sale tickets
- Several changes around messaging for pre-sales and to make it easier to recognize and fix scenarios where a ticket show is being run from both the app and bot

4/27/2019 Version 1.9:
- Added command for /restartsales to either start selling tickets again during a show after /showend has been used, or after a show to go back to the ticket sales stage and later start the show again. Retains all current ticket holders.
- Added validation on the Goal Counter feature to ensure goal number settings are in order of increasing goal number

4/19/2019 Version 1.8:
- Added Goal Race feature. Includes ability for use to go back and add their tips to a goal if they didn't select one when tipping, and also toggle between sending votes or sending regular tip notes when tipping.

4/15/2019 Version 1.7:
- Fixed an issue with the display of the ticket holder count and viewer count in the UltraApp when when switching from pres-sales to the ticket show sales
- Added a setting on the UltraApp ticket show to accumulate tips once ticket sales start so that if someone tips the ticket price in multiple tips they can be added automatically and not require the broadcaster or mod to add them. This can be turned off, but the default is to have it on
- Also ensured Fan Club and VIP are added during pre-sales if configured, and highlighted pre-sale ticket holders

4/07/2019 Version 1.6:
- Add pre-sales to ultraApp - no longer need to maintain pre-sales in Ultra Fembot (or other ultrabot), pre-sales made direcly through app while other goal shows features are running
- Change message in UltraApp ticket show to remove ticket price from video window... also add recurring notice of sales ended after /showend
- Added new commands from Dorothy's Gamebot to list of valid commands
- Added support for /prepticket command to perform functions in both Fembot and UltraApp... In UltraApp it can change app from goals to ticket show and start the ticket show timer, in addition to Fembot features (swap menus, start poll, turn on backup ticket list)
- Added Fan Appreciation Show mode to UltraApp Ticket show

3/29/2019 Version 1.5:
- Add ability for all users to see the ticket show ticket buyer list

3/25/2019 Version 1.4:
- Add Support for Dorothy's Gamebot commands

3/14/2019 Version 1.3:
- Display the OT list changes upon stop show.

2/20/2019 Version 1.2:
- Add external fan club and VIP list management within the App to allow for adding them to the show without command entry. If you're already using Dorothy's Ultra Fembot, you'll need to duplicate the EFC and VIP lists from there here into the App as well.

2/14/2019 Version 1.1:
- Added ability to customize background and text color in the panel
- Added ability to change the background panel and text color on the fly using commands /chgpanelbg and /chgpaneltext

2/9/2019 Version 1.0:
- Original release with Ticket Show, Single / Progressive Goals, Goal Counter, Tip Sequence Goals, and Tip Jar features
- Includes Token Stats