> ## 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 Tournaments

> Run Twitch tournaments with brackets, teams, and live scoreboards. Manage competitive events from your stream.

## What are Tournaments?

Vision Tournaments let you run competitive events with professional-looking brackets, team displays, and live scoreboards. Whether you're hosting a small community tournament or a large-scale competition, Vision provides the tools to manage it all.

***

## Tournament Types

Vision supports two main ways of running tournaments:

* **Elimination Tournaments** – classic bracket-style events where teams progress through matches until a winner is crowned.
* **Custom Games** – flexible game modes for darts and similar games where you control how points, hearts, or rounds are displayed on stream.

In practice, many creators set up **one Elimination tournament** for the bracket and **a separate Custom Games tournament** for the in-game scoreboard visuals they show on stream.

***

## Creating a Tournament

<Steps>
  <Step title="Go to Tournaments">
    In the Vision dashboard, click **Tournaments** in the sidebar
  </Step>

  <Step title="Create Tournament">
    Click **Create Tournament** and enter a name
  </Step>

  <Step title="Choose tournament type">
    Select **Elimination** for bracket-style or **Custom** for special formats
  </Step>

  <Step title="Configure settings">
    Set up your tournament branding - logo, colors, and description
  </Step>

  <Step title="Add teams">
    Create teams and add team members with their names and profile pictures
  </Step>
</Steps>

***

## Elimination Tournaments

Elimination tournaments are bracket-based competitions where teams move forward by winning matches:

* **Single elimination** – one loss and the team is out.
* **Bracket overview** – viewers always see who plays next and how far each team has progressed.
* **Best-of support** – combine Elimination with *Best-of Series* to decide each match over multiple legs/sets.

Use Elimination when you want a clear winner at the end of the event and a full bracket to show on stream.

<Steps>
  <Step title="Create an elimination tournament">
    When creating a tournament, choose **Elimination** as the type.
  </Step>

  <Step title="Add teams and seeding">
    Add all teams and (optionally) adjust their order to control the initial seeding.
  </Step>

  <Step title="Configure match format">
    Choose how each match is decided (for example a Best-of Series) in your tournament settings.
  </Step>

  <Step title="Add tournament layers to overlays">
    Use the **Tournament Bracket**, **Tournament Scoreboard**, and **Tournament Score** layers to show the bracket and live scores on stream.
  </Step>
</Steps>

***

## Custom Games

Custom Games are visual scoreboards for different game modes. They are especially useful for darts and pub-style games where you care more about how points/hearts are shown than about a classic tournament bracket.

Each Custom Game mode controls:

* **How teams and players are arranged** (rows, columns, tree layout, etc.).
* **How scores are displayed** (hearts, points per round, wins per match).
* **Which team or player is visually highlighted** (active/throwing team, winner, etc.).

You can design the look of these modes in the **Tournament Designer** CSS editor (see the CSS Designer docs) and then use them live during a match.

<Tip>
  To learn how to style these views with custom CSS, see the **[Tournament CSS Designer](/events/tournaments-css-designer)** guide.
</Tip>

### Hearts Elimination

Hearts is a life-based format:

* Each team (and optionally each player) starts with a number of hearts.
* When they lose a leg/round, they lose hearts.
* When a team runs out of hearts, they are effectively eliminated from the game.

Use this when you want a casual, easy-to-read elimination style where viewers can instantly see who is “on the edge”.

### Points per Round

Points per Round focuses on score progression:

* Each round adds a new column of points for every team and/or player.
* A total score is shown so viewers can see who is ahead overall.
* Active teams and players are highlighted while others are visually dimmed.

Use this when you want to show how scores build up over time (for example, multiple throws/rounds of darts).

### Best-of Series

Best-of Series is about winning rounds rather than collecting points:

* Each match consists of several rounds (e.g. Best of 3, Best of 5).
* Winners of each round are clearly marked.
* A match winner is highlighted once they reach the required number of round wins.

Use this for more competitive matches where you care about clear “wins” instead of total points.

### Tannenbaum

Tannenbaum is a Kegeln-inspired game mode (German-style bowling) laid out in a tree/diamond shape:

* Each cell in the layout represents a target number that must be hit a certain number of times.
* Cells change appearance when they are completed.
* Teams are shown side by side so viewers can compare progress at a glance.

This mode is ideal for party-style or seasonal formats where the layout itself is part of the fun.

***

## Scolia Smart Dartboards

<Warning>
  We also support an integration with **Scolia Smart Dartboards** as a special Custom Game. This mode is not fully documented here because it depends on additional hardware and integration steps.

  If you want to enable the **Scolia Smart Dartboard integration** or need **custom game modes** tailored to your format, please reach out via our **Discord** or contact us at **[support@1up.vision](mailto:support@1up.vision)**.
</Warning>

***

## Setting Up Teams

<Steps>
  <Step title="Create a team">
    In your tournament, click **Add Team**
  </Step>

  <Step title="Team details">
    Enter the team name, upload a logo, and set a team color
  </Step>

  <Step title="Add members">
    Add team members with their:

    * Display name
    * Profile picture
    * Twitch URL (optional)
    * Call URL for camera integration
  </Step>

  <Step title="Repeat">
    Add all participating teams
  </Step>
</Steps>

***

## Tournament Layers

Add tournament visuals to your overlay with these layer types:

### Tournament Bracket

Displays the full bracket showing all matches and progression in an **Elimination Tournament**.

### Tournament Scoreboard

Shows the current standings or leaderboard.

### Tournament Score

Displays the score for the current match. For Custom Games, this can be based on different modes (e.g. hearts, points per round, best-of).

### Tournament Tree

Visual representation of the bracket structure (mainly used for Elimination).

<Steps>
  <Step title="Open your overlay">
    Go to the overlay where you want to display tournament info
  </Step>

  <Step title="Add a tournament layer">
    Click **+** and select a tournament layer type
  </Step>

  <Step title="Select your tournament">
    In the layer settings, choose which tournament to display
  </Step>

  <Step title="Position and style">
    Adjust the size, position, and visual settings
  </Step>
</Steps>

***

## Running a Tournament

### Control Page

Access the tournament control page to manage matches live:

1. Go to **Tournaments** and click on your tournament
2. Click **Control** to open the control interface
3. From here you can:
   * Update match scores
   * Advance winners
   * Reset matches
   * Manage the bracket and Custom Games displayed on your overlay

### Updating Scores

During a match:

1. Open the control page
2. Find the current match or active Custom Game
3. Update the score for each team (depending on the game mode, this can mean hearts, points per round, or wins)
4. When an Elimination match ends, the winner automatically advances in the bracket

***

## Letting Your Mods Help

Grant your team access to manage the tournament:

1. Go to **Permissions → Roles**
2. Create a role with tournament permissions
3. Invite your moderators or tournament admins
4. They can now update scores and manage matches

***

## Tips

<Tip>
  **Test your bracket** before going live. Create a practice tournament to familiarize yourself with the control page.
</Tip>

<Tip>
  **Use team colors** consistently - they help viewers quickly identify teams in the bracket and scoreboard.
</Tip>

<Tip>
  **Set up camera calls** for team members to display their faces alongside the tournament bracket.
</Tip>