Dorothy's Gamebot

Short Description:

All in one game bot with dice, wheel spin, keno, russian roulette, war!, press your luck, and more to come!

Full Description

Welcome to Dorothy's Gamebot! This bot is available to everyone for public use.
Note: Current version: 1.18 Release 1/23/2020 - The Change Log of fixes and enhancements in each release is at the bottom of the page.
I also run a Twitter DM group for users of the Apps and Bots I've written, please message me on twitter and let me know if you'd like to be added to the group. In the group you'll receive notifications on new features, get tips and tricks, be able to provide feedback on them and request enhancements, and take part in discussions on how they can best be used.
And check out my bio for other useful tips and general info about CB and broadcasting, great for new cammers! https://www.freesexcam.ca/chelsea2950/

If using the Gamebot alongside Dorothy's Ultra Fembot or any other bot that alters the chat messages, it is recommended to make sure the Gamebot is in a lower slot that the Fembot (Fembot should be in Bot Slot 1 and Gamebot in Slot 2 or 3).
Each chat message is processed in order of Bot 3 then Bot 2 then Bot 1 then App 1. If the chat messages are altered before they reach the Gamebot, features such as the charades guess checking may not work if a user has a tip count, icon, nickname, etc displaying as part of their message.

Summary

Tired of setting up prizes over and over in all those game bots?
The purpose of this "Ultra" Gamebot is to provide several games in one place, and run them all from a common prizelist so you don't have to keep setting up prizes in each game separately.
A default prize list is also provided to help you set up for the first time faster, but keep in mind these are just suggestions, and mostly written from a couples show perspective, so please be sure to update the prizes to your own choices and prices.
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 generally 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 adding or changing prizes and prices, and the fanclub and VIP lists. Note that the fanclub and VIP lists must be entered within this bot in addition to the Fembot and UltraApp, as the bots and apps cannot see the each other's settings, so if you want to use the VIP and Fan Club discounts and free rolls/spins/etc, you'll need to add those lists here too.
I recommend keeping 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.

Commands and How to Play the Games

The Games featured in this bot are shown below, and followed by a detailed description of each with all of the available commands. Note that when the Gamebot is started, you'll configure which game or games you want to start immediately. You can turn on as many of the games at one time as you like, but that can also make the chat very busy, so it may be best to only use 1-2 at a time. If there are errors when attempting to start one of the games, usually due to prizes missing or not entered correctly, you'll see an error message in blue, and that must be fixed to start the game
In general, with all of the prize list levels, you can turn off a prize by setting the price to 0. If you leave a prize description blank, it may default back to the original value from the default list, so if there's a prize you don't want, you can set the description to anything you want ('.', 'Not used', etc), but set the price to 0, and that will keep it from being used in a game.
The prices are mainly there to group the prizes by level, most of the games only use the level for prize retrieval, but additional games may be added in the future that use specific prizes. Therefore, be sure not to use the same price twice.
A. Dice Game
B. Wheel Spin
C. Russian Roulette
D. Keno
E. War! Card Game
F. Press Your Luck
G. Random Prize Generator
H. Bad Libs
I. Charades / Pictionary
J. Twenty Questions

The Gamebot allows assignment of "Bot Moderators" that have same privileges as CB assigned moderators within the bot, 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. Dice Game

The Dice Game allows viewers to tip a specified amount to roll a pair of 6-sided dice, and win one of 11 possible prizes based on the outcome of the roll (rolls of 2-12), plus 1 special rare roll of 13. Viewers must either tip the exact amount of the Dice Roll price that is configured, or there is also a setting to define if a viewer can tip for multiple rolls with a single tip by tipping a multiple of the single roll amount, and what the maximum multiple is.
Any slots not filled in will yield no prize if that amount is rolled.
There are two modes, you can either keep all prizes intact or have prizes removed from the board as they are won. Removing the prizes from the board is not a commonly used mode as it reduces the chances of winning a prize with each roll, which discourages people from playing.
There are settings for giving Mods, Fans, and VIPs each a discounted dice roll price, as well as a number of free rolls - either or both can be used.
There are three color settings pairs available, one for the notice background and text, one for the regular roll result background and text, and one for the special 'Rare' prize result background and text.

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


2. /di: (all users) Display the 'dice info' panel, which contains the instructions and command list for the Dice game.


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


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


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


6. /freeroll: (users granted privilege) CB fan club, external fan club, VIP list, and moderators can be granted a number of free rolls by the broadcaster, and this is the command they enter to use one of their rolls.

B. Wheel Spin

