Foundry VTT Closed Beta

The module adds a ScryRPG campaign panel and character sheets inside Foundry. Linked characters stay in step with the website in both directions for the supported areas below. Every person connects with their own ScryRPG account.

Back up your world first

This is an early alpha. It can damage a Foundry world. Back up before installation, before updates and before each session. Try it on a copy of your world first.

In Foundry 13, leave your world with Game Settings > Return to Setup. Right-click the world and choose Take Backup. Wait for it to finish. Alternatively, stop Foundry completely and copy the whole world folder from Data/worlds somewhere safe. For hosted worlds, use your host’s backup or export feature and check its restore instructions.

To restore a Foundry backup, return to Setup, open the world’s menu, choose Manage Backups, select the backup from before installation and choose Restore. This replaces the world’s current state; later play in that world is lost. To restore a folder copy, stop Foundry, move the current folder aside and put the saved folder back under Data/worlds.

A world backup restores Foundry, not changes made on the ScryRPG website. Leave the module disabled after restoring while the team helps you check what happened. History undo is for individual changes; a backup is the only complete undo for the world.

Requirements

• Foundry 13 with D&D 5e 5.3.0 through 5.3.x, or Foundry 14 with D&D 5e 5.3.x or 6.0.0 through 6.0.x. Other D&D 5e versions and other systems are outside this beta.
• Open Foundry over HTTPS or on localhost. A plain HTTP address on your home network will not support sign-in.
• The ScryRPG server address must use HTTPS.
• Everyone needs their own ScryRPG account and membership in the same invited party. The Foundry GM must also be that party’s GM on ScryRPG. Access is by party invitation, with no paid-plan requirement.

Two-browser testing used Foundry 13.351 with D&D 5e 5.3.3 and Foundry 14.368 with D&D 5e 6.0.5, in Chromium 152. Foundry 14.368 with D&D 5e 5.3.3 passed separate panel and sheet checks. Other versions and browsers are not yet verified. The menu instructions here use Foundry 13.

Install and enable

After your party is invited:

1. On Foundry’s Setup screen, open Add-on Modules, then Install Module.

2. Paste this address into Manifest URL and click Install:

   https://github.com/bmikk/scryrpg-foundry-releases/releases/latest/download/module.json

3. Launch the world as GM. Open Game Settings > Manage Modules, enable ScryRPG Connected Campaign (Alpha), then choose Save Module Settings and reload.

4. A new world points at ScryRPG by default. Leave the server address alone unless the team asks you to change it. An older world keeps its saved address.

The module is installed by manifest URL, not by searching the package browser. As an alternative, unpack the release zip into Data/modules/scryrpg-foundry so it contains module.json, then restart Foundry or return to Setup.

Back up before updating. Use Update or Update All in Add-on Modules. If the panel asks for a newer module version, sync stops until you update. Changes made in Foundry are kept and sent after the update.

Connect once per person

1. As GM, choose Open ScryRPG Campaign in Game Settings.
2. Open Account > Connect your ScryRPG account in the panel. Choose Open the ScryRPG website.
3. While signed in to your own account, enter the code shown in Foundry at the connection approval page. Copy copies the code. Approve the connection; the GM connects first and approves the world’s connection to the party.
4. Each player repeats these steps on their own computer with their own account. The GM cannot connect for a player.
5. Open Status, the bell at the top of the panel, and use its Setup section to finish linking characters.

Keep a connected GM in the world while the table plays. Website changes arrive only while that GM has the world open; changes made while the GM is away arrive when the GM returns. On shared computers, sign out from Account when finished. Never share sign-in codes.

Link your characters

For a character that exists only in Foundry, use Create in ScryRPG under Status > Setup. A player doing this for their own character owns it on both sides. If the GM creates it, it belongs to the GM on ScryRPG until offered to the player through Players and characters and accepted by that player.

For a character that exists on ScryRPG, select its partner under Your Foundry character, choose Compare with ScryRPG, then Link it, keeping Foundry’s values to bring the Foundry build across. Use the existing character rather than making another copy.

For a character that exists only on ScryRPG, choose Keep the campaign side with the GM connected. If the full build is unavailable, create an empty Foundry character with the same name and link it using Link it, keeping ScryRPG’s values.

If asked to match items, match each ScryRPG item to its Foundry counterpart or choose Not in Foundry. Review removals and new items, then choose Start character setup. Follow remaining prompts and resolve conflicts. Setup is finished when the panel says Foundry and ScryRPG agree; setup is complete.

What works in the beta

• Inventory: character containers and the Party Stash, including moving and giving items. Choose a destination and quantity, or drag a stack onto a container.
• Coins: Adjust currency (+/−) adds or removes coins. Currency on the character sheet sets exact counts.
• Shops: buy and sell. Set Buying into: to a character container or the Party Stash. Choose Pay with and a quantity in the purchase dialog, then confirm the price.
• Loot: take from revealed piles. GMs can reveal and hide piles. Need-and-greed votes happen on the website.
• Library: browse items and use Add to… to choose a container and quantity.
• Activity: search and filter the party timeline. Open entries in History.
• History: review changes and use Undo where offered.
• Character sheets: Stats, Spells, Inventory, Notes, About and History, with rolls, hit points, spells, rests and equipment.

Use Open on ScryRPG on a character, container, shop, loot pile or the Library for actions the panel does not offer.

Recommended session routine

Create shops and loot on the website, then use them in Foundry. During a session, make changes in Foundry and avoid editing the same character on the website. The connected GM opens the world first and leaves last. Connect each player and link characters before game night.

Level up between sessions using either the sheet’s level-up button or a D&D Beyond re-import, not both for the same level. A website level-up appears as waiting in Foundry. A D&D Beyond re-import updates the build while preserving play values such as coins, items, current HP and spent spell slots. Conditions reset to D&D Beyond’s conditions, usually none; reapply active conditions afterward. Disable D&D Beyond Importer options that send changes back to D&D Beyond for linked characters during this beta.

Known limits

• Conditions do not sync in either direction. Set them in Foundry for play.
• Experience points and spent uses or charges on items and features stay in Foundry.
• Carrying capacity reads Capacity not shown, or Not shown where unavailable. The Take dialog omits unavailable capacity. Loot piles show no total value.
• Create shops and loot on the website. Need-and-greed voting stays there too; the panel’s Open on ScryRPG icon opens the pile.
• Loot placed on the map, journals, lore and encounters are not in this version.

Pause, restore or uninstall

If something looks wrong, pause sync instead of changing both sides by hand. As GM, open Game Settings > Configure Settings, turn on Pause ScryRPG sync and save. You can also use Account > Pause sync in the panel. This stops sending and applying changes; it does not undo earlier ones. Use Resume in Status when ready.

Report the problem in the closed-beta channel where you were invited. Include what happened and roughly when. Hide sign-in codes in any console screenshots.

To stop using the module, disable ScryRPG Connected Campaign (Alpha) under Manage Modules, save and reload. Removing the module leaves its notes, created items and some settings in the world. It does not restore earlier values. Restore your backup if you need the complete Foundry world back.