Skip to content

Script Documentation

Blasman edited this page Aug 7, 2017 · 32 revisions

Required Scripts

BlasBot.mrc
Required script for most of the other scripts to work. You will have to input some info upon loading the script. If you change any of this info or enter it incorrectly, please read the info in the script on how to reset it. Other required scripts can be found in the README.md instructions. This script also contains the "!games on" and "!games off" commands to enable and disable any of the other games scripts on this GitHub that you have loaded in mIRC.

Jump to Script Sections:

!jackpot - Jackpot Version 2.1 game
!slot - Slots Version 2.0 game
!payactive - PayActive Command
!raid - Raid Companion
!jackbox - Jackbox Party Pack Helper
!autohost - Advanced Autohost Version 2
!scram - Word Scramble game
!rps - Rock Paper Scissors game
!rbet - Casino Roulette game
!blackjack - Blackjack game
!rr - Russian Roulette game
!date - Twitch Followdate command
!hosts - List all channels hosting
!give - Give channel currency command
!shoutout - Shoutout command
!mm - Mario Maker Level ID script
Everything Else

Jackpot Version 2.1

jackpot.v2.mrc
Do not use in conjunction with Jackpot Classic.

IMPORTANT: Version 2.1 requires the updated BlasBot.mrc file (at least version 1.0.0.5). So please update your BlasBot.mrc before installing OR updating the new version of Jackpot!

!Jackpot Command Example

This is a new and much improved version of Jackpot Classic. You will be asked to enter all needed information in input boxes when you first load the script. You may use as many emotes as you want (at least two, obviously) for the reels. You may set the odds of winning the jackpot to any percentage that you want, regardless of the number of emotes used. You can now right click your status or channel window in mIRC and select the "!JackPot" context menu that appears and easily view and set the following: enable/disable !jackpot, emotes used, cost to play, user cooldown, new pot amount, odds of winning, current pot, all reels speeds, WHISPER mode, lever pull message, jackpot lose message, and optional winning sound effect.

Note: in order to actually HEAR the sound effect that you have set for a jackpot win, please make sure that sounds are enabled in mIRC (ALT-O > Sounds). I recommend disabling the sounds for EVERYTHING else (uncheck everything and change all the "On Event's" to "no sound").

What's added/different in Version 2.1 from Version 2.0:

Queue System: The !jackpot is now QUEUED when multiple users try to activate it at the same time. No more waiting for the last person to finish before you are able to type !jackpot to play.
Whisper Mode: Mods can enable "whisper mode" on and off. When it is enabled and users type !jackpot in the chat, your bot will whisper them the game instead of outputting to the main channel. If a user WINS the !jackpot, your bot will still display the winning hype message in the main channel. The queue system also works when this mode is enabled.
More Customization: Added even more options to the context menu that allow you to easily customize the speeds for each reel, as well as the messages that the bot uses for the "pull message" and when a user loses the !jackpot.
Stats Tracking: The !jackpot now keeps track of all users number of games played, how much channel currency they have spent, and their total winnings. The command is !myjackpot and may be disabled in the context menu if desired.

Jackpot Version 2 Context Menu Jackpot Version 2 Context Menu Jackpot Version 2 Context Menu Jackpot Version 2 Context Menu Jackpot Version 2 Context Menu

Command List:

!jackpot ::: plays the game.
!jackpot stats ::: this will tell you some basic stats of the jackpot... the current jackpot, the last winner, how much the last winner won, the total number of winners, and the total payouts.
!jackpot record ::: this will tell you who won the largest !jackpot ever and how much it was for.
!jackpot addicts ::: this will tell you who has played the !jackpot the most.
!jackpot winners ::: this will tell you who has won the most on !jackpot.
!jackpot netwinners ::: this will tell you who has won the most NET winnings on !jackpot.
!jackpot on ::: Mod Only. Turn the game on.
!jackpot off ::: Mod Only. Turn the game off.
!jackpot set # ::: Mod Only. Manually set the current jackpot to #.
!jackpot odds # ::: Mod Only. Change the odds of winning the !jackpot.
!jackpot whispers on ::: Mod Only. Turn on WHISPER mode.
!jackpot whispers off ::: Mod Only. Turn off WHISPER mode.
!jackpot bet # ::: Mod Only. Change the amount of channel currency that is spent on each play of !jackpot.
!jackpot cd # ::: Mod Only. Change the cooldown time for !jackpot.
!jackpot newpot # ::: Mod Only. Change the amount of channel currency that new !jackpot's will be set to after someone wins.
!jackpot emotes emote1 emote2 ::: Mod Only. Set the emotes that !jackpot uses by adding them to this command. (at least two required)
!myjackpot ::: Check your own individual !jackpot statistics. Mods may also use "!myjackpot username" to check another user. This command can be disabled in the context menu.

