README Template

Please update the following in each of your SDK application.

Introduction / Summary

This boilerplate is meant to give you a simple starting point to build new features in Topia using our Javascript SDK. Please reference the documentation for a more detailed breakdown of what the SDK is capable of and how to use it!

Key Features

Canvas elements & interactions

• Key Asset: When clicked this asset will open the drawer and allow users and admins to start interacting with the app.

Drawer content

• How to play instructions
• Leaderboard
• Admin features (see below)

Admin features

Does your app have special admin functionality? If so your key features may looks something like this:

• Access: Click on the key asset to open the drawer and then select the Admin tab. Any changes you make here will only affect this instance of the application and will not impact other instances dropped in this or other worlds.
• Theme selection: Use the dropdown to select a theme.
• Reset: Click on the Reset button to clear the active game state and rebuild the game board in it's default state.

Themes description

• Winter (default): A snowy theme that when selected will drop snowflakes throughout the scene
• Spring: A garden theme that when selected will drop flowers throughout the scene

Data objects

We use data objects to store information about each implementation of the app per world.

• Key Asset: the data object attached to the dropped key asset will store information related to this specific implementation of the app and would be deleted if the key asset is removed from world. Example data:
  • isResetInProgress
  • lastInteraction
  • lastPlayerTurn
  • playerCount
  • resetCount
  • turnCount
• World: the data object attached to the world will store analytics information for every instance of the app in a given world by keyAssetId and will persist even if a specific instance is removed from world. Example data:
  • gamesPlayedByUser (keyAssets.${assetId}.gamesPlayedByUser.${profileId}.count)
  • gamesWonByUser (keyAssets.${keyAssetId}.gamesWonByUser.${profileId}.count)
  • totalGamesResetCount (keyAssets.${assetId}.totalGamesResetCount)
  • totalGamesWonCount (keyAssets.${assetId}.totalGamesWonCount)

Developers:

Built With

Client

Server

Getting Started

• Clone this repository
• Run npm i in server
• cd client
• Run npm i in client
• cd .. back to server

Add your .env environmental variables

API_KEY=xxxxxxxxxxxxx
INSTANCE_DOMAIN=api.topia.io
INSTANCE_PROTOCOL=https
INTERACTIVE_KEY=xxxxxxxxxxxxx
INTERACTIVE_SECRET=xxxxxxxxxxxxxx

Where to find API_KEY, INTERACTIVE_KEY and INTERACTIVE_SECRET

Topia Dev Account Dashboard

Topia Production Account Dashboard

Helpful links

• SDK Developer docs
• View it in action!
• To see an example of an on canvas turn based game check out TicTacToe:
  • (github))[https://github.com/metaversecloud-com/sdk-tictactoe]
  • (demo))[https://topia.io/tictactoe-prod]

New for June 2025: Multiplayer Experience Engine

Topia has developed a powerful new Experience Engine that enables extremely low-latency, interactive in-canvas multiplayer experiences. This engine is purpose-built for real-time interaction and supports a wide range of dynamic behaviors, making it ideal for collaborative activities, games, and social experiences within Topia worlds.

Key Features

• Ultra Low Latency: Real-time feedback for seamless multi-user interaction and state synchronization.
• Physics & Collision: Includes a robust physics and collision system to support realistic and responsive behaviors.
• Real-Time Interactivity: Supports dynamic responses to user input and environmental changes inside the canvas.
• Optimized for the Web: Engineered to perform smoothly across browser-based environments with minimal resource impact.

SDK Integration: Leverage the SDK inside the Experience Engine to:

• Trigger visual/audio effects based on real-time interactions
• Save and persist spatial data, such as object positions or interaction states

This engine unlocks a whole new layer of interactivity, paving the way for creative, immersive experiences including educational tools, multiplayer games, or collaborative activities.

Get In Touch

To sign up for the experience engine private beta, visit https://topia.io/p/game-engine.