Phoebe's Show/Multi-Goal

Short Description:

for Phoebe

Full Description

The App features are:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

/setgentext [newsubject]: Update the general text that is shown in the Room Subject. This text stays intact as you move between app features. Overrides the original value set on the launch page.

/gentextposn [X]: Update the default setting for whether the General Text shown across all App features is shown at the beginning or the end of the room title. Valid values for the X parameter are "0" for the beginning and "1" for the end of the room title.'

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.

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

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

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

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

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

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

C. UltraApp Ticket Show
As noted, the app features are usually a better fit for ticket shows than bots, 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.
There is a more detailed listing of all of the settings used on the launch page for the Ticket Show feature on the stand alone Dorothy's Ticket Show App page here: https://chaturbate.com/apps/app_details/ dorothys-ticket-show/?slot=1
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.

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

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

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

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

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

/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. The ticket holder list, ticket price and show description are kept intact.

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

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

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

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

/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 (or /ctsubject) [newsubject]: (mods/bc only) Change the configurable portion of the room title to a new value.

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

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

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

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

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

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

/previewlength [newlength]: (mods/bc only) Update the length of the free preview period. Note that setting it to zero ("0") will disable the free preview. Please make sure to use one of the following values as the parameter: "0", "10sec", "20sec", "30sec", "1min", "2min", "3min", "4min", or "5min".

D. 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).

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

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

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

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

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

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

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

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

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

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

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

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

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

/spanktips: Display the history of the spank tips.

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