Slots Version 2.0

slots.v2.mrc
Do not use in conjunction with Slot Machine Classic.

IMPORTANT: Please be sure that you are using the LATEST BlasBot.mrc file from this GitHub, otherwise this game may not work.

!Slot Machine Example
!Slot Machine Example
!Slot Machine Example
!Slot Machine Example
!Slot Machine Example

This is a new and much improved version of Slot Machine Classic, although the reels and payouts are much different. You will be asked to enter most information in input boxes when you first load the script. You can right click your status or channel window in mIRC and select the "!Slot" context menu that appears and easily view and set the following: enable/disable !slot, emotes used, cost to play, user cooldown, house edge/odds of winning, all reels speeds, WHISPER mode, lever pull message, slot lose message, etc.

Game Details:

The game requires you to specify five emotes to be used. The user needs to match three emotes to win. The five emotes are worth 1x, 2x, 3x, 5x and 10x the users bet. The lower the payout multiplier, the higher the odds of receiving that multiplier during any given winning game.

The "houseedge" option needs some explanation as it can be confusing. The default value is "0" which means that the user will break even in the long term. At this value, the odds of getting a winning spin on the !slot is 42.67%. If set to "100" then the user will ALWAYS lose. If it is set to "-100" then the user will ALWAYS win. To give users a slight edge in their favor, you could choose a low negative value such as -10 or -20. To rob users of their currency slightly more often, you could say a low postive value such as 10 or 20. In my opinion, the game is much more enjoyable with a decent negative value such as -20.

With a "houseedge" of 0, the following are the odds of the outcome on any given slot game:
lose = 57.333%
1x win = 20%
2x win = 10%
3x win = 6.667%
5x win = 4%
10x win = 2%

I also have some basic FFZ emotes that may be used for the Slot Machine at http://www.frankerfacez.com/emoticons/user/blasman13 if desired. Note that these will not display correctly if using the WHISPER mode. I have removed the 50x version of the slots from the GitHub as it was too much effort to maintain updating two versions and I felt that the 10x version was more enjoyable for my viewers.

Command List:

You may also type !slots instead of !slot, as they will both do the same.
!slot # ::: plays the game and bets # amount of points on the slot machine. (example: !slot 100)
!slot ::: typed by itself will give info on how to play the game.
!slot on ::: Mod Only. Turn the game on.
!slot off ::: Mod Only. Turn the game off.
!slot houseedge # ::: Mod Only. Change the houseedge of the !slot.
!slot whispers on ::: Mod Only. Turn on WHISPER mode.
!slot whispers off ::: Mod Only. Turn off WHISPER mode.
!slot minbet # ::: Mod Only. Change the minimum amount of channel currency that is required to be wagered for a game of !slot.
!slot maxbet # ::: Mod Only. Change the maximum amount of channel currency that is required to be wagered for a game of !slot.
!slot cd # ::: Mod Only. Change the cooldown time for !slot.
!slot emotes emote1 emote2 ::: Mod Only. Set the emotes that !slot uses by adding them to this command.
!myslots ::: Check your own individual !slot statistics. Mods may also use "!myslot username" to check another user. This command can be disabled in the context menu.
!slot stats
!slot addicts
!slot winners
!slot netwinners

!PayActive Command

payactive.mrc

!PayActive Command Example 01 !PayActive Command Example 02

This script contains the !payactive command that is similar to AnkhBot's "!points add +viewers #" command, except that it will only give points to the users who have been ACTIVE in the last X seconds (see below) and are still in your channel's viewerlist. Just like with AnkhBot's "!points" command, users need to be an Editor in AnkhBot in order to be able to use this command.

Basic Usage:

!payactive # # ::: Initiates a payactive. The first # is the amount of channel currency. The second # is OPTIONAL and will be a timer that lets users know that they have # seconds to speak up in chat before the payactive will happen. Example: "!payactive 100" will instantly payout 100 points to all active users. Whereas "!payactive 100 60" will display a message saying that in one minute (60 seconds) everyone who has been chatting in the last X minutes (what you set the payactive time to) will receive 100 points.

!payactivex # # ::: Similar to !payactive, except that users will need to speak within the X amount of seconds specified as the second number. Therefore, both numbers are required.

