Importing Universal VTT (.dd2vtt) Files

Dungeon Flow can export a Universal VTT file (.dd2vtt) that bundles your map image with grid-aligned wall, door, and supported light-source data. The format was popularized by Dungeondraft and is widely supported through community importers rather than built-in platform features.

This guide explains what the export contains and how to bring a file into common virtual tabletops.

Before You Start

• Universal VTT export requires Dungeon Flow Pro.
• In the editor, open Export → Universal VTT File to download a .dd2vtt file.
• Most platforms need a community extension, module, or API script to read wall and door data. Treat importer support as unofficial and version-dependent.

What the Export Includes

Each .dd2vtt file from Dungeon Flow contains:

• Map image: embedded PNG of your rendered map
• Grid: cell size and map dimensions (pixels_per_grid, map_size)
• Wall line of sight: wall segments for dynamic lighting or fog of war
• Doors: door portals aligned to your map grid
• Lights: lit brazier and torch props exported at their flame positions with an 8-cell range, neutral white color, and shadows enabled

Dungeon Flow writes the file using Universal VTT format 0.3, the same family of .dd2vtt / .uvtt / .df2vtt files used by other map tools. Importer support varies: some tools import walls and doors but ignore the format's light records. Dungeon Flow keeps these gameplay lights neutral because any artistic colored glow is already baked into the map image. Scaling a prop moves its light origin with the artwork but does not change the 8-cell range.

Import Options by Platform

Importer names, install steps, and compatibility can change between VTT versions. The options below are community-maintained unless noted otherwise.

Roll20

Roll20 does not natively read Universal VTT wall data. Many groups use the UniversalVTTImporter API script (Roll20 Pro subscription required).

Typical workflow:

1. Install UniversalVTTImporter from the Roll20 Mod (API) script library.
2. Upload the map image from your .dd2vtt file to the map layer (you may need to choose All Files when browsing).
3. Select the uploaded graphic and run !uvtt in chat, following the script handout instructions.
4. Optionally use the Universal VTT Import Sanitizer to strip the embedded image and upload only wall and door metadata.

References:

• Roll20 Wiki: UniversalVTTImporter
• Universal VTT Import Sanitizer

Foundry VTT

Foundry does not ship native Universal VTT import. The common community option is the Universal Battlemap Importer module.

Typical workflow:

1. Install Universal Battlemap Importer from Foundry's module browser.
2. Use the module's import action and select your .dd2vtt file.
3. Review the created scene's walls, doors, and grid alignment.

Looking for a supported Foundry workflow? The native Dungeon Flow Foundry module pairs your account and imports directly from Dungeon Flow, including re-import after edits. That path does not use .dd2vtt files, but it is the officially supported Foundry integration.

See also: Installing the Dungeon Flow Foundry Module

Owlbear Rodeo

Owlbear Rodeo relies on extensions for Universal VTT import. The Scene Importer extension supports .dd2vtt and .uvtt files.

Typical workflow:

1. Install the Scene Importer extension from its manifest URL.
2. Open Scene Importer in your Owlbear session.
3. Select your .dd2vtt file and choose Create New Scene or Add Walls to Current Scene.

Reference: Scene Importer on GitHub

Fantasy Grounds Unity

Fantasy Grounds Unity includes native Universal VTT import for compatible file types.

Typical workflow:

1. Open the Images window in your campaign.
2. Use the import control and select your .dd2vtt file (or rename to .uvtt if the file picker filters by extension).
3. Place the imported map and confirm wall and door layers in the scene.

Because this is built into Fantasy Grounds Unity, behavior may be more consistent than third-party importers, but you should still verify grid scale and wall alignment after import.

Other Platforms

Other tools (for example Arkenforge, MapTool, or newer VTTs) may accept .dd2vtt / .uvtt files natively or through plugins. Check your platform's documentation or community forums for "Universal VTT" or "dd2vtt" support before relying on a workflow.

Troubleshooting

• Walls or doors are missing: confirm the importer supports format 0.3 and that you selected the full .dd2vtt file, not only the extracted image.
• Grid is misaligned: compare pixels_per_grid in the file with your VTT scene grid settings; some importers let you adjust scale after import.
• File is very large: the export embeds a full PNG. Roll20 users in particular may need the sanitizer linked above before uploading metadata.
• Lights are missing: confirm your importer supports Universal VTT lights; some importers only create walls and doors. You can add or adjust lights manually after import.
• Lighting looks too bright or tinted: Dungeon Flow exports neutral white lights while the map image retains its baked artistic glow. Check whether the importer applied its own default color, intensity, or ambient-light settings.

Related Guides

• Installing the Dungeon Flow Foundry Module: supported Foundry import and re-import
• Using Dungeon Flow with Foundry VTT: pairing, scenes, and common Foundry setup issues