Currency Core (2).png

General Notices

<aside> 💡 This product will work without the core system, but it is highly recommended for you to install that too.

</aside>

<aside> <img src="/icons/info-alternate_blue.svg" alt="/icons/info-alternate_blue.svg" width="40px" /> This product comes without a .StreamUP file because it is just controlled inside of Streamer.Bot.

You still need to install the product into Streamer.Bot and use our DLL so make sure you follow the instructions below! Installing Products into Streamer.Bot Adding a Product into Streamer.Bot Setting Up a Product in Streamer.Bot Enabling Chat Commands In Streamer.Bot

All these links go to the same page but for easy of access I included them all so that you can clearly see what is required to do before continuing!

</aside>

After Streamer.Bot Installation

Alright, now that you have installed everything that is required into Streamer.Bot it is time to start using the product. If you are unsure what some of the settings were and what they did you can see explanations at the bottom of this guide.

<aside> <img src="/icons/info-alternate_blue.svg" alt="/icons/info-alternate_blue.svg" width="40px" /> If there is an tiny image, you can click on the image to see a enhanced version of it.

</aside>

User Guide

How to Use

By default this product is setup to work with Twitch and YouTube. It allows users to gamble their points for a chance to double up on with this game. This game is fully customisable allowing you to change the odds and if you want to enable push which results in a draw.

Settings

This overview explains the function of each setting. By adjusting these settings, you can control the rate at which users earn points. You can access this menu by going to the Currency Slots • Settings action then right clicking the Test trigger, then press Test Trigger.

Buttons

Reset Button
- Function: Resets all settings to their default values.
- Location: Bottom-left corner of the UI.
- Action: Click to reset all settings to default.
Save Button
- Function: Saves the current settings.
- Location: Bottom-centre of the UI.
- Action: Click to save your changes.
Cancel Button
- Function: Discards any changes and closes the settings window.
- Location: Bottom-right corner of the UI.
- Action: Click to discard changes and exit the settings menu.

General Settings

What would you like to call your points

Description: Specifies the name that will be used to refer to the user's points in the slots game.
Usage: Enter a custom name for your points, such as "Coins" or "Tokens".

Bet Amount when none is given

Description: Sets the default amount of points to bet if the user does not specify an amount.
Usage: Enter a number (e.g., 1000) that will be used as the default bet amount.

Points a user will have if they don't have enough to bet

Description: Defines the amount of points given to users who attempt to bet without having enough points. For example if they only have 150 then when they try to bet they will be rounded back up to 200. If you don't want this setting on you can set it to 0
Usage: Enter a number (e.g., 200) to ensure users can participate even if they run out of points.

Minimum bet amount

Description: Establishes the minimum amount of points a user can bet in the slots game.
Usage: Enter the smallest bet amount (e.g., 100) allowed in the game.

Maximum bet amount

Description: Establishes the maximum amount of points a user can bet in the slots game.
Usage: Enter the largest bet amount (e.g., 5000) allowed in the game.

What % chance do you want to give the users?

Description: Determines how likely a user win is to happen. The higher the number the more likely.
Usage: Enter the value you wish to set the percentage at.

Would you like to enable push?

Description: Determines if push is enabled, if push is enable then if logic roll are equal the result will be a draw and the bet will be returned, otherwise a match will be settled as a loss.
Usage: Check or uncheck depending on if you want to enable push.

Would you like to fail if bet is under minimum?

Description: Determines if the action should fail if the bet is under the minimum or if it should try bet the minimum.
Usage: Check or Uncheck if you want it to fail when someone bets under the minimum.

Would you like to fail if bet is under maximum?

Description: Determines if the action should fail if the bet is under the maximum or if it should try bet the maximum.
Usage: Check or Uncheck if you want it to fail when someone bets under the maximum.

Untitled

Commands

This extension only comes with one command.

Command	Purpose
!gamble
This is how the user will have a gamble, with the command `!gamble <amount>`

<aside> 💡 Note that amount can be one of the following.

A Number : !gamble 5000 A Percentage : !gamble 20% It can use K and M as short for Thousands and Millions : !gamble 50k !gamble 5m You can use All to call for an all in: !gamble all or you can leave it blank to bet the default amount: !gamble

</aside>

<aside> ⛔ If you try bet a negative number that will be converted into a positive number.

</aside>

Arguments and Triggers

This game comes with several Custom Triggers so you have full control over what happen with the different out comes, below is a list of the triggers and when they would trigger. Each Trigger is found in the Custom >> Currency trigger context menu.

Trigger	Description
Gamble All In Loss	Triggers when a player loses all their remaining balance in one gambling round.
Gamble All In Win	Triggers when a player wins after betting all their remaining balance in one gambling round.
Gamble All In Push	Triggers when a player neither wins nor loses, but ends up with the same balance after betting all their remaining balance in one gambling round.
Gamble Any Loss	Triggers whenever a player experiences any loss in a gambling round.
Gamble Any Win	Triggers whenever a player experiences any win in a gambling round.
Gamble Any Push	Triggers whenever a player's balance remains the same after a gambling round (no net win or loss).
Gamble Loss	Triggers when a player loses in a gambling round. That isn’t an All In Bet.
Gamble Win	Triggers when a player wins in a gambling round. That isn’t an All In Bet.
Gamble Push	Triggers when a player's balance remains the same after a gambling round (no net win or loss). That isn’t an All In Bet.

These actions will also return several arguments these can be used in your actions.

Argument Name	Example	Description
`gameName`	Gamble	This is the name of the game.
`points`	99284	This is the amount of points you have at the start.
`pointsName`	Points	This is the name you’ve given to your points.
`betSize`	3000	This is the amount that ended up been bet.
`gambleResult`	64	This is the random number that is span in order to determine a winner.
`allIn`	False	This bool is if the bet is an All In bet or not.
`result`	Loss	This is a bool showing if the bet is a winner or not.
`oldPoints`	99284	This is the points before the bet.
`newPoints`	96284	This is the points after the bet.

Errors

If something goes wrong slots has some error codes built in these can be used with Generic Fail Trigger. When this happens you can use either %failCode% or %failReason% to differentiate between the errors.

This table shows the error code and the reason that is associated with that error.

`%failCode%`	`%failReason%`
1	User Can Not Afford to Make this Bet
2	Your bet is over the maximum you can bet upto {max}
3	Your bet is under the minimum you need to bet at least {min}