Metaplay Docs

Appearance

Trash Dash Sample Project

A complete sample of how to integrate Metaplay into an existing Unity game.

Overview ​

Trash Dash is a sample project demonstrating how to integrate Metaplay into an existing Unity game. Based on Unity's Trash Dash endless runner sample, this project shows an incremental adoption approach that focuses on quick wins without extensive refactoring.

In game Preview

The complete integrated sample project is available at GitHub, with each integration step implemented as a separate pull request for easy reference.

What's Included ​

The sample demonstrates the following Metaplay features:

  • Segmentation - Creating and managing player segments that update dynamically during gameplay.
  • Over-the-air LiveOps events - Configuring, scheduling and targeting dynamic in-game events from the LiveOps Dashboard.
  • Over-the-air game configs - Building game economy configuration from Google Sheets and delivering updates without client releases.
  • A/B testing of game configs - Running experiments with alternative config values targeted to specific player segments.
  • Rich player state visualization - Custom LiveOps Dashboard components for easier player state browsing.

Dashboard customization

The sample also includes:

  • Local development - All features work locally without external dependencies for productive development.
  • Cloud deployment ready - Prepared for deployment to Metaplay's managed cloud services.
  • Cheat proofing examples - Server-validated shop purchases to demonstrate security best practices.

How to Explore? ​

There are three ways to explore this integration example:

  1. Read the tutorial - Follow the step-by-step tutorial in Integrate Metaplay Into an Existing Game to understand how the sample was built.

  2. Clone, run, and test - Clone the repository and run the sample locally. All steps can be done completely locally and offline, making it easy to interactively explore and experiment with the code.

  3. Repeat/apply in your own project - Use this sample and the accompanying tutorial as a reference to adopt Metaplay SDK in your own game. Adapt the steps to fit your existing project structure.

Setup Instructions ​

To run the Trash Dash sample locally:

Dependencies:

To run the sample:

  • Unity 2022.3.42f1 or later

To run the server:

To run the custom LiveOps Dashboard:

Steps:

  1. Clone the repository: git clone git@github.com:metaplay-shared/trashdash-sample.git
  2. Open the Unity project (located in the repository root)
  3. Initialize the MetaplaySDK: metaplay init sdk --sdk-version=34.2
  4. Run the server: metaplay dev server
  5. The server will start and you can access the dashboard at localhost:5550

Usage in Your Own Project ​

The code in the GitHub repository is provided as an educational example to help you understand how to integrate Metaplay into an existing project. Feel free to use our code as a reference or template for your own integration.

The Trash Dash project belongs to Unity and is not a part of the Metaplay SDK and is not governed by the Metaplay SDK license.