Requirements & effects

Passes on an event

A shout travels from one end of the workshop to the other. This rule is the shout: it says what was made, and whoever is listening answers.

What it is

Passes on an event is an effect. When the action finishes, it names one component and announces it. A Handle event action in the same place that listens for that component hears it and gives something back. The announcement is the event.

Example

Passes on Flour to anything here that listens for it.

Which actions use it

Make things. A Handle event can carry one too, but it does nothing there.

Settings

Setting What it means Example
Component What is announced. The action must also give it. Flour
Amount The amount announced. It is usually 100. 100

Only the component matters to the listener. The window shows this rule as a read-only line and never edits it. To add one, open the action and choose EDIT THIS ACTION IN ADVANCED.

The listener side shows in the window as a settings line. A listener for Flour reads "listens for Flour (only when another action here passes it on)".

The lower part of the property window of the Bakehouse Oven's Bake action. Rewards has one row: Hearth Loaf, quantity 50, chance 100, to the player. Under Settings, the line Also set in Advanced reads listens for Flour, only when another action here passes it on. Below are the Edit this action in Advanced, Save and Remove this action buttons.
The Oven's listener: it hears Flour and gives 50 Hearth Loaf for every 100 Flour passed on.

In Vespera

In Vespera: the Mill and the Oven Play it

The Mill's Grind action gives Flour, and passes it on. The Bakehouse Oven stands in the same place and listens for Flour. Its Bake action gives Hearth Loaf to the player, at 50 percent of the Flour it hears.

In play, round 1 made 6 Flour, so the Oven gave 3 Hearth Loaf. Round 2 made 3 Flour and gave 1 loaf. Round 3 made 2 Flour and gave 1 loaf. Half of 3 is 1.5, and it was rounded down.

Good to know

  • Same place. Put the listener in the same place as the action that passes on, or it never hears.
  • A small share can give nothing. Ten percent of 5 is 0, so nothing is given.
  • It passes on what it gives. The Mill gives Flour and passes Flour on. The two must name the same component.
Under the hood
  • It runs when the action finishes. It matches what the action gave, and finds the listening actions that sit in the same place and listen for that component.
  • A listener in the player's bag never hears it, and nor does one in another place. The first listener found for each component runs.
  • Each listener gives a percent of the amount passed on, rounded down. A percent that comes to 0 gives nothing.
  • Listeners pass on in turn, so a chain of several can run, up to eight deep.
  • It does not fire for what a Harvestable gives when it is used up, nor for what a Buy or Build gives to its target.
  • The Advanced editor has an Add Re-Trigger button on a listener. It does nothing, because a listener already passes on whatever it gives.
  • The property window never edits this rule. It shows it as the read-only line Passes on Flour to anything here that listens for it.