Example: “!payactivex 100 120” will pay out 100 points to all users who have been active within the 120 seconds after the command is activated.

!payauto # # # # ::: This will set up AUTOMATIC !payactive’s. You may also use “!payautox” to have automatic !payactivex’s instead of !payactive’s.

!payauto [AMOUNT of currency] [TIMER OF !payactive] [HOW OFTEN the !payactive] [OPTIONAL: HOW MANY TIMES to keep repeating the !payactive]

Example: "!payauto 100 60 300" will perform an automatic "!payactive 100 60" every 300 seconds until manually stopped. Whereas "!payauto 100 60 300 5" will also perform a "!payactive 100 60" every 300 seconds, but will stop after 5 times.

You may type !payauto by itself. If a !payauto is active, it will display information on the current !payauto. If no !payauto is active, it will display information on how to properly use the !payauto command.

!payauto off ::: Disable an active !payauto or !payautox.

!paylimit # ::: Sets the MAX LIMIT for the !payactive amount of currency. This is useful for mods that may accidentally forget to add a space between the amount of currency and the timer. Example: Accidentally typing "!payactive 100600" instead of "!payactive 100 600" The default is set to 1000000. Type !paylimit without a number to check the current limit.

!set activetime # ::: Change the amount of time (in seconds) for a user to be considered ACTIVE in chat. The default is set to 900 seconds (15 minutes). If a user has said anything in chat in the last # seconds when the payactive happens, they will receive the channel currency.

Advanced Usage:

You may use time units for easier usage of !payactive/!payactivex’s and !payauto/!payautox’s.

Example: “!payactive 100 5m” is the same as !payactive 100 300

You may set “ranges” for any of the numbers in the payactive and payauto commands.

Example: “!payactive 100-200 5m-10m” will perform a !payactive that is a random number between 100-200 and a random time between 300 and 600 seconds.

Example: “!payauto 100 5m 1h-1.5h” will perform an automatic “!payactive 100 5m” every 60 to 90 minutes (a random time between 3600 and 5400 seconds).

Notes:

Only one type of !payauto can be activated at a time. Activating a !payauto or !payautox while one is active will overwrite the previous one. !payauto and !payautox share this rule together (only one can be active at a time).

Only one !payactive can be activated at a time. If a !payactive is activated while one is waiting for the timer to finish, the previous !payactive will be overwritten. !payactivex shares this same rule independently of !payactive. Therefore, you can have a !payactive and !payactivex active at the same time.

You may still perform !payactive/!payactivex commands while a !payauto or !payautox is active. They will not overwrite each other.

Raids

raids.mrc

Raids Script Example Raids Script Example Raids Script Example

This script is designed to help with Raiding other channels. After typing "!raid username" the script will post a link to the raid target as well as the message to copy and paste. Five seconds after typing "!raid username," your bot will automatically join the channel to raid (your bot never leaves your own channel though). Once YOU type the raid message into the channel that you are raiding (using your main Twitch account, not your bots, obviously), your bot will silently begin listening in on the channel that you are raiding. For the next 90 seconds, whoever types your raid message into that chat (or whatever text you specify to match), will be added to the "raider list." After the 90 seconds are over, your bot will automatically part the channel that you are raiding and begin paying everyone who raided with you a specified amount of channel currency. Raiders will only receive the payout ONCE, regardless of how many times they paste the raid message. A text file called "raid_history.txt" will be kept in your mIRC folder, it will keep a list of when you raided a channel, and who raided with you as well. There are many other commands, for a complete list of commands type !raidhelp in your channel.

Update (Feb 12, 2017):

Added a !topraiders command that will list the top 10 users who have raided with you. Type !raidtopcmd in channel to enable it.
Added a !raidforce [user] command that will FORCE a raid on a specific user. This is to bypass Twitch API checks to see if the user is valid and that the user is currently live before allowing a raid with the standard !raid [user] command.
Current raids.mrc script requires the latest version of BlasBot.mrc! Be sure that your BlasBot.mrc is version 1.0.0.5 or higher!

Jackbox Party Pack Helper

jackbox.mrc

Jackbox Party Pack Helper Example
Jackbox Party Pack Helper Example
Jackbox Party Pack Helper Example
Jackbox Party Pack Helper Example

This purpose of this script is to ease and automate the process of distributing the four character entry code for Jackbox Party Pack games. How it works is simple. The streamer or a moderator simply whispers the code to the bot using "!code XXXX" and then a message is displayed in chat saying that anyone that meets the requirements may simply request a code by typing "!code" in chat.

