Ideas & systems

How a new game starts

Every journey has a first step, and the Ledger writes it down before the player ever arrives. Here is what happens between pressing Start and standing in the first scene.

What it is

When a player starts a new game, the game makes a fresh copy of your world just for them. It places the starting items you set up, puts the player in the start location, and plays the intro story if there is one.

A game you have not edited yet is small. It holds the player character, the first location, a map, and the usual screen buttons for the shop, the bag and the journal. It has no money, tools or trees until you add them.

How it works

  1. The game reads all the starting items for your game.
  2. It finds the player character. A game either names its player character, or lets the player choose one (see Good to know).
  3. It finds the start location. That is where the player character is placed. If no character is placed anywhere, the game makes a "Default Map" with a "Default Location" so that something exists.
  4. It sets up every place on the start map. The start location begins with a visit count of 1. The other places on that map begin at 0 until the player visits them.
  5. It places every starting item, including the things inside a place and the things in the player's bag.
  6. If the start location has a Travel action, the game runs it once on arrival. That is how the intro story reaches the player, and it raises the start location's visit count from 1 to 2.
  7. The game opens. The intro story plays once, from the player's first load. Afterwards it is marked finished, so reloading does not play it again.

Other maps are set up later, the first time the player travels to them.

In Vespera: a fresh game of Vespera Play it

A new game of Vespera starts with Frono standing in The Last Outpost. The only thing in Frono's bag is The Ledger of Making, with its pages at 0 of 7. Four paths lead out of the Outpost, and the Ledger Lectern stands in the square.

The intro story plays once. A game that has already started shows the story as finished in Frono's bag, and moving between places does not play it again.

Good to know

  • Fixed player or character select. If your game names a player character, the game starts straight away with it. If it does not, the player first sees a character select screen. This is a deliberate choice, not a mistake in the game.
  • Only characters placed in a location are offered. The select screen shows characters that sit inside a location. A character that is not inside one is not offered.
  • No player character, no game. If the game cannot find a player character to start from, creating the game fails with an error.
  • Intro stories need a new game. Games started before the intro was added do not receive it. Start a new game to see it.
  • New games hold no money. A newly created game has no gold, no tools and no trees. You add those yourself, or install an example set.
Under the hood
  • Places on other maps get their inventories only when the player first travels to that map. Then every place on that map is set up at once, each with a count of 0 until it is visited.
  • A place that uses a random location picks it when the place is set up. It is not picked again on a later visit.
  • A character that is placed on a node only, or at the top level, is returned to the client but never offered on the character select screen. The filter that hides it runs in the client; the server does not check it.
  • Moving the player to a new place sends one new Active row with the new parent, never a Deleted row and an Active row as a pair.