Glossary

The Archivist's index of every word in the Ledger, with the other names you may have heard for it.

Every page of the Atlas has an entry here, along with the terms the builder uses. Where a thing goes by more than one name, the entry lists the others after "Also called". Open the page to read the whole story.

A

A single reward
One prize drawn from several: each prize has a weight, and exactly one is given each time. Also called: weighted output. Open the page
Achievement
A milestone that is earned automatically and shown in the journal. Also called: badge. Open the page
Action
Something a component can do or have done to it. Open the page
Action type
What kind of action it is, such as Harvest, Craft or Attack. Open the page
Add components to a scene
Make a piece of scenery in Edit Mode, place it in a location, and have every new game start with it there. Open the page
Add music and a voice
Make a spoken voice-over with the game's AI voice tool, add it to a story, and put a quiet music bed under it. Open the page
Agro
An action on a foe that decides whether it attacks the player on arrival. Open the page
Also takes, if there is any
An extra cost that is taken when the player has it and ignored when they do not. Open the page
Animation
Move, fade, zoom or turn a layer over time by setting its values at chosen moments. Open the page
Art for a component
How a component gets its icon, and how a place gets its scene background. Open the page
Ask for a tool or a skill
Make an action ask the player for a tool they carry and a skill they have learned. Open the page
Audio tracks
Music, sound effects and voice-over that play on the story's clock, each with a start, an end and a volume. Open the page

B

Backpack button
A HUD button that opens the player's Backpack panel on its Inventory tab. Also called: player menu, inventory button. Open the page
Bags and places
Where things are kept: in the player's bag or in the place, and how rewards and requirements choose. Also called: from inventory, to inventory. Open the page
Bonus rewards
An effect: an extra reward that an action gives only while the player holds a certain item. Also called: conditional output. Open the page
Buffs and modifiers
A bonus that rides on an item or skill the player owns and changes how much, or how likely, an action gives. Also called: modifier, buff. Open the page
Build
Let players put up a building or a chest themselves, for a price. Open the page
Build an idle machine
Put a machine on the Build Menu with a cost and a build time, then make it run round after round by itself. Open the page
Buy
Let players pay for an item at a shop and take it home. Open the page

C

Chance and weights
The two meanings of a number beside a reward: a percent chance on its own, or a weight in a shared draw. Also called: max possible, random roll, chance. Open the page
Changes a place's stat
An effect that raises or lowers a stat of the place where the action ran. Open the page
Changes a tracked stat
An effect that changes a stat on a tracked item, a hidden counter such as the Ledger's Pages. Open the page
Changes the character's stat
An effect that heals, hurts, tires or rewards the character who ran the action. Also called: attribute modification. Open the page
Character
A playable unit with levels, stats and a backpack: the player's hero or a staff member. Open the page
Character class
A calling that gives a Character a permanent package of stats and bonuses. Also called: class. Open the page
Collectible
A rare find the player keeps for completion or display, listed in the Journal's Collection tab. Open the page
Colours and shapes
How one theme of colours, borders and corners paints every panel, card and button in a game. Open the page
Combat
How a fight starts, runs and ends, and which actions you give the foe and the player. Also called: attack, start a fight. Open the page
Combat move
An action a character, a weapon or a foe uses inside a fight, usually to take health from the other side. Also called: attack move. Open the page
Comparisons
The words 'at least', 'at most', 'exactly', 'fewer than' and 'more than' that a requirement uses, and how they differ from changes. Open the page
Complete
Let a player hand in what a quest asks for and be paid, or claim an achievement. Also called: complete quest, complete task. Open the page
Component
Anything that exists in your game: a sword, a shop, a hero, gold. Open the page
Component type
What kind of component something is, such as Structure, Harvestable or Material. The Create Component dialog lists them. Open the page
Container
A chest or storeroom that holds items the player moves in and out. Open the page
Converts a share of what went in
An effect that turns a percent of a stack the player holds into something else. Also called: convert input to output. Open the page
Counter for something in the place
A HUD counter that shows the picture and number for one component the current place holds, with an optional bar. Also called: location display. Open the page
Counter for something the player holds
A HUD counter that shows the player's picture and number for one component they own, with an optional bar. Also called: gold counter, gem counter, currency HUD. Open the page
Craft
Let players turn ingredients into something new with a Recipe. Open the page
Crafting button
A HUD button that opens the player's Backpack panel on its Crafting tab. Open the page
Create a quest
Make a quest in Edit Mode that asks the player for some things and pays them a reward. Open the page
Currency
The coin of your game: earned, held in the player's wallet and spent. Also called: currencies. Open the page

D

Design cards
Planning notes for your game: the story, the characters, the economy, the world and the rules you keep. Planning note linked to the things it describes. Open the page
Destroy
Let players break something up where it lies, and optionally hand back what was inside. Open the page

E

Edit Mode
The in-game editor, entered with Edit this Game. Open the page
End turn button
A HUD button that ends the player's turn in a turn-based game. Also called: end turn. Open the page
Enemy
A foe with its own Health, moves and loot, that the player fights. Open the page
Enemy defeated
What a foe gives and changes when a fight takes its last health. Open the page
Example sets
Ready-made worked examples you can add to a game from the Add examples panel. Open the page

F

Fade in an image and zoom it
Add a picture to a story, fade it in over four seconds and zoom it slowly for the rest of the story. Open the page
Flee
An action to escape a fight. The game's own Flee! button already shows in every fight. Open the page

G

Game menu button
The HUD button that opens the game's own menu: volume, text size, leaving the game and Edit Mode. Also called: hamburger menu, settings popover. Open the page
Gear
A tool, weapon or piece of equipment that gives its carrier a capability, a stat or a boost. Open the page
Give a character an attack
Add a fight move to the player's character in Edit Mode, so the fight panel has something to use. Open the page
Give a place its starting items
Drop a building into a place in Edit Mode, and leave an empty slot where a machine will later be built. Open the page
Gives
The yield of an action: what it hands out when it finishes. The yield of an action, for example Gives 1 Wheat Sheaf. Also called: output. Open the page
Gives when used up
A bonus that is handed out only when a Harvestable is finally used up. A bonus when a Harvestable is used up. Also called: reward on death, output on death. Open the page

H

Handle event
Let a component react by itself, to something passed to it or to being acquired. Also called: event handler. Open the page
Harvest
Let players gather from something in a place, such as wheat, wood or ore. Open the page
Harvestable
Something in a scene that players gather from. Open the page
Harvestable and Scenery
Something fixed in a scene that players gather from, or that only decorates it. Open the page
Hints and flags on a component
The two switches that say whether a component can be picked up or moved, and the tip that greets a player who receives one. Open the page
How a game fits together
How components, levels, actions and their requirements and effects connect, traced through one workbench. Open the page
How a new game starts
What the game builds, places and plays the moment a player starts a new game. Also called: player character. Open the page
How a world fits together
The parts of a game world, a map, its pins, the places and their scenes, and the starting items, and how they connect. Open the page
How an action runs
What happens between a tap and its reward: the start, the wait, the finish, and the loop that keeps a machine going. Also called: rule. Open the page
How menus open
Which HUD button and which scene button open each panel, and what each way does and does not skip. Open the page
How the game screen is put together
The scene, the HUD and the menu panels that make up what a player sees, and where each one is set up. Open the page
HUD anchors
The eight places on the game screen where HUD buttons and counters are pinned, and what Vespera keeps in each. Also called: top-left HUD slot. Open the page

I

Idle and clicker recipes
Four small recipes for an idle game, a machine, an income, a bar and a goal, each shown running in Vespera. Open the page
Image layers
A picture on the stage, with a start and end time, a place, a size and a layer order. Open the page
Interactable
A fixed thing in a scene that the player taps: a lever, an altar, a shrine, a standing stone. Open the page

J

Journal button
A HUD button that opens the Journal: quests, research, achievements, collection and story. Also called: journal, codex, quests menu, scene journal button. Open the page

L

Labelled place counter
A HUD counter that shows, as text with a label, how many of one component the current place holds. Open the page
Labelled player counter
A HUD counter that shows the player's number for one component as text with a label, and no picture. Also called: labelled currency bar. Open the page
Layer
One part of a story sequence: an image, text, audio or a particle effect. Open the page
Learn
Let a player pay a cost to gain a skill. Open the page
Put a signpost in one scene that leads to another place, then gate it behind a research if you want. Open the page
Location
A place players can travel to, with its own scene, its own contents and, if you want, several levels. A place in the world map. Open the page
Location story
A story you attach to a place, so that it plays when the player arrives. Open the page
Loot box
A satchel, crate or sack the player opens once for a reward, often a surprise. Open the page