You may set ANY combination (including none) of the various requirements for users to be able to receive a code by typing !code. If they do not meet all of the requirements that you set, then they will be whispered a message saying that they do not meet the requirements.

Follower ::: Must be a follower of the channel. You may also set an optional amount of time that the user must have been following for.
Subscriber ::: Must be a subscriber of the channel (Twitch, GameWisp, or External).
Regular ::: Must be a regular in AnkhBot.
Minimum Minutes ::: Must have spent at least X amount of minutes in the channel.
Minimum Points ::: Must have at least X amount of channel currency (costs nothing to request a code).

I have also added a feature that allows Subscribers of the channel to receive the code before non-Subscribers. You may set an optional timer in the script for this. For example, if the timer is set to 30 seconds, then all Subscribers will begin receiving the code immediatly when they request it with !code. All non-Subscribers would begin receiving the code that they requested once 30 seconds has passed since your Bot's message was displayed in chat. They may still request a !code immediatly, yet they will simply not be whispered until the 30 seconds from the Bot's message has passed. This allows priority for Subscribers while still giving a chance for everyone to join the game.

Commands

!code XXXX ::: Mod Only. To be Whispered to the bot. This will set the code for the game and have the bot display a message in chat saying that anyone that meets the requirements may request a code using the !code command.

!code ::: Once a code has been inputted with the above command, any users that meet the requirements may request a code using this command in chat.

!allin ::: Mod Only. Once the Jackbox Party Pack game is ready to start or has just started, this command will display the code in chat for everyone to join the audience as well as end all script processing.

!cancel ::: Mod Only. If the Jackbox Party Pack game never gets started for whatever reason, then use this instead of !allin to end all script processing.

!invite user1 user2 user3... ::: Mod Only. For convenience, you may use this command with any number of user names after it to have the bot whisper the code to all those users.

!allow add username ::: Mod Only. Add a user as a special exception to any requirements set to request a code. Users added to this 'allow list' may bypass any requirements to request a code.
!allow rem username ::: Mod Only. Remove a user from the 'allow list.'

!deny add username ::: Mod Only. Add a user to the 'deny list.' Users added to this list may never request a code.
!deny rem username ::: Mod Only. Remove a user from the 'deny list.'

!jackbox ::: Generic command informing users to go to jackbox.tv to join the game.

!jackbox perm [permissions] ::: Mod Only. Set the required permissions for users to be able to request a code. 'fo' for Follower. 'fo#' for Follower for at least # minutes. 'su' for Subscriber. 're' for Regular in AnkhBot. 'mm#' for Minimum Minutes spent in the channel. 'mp#' for Minimum Points.
Example: !jackbox perm fomm60 ::: This would set the requirements to "Must be a Follower and have spent 60 Minutes in the channel."
Example: !jackbox perm fo120su ::: This would set the requirements to "Must be a Follower for at least 120 Minutes and be Subscribed to the channel."
Typing !jackbox perm without any additional parameters will post the current requirements in chat.

!jackbox timer # ::: Mod Only. Set the optional timer for Subscribers to be able to receive the code early. Set to 0 to disable.
Typing !jackbox timer without any additional parameters will post the current timer in chat.

Advanced AutoHost Version 2

autohost.mrc

Autohost Script Example

General Info

This script is designed for power users who want more advanced features out of their autohosting programs and/or are not pleased with the lack of customization with Twitch.TV's built in autohost feature. This script is not designed for users who "just want a simple autohost program." This script is a "stand-alone" script that only requires SReject's JSONForMirc.mrc script from the Required Scripts section of the GitHub. However, if you wish to be able to also whisper the autohost commands to your bot (in addition to already being able to type them in chat) then you will also want the mTwitch.Core.mrc script as well.

Upon loading the script in mIRC, you will be greeted with a welcome message with a brief explaination of how the autohost script works. You will be asked a series of questions to help ease the setup process. The default recommended values will already be filled out in the input boxes for you. After the setup process is complete, you will want to edit the autohost.txt file in your mIRC directory to add the names of the channels that you want to host. You can edit the autohost.txt file in your default text editor by right clicking on your mIRC status or channel window and selecting the 'Autohost' context menu. You can also change any of the options that you configured during the setup process by accessing this menu as well.

Multi-Tier

One of the main features of this script is its "multi tier" based autohosting system. Each line in your autohost.txt file is considered a separate "tier." All channels on line 1 are tier 1, all channels on line 2 are tier 2, etc. The higher the tier that a channel is on, the more priority that it is given when the autohost script is ran and begins searching for a host.

