# Setting up Magic Ball

If you've read our [Setting up Scratch Cards](/competition-docs/minigames/view-minigames/setting-up-scratch-cards.md) article then you will see a lot of parallels between that and this article.\
\
You may only need to read one of these articles to understand how to operate both of them but in this article we will show you how the Magic Ball game mode works from a customer perspective aswell as how to set it up.

### How does Magic Ball work?

Magic ball is a simple minigame, shake your phone to find out if you won or tap the magic ball!

#### Get started with Magic Ball <a href="#get-started-with-slot-machine" id="get-started-with-slot-machine"></a>

Setup an Instant Prize Competition as usual and then scroll under the Featured image to find the Minigames widget.

<figure><img src="/files/aYfAyDqJrRlWcWfI4JYQ" alt=""><figcaption></figcaption></figure>

Select the Magic Ball game and save the product. Once you have done that, every ticket purchased will give customers a go at the Magic Ball Game.

#### Behind the hood <a href="#how-does-it-work" id="how-does-it-work"></a>

The Magic Ball game & all minigame modes integrate with the Instant Prizes to provide a visual overlay that is more interactive than the original instant wins. When someone purchases a ticket they will see a button after Checkout aswell as on the Magic Ball game activated competition above the Add to Cart button where they can open a Popup.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://competitions.gitbook.io/competition-docs/minigames/view-minigames/setting-up-magic-ball.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.