M

Make a new location with scene art
Make a new place in Edit Mode, draw its background with the assistant's picture maker, and find its pin on the map. Open the page
Make a one-line story
Ask the game's assistant to write a one-sentence story that plays once, when the player first gets a certain item. Open the page
Make a recipe and craft with it
Make a Recipe in Edit Mode that turns three Wheat Sheaf into a loaf, and give the player XP for baking it. Open the page
Make a shop
Make a shop button in Edit Mode, place it, and stock its shelf with items that have a price. Open the page
Make things
Let a Structure turn what it needs into something new, over time. A Structure's action; Edit Mode says "This structure can make things" / "Let this make something". Open the page
Map button
A HUD button that opens the map, where the player picks a place to travel to. Also called: map, travel menu, scene map button. Open the page
Map node
One pin on the world map: it holds a location and says where on the map picture that place sits. Also called: location node, map placement. Open the page
Map style
The sizes and colours of a map's pins, their labels and their links. Also called: node style. Open the page
Material
A stackable thing used as an ingredient or a yield: wood, ore, nails, wheat. A stackable thing used as an ingredient or yield: wood, nails, wheat. Also called: resources. Open the page
A button you place in a scene that opens one of the game's panels when the player presses Open. Open the page
Move the HUD buttons
Drag a HUD button to another corner of the screen, set its size and put it back with Undo. Open the page

N

Needs (a cost)
A requirement that asks for some amount of a component, and can use it up. Also called: input requirement, consumed. Open the page
Needs a skill
A requirement: the action will not start until the player has a certain skill. The player must have a skill (a higher level also counts). Open the page
Needs a stat
A requirement: the action will not start unless the player's own stat, such as Health, passes a test. Also called: attribute requirement, stat requirement. Open the page
Needs a tool
A requirement: the action will not start unless the player carries an item with a certain capability or stat. The player must carry an item with a capability, e.g. an axe. Also called: required gear. Open the page
Needs research
A requirement that locks an action until the player has finished a research topic. Open the page
Node types
The three ways a map node can choose which location it shows. Also called: specific location, random location, location type tag. Open the page
Nothing happens
An empty ticket in a draw: when it is drawn, the outcome gives and changes nothing. Open the page
NPC
A character who stands in a scene, talks to the player and can hand things over. Open the page

O

Open
Let players open, use or touch something to get what it holds or to trigger an effect. Open the page

P

Particle layers
Dust, snow, embers or a burst of sparks drawn over a story, with no picture file needed. Open the page
Passes on an event
An effect that tells the other components in the place that something was just given. Also called: trigger, emit event, re-trigger. Open the page
Path
A signpost in a scene that takes the player to another location, for free or behind a rule. Also called: connection, edge, nav component, nav button, travel button. Open the page
A link that lets a player travel from one location to another. Open the page
Paths and travel
How players move between places: signposts in scenes, each with a built-in destination, free or behind a rule. Also called: travel destination, visit count. Open the page
Pick up and drop
The two moves every carried item has: take it from the place into the bag, or leave it in the place. Open the page
Placing things in a scene
How items get a spot in a scene: by a position you give them, or by a placement zone that lays them out. Also called: placed character, not placed, unplaced, scene placement. Open the page
Plan with design cards
Write a design card, then ask the Build Assistant what is left to build and decide on its proposal. Open the page
Play story
Let a character or a thing in a scene tell a story when the player taps it. Open the page
Player defeated
What happens to the player's character when a fight takes their last health. Open the page
Player portrait
The player's portrait on the HUD, with a level badge and bars for experience and health. Also called: stats icon. Open the page
Powerup
A potion, charm or spell the player uses once for a boost. Also called: consume. Open the page
Process awards
Let a Structure take a share of every reward of one kind, wherever it comes from. Open the page

Q

Quest
A goal the player picks up, completes by handing things in, and is paid for. Open the page
Quests and achievements
How a quest or achievement is handed out, turned in and followed by the next stage. Open the page

R