If the autohost is enabled, it will search for a new host in 5 minute intervals (configurable). With the default script settings, the following are some possible scenerios:

  • A tier 1 channel is currently being hosted. When the script begins its search for a new host, it will simply stop searching. Tier 1 hosts will remain hosted until they either go offline or you manually unhost them with /unhost or !nexthost.

  • A tier 2 channel is currently being hosted. When the script begins its search for a new host, if a tier 1 channel is currently live and the current host has been hosted for a minimum amount of time specified during setup (default is one hour), then the current host will switch to the first live tier 1 channel that it finds. If no live tier 1 channel is found, the host remains on the tier 2 channel and does not search any further until the next search interval or the current host goes offline.

  • A tier 3 channel is currently being hosted. When the script begins its search for a new host, if a tier 1 channel is currently live and the current host has been hosted for a minimum amount of time specified during setup (default is one hour), then the current host will begin searching for live tier 1 channel to host. If a tier 1 channel is live, then the current host will switch to the first live tier 1 channel that it finds. If no tier 1 channels are live, then the script will begin searching for a tier 2 channel to host. If a tier 2 channel is live, then the current host will switch to the first live tier 2 channel that it finds. If no tier 2 channels are live, then the host remains on the tier 3 channel and does not search any further until the next search interval or the current host goes offline.

  • And so on...

Features / Options

Display message in chat: Possible settings are ON or OFF. Default is ON. Display a message in chat whenever you begin a host on a channel, whether or not the autohost is running.
Example: BlasBot: We are now hosting Blasman13 who is playing Watch Dogs for 69 viewers. Uptime: 4hrs 20mins. You can visit them at twitch.tv/Blasman13

Randomize channels in each tier: Possible settings are ON or OFF. Default is OFF. When the autohost begins to search a tier for a new host, it will search in the order that you place the channels on that line in autohost.txt. If desired, you can enable this option to randomize the order of the names on each tier.

Minimum time passed before rehosting a channel: Configurable. Default is 8 hours. This setting will prevent the autohost script from rehosting the same channel if it has recently been hosted. It will not host the same channel again until the amount of time passed since you last began a host on that channel is longer than this setting.

Minimum time to host a channel for each tier: Configurable per tier. Default is 1 hour. The autohost script will not switch to a new host until the current hosted channel has been hosted for at least the length of time specified for this setting.

How often to look for a new host: Configurable. Default/recommended is every 5 minutes. When the autohost is active, this is how often that it will search for a new host.

Grace period when host goes offline: Configurable. Default is 5 minutes. When the current host goes offline and the autohost is active, it will wait for X amount of time before doing anything. Once this amount of time has passed, it will check to see if that channel has come back online. If the channel is back online, then this will rehost that channel. If the channel is still offline, then the search for a new host will begin. This is useful in the event that a channel is having technical difficulties and has temporarily gone offline, for example.

Performing /unhost to disable Autohost: Possible settings are ON or OFF. Default is OFF. If you would like the /unhost command to also disable the autohost if it is active, then enable this setting.

Channel mods to have access to autohost commands: Possible settings are ON or OFF. Default is OFF. If you would like your channel mods to have access to the autohost commands, then enable this setting.

Default temporary tier for current host when enabling autohost: Configurable. Default is tier 1. If you are already hosting a channel when you first enable the autohost function, it needs to be specified a temporary tier so that the autohost script knows what to do when it begins searching for a replacement host. If the channel is currently in the autohost.txt, it can either be set to a different tier then if it is not found in the file, or it can be set to it's actual tier in the autohost.txt file. Read the setup questions in the script for detailed info.

Force search for new host on any tier after X amount of time: Configurable. Default/recommended is OFF. When the autohost begins searching for a new host and you have been hosting a channel for X amount of time, then this setting will FORCE a search for a new host. This effects all tiers, including tier 1. As always, the search for a new host will begin from tier 1.

Only host live streams and do NOT host streams that are playing VODs: Possible settings are ON or OFF. Default is ON. Change this to OFF if you would like the autohost script to also host channels that are streaming VODs.

Commands

You may type these commands in your channel. If you have the mTwitch.Core script loaded (or another script to enable whispers), you can also whisper these commands to your bot to have your bot reply back to you via whisper with a response.

!autohost on and !autohost off ::: Enable or disable the autohost.
!nexthost ::: Begin searching for a live channel to replace the current host. If ANY channels are live in your autohost.txt file, it will replace the current host with the first channel found (as always, beginning from tier 1). If NO live channels are found in autohost.txt, then the host will stay on the current channel.
!settier X ::: Set a temporary tier for the current hosted channel.
!hostinfo ::: Get info on the current host.

