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.