Skip to main content

Adventures

How to import Adventures.

Overview​

DDB Importer can import D&D Beyond Adventures - these are the scenes and journal entries found in books.

There are two ways to import adventures into Foundry. If you are on v14 you can use the new built in Adventure integration tool right within the browser. If you are on an earlier version it requires the use of another tool called Adventure Muncher, which runs as a standalone product on your computer.

It will allow you to download your D&D Beyond Adventures and transform them into a file which DDB Importer can import.

Things to know​

  • Configuration for things like scene formatting, walls, lights, monster locations, and journal notes are done hand, and the configuration for these is called the meta data. It's available under the Fan Content Policy here, and Adventure Muncher will download the latest version when it starts up.
  • New books are not automatically available and are normally made available 1-2 weeks after the D&D Beyond release and the first pass at some meta data collection has been made.
  • When you import an adventure, it will use the monsters that are in your DDB Monsters compendium (or which ever compendium you have linked in the settings). It uses the unique ID from DDB that is the in the flag data of the imported monster to match the correct one. If the monsters are not in the compendium it will attempt to import them if you support me on Patreon or run your own proxy.

Adventure Completion Status​

You can see the state of scene support at this page.

Method 1: Browser based Muncher

Importing Adventures​

  1. Follow the instructions to get Adventure Muncher installed and generate an adventure file
  2. Once you have your generated adventure file, open the Adventure section of the DDB Muncher.

On the right hand side of Foundry click the Compendium section (looks like a book with a world on it). Then click DDB Muncher.

Muncher Location

Select Munch and then Legacy.

Browser

Click the button to open up the adventure browser.

Adventure Browser

Select the options you need:

  • Import all scenes? If checked it will import all scenes, otherwise it will ask for you to make a choice.
  • Import all monsters to world? If checked it will import any monster referenced in the adventure into the world. Otherwise it will just import monsters placed on scenes in the Meta Data.
  • Add journals/tables to compendiums? If checked it will import any journals and tables into the the DDB Journals and DDB Tables compendiums. This is useful if you wish to import things like the PHB.
  • Compendium only If checked will only write journals and tables to the ddb journals/tables compendium.

Search for the adventure you have access to and click IMPORT.

Wait. Depending on how much content is already in your world it might take a few minutes to import the adventure.

Self hosted proxy support?

This method is not yet supported in the self hosted proxy. Please use the standalone adventure muncher app if you wish to run your own proxy.

Method 2: (Deprecated) Standalone Adventure Muncher App

Importing Adventures​

  1. Follow the instructions to get Adventure Muncher installed and generate an adventure file
  2. Once you have your generated adventure file, open the Adventure section of the DDB Muncher.

On the right hand side of Foundry click the Compendium section (looks like a book with a world on it). Then click DDB Muncher.

Muncher Location

Select Adventures and then Legacy.

Adventure Muncher Screen

  1. Click Import Generated Adventure.
  2. Click the Choose file button and select your chosen adventure.
  3. Select the options you need:
  • Import all scenes? If checked it will import all scenes, otherwise it will ask for you to make a choice.
  • Import all monsters in adventure to world? If checked it will import any monster referenced in the adventure into the world. Otherwise it will just import monsters placed on scenes in the Meta Data.
  • Link journals to world actors? When actors mentioned in journals are clicked it will open the actor. If checked it will open the actor imported into the world. Otherwise it will open the compendium actor.
  • Add journals and tables to compendiums? If checked it will import any journals and tables into the the DDB Journals and DDB Tables compendiums. This is useful if you wish to import things like the PHB.
  1. Click Import Adventure to World.
note

If you select Add Adventure to DDB Compendium DDB Importer will first import the adventure into the world and generate a compendium Adventure type entry in your DDB Adventures Compendium. You probably don't want to do this if you want to run adventures. After upgrades to Foundry/D&D system these may need manually updating by extracting and rebuilding the adventure.

Third Party Adventure Linking

If you own the content on D&D Beyond you can link the monsters and journal pins to a number of third party maps. For this guide we will assume you are using "Tor's Tomb of the Nine Gods" for "Tomb of Annihilation".

  1. Import and activate Foundry modules:
  • D&D Beyond Importer
  • Tor's Tomb of the Nine Gods
  1. Set Up D&D Beyond Importer and Adventure Muncher. There's a useful guide here.
  2. Import the Tor's Tomb of the Nine Gods Scenes into your game so they are present. (Right click on the compendium and import - some modules may use Scene Packer and will pop up a dialogue to install the module - let scene packer do it's thing and import the scenes for you).
  3. Import the Tomb of Annihilation adventure using Adventure Muncher and DDB Importer (see here).
  4. Once imported, once again open DDB Muncher in Foundry, select the Adventures tab and select Enhance Third Party Scenes. Then select Tor's Tomb of the Nine Gods.
  5. Success!

Other great third party maps include Cyrens Dungeon of the Mad Mage