> ## Documentation Index
> Fetch the complete documentation index at: https://docs.1up.vision/llms.txt
> Use this file to discover all available pages before exploring further.

# Stream Bingo Overlay

> Add interactive bingo boards to your Twitch stream. Customizable grid with mod collaboration.

## How to Use Bingo

The Bingo layer lets you create interactive bingo boards for your stream.

### Getting Started

<Steps>
  <Step title="Create overlay">
    Create a new overlay or open an existing one
  </Step>

  <Step title="Add Bingo Layer">
    Click the **+** icon and select **Bingo**
  </Step>

  <Step title="Set grid size">
    Choose your board dimensions (e.g., 5x5 for traditional bingo)
  </Step>

  <Step title="Add fields">
    Enter text for each bingo square
  </Step>

  <Step title="Position">
    Drag and resize the bingo board on your overlay
  </Step>

  <Step title="Save">
    Save your overlay to display the bingo board
  </Step>
</Steps>

***

## Configuring the Board

### Grid Size

Set the dimensions of your bingo board:

* Minimum: 1x1
* Maximum: 10x10
* Common sizes: 3x3, 4x4, 5x5

### Adding Fields

Each square on the board is a "field":

1. Click on a square to edit it
2. Enter the text (e.g., "Streamer dies", "Chat spams", "Donation alert")
3. Repeat for all squares

### Marking Fields Complete

During your stream:

1. Click on a bingo field when the event happens
2. The field is marked as complete and changes appearance
3. The completion is tracked with who marked it and when

***

## Styling

### Colors

| Setting             | Description            |
| ------------------- | ---------------------- |
| **Primary Color**   | Board background color |
| **Secondary Color** | Completed field color  |

### Typography

Customize text appearance:

* Font family
* Font size
* Font color

### Visual Options

* Adjust opacity
* Set in/out animations
* Apply custom CSS via Advanced → Theme

***

## Letting Your Mods Help

Let moderators mark bingo squares:

1. Go to **Permissions → Roles**
2. Use a prebuilt role or create a custom one with overlay edit permissions
3. Invite your moderator
4. They can now mark bingo fields during the stream

When a moderator marks a field, it tracks:

* Their username
* Their profile picture
* The time it was marked

***

## Tips

<Tip>
  **Plan your fields** before the stream. Having all squares ready prevents awkward pauses.
</Tip>

<Tip>
  **Use a center free space** for traditional 5x5 bingo - mark it as complete from the start.
</Tip>

<Tip>
  **Reset between streams** by unmarking all fields if you want to reuse the same board.
</Tip>