This guide covers the creation of a Telegram Game using Sequence’s Unity SDK.
This guide will walk you through setting up your Telegram Mini-app or game using Sequence’s Unity SDK, enabling web3 functionality on EVM chains for your users, for email and guest authentication methods.
We’ll develop the game logic in Unity, but to deploy it as a Telegram Mini-Game, we’ll package the WebGL build within a React project.
Create a Telegram Bot with BotFather
/start
/newbot
Obtain Required Tokens
After creating your bot, BotFather will provide:
Save these credentials - you’ll need them for the next steps.
Install Sequence's Unity SDK
Use one of our recommend installation options for your existing project or use our Unity Boilerplate if you want to start a project from scratch.
UI for Mobile Layouts
Ensure that your game’s UI is optimized for mobile aspect ratios. We recommend using the Device Simulator for Unity. Additionally, ensure your input handling is set up for touch controls.
Configure Sequence's React Template for WebGL
Sequence’s Unity SDK includes a WebGL Template for exporting as a React project.
Copy the WebGLTemplates
folder from Packages/Sequence Embedded Wallet SDK/
into your project’s Assets/
directory.
Go to Project Settings
-> Player
-> WebGL
-> Resolution and Presentation
and select the SequenceReact
template.
Cloudflare Configuration
Inside the React project’s root directory, create a wrangler.toml
file and include the following content.
Build your WebGL game as a React project
Open the root directory of your React project in a CLI or an IDE like Visual Studio Code, and run the following command to test your game in the browser.
Authenticate with Cloudflare Account
From the React project’s root directory, deploy the app and functions logic to Cloudflare.
pnpm wrangler pages deploy
This will prompt you to authenticate with Cloudflare if not already logged in. On successful deploy, copy the URL where your application is now hosted.
Register Webhook with Telegram
Now we call our registerWebhook
endpoint on our app to register the webhook function with the URL of your deployed
application to enable access for the Telegram API.
Update Allowed Origins
Ensure in Sequence Builder that your wallet configuration includes the URL of your deployed application as an allowed origin.
Send a message to your bot on Telegram and check if it responds! It should answer you with the ability to share, play or get more information about the bot.