Back to Guides

Foundry VTT Integration Guide

Full Integration Available

Rollsight integrates seamlessly with Foundry VTT, providing automatic dice roll transmission, chat messages, 3D dice animations, and roll requests.

Prerequisites

  • Foundry VTT installed and running
  • Rollsight software installed and running
  • Rollsight Integration module installed in Foundry
  • Both applications on the same computer (or network access configured)

Step 1: Install Rollsight Integration Module

Method 1: Module Manifest URL

  1. Open Foundry VTT
  2. Go to Setup → Add-on Modules
  3. Click Install Module
  4. Enter the Rollsight Integration module manifest URL
  5. Click Install

Method 2: Manual Installation

  1. Download the Rollsight Integration module
  2. Extract to your Foundry Data/modules/ directory
  3. Restart Foundry VTT

Step 2: Enable the Module

  1. In Foundry, go to Game Settings → Manage Modules
  2. Find Rollsight Integration in the module list
  3. Check the box to enable it
  4. Click Update Modules
  5. Reload the world

Step 3: Configure Connection

In Rollsight

  1. Open Rollsight Settings
  2. Go to VTT Integration section
  3. Select Foundry VTT as your integration
  4. Enter Foundry URL (default: http://localhost:30000)
  5. Click Connect

In Foundry

  1. The module will automatically connect when Rollsight is running
  2. Check module settings for connection status
  3. Verify connection in module settings panel
Connected: When connected, you'll see a status indicator in both applications.

Step 4: Test the Integration

  1. Place a die in your dice tray
  2. Roll the die in Rollsight
  3. Check Foundry chat - you should see the roll appear automatically
  4. If 3D dice are enabled, you should see dice animation
  5. Roll should be attributed to your user

Features

Automatic Roll Transmission

Dice rolls in Rollsight automatically appear in Foundry chat. No manual input needed!

3D Dice Animations

Physical rolls trigger Foundry's 3D dice animations for visual feedback.

Roll Requests

Foundry can request rolls from Rollsight (e.g., for spells, attacks) via module API.

Roll Corrections

When you correct a roll in Rollsight, the Foundry chat message updates automatically.

Advanced Configuration

Network Setup (Remote Access)

If Foundry is running on a different computer:

  1. Ensure Foundry is accessible on your network
  2. In Rollsight, enter Foundry's network IP address instead of localhost
  3. Format: http://192.168.1.XXX:30000
  4. Verify firewall allows the connection

Roll Formatting

Customize how rolls appear in Foundry chat:

  • Module settings allow customization of roll message format
  • Can include dice breakdown, modifiers, totals
  • Supports Foundry's roll formatting syntax

Troubleshooting

"Not connected to Rollsight"

  • Ensure Rollsight is running
  • Check that Rollsight is configured to connect to Foundry
  • Verify Foundry URL in Rollsight settings
  • Check Foundry console (F12) for connection errors
  • Try restarting both applications

Rolls not appearing in chat

  • Check module is enabled in Foundry
  • Verify connection status in module settings
  • Check Foundry console for errors
  • Ensure you're logged in as a user (not just GM)
  • Test with a simple roll first

3D dice not animating

  • Check that 3D dice are enabled in Foundry settings
  • Verify module is sending dice animation triggers
  • Try disabling and re-enabling 3D dice

Next Steps

  • Train your dice in Rollsight
  • Test various dice types and rolls
  • Configure roll formatting preferences
  • Enjoy seamless physical dice in Foundry!