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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- Link two locations
- 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
- 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
- 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
- Path / link
- 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
- 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
- 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
- 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
- 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