Importing a Dungeon Flow Export into Foundry VTT

Dungeon Flow exports a Foundry-ready zip that contains a scene JSON file and a map image. The JSON includes walls and grid settings, but it does not set the background image so you can choose where the PNG lives in your Foundry file storage.

Before You Start

• Foundry export currently requires Foundry v13.
• Unzip the export file so you can access the scene JSON and PNG.

Step-by-Step Import

1. Create a new scene in the Foundry Scenes directory.
2. Import the scene JSON:
   • Right-click the new scene and choose Import Data.
   • Select the *-scene.json file from the unzipped folder.
3. Upload the map image:
   • Open the Scene configuration.
   • Choose a background image and upload the *-foundry.png file.
4. Save the scene and open it. Your walls, grid, and map layout should now match the Dungeon Flow export.

If Players See a Black Screen

Foundry defaults to Global Illumination off, and tokens cannot see without light or vision. Fix it with one of the following:

• Enable Global Illumination in the scene configuration.
• Add light sources on the Lighting layer.
• Confirm token vision (for example, darkvision or a light source).

Foundry documentation:

• Scene settings and Global Illumination
• Lighting layer and adding lights

Extra Tips

• The export includes walls for line-of-sight. If you move the background image, the walls will no longer line up.
• If you need to re-import, keep the same scene and import the JSON again, then update the background image.