Config-driven merge-2 story sample

A merge-2, story-driven Unity sample that uses the core Metaplay systems.

Built by Metaplay team

▶ Play in your browser View on GitHub

Genre: Merge puzzle
Client: Unity
License: Apache-2.0

Core Metaplay features

Economy & IAP
LiveOps events
Game configs
A/B tests
Dashboard extensions

How this merge puzzle sample works

In this Unity game you merge items to move a story forward. You can play it as an interactive demo, with the game and its LiveOps Dashboard running side by side in your browser, so you see your player, configs and events change on the dashboard as you play.

It's the one to start with if you're building a single-player game with a live economy. The item data, the story and the tutorial triggers live in game configs edited in Google Sheets, so designers can change them without a client release. Every merge and purchase is a player action that runs instantly on the device and is checked again on the server, so the economy can't be tampered with, and events, offers and A/B experiments are run from the same dashboard.

Core Metaplay features in the game

A showcase of the core Metaplay features this sample is built around, screen by screen.

What it shows about Metaplay

Each system in the game maps to a Metaplay feature. The label under each card names it and links to its page in the Metaplay docs.

Story and tutorial set up in configs

Items, merge chains, story dialogue and the tutorial are set up in Google Sheets and compiled into game configs. A trigger system in the configs decides what happens when, such as which dialogue plays after a discovery, so designers can change progression without a client release.

Game configs

Server-validated player actions

Every merge, collection and purchase is a player action. It runs straight away on the device, and the server runs the same code to check it, so players get instant feedback and the economy can't be tampered with.

Player actions

Custom LiveOps Dashboard views

The standard LiveOps Dashboard is extended with views of each player's merge board, heroes and inventory, which makes it easier to look into a player's account.

Dashboard extensions

Events and offers for dynamic segments

Events, discounts and in-app purchase offers are scheduled from the LiveOps Dashboard and targeted at dynamic player segments, which players move in and out of as they play.

LiveOps events, offers and segmentation

A/B tests on the economy

The game configs include A/B tests on energy costs, energy regeneration and levelling speed, which are managed from the LiveOps Dashboard.

A/B testing

Explore this sample

Two steps and your coding agent has this sample running locally and can walk you through how it fits together, from the shared game logic to the game configs and the LiveOps Dashboard.

Prefer to run it by hand? The README has the commands.

macOS, with Homebrew

$ brew tap metaplay/homebrew-tap
$ brew install metaplay

Windows, with Scoop

$ scoop bucket add metaplay https://github.com/metaplay/scoop-bucket
$ scoop install metaplay

Linux

$ bash <(curl -sSfL https://metaplay.github.io/cli/install.sh)

02Paste this into your coding agentFrom an empty directory. It clones the sample, installs the Metaplay Agent, runs the game locally and walks you through how it works.
Clone https://github.com/metaplay-shared/orca and run metaplay skills install in that folder to install the Metaplay Agent. Run the game server locally and open the Unity project so I can try it, then walk me through how the sample is put together.