Reference
Starting item scopes
Each entry in the Ledger is pinned to something: a hero, a place, a shelf. The pin decides who sees it.
Still being forged
Parts of this aren't finished yet. What doesn't work yet is listed below.
- The world admin editors have a mode for the player's own items, but nothing uses it. A character's backpack is a list attached to the character instead.
What it is
A starting item belongs to one scope: the thing it is attached to. The scope decides where the item appears in a new game and which editor changes it. The world admin pages work in two modes: one for a place's own list, and one for the global shop and global items. A third mode, for the player, exists but nothing uses it.
Settings
| Scope | Where it appears in a new game | Where you set it | Vespera example |
|---|---|---|---|
| A place's list | In that place, every time it is built | The place's starting list in the world admin, or by dropping into a scene in Edit Mode | Maren's Stall at the Outpost |
| One node | Only in that exact place on the map, on top of its list | The node's own overrides | Surviving Wheat in the Fields; the Storeroom's empty slot at the Outpost |
| A character's backpack | In the player's bag, once the character exists | The character's loadout | The Ledger of Making in Frono's backpack |
| A place's shop shelf | On that place's shop, for sale | The shelf of the place, in the shop dock | The six rows on Maren's Stall |
| The global shop | In a shop open from every place | The global shop page | Not used in Vespera |
| Global items | Outside any place, at the top level | The same page as the global shop | Not used in Vespera |
Setting it up
The steps for a scene item are in Add components to a scene. A shelf row is the same drop onto a shop panel. Each row in the shop dock has an ∞ button (its tip reads "Make stock unlimited").
In Vespera
In Vespera: the Ledger, the Stall and the scene Play it
- Backpack. The Ledger of Making is a starting item attached to Frono. A new game puts it in his bag, one copy.
- Shop shelf. Maren's Stall has six rows attached to the Outpost, each marked for sale with an unlimited count.
- Place's list. Maren's Stall is attached to the Outpost's own list, so every new game builds it there.
- One node. The Fields' node holds Surviving Wheat at a count of 6. The Outpost's node holds the Storeroom at a count of 0 with a position, an empty slot where building it puts it.
Good to know
- The mode is not the scope. Trust where an item is attached, not the mode of the page you edited it in.
- A negative count belongs on a shelf. An unlimited count is only allowed on a row for sale.
- A node row ignores its parent. If a row names both a node and a parent, only the node counts.
Under the hood
- The admin editors work in two modes: a place's list and the global shop with the global items. The mode is only a setting of the page. It is not saved with the starting item.
- What a starting item really does is set by where it is attached: a place or node, a character, and whether it is for sale.
- An editor address that ends in 0 means a new place, not the global list.
- An older single editor handled both modes. It was removed when the location editors were reworked.
- When you make a game by program, trust the attachments of each row. Do not rely on the mode.