Back to Guides

Foundry VTT Integration Guide

Foundry v12+ for in-context rolls · v10/v11 for chat-only

Rollsight uses Foundry's Manual dice setting. When you set a die type to Manual, Foundry opens a "waiting for dice" dialog. Rollsight captures that dialog and fills it with your physical roll (or you can complete with digital dice). No separate Rollsight option in the dice menu; just choose Manual and the module does the rest.

Manual rolls don't let players cheat

When you allow Manual rolls for your players, every manual roll dialog is handled by the Rollsight module. The player cannot type in a number. They must either:

  • Roll real dice in Rollsight and send the result, or
  • Click Complete with Digital Rolls to use Foundry's built-in random roll.

So enabling Manual for Rollsight does not open the door to fake values. Rollsight captures the dialog and only accepts a Rollsight result or an explicit digital roll.

What you get

Once the module is installed, enabled, and Dice Configuration is set to Manual for the dice you use, here's what happens:

  • In-context rolls (v12+): When you click Roll on an attack, spell, or save (or type /roll 1d20 in chat), Foundry opens a "Roll in Rollsight" style dialog. You roll in the Rollsight app; the result fills in and the roll completes in the same context, with no separate chat line.
  • Chat commands: /roll, /r, /gmroll, /blindroll, /selfroll (and formulas like 1d20, 2d20kh + 5) open the same waiting dialog; Rollsight fills it and the result posts with the correct visibility.
  • Fallback to chat: If no roll is waiting (e.g. you roll in Rollsight without a Foundry prompt open), the roll is sent to chat so it's never lost. You can turn this off in module settings.
  • Initiative: When combat has started and a combatant has no initiative yet, a single d20 from Rollsight can be applied to that combatant's initiative.
  • Complete with digital rolls: In the waiting dialog, players can choose to fill any remaining dice with Foundry's digital RNG instead of rolling more in Rollsight.
  • 3D dice: When a roll is fulfilled or sent to chat, Foundry's 3D dice (or Dice So Nice / dddice) animate if enabled. No extra setup.

Foundry v10/v11 do not have the Manual/fulfillment flow; on those versions, Rollsight rolls go to chat only.

How it works in one sentence

You set dice to Manual in Foundry; when a roll uses that die, Foundry shows a manual-entry dialog. The Rollsight module replaces that with a "Roll in Rollsight" prompt and feeds your physical (or digital) result into Foundry so the roll completes in context.

Prerequisites

  • Foundry VTT (v12+ recommended for in-context rolls; v10/v11 supported for chat-only)
  • Rollsight Integration module installed and enabled in your world (see steps below)

Sending rolls from Rollsight into Foundry (browser extension, bridge, or direct connection) is covered in a separate, universal VTT connection guide. This guide focuses only on setup inside Foundry: installing the module, permissioning, and dice configuration.

Step 1: Install the module

Manifest URL (recommended for The Forge and most hosts)

On The Forge and similar hosts you don't have filesystem access; use the manifest URL so Foundry can install the module directly.

  1. In Foundry, go to Setup → Add-on Modules.
  2. Click Install Module.
  3. In Manifest URL, paste this URL exactly:
    https://raw.githubusercontent.com/smegill/rollsight-integrations/main/rollsight-integration/module.json
  4. Click Install, then close the dialog.

Foundry will fetch the module from the manifest. The module name in the list will be Rollsight Real Dice Reader.

Manual install (self-hosted with file access)

  1. Download the rollsight-integration folder (e.g. from the releases page or clone the repo).
  2. Place it in Foundry's Data/modules/ directory (e.g. Data/modules/rollsight-integration/).
  3. Restart Foundry or reload the world.

