---
title: "Thunderboard"
slug: "thunderboard"
updated: 2026-06-11T10:57:49Z
published: 2026-06-11T10:57:49Z
canonical: "docs.xtremepush.com/thunderboard"
---

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

# Thunderboard

An overview of the Thunderboard game and the game campaign setup process.

## Game Overview

[](https://docs.xtremepush.com/docs/thunderboard#game-overview)

*Thunderboard* is a tile-matching game in which players are presented with a grid of face-down tiles. Players flip tiles to reveal symbols, and matching tiles count as a match. To win a prize, a player must find enough matches required for that prize.

You can configure the following for a *Thunderboard* game:

- The number of prizes and the number of matches required to win each prize.
- The maximum number of picks a player can make per game.
- How many times a player can play per day, week, or month.

There are two ways you can configure a *Thunderboard* game:

- Equal Matches: All prizes in the game require the same number of matches. The video below shows a game where all prizes require the same number of matches.

[Embedded content](https://app.screencast.com/7ZuMn4carZH4L/e)
- Different Matches: Each prize can have its own required number of matches. The video below shows a game where different prizes require different numbers of matches.

[Embedded content](https://app.screencast.com/CBMsYJtxjKjsf/e)

> [!NOTE]
> Regardless of which match configuration you use, the likelihood of a player winning a prize is determined by the prize weight and the customer segment they belong to. For more information, see [Prizes in Thunderboard](https://docs.xtremepush.com/docs/thunderboard) below.

The entire game is built and managed within the Xtremepush platform and can be embedded directly on your website.

### Prerequisites

[](https://docs.xtremepush.com/docs/thunderboard#prerequisites)

- User Segments: To target your game to specific players, you'll need pre-configured segments. These must be created on the Xtremepush platform before you start. For more information, see [Before You Create a Game Campaign](/documentation/docs/before-you-create-a-game-campaign).
- Game Assets: Have your game assets prepared. These include images for the game background, the tiles for the grid, prizes, and other branded elements. Assets are uploaded directly within the game in the **Assets** tab when you select a template during the campaign configuration.

## Game Setup

[](https://docs.xtremepush.com/docs/thunderboard#game-setup)

The following sections provide a high-level overview of the steps required to set up a *Thunderboard* game.

The infographic below highlights the four key stages of the game launch workflow, from creation to monitoring:

### Create Campaign

Define the rules of your new game.

✏️

🎨

### Configure Mechanics

Configure prizes and optional time slots.

### Customise Design

Replace assets and update texts.

⚙️

🚀

### Launch & Monitor

Embed your game and view player activity.

### Create Game Campaign

[](https://docs.xtremepush.com/docs/thunderboard#create-game-campaign)

The first step in creating your game is creating a game campaign. A campaign acts as the container for your game, allowing you to define crucial aspects like target audiences, campaign duration and more. It also contains your game’s design, text, and prize configurations.

For more information on the required fields when setting up campaigns, see [Create a Game Campaign](/documentation/docs/create-a-game-campaign)

Selecting a template automatically loads a complete layout file and the necessary assets into your campaign's **Assets** tab. This streamlines configuration, allowing you to easily replace the default assets with your own without needing to build the game's layout from scratch.

> [!NOTE]
> Max Picks per Game
> 
> When creating a *Thunderboard* campaign, you can configure the **Max Picks per Game** . This sets the maximum number of tiles a player can flip in a single game. Once a player has used all their picks, the game ends.
> 
> Ensure this value corresponds to the number of matches required for each prize. For example, if the number of matches required for a prize is 3, the minimum value for **Max Picks per Game** must be 3.

### Customise Game Design

[](https://docs.xtremepush.com/docs/thunderboard#customise-game-design)

After creating the campaign, the next step is to customize the game's visual design and text to match your brand. This involves three key areas:

- Replace or Add Assets : The template you select provides a standard asset pack, which includes default images for the background, game board, and prizes. You have two options for customization:
  - You can replace any of the default assets with your own branded versions. For more information, see [Replace Assets](/documentation/docs/replace-assets).
  - You can also add new assets that are not part of the standard pack. For more information on adding new assets, see [Manage Assets](/documentation/docs/manage-assets). For a general overview on game assets, see [Assets Overview](/documentation/docs/assets-overview)
- Update Game Texts: In the **Texts** tab, you can update all the standard text that appears in your game's interface. However, the text displayed when a player wins or loses is configured separately in the **Prizes** tab. For more information, see [Update Texts](/documentation/docs/update-game-texts)
- Make Design Changes in the Editor: For granular control over the game's front-end appearance, use the Editor. It allows you to make detailed visual adjustments, such as resizing or repositioning elements, modifying fonts and colours, or adding new components. For more information, see the following pages:
  - [Editor Overview](/documentation/docs/editor-overview)
  - [Editor Use Cases](/documentation/docs/handle-prize-redirects-from-your-website).
  - [Customise a Game Grid Layout](/documentation/docs/customise-a-game-grid)

### Configure Game Mechanics

[](https://docs.xtremepush.com/docs/thunderboard#configure-game-mechanics)

#### Prizes in Thunderboard

[](https://docs.xtremepush.com/docs/thunderboard#prizes-in-thunderboard)

In the **Prizes** tab of your campaign, you configure the prizes available in your game and map them to the prize slots in your game's pay table. For more information the different prize configuration fields, see [Configure Prizes](/documentation/docs/configure-prizes).

> [!NOTE]
> **Number of Prizes in your Game**
> 
> If you selected a template, a standard 6 prizes and a no-win prize are available in your game by default. The number of prizes can be configured under **Editor** > **Settings** > **Prize** > **References**.
> 
> In the **References** field, you can view and manage your prize references. These are the internal identifiers for each prize in your game. You can rename these references or add and remove prize slots to control how many prizes appear in your game

When configuring a prize, the three key fields are:

- **Prize Reference**: Links the prize you are configuring to the corresponding prize in the game's pay table. Each prize must be mapped to a prize reference.
- **Matches Required**: The number of matching tile pairs a player must find to win this prize.

The number of matches required for a prize does not determine whether a player wins it. Even if one prize requires 5 matches and another requires 3, a player's chance of winning each prize is determined solely by its weight relative to the other prizes in their segment.
- **Weight**: Determines the likelihood of a player winning this prize. Before a game begins, the system determines which prize a player will win based on the prize weights. This also determines the number of matches the player finds during the game.

The chance of winning a prize is based on its weight relative to the total combined weight of all prizes available for that specific customer segment. A higher weight means a higher chance of winning

> [!NOTE]
> **No-Win Prize**
> 
> You must configure a no-win prize for your game. The no-win prize is included in the weight calculation and works like any other prize. When configuring the no-win prize, ensure the following:
> 
> - You only need to configure one no-win prize with a single **Matches Required** value. This means the no-win outcome is fixed. For example, if you set the no-win prize to 2 matches, every player who does not win a prize will always end the game with exactly 2 matches. There is no scenario where a player receives fewer matches than this value.
> - The **Matches Required** value must be greater than 0.

The table below shows an example prize configuration using different matches per prize:

| **Prize** | **Prize Reference** | **Matches Required** | **Weight** |
| --- | --- | --- | --- |
| 🎟️ Free Spins x5 | Prize 1 | 3 | 20 |
| 🎟️ Free Spins x10 | Prize 2 | 3 | 20 |
| 💰 €5 Free Bet | Prize 3 | 3 | 20 |
| 💰 €10 Free Bet | Prize 4 | 4 | 10 |
| 💰 €25 Free Bet | Prize 5 | 4 | 10 |
| 💰 €50 Free Bet | Prize 6 | 4 | 10 |
| 🏆 €100 Free Bet | Prize 7 | 5 | 5 |
| No-win | No-win | 1 | 5 |
| Total |  |  | 100 |

In this example, *Prize 3* has a weight of 20 out of 100, making it more likely to be won than *Prize 7*, which has a weight of 5 out of 100.

#### Configure Time Slots

[](https://docs.xtremepush.com/docs/thunderboard#configure-time-slots)

You can control your game's daily availability by setting up specific time slots when it can be played. For example, you could make the game available only during a 'happy hour' promotion from 5 PM to 7 PM.

For more information, see [Manage Time Slots (Optional)](https://docs.xtremepush.com/docs/manage-time-slots-optional).

### Launch and Monitor Game

[](https://docs.xtremepush.com/docs/thunderboard#launch-and-monitor-game)

**Launch Your Game**

[](https://docs.xtremepush.com/docs/thunderboard#launch-your-game)

To launch your game, you must embed it on your website. For added security, you can also use a JWT token to ensure that only authenticated users are able to play.

For more information, see the following pages:

- [Launch your Game](/documentation/docs/launch-your-game)
- [JWT Authentication Details](/documentation/docs/jwt-authentication-details).

#### Monitor Player Activity

[](https://docs.xtremepush.com/docs/thunderboard#monitor-player-activity)

The Xtremepush platform automatically tracks the following engagement data for the *Thunderboard* game, which you can view in the **Games** tab of your campaign:

- A record of every player that played the game, the prize they won, and no-win outcomes.
- Timestamps for when the user opened the game (**Created At**) and when they played it (**Played At**).
- Timestamps for when a prize was accepted (**Accepted At**) or declined (**Declined At**).