# 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.