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

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
- Open π Locations from the left navigation bar in the GM tool.
- Click + Location.
- Start typing into Name β the location is saved the moment you type your first character (see Autosave). There is no separate "Create" button.
- Fill in Description, Notes, and the GM secret field. Every field autosaves as you go.
- Click β Done (or just click outside the dialog) to close. Empty drafts are discarded automatically.
- 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:
- In the π Links panel, click + Link.
- Pick the target type from the dropdown.
- Pick the specific entity from the second dropdown.
- Optionally type a relationship in the label field (e.g. owns, guards, birthplace of).
- 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:

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 |
Related articles
- πΈοΈ Story Web β locations appear here as nodes automatically
- π¬ Scenes (prep) β set a scene at a location and push it
- π€ NPCs β link the people who live in your places
- πΌοΈ Scene push β send a location image to player phones
- π§΅ Threads & costs β what image suggestions cost
- πΎ Storage & files β what counts against your quota