Hostinfo Example

Other Info

If you are choosing to not use mTwitch.Core.mrc, you will need to make sure that you are requesting capabilities from the Twitch server in one of your other mIRC scripts. If you are not, you can simply UNCOMMENT (delete the ; character) from line 10 in the autohost.mrc script.

Word Scramble

scramble.mrc
ScrambleWords.txt
Edit the variables and read the info at the beginning of the script before you load the script. Otherwise, you will have to un-load and re-load the script for the changes to take effect. Put the ScrambleWords.txt file into your mIRC root directory as well.

The game is a TWO player word guessing game, where the bot will rearrange the letters of a five-letter word and whisper the scrambled word to the two players that have agreed to play against each other. The first player to successfully whisper the correct unscrambled word back to the bot will win the game as well as the amount of points that were agreed upon from the other player.

Command List:

!scram on ::: Mod Only. This command will enable the game in your channel.
!scram off ::: Mod Only. This command will disable the game in your channel.
!scram ::: This command will give an info message about how to play the game as well as additional commands.
!scram # ::: Example: !scram 100. This is for a user to start the game as player 1 with X amount of their points on the line. The bot will start a 90 second timer to wait for a second player to join.
!scram # username ::: Example: !scram 100 blasman. This command is for a user to start the game as player 1, but only the username at the end of the command will be able to join the game as player 2.
!scram accept ::: When there is a player 1 waiting for a player 2, this command will join the game as player 2.
!scramstats ::: This command will tell a user their overall win/loss record for the game, as well as their fastest time to win the game.
!scramstats username ::: This command will tell a user their win/loss record against the username in the command.
!scramtop ::: This command will list the top 5 players with the most wins, as well as the 5 fastest times to win the game.

Rock, Paper, Scissors

rps.mrc
Edit the variables and read the info at the beginning of the script before you load the script. Otherwise, you will have to un-load and re-load the script for the changes to take effect.

This is a simple "Rock, Paper, Scissors" game for two players. Once two players agree to play the game against each other, they will both be whispered by the bot to enter their choice. The results will be displayed in the main channel. The winner will receive X points from the other player.

Command List:

!rps on ::: Mod Only. This command will enable the game in your channel.
!rps off ::: Mod Only. This command will disable the game in your channel.
!rps ::: This command will give an info message about how to play the game as well as additional commands.
!rps # ::: Example: !rps 100. This is for a user to start the game as player 1 with X amount of their points on the line. The bot will start a 90 second timer to wait for a second player to join.
!rps # username ::: Example: !rps 100 blasman. This command is for a user to start the game as player 1, but only the username at the end of the command will be able to join the game as player 2.
!rps accept ::: When there is a player 1 waiting for a player 2, this command will join the game as player 2.

Casino Roulette

roulette.mrc
Edit the variables and read the info at the beginning of the script before you load the script. Otherwise, you will have to un-load and re-load the script for the changes to take effect.

This is a classic single-zero Casino Roulette table. It is similar to channel "heists" in the sense that everyone in the channel can bet on the same table at the same time. You can set a maximum amount of channel currency that a user can bet for the entire table, as well as a minimum bet for any option on the table. Therefor, a user can make multiple bets at the table on different options, just like at a real Casino. See http://i.imgur.com/j7Fwytt.jpg for all betting options.

Command List:

!rbet on ::: Mod Only. This command will enable the game in your channel.
!rbet off ::: Mod Only. This command will disable the game in your channel.
!rbet ::: This command will give an info message about how to play the game as well as additional commands.
!rbet [option] [amount] ::: Example: !rbet red 100. This is to make a wager at the table. The example simply means that you bet 100 channel currency on "red."

BlackJack

blackjack.mrc
Edit the variables and read the info at the beginning of the script before you load the script. Otherwise, you will have to un-load and re-load the script for the changes to take effect.

This is a one player BlackJack game. It is an infinite decks game. The bot will always stand on 17 or higher.

!blackjack on ::: Mod Only. This command will enable the game in your channel.
!blackjack off ::: Mod Only. This command will disable the game in your channel.
!blackjack ::: This command will give an info message about how to play the game.
!blackjack # ::: Example: !blackjack 100. This will begin the game with X amount of points as your wager.

Russian Roulette

