A Dice Roll Game

Dice Roll Game - Instructions and Overview

App Summary

The Dice Roll Game lets users tip tokens to roll dice and win fun prizes! Each time a user tips a specified amount, they roll two dice, and the total of the dice determines the prize they win. Customize the prizes, set the dice roll frequency, and make the experience engaging with emojis and dynamic prize displays.

How It Works

1. Users tip a multiple of the set tokens per roll (e.g., 44 tokens per roll).

2. Two dice are rolled, and the total of the dice determines the prize the user wins.

3. The room can periodically be informed about the game and the available prizes through customizable notices.

---

Instructions for Setting Up and Customizing the App

1. Tokens Per Roll

Set the number of tokens required for each dice roll. This ensures that every tip meeting the required token count triggers the dice roll.

• Default: `44 tokens`

• Adjustable in the settings under Tokens per roll.

2. Prizes for Dice Rolls

For each dice roll total (from 2 to 12), you can customize the prize. These prizes are announced when a user rolls the corresponding number.

• Example prizes:

• 2: "Small kiss 😘"

• 7: "Spin around 🌀"

• 12: "Big smile 😄"

• You can set unique prizes in the settings under Prize for rolling X.

3. Weighted Prize Chances

Control the likelihood of each prize being won by adjusting the weight for each roll total (2-12). Higher weights make a roll more likely to occur.

• Default values: Higher totals are more likely (e.g., 7 has a higher weight than 2).

• Adjustable in the settings under Weight for rolling X.

4. Prize List Display Format

Choose how the prize list is shown in the room:

• Block format: Each prize is displayed on a separate line.

• Single line format: Prizes are shown on a single line, separated by an emoji.

• Adjustable in the settings under Prize List Display Format (choose "Single Line" or "Block").

5. Periodic Room Notices

The app sends periodic room notices to remind viewers about the game:

• Dice Roll Notice: Informs the room how many tokens are needed to roll the dice.

• Prize List Notice: Lists the prizes that can be won by rolling the dice.

• Adjustable intervals for both notices:

• Dice roll notice interval: How often the room is informed about the dice roll tokens.

• Prize list notice interval: How often the prize list is shown.

6. Emoji Separator

Customize the emoji used to separate prizes when displaying them in a single line.

• Default: 🎁 (gift emoji)

• Adjustable in the settings under Emoji separator for the prize list.

---

Settings Overview

In the app settings, you can customize the following:

• Tokens per roll: Number of tokens required to roll the dice.

• Prize descriptions: Set a custom message for each dice roll (2 through 12).

• Prize weighting: Adjust the likelihood of each dice total being rolled.

• Prize list format: Choose between block format or single-line format.

• Room notice intervals: Set how often the app reminds users to roll the dice and displays the prize list.

• Emoji separator: Set a custom emoji to separate prizes in the single-line format.

---