The Wheel Spin Game allows viewers to tip a specified amount to spin a wheel, and win one of 20 possible prizes based on the outcome of the roll, plus 3 rare prizes. Viewers must either tip the exact amount of the Wheel Spin price that is configured, or there is also a setting to define if a viewer can tip for multiple spins with a single tip by tipping a multiple of the single spin amount, and what the maximum multiple is.
Any slots not filled in will yield no prize if the spin results in that slot, but it is preferable to put a prize in every slot, even if some are just a 'hello' or 'thank you'.
There are settings for giving Mods, Fans, and VIPs each a discounted wheel spin price, as well as a number of free spins - either or both can be used.
There are three color settings pairs available, one for the notice background and text, one for the regular spin result background and text, and one for the special 'Rare' spin result background and text.

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


2. /whi: (all users) Display the 'wheel info' panel, which contains the instructions and command list for the Wheel Spin game.


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


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


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


6. /freespin: (users granted privilege) CB fan club, external fan club, VIP list, and moderators can be granted a number of free rolls by the broadcaster, and this is the command they enter to use one of their spins.

C. Russian Roulette

This is a game of chance to try to win a single prize (usually a valuable prize) using the Russian Roulette method of firing a gun without knowing if a bullet is in the chamber being used. The "gun" is expanded to up to 100 "chambers" (or chances to win) and the tipper fires the gun upon tipping. and they 'win' if the chamber with the bullet is randomly selected by the game. Most commonly this is used to have people tip for a chance at a high dollar prize such as premium snap access.
Viewers must tip the exact amount of the 'Price per Shot' that is configured, or a multiple of it. You can also set the number of rounds that will be played. A common config
A starting point for how to determine the 'Price per shot' is that it should be roughly equal to 2x the prize's value divided by the number of "chambers" you plan to use, or a little higher. For example, if you chose a prize with a normal value of 500 tokens, and used 20 "chambers", on average, someone would win each time by approximately "chamber" 10, or halfway through the range So if the prize is valued at 500 tokens, then 500/10 = 50 tokens per fire would be a break even point, so then maybe go slightly higher at 60. Then if they fire 10 times before winning, you make 600 tokens, which would be more than the amount of the prize value. However, sometimes it will happen before 10 fires, sometimes after - it's a game of chance!
There are two modes, you can either give every shot exactly the same odds, or you can use up 'chambers' in the gun with each shot until you eventually get to the prize.
- With the first mode, every shot has exactly the same odds, and you have no guarantee that the prize will be won within the defined maximum number of shots per round.
- With the second mode, you use up the chambers until the bullet is found... you can use the /chambers command under this mode to see the remaining chambers and the location of the bullet.
There are three color settings pairs available, one for the notice background and text, one for the unsuccessful shot result background and text, and one for the winning shot result background and text.

1. /rr [on/off]: (mods/bc only) Toggle the setting for whether the Russian Roulette Game is "on" or "off". Overrides the initial setting to turn the game on or off during the show.


2. /rri: (all users) Display the 'Russian Roulette info' panel, which contains the instructions and command list for the Russian Roulette game.


3. /rrs (or /shooters): (mods/bc only) Display a listing of all of the users who have taken a shot in the current game.


4. /rrp (or /rrprice) [amt]: (mods/bc only) Change the price of a shot within the show, where [amt] is the new amount to use.


5. /chambers: (bc only) only valid when using the chambers as shots are fired, displays the remaining chambers and the location of the bullet.

D. Keno

The Keno Game allows viewers to tip specified amounts to clear numbers off a board. The board is configurable for the number range that will used, and how many prizes will be used.
Viewers must tip the exact amount of one of the numbers on the board, and when they do, they win the prize behind that number, if there is one. If group tipping is turned on, any tips against a number not on the board, or already cleared from the board will count against the highest number on the board until it is used up and that prize is won.
You can specify a list of numbers that you don't want to display in the Keno Board, such as if they are tip amount from the menu or a ticket price, etc.

1. /keno [on/off]: (mods/bc only) Toggle the setting for whether the Keno Game is "on" or "off". Overrides the initial setting to turn the game on or off during the show.


2. /ki: (all users) Display the 'keno info' panel, which contains commands and instructions for playing keno, as well as stats about the current game.


3. /kp: (all users) Display both the available prizes (in random sequence) and the prizes already won (in order) in the Keno game. Only shown to the user that requests it.


4. /kpa: (mods/bc only) Functions like /kp but will display the full prize list of remaining prizes and prizes won to the whole chat.';
   
5. /kpw [xx]: (all users) Display only the prizes already won in the Keno game. The [xx] parameter is optional and can be entered to limit the number of recent winners displayed. For example, "/kpw 10" would display the last 10 winners. The list is only shown to the user that requests it.


6. /kpwa [xx]: (mods/bc only) Functions like "/kpw" but will display the list of recent winners to the whole chat. As with the "/kpw" command, a number of recent prizes to display can be entered as a parameter.';
   
