Template: Colyseus + Discord Activity (Embedded App SDK)

This Project Template is a starting point for crafting HTML5 multiplayer Discord Activities.

Project Structure

This repository contains the front-end and back-end are separated into two different modules.

• apps/client/ - Has the frontend project, using Pixi.js and Vite
• apps/server/ - Has the backend project, using Colyseus (Node.js)

Environment variables

Both the client and server projects need environment variables configured from your Discord Activity.

• apps/client/.env - Should contain your "OAuth2 → Client ID" under VITE_DISCORD_CLIENT_ID.
• apps/server/.env - Should contain your "OAuth2 → Client ID" under DISCORD_CLIENT_ID and "OAuth2 → Client Secret" under DISCORD_CLIENT_SECRET.

Testing your local Discord Activity

In order to test your Discord Activity locally, you need to expose your local server to the public internet.

We will need to open 3 terminal windows to run the server, client, and the cloudflared tunnel.

1. Start the server

npm run start:server

2. Start the client

npm run start:client

3. Use cloudflared or ngrok for exposing your local server to a public URL (see complete tutorial here).

During development, there's no need to expose the server to the public internet - only the client. Our Vite development server proxies the /colyseus requests to our local server.

npm run cloudflared

You will need to update your Discord Activity's "OAuth2 → Redirect URL" and "URL Mappings → Target" to the URL provided by cloudflared:

Warning

Each time you run cloudflared, it will generate a new URL. Be sure to update your Discord Activity's "OAuth2 → Redirect URL" and "URL Mappings → Target" to the new URL.

(Be sure to complete all the steps listed here to ensure your development setup is working as expected.)

---

Using Colyseus Cloud

When using Colyseus Cloud with Scalability, you must configure the following URL Mappings:

When instantiating the Client SDK, you should do as follows:

• new Client('https://[subdomain].colyseus.cloud')

---

Deploying your Discord Activity

When deploying your Discord Activity, you will generally need to deploy the client and server projects separately, under their own public URLs.

Tip

You can use services like Vercel, Netlify, or Heroku to deploy your client project, and services like Colyseus Cloud, Vultr, AWS, or DigitalOcean to deploy your server project.

You will need to configure your Discord Activity's URLs:

• "OAuth2 → Redirect URL" to point to your deployed client project.
• "URL Mappings → Root Mapping / Target" to point to your deployed client project.
• "URL Mappings → Prefix /colyseus / Target" to point to your deployed server project.

---

Explore More Discord Activities (Open source)

Made a cool Discord Activity? Make a pull-request and contribute to the list below!

• Phaser Discord Multiplayer Games Template - phaserjs/discord-multiplayer-template
• Air Party - tejaboy/airparty_discord (YouTube Tutorial)
• Unity WebGL Multiplayer Tutorial - DotSketched/Discord-Activity-WebGL-Tutorial (YouTube Tutorial)
• Chess-like tactical fps turn based combat game prototype - RaiaN/tactochess
• TypeScript + Colyseus + React - Wave-Play/robo.js
• Discord Typing Race - linkai101/keyboard-derby

Also, check out Creating Discord Games with Phaser which describes the steps required to create a Discord App and get a Phaser game running as a Discord Activity. (For a full multiplayer Phaser + Colyseus check out this repo)

License

MIT