Front cover

3 The player and the start

A story needs someone to be. In Chord the player is not a special object that exists before you write anything. The player is a role, and at the start of the story you hand that role to a person you have made. This chapter makes the person and hands over the role.

3.1 Making Ansel

The Relighting is played as Ansel, who was a student at Lanternhall for one term thirty years ago and has walked back this morning. Here is Ansel in full.

create Ansel
  a person
  playable
  starts in the Lodge

  You were a student here once, for a term. You have the same hands and
  not much else.

The header line, create Ansel, makes something and names it. Chapter 5 has much more to say about create, since everything in a story’s world is made with it. For now it is enough to read the three short lines beneath the header, each of which states one fact.

a person says what kind of thing Ansel is. A person can carry things and wear things, and is someone in the story rather than something.

playable says that Ansel may hold the player role. Only a person can be playable. This line does not make Ansel the player. It makes Ansel a person who is allowed to be.

starts in the Lodge says where Ansel is when the story begins. The Lodge is the one room the story has so far.

After the blank line comes Ansel’s description. The player reads it by typing examine me:

> examine me
You were a student here once, for a term. You have the same hands and not much else.

Notice that the description is written to the player, as “you”. Everything the player reads in The Relighting is in the second person and the present tense, which is the custom in interactive fiction, and you will be writing in that voice from here on. A description is optional. If you leave Ansel’s out, the platform supplies its stock answer, which is “As good-looking as ever.”

3.2 Handing over the role

Making a playable person is half of the job. The other half is the last block in the file.

before the game starts
  change the player to Ansel
end before

This is the start block. It runs once, before the first turn, and its job is to say who the player is. The line inside it, change the player to Ansel, gives the role to Ansel. When the story opens, the player is standing where Ansel starts, which is the Lodge.

The phrase the player deserves a moment. It does not name a person. It means whoever holds the role at the time. Later in this book you will write lines such as “when the player takes the lamp”, and those lines will go on working if the role moves to someone else in the middle of the story. Chapter 31 does exactly that.

A story has exactly one start block, and the block must hand the role to someone. It may go anywhere in the file after the header. This book puts it last.

3.3 What the start block is not for

The start block is not the place to greet the player. It runs before there is a turn to carry any text, so it cannot print anything. The words the player reads first belong in the header’s prologue: field, which chapter 2 described. Keep the two apart in your mind: the prologue is what the player reads at the start, and the start block is what the story arranges at the start.

3.4 The opening

Once the start block has run, the story does three things unasked, before the player has typed a word. It prints the prologue. It prints the title with the description, the authors and the version, which together are called the banner. Then it takes a first look at the room the player is standing in. These three together are the opening.

You were here for one term, thirty years ago, and you would have said you remembered none of it. Then last week a candle leaned toward your hand, and you started walking.

The Relighting
Thirty years after the magic went out of the world, a lamp burns blue.
By The Sharpee Project
Story v0.1.0

Lodge
The porter's lodge is one small room built into the thickness of the gate arch. A chair, a kettle and thirty years of newspapers have filled most of it. On the sill a lamp is burning with a steady blue flame.

The opening is not a turn. Nobody typed anything, so nothing that counts turns has counted one, and the first command the player types is turn 1. That will matter in chapter 19, where the story gets a clock.

Each of the three has a name, and a second block lets you say which of them run and in what order.

when the game starts
  show-prologue
  show-banner
  do-first-look
end when

This is the opening block. It opens with when the game starts and closes with end when, and between them it holds the names of the opening’s three routines, each alone on its line. The block above is the order a story gets when it has no opening block at all, so adding it to your file changes nothing.

Change the order of the lines and the opening changes with them. Here the banner comes first, in the way of a book that puts its title page before its first paragraph.

when the game starts
  show-banner
  show-prologue
  do-first-look
end when
The Relighting
Thirty years after the magic went out of the world, a lamp burns blue.
By The Sharpee Project
Story v0.1.0

You were here for one term, thirty years ago, and you would have said you remembered none of it. Then last week a candle leaned toward your hand, and you started walking.

Lodge
The porter's lodge is one small room built into the thickness of the gate arch. A chair, a kettle and thirty years of newspapers have filled most of it. On the sill a lamp is burning with a steady blue flame.

A routine you leave out does not run. A block without do-first-look prints the prologue and the banner and then waits, and the player reads about the Lodge only when they look for themselves. A block with no lines in it prints nothing at all.

The block holds routines and nothing else. Each may appear once, and show-prologue may appear only in a story whose header has a prologue: field. The compiler refuses a routine written twice, and it refuses any other statement:

relighting.story:36:3 error [analysis.opening-routine-repeated] `show-banner` is already in this block. An opening runs each routine once; take this line out.
relighting.story:36:3 error [parse.opening-statement] `phrase hello` cannot go in a `when the game starts` block. The block holds only the opening's routines, each alone on its line: `show-prologue`, `show-banner`, `do-first-look`.

A story has at most one opening block, and like the start block it may go anywhere in the file after the header. The two are easy to tell apart by their first words. before the game starts arranges the world and prints nothing. when the game starts prints the opening and arranges nothing.

The Relighting keeps the usual order, so this book’s story has no opening block, and you need not add one.

3.5 When it goes wrong

There are four mistakes to make here, and the compiler catches three of them.

If you leave the start block out, the story has no player:

relighting.story:4:1 error [analysis.start-block-missing] This story never says who the player is. Add a `before the game starts` block assigning the role: `change the player to <character>`.

If you hand the role to a person who is not playable, the compiler tells you which line to add:

relighting.story:30:3 error [analysis.player-target-not-playable] `ansel` is not `playable` — add `playable` to its create block to let the player role move to it.

If you write two start blocks, the compiler asks you to merge them.

The fourth mistake is leaving out starts in the Lodge. The compiler accepts that story, and the mistake shows itself only when you try to play:

Error loading story: Story player "Ansel" (ansel) is not placed in the world — an unplaced player character is nowhere to play.

So give every playable person a place to start, whatever the compiler says.

Under the Hood: the player role · sharpee compose

In the Story IR, each thing you create is an entry in entities, and playable is a flag on that entry:

"name": "Ansel",
"article": null,
"aka": [],
"isPlayable": true,

The platform never begins with a player of its own. When it loads a story it runs the start block, finds the person who now holds the role, and refuses to start if that person has no place in the world. That refusal is the error you have just read.

From another system: the player character

In Inform 10 a story has a player without your asking for one, and the first thing an author says about the player is where they are. TADS 3 has you define the player character as an object and name it in the game’s main object. Chord has no default player at all. A story with no start block does not compile, which means the question of who the player is always has an answer you wrote.

3.6 What you have so far

The whole of relighting.story is now explained except for the room in the middle, and you have typed all of it. The next chapter builds it, plays it, and breaks it on purpose.