> For the complete documentation index, see [llms.txt](https://help.smartico.ai/welcome/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smartico.ai/welcome/products/mini-games/treasure-hunt.md).
# Treasure Hunt
Treasure Hunt is an engaging mini-game where players accumulate the amount of their reward by opening boxes filled with surprises. The special score modifiers that can multiply, divide, or reset the current score of the player add an extra layer of thrill and unpredictability to the game.
### Here's how it works
The Treasure Hunt mini-game is fully customizable, allowing you to create your own skin, specify the type and quantity of prizes, determine the cost type for attempts (Free, Gamification Points, Spin attempts, Gems, or Diamonds), define the user segment eligible to access the game, and more.
**Gameplay Overview**
1. Starting the Game:
1. Players open boxes on a grid.
2. Each box reveals either a number (which adds to their prize total) or a special score modifier.
2. Prize Tracking:
1. The game displays the prize type in the bottom winnings panel (unless hidden via settings), and a counter displays the accumulated prize amount as boxes are opened.
2. Numbers revealed from boxes add to the total prize amount.
3. Modifiers affect the total sum by multiplying, dividing, or resetting it to zero.
3. Game Progression:
1. The game ends when the *‘End Game’* box is revealed, which occurs after a random number of steps (e.g., 5, 10, 12 boxes).
2. At the end, the player receives the accumulated prize amount.
1. For example, if the prize is free spins and the total sum is 30, the player wins 30 free spins.
3. Prize amount, score modifiers, and max number of steps in the game are configurable in the BO.
**Special Score Modifiers:**
Modifiers can be enabled or disabled via the BO to add extra layers of strategy and excitement:
* **Multipliers (x2, x5, x10)**: Multiply the current prize amount by 2, 5, or 10. Example: If the first box reveals 10 and the second reveals x5, the total becomes 50.
* **Dividers (/2, /5, /10):** Divide the current prize amount by 2, 5, or 10.
* **Reset to 0:** Resets the total prize amount to zero but does not end the game.
* **0x:** Empty box
### Configuring the Treasure Hunt
You can set up the Treasure Hunt mini-game from the Back-Office under the Mini-Games section in the Gamification tab. The game configuration template is similar to other random mini-games, featuring tabs for Settings (General and Advanced), Prizes, Winnings, Not claimed prizes, Analytics, Used In, User Attempts (when cost type is Spin attempts), and History.
However, **Treasure Hunt** introduces a few unique options in the Advanced settings and in the Prize configuration.
**Advanced settings:**
* The **'Max. steps in game'** option allows you to set the maximum number of steps for a game. For example, if you enter 10, the game will end in a random number of steps between 1 and 10, and the number of steps will vary each time the game is played.
The game grid consists of 36 boxes (a 6x6 layout). The 'Max. steps in game' setting accepts a value from 1 to 36 (default is 15).
**The Prize configuration settings** have been updated with the following new options:
* **Prize amount** - The prize amount specifies the final amount the player wins at the end of the game. This amount remains the same even if score modifiers are enabled. If the prize type is points, the option changes to the ‘Points amount’.
* **Prize name (without amount)** - If the prize type is Points, Bonus, Jackpot, Tangible items, Raffle Tickets, or Gems & Diamonds, the prize name should not contain any numerical amount because the number is accumulated dynamically on the screen.
* **Hide prize until won -** by default the setting is disabled, but when enabled the prize name remains hidden during gameplay and is only revealed in the winning pop-up once a player wins it.
* **Allow split by decimal** - available only for prize-type Bonus and Tangible items. When enabled the prize amount can be split into decimal numbers.
* **Score modifiers** - You have the option to choose score modifiers for each prize type. These modifiers will appear randomly during gameplay. You can select multiple modifiers, just one, or none. The score modifiers won't change the final prize amount.
### How Prize Determination Works
Like all Smartico mini-games, the winning prize is determined server-side immediately when the player starts the game, according to the probabilities and stock pools configured in the Prizes tab. The frontend then automatically generates an animated sequence of numbers and enabled score modifiers that mathematically sums to the predetermined prize amount upon reaching the End Game box. When the game concludes, all remaining unopened boxes on the 36-tile grid are revealed.
### Treasure Hunt Skinning
To create a custom skin for the Treasure Hunt, you can use the ‘Mini-games skin editor’, following the same approach that is used for mini-games. The ‘Treasure Hunt’ package also includes sound effects so you can upload custom sounds as well.
{% hint style="success" %}
We can provide a Figma template for Mini-games skins upon request.
Please note that any images exported from the template must be compressed before uploading them to the BO. You can use [\[this link\]](https://tinypng.com/) to compress your images.
For further assistance, please contact your Customer Success Manager!
{% endhint %}
{% hint style="success" %}
The supported format for the sound file is MP3 and the maximum file size is 1MB.
{% endhint %}
Here is a package for Treasure Hunt skin using the old pop-ups:
{% file src="/files/iDkf4s5pLYeGoMp4sik4" %}
Here is a package for Treasure Hunt skin using the new pop-ups:
{% file src="/files/swY9Xqdw7OVsYaF8XNmx" %}
You can find the rest of the packages for the Treasure Hunt skins here:
{% embed url="" %}
### Frequently Asked Questions
**Does the player's choice of boxes affect the final prize or outcome?**
No. The prize is determined server-side when the game starts based on the prize pool probabilities. The client dynamically generates a sequence of numbers and modifiers that always adds up to that exact prize amount upon reaching the End Game box, regardless of which boxes the player clicks.
**Is there a minimum number of prizes required to configure a Treasure Hunt template?**
Unlike Scratch Cards (which require exactly 6 real prizes) or Plinko (2 to 7 prizes), Treasure Hunt does not enforce a minimum count of prize tiers. You only need at least one valid prize (and a surcharge prize or unlimited pool) to activate the template.
**What sound files are supported for custom Treasure Hunt skins?**
The skin package supports MP3 audio files under 1MB. Treasure Hunt can use custom sound effects for opening tiles (tile-opening.mp3), empty boxes (empty-tile.mp3), positive modifiers (positive-modifier.mp3), negative modifiers (negative-modifier.mp3), reset modifiers (reset-modifier.mp3), winning sounds (you-won.mp3), losing sounds (you-lose.mp3), and background music (treasure-hunt-background.mp3).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://help.smartico.ai/welcome/products/mini-games/treasure-hunt.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
