All docs

Discord API setup

DungeonJam streams audio into a Discord voice channel using a bot account that you control. Follow these steps to create the bot and connect it to the app.

  1. 1

    Create a Discord application

    Go to the Discord Developer Portal and click "New Application". Give it a name, e.g. "DungeonJam".

  2. 2

    Add a bot user

    In your application, open the "Bot" tab and click "Add Bot". Disable "Public Bot" if you only plan to use it on your own server.

  3. 3

    Copy the bot token

    On the "Bot" tab, click "Reset Token" (or "View Token") and copy the value. Keep it secret — anyone with this token can control your bot.

  4. 4

    Enable required privileged intents

    Still on the "Bot" tab, enable the "Server Members Intent" and "Message Content Intent" if prompted by DungeonJam.

  5. 5

    Invite the bot to your server

    Open the "OAuth2 → URL Generator" tab, select the "bot" scope, and under bot permissions select "Connect" and "Speak". Copy the generated URL, open it in your browser, and add the bot to your Discord server.

  6. 6

    Add the token to DungeonJam

    In DungeonJam, create a `.env` file next to the application (or use the in-app settings, if available) and set `DISCORD_TOKEN="your-token-here"`. Restart the app so it can connect to Discord.

Security note: Never share your bot token or commit it to source control. Treat it like a password — anyone who has it can act as your bot.