Maps
A map is a grid, a background, and everything on it.
Creating a map
Map → New Map, or from the campaign's maps list. A new map starts as a textured grid.
Ways to give it a background:
- Upload an image — a battle map you already have.
- Choose a texture and build the space with drawings.
- Generate one with the map generator.
The grid
Getting the grid to line up with an uploaded image is the fiddliest part of setting up a map, and there is a dedicated tool for it.
| Setting | Meaning |
|---|---|
| Grid size | Pixels per grid square (default 140) |
| Grid offset X / Y | Shifts the grid so its lines land on your image's lines |
| Foundation texture scale | How large the base texture tiles are, in grid squares |
Use Adjust Grid ‹verify the exact label› and nudge the offset until the overlay matches the artwork. Get this right before you place tokens — rescaling later moves everything.
If you rescale the grid after drawing, you will be asked whether to rescale the drawings with it.
Layers
Maps have layers, which control draw order and what can be interacted with. Some layers are built in; you can add your own, reorder them, and rename them.
Notes that save time:
- The layer list is displayed in reverse of its internal order — the top of the list is the top of the map, which is what you want, but it means dragging feels inverted if you think in array indices.
- Some layers are protected and cannot be deleted.
- Objects live on a layer; if something is invisible, check whether its layer is hidden or whether you are drawing onto the wrong one.
Camera
| Key | Action |
|---|---|
| W A S D | Pan |
| Q / E | Smooth zoom in / out |
| + / - | Stepped zoom |
| 0 | Reset camera |
Camera position is remembered per map, per device.
Hiding a map from players
A map can be hidden from players while you build it. Hidden maps are visible to the GM only, so you can prepare next week's dungeon in the same campaign everyone is looking at.
Map objects
Objects are scenery: furniture, doors, trees. They are placed like tokens but are not characters and do not act. They come from the Library.
Snapshots
Maps keep a snapshot image used as their thumbnail in lists. It refreshes automatically.
Copying and exporting
- Copy a map from another campaign to reuse it.
- Export a map, which packages it with its tokens and art.
History, undo and restore
Every change to a map — its settings, a token moved, a drawing added, a wall removed — is recorded. ⌘Z / Ctrl+Z undoes the last one and survives a reload; the History button in the palette, right of Undo and Redo, shows the whole list, what each change was, who made it, and lets an editor restore any earlier state.
Deleting
Deleting a map moves it and its tokens, drawings, and shapes to the trash, recoverable for 30 days.