7. /kpbc: (bc only) Specific mode of displaying the keno board only available to broadcasters, which shows the location of each prize.


8. /kb (or kenoboard): (all users) Display the keno board.


9. /freekeno [number from board]: (users granted privilege) CB fan club, external fan club, VIP list, and moderators can be granted a number of number gueses by the broadcaster, and this is the command they enter to use one of their guesses, with the board number specified as the parameter.

For reference, here are the total number of tips that would be needed to clear the board for some common keno number 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. War! Card Game

The game of War! is like the classic card game of the same name. It allows viewers to tip to challenge the dealer to a game of war, under one of five possible prize levels.
- The user is then dealt a card, and the broadcaster can either be configured to automatically be dealt a card or use the "/wardraw" command to draw a card.
- If the viewer has a higher card, they win the war and the prize.
- If the broadcaster has a higher card, they win the war and the user does not win a prize.
- If they tie, they war again to draw more cards to see who wins. The user enters the command "/war" to start the next round and war again, and the broadcaster responds again automatically or with "/wardraw".
- Note that aces are high in this game (not a 1).
Since there is a time passage while the round is being played, and there is only one deck of cards to be used at a time, and wanting to give everyone a fresh deck when they start, only person can play at a time.
Therefore, anyone who tips while the game is being played will go into a queue of 'next players', and their games will start automatically when the one in front of them finishes.
For each prize, you can either specify the exact prize number using the "level.prize" format, or you can specify a level, and each win willl result in a random prize from that level.

1. /wargame [on/off]: (mods/bc only) Toggle the setting for whether the War! Card Game is "on" or "off". Overrides the initial setting to turn the game on or off during the show. Turning the game off will end any game in progress, suspend the display of the notice, and tips will no longer start a game.


2. /wi (or /warinfo): (all users) Display the 'war info' panel, which contains the commands and instructions for playing War!


3. /wd (or /wardraw): (bc only) Once a user has challenged the broadcaster to a game, if not configured for auto-broadcaster play, the broadcaster uses this command to draw their card.


4. /wp (or /warprizes): (all users) Display the available prizes in the War! Card Game by challenge level, only shown to the user that requests it, unless requested by a moderator or broadcaster, then it is displayed to the room.


5. /wl (or /warlist): (all users) Display a listing of the people who have tipped to play the War! Card Game and are currently waiting to play.


6. /war (or /waragain): (players) If there was a tie between the broadcaster and viewer cards, the viewer can use this command to War! again and draw their next card.


7. /stopwar: (users granted privilege) CB fan club, external fan club, VIP list, and moderators can be granted a number of free rolls by the broadcaster.


8. /ww (or /warwinners): (all users) Display a listing of the last 20 results of people playing war and the prizes that the winners won. Can also show all results by using "/ww all".


9. /wf [1-5] (or /warfree): (mods/bc with privileges) Perform a free draw for the level specified as if a user had tipped, such as "/wf 3" to draw for level 3. Helpful if a person tips the wrong amount, or doing a demonstration.

F. Press Your Luck

The "Press Your Luck" game allows viewers to tip a specified amount to draw a playing card, trying to draw the current type of prize card. The broadcaster can set the prize type at the beginning of the show or change it later through the command noted below. There are varying prize types, each with certain percentages of winning based on how many of that type of card are in a standard deck of cards (black/red, specific suit, face cards, number cards, etc).
If the player draws a card for the selected prize type, they win the first level prize. They can either choose to keep that prize or return it and draw again for a next level prize. If they keep drawing the selected prize group, they keep winning prizes from escalating prize levels.
For each prize, you can either specify the exact prize number using the "level.prize" format, or you can specify a level, and each win willl result in a random prize from that level.
The odds of winning each prize type are noted in the drop down selection, but note that those percentages are only for the first draw. The percentage drops by roughly 2% with each winning draw since the drawn card is removed from the deck.
Also, there are up to eight prize levels. If you were playing a simple red or balack card prize type, the odds of winning round 1 are 2-1 (50%), the odds of winning rounds 1 and 2 are 4-1, or roughly 25%, the odds of winning rounds 1 thru 3 are 8-1, or roughly 12%, the odds of winning rounds 1 thru 4 are 16-1 or roughly 6%... and so on. So keep these odds in mind when setting your price and prizes. I've set a default configuraion for 9 tokens per draw, thinking that winning round 1 would be a prize worth roughly 18 tokens, rounds 1 and 2 would be worth roughly 36 tokens, rounds 1 thru 3 would be worth roughly 72 tokens, rounds 1 thru 4 would be worth roughly 144 tokens, and so on.
Since there is a time passage while the round is being played, and there is only one deck of cards to be used at a time, and wanting to give everyone a fresh deck when they start, only person can play at a time.
Therefore, anyone who tips while the game is being played will go into a queue of 'next players', and their games will start automatically when the one in front of them finishes.

