> 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.md). # Mini Games Smartico Mini-Games are interactive, gamified engagement tools that allow operators to reward players through randomized games of chance, sports prediction challenges, and custom interactive experiences. Mini-games can be used across player acquisition, onboarding, daily engagement, and VIP retention journeys. ### Game Types & Mechanics Smartico provides three main categories of mini-games: 1. **Random Reward Mini-Games** * **Spin the Wheel (Loyalty Wheel):** A classic spinning wheel with 3 to 10 customizable prize sectors, pointers, and animations. * **Scratch & Catch (Scratch Card):** An interactive scratch-card game where players scratch a canvas to reveal their prize. * **Gift Box:** A selection game where players tap mystery gift boxes to uncover hidden rewards. * **Lootbox (Daily & Weekly):** Calendar-based or weekday-based mystery boxes with dynamic daily prize pools. * **Treasure Hunt:** A map-exploration game where players choose sectors on a treasure grid. * **Voyager:** An animated journey game where a character travels along a path to reach rewards. * **Plinko:** A physics-driven ball drop game where balls navigate pegs into prize buckets. * **Coin Flip:** A quick binary-choice heads or tails game. * **Prize Drop:** Instant server-triggered prize popups that reward active players in real time without requiring manual spin actions. 2. **Prediction Mini-Games** * **MatchX:** A sports prediction game where players predict match scores and outcomes to compete on leaderboards and win shared progressive jackpots. * **Quiz:** A trivia and sports questionnaire game where players answer multi-round questions to earn points and leaderboard rewards. 3. **Custom Mini-Games (Vibe Studio & Web Embedding)** * Operators can build and integrate bespoke mini-games created in Vibe Studio or hosted externally via iframe embedding. ### Launch Modes & Deployment Mini-games can be presented to players through four distinct launch methods: * **In-Widget Mode:** Mini-games appear directly within the Gamification Widget lobby under the Bonus Games section or inside a dedicated Custom Section tab. * **Standalone Mode:** Mini-games open as a dedicated, focused modal or full-screen overlay without the full widget interface, ideal for push notification clicks, direct links, and campaign triggers. * **Embeddable & Inline Mode:** Games can be embedded directly into website banners, promotion pages, or custom iframes via dedicated embed URLs. * **Landing Pages & Visitor Mode:** Mini-games can be displayed to unregistered visitors on acquisition landing pages, allowing anonymous leads to play and claim their won prizes upon completing registration. ### Buy-in Options & Attempt Management Operators can control how players access and pay for mini-game attempts: * **Buy-In Types:** Attempts can be configured as **Free**, purchased using **Gamification Points / Gems / Diamonds**, or unlocked using **Spin Tickets**. * **Spin Ticket Distribution:** Spin attempts can be awarded automatically through Campaign automations, Mission completion rewards, Level-up bonuses, Tournament prizes, or purchased in the Gamification Store. * **Spin Expiration Rules:** Tickets can be set to expire based on a relative timeframe from issuance (e.g., within 24 hours), at a specific clock time each day, on a specific day of the week, or on an exact calendar date. * **Play-Rate Limits:** Operators can throttle play frequency by setting maximum allowed spins per rolling time window, per calendar day (based on label or player timezone), or per player lifetime. * **Visibility Rules:** The game can be configured to remain visible at all times or hidden automatically when a player has no remaining attempts or insufficient points. ### Prizes & Automated Fulfillment Mini-games support diverse reward types and instant automated workflows: * **Supported Prize Types:** Real-money or bonus credits (Casino and Sports bonuses), Gamification Points, Gems, Diamonds, Tangible merchandise, Spin tickets for other mini-games, Progressive Mini-Game Jackpots, or "No Win" outcomes. * **Prize Claiming & Delivery:** Rewards can be credited instantly upon game completion or require explicit player confirmation. If a player disconnects or closes the game mid-spin, an automated background sweep ensures won prizes are safely delivered. * **Automated Win Workflows:** Winning a mini-game prize can trigger automated multi-channel messaging (instant popups, push notifications, emails, or SMS) and initiate automated CRM player journeys. * **Physical Merchandise Delivery:** Tangible prizes can trigger automated alerts for manual shipping fulfillment or connect directly to third-party delivery provider APIs. ### Skins, Customization & Localization * **Theme Library:** Pre-built seasonal and event skins (Christmas, Halloween, Valentine's Day, Oktoberfest, Sweet Choco, and more) are available out of the box. * **Custom Skin Editor:** Operators can customize visual elements including wheel sectors, prize icons, pointers, scratch layers, sounds, and background graphics, with Figma design templates available upon request. * **Multilingual Support:** All titles, descriptions, prize names, button labels, and system notifications support multi-language translations and adapt dynamically to the player's active language. ### Frequently Asked Questions **Can mini-games be offered to anonymous visitors on landing pages before registration?** Yes. Mini-games can run in Visitor Mode on acquisition landing pages using the Visitor API or embed scripts. Anonymous players can spin the game, and their won prize is associated with a secure token that automatically credits the reward to their player account once they complete registration. **Why is a mini-game missing from the lobby or showing "There is nothing here, yet..."?** This typically happens if the template's visibility setting is configured to hide the game when the player has zero available attempts or insufficient balance. Additionally, check that the player satisfies the assigned segment rules, that the current time falls within the template's active date and hour window, and that any linked custom section is enabled in the widget settings. **How can our design team create custom visual skins for mini-games?** Designers can utilize Smartico Figma templates to prepare assets matching exact canvas specifications for Spin the Wheel, Scratch Card, Gift Box, and Lootbox formats. Once images (pointers, prize icons, card covers, background assets) are uploaded in the Back-Office Skin Editor, they can be assigned directly to active mini-game templates. **Can we create custom mini-games using our own code or Vibe Studio?** Yes. Operators can develop bespoke mini-games using Vibe Studio or host their own HTML/JavaScript games on an external URL. By selecting Custom Game mode in the template configuration, Smartico embeds the game securely in an iframe, automatically handles player authentication and prize resolution, and tracks game results. --- # 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.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.