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.

This article covers lore maps — the continent, the city, the dungeon floor plan you point at while describing where the party is. The same canvas also runs tactical play: grid, walls, doors, lighting, fog of war, and dynamic vision are covered in Battlemaps.

Uploading a map

Open your world and click Maps in the sidebar.
Click + New Map.
Pick a source: upload a file, a VTT file, an Inkarnate share link, or a direct media URL.
Give the map a name and a category.
Click Create.

Images can be PNG, JPG, or WebP. Maps can also be looping video — MP4, M4V, or WebM — for rain, torchlight, or moving water beneath everything else on the canvas.

Category	For
World	Continent or world overview
Region	Country, kingdom, biome, or sub-continent
City	Settlement, town, or village street plan
Building	Keep, manor, or temple interior
Dungeon	Interior crawl or multi-level adventure site
Battle	Encounter-scale tactical map

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, or hold Space from any tool
F fits the map to the view
Right-click anywhere on the map to open the token placement menu, or press N for a new token
? opens the full keyboard cheat sheet

The tool rail runs down the side. For lore maps the ones you'll live in are Select V, Label L, Region P, Route R, and Measure M.

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.

Regions, routes, and labels

Beyond tokens, a lore map carries three kinds of drawn geography:

Regions — closed shapes for territories, biomes, and borders. Click each vertex, close on the first one.
Routes — open paths for roads, trade routes, and travel lines. Click waypoints, double-click to finish.
Labels — text placed on the map itself.

Regions and routes carry their own labels, with an optional show-on-hover mode to keep a busy map readable, plus custom stroke patterns and widths so borders, territories, and travel paths read differently at a glance.

Map labels stay anchored to the map and keep a consistent size as you zoom, so they read as part of the cartography rather than floating overlays.

Regions, routes, and labels can all be revealed to players during a live session as the party uncovers them — not just tokens.

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.