Discord Activity

Additional setup steps for deploying your Endemic+ Unity integration as a Discord Activity.

When your Unity WebGL build runs inside a Discord Activity, the browser sandbox prevents standard link opening. Endemic+ includes a bridge that routes clickable placement URLs through the Discord Embedded App SDK instead. You need to enable this in the plugin settings.

Open Endemic+ Settings

In the Unity menu bar, go to Tools → EndemicPlus → Settings.

Enable the "Discord Activity" toggle

In the Settings panel, enable the Discord Activity toggle. This tells the plugin to use a JavaScript bridge for opening URLs instead of Unity's default method, which does not work inside Discord's iframe.

The plugin's JavaScript bridge calls a function on your host page to open links through the Discord SDK. You need to register this callback after the Discord Embedded App SDK is initialized.

Add the callback after SDK initialization

In your host page JavaScript, after calling discordSdk.ready(), register the window.endemicOpenUrl callback. This connects the plugin's bridge to Discord's openExternalLink command:

javascript

// Add after discordSdk.ready()
window.endemicOpenUrl = (url) => {
  discordSdk.commands.openExternalLink({ url });
};

User experience

When a player clicks an endemic placement, Discord will show a confirmation modal before opening the link. Players can click "Trust this Domain" to skip the confirmation for that domain in the future.

Discord Activities run inside a sandboxed iframe that blocks external network requests. The Endemic+ plugin needs to reach its API servers for texture downloads, analytics, and other functionality. You need to configure URL Mappings in the Discord Developer Portal and patch them in your host page so these requests go through Discord's proxy.

Add URL Mappings in the Discord Developer Portal

Go to your app in the Discord Developer Portal, navigate to Activities → URL Mappings, and add the following entries:

URL Mappings

Prefix: /endemic-app  →  Target: https://app.adrenalineinteractive.ai
Prefix: /endemic-api  →  Target: https://api.adrenalineinteractive.ai

Patch URL Mappings in your host page

In your host page JavaScript, call patchUrlMappings before Unity loads. This rewrites the plugin's network requests to go through Discord's proxy:

javascript

import { patchUrlMappings } from '@discord/embedded-app-sdk';

// Must run before Unity loads
patchUrlMappings([
  { prefix: '/endemic-app', target: 'app.adrenalineinteractive.ai' },
  { prefix: '/endemic-api', target: 'api.adrenalineinteractive.ai' },
]);

You can also view

Deployment Placement Linking Testing & Preview Mode Troubleshooting

Discord Activity

Enable Discord Activity mode

Register the URL callback in your host page

Add URL Mappings for Endemic+ API domains

Build and deploy as WebGL

You can also view