rr.mrc
Edit the variables and read the info at the beginning of the script before you load the script. Otherwise, you will have to un-load and re-load the script for the changes to take effect.

This is a two player Russian Roulette game. Two players pass a gun with six chambers in the cylinder to each other and take turns at taking a shot at themselves. The player that gets shot loses X amount of channel currency to the other player. Before the game begins, everyone else in the channel will have 90 seconds to place bets on who will be the survivor.

!rr on ::: Mod Only. This command will enable the game in your channel.
!rr off ::: Mod Only. This command will disable the game in your channel.
!rr ::: This command will give an info message about how to play the game as well as additional commands.
!rr # ::: Example: !rr 100. This is for a user to start the game as player 1 with X amount of their points on the line. The bot will start a 90 second timer to wait for a second player to join.
!rr # username ::: Example: !rr 100 blasman. This command is for a user to start the game as player 1, but only the username at the end of the command will be able to join the game as player 2.
!rr accept ::: When there is a player 1 waiting for a player 2, this command will join the game as player 2.
!rrbet user # ::: When betting is open, use this command to bet that either player will be the winner.

!date Command

followdate.mrc
Also required: DateXpander.mrc
This is a !date command that will return how long and when a user first followed your Twitch channel.

  • Mods may use !date by itself to get their own follow date, or they may use it with a users name after the !date command to get info of when another user followed the channel.
  • Non-Mods may only use !date by itself to get their own follow date, and there is a one minute cooldown on the command.
  • The command automatically removes any @ characters from the target's name.

The following are some example replies from the bot.
If the user has been following for LESS THAN ONE HOUR it will display MINUTES and SECONDS only:
User has been following this channel for 47 minutes, and 34 seconds since Jan 14 2016.
If the user has been following for BETWEEN ONE HOUR and ONE DAY it will display HOURS and MINUTES only:
User has been following this channel for 13 hours, and 21 minutes since Jan 13 2016.
If the user has been following for BETWEEN ONE DAY and ONE WEEK it will display DAYS and HOURS only:
User has been following this channel for 4 days, and 13 hours since Jan 10 2016.
If the user has been following for OVER A WEEK if will display YEARS, MONTHS, WEEKS, and DAYS only:
User has been following this channel for 1 year, 3 months, 1 week, and 4 days since Oct 3 2015.

!hosts Command

hosts.mrc
Read the info in the script! This is a simple !hosts command that will list everyone who is currently hosting your channel, in alphabetical order.

!give Command

give.mrc
This is a simple !give command to give points to another user. The built in give command in AnkhBot has various issues such as the ability to easily give points to users that don't exist. This command addresses that issue as well as prevents the user from giving points to the streamer, the bot, or themselves. If will only give points to a user who is currently ACTIVE and in the channel, therefor it requires the randuser.mrc script as well.

!shoutout Command

shoutout.mrc
This is a basic "caster command" used when promoting other streamers in your channel. It is different than AnkhBot's and most other bots shout out commands in the following ways:

  • You can use any of the following commands for shout outs (easy to figure out how to edit in the script as well): !caster !so !shoutout !follow !streamer !ally
  • You may shout out multiple users using the command by adding the list of users after the command, separated by spaces (eg. !caster user1 user2 user3)
  • The command checks the Twitch API to ensure that the name is a valid Twitch user, and retrieves the proper Twitch display name as well. If the user does not exist on Twitch, then either an error message will be displayed, or the name will be omitted from the list of users if shouting out multiple users.
  • The command automatically removes any @ characters from the target's name.

Mario Maker Level ID Script

mario.maker.mrc
This is a Mario Maker Level ID submission script. Users may submit Level ID's into a queue to be played by the streamer. This script was written a long time ago and there are other better ways to integrate a form of viewer level ID submission into your stream. Nonetheless, this is here.

!mm [on/off] ::: Mod Only. Set the script as active and inactive.
!mm cost # ::: Mod Only. Set an optional currency cost for users to submit Level ID's. Default is 0.
!mm max # ::: Mod Only. Set the maximum amount of Level ID's allowed to be queued per user. Default is 1.
!mm queue # ::: Mod Only. Set the maximum amount of Level ID's allowed in the queue. Default is 0 (no limit).
!mm history # ::: Mod Only. Set the number of Level ID's to be kept in history. This is to prevent Level ID's from being resubmitted after already being played and removed from the current queue. Default is 0.
!mm ban [level id] ::: Mod Only. Add a Level ID to the blacklist so that it cannot be submitted to the queue.
!mm followcheck [on/off] ::: Mod Only. Set the script to only allow followers of the channel to submit Level ID's. Default is off.
!nextid ::: Mod Only. Display and advance to the next Level ID in the queue.
!submit [level id] ::: Submit a Level ID to the queue. This command may also be whispered.
!currentid ::: Display the current Level ID as well as the queue size.

