Getting started
Discord bot setup
Create the bot, flip on the right intents, invite it, and copy your token.
Create the application and bot
- 1
Open the Developer Portal
Go to the Discord Developer Portal and click New Application.
- 2
Add a bot
Open the Bot tab. Set a name and avatar if you like — this is what players see in Discord.
- 3
Copy the token
Under the bot's username, click Reset Token, then Copy. This is the value you paste into
bot.token. Treat it like a password — anyone with it controls your bot.
Keep your token secret
Never commit it, paste it in a public channel, or share screenshots of config.yml. If it leaks, reset it in the portal.
Enable Privileged Gateway Intents
Still on the Bot tab, scroll to Privileged Gateway Intents and enable:
- Server Members Intent — required for role/group sync, nickname sync, and authorization.
- Message Content Intent — required to read Discord messages for chat sync.
- Presence Intent — optional; only needed if a feature reacts to member presence.
Invite the bot to your server
Under OAuth2 → URL Generator, select the bot scope, choose the permissions below, and open the generated URL to add the bot to your Discord server.
| Permission | Needed for |
|---|---|
| Manage Roles | Role / group sync |
| Manage Nicknames | Nickname sync |
| Manage Webhooks | Webhook chat sync (player-head avatars) |
| Read Messages / View Channels | Reading chat, console, and command channels |
| Send Messages | Posting synced chat, logs, and embeds |
| Embed Links & Attach Files | Rich embeds and interactive item/inventory images |
| Manage Channels | Live stat voice channels and proximity voice |
| Read Message History, Add Reactions, Use External Emojis | Replies, reactions, and emoji handling |
| Ban Members | Ban sync (Discord side) |
Tip
The bot's role must sit above any role it manages in your server's role list, or Discord won't let it assign or remove that role.
Give the bot its token
bot:
# Discord bot token (KEEP SECRET!)
token: YOUR_BOT_TOKEN_HERESave the file and run /ds reload. On success the console logs that the bot logged in. If it doesn't, check Troubleshooting.
Turn on Developer Mode (for channel IDs)
You'll need channel and role IDs throughout the config. In Discord: User Settings → Advanced → Developer Mode. Now right-click any channel, role, or user and choose Copy ID.