Mini Game Templates · Solitaire 4.0 Pack

🏠 Overview

10 fully playable mini-games, each with boosters, achievements, reskin slots, a first-run tutorial, per-level difficulty scaling and light/dark theming — all driven by one shared runtime.

Shared capabilities

⚙ How it works

This is a procedural-UI games template. Every game builds its own interface and logic in C# at runtime inside the RectTransform you give it — there are no hand-placed prefabs to wire up. The shipped demo scene is a pre-baked snapshot of that build, so you can inspect the full hierarchy without pressing Play; on Play it rebuilds itself and becomes fully interactive.

The Studio

Open Tools > Mini Game Templates > Studio for per-game tuning panels. Settings you edit are saved to ScriptableObject assets under Assets/MiniGameTemplates/Resources/Config/ and loaded by the games at runtime.

Customization at a glance

⚡ Quick start

1. Import MiniGameTemplates-Solitaire4.unitypackage. If Unity offers to import TMP Essentials, accept — the demo UI uses TextMeshPro.
2. Open Assets/MiniGameTemplates/Demo/MiniGameTemplates_Solitaire4.unity. The full demo is already baked into the scene.
3. Press Play — the dashboard lists every Solitaire 4.0 game; pick, play, and try the boosters and cheat rail.
4. Open Tools > Mini Game Templates > Studio and tune any game's settings.
5. (Optional) Open Tools > HLK > Guided Setup to configure the bundled LiveOps kit — ads, IAP, notifications, rate-us and more (see the LiveOps Kit section).
6. To ship a single game inside your own UI, use the IMiniGame contract:

IMiniGame game = new WhiteheadGame();
game.Mount(hostRect, context);   // context : IMiniGameContext
// ... later, when done:
game.Unmount();

🛠 Architecture

The IMiniGame contract

public interface IMiniGame {
    string Id { get; }                 // stable snake_case id, e.g. "solitaire4_whitehead"
    string DisplayName { get; }
    string Category { get; }
    string ShortDescription { get; }
    void Mount(RectTransform host, IMiniGameContext ctx);
    void Unmount();
    void NewRound();
    IEnumerable<CheatAction> GetCheatActions();
}

Auto-discovery

Per-game folder layout

Assets/MiniGameTemplates/Runtime/Solitaire4/<Game>/
    <Game>Game.cs             // gameplay + procedural UI
    <Game>Settings.cs         // ScriptableObject settings (+ static Default)
    <Game>BoosterSpec.cs      // booster definitions
    <Game>AchievementSpec.cs  // achievement definitions
    <Game>ReskinSpec.cs       // reskinnable sprite slots
    <Game>TutorialSpec.cs     // first-run walkthrough steps

Runtime flow

Mount(host, ctx) → NewRound() → player input loop → RoundWon / RoundLost event → NewRound() or Unmount()

🎮 Whitehead

Klondike, all face up; build down by colour, same-suit runs move together.

How to play

1. Every card is face up. Build columns DOWN by colour — a red card goes on a red card one rank higher, black on black. Only an in-order SAME-SUIT run lifts as a group.
2. Turn the stock for one card at a time onto the waste. Build the four foundations UP by suit from Ace to King. Clear all 52 cards to win.

Boosters

Achievements

Reskin slots

background card_back card_face — drop art per slot via Tools > Mini Game Templates > Reskin Editor.

Configurable settings

↑ Back to top

🎮 Westcliff

Ten columns of three; build down by alt colour; stock deals a full row.

How to play

1. Ten columns of three cards. Build columns DOWN by alternating colour (red on black, black on red). An in-order alternating run lifts as a group; empty columns take any card.
2. When you are stuck, tap the stock to deal one card to EVERY column at once. Build the four foundations UP by suit from Ace to King. Clear all 52 cards to win.

Boosters

Achievements

Reskin slots

background card_back card_face — drop art per slot via Tools > Mini Game Templates > Reskin Editor.

Configurable settings

↑ Back to top

🎮 Thumb and Pouch

Klondike where tableau builds down in any suit but the same one.

How to play