Re-colour your game
Change the colours of panels, buttons and tabs in Edit Mode, finish the borders in the full theme editor, and know how to go back. Open the page
Recipe
Crafting knowledge: what a player needs and what they get when they use it. Open the page
Remove it after it runs
Makes a component disappear once its action has finished: a satchel opened, a tonic drunk. Open the page
Requirement / effect
A requirement is what an action needs. An effect is what it produces or changes. Open the page
Research (action)
Let players study a topic and unlock what depends on it. Open the page
Research (component)
A long-term unlock the player earns once, for the whole game. Open the page

S

Scenery
Decoration that does nothing; adding Harvest makes it a Harvestable. Open the page
Sell
Let players sell an item they carry and be paid for it. Open the page
Send to
An effect that moves the defeated character to a place you choose. Also called: send player home. Open the page
Shop button
A HUD button that opens the Shop panel, with its Build, Buy and Sell tabs. Also called: shop, build menu, buy menu, scene shop button. Open the page
Shops
How a place sells things to the player and buys things back, and how you stock the shelf. Open the page
Skill
An ability the player learns once and trains by use; actions can ask for it. Also called: skill tree node. Open the page
Starting count
How many of an item a game begins with, e.g. 3 wheat patches. Open the page
Starting item
One item, and how many of it, that a new game places into a location, a bag or a shop. Also called: starting inventory, loadout. Open the page
Starting item scopes
The ways a starting item can be attached, and the modes the world admin editors work in. Also called: global shop, location template, node override. Open the page
Starting items
How a game decides where each starting item goes: into a place, a backpack, a shop shelf or the whole game. What is placed in a location or inventory when a game begins. Open the page
Stats and tags
The named numbers and abilities a component can carry, such as Health, XP or Reaping, and how they pass from level to level. Also called: stat, attribute, capability, equipment slot. Open the page
Story
A cut-scene or a few lines of dialogue that plays over the game, and can be given to the player like any other component. Also called: cut scene, dialog. Open the page
Story sequences
How a story is put together: a timeline of layers and sound tracks, shown on a stage over the game. A cut-scene built from layers. Open the page
Structure
A building or machine in a scene that can make things for the player. A building or machine in a scene. The Edit Mode create menu calls it a Structure. Open the page

T

Takes health
An effect that wears down the thing the action is used on, such as a Harvestable's Health. Each use wears the target's Health down; at 0 it is destroyed. Open the page
Team button
A HUD button that opens the team panel, where the player hires and fires characters. Also called: party, characters menu. Open the page
Text layers
Words on the stage, typed out letter by letter, that can wait for the player to press Continue. Open the page
The HUD
The counters and buttons fixed around the edges of the game screen, and how you place them. Also called: screen item, counter, screen button, screen mode, HUD. Open the page
The property window
The Edit Mode window where you give a component stats and buffs, and set the rules of its actions. Open the page
The scene model
How a scene is measured and drawn: one size for the whole game, positions in pixels, and a view that fits the screen's height. Open the page
Theme colours
Every colour, border and corner setting in a game's theme, grouped by what it paints, with the editor's default for each. Also called: interface colours. Open the page
Token
An abstract number such as reputation or score, shown only as a counter on the screen. Also called: audience, reputation, skill points. Open the page
Tracking
A hidden counter the player carries, such as foes bested or pages found. Open the page
Trains a skill
An effect that adds experience to a skill the action asks for, so the skill grows with use. Open the page
Travel
Let players walk from one place to another, for free or for a price. Open the page

U

Unplaced Items
The tray that lists items that have no position in the scene. Open the page
Upgrade
Let players move a building or an item up to its next tier. Open the page

W

Wears the tool
An effect that changes a stat on the tool the player carries, usually to wear it down. Open the page
What can be placed where
Which kinds of component the builder lets you put in a scene, a shop or a character's bag. Open the page
Which menus the player sees
The switches that show or hide each tab of the Shop, Backpack and Journal panels. Also called: menus, tab visibility. Open the page
Worked examples and mistakes
Seven small designs in Vespera, each with the version that works, the near miss, and what the player sees. Open the page
World map
The painted board your locations sit on, and the map players open to see where they are. Also called: fog of war. Open the page

Y

Your first quest
Play the example game for about ten minutes, then open Edit Mode and look at how each thing you just did was built. Open the page