1. /press [on/off]: (mods/bc only) Toggle the setting for whether the Press Your Luck Game is "on" or "off". Overrides the initial setting to turn the game on or off during the show. Turning the game off will end any game in progress, suspend the display of the notice, and tips will no longer draw a card.


2. /pi : (all users) Display the 'Press info' panel, which contains instructions, commands, and prices for the Press Your Luck game. Reduced the amount of info in the recurring notice and put it here on-demand.


3. /pp (or /pressprizes): (all users) Display the available prizes in each round in the Press Your Luck Game, only shown to the user that requests it, unless requested by a moderator or broadcaster, then it is displayed to the room.


4. /pl (or /presslist): (all users) Display a listing of the people who have tipped to play the Press Your Luck game and are currently waiting to play.


5. /stoppress: (players and BC/mods with privileges) Used by the player to stop at a certain level and keep their prize, or by the mod or broadcaster to end the current game if the person who was playing has left or is not responding, so that the next person can play. This will start a new game for the next person in line if anyone was waiting.


6. /pw (or /presswinners): (all users) Display a listing of the last 20 results of people playing Press Your Luck and the prizes that the winners won. Can also show all results by using "/pw all".


7. /pf (or /pressfree): (bc/mods with privileges) Perform a free drawing in the Press your Luck game as if a user had tipped. Helpful if a person tips the wrong amount, or doing a demonstration.


8. /pressprice [amt]: (mods/bc only) Change the price of the Press Your Luck game within the show, where [amt] is the new amount to use.


9. /pt [1-10] (or /presstype): (bc/mods with privileges) Change the winning card type for Press Your Luck to a new value on the fly without restarting the bot, example format is "/pt 5" to change to card type "5". Note there are significant differences in the win percentages for the different card types, so changing just the type without changing the price or prize level may make the prize levels a really good bargain or not worth playing. Card types that go along with the numeric values are below. Note that the approximate percentages are for the first draw only, after a successful draw, the percentage drops by roughly 2% each time.
   1 = Red Card (50%)
   2 = Black Card (50%)
   3 = Hearts (25%)
   4 = Diamonds (25%)
   5 = Clubs (25%)
   6 = Spades (25%)
   7 = Number Cards 2-10 (69%)
   8 = Face Cards and Aces (31%)
   9 = Aces (8%)
   10 = Queen of Hearts (2%)
   

G. Random Prize Game

The Random Prize game allows the broadcaster to define up to 3 tip thresholds with unique prize choices, and percentages for which tippers will randomly be granted a prize.
For example, they may say that threshold 1 is from 5 to 50 tokens (set threshold 2 to 50), and the percentage at 5%, and a random prize from master prize level 2.
The 5% odds, means that approximately 1 in 20 tips of between 5 and 50 tokens will win a random prize from the master prize list level 2 choices.

1. /random [on/off]: (bc/mods with privileges) Toggle the setting for whether the game is "on" or "off". Overrides the initial setting to turn the game on or off during the show.


2. /ri : (all users) Display the 'Random info' panel, which contains instructions and commands for the Random Prize game.


3. /rw : (all users) Display a listing of the last 20 random prize winners. Can also show all results by using "/rp all".


4. /randomfree (or /wwwfree): (bc/mods with privileges) Perform a free random prize selection. Helpful if a doing a demonstration. Selection type is always random from a level, and the level is specified as the parameter.

H. "Bad Libs" Game

The "Bad Libs" game is in the spirit of the classic "Mad Libs" and allows viewers to tip a specified amount to have a sentence constructed of 4 randomly chosen pieces from lists of who, what, where, and for how long.

1. /badlibs [on/off]: Toggle the setting for whether the game is "on" or "off". Overrides the initial setting to turn the game on or off during the show.


2. /bli : Display the 'Bad Libs info' panel, which contains instructions and commands for the Bad Libs game.


3. /blc : Display the available choices for each of the four categories of who, what, where, and for how long. Only shown to the user that requests it, unless requested by a moderator or broadcaster, then it is displayed to the room.


4. /blw : Display a listing of the last 20 results of people playing Bad Libs and the prizes that the winners won. Can also show all results by using "/bw all".


5. /badprice [xx]: Update the price for playing the game to a new value of [xx].


6. /badfree: Perform a free Bad Libs game as if a user had tipped. Helpful if a person tips the wrong amount, or doing a demonstration.


7. /addwho: Add a value to the list of people particiapting in the actions decided in the game.


8. /addwhat: Add a value to the list of actions decided in the game.


