> For the complete documentation index, see [llms.txt](https://competitions.gitbook.io/competition-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://competitions.gitbook.io/competition-docs/minigames/view-minigames/setting-up-magic-ball.md).

# 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="https://3744898343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvmZQfjJYplU4Sw9Oe8b0%2Fuploads%2FcuxFO5oigcmV308jQKJO%2Fmagic%20ball.gif?alt=media&amp;token=85f5356a-a98e-4b01-97be-0b9795db2197" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3744898343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvmZQfjJYplU4Sw9Oe8b0%2Fuploads%2FiznEVcbbRdTTXArIDWgE%2Fimage.png?alt=media&amp;token=6dc0d3c3-c7de-4370-a68c-8cbcc2c0570f" alt=""><figcaption></figcaption></figure>

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