1. Build columns DOWN in any suit EXCEPT the same suit — a card stacks on a different-suit card one rank higher. An in-order run that follows that rule lifts as a group.
2. Tap the stock to turn one card to the waste; once empty it recycles. Build the four foundations UP by suit from Ace to King. Clear all 52 cards to win.

Boosters

Achievements

Reskin slots

background card_back card_face — drop art per slot via Tools > Mini Game Templates > Reskin Editor.

Configurable settings

↑ Back to top

🎮 Australian Patience

Seven columns of four; build down by suit; Yukon-style grabs.

How to play

1. Build columns DOWN by suit. Yukon-style: tap ANY face-up card to grab it together with every card on top of it, then drop where the grabbed card fits the same-suit card one rank higher.
2. Tap the stock to turn one card to the waste. Build the four foundations UP by suit from Ace to King. Clear all 52 cards to win.

Boosters

Achievements

Reskin slots

background card_back card_face — drop art per slot via Tools > Mini Game Templates > Reskin Editor.

Configurable settings

↑ Back to top

🎮 Spiderette

One-deck Spider; build down any suit; clear same-suit King-to-Ace runs.

How to play

1. Build columns DOWN regardless of suit. Only an in-order SAME-SUIT run lifts as a group. Build a full King-to-Ace run of one suit and it clears to a foundation automatically.
2. When stuck, tap the stock to deal one card to every column (fill empty columns first). Clear all four suit runs to win.

Boosters

Achievements

Reskin slots

background card_back card_face — drop art per slot via Tools > Mini Game Templates > Reskin Editor.

Configurable settings

↑ Back to top

🎮 Will o' the Wisp

Spider variant; seven columns of three face up; clear same-suit K-A runs.

How to play

1. Every card is face up. Build columns DOWN regardless of suit, but only an in-order SAME-SUIT run lifts as a group. A full King-to-Ace suit run clears to a foundation automatically.
2. When stuck, tap the stock to deal one card to every column (fill empty columns first). Clear all four suit runs to win.

Boosters

Achievements

Reskin slots

background card_back card_face — drop art per slot via Tools > Mini Game Templates > Reskin Editor.

Configurable settings

↑ Back to top

🎮 Martha

Aces pre-placed; twelve columns; build down by alt colour, single cards.

How to play

1. The four aces are already on the foundations. Build the twelve columns DOWN by alternating colour, ONE card at a time. Moving a card off a face-down card flips it.
2. Build the foundations UP by suit from Ace to King. Empty columns accept any single card. Clear all 52 cards to win.

Boosters

Achievements

Reskin slots

background card_back card_face — drop art per slot via Tools > Mini Game Templates > Reskin Editor.

Configurable settings

↑ Back to top

🎮 Fortress

Ten columns; tableau builds up OR down by suit; no redeal.

How to play

1. There is no stock. Build the ten columns UP OR DOWN by suit, one card at a time — place a same-suit card one rank higher or one rank lower onto a column top.
2. Build the four foundations UP by suit from Ace to King. Empty columns accept any single card. Plan carefully — there is no redeal. Clear all 52 cards to win.

Boosters

Achievements

Reskin slots

background card_back card_face — drop art per slot via Tools > Mini Game Templates > Reskin Editor.

Configurable settings

↑ Back to top

🎮 Streets and Alleys

Eight columns, no reserve; build down any suit; foundations up by suit.

How to play

1. The whole pack is dealt across eight columns; the aces are NOT pre-placed. Build columns DOWN regardless of suit, one card at a time. Empty columns accept any single card.
2. Free the aces and build the four foundations UP by suit from Ace to King. There is no stock or redeal — plan ahead. Clear all 52 cards to win.

Boosters

Achievements

Reskin slots

background card_back card_face — drop art per slot via Tools > Mini Game Templates > Reskin Editor.

Configurable settings

↑ Back to top

🎮 Chameleon

Canfield variant; reserve + wrapping foundations; build down any suit.

How to play

