Tabletop roleplaying games often require note-taking for specific objects in a scene, or landmarks on a map. Foundry Virtual Tabletop supports the use of placing journal entries on the map to serve as map notes. This article will familiarize you with the process of creating map notes, editing existing map notes, and how permissions for journal entries determine visibility of map notes.

Creating Map Notes

To create a map note, take the following steps:

  1. Create a Journal Entry in the Journal Entries sidebar.
  2. Drag the created journal entry from the sidebar onto the scene to create the Map Note.

A dialog window should appear, allowing you to configure the note before it is placed.

Map Notes Configuration Menu
An example Map Note and its Map Note Configuration dialog.

Viewing Notes

Map Notes are not always seen straight away - depending on the user's settings, they may only appear while the Journal Notes button is selected in the scene control toolbar. If you wish to see available map notes on the scene at all times, simply click on the Journal Notes button (bookmark icon) in the scene control toolbar, and click "Toggle Notes Display" (magnifying glass icon). Once enabled, notes will always be visible. This setting isper user- each player is able to turn on and off Map Note visibility.

The visibility of Map Notes are determined by its corresponding Journal Entry - if a player has "Limited" permissions to the Journal Entry, they will be able to see the position of the Map Note pin and its assigned tooltip. The "Limited" permission prevents a user from opening the text of a journal entry, but image journal entries may still be opened. If a Map Note has no Journal Entry associated with it, the note will be visible to all users currently viewing the scene.

If you right click on a Journal Entry in the sidebar, you can conveniently "Jump to Pin" to pan the canvas to its placed Note location.

Deleting Notes

A Map Note can be deleted from a Scene by a Gamemaster by mousing over the note and pressing the Delete key. Alternatively, all Map Notes on the current scene can be deleted by clicking the Map Notes button (bookmark icon) in the scene control toolbar, and clicking "Clear Notes" (trash can icon).

Deleting a placed object like a Map Note will not delete the Journal Entry that it refers to.

Configuring Notes

Map Notes - Config Screen
An example Map Note and its Configuration dialog which is opened by double right-clicking on the control icon.

A Map Note can be configured again by double right-clicking it. The details of each configuration option are listed below:

Journal Entry:
The Journal Entry assigned to the Map Note. Double clicking the Map Note will bring up the Journal Entry.
Text Label:
The label the Map Note will display when moused over. If left empty, the label will default to the name of the Journal Entry.
The coordinates for the Map Note on the scene. It is worth noting The Map Note can still be dragged and relocated after placing, making these fields more suitable for fine-tuning the placement of pins.
Entry Icon:
The display icon for the Map Note.
Icon Size:
The size of the Map Note's icon on the Scene. This is equal to the length of one side of the icon, in pixels.
Icon Tint:
The tint color of the Entry Icon. Empty by default.
Font Family:
The font which will be used to display the text of this note. Signika by default.
Font Size:
The font size of the Text Label entered.
Text Color:
The color of the Text Label. A text stroke will automatically be added in contrast to the color chosen to ensure visibility.
Text Anchor Point:
The placement of the Text Label relative to the Map Note itself.

API References

To interact with Map Note objects programmatically, you will primarily use the following API concepts: