Requirements & effects

Changes a tracked stat

The Ledger keeps count of what the Maker has found. This is the quill that adds a mark.

What it is

Changes a tracked stat is an effect. A tracked item (a Tracking component) is an invisible counter the player carries, such as the Ledger of Making. It can hold stats of its own, such as a count of pages. This effect adds to, takes from or scales one of those stats when the action finishes. Use it for progress counters: pages found, foes bested, days passed.

Example

Adds 1 to the Pages of the Ledger.

Which actions use it

Almost any action can have it: Harvest, Craft, Build, Make things, Open, Play story, Travel, Research, Complete and more. Edit Mode offers it on most of them with Add tracked-stat effect.

Settings

Setting What it means Example
Stat The stat on the tracked item. Pages
Change Add, Subtract or Percent of current. Add
Amount How much. 1
Random max (exclusive) A random amount from the amount up to this number, never reaching it. none
Chance (%) The chance that the change happens, from 0 to 100. 100

In Edit Mode, open the property window of the thing, scroll to the action, and look for Effects. Click Add tracked-stat effect and pick the stat. If the action has no tracked item as an input, its sentence starts "Every tracking object the player carries that has". It names the tracked input when there is one.

Edit Mode does not edit event listeners, such as the When acquired action in the example below, so that example was set up outside Edit Mode.

In Vespera: the Ledger Page Play it

The Ledger of Making is a tracked item with a Pages stat that starts at 0 and stops at 7. The Ledger Page has a When acquired action that asks for the Ledger, keeps it, and adds 1 to its Pages. When the player gets the page from clearing the Collapsed Granary, the Ledger goes from 0 to 1 of 7.

Good to know

  • It does not name an item. It changes the tracked items that carry the stat. Give an action a tracked input to aim it at one item.
  • It needs the item to exist. If the player does not carry the tracked item, nothing changes. Hand it out at the start, as Vespera does with the Ledger.
  • It cannot change a Token. Only tracked items are changed.
Under the hood
  • The effect names only the stat. It does not name which item to change.
  • If the action has a tracked item as an input, only that item's copies change. The player's copies are used for an input in the player's bag, and the place's copies for an input in the place.
  • With no tracked input, every tracked item the player carries that has the stat changes.
  • An item without the stat is skipped. If there is nothing to change, nothing happens and nothing is reported.
  • The effect does not make the tracked item. Another action has to give it first.