Reference

What can be placed where

Not every thing belongs on every shelf. This page is the Archivist's shelving plan.

Builder-only rule

The builder checks this rule for you, but the game itself doesn't enforce it.

What it is

When you place a component, the builder checks its kind against a list. This page is that list, in plain words. There are separate lists for a scene, for a shop and for a character's bag.

The builder keeps these lists. The game engine does not check them: if a placement slipped past the builder, the game would still place it. The one list that matters most for a scene is what the game can draw. A kind that the game cannot draw is silently not shown.

Place What the builder lets you put there
A scene Coins, materials, gear, recipes, power-ups, structures, harvestables, chests and loot boxes, things the player can open or tap, non-player characters, enemies, path components, collectibles, quests, and the game-menu buttons
A shop Coins, materials, gear, power-ups and recipes
A character's bag The same kinds as a place's bag, plus chests and loot boxes
A character's skills Skills
A character's quests Quests

Setting it up

The Edit Mode steps were walked once in Add components to a scene.

  1. Play your game and travel to the location.
  2. Open the game menu and click Edit this Game.
  3. In Add Components, find a component and drag it onto the scene.
  4. If a Heads up box asks whether to continue, click Continue.

If the component is a kind the game cannot draw, it does not appear in the scene.

In Vespera: a Material and a Currency Play it

Scrap Iron is a Material, and Materials are on the scene list. It lies in the Silent Forge with a starting count of 20, and the count shows on its icon.

The Silent Forge, a ruined stone workshop with an anvil on the left. A small wooden Tinker's Bench stands on the right, and beside it a pile of rusty iron scraps lies on the floor with a count badge reading x 20.
Scrap Iron lying in the Silent Forge with its count.

Vesper Marks are a Currency. A Currency can also lie in a scene, but Vespera never places it. The Marks go to the player instead: achievements and quests award them. The First Harvest achievement gives 3, and the first quest stage, First Light, gives 10.

Good to know

  • Not enforced by the engine. The builder's lists are the only guard. Placement from outside the builder is not checked for type.
  • Stories are not scenery. A story is not drawn in a scene. The player gets one as a story, not as an object.
  • Some kinds are never placed here. Tracking items, tokens, character classes, research, achievements and some menu buttons are not offered. A location itself is placed through map nodes only.
  • Building is separate. A Structure or Harvestable can start in a scene, but it can also be added later through the Build Menu or by an action.
Under the hood
  • Characters appear in the location editor's own list but are not drawn in a scene. Stories are never drawn in a scene either; they are only a payload that plays.
  • A defeated enemy is not drawn. An enemy that is still active is drawn, so the player can attack it.
  • A Token behaves like a Currency in the currency bar, but is never drawn in a scene. Use it for a counter that lives only on the screen.
  • Stories, achievements, collectibles, quests, skills, character classes and research are kept out of container screens.
  • The character list in the world admin leaves out any character whose level has an Agro action.