Component types
Harvestable and Scenery
Some things in Vespera give and some only remember. A Harvestable is a thing that gives. Scenery is one that has not been asked yet.
What it is
A Harvestable is a thing that stays in one place in a scene and gives something to players who gather from it: a tree gives wood, a vein gives ore, a patch gives wheat. It runs out either by count or by health.
Scenery is a Harvestable with no Harvest action. It is decoration. It sits in the scene, players cannot interact with it, and it has no starting count. Add a Harvest action and it becomes a working Harvestable. You can undo that.
Use it for
- A tree that gives wood until it is cut down.
- An ore vein players mine.
- A patch of wheat, with a limited number of harvests.
- A fence, a statue or a lectern that only decorates the scene.
Actions it can have
| Action | What it does here |
|---|---|
| Harvest | Lets players gather from it. It gives a yield and uses the thing up a little each time. |
One more exists for advanced setups. It is listed under the hood below.
Setting it up
A Harvestable
- Play your game, open the game menu and choose Edit this Game.
- In Add Components, click + Create Component.
- In the Create Component dialog, pick Harvestable.
- Fill in Name, Duration (seconds), Output resource and Output quantity. The form needs a positive number for both the duration and the quantity.
- If nothing exists to yield yet, the form points you to the picker. Type a name there to make the missing component without leaving the form.
- Click Create, then drag it from the palette onto the scene.
Scenery
- Follow steps 1 and 2 above, then pick Scenery in the Create Component dialog.
- Fill in Name and Description Shown Player.
- Click Create, then drag it from the palette onto the scene.
To make Scenery harvestable later, select it, open its property window, click Add action ▾ and choose Let players harvest this. The new action is named Harvest and lasts 5 seconds.
In Vespera: the Surviving Wheat and the Ledger Lectern Play it
The Surviving Wheat in the Withered Fields is a Harvestable. Each harvest takes 5 seconds and gives 1 Wheat Sheaf, and it starts with a count of 6. The Harvest page shows it at work.
The Ledger Lectern in the Last Outpost is Scenery. It stands in the scene as one starting item and has no action, so players can look at it and nothing more.
Good to know
- Fixed in the scene. A new Harvestable cannot be dragged around by players.
- Count or health. Whether a Harvestable counts down or wears down depends on its Harvest action. The Harvest page explains it.
- An empty Harvest still uses it up. A Harvest with no yield gives nothing and still uses the thing up. The property window warns you on that row.
- Where the yield goes. A Material goes into the place, not the player's bag. Coins and stories go to the player. By default a Material waits in the scene's Unplaced Items tray until the player drags it out or picks it up.
- Turning Scenery into a Harvestable changes nothing else. Placements you already made stay where they are.
Under the hood
- A Harvestable can also carry an action that reacts when it is given to a place.
- Scenery is not a separate type in the engine. It is a Harvestable with no Harvest action, so deleting the Harvest turns a Harvestable back into Scenery.
- Older Scenery that was made as a Material players cannot pick up keeps working as Scenery. Nothing needs to be moved.