Requirements & effects

Needs (a cost)

Nothing in the Ledger is free. This is the rule that says what an action costs, or what a player must be holding before it will run.

What it is

Needs is a requirement, and often a cost. You name a component and an amount. When a player starts the action, the game looks for that amount in the player's bag or in the place. If it is there, the action goes ahead. If it is not, the action is refused. You choose whether the amount is used up or only has to be held.

Example

Needs 3 Wheat Sheaf, used up. Needs 1 Brass Key, kept.

Which actions use it

Buy (the price), Craft (the ingredients), Build and Upgrade (the cost), Make things (what it needs), Open, Play story, Learn, Research and Complete (the turn-in). A Travel takes costs through the Exit dialog. Sell, Handle event and the combat moves take none.

  • Craft: the ingredients of a recipe.
  • Build: what a new Structure costs.
  • Upgrade: what the next tier costs.
  • Research: what a topic costs to study.
  • Travel: what an Exit asks of the player.

Settings

Setting What it means Example
Component What is asked for. Required. Wheat Sheaf
Level Which level of the component, when it has more than one. Level 1
Comparison How the player's amount must stand against yours: at least, at most, exactly, fewer than, more than. It starts at "at least". at least
Quantity The amount. 3
Where "from the player's bag" or "from this place". from the player's bag
Used up Ticked: the amount is taken. Not ticked: the player only has to hold it. ticked

Open the action in the property window. Each cost is a row with Choose a component, Quantity, Where and Used up. The Needs column holds the comparison. ADD at the right of the section adds a row. A row reads back as a sentence, such as "Costs 3 Wood from this place" or "Needs at least 1 Brass Key (kept)".

When you create a Recipe, the dialog has an Ingredients list with the same rows. Click ADD, pick a component and set Quantity.

The New Recipe dialog, scrolled to its lower part. What it crafts reads Hearth Loaf, How many it makes 1, Time to craft 1 second. Under Ingredients is one row: Wheat Sheaf, quantity 3, Used up ticked.
The Ingredients row of the Hearth Loaf recipe: 3 Wheat Sheaf, used up.

In Vespera

In Vespera: bread, and a mended forge Play it

  • Used up. Step 3's Recipe: Hearth Loaf needs at least 3 Wheat Sheaf from the player's bag, and they are used up. The loaf is crafted in 1 second.
  • Kept. The research Mend the Old Forge is studied with a Study action that takes 15 Vesper Marks and 6 Iron Nails, both used up, and asks the player to hold 2 Ledger Pages. The pages are kept. The player studies the topic with the pages still in the bag.

Good to know

  • Kept or used up? Tick Used up for money and ingredients. Leave it off for a key, a pass or anything the player should still own afterwards.
  • A word that cannot be used up. With "at most" or "fewer than", the Used up box is off and cannot be ticked. The editor says "Never used up: this only checks what the player has."
  • Asking for none. An amount of 0 is accepted for "at most", "exactly" and "more than". "Fewer than 0" is refused, because it can never be met. See Comparisons.
  • A cost that never blocks is a different rule: Also takes, if there is any.
Under the hood
  • Every cost on an action is checked first. Only when all of them pass is anything taken. A player who is short on one cost loses nothing.
  • A cost that is kept is met by the named level and by any higher level of the same component. A cost that is used up is met only by the exact level.
  • A cost never rolls a chance and never takes a random amount. The editor hides both and resets them on save.
  • On Make things the cost is taken once for each run, so a stack that runs several times takes several times as much.
  • A cost with an amount of 0 and the default word, at least, is a free cost and always passes. It is never a gate.
  • A cost that the editor cannot complete (a free cost, a negative amount, a place the editor does not offer) is not changed by a save. It shows as a read-only line.
  • The game never takes anything on a sale, so Sell has no cost.
  • When you ask the assistant for a cost, say that it is used up. A cost that does not say so is kept.