Back to Guides

Discord Integration Guide

Available in the RollSight desktop app

Open Connections → Connect dice, choose Discord, then Connect. If no channel is saved, RollSight opens Discord in your browser so you can authorize and choose one. You can also enter an existing webhook or bot in Discord details. Rolls go to Discord while that connection is active.

Avrae and physical dice

Avrae does not expose an API for injecting rolls from outside. RollSight posts next to Avrae in the same channel so your table sees bot automation and physical dice together.

Two ways to post

The in-app channel picker is the easiest way to create a webhook connection. Manual webhook and bot settings are available in Discord details; those settings are saved when you connect.

Incoming webhook

  • Recommended: choose Discord in Connect dice, then choose Connect.
  • No bot to host or invite; Discord shows the webhook name/avatar on messages.
  • Good for a fixed play channel.

Bot token + channel

  • Your own application; posts appear as your bot.
  • You can add multiple channel IDs (one per line in the extra field) for different games.
  • Requires server permission to add the bot and correct channel permissions.

Prerequisites

  • RollSight desktop app installed and updated
  • A Discord server and permission to authorize a channel webhook, or an existing webhook or bot
  • Developer Mode in Discord if you need to copy IDs: User Settings → App Settings → Advanced → Developer Mode

Option A: Incoming webhook

Recommended: Connect dice → Discord

Open Connect dice, choose Discord, then Connect. If no channel is saved, choose one in the Discord browser window; the session starts when you return to RollSight. The webhook URL is transferred securely to the app.

Manual option: create a webhook and paste its URL using the steps below.

  1. Open your Discord server and go to the target text channel.
  2. Channel menu (Edit Channel) → Integrations → Webhooks → New Webhook (or use an existing one).
  3. Copy the Webhook URL. Treat it like a password; anyone with the URL can post as that webhook.
  4. In RollSight, open Connections → Connect dice, choose Discord, turn on Send rolls to Discord for this session, choose Webhook in Discord details, and paste the URL.
  5. Choose Connect, then roll physical dice and check the selected channel for the result.

You can paste additional webhook URLs (one per line) in the extra webhooks field. If you save more than one, the session flow asks which destination should receive rolls. Discord does not tell RollSight which channel you have focused in the client.

Option B: Bot

  1. At Discord Developer Portal, create an application and add a Bot.
  2. Under Bot, copy the token and keep it private. Reset it if it leaks.
  3. Under OAuth2 → URL Generator: scope bot. Permissions: at minimum Send Messages and Embed Links (embeds are optional in RollSight but common). Open the generated URL, pick your server, and authorize.
  4. Get the channel ID: right-click the channel → Copy Channel ID (Developer Mode on), or paste a channel URL like https://discord.com/channels/<server>/<channel>. RollSight can parse the IDs from the link.
  5. In RollSight, open Connections → Connect dice → Discord, turn on sending, choose Bot in Discord details, and paste the token and channel (and server ID if needed).
  6. Choose Connect to start sending physical rolls to the selected channel.

Security: Never commit tokens or webhook URLs to public repos or stream them on screen. If exposed, rotate the webhook or reset the bot token immediately.

RollSight settings (reference)

Open Connections → Connect dice → Discord for the active destination. More options are under Settings → Connections. You can:

  • Open this guide in your browser via the in-app link or Help → Discord setup guide.
  • Toggle Send rolls to Discord for this session and choose webhook vs bot.
  • Optional display name, embed vs plain text, and roll proof / replay options if you use those features.
  • Use Test connection to verify credentials without rolling (webhook mode can post a test to each configured URL).

Play session flow

  • Saving a destination does not send dice. Connect to Discord when you want to start sending rolls.
  • Open Connections → Connect dice, select Discord, and choose Connect. Select the intended channel if more than one is saved.
  • If multiple webhooks or bot channels are saved, the session UI lets you pick which one is active for that session.
  • Choose Connections → Disconnect when you are done so rolls are not sent unintentionally.

Message format

With embed style, RollSight sends a compact summary (formula, dice, total, natural 20 / 1 notes when relevant). With embeds off, the same information is sent as plain text. If roll proof / replay is enabled and a clip URL is available, the message can include a replay link.

Troubleshooting

Nothing posts to Discord

  • Confirm Discord is selected and connected in Connect dice.
  • Confirm Send rolls to Discord for this session is on.
  • Run Test connection from Discord details.
  • Webhook: URL must be the full discord.com/api/webhooks/… link.
  • Bot: bot is in the server and has Send Messages (and Embed Links if using embeds) in that channel.

Wrong channel or duplicate targets

  • With multiple webhooks or channels saved, choose the active target when you create the session.
  • Re-copy channel IDs or webhook URLs if you moved channels or regenerated a webhook.

HTTP errors or rate limits

  • Discord may briefly rate-limit bots; RollSight retries in some cases. Space out rapid tests.
  • 401/403 usually means a bad token, wrong bot invite, or missing channel permissions.

Checklist

  • Discord channel authorized, or webhook URL or bot token + channel entered in Discord details
  • Connections → Connect dice → Discord → Connect while you play
  • Test connection passes, then roll a die in RollSight
Discord Integration Guide