1. Build the three tableau columns DOWN regardless of suit, wrapping (an Ace goes onto a 2, a King onto an Ace). Only the top of the reserve pile is playable; an emptied column refills from the reserve.
2. Foundations build UP by suit from the dealt base rank and WRAP past the King. Tap the stock to turn cards to the waste (it recycles). Clear all 52 cards to win.

Boosters

Achievements

Reskin slots

background card_back card_face — drop art per slot via Tools > Mini Game Templates > Reskin Editor.

Configurable settings

↑ Back to top

💥 Boosters

Per-game power-ups with persistent counts and refund safety, auto-discovered from each game's <Game>BoosterSpec.cs. The demo dashboard renders them as the bottom booster bar.

Activating a booster

bool OnBoosterActivated(string key) {
    if (_ended || _busy) return false;   // returning false REFUNDS the charge
    switch (key) { /* per-key effects */ }
    return false;                        // unknown key -> refund
}

Award boosters programmatically with BoosterManager.Add(gameId, key, count).

Full booster catalogue

🏆 Achievements

Progression goals per game, defined in <Game>AchievementSpec.cs and tracked persistently by AchievementManager. Unlocks pop a toast card over the game and auto-credit any coin reward. Each game's own goals are listed in its section above.

Reset helpers for testing: AchievementManager.ResetForGame(gameId) and AchievementManager.ResetAll() (also exposed in the demo's cheat rail).

🎨 Reskins

Drop in your own art per slot, per game — no code required. Open Tools > Mini Game Templates > Reskin Editor, pick a game, and assign an image per slot. Art is copied to Resources/Reskin/<gameId>/<slot>.png and imported as a Sprite automatically. In-game, the Skin pill toggles between Default and Custom art.

Per-game slot list

🎯 Tutorials

First-run overlay walkthroughs, defined declaratively in <Game>TutorialSpec.cs as an ordered list of captioned spotlight steps. Each shows once per game's first session and can be replayed from the demo's cheat rail. Reset with TutorialManager.Reset(gameId).

📈 Level scaling

Per-game difficulty progression — auto-generated out of the box, fully editable in the Studio.

int level = LevelManager.GetCurrent(gameId);          // player's current level
var diff  = LevelManager.GetDifficultyForCurrent(gameId);
float mult = diff.Get("difficulty", 1f);              // ramp targets / timers / AI

The Studio's Levels editor can regenerate a curve (level count, start/end difficulty) or hand-edit individual levels; edits are saved as a LevelSet asset under Resources/Config/Levels/<gameId>.asset. Reset progress with LevelManager.ResetProgress(gameId).

🌙 Light & dark mode

One toggle re-themes the whole scene — chrome and every game. Games read every colour from ctx.Theme, a MiniGameTheme asset that carries both palettes:

theme.ApplyMode(light: true);   // swap palettes
bool isLight = theme.IsLightMode;

The demo dashboard's header has a DARK / LIGHT pill; the choice persists between sessions (default: dark). Both palettes are contrast-checked — panel/text/accent pairings stay readable in either mode.

🎁 LiveOps Kit (bundled)

The full HyperCasual LiveOps Kit is included in this pack — no stripping, nothing to buy on top. It provides the production meta-game layer around the games:

How it is hooked up in this demo

• Vibrations: every game's sound events (taps, wins, errors) fire matching haptics through the kit automatically.
• Rewarded ad: winning a round with a coin reward offers a “Watch Ad” doubler; completing the (mock) ad credits the bonus.
• Interstitial: auto-shows after every 3rd round (skipped after a No-Ads purchase).
• Banner + shop: the cheat rail's Ads & IAP section toggles the banner and opens the simulated IAP shop (Coin Pack, No Ads, Starter Bundle) through the kit's store backend.

Setup & going live

1. Everything works out of the box in the editor with mock/dummy backends — no SDKs required, nothing to configure for the demo.
2. Open Tools > HLK > Open Toolset (or Tools > HLK > Guided Setup) to configure ad units, IAP products, notifications, rate-us and the rest.
3. To go live, install the SDKs you want (e.g. AdMob, Unity Ads, Firebase) — the kit detects them automatically via scripting defines (HLK_ADMOB, HLK_UNITY_ADS, HLK_FIREBASE, …) and switches from mock to real backends.

Full kit documentation: Assets/MiniGameTemplates/HyperCasualLiveOpsKit/Documentation/HLK-Documentation.html (also listed under Tools > Mini Game Templates > Welcome > Open Documentation).

➕ Add to your project

Path A — use the bundled demo dashboard

Add Assets/MiniGameTemplates/Demo/MiniGameTemplates_Solitaire4.unity to your build settings. It auto-discovers every imported game and provides the picker, HUD, boosters, achievements and theming out of the box.

Path B — embed a single game in your own UI

IMiniGame game = new WhiteheadGame();
game.Mount(hostRect, context);   // your IMiniGameContext implementation
// ...
game.Unmount();                  // ALWAYS unmount before destroying the host

Listening to events

ctx.Events.Subscribe(GameEvents.RoundWon,     payload => { /* celebrate */ });
ctx.Events.Subscribe(GameEvents.RoundLost,    payload => { /* retry UI  */ });
ctx.Events.Subscribe(GameEvents.ScoreChanged, payload => { /* HUD       */ });

⚙ Customizing

Override default settings

Each game reads a ScriptableObject settings asset (see each game's Configurable settings table above). Create one via Create > Mini Game Templates > Solitaire 4.0, drop it in Resources/Config/, or mutate <Game>Settings.Default at runtime before mounting.

Boosters: add / remove / rebalance

• Remove: delete the BoosterDef from the game's spec.
• Add: append a BoosterDef and handle its key in the game's booster handler.
• Grant: BoosterManager.Add(gameId, key, count).

Audio

Games call ctx.Audio.Play(SfxKind.…). The bundled ProceduralAudioBus synthesizes all SFX at runtime — no audio files to manage; swap in your own IAudioBus to use recorded audio.

🧰 Adding new games

1. Create Assets/MiniGameTemplates/Runtime/Solitaire4/MyGame/.
2. Add MyGameGame.cs implementing IMiniGame, decorated with [MiniGame("…", "My Game", Category = MiniGameCategory.Solitaire4)].
3. Add MyGameSettings (optional) with a static Default getter.
4. Add the spec files — MyGameBoosterSpec, MyGameAchievementSpec, MyGameReskinSpec, MyGameTutorialSpec — all auto-discovered.
5. Done: the dashboard and Studio list your game automatically. No edits to existing files.

💡 Troubleshooting

Text is invisible / fonts look broken

Import TMP Essentials: Window > TextMeshPro > Import TMP Essential Resources. The demo UI uses TextMeshPro's default font.

My game doesn't show up in the dashboard

Check it implements IMiniGame, carries the [MiniGame] attribute, and its assembly references MiniGameTemplates.Core.

A booster button does nothing when pressed

The booster's key must exactly match a case in the game's booster handler — unknown keys refund silently by design.

Tutorials replay every time I press Play in the editor

The "seen" flag is stored per game id in PlayerPrefs; clearing PlayerPrefs resets it. Replay on demand from the cheat rail instead.

Reskin sprites don't apply

Import the art through Tools > Mini Game Templates > Reskin Editor (it handles the copy + import settings), then flip the in-game Skin pill to Custom.

Coroutine errors about destroyed RectTransforms when switching games

Call Unmount() before destroying the host. The unmount path stops the game's coroutines and tweens.

Ads say “SIMULATED” / no real ads show

By design: without an ad SDK installed the kit uses its mock backend, which draws clearly-labelled placeholder ads so every flow is testable. Install a real provider (e.g. AdMob via its package) and the kit switches to it automatically — see the LiveOps Kit section.

Where do I report a bug?

Email satisvizion@gmail.com with your Unity version, target platform, the game id (e.g. solitaire4_whitehead), steps to reproduce, and the console log.

📬 Support & review

Get in touch: satisvizion@gmail.com — bug reports, feature requests, integration help and game requests for future updates are all welcome. Typical response time is 24–48 hours.

Before contacting, it helps to: check Troubleshooting above, open the demo scene to verify the game runs there, and copy any Console errors. Include your Unity version, render pipeline, target platform and the game id.