Ideas & systems

Hints and flags on a component

Every component carries a few small notes in the margin of the Ledger. Two say how it may be handled. One says a kind word when it arrives.

What it is

A component's page in the admin has two switches and a tip box. They are small, and they change how the component feels in play.

Setting What it does Where you meet it
Can pickup/drop Lets the player pick the component up from a scene and carry it. The popover on a thing in the scene shows Pickup or not.
Can Move Lets the component be moved in a scene. With it off, the component is fixed where you put it. A fixed thing stays put.
Player Tips on Receipt of A short message that appears when the player receives the component. A toast with a Dismiss button.

A tip is that message. It greets the player the moment the component lands in their bag.

How it works

To add a tip, you edit the component on its page in the admin. These are the steps as they were done on the Pressed Hollow Flower.

  1. Open the admin's Components list for your game and click EDIT on the component.
  2. Find the line Player Tips on Receipt of and the name of the component. Click Show Tips beside it.
  3. Type your message in On Player Receive and click the plus beside it. A block headed On Player Receive opens under it.
  4. In the block, set Probability and Max Shows. A new block starts with Probability 1 and Max Shows 1.
  5. Click Save Component.

What the numbers do:

  • Probability is a percentage from 0 to 100. The first time a tip is ever shown it always shows, whatever the number says.
  • Max Shows is how many times the tip may appear in all. If you leave it empty, it counts as 1. 0 means no limit.
  • With Max Shows 1, the single showing always happens, so Probability does not matter. It matters only when Max Shows is above 1, or 0.

The block also has Duration (sec), Random and User must dismiss. Add Message adds a further message. You can keep the first three as they are.

In Vespera

In Vespera: the Weathered Satchel, the Tinker's Bench and the Pressed Hollow Flower Play it

Flags. The Tinker's Bench and the Weathered Satchel have Can Move off, so neither can be moved. The Satchel also has Can pickup/drop off. In play, tapping a satchel shows only Open, with no Pickup. The Pressed Hollow Flower has both switches on. Tapping it shows Look closer and Pickup, and it can be carried.

Tip. The Pressed Hollow Flower has one tip. In the admin it sits under Player Tips on Receipt of the Flower, in the On Player Receive block, with Probability 100 and Max Shows 1. The message reads "Some finds have more to tell. Look closer in the Journal's Collection."

In play, the player taps the Flower and chooses Pickup. The text "+1 Pressed Hollow Flower" flies up. A toast then shows the header "You've received Pressed Hollow Flower", the message, and a Dismiss button. It disappeared by itself a few seconds later, with no tap.

Good to know

  • A tip needs a component that is received. The Waystone stays on the Road and is never given to the player, so it has no tip. Vespera puts its tip on the Flower, which is picked up.
  • Stories cannot carry a tip yet. The admin has no tips section for a story (Lore). The game would show one, but you cannot write it there.
  • A tip comes once by default. With Max Shows left at its starting value, a player sees the tip the first time and never again.
  • Flags are not stats. Health, costs and rewards live on levels and actions, not on these switches.
Under the hood
  • Both switches are stored as 1 for on. An empty value means off. Navigation components and NPCs are always fixed, whatever the box says.
  • Each type starts with its own defaults. Currency, Material, Gear, Recipe, Powerup, Lore and Loot box can be picked up from the start. A Harvestable, Container, Interactable and Quest cannot be moved from the start.
  • A tip is shown when a component's count goes up in the player's bag or in a place. A story (Lore) would qualify, but the admin has no tips section for a story yet, so stories cannot carry a tip yet.
  • Tips can also be set to show on arrival in a place, with the box On Location Receive. A tip can list several messages, picked in turn or at random.
  • A tip's chance is a percentage from 0 to 100, and it is not a fraction. The first time a tip is ever shown it always shows, whatever its chance. Max Shows starts at 1 when it is left empty, and 0 means no limit.
  • The page's Design Notes box is for you only. The game never reads it.