Maps and locations

Maps in Skryrún are interactive image canvases. Upload any image, place tokens anywhere on it, link tokens to entities, and control which players can see which tokens.

Uploading a map

Open your world and click Maps in the sidebar.
Click + New Map.
Upload an image file (PNG, JPG, or WebP).
Give the map a name.
Click Create.

You can have multiple maps per world — continent overview, regional map, city district, dungeon floors, individual rooms. There's no limit on map count.

The map canvas

The map opens in a pan/zoom canvas:

Scroll to zoom in and out
Click and drag on empty space to pan
Right-click anywhere on the map to open the token placement menu, or use the Add Token button in the toolbar

Tokens

Tokens are markers placed on the map. Each token can link to an entity, so clicking the token in player view navigates directly to that entity's article (if the player has visibility access).

Token properties

Property	Options
Label	Display name shown under the token
Description	Short text shown in the token tooltip
Icon	20 presets (castle, skull, sword, tavern, etc.) or custom uploaded image
Color	Color picker — applied to the icon and label
Size	sm / md / lg / xl
Linked entity	Any entity in your world
Animated	Pulsing glow effect — draws attention to key locations

Token visibility tiers

Every token has its own visibility setting, independent of its linked entity:

Tier	Who sees this token
gm_only	Only you — invisible to all players
campaign_player	Players invited to the campaign
session_guest	Anyone with a session guest link
public	Anyone who can view the world portal

⚠️Warning

A token's visibility and its linked entity's visibility are separate settings. A campaign_player token that links to a gm_only entity will show the token on the map but block access to the entity article. Set both intentionally.

Previewing player view

Use the Visibility Filter toggle in the map toolbar to preview what each tier sees. Switch between gm_only, campaign_player, session_guest, and public to confirm that secret tokens are actually hidden before you share the map link.

Multiple maps per world

Each map is independent. Use them for:

Different geographic scales (world → region → city → building)
Different dungeon floors (Level 1, Level 2, Level 3)
Different time periods (the city before the siege, after the siege)
Player-facing and GM-only versions of the same area

The MapEmbed component

Insert a map inline in any entity article using the MapEmbed component from the editor's Insert menu. The embedded map renders as an interactive miniature canvas — players can pan and zoom it within the article. Useful for embedding a district map on a city entity's article, or a floor plan on a dungeon entity.

💡Tip

Link your location entities to their corresponding map tokens. That way, the entity's mini-graph shows the map connection, and players navigating through entity links can jump to the relevant map.

Troubleshooting

My map image uploaded but looks blurry. The map canvas scales the image to fit the viewport on load. Zoom in with scroll or pinch — the image renders at full resolution as you zoom. If the image appears blurry even fully zoomed in, the source file may be low resolution. Re-upload a higher-resolution version from the map settings.

A token is visible to me but not to players. Check the token's visibility tier — it may be set to gm_only. Open the token's edit panel and change the visibility tier to campaign_player or session_guest as appropriate. Also confirm the player has an accepted campaign invite; players with pending invites don't see campaign_player tokens.

Players can see a token but clicking it gives an "access denied" error. The token's visibility tier allows the player to see the marker, but the linked entity is set to GM Only. Either reveal the linked entity (set it to Party) or remove the entity link from the token until you're ready to reveal it.

I embedded a map in an entity article but players just see a blank box. The MapEmbed component only renders the map if the player has access to the map itself. If the map hasn't been shared with the campaign (no campaign_player tokens and no explicit portal share), players see an empty frame. Add at least one campaign_player token to the map to make it accessible.