Getting started with VTTA.io

As the tools evolved, some instructions found on the internet or even on my YouTube channel are outdated and not accurate anymore. This primer will help you find the most recent onboarding tutorial in written form. And you will learn how easy it is to import your licensed content into Foundry VTT.

Step 1: Tools and Modules

The following tools are used to import content from D&D Beyond into Foundry VTT:

These three components are the building blocks of the D&D Beyond Integration tool suite. The

Availability

All modules are available by using the Foundry module installer. The Chrome extension is available from the Chrome Webstore.

What you need to do now

  1. Install the Chrome browser extension. You can optionally pin it's icon to be always visible:

Installation of the Chrome browser extension:Pin it to the most often used extensions during imports

  1. Install the Foundry VTT modules. Search for vtta to find the "VTTA D&D Beyond Integration" module. The required dependency "VTTA Core" will be installed automatically for you. Optional: Install "VTTA Tokens", too.

  2. Enable all installed modules: Game Settings > Manage Modules

  3. Optional for Vanilla Foundry users, Required for users of "The Forge": Configure the image-related paths in the VTTA configuration panel. Game Settings > Configure Settings > Module Settings > Find the VTTA Core section and press the Open Configuration button. Forge users need to change these paths to use folders with their Asset Library.

Step 2: Account

You will only need one single account, which is created when you login with your Google account here at vtta.io. Along connections to Patreon and Discord, this account enables you to use the VTTA.io image proxy to download scenes and monster artwork from D&D Beyond and upload them to your Foundry VTT server.

What you need to do now

  1. Use the Google button on the top right to login using your Google credentials. You will be redirected to this page again and the Google button is replaced with your username.

  2. Click on your username, then select "View Profile" in the popup menu.

  3. With the extension installed, the connection is made automatically and a success message appears. That's it!

Account connection:Instead we are looking of a successful connection

  1. Click on the extension's icon in the browser bar to validate that your user is now successfully connected there, too:

Account connection:Instead we are looking of a successful connection

Step 3: Connect Foundry VTT to the extension

In Step 1 I described the responsibilities of all components, but I left out one tiny detail: The Chrome browser extension cannot talk directly to the VTTA D&D Beyond Integration module running inside Foundry VTT. It can inject a content script into your Foundry VTT browser tab and this script is then able to both communicate with the VTTA.io modules and the rest of the Chrome extension.

Injecting the content script to establish communication

Injecting the script is not an automatic process, it requires you to click on the extension icon you pinned to the visible area in Step 1. Requiring a user interaction is a security measure, protecting you from malicious browser extensions that inject all kinds of scripts in all the website you are using, so that is a good thing. Also, the content script is only injected into the currently active, visible browser tab, another security measure.

Keep that in mind

The content script and it's availability makes or breaks the whole communication chain: All imports, all queries, all messages from the extension into Foundry VTT pass through the content script, and without it, communication stops.

To re-inject the content script, repeat the process: Bring your Foundry VTT browser tab to the foreground and click the extension's icon.

What you need to do now

Step 4: Import

Keep that in mind

Chrome limits CPU, memory and bandwidth ressources from background browser tabs, ie. tabs that are not visible to the user to save general computer ressources. This can and will lead to slow imports and even stalling imports, especially during batch imports.

Bring both the D&D Beyond tab and the Foundry VTT in the forground, perferably next to each other to monitor progress during batch imports to avoid this situation.

Having both tabs in the foreground helps enormously

Now it's time to import something! Unobstrusive user interface elements are inserted all over the D&D Beyond websites. You can recognize them by looking out for the VTTA.io icon, e.g. inside monster blocks:

The import button is e.g. placed within a monster block

Keep that in mind

Batch imports always have a starting point: