The Forge
Components & actions

Every sword, every coin, every hero began here as a component. Come, the fire is lit.
Everything in a MultiBit game is a component: the player's hero, the gold in their pocket, the mill in the village, even a quest. Each component has a type that says what kind of thing it is.
Components become interesting when you give them actions: things a player can do with them, or things that happen to them. An action can have requirements (what it needs before it can run) and effects (what it gives or changes).
How it connects
Components you make here are placed into locations in the Atlas, and story sequences in the Bard's Hall can be started by them.
Guides
- Create a quest Make a quest in Edit Mode that asks the player for some things and pays them a reward.
- Ask for a tool or a skill Make an action ask the player for a tool they carry and a skill they have learned.
- 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.
- 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.
- Make a shop Make a shop button in Edit Mode, place it, and stock its shelf with items that have a price.
- 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.
- 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. Still being forged
Component types
- Structure A building or machine in a scene that can make things for the player.
- Harvestable and Scenery Something fixed in a scene that players gather from, or that only decorates it.
- Material A stackable thing used as an ingredient or a yield: wood, ore, nails, wheat.
- Currency The coin of your game: earned, held in the player's wallet and spent.
- Recipe Crafting knowledge: what a player needs and what they get when they use it.
- Container A chest or storeroom that holds items the player moves in and out.
- Powerup A potion, charm or spell the player uses once for a boost.
- Research A long-term unlock the player earns once, for the whole game.
- NPC A character who stands in a scene, talks to the player and can hand things over.
- Interactable A fixed thing in a scene that the player taps: a lever, an altar, a shrine, a standing stone.
- Loot box A satchel, crate or sack the player opens once for a reward, often a surprise.
- Collectible A rare find the player keeps for completion or display, listed in the Journal's Collection tab.
- 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.
- Character A playable unit with levels, stats and a backpack: the player's hero or a staff member.
- Gear A tool, weapon or piece of equipment that gives its carrier a capability, a stat or a boost.
- Enemy A foe with its own Health, moves and loot, that the player fights.
- Character class A calling that gives a Character a permanent package of stats and bonuses.
- Skill An ability the player learns once and trains by use; actions can ask for it.
- Quest A goal the player picks up, completes by handing things in, and is paid for.
- Achievement A milestone that is earned automatically and shown in the journal.
- Token An abstract number such as reputation or score, shown only as a counter on the screen.
- Tracking A hidden counter the player carries, such as foes bested or pages found.
Action types
- Harvest Let players gather from something in a place, such as wheat, wood or ore.
- Make things Let a Structure turn what it needs into something new, over time.
- Craft Let players turn ingredients into something new with a Recipe.
- Destroy Let players break something up where it lies, and optionally hand back what was inside.
- Open Let players open, use or touch something to get what it holds or to trigger an effect.
- Buy Let players pay for an item at a shop and take it home.
- Learn Let a player pay a cost to gain a skill.
- Sell Let players sell an item they carry and be paid for it.
- Build Let players put up a building or a chest themselves, for a price.
- Complete Let a player hand in what a quest asks for and be paid, or claim an achievement.
- Upgrade Let players move a building or an item up to its next tier.
- Combat move An action a character, a weapon or a foe uses inside a fight, usually to take health from the other side.
- Travel Let players walk from one place to another, for free or for a price.
- Enemy defeated What a foe gives and changes when a fight takes its last health.
- Player defeated What happens to the player's character when a fight takes their last health.
- Flee An action to escape a fight. The game's own Flee! button already shows in every fight. Still being forged
- Agro An action on a foe that decides whether it attacks the player on arrival.
- 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.
- Research Let players study a topic and unlock what depends on it.
- Play story Let a character or a thing in a scene tell a story when the player taps it.
- Handle event Let a component react by itself, to something passed to it or to being acquired.
- Process awards Let a Structure take a share of every reward of one kind, wherever it comes from.
Requirements & effects
- Gives The yield of an action: what it hands out when it finishes.
- Needs (a cost) A requirement that asks for some amount of a component, and can use it up.
- Gives when used up A bonus that is handed out only when a Harvestable is finally used up.
- Needs a skill A requirement: the action will not start until the player has a certain skill.
- Needs research A requirement that locks an action until the player has finished a research topic.
- Needs a tool A requirement: the action will not start unless the player carries an item with a certain capability or stat.
- Needs a stat A requirement: the action will not start unless the player's own stat, such as Health, passes a test.
- Takes health An effect that wears down the thing the action is used on, such as a Harvestable's Health.
- Wears the tool An effect that changes a stat on the tool the player carries, usually to wear it down.
- Trains a skill An effect that adds experience to a skill the action asks for, so the skill grows with use.
- Changes a tracked stat An effect that changes a stat on a tracked item, a hidden counter such as the Ledger's Pages.
- Also takes, if there is any An extra cost that is taken when the player has it and ignored when they do not.
- Changes the character's stat An effect that heals, hurts, tires or rewards the character who ran the action.
- Send to An effect that moves the defeated character to a place you choose.
- Converts a share of what went in An effect that turns a percent of a stack the player holds into something else.
- Changes a place's stat An effect that raises or lowers a stat of the place where the action ran.
- Passes on an event An effect that tells the other components in the place that something was just given.
- Bonus rewards An effect: an extra reward that an action gives only while the player holds a certain item.
- A single reward One prize drawn from several: each prize has a weight, and exactly one is given each time.
- Nothing happens An empty ticket in a draw: when it is drawn, the outcome gives and changes nothing.
- Remove it after it runs Makes a component disappear once its action has finished: a satchel opened, a tonic drunk.
Ideas & systems
- Art for a component How a component gets its icon, and how a place gets its scene background.
- How a game fits together How components, levels, actions and their requirements and effects connect, traced through one workbench.
- 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.
- 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. Still being forged
- Comparisons The words 'at least', 'at most', 'exactly', 'fewer than' and 'more than' that a requirement uses, and how they differ from changes.
- Shops How a place sells things to the player and buys things back, and how you stock the shelf.
- 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. Still being forged
- Quests and achievements How a quest or achievement is handed out, turned in and followed by the next stage.
- 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.
- 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.
- Worked examples and mistakes Seven small designs in Vespera, each with the version that works, the near miss, and what the player sees.
- Bags and places Where things are kept: in the player's bag or in the place, and how rewards and requirements choose.
- Combat How a fight starts, runs and ends, and which actions you give the foe and the player. Still being forged