9. /addwhere: Add a value to the list of locations decided in the game.


10. /addhowlong: Add a value to the list of durations decided in the game.

I. Charades / Pictionary Game

Charades is a game where one person acts out a word or phrase with talking, and the other players try to guess what they are acting out before time runs out.
This game was originally built as Charades, but you can also use this game for other formats, such as a Pictionary format, where the broadcaster draws the answer instead of acting them out. Everything within the bot remains the same, and the only difference is what the broadcaster is doing to act out or draw the answer.
There is a setting on the launch page that defines which game you are playing, but the bot behaves the same for both, the only difference is the text on the screen wither showing "Charades" or "Pictionary". All of the commands still use a "ch" prefix from the initial creation as Charades.
Within this bot, when each game is started, the broadcaster is shown the word or phrase and a timer is started while they begin acting it out, and everyone can try to guess by typing in their guesses in the chat while the bot monitors for the correct answer.
Charades has several types of 'signals' that people who play have learned that help the actor tell the audience things like how many words are in the answer, whether it's a movie, person, place, etc. You can find some ideas on signals you can do to tell the audience what kind of word or phrase you are doing here: http://www.outsetmedia.com/charadessigna ls

The Charades Game has three modes
- Mode 1 - Broadcaster against Broadcaster - In this mode, two or more broadcasters in the same room (usually a couples show or just multiple performers), compete against each other to get to the configured number of total points first.
Each game can be initiated by the broadcaster or can be tipped for if a price is specified under mode 1.
- Mode 2 - Viewer against the room (1 game) - In this mode, the viewer who tips tries to win a prize by being the first one to guess the word/phrase. If they guess correctly before anyone else in the room, they win the prize, otherwise there is no win.
- Mode 3 - Viewer against the room (goal race) - This mode is similar to the above, except that the it keeps track of the winner's scores and awards a grand prize for the firs viewer to a configured point total.
When a viewer wins a gme from their own tip, they get 3 points, otherwise other guessers get 1 point.
This 'scoreboard version' is helpful because it incents each person to try, and not just let the tipper win and get a prize that everyone gets benefit from.

The wordlist can either be entered by the broadcaster on the launch page, or you can use the default list from the Gamebot, or you can add the words manually for each game as you go or at any time while the Charades game is enabled. Moderators can also enter words for you, but then they cannot guess if this is enabled, you define if moderators participate in the word selection or do not know the word and are eligible to guess like the rest of the audience.
I try to rotate new words in periodically, but people will eventually learn the words or you'll see repeats, so adding your own list is preferable, especially after you start seeing the same words again
Even if the user entered list or default list is used as a starting point, you can still add words to the list with the /chword command, and clear the list with the /chclearlist command.
There is also the /chsave command that displays the current word list at the end of a show so you can copy it and then paste it back into the Broadcaster Defined list on the launch page so that you keep track of your progress and don't keep getting the same words repeated.
There is a setting to go in the order of the entries or draw a word at random - random is preferred unless entering them as you go and wanting to follow a certain order.
Once the broadcaster starts a game, all viewers in the room can attempt to guess the word/phrase. The gamebot will monitor for the correct answer and announce the winner and stop the timer when a correct guess is made. Note that the answer must be spelled correctly, but case does not matter. The length of the timer is configurable on the launch page.
As with War! and Press Your Luck, if a game is already started when someone tips, the new tipper's name will go into the queue of next players. As each game is finished, the next player in the queue automatically starts the next game.

1. /charades [on/off]: Toggle the setting for whether the game is "on" or "off". Overrides the initial setting to turn the game on or off during the show. Note that wordlist is kept intact if turning the game on or off without restarting the Gamebot. The list can be cleaed with the /chclearlist command.


2. /chi : display the Charades Info (help) text for the game in the chat.


3. /chh : see the history of the Charades games that have been played so far this session.


4. /chq : see the list of people who have tipped to play charades and are currently in line waiting to play.


5. /chscoreboard (or /chsb) : display the current score in the charades game. When requested by mod or broadcaster, goes to entire room. When requested by other viewer, goes to individual.


6. /chprice [xx] : Update the price for playing Charades to the new value of [xx] tokens.


7. /chwin [username] : Manually assign a correct guess to someone who may have come close but misspelled the word. The game will behave as if the user specified had guessed correctly.


8. /chfree : Initiate a free game to play the next turn or round, or to override the tip requirement and play a round for free as if someone had tipped.


9. /chplay : Start the current game. After a game has been initiated by a tip or the /chfree command, this command shows the word to the broadcaster and starts the timer.


