Back to Guides

Roll20 Integration Guide

Browser Extension Available

Rollsight integrates with Roll20 through a browser extension and API, allowing seamless dice roll transmission to your Roll20 games.

Prerequisites

  • Roll20 account and active game
  • Rollsight software installed and running
  • Chrome, Firefox, or Edge browser
  • Rollsight browser extension installed

Step 1: Install Browser Extension

Chrome/Edge

  1. Download the Rollsight extension from the Chrome Web Store (or extension package)
  2. Open Chrome/Edge and go to chrome://extensions
  3. Enable "Developer mode" (toggle in top right)
  4. Click "Load unpacked" and select the extension folder
  5. Extension should appear in your extensions list

Firefox

  1. Download the Rollsight extension package
  2. Open Firefox and go to about:debugging
  3. Click "This Firefox"
  4. Click "Load Temporary Add-on"
  5. Select the extension's manifest.json file

Step 2: Configure Extension

  1. Click the Rollsight extension icon in your browser toolbar
  2. Enter the Rollsight bridge server URL (default: http://localhost:8765)
  3. Click "Connect"
  4. Verify connection status shows "Connected"
Connected: The extension icon should show a green indicator when connected.

Step 3: Start Rollsight Bridge Server

  1. Launch Rollsight software
  2. Go to Settings → VTT Integration
  3. Enable "Browser Bridge" or "Roll20 Integration"
  4. Note the bridge server port (default: 8765)
  5. Bridge server starts automatically when enabled

Note: The bridge server must be running for the extension to work. It runs automatically when Rollsight is open.

Step 4: Connect to Roll20

  1. Open your Roll20 game in the browser
  2. Click the Rollsight extension icon
  3. Click "Connect to Roll20" or "Enable for this page"
  4. Extension should detect Roll20 and show "Ready" status
  5. You're now connected!

Step 5: Test the Integration

  1. Place a die in your dice tray
  2. Roll the die in Rollsight
  3. Check Roll20 chat - you should see the roll appear automatically
  4. Roll should be attributed to your character
  5. Test with different dice types

Features

Automatic Roll Transmission

Physical dice rolls automatically appear in Roll20 chat. Works with all dice types.

Macro Support

Can be integrated with Roll20 macros for automated roll handling.

API Integration

Advanced users can use Roll20 API for custom integrations and automation.

Roll Corrections

When you correct a roll in Rollsight, Roll20 chat updates automatically.

Troubleshooting

Extension not connecting

  • Verify Rollsight is running
  • Check bridge server is enabled in Rollsight settings
  • Verify bridge server URL in extension matches Rollsight
  • Check browser console for errors (F12)
  • Try reloading the Roll20 page

Rolls not appearing in Roll20

  • Check extension is connected (green indicator)
  • Verify extension is enabled for Roll20 page
  • Check Roll20 console for errors
  • Ensure you're logged into Roll20
  • Try disconnecting and reconnecting extension

Bridge server errors

  • Check port 8765 is not in use by another application
  • Verify firewall allows connections on bridge port
  • Restart Rollsight to restart bridge server
  • Check Rollsight logs for bridge server errors

Next Steps

  • Train your dice in Rollsight
  • Test various dice types and formulas
  • Configure macro integration if desired
  • Enjoy physical dice in Roll20!