Savannah's tip goals

Short Description:

Set up single goal or multiple progressive goals (multi-goal)copy of Dorothy's tip goals all credit to chelsea2950

Full Description

Set up single goal or multiple progressive goals (multi-goal)copy of Dorothy's tip goals all credit to chelsea2950

The purpose of this Tip Goal App is to provide a goal structure for the show, where viewers wither tip to a single goal or a series of progressive goals. Using progressive goals is very common and allows you to setup the goals for the whole show at the beginning and them automatically advance as each goal is reached.
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 elevated access to your room. 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. For this App, this primarily means changes to the goal amounts, sequence and description that can be done from commands within the app (see below).
The App features are:
- Single & Progressive Goals
- Ability to skip goals, restart goals, manually add tokens to the current goal
- Keep track of your stats for the goal show
- Flexible backgrounds and text colors in the draw panel
Note that it is mandatory to have at least one goal configured with an amount and description, all other goals can be left blank if only doing a single goal.
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.

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 - The UltraApp allows you to easily switch between several of the most common goal features and the hidden ticket show. The goal features are Single Goal, Progressive Goal (Multi Goal), Tip Jar, Tip Sequence (up or down), and Tip Goal Counter. The UltraApp also has customizable draw panel backgrounds.
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, similar to crazyticket but with more features. Like the UltraApp, the Ticket Show App also has customizable draw panel backgrounds.
Link for Tip Goals App: Dorothy's Tip Goals - This App...
***coming soon*** Link for Ultra Gamebot: Dorothy's Ultra Gamebot - Will likely include Dice, Wheelspin, Hangman, Keno, High Card, Roulette, Bingo? Battleship? any other Ideas?

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.

Commands
These commands are available for moderators and broadcasters only, there are no commands for general users in this App. Note that you can also type "/goalshelp" within the chat to see the list of commands as well.

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 are not kept 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.
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).

/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 these are only temporary changes made within the session so you don't have to restart the App, 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 between the current goal and the next goal.

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

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

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

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

Latest enhancements and fixes:
2/19/2019 Initial Release (1.0):
- Original release of Dorothy's Tip Goals, same features as used in Dorothy's UltraApp