Files
dragonroll/frontend/app/content/docs/02-using-dragonroll/03-maps.md
Gitea OpenCode Agent 5ee7353123
All checks were successful
Test / test (push) Successful in 2s
Fix issue #84: Double click token
2026-10-15 20:44:53 +00:00

2.5 KiB

Maps, pins and tokens

A map is a picture of a place — a dungeon floor, a town, a combat encounter — with a grid laid over it. On top of the picture you can pin the notes that belong to a spot and stand the campaign's characters on its cells.

Creating a map

Maps → New map asks for an image and the grid that goes with it:

Setting What it is
Map image A photo or scan of the map. Uploading a new one replaces it, and leaving it empty keeps the current image
Grid size (px) How wide one grid cell is in the image, in image pixels
Offset X / Offset Y Where the grid starts in the image, so the grid can be lined up with the drawing
Scale How much distance one cell stands for, like 5 feet

The grid size, offsets and scale are what let the app turn a point on the screen into a cell of the map, so a token stands where it should and pins stay put when you zoom.

Looking at a map

Clicking a map in the sidebar anchors it in the place the open notes occupy, and Open in window puts it in a window of its own, which you can drag next to the notes. Once a map is on screen:

  • scroll to zoom towards the cursor, or use the zoom buttons and Fit to window,
  • drag to pan,
  • Show grid turns the grid overlay on and off. The grid is drawn over the image, so its lines stay crisp whatever the zoom.

Pinning notes

Right-click anywhere on a map and pick Pin a note here, then choose the note: a marker appears on that spot, and clicking the marker opens the note. A pinned note can be read straight off the map without hunting for it in the sidebar, which is what makes a town map usable at the table.

Remove pin takes the marker off; the note itself is untouched. Deleting a note that is pinned drops its pins.

Tokens

Drag an actor from the sidebar onto a map and it stands there as a token: it snaps to the centre of the cell you dropped it on and is sized by that cell, so a huge creature can be given more than one cell by sizing it up on the map's settings.

Once a token is on the map you can drag it to another cell, step it across the grid one cell at a time with the arrow keys, and take it off with Delete. Double-clicking a token opens the sheet of the actor it stands for, and Enter does the same on a token focused with the keyboard.

Tokens belong to the map, not to the actor: the same character can stand on several maps, and taking a token off does not remove the character from the campaign.