Reference
Location
Every road in the Ledger ends somewhere. A location is the somewhere.
What it is
A location is a place a player can travel to, such as a village square or a field. It has a scene, the picture players see, and it holds the things you place there. It can have levels. A place that moves up a level changes its name and its scene picture.
A location is not made from the Create Component dialog and does not appear in Add Components. Locations are set up in the world pages of the builder, or by the assistant. The signposts that lead to them are paths. See Path.
Settings
| Setting | What it means | Example |
|---|---|---|
| Name | What the place is called. Each level has its own name. | The Withered Fields, then The Golden Fields |
| Scene picture | The picture players see while the place is at that level. | One picture per level |
| Map marker | The small icon on the map and in menus. | The icon shown for the place |
| Levels | Optional tiers. They appear once the place has an Upgrade. | 2 |
| Travel | How a player enters, by a path or a map tap. A cost or a rule can be set. | The path to the Hollow Road needs a story |
| Upgrade | How the place moves up. It can give rewards. | Fills at 100 XP |
Setting it up
- Make the place and its scene. The scene picture is what players see on arrival.
- Put things in it with starting items. See Give a place its starting items.
- Link it to the rest of the map with a path. See Path and Link two locations. Its pin on the world map is a map node.
- For a second level, give the place an Upgrade and a second level with its own name and scene picture. See Upgrade.
In Vespera
In Vespera: the Withered Fields Play it
The Withered Fields is a place with two levels. Level 1 is the withered field. Level 2 is named The Golden Fields.
The place gains XP from the Mill. Each round of the Mill's Grind adds 20 XP to the Fields, so five rounds fill the bar. See Changes a place's stat. The place levels up on its own. The game shows "Level Up! / The Golden Fields reached level 2 / You received / +4 Surviving Wheat".
The level-1 Upgrade gives 4 Surviving Wheat to the place. Four empty slots wait in the Fields, each with a starting count of 0, at four fixed spots in the scene. The reward fills one slot each. So four patches of Surviving Wheat appear where the slots stood, at the four slot positions, (560, 640), (700, 700), (940, 700) and (1080, 640). The scene picture changes to the golden field at the same moment, with no loading screen.
The Fields keep level 2 for good. Leaving to the Outpost and coming back does not reset it.
Good to know
- A drop in Edit Mode belongs to the level the place is at. An item you drop while the place is at level 2 is made when the place reaches level 2, not at the start of a new game. A new game spawns level 1's items.
- Level-up fills the new level's starting items. When a place moves up, the items made for the new level appear first. Then the Upgrade's rewards are given.
- Edits do not reach games already running. A game that is past a level keeps the items it already has.
- Each place levels on its own. Two nodes that share a location do not share a level.
- Levels need an Upgrade. The list of levels stays hidden until the place has one.
- A place can greet the player. Attach a story and it plays on arrival. See Location story. For how a scene is measured, see The scene model.
Under the hood
- A location has its own inventory of the things standing in it. Items it holds are part of the place, not of the player.
- A place keeps its level for good. The level survives leaving and returning, and it survives updates to the game's setup.
- If one location is placed on two map nodes, each node is its own place and levels up separately.
- XP reaches a place only through an effect that changes a place's stat, and it reaches the place the action runs in. See Changes a place's stat.
- When a place levels up, the new level's starting items are created first. A reward given to the place afterwards can fill the empty slots they leave.
- Items made from the old level's starting items stay where they are. An edit to them does not reach a game that is already past that level.
- Arrival actions run when a player enters: a story can play, and an unmet condition is skipped without stopping the journey. Enemies in the place turn hostile on arrival.
- A place's start-of-game contents are not needed for it to work. A place with none is still playable, with nothing in it.