10. /chword [word/phrase] : Add words and phrases to the word list used for the game.
    This can be done in any play mode at any time, and will only add to the existing list.
    You can add multiple words separated by a colon ":".
    If the word list source is configured as "Added During Game", the list will be empty to start and must be added before a game can be played.
    Otherwise, it will be populated from the default list or the broadcaster defined list on the launch page (and you can still add to the list in either case).
    NOTE: Try not to use words that are hard to spell or long phrases, the spelling must match exactly (but is not case sensitive).


11. /chrmv [word/phrase] : Removes words and phrases from the word list used for the game, regardless of whether added manually or from the startup list.


12. /chsave : Display the current remaining word list in a form that can be copied and pasted into the Broadcaster Managed word list upon restart of the Gamebot to save your remaining words.


13. /chskip : Skip a word/phrase if you do not know what it is. Skipping a word will reset the timer, and you must use /chplay to start again after word selection.


14. /chend : End the current game if you decide not to finish it. Does not end the Charades game feature, just the current game/word being guessed, and will be ready for the next game. If a game has been tipped for in the queue it will be started.


15. /chstoptimer : End the timer for the current game, but guessing can continue.


16. /chclearlist : Clear the wordlist. The wordlist is kept intact if the game is ended and restarted without restarting the Gamebot.


17. /chlength : Update the length of the timer for each game. Valid values are .5, 1, 1.5, 2, 3, 4, and 5.


