Skip to content

Import a scene from a map file

If your battle map already has walls and lights baked in — from Dungeondraft, Dungeon Fog, or Foundry VTT — you don’t have to trace them again. Import the file and PostRoll builds the scene for you: walls block sight, doors open and close, and lights glow.

Open Scenes and click Import Scene (next to + Create Scene).

A UVTT file (.dd2vtt or .uvtt) already contains the map picture, so this is fully automatic.

  1. Scenes → Import Scene, then choose your .dd2vtt or .uvtt file.

  2. Check the summary — the scene name, grid size, and how many walls, doors, and lights were found. Rename the scene if you like.

  3. Set Dynamic darkness (see below).

  4. Click Import Scene. The map image comes across with everything else.

Foundry keeps the map picture separate from the file, so you supply the image.

  1. Scenes → Import Scene, then choose the scene file — either a single scene you exported from Foundry (right-click a scene → Export Data), or a module’s scene pack: the file ending in .db inside the module’s packs folder. (You may need to switch the file dialog to All Files to see it.)

  2. If the pack holds several maps, pick the one you want from the Scene list.

  3. Upload the matching map image from the module’s maps folder — or leave it and add the map later in the scene editor.

  4. Set Dynamic darkness and click Import Scene.

Roofs, floors and windows from a Map Foundry battle map

Section titled “Roofs, floors and windows from a Map Foundry battle map”

A battle map exported from the Map Foundry with Roofs: Both brings each building’s roof and upper floors with it. When you import it:

  • Each roof sits over its building. A token that goes inside shows through the roof around it, and the roof lifts for its own player while it’s inside.
  • Each building’s floors are levels: everyone sees the floor their own token stands on, and the walls and doors of that floor are the ones that count. A token on floor 2 sees and moves by floor 2’s walls.
  • As the GM, right-click a building and choose View from floor 2 (or another floor) to look inside it yourself, or Hide its roof from everyone. The Overlay Tiles tool lists every building under Buildings, with All roofs on and All roofs off.
  • Windows let tokens see out (and in), but tokens can’t walk through them.
  • The stairs inside and outside take a token between floors when its move ends on them (see Moving between levels).

A treetops battle map downloads as a zip. Drop the whole zip into Import Scene, and it comes in as one scene with its levels: the forest floor as the map, each height of platforms and the canopy over it, the ladders and stairs between them, and the platforms’ edges as walls that stop a token on that level. The .dd2vtt from inside the zip on its own comes in flat, as another VTT would show it.

A themed battle map (flooded, swamp, lava, ruined) brings its terrain too. Flood water, a swamp’s pools, rubble and lava cracks become difficult terrain, and lava becomes impassable. Change it with the Difficult Terrain tool, as on any other scene.

The summary tells you how many buildings and floors came with the file, and how many squares of terrain.

The Dynamic darkness toggle decides how the scene starts:

  • On — the scene begins dark and the map’s own lights light it up, so players only see what’s in range (great for dungeons).
  • Off — the map stays fully lit. Walls and doors still control what each player can see.

PostRoll picks a sensible default from the file; flip the toggle before importing if you’d rather have the other.