Once the first Level ID is activated using !nextid, a text file named mm_current.txt will also be created in your mIRC directory that displays the current Level ID being played. You may use this text file with your broadcasting software to display the current Level ID on the stream.

Undocumented Scripts

Other scripts on this GitHub are:
dice.mrc - a !dice game, somewhat similar to Casino Roulette.
katana.mrc - a game created for twitch.tv/A_Colder_Vision
predict.mrc - a script that I use for prediction games in my channel.
queenulhu.duel.mrc - a game created for twitch.tv/queenulhu
syphon.mrc - a points raffle where everyone puts points into a pot, and the winner gets all the points entered.
nowhosting.mrc - displays a message in chat when you host another channel.
highlight.mrc - use "!highlight message" to make notes of what/when to highlight something that happened during the stream. Saves to a file called "highlights.txt" in your mIRC folder.
thaithyme.istream.mrc - A simple script created for the amazing twitch.tv/thaithyme . Everyone who is a streamer in a channel can let each other know and follow each other.
now_playing.mrc - A simple "now playing" script that will post a message in your channel chat of the current song being played whenever a new song begins playing on stream.

Old/Depreciated Scripts

Classic Jackpot Machine

jackpot.classic.mrc
It is highly recommended that you install Jackpot Version 2 instead of Classic Jackpot Machine, as Jackpot Version 2 is a much newer and superior version of the game. Do not use Classic Jackpot Machine in conjunction with Jackpot Version 2.

Edit the variables and read the info at the beginning of the script before you load the script. Otherwise, you will have to un-load and re-load the script for the changes to take effect.

This is a classic jackpot slot machine. There are nine emotes, and if you get any three in a row, you win the jackpot. The jackpot amount keeps going up with each attempt at winning the jackpot. The odds of winning are 1 in 81.

Command List:

!jackpot ::: plays the game.
!jackpot stats ::: this will tell you some basic stats of the jackpot... the current jackpot, the last winner, how much the last winner won, the total number of winners, and the total payouts.
!jackpot on ::: Mod Only. Turn the game on.
!jackpot off ::: Mod Only. Turn the game off.
!jackpot set # ::: Mod Only. Manually set the current jackpot to #.
!jackpot reset ::: Mod Only. DELETE all jackpot statistics.
!jackpot bet # ::: Mod Only. Change the amount of channel currency that is spent on each play of !jackpot.
!jackpot cd # ::: Mod Only. Change the cooldown time for !jackpot.
!jackpot newpot # ::: Mod Only. Change the amount of channel currency that new !jackpot's will be set to after someone wins.
!jackpot emotes emote1 emote2 emote3 emote4 emote5 emote6 emote7 emote8 emote9 ::: Mod Only. Set the nine emotes that !jackpot uses by adding them to this command.

Classic Slot Machine

slots.classic.mrc
It is highly recommended that you install Slots Version 2 instead of Classic Slot Machine, as Slots Version 2 is a much newer and superior version of the game. Do not use Classic Slot Machine in conjunction with Slots Version 2.

Edit the variables and read the info at the beginning of the script before you load the script. Otherwise, you will have to un-load and re-load the script for the changes to take effect.

This is a classic slot machine game for your channel.

Command List:

You may also type !slots instead of !slot, as they will both do the same.
!slot # ::: plays the game and bets # amount of points on the slot machine. (example: !slot 100)
!slot ::: typed by itself will give info on how to play the game as well as the link for the payout info. http://i.imgur.com/ch5vQZ2.png
!slot on ::: Mod Only. Turn the game on.
!slot off ::: Mod Only. Turn the game off.

It's also worth noting that I ran the script through a 1,000,000 times loop to get an idea of the overall odds of winning and losing. The variance was less than 0.1% in favor of the user. It only seems like the users win a lot simply because it's very easy to win 1x, 2x, and even 5x. However, it is very rare to get any of the other combinations of symbols.

Advanced AutoHost

autohost_old.mrc
It is highly recommended that you install Advanced Autohost Version 2 instead of this one, as Autohost Version 2 is a much newer and superior version of the script. Do not use Version 1 in conjunction with Version 2.
Edit the variables and read the info at the beginning of the script before you load the script, and read the info in the script! Read the commented sections in the script for info on available commands.