Ideas & systems
How a game fits together
Every page in the Ledger rests on one small chain. Learn the chain once, and the rest is only names.
What it is
A game is built from a chain of four things. A component is anything that exists in your game. A component has one or more levels. A level can have actions, which are things it can do or have done to it. An action has requirements and effects: what it needs and what it gives or changes.
Requirements and effects are the rules. There is no separate list of rules anywhere else.
How it works
- You make a component. A sword, a shop, a coin or a workbench is a component of some type, such as Structure or Material.
- The component has levels. A level is a tier, like an axe at level 1, 2 and 3. A component with no levels has no actions.
- Actions belong to a level. A level can hold several actions, of the same or different types, such as two crafts and a buy.
- Requirements and effects belong to an action. They say what is used up, what is given, and what is changed.
- Your design is a pattern, not a thing. The component, its levels and its actions are the design. When a player holds one, or one stands in a place, that is a copy made from the design. Each copy has its own values, copied from the level when it was created.
- Someone runs the action. A run has a start, which checks and uses up what the action needs, and an end, which gives what it makes and applies changes. A quick action does both at once. A timed action ends later.
In Vespera
In Vespera: the Tinker's Bench Play it
Follow the bench down the chain.
- Component. The Tinker's Bench is a Structure.
- Level. It has one level.
- Action. That level has one action, Make things, named Make nails. It takes 10 seconds.
- Requirements and effects. It needs 1 Scrap Iron, taken from the place and used up. It gives 2 Iron Nails into the place. It also gives the player 1 XP.
- Placed. The bench is a starting item in the Silent Forge, with a starting count of 1, so every new game begins with it there.
- Played. In a game, the player taps the bench. The run starts and uses up a Scrap Iron. Ten seconds later it ends and 2 Iron Nails arrive.
Good to know
- One design, many copies. Fifty Iron Nails in a bag are fifty copies of one design. Each copy carries its own attribute values, so one can differ from another.
- The editor guides, it does not enforce. The editor offers only the actions that suit a component type. The engine itself does not check that.
Under the hood
- The editor only offers some actions on some component types, and suggests some requirements and effects for some actions. These are guides for the editor. The game engine runs whatever actions and effects exist on a level.
- A component's pictures and sounds belong to its levels, and a level with none borrows from the one below. See Art for a component.