Action types

Handle event

Some work needs no hand on the lever. A Handle event waits, and when its moment comes, it acts.

What it is

Handle event lets a component react without a button. There are two kinds. A listener waits for another action to pass an item to it, and then gives a share of it as something else. An acquire action runs when the player first gets its component.

What the player sees

Nothing to press. A listener has no button. When another action in the place passes the item on, the listener gives its reward, and the player gets it. An acquire action gives its reward the moment the player gets the item, such as a story that plays.

Which components can have it

Most Edit Mode components can: a Currency, a Material, a Harvestable, a Structure, a Recipe, a Container, a Gear, a Quest and an Interactable. A listener is most often a Structure. To hear every reward of one kind, wherever it comes from, see Process awards.

Requirements & effects it uses

Requirement / effect What it does here
Gives What the action hands over. For a listener, each amount is a percent of what it heard. For an acquire action, it is an exact amount.

A listener hears an event that Passes on an event sends. It never takes anything and never runs stat effects. Other settings are listed under the hood.

Setting it up

Edit Mode does not have an Add action entry for a Handle event, so you cannot make one there. You can change one that exists:

  1. Play your game, open the game menu and choose Edit this Game.
  2. Select the Structure to open its property window and find its action.
  3. Under Rewards, change the component, Quantity (a percent of what it hears), % Chance or Where, or click ADD for another reward.
  4. Click Save.

What it listens for is shown as a line under Settings. To change it, click EDIT THIS ACTION IN ADVANCED. An acquire action is made in the same Advanced editor, not in the property window.

In Vespera: the Bakehouse Oven Play it

In the Fields, the Bakehouse Oven has one action, Bake. It listens for Flour. Its one reward is Hearth Loaf, Quantity 50, % Chance 100, Where "to the player".

The Bakehouse Oven's property window. Rewards: Hearth Loaf, Quantity 50, % Chance 100, Where to the player. Under Settings, a line says Also set in Advanced: listens for Flour, only when another action here passes it on.

The Mill's Grind action makes Flour and passes it on. Each time it does, the Oven hears the Flour and gives half as many Hearth Loaves to the player.

An acquire action. The Rusty Sickle plays the story The Reaper's Tune once, when the player gets the sickle. It has an acquire action that gives the story, and no button.

Good to know

  • A percent, not a count. On a listener, 50 means half of what came in.
  • It needs a partner. A listener gives nothing until another action in the same place passes the item on.
  • The window's hint. The window says "It only gives something in play when another action here passes that component on to it."
  • Awarded or picked up. An acquire action also fires when a player picks the item up from the scene, or takes it out of a chest.
  • A story plays by itself. An acquire action that gives a story plays it, with no story action needed.
  • Removing it. The window has REMOVE THIS ACTION.
Under the hood
  • The two kinds are told apart by one setting, the trigger. When it is none, the action passes on a share of what it hears. When it is set, the action runs when its own component is acquired.
  • A listener passes on a share of a number. The share is a percent, so 50 means half of what came in. A reward of an acquire action is an exact amount, so 50 means 50. Reading one as the other is the common mistake.
  • A listener only hears when another action in the same place passes the item on. It sits in the place, not in the player's bag, and a chain of listeners can go several steps deep.
  • A listener never reads costs, skill or research rules, random outcomes or its own re-triggers. Edit Mode offers none of those on it.
  • An acquire action fires once for each award, not once for each unit. It must run in an instant, and it must not give its own component, or it would fire forever.
  • Taking the same item out of a chest again fires it again. Do not hang a valuable reward on an item players can move around.
  • The Edit Mode window offers Hide this action from players, a sound and Remove this action, and nothing else.