Data paths: Windows %localappdata%\FoundryVTT\Data\; macOS ~/Library/Application Support/FoundryVTT/Data/; Linux ~/.local/share/FoundryVTT/Data/ (or your host's path).

Step 2: Enable the module

  1. Open your world in Foundry (as GM).
  2. Go to Settings (gear icon) → Manage Modules.
  3. Find Rollsight Real Dice Reader (or Rollsight Integration) and check the box.
  4. Click Update Modules or close, then reload the world (refresh the browser or use Reload World).

The GM enables the module once; it then runs for all connected clients. On cloud hosts (e.g. The Forge), ensure the module is available to players if you want them to use Rollsight. It usually is by default once the GM enables it.

Step 3: Allow players to use Manual rolls (permissioning)

For Rollsight to work, each player who rolls physically must set their Dice Configuration to Manual for the dice they use. Foundry only shows the Manual option if the player has permission to configure dice. As GM, you need to grant that permission.

Why this step matters

Dice Configuration is per user. If only the GM has access to it, only the GM can set Manual, and only the GM's rolls would wait for Rollsight. Giving players permission to configure dice (and choose Manual) lets each player use Rollsight for their own rolls.

  1. Go to Setup → Game Settings (or Configure Settings), then open the Core or Permission section where player roles are defined.
  2. Find the permission that controls whether players can change Dice Configuration or select Manual Rolls. In Foundry v12 this is often under a "Configure Dice" or "Dice Configuration" capability for the Player (or Trusted Player) role.
  3. Enable that permission for the role(s) that should use Rollsight (e.g. Player, Trusted Player).
  4. On The Forge: In your Forge dashboard, check Game Settings or Player Permissions for anything related to "Dice" or "Manual rolls" and ensure players are allowed to configure dice. If Dice Configuration is GM-only on your host, you may need to enable a Forge-level option so players can access it.

After this, each player can open Setup → Dice Configuration while logged in and set their dice to Manual (see Step 4). You can reassure them: allowing Manual does not allow cheating, because Rollsight captures every manual dialog (see the green callout at the top).

Step 4: Dice Configuration (set to Manual)

For Foundry to wait for Rollsight instead of rolling digitally, each die type that players will roll physically must be set to Manual. The Rollsight module then feeds physical rolls into Foundry's manual-roll flow. This is the main configuration step for in-context rolls.

  1. Each player who will use Rollsight should log in as themselves, open Setup → Dice Configuration (or Game Settings → Configure Dice, depending on version).
  2. For each die they want to roll physically, set the fulfillment method to Manual:
    • d20: attacks, saves, ability checks, initiative
    • d4, d6, d8, d10, d12, d100: set these too if they roll damage or other dice in Rollsight
  3. Leave any die they don't roll physically as Default (digital).
  4. Click Save Changes, then do a full world reload (F5 or refresh).

Tip

There is no separate "Rollsight" option in the dice dropdown. Rollsight works with Foundry's built-in Manual option: when Manual is selected, the Rollsight module intercepts the manual-entry dialog and replaces it with a "Roll in Rollsight" prompt, then feeds the result in.

MidiQoL, Dice So Nice, dddice & other modules

Rollsight plugs into Foundry's standard roll and manual-fulfillment flow. That means it works with the same dialogs and chat messages that other modules use. No special configuration is required for these popular add-ons:

  • MidiQoL: MidiQoL must be set to allow manual (not automatic) rolling. If MidiQoL is set to automatic, it performs the roll itself and never opens Foundry's roll dialog, so the Rollsight pipeline is skipped. In MidiQoL settings, choose manual rolling so that when a player clicks Roll, Foundry opens the "waiting for dice" step and the Rollsight dialog appears. The player who clicks Roll must also have Dice Configuration set to Manual for the relevant dice (e.g. d20 for attacks).
  • Dice So Nice: Rollsight posts rolls through Foundry's normal chat/roll API. If Dice So Nice is enabled for your world, Rollsight rolls will trigger 3D dice animations like any other roll. No extra Dice So Nice configuration.
  • dddice: Same idea. If dddice is handling roll display for your game, Rollsight's rolls are just normal Foundry rolls and will be picked up by dddice. No special dddice settings for Rollsight.

If a specific dialog or module still rolls digitally, that flow may not use Foundry's standard Roll.evaluate() path. In that case, use Fallback to chat (roll in Rollsight and the result appears in chat) or type the roll in chat (e.g. /roll 1d20).

Step 5: Module settings (optional)

In Configure Settings, scroll to Rollsight Integration (or Rollsight Real Dice Reader). Useful options:

  • Replace manual dice dialog with Rollsight: When Foundry opens the manual dice dialog, replace it with a Rollsight prompt (recommended: on).
  • Fallback to chat: When no roll is waiting, send Rollsight rolls to chat (default: on).
  • Debug logging: Turn on to troubleshoot in the browser console (F12).
  • Apply Rollsight rolls to pending initiative: Use a single d20 from Rollsight for initiative when combat has started (default: on).
  • Rollsight Real Dice Reader (this client): Client-side toggle so the player can confirm the module is active for them.

Step 6: Test the integration

Once Rollsight is connected to Foundry (see the general VTT connection guide), you can verify the Foundry-side setup:

  1. Reload the world after enabling the module and setting Dice Configuration (and permissioning).
  2. In chat, type /roll 1d20 and send.
  3. A dialog should appear: "Roll 1d20 in Rollsight…" with a Complete with Digital Rolls button.
  4. Roll a d20 in Rollsight (or click Complete with Digital Rolls); the result should fill in and the roll post to chat.
  5. Try an attack or save from a character sheet (or MidiQoL); the same Rollsight dialog should appear and the roll should complete in context.

If the dialog appears and rolls complete as above, your Foundry setup is correct. Each player who uses Rollsight needs their own Dice Configuration set to Manual for the dice they roll (and a Rollsight connection as per the general guide).

Troubleshooting

Manual not available or greyed out in Dice Configuration

  • The GM must give players permission to configure dice / use Manual rolls (Step 3). Check Game Settings or your host's Player Permissions.
  • Use Foundry v12+ for Dice Configuration and the manual-fulfillment flow.
  • Ensure Rollsight Real Dice Reader is enabled in Manage Modules and you've reloaded the world.

Foundry rolls digitally instead of waiting

  • Dice Configuration is per user. The player who rolls must open Setup → Dice Configuration as that player, set the die (e.g. d20) to Manual, Save, and reload.
  • If Manual is greyed out: enable the "Configure Dice" / Manual-rolls permission for that player's role (Step 3).

Rolls not appearing in Foundry

  • Rolls must reach Foundry via your VTT connection (browser extension, bridge, or direct). See the general VTT connection guide for setup.
  • Enable Debug logging in Configure Settings → Rollsight Integration, reload, then check the browser console (F12) when you roll to see where the pipeline might be failing.

Dialog doesn't appear for /roll 1d20

  • Confirm Dice Configuration has Manual for that die for the user who is rolling, and you've saved and reloaded.
  • Foundry v12+ is required for the "wait for Rollsight" flow; on v10/v11, rolls go to chat only.

MidiQoL or other dialog rolls digitally

  • MidiQoL must use manual rolling, not automatic. If MidiQoL is set to automatic, it rolls digitally and never opens the Rollsight pipeline. In MidiQoL settings, enable manual rolling so Foundry opens the roll dialog.
  • The player who clicks Roll must have Setup → Dice Configuration set to Manual for the relevant dice (e.g. d20), then Save and reload.
  • If it still rolls digitally, that dialog may not use Foundry's standard roll path; use Fallback to chat or type the formula in chat (e.g. /roll 1d20).

Next steps

  • Remind players to set Dice Configuration to Manual for the dice they use (d20, d6, etc.) and that Manual + Rollsight does not allow cheating. Rollsight captures the dialog.
  • Point players to the general VTT connection guide so they can connect Rollsight to Foundry from their own machine.