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 everyone!
Note: Current version: 1.4 Release 05/22/2019 - The Change Log of fixes and enhancements in each release is at the bottom of the page.

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.

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 - Tip goals, multi-goal, goal counter, tip jar, tip sequences, and ticket show, all in one place!
Link for Ultra Gamebot: Dorothy's Ultra Gamebot - This bot...

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

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

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

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. /kp: (all users) Display the available prizes (in random sequence) and the prizes already won in the Keno game, only shown to the user that requests it, unless requested by a moderator or broadcaster, then it is displayed to the room.


3. /kpbc: (bc only) Specific mode of displaying the keno board only available to broadcasters, which shows the location of each prize.


4. /kb: (all users) Display the keno board.


5. /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 all of the info, 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 info, instructions, 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. /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 instructions, commands, and randomly selected choice lists 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]: (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. /bi : (all users) Display the instructions, commands, and randomly selected choice lists for the Press Your Luck game. .


3. /bp [xx]: (bc/mods with privileges) Update the price for playing the game to a new value of [xx].


4. /bc : (all users) 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.


5. /bw : (all users) Display a listing of the last 20 results of people playing Who/What/Where and the prizes that the winners won. Can also show all results by using "/bw all".


6. /badfree: (bc/mods with privileges) 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: (bc/mods with privileges) Add a value to the list of people particiapting in the actions decided in the game.


8. /addwhat: (bc/mods with privileges) Add a value to the list of actions decided in the game.


9. /addwhere: (bc/mods with privileges) Add a value to the list of locations decided in the game.


10. /addhowlong: (bc/mods with privileges) Add a value to the list of durations decided in 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.

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


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


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


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


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


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


7. /mpl (or /masterprizelist): (mods/bc only) 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


8. /ap (or /addprize) [level.prize] [price] [description]: (mods/bc only) 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.


9. /cpp (or /chgprizeprice) [level.prize] [price]: (mods/bc only) 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).


10. /cpd (or /chgprizedesc) [level.prize] [description]: (mods/bc only) 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.


11. /gbstats : (mods/bc only) Display a listing of the Gamebot's time online, total tips toward games, and tips broken down by game.

Latest enhancements and fixes:

5/22/2019 Version 1.4 (Current Version):
- 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 Who/What/Where
- 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.