18. /chfixscore : Adjust scores in modes 1 and 3 as needed (such as if someone guesses and it's not an exact match).

J. 20 Questions Game

The 20 Questions game is the same as the classic game that you probably played with your family on long car rides. The Broadcaster will choose a word (using the "tword" command) and that starts each round.
The defaut is for a 20 question game, but you can update the setting to use more or less guesses, however it is recommended to use 20 questions unless you are using really hard or really easy words.
Once a round is started, the viewers try to figure out the word by tipping to ask "Yes" or "No" questions about the word that the broadcaster will answer. The question is asked in the tip note, and only questions in the tip notes should get a response.
For each tip, the viewer can either ask a question to narrow it down, or if they think they know what it is, they can actually guess the word. Guesses also count as one of the questions though.
The bot will analyze all tip notes and check to see if the chosen word is in the text. If it is, the game is ended and the prize awarded, else the game continues.
A game is not automaticaly ended after the last guess in case someone guesses and it is not an exact match, so the /twentyend command must be used to close out the game before a new one can be started.
The prize can either be specifically stated or you can use a prize from the master prize list.

There are two modes of playing in this game:
- All Play - The entire room is playing and anyone can tip to make the next guess
When a user tips to guess, their tip note is displayed for the entire room (only for tips equal to the tip amount for playing the game)
Regardless of who asks questions or makes a guess, the whole room can only ask the configured total number of questions
- Individual Play - It's everyone for themselves and the first person to figure out the word wins the prize
In this mode, only the broadcaster (and mods if configured) will see the tip note question and answer back to each specific person as they ask
The bot will track each user's guesses and not let them guess anymore once they exceed 20 (or the configured number) but the game will go on as others attempt to guess and ask questions

The broadcaster should choose prizes based on the mode of game play, for example, for All Play, the prize is for the whole room, so it wouldn't be something like Snapchat, it would be a general prize to perform for the room. For individual play, it would be something awarded to the individual winner more than the room.

1. /twenty [on/off]: Toggle the setting for whether the game is "on" or "off". Overrides the initial setting to turn the game on or off during the show.


2. /tqi : display the Twenty Questions Info (help) text for the game in the chat.


3. /tqh : see the history of the Questions that have been asked so far. For All Play, you can see all past questions for the room. For individual play, you can only see your own questions. Broadcasters and mods can send the list to 'all' in the All Play mode


4. /tqa [XX] [yes/no]: Update the answer to question number [XX], only in "All Play" mode to Yes or No (so that new viewers to the room can see what the answer was).


5. /tprize : Change the Prize that will be awarded to the winner.


6. /twentyprice [XX] : Update the price for playing (asking a question) to the new value of [XX] tokens.


7. /twentywin [username] : Manually assign a correct guess to someone who may have come close but misspelled the word. The game will end with the assigned person as the winner as if they had guessed correctly.


8. /tword [word] : Choose the word for the current game, which will start a new round.


9. /twentymode [all/single] : Change the game mode to be either 'all' for All Play or 'single' for Individual Play.


10. /twentyend : End the current round of 20 Questions. It is not automaticaly ended after the last guess in case someone guesses and it is not an exact match, so the /twentyend command must be used to close out the game.

General commands and features across all games

The first three commands below are relative to the external fan club. They allow for updating the list of users that will have special access from purchasing a Fan Club membership on an external site such as FanCentro, justfor.fans, etc.
The next three commands are relative to the VIP list, which is similar in usage to the external fan club, but usually used more for users who are good friends or high tippers that you want to grant special privileges to.
For both of these lists, the initial list is set on the bot launch page, but can updated during a show using the below commands. Adding a user to one of the lists may give configurable privileges in some of the games as noted (free rolls, free spins, etc). Users can be added and removed within a session, but a master list should be maintained and updated on the bot's configuration page so it is saved (updates made within the session are not permanent). The lists should also be saved externally in case the configuration page is ever reset. Only broadcasters have the ability to maintain the lists.
The last four commands are relative to viewing and updating the master prize list from within the show. Usually if you're going to be doing a lot of editing, it is better to restart the bot and edit the settings on the launch page, both because of ease of use, as well as the fact these settings changed during the show are not saved.
Also note that depending on the game, the prize list may have already been loaded into the game, so the change may not take effect unless you disable and re-enable that game using the "on/off" commands. Generally, any specific prize ID callouts will take effect immediately, but prize level settings typically load the prizes for a level into the game only when that game is started.

Commands for Broadcasters only:

1. /addfan [user]: Adds a user to the Gamebot External Fan Club list where [user] is the person you want to add.


2. /rmvfan [user]: Removes a user from the Gamebot External Fan Club List where [user] is the person you want to remove.


3. /addvip [user]: Adds a user to the Gamebot VIP list where [user] is the person you want to add.


4. /rmvvip [user]: Removes a user from the Gamebot VIP List where [user] is the person you want to remove.


5. /addmod [user]: Adds a user to the Gamebot "BotMod" Moderator List where [user] is the person you want to add. BotMods are given the same authority as CB assigned moderators but not given a red name in the chat.


6. /rmvmod [user]: Removes a user from the Gamebot "BotMod" Moderator List where [user] is the person you want to remove.

Commands for Broadcasters (and moderators with sufficient authority):

7. /fanlist: Displays the list of users currently in the Gamebot External Fan Club List.


8. /viplist: Displays the list of users currently in the Gamebot VIP List.


9. /modlist: Displays the list of users currently in the Gamebot Moderator List.


10. /mpl (or /masterprizelist): Displays the master list of all prizes by level. If the parameter is entered for a level, only display that level, otherwise if level is 0 or not entered, will display all levels. The list is only sent to the person requesting, this command is not available to the general room, only mods (if granted authority) and broadcaster


11. /ap (or /addprize) [level.prize] [price] [description]: Add or change a prize on the master prize list. Note that all parameters must be entered when using the 'add', and if a prize already exists in the position specified, it will be overwritten. The "level.prize" indicates the level and prize number that are to be added/changed, [price] indicates the price (a value of '0' disables the prize), and is followed by the text description of the prize.


12. /cpp (or /chgprizeprice) [level.prize] [price]: Change a prize's price on the master prize list. The "level.prize" indicates the level and prize number for which the price will be changed, and is followed by the new price of the prize (a value of '0' disables the prize).


13. /cpd (or /chgprizedesc) [level.prize] [description]: Change a prize's description on the master prize list. The "level.prize" indicates the level and prize number for which the description will be changed, and is followed by the new text description of the prize.


14. /gbstats : Display a listing of the Gamebot's time online, total tips toward games, and tips broken down by game.

Latest enhancements and fixes:

1/23/2020 Version 1.18 (Current version):
- Fix issue with Wheel Spin giving an error for multiple spins allowed

1/3/2020 Version 1.17:
- Fix issue with Charades/Pictionary Mode 2 giving an error when setting to select a prize from a prize level

12/29/2019 Version 1.16:
- Fix issue with overlapping variable and function names for wheelspin rare percentage

11/29/2019 Version 1.15:
- Fix issue with free wheel spin and free dice rolls for mods, fans, VIPs
- Fix issue with discounted wheel spin and dice rolls for mods
- Fix dice gifs that have been deleted on CB
- Added the new game "20 Questions"! Can play in All Play mode or Individual Mode. See description page or use the /tqi command to see more info on the game.
- Also started putting in the same 'minimum chat messages for notice' feature from the Fembot, added for the new 20 questions game, built framework for the remaining games that will have their notice posting updated later.

10/12/2019 Version 1.14:
- Added Keno command /kpw to only show the prizes won so far. Command also has a parameter to show the most recent X number of prixes won.
- Added numbering of the Keno prizes won so easier to keep track of progress with performing prizes
- Added Keno commands /kpa and /kpwa to send the prize list or prizes won list to the entire chat. Previously for mods and broadcasters this always happened, now they can also have it sent only to them with the /kp and /kpw commands. The /kpa and /kpwa are only available to mods and BC.
- Added a setting in the General Setup section for the name the broadcaster would like displayed in the chat notices instead of the general text "broadcaster" or the room name

9/28/2019 Version 1.13:
- Added ability to add multiple words to the Charades list using the /chword command, with a colon ":" as a separator in the list
- Added /chsave command to display the current remaining list in a form that can be copied and pasted into the Broadcaster Managed word list upon the next restart of the Gamebot, so you can save your progress in the list

9/26/2019 Version 1.12:
- Added link to site for charades info and signals
- Added more default charades words
- Corrected issue where /chfixscore was incrementing game count in charades mode 3
- Added setting to have the text for the notices related to the charades game be displayed as "Charades" or "Pictionary" - both types of games can be run through the same game format in the bot. This setting only affects the text in the notices.

9/12/2019 Version 1.11:
- Added setting to control if tips for Keno skipped numbers (for tip menu items usually) are included in group tipping

9/7/2019 Version 1.10:
- Added command /chrmv to remove a charades word from the list
- Suppress special characters in charades answers and account for additional/missing spaces when comparing to charades word
- Added notice for when badlibs is turned off
- Keep individual scores for BAB Charades mode as well

9/1/2019 Version 1.9:
- Fixed Charades issue with /chskip command - was advancing user twice in BAB mode 1
- Display the correct guess for charades if time runs out

8/6/2019 Version 1.8:
- Fixed all user entered user name lists (VIP List, Fan Club, Mod List) to update with lowercase to match CB conventions
- Added list of numbers to exclude from the Keno Board, configured in field on launch page

7/16/2019 Version 1.7:
- Fixed issue with score updates in Charades BAB mode
- Added /chfixscore command for charades to adjust scores as needed
- Added more details on prizes to the charades notice and the additional info see with the /chi command
- Added BotMod feature, given same authority as CB assigned moderators
- Changed gifs for war game notice and structure of war game tip menu so it takes up less room

6/22/2019 Version 1.6:
- Fixed issue with keno not displaying top tipper at board complete correctly
- Stop displaying the keno board notice once the board is complete
- Give warning if trying to end the charades, war, or PYL games when there is an active game outstanding
- Added comments at the top of this description page regarding the bot slot sequence for the Gamebot vs other bots
- Charades tweaks:
--- sort the mode 3 scoreboard in order of scores
--- added a command /chlength for updating the timer length during the show
--- added a command /chscore to display the score for mode 1 and 3
--- functions added to the Dorothy's Ultra Fembot to suppress tip count and icons while playing charades so they don't interfere with people guessing

6/09/2019 Version 1.5:
- Added Charades!

5/22/2019 Version 1.4:
- Automatically perform "/stoppress" or the dealer draw in war if they have not bee performed after 2 reminders (approx 5-6 min) so that games are not forgotten and other players get stuck in the queue behind them
- Skip the entries with a blank ID when adding prizes to the war game (previously only skipped zero amount prizes)
- Added new game 'Bad Libs'!
- Added Random Prize game!

4/16/2019 Version 1.3:
- Added /gbstats command to view time online and tipping stats for the Gamebot's current session
- Added help command for /gbhelp
- Trimmed down recurring notices for each game and added more details to a 'more info' command for each game (/di, whi, /rri, /ki, /pi, /wi)
- Added a reminder notice for Press Your Luck and War! when there is an outstanding game waiting on the player or broadcaster.
- Fixed an issue with keno notice showing rapidly

4/6/2019 Version 1.2:
- Fix issue with card array not being reset for each game in Press Your Luck

4/2/2019 Version 1.1:
- Move some of the instructional info for War and Press your Luck to be displayed on-demand rather than in every notice (added /wi and /pi commands)
- Add free plays for War and Press Your Luck (added /wf and /pf commands)
- Add command to change the Press Your Luck winning card type on the fly (added /pt command)

3/28/2019 Initial Release, Version 1.0:
- Original release with Dice Game, Wheel Spin, Roulette, Keno, War!, Press Your Luck

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.

Other 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 - All in One app that contains several different types of goal shows (single goal, multiple goals, auto-reset goals, goal counter, goal race, tip sequence, tip jar), plus a full feature ticket show and peep show
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 Easy Ticket Show: Dorothy's Easy Ticket Show - Same features as the stand alone ticket show, but with a very short launch page setup (4 settings), all other settings use most common defaults.
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 Gamebot: Dorothy's Ultra Gamebot - This bot...
Link for Tip Menu Pro: Dorothy's Tip Menu Pro - Ultimate Tip Menu with 2 menus that can be swapped based on type of show (Menu 1 with 50 slots, Menu 2 with 20), plus a positions menu that can be run simultaneously
*** Note that the dice game in the Fembot will be phased out since it is now available here and in it's own stand alone bot. ***