πŸ“ Locations

πŸ‘€ For: Game Masters Β· πŸ’³ Plan: All plans Β· πŸ”„ Updated 2026-10-17

Locations are a first-class entity in Wovenkeep β€” the cities, dungeons, taverns, and landmarks of your world get their own record with a description, private GM notes, hidden secrets, and an image. Once a place exists as a Location, you can link it to anyone and anything and watch it appear in the Story Web automatically.

Locations with two places from the demo: The Rusty Tankard Inn (🀫 GM secret) and Cellar Entrance for all campaigns of the world (🌍 belongs to the world), top right + Location

What it does

A Location is a reusable record that belongs to one campaign β€” or, if you tick For all campaigns of this world, to the whole world, so every campaign in that world can use it. Each one holds a Name, a Description your players can hear, free-form Notes for yourself, a GM secret (never shown to players), and an Image. Locations are not buried inside a scene β€” they live in their own list, so the same place can show up across many scenes, plotlines, and sessions without being re-typed. They also become nodes in the Story Web and can be connected to other entities with Links.

When to use it

  • You have a recurring place β€” a home base, a city, a villain's lair β€” that several scenes refer to
  • You want a private GM secret attached to a place (a hidden door, who really owns the inn) that never leaks to players
  • You are mapping your world and want every important place to show up in the Story Web
  • You want to push an illustration of a location (your own, or a suggestion with AI) to players during a session

Step by step

  1. Open πŸ“ Locations from the left navigation bar in the GM tool.
  2. Click + Location.
  3. Start typing into Name β€” the location is saved the moment you type your first character (see Autosave). There is no separate "Create" button.
  4. Fill in Description, Notes, and the GM secret field. Every field autosaves as you go.
  5. Click βœ“ Done (or just click outside the dialog) to close. Empty drafts are discarded automatically.
  6. To change a location later, click the ✏️ button on its card. To remove one, click βœ•.

πŸ’‘ Tip: If you close the dialog without giving the location a name, Wovenkeep deletes the empty draft for you β€” so you never end up with a list of "Neuer Ort" leftovers from a mis-click.


Locations for the whole world

A capital city, a famous tavern or the villain's fortress often matters in more than one campaign. You don't have to create such a place twice:

  • In the location dialog (new or ✏️ edit), tick 🌍 For all campaigns of this world. All campaigns of this world see this location. Untick it to make the location belong to the current campaign only again.
  • In the Worlds section, open a world: the section πŸ“ Locations of this world lists all world locations, and + Location there creates one directly for the world β€” no campaign needed.

In a campaign's location list, world locations carry the badge 🌍 belongs to the world. If you move a campaign to another world (🌍 Change world), the locations of the old world stay there, and the locations of the new world appear in this campaign. Locations that belong only to the campaign move with it.


The fields

Field Who sees it Use it for
Name Players (if pushed) The place's name
Description Players (if pushed) What the place looks and feels like
Notes GM only Loose prep, reminders, things still in flux
GM secret GM only β€” never shown to players The twist: a hidden passage, the true owner, a trap
Image Players (if pushed) A paste-in image URL, a picture from πŸ—‚οΈ Choose from media, or a suggestion (AI) β€” see below

The GM secret is marked with 🀫 on the location card so you can see at a glance which places are still hiding something.

πŸ—‚οΈ Choose from media (in the edit dialog, below the image field) picks one of your pictures, uploads a new one or β€” with ✨ Create with Tantu β€” starts the image suggestion; βœ• Remove clears the image. The new image is saved at once. See Choose from media.

Place state from world events

When a world event changes a place, the location list shows a badge behind its name: ⚠️ threatened, 🚩 occupied, πŸ•―οΈ cursed, πŸ•ΈοΈ abandoned or πŸ”₯ destroyed β€” the places a deicide destroys get πŸ”₯ destroyed too. An event with restored (normal), or reverting the event, removes the badge.

  • The badge is for you only β€” players don't see it.
  • It belongs to the campaign in which the event happened: a location shared by the whole world shows it only in that campaign, and never in the world's own location view.
  • Your location entry itself stays unchanged β€” name, description and image remain as they are.

Linking locations to everything else

Open a location's edit dialog and you will find a πŸ”— Links panel. This is the generic relationship tool: a location can be linked to any other entity in your campaign, in any direction, with an optional relationship label.

To add a link:

  1. In the πŸ”— Links panel, click + Link.
  2. Pick the target type from the dropdown.
  3. Pick the specific entity from the second dropdown.
  4. Optionally type a relationship in the label field (e.g. owns, guards, birthplace of).
  5. Click + Link to save.

You can link a location to any of these:

Link to Example relationship
NPC "lives in", "owns"
Scene "takes place at"
Location "is inside", "borders"
Plotline "central to"
Player character "hometown of"
Item (custom / SRD) "hidden here"
Monster (custom / SRD) "lairs here"
Deity "shrine of"
World Event "destroyed in"

Links are de-duplicated β€” adding the same connection twice does nothing. To remove a link, click the βœ• beside it. Both outgoing (β†’) and incoming (←) links are listed, with the related entity's name resolved automatically.


Locations in the Story Web

Every location becomes a Location node in the Story Web (teal, πŸ“). The links you create in the panel above show up as edges there immediately β€” no re-import.

From the πŸ”— Links panel, the πŸ•Έ Show in web button opens the Story Web in a new browser tab with that location already in focus, so you can see its whole neighbourhood at a glance.


What the player sees

Players never see a location's record, Notes, or GM secret. A location isn't pushed on its own: to show the place, push a scene in the live session β€” with 🎬 Push scene (title, description, image URL, e.g. the location's image) or a scene from πŸ“‹ Prepared scenes. The phone shows only that β€” here the demo scene of the inn:

The player's phone after a scene push: image, title and description of the demo inn, no GM secret


Optional: Image suggestion (AI)

In the edit dialog, next to the Image field, there is a πŸ–ΌοΈ Image by Tantu button with a 5 🧡 cost badge. Click it and β€” after a confirm dialog showing the cost, your current balance, and the balance after β€” Tantu suggests a wide establishing shot of the place. It uses the location's name, description, and your GM notes/secrets to shape the scene, and deliberately leaves out text, watermarks, and foreground characters so the result reads as a backdrop.

The generated image is saved to the location automatically; the Image field updates to show it. From there you can push it to players' phones the same way as any other Scene push.

If something goes wrong mid-generation, the Threads you spent are refunded automatically.

πŸ’‘ Tip: Fill in the Description before generating. An empty location falls back to a generic "fantasy location" prompt β€” a sentence or two of detail produces a far more fitting image.


Costs

  • Creating, editing, and linking locations is free on every plan, with no cap.
  • Image suggestions (AI) cost 5 Threads per image β€” free only with your own Google Gemini key. Pasting your own image URL or choosing one from your media is free. Generated images then push to players for free. See Threads & costs.
  • Stored images count against your Realm's storage quota. If you are near the limit, image generation is blocked until you free space or add a storage pack. See Storage & files.

Troubleshooting

Symptom Cause Fix
New location shows as a blank "Neuer Ort" entry A draft was created but never named Open it, give it a name; or delete it with βœ•
πŸ–ΌοΈ Image by Tantu does nothing / errors No AI image provider is configured for this Realm Add an AI key in instance settings, or bring your own key
Image generation says "insufficient balance" You are out of Threads Buy or earn more Threads β€” or add your own Google Gemini key, then images cost no Threads; see Threads & costs
Image generation blocked with a storage message Your Realm storage is full Free space or add a +500 MB pack β€” see Storage & files
Deleted a location by mistake Delete archives to Trash first, then removes Check the Trash to restore it
A link I added isn't in the Story Web Graph wasn't reloaded Re-select the campaign in the Story Web to reload