Svelcordity is a template repository with a simple setup for integrating your Discord Activity with SvelteKit. This project utilizes a Unity WebGL build to display your Discord activity seamlessly. As an example, a roguelike game built with Unity is included in this template.
Text guide not your cup of tea? Try the video tutorial! :)
- Easy integration of Discord Activity with SvelteKit
- Unity WebGL build for interactive content
- Minimal setup and configuration required
- Includes a sample roguelike game built with Unity
- Unity Editor
- Node.js
- npm (Node Package Manager)
- GitHub Desktop (optional, but recommended for easier repository management)
To get started with Svelcordity, follow these steps:
-
Click the "Use this template" button on the GitHub repository page to create a new repository based on this template.
-
Clone your newly created repository using GitHub Desktop or the command line:
git clone https://github.com/yourusername/your-repo-name.git
-
Navigate to the project directory:
cd your-repo-name
-
Install the dependencies:
npm install
-
Create a
.env
file in the root directory of the project and add your Discord application'sCLIENT_ID
andCLIENT_SECRET
for server-side authentication:CLIENT_ID=your_client_id CLIENT_SECRET=your_client_secret
-
Open your Unity project and select the WebGL platform.
-
Set the WebGL Template to Minimal:
- Go to Edit -> Project Settings -> Player -> Resolution and Presentation
- Click Minimal under WebGL Template.
-
Build your Unity project and locate the generated
Build
folder.
-
Open your project's
lib
folder and set up your configuration file (config.ts
) with the necessary details. -
Copy the Unity
Build
folder you generated earlier and paste it into this project'sstatic
folder.
-
Run the development server to test the project:
npm run dev
-
Open your browser and visit
https://localhost:5173
to see your Discord Activity in action. -
When you're ready to deploy, build the project:
npm run build
Note: In the
svelte.config.js
file, make sure to replaceadapter: adapter()
with an adapter of your choice, depending on your deployment platform. SvelteKit offers various official and community adapters for different platforms.For example, if you want to use the
@sveltejs/adapter-node
adapter for deploying to platforms that support Node.js (e.g., AWS, Azure, Heroku), you would modify yoursvelte.config.js
file like this:// svelte.config.js import { vitePreprocess } from "@sveltejs/kit/vite"; import adapter from "@sveltejs/adapter-node"; const config = { preprocess: vitePreprocess(), kit: { adapter: adapter(), }, }; export default config;
Make sure to install the corresponding adapter package. For example, if using
@sveltejs/adapter-node
:npm install @sveltejs/adapter-node
Don't forget to remove
@sveltejs/adapter-auto
frompackage.json
if you're using a specific adapter!You can explore other official and community adapters in the SvelteKit documentation to find the one that suits your deployment needs.
-
Deploy the built files to your chosen platform if you want to share your Discord Activity with others (Discord Proxy).
-
Enjoy your Discord Activity powered by SvelteKit and Unity WebGL!
Remember to choose an adapter that matches your deployment platform and follow the specific deployment instructions for that platform.
This template includes a sample roguelike game built with Unity to demonstrate how to integrate a Unity WebGL build with SvelteKit. The game files are in the static/Build
folder.
Feel free to replace the example game with your Unity WebGL build to showcase your Discord Activity.
Contributions are welcome! If you find any bugs or have suggestions for improvement, please open an issue or submit a pull request.
This project is licensed under the MIT License.
In the words of Todd Howard, it just works.