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