Back to Guides

Discord Integration Guide

Bot Integration

Share your physical dice rolls directly in Discord channels. Perfect for voice chat games and community servers.

Prerequisites

  • Discord account and server access
  • Rollsight software installed and running
  • Discord bot token (for bot integration)
  • Permission to add bots to your Discord server

Step 1: Create Discord Bot

  1. Go to Discord Developer Portal
  2. Click New Application
  3. Name it "Rollsight" or your preferred name
  4. Go to Bot section
  5. Click Add Bot
  6. Copy the bot token (keep this secret!)

Security: Never share your bot token publicly. Store it securely.

Step 2: Configure Bot Permissions

  1. In Bot section, enable required permissions:
    • Send Messages
    • Embed Links
    • Read Message History
  2. Go to OAuth2 → URL Generator
  3. Select bot scope
  4. Select the permissions above
  5. Copy the generated URL

Step 3: Add Bot to Server

  1. Open the generated OAuth2 URL in your browser
  2. Select your Discord server
  3. Click Authorize
  4. Complete any CAPTCHA if prompted
  5. Bot should now appear in your server member list
Success: The bot should appear offline in your server. This is normal until configured.

Step 4: Configure Rollsight

  1. Launch Rollsight software
  2. Go to Settings → VTT Integration
  3. Select Discord as your integration
  4. Enter your Discord bot token
  5. Enter Discord server ID (right-click server → Copy ID)
  6. Enter channel ID where rolls should be posted (right-click channel → Copy ID)
  7. Click Connect
Note: You need Developer Mode enabled in Discord to copy IDs. Enable in User Settings → Advanced → Developer Mode.

Step 5: Test Integration

  1. Place a die in your dice tray
  2. Roll the die in Rollsight
  3. Check the configured Discord channel
  4. You should see a formatted roll message from the bot
  5. Test with different dice types

Features

Channel Messages

Rolls appear as formatted messages in your Discord channel, showing dice breakdown and totals.

Roll Formatting

Rolls are formatted clearly with dice types, individual results, and totals.

Easy Setup

Once configured, rolls automatically post to Discord - no manual input needed.

Voice Chat Games

Perfect for games played over Discord voice chat - everyone sees your physical rolls.

Troubleshooting

Bot not responding

  • Verify bot token is correct
  • Check bot is added to server
  • Ensure bot has required permissions
  • Check Rollsight connection status
  • Verify channel ID is correct

Rolls not appearing

  • Check bot has permission to send messages in channel
  • Verify channel ID is correct
  • Check Rollsight logs for errors
  • Test bot manually (send a test message)

Next Steps

  • Train your dice in Rollsight
  • Test various dice types and formulas
  • Share your Discord server with players
  • Enjoy physical dice in your Discord games!