Inform 7 v10 Docs Search

At its simplest, the interactive fiction will be simulating a physical world to explore. The forerunner of today's IF is generally agreed to be a computer simulation by Will Crowther of the exploration of a cave system in the Mammoth and Flint Ridge chain of caves in Kentucky, a part of which might be described in Inform thus:

"Cave Entrance"

The Cobble Crawl is a room. "You are crawling over cobbles in a low passage. There is a dim light at the east end of the passage."

A wicker cage is here. "There is a small wicker cage discarded nearby."

The Debris Room is west of the Crawl. "You are in a debris room filled with stuff washed in from the surface. A low wide passage with cobbles becomes plugged with mud and debris here, but an awkward canyon leads upward and west. A note on the wall says, 'Magic word XYZZY'."

The black rod is here. "A three foot black rod with a rusty star on one end lies nearby."

Above the Debris Room is the Sloping E/W Canyon. West of the Canyon is the Orange River Chamber.

Here we sketch in four of Crowther's locations, and two objects: just enough to be able to walk around the caves and pick up the rod and the cage. The text in quotation marks will appear verbatim as paragraphs shown to the player as the caves are explored. The first paragraph, as we have seen, is the title of the work. The other quotations describe the places and objects introduced.

If we play this story, we find that we can type TAKE CAGE or TAKE WICKER CAGE, for instance, but not TAKE SMALL CAGE. Inform saw that we called this "a wicker cage" when it first appeared in the source text, and assumed that the player would call it that, too. (Whereas it didn't look inside the descriptive text to allow for TAKE SMALL CAGE or TAKE DISCARDED CAGE or TAKE NEARBY CAGE.) A small limitation here is that probably only the first 9 letters of each word are read from the player's command. This is plenty for handling the wicker cage and the black rod, but it might be embarrassing at a meeting of the Justice League to find that KISS SUPERHERO and KISS SUPERHEROINE read as if they are the same command.

So we have already found that Inform has made some assumptions about what we want, and imposed some limitations on how much computational effort to go to when the work of IF is finally played. If Inform guesses what we need wrongly, we need to know more advanced features of the language in order to overcome these problems. (We shall see how to change the way the player's commands are read in the chapter on Understanding.)

This is often how Inform works: make the standard way of doing things as simple as possible to describe, but allow almost any behaviour to be altered by more elaborate source text. As an example of that, the player begins in the Cobble Crawl because it was the first room created in the source text, but we could instead have written text like:

The player is in the Cobble Crawl.

to override that. This can make the source text easier to follow if the rooms are sometimes being created in a less obvious way. For example, if we write:

The silver bars are in the Y2 Rock Room.
The Cobble Crawl is a room. South of the Crawl is Y2.

then the first room to be created will actually be the Y2 Rock Room, so that's where the player will be starting unless we say otherwise.

Examples

Bic ★

Testing to make sure that all objects have been given descriptions.

RB 13.1 Testing

Verbosity 1 ★

Making rooms give brief room descriptions when revisited.

RB 6.4 Looking

Slightly Wrong ★★

A room whose description changes slightly after our first visit there.

RB 3.1 Room Descriptions

🔗

WI §3.2 Rooms and the map

Rooms are joined together at their edges by "map connections", most of which are pathways in one of the eight cardinal compass directions: north, northeast (written without a hyphen), east, southeast, south, southwest, west, northwest. We also have up and down, suitable for staircases or ladders. In real life, people are seldom conscious of their compass bearing when walking around buildings, but it makes a concise and unconfusing way for the player to say where to go next, so is generally accepted as a convention of the genre.

Two more directions are provided by Inform: "inside" and "outside". These are best used when one location is, say, a meadow and the other is a woodcutter's hut in the middle of it; we might then say

Inside from the Meadow is the woodcutter's hut.

The "from" is important, as it clarifies that we intend to link two different locations, not to create an item - the hut - in a single location - the meadow.

A problem which sometimes arises when laying out maps is that Inform allows short forms of room names to be used as abbreviations. This is usually a good idea, but has unfortunate results if we write:

The Airport Road is west of the Fish Packing Plant. The Airport is west of the Airport Road.

…because "Airport" is taken as a reference to "Airport Road", so Inform makes only two locations, one of which supernaturally leads to itself. We can avoid this by writing:

The Airport Road is west of the Fish Packing Plant. A room called the Airport is west of the Airport Road.

Using "called" is often a good way to specify something whose name might give rise to confusion otherwise. It always makes something new, and it is also neatly concise, because we can establish something's kind and name in the same sentence. As another example, suppose we want to create a room called "South of the Hut", to south of the Hut. We can't do so like this:

South of the Hut is a room. South of the Hut is south of the Hut.

…because Inform will read that first sentence as placing a (nameless) room to the south of a room called "Hut". Once again "called" can save the day:

South of the Hut is a room called South of the Hut.

It is best to use "called" in the simplest way possible, and in particular, best not to use "called" twice in the same sentence. Consider:

The kitchen cabinet contains a container called a mixing bowl and a portable supporter called a platter.

It is unlikely that anyone would want to name something "a mixing bowl and a portable supporter called a platter", but not impossible, and Inform tends not to be a good judge of what is likely.

(If we really want to get rid of this issue once and for all, starting the source text with the use option "Use unabbreviated object names." will do it, but the effect is drastic. This instructs Inform not to recognise names other than in full. For example:

West of the Kitchen is the Roaring Range. South of the Range is the Pantry.

is ordinarily read by Inform as constructing three rooms (Kitchen, Roaring Range, Pantry); but with this use option set, it makes four (Kitchen, Roaring Range, Range, Pantry), in two disconnected pieces of map. Handle with care.)

Examples

Port Royal 1 ★

A partial implementation of Port Royal, Jamaica, set before the earthquake of 1692 demolished large portions of the city.

RB 3.2 Map

Up and Up ★★

Adding a short message as the player approaches a room, before the room description itself appears.

RB 6.9 Going, Pushing Things in Directions

Starry Void ★★★

Creating a booth that can be seen from the outside, opened and closed, and entered as a separate room.

RB 3.3 Position Within Rooms

🔗

WI §3.3 One-way connections

Connections are ordinarily two-way, but do not have to be. One of the map connections in the Mammoth Cave simulation was made by the sentence:

The Debris Room is west of the Crawl.

Besides reading this sentence at face value, Inform also deduced that the Crawl was probably meant to be east of the Debris Room: in other words, that the path between them is a two-way one. When Inform makes guesses like this, it treats them as being less certain than anything explicitly stated in the source. Inform will quietly overturn its assumption if information comes to hand which shows that it was wrong. That might happen in this case if another sentence read:

The Hidden Alcove is east of the Debris Room.

These two sentences are not contradictory: Inform allows them both, simply accepting that the world is more complicated than it first assumed. There are relatively few situations where Inform has to make educated guesses, but when it does, it tries always to follow Occam's Razor by constructing the simplest model world consistent with the information in the Source text.

We can even explicitly make a route which turns around as it leads between two rooms:

West of the Garden is south of the Meadow.

If we want to establish a route which cannot be retraced at all, we can specify that a particular direction leads nowhere:

East of the Debris Room is nowhere.

Finally, note that Inform's assumptions about two-way directions are only applied to simple sentences. When the source text seems to be saying something complicated, Inform takes it as a precise description of what's wanted. So, for example, in:

The Attic is above the Parlour.
The Attic is a dark room above the Parlour.

Inform makes guesses about the first sentence, and makes a two-way connection; but it accepts the second sentence more precisely, with just a one-way connection.

Examples

Port Royal 2 ★

Another part of Port Royal, with less typical map connections.

RB 3.2 Map

The Unbuttoned Elevator Affair ★

A simple elevator connecting two floors which is operated simply by walking in and out, and has no buttons or fancy doors.

RB 8.2 Ships, Trains and Elevators

🔗

WI §3.4 Regions and the index map

Rooms represent individual places to which one can go, but we tend to think of the world around us in larger pieces: we think of a house and a garden, rather than each of the single rooms of the house and all corners of its garden. To Inform a collection of rooms is called a "region", and we can create one like so:

The Arboretum is east of the Botanical Gardens. Northwest of the Gardens is the Tropical Greenhouse.
 
The Public Area is a region. The Arboretum and Gardens are in the Public Area.

The real usefulness of creating regions like "Public Area" will only appear later, when we begin defining rules of play which apply in some areas but not others, but in the mean time we can see the effect by turning to the World tab of the Index. In the World Index, Inform draws a map - or at least a stylised attempt at a diagram of the rooms and their connections: this will not always correspond to how we imagine things, but with any luck it should mostly be right.

Rooms are represented by coloured squares, and the colour-coding is done by region. In the above example, the two "Public Area" rooms are coloured green (as it happens); the Greenhouse, since it belongs to no region, is a neutral grey.

Regions can be put inside each other:

The University Parks is a region. The Public Area is in the University Parks.

but they are not allowed to overlap other than by one being entirely inside the other.

Example

10.

Port Royal 3 ★

Division of Port Royal into regions.

RB 3.2 Map

🔗

WI §3.5 Kinds

The following description runs to only 33 words, but makes a surprisingly intricate design. It not only places things within rooms, but also places them very specifically with respect to each other:

"Midsummer Day"
 
East of the Garden is the Gazebo. Above is the Treehouse. A billiards table is in the Gazebo. On it is a trophy cup. A starting pistol is in the cup.

Inform needs to identify the places and objects being described by the nouns here, and to guess what it can about them. For instance, the pistol can be picked up but not walked inside, whereas the Treehouse is the reverse. (This is obvious to someone who knows what these words mean, less obvious to a computer which does not, but the text contains sufficient clues.) Inform does this by sorting the various nouns into different categories, which are called "kinds". For instance:

Garden, Gazebo, Treehouse - room
billiards table - supporter
cup - container
starting pistol - thing
East, up (implied by "above") - direction

(A container is something which can contain other things, and a supporter similarly.) For instance Inform knows that if one thing is in another, then the second thing is either a room or a container, and if one thing is on another, the second thing is a supporter. This worked nicely for the design above, but:

In the Treehouse is a cardboard box.

results in the cardboard box being made only a "thing": because nothing has been put inside it, there is no reason for Inform - which does not know what a cardboard box looks like - to guess that it is a "container". So we need to add:

The box is a container.

It is rather clumsy to have to write two sentences like this, so we would normally write this instead:

In the Treehouse is a container called the cardboard box.

Examples

11.

First Name Basis ★

Allowing the player to use different synonyms to refer to something.

RB 2.2 Varying What Is Read

12.

Midsummer Day ★

A few sentences laying out a garden together with some things which might be found in it.

RB 1.1 Preface

🔗

WI §3.6 Either/or properties

Some containers, like bottles, can be opened: others, like buckets, cannot. If they can be opened, then sometimes they will be open, and sometimes closed. These are examples of properties, which can change during play. The following source sets some properties:

The cardboard box is a closed container. The glass bottle is a transparent open container. The box is fixed in place and openable.

There are only four different properties referred to here. Closed means not open, and vice versa, so these two adjectives both refer to the same property. (As might be expected, when a container is open, one can see inside and place things within, or take them out.) The glass bottle and the box being containers is a matter of their kinds, which is something fundamental and immutable, so "container" does not count as a property.

A "transparent" container is one which we can see inside even when it is closed, and the opposite is an "opaque" container.

The property of being "fixed in place" ensures that the player cannot pick the item up and walk away with it: this is useful for such things as oak trees or heavy furniture. The opposite condition is to be "portable".

A container which is "openable" can be opened or closed by the player; as might be expected, the opposite is "unopenable".

With a really large cardboard box, we might imagine that the player could get inside: such a container should be declared "enterable".

Example

13.

Tamed ★

Examples of a container and a supporter that can be entered, as well as nested rooms.

RB 8.4 Furniture

🔗

WI §3.7 Properties depend on kind

Properties depend very much on kind. It makes no sense to ask whether a room is transparent or opaque, for instance, so Inform will not allow this either to be specified or queried.

Another way that kind influences properties can be seen from an earlier example:

The Gazebo is a room. A billiards table is in the Gazebo. On it is a trophy cup. A starting pistol is in the cup.

The cup, the pistol and the table are all allowed to have the "fixed in place" property, but in fact only the table actually has it: the cup and the pistol are created as "portable" instead. This is because Inform knows that most things are portable, but that supporters - such as the table - are usually fixed in place. If this assumption is wrong, we need only add the line:

The table is portable.

Example

14.

Disenchantment Bay 1 ★

A running example in this chapter, Disenchantment Bay, involves chartering a boat. This is the first step: creating the cabin.

RB 1.3 Disenchantment Bay

🔗

WI §3.8 Scenery

As we have just seen, making something "fixed in place" will prevent it from being picked up or moved. But it remains substantial enough to be described in its own paragraph of text when the player visits its location. This can be unfortunate if it has also been described already in the body of the main description for that location. For instance, if we wrote:

The Orchard is a room. "Within this quadrille of pear trees, a single gnarled old oak remains as a memory of centuries past." The gnarled old oak tree is fixed in place in the Orchard.

This would end up describing the oak twice, once in the paragraph about the Orchard, then again in a list of things within it:

Orchard
Within this quadrille of pear trees, a single gnarled old oak remains as a memory of centuries past.
 
You can see a gnarled old oak tree here.

We avoid this by making it "scenery" instead of "fixed in place":

The gnarled old oak tree is scenery in the Orchard.

Any thing can be scenery, and this does not bar it from playing a part in the story: it simply means that it will be immobile and that it will not be described independently of its room. Being immobile, scenery should not be used for portable objects that are meant to be left out of the room description.

If a supporter is scenery, it may still be mentioned in the room description after all, but only as part of a paragraph about other items, such as

On the teak table are a candlestick and a copy of the Financial Times.

If the player takes the candlestick and the Times, the teak table will disappear from mention. (Scenery containers do not behave in this way: their contents are assumed to be less immediately visible, and will be mentioned only if the player looks inside them.)

Examples

15.

Disenchantment Bay 2 ★

Disenchantment Bay: creating some of the objects in the cabin's description.

RB 1.3 Disenchantment Bay

16.

Replanting ★

Changing the response when the player tries to take something that is scenery.

RB 6.8 Taking, Dropping, Inserting and Putting

🔗

WI §3.9 Backdrops

It is a cardinal rule that nothing can be in more than one place at the same time, but rules were made to be broken, and an exception is allowed for a special kind of thing called a "backdrop". For instance:

"Streaming"

The Upper Cave is above the Rock Pool.

The stream is a backdrop. It is in the Upper Cave and the Rock Pool.

Backdrops are ordinarily in the background: if the sky needed to be referred to in the course of play, it might be represented by a backdrop, for instance. Here we have a stream of water running through two rooms, though it might be any number. Backdrops are always fixed in place.

Backdrops can be put in regions as well as rooms, and if so, then they are present at every room in the given region (or regions), as well as any specific rooms they may also be put into. For instance:

The Outdoors Area is a region. The Moon is a backdrop. The Moon is in the Outdoors Area. The Moon is in the Skylight Room.

The special place "everywhere" can be given as the location of a backdrop to make it omnipresent:

The sky is a backdrop. The sky is everywhere.

Inform assumes that backdrops are also scenery unless told otherwise, so this will not result in messages like "You can also see the sky here." being included in room descriptions. In the case of the stream above, we could artfully mention it in passing in the room descriptions of the Upper Cave and the Rock Pool.

Example

17.

Disenchantment Bay 3 ★

Disenchantment Bay: adding a view of the glacier.

RB 1.3 Disenchantment Bay

🔗

WI §3.10 Properties holding text

The properties we have seen so far have all been either/or: either open or closed, either transparent or opaque, either fixed in place or portable, either openable or not openable. However, some properties can have a much wider range of possibilities. For instance, the "description" of a room is the text revealed when the player first enters it, or types "look". This needs to be textual: Inform would complain if, for instance, we tried to set the description of something to the number 42. We have already seen a concise way to set the description of a room:

The Painted Room is north of the Undertomb. "This is the Painted Room, where strange wall drawings leap out of the dark at the gleam of your candle: men with long wings and great eyes, serene and morose."

This does the same thing as:

The Painted Room is north of the Undertomb. The description of the Painted Room is "This is the Painted Room, where strange wall drawings leap out of the dark at the gleam of your candle: men with long wings and great eyes, serene and morose."

Or even:

The Painted Room is north of the Undertomb. The description is "This is the Painted Room, where strange wall drawings leap out of the dark at the gleam of your candle: men with long wings and great eyes, serene and morose."

🔗

WI §3.11 Two descriptions of things

The player's first sight of something is the text used as its "initial appearance":

The plain ring is here. "Cast aside, as if worthless, is a plain brass ring."

This text appears as a separate paragraph in the text describing the Painted Room. It will continue to be used until the first time player picks the ring up (if this ever happens), so it normally describes things in their original, undisturbed context. (Inform uses an either/or property called "handled" for this: something is "handled" if it has at some point been held by the player.)

Thus when a piece of text stands alone as a sentence in its own right, then this is either the "description" of the most recently discussed room, or the "initial appearance" of the most recently discussed thing. Either way, it is used verbatim as a paragraph in the text shown to the player visiting the room in question.

But a thing also has an ordinary "description", which is used to give a close-up look at it. This text is ordinarily only revealed to the player when a command like "examine ring" is keyed in:

The description of the plain ring is "No better than the loops of metal the old women use for fastening curtains."

Examples

18.

Disenchantment Bay 4 ★

Disenchantment Bay: fleshing out the descriptions of things on the boat.

RB 1.3 Disenchantment Bay

19.

Laura ★★

Some general advice about creating objects with unusual or awkward names, and a discussion of the use of printed names.

RB 2.2 Varying What Is Read

🔗

WI §3.12 Doors

The map of an interactive fiction is the layout of rooms and the entrances and exits which connect them. So far, these map connections have always run from one room to another, like so:

The Painted Room is north of the Undertomb.

However, we can also interpose doors between rooms, like so:

The heavy iron grating is east of the Orchard and west of the Undertomb. The grating is a door.

The second sentence is needed since otherwise Inform will take "heavy iron grating" to be the name of a third room, whereas what we want is for the grating to be something physically present in both the Orchard and in the Undertomb, and acting as a conduit between them. To this end it needs to be a "door", a kind we have not so far seen. In the absence of any other instruction, a newly created door will be fixed in place, closed and openable.

The grating really does come in between the two rooms: the grating is what lies immediately east of the Orchard, not the Undertomb room. So if we wrote the following:

The Undertomb is east of the Orchard. The heavy iron grating is east of the Orchard and west of the Undertomb. The grating is a door.

then Inform would say that this is a contradiction: we said the Undertomb was east of the Orchard, but then we said that the grating was east of the Orchard.

Inform's "door" kind can be used for all manner of conduits, so the word door need not be taken literally. In Ursula K. Le Guin's beguiling novel "The Tombs of Atuan", from which the above rooms are stolen, it is not a grating which interposes, but:

The red rock stair is east of the Orchard and above the Undertomb. The stair is an open door. The stair is not openable.

In real life, most doors are two-sided, and can be used from either of the rooms which they join, but this is not always convenient for interactive fiction. Here is a one-sided door:

The blue door is a door. It is south of Notting Hill. Through it is the Flat Landing.

(Note the use of "it" here as an optional abbreviation.) This will make a door visible only on the Notting Hill side; no map connection will be made in the reverse direction, unless we ask for one.

So much for creating and describing individual doors. Once we need to write about doors in general, we are likely to want a way to find out where a given door sits in the map. The following phrases reveal this:

front side of (object) ⇒ room

This phrase produces the first of the one or two rooms containing a door - first in the order given in the source text. Example: if

The red rock stair is east of the Orchard and above the Undertomb.

then "front side of the red rock stair" produces the Orchard. For a one-sided door, this produces the only room containing the door.

back side of (object) ⇒ room

This phrase produces the last of the one or two rooms containing a door - last in the order given in the source text. Example: if

The red rock stair is east of the Orchard and above the Undertomb.

then "back side of the red rock stair" produces the Undertomb. A one-sided door has no "back side."

More often, we are dealing with a door and want to know what it leads to, but that depends where we're standing:

other side of (door) from (room) ⇒ object

This phrase produces the room on the other side of the door, as seen from the given vantage point, which needs to be one of its sides. Example: if

The red rock stair is east of the Orchard and above the Undertomb.

then "other side of the red rock stair from the Undertomb" produces the Orchard, and vice versa.

direction of (door) from (room) ⇒ object

This phrase produces the direction in which the door leads, as seen from the given vantage point, which needs to be one of its sides. Example: if

The red rock stair is east of the Orchard and above the Undertomb.

then "direction of the red rock stair from the Undertomb" produces up.

Examples

20.

Disenchantment Bay 5 ★

Disenchantment Bay: adding the door and the deck to our charter boat.

RB 1.3 Disenchantment Bay

21.

Escape ★★

Window that can be climbed through or looked through.

RB 3.6 Windows

22.

Garibaldi 1 ★★★

Providing a security readout device by which the player can check on the status of all doors in the game.

RB 3.5 Doors, Staircases, and Bridges

🔗

WI §3.13 Locks and keys

It seems unwise for a door in Notting Hill to be unlocked, so:

The blue door is lockable and locked. The matching key of the blue door is the brass Yale key.

Since the second sentence here is a little clumsy, we can equivalently say

The brass Yale key unlocks the blue door.

Yet a third way to say this is:

The blue door has matching key the brass Yale key.

This introduces three new properties: a door can be locked or unlocked; lockable or not lockable; and it can have a matching key, which must be another thing. The same thing can be the matching key of many different locks: and note that a door can be locked and even lockable without having a matching key at all, in which case the player trying to open it will be permanently out of luck. Doors are ordinarily unlocked, not lockable, and without a matching key.

Containers can also have locks, in exactly the same way, and are allowed to have the same properties. On the other hand supporters never have locks: it makes no sense to be able to lock a tabletop, for instance, and Inform will not allow any discussion of the matching key of a supporter, or of a supporter being locked or unlocked.

Examples

23.

Disenchantment Bay 6 ★

Disenchantment Bay: locking up the charter boat's fishing rods.

RB 1.3 Disenchantment Bay

24.

Neighborhood Watch ★★

A locked door that can be locked or unlocked without a key from one side, but not from the other.

RB 3.5 Doors, Staircases, and Bridges

🔗

WI §3.14 Devices and descriptions

A "device" is another of the standard kinds of thing, and should be used for anything which can be switched on or off: a light switch, say, or a slide projector. Devices are generally machines, clockwork or electrical. A device is always either "switched on" or "switched off", but is switched off unless we specify otherwise.

That makes three kinds of thing which will likely change their appearance according to which of their two possible states they are in: doors and containers, which can be open or closed; and devices, which can be switched on or switched off. We would like to produce text accordingly, and we can do this using Inform's ability to make (almost) any piece of text change with circumstances. For instance:

The coffin is an openable container in the Undertomb. "[if open]The lid of a plank coffin yawns open.[otherwise]A plank coffin lies upon the dirt floor of the Tomb."

We could use a similar trick to make the appearance of a device change "if switched on". There will be much more about text substitutions, as instructions in square brackets like these are called, in later chapters.

Examples

25.

Disenchantment Bay 7 ★

Disenchantment Bay: making the radar and instruments switch on and off.

RB 1.3 Disenchantment Bay

26.

Down Below ★★

A light switch which makes the room it is in dark or light.

RB 3.7 Lighting

🔗

WI §3.15 Light and darkness

Rooms can be "dark" or "lighted", though they are lighted by default, and are lighted in all the examples we have seen so far.

The Sinister Cave is a dark room. "A profoundly disquieting rock formation, apparently sculptured by some demonic hand, this is not a cave in which to relax."

When the player is in a dark room, he can still go in various directions, but he cannot see the room description or interact with any of the objects in the room, except those he is holding. This means that, unless we should change the Cave in some way during play, the text above ("A profoundly…") will only be read if the player succeeds in bringing light into the Cave, perhaps by bringing along the following:

The flaming torch is in the Sandy Passage. "Stuck loosely into the sand is a flaming torch." The flaming torch is lit.

A thing with the property of being "lit" will enable the player to see inside dark rooms, and to carry out other activities requiring light, such as examining items. A lit thing in an open container will still light up a room; a lit thing in a closed container will not, unless the container has been given the "transparent" property.

It is possible to adjust the way darkness behaves, and we will see more on this topic in the chapter on Activities.

WI §3.16 Vehicles and pushable things

Next in the tour of standard kinds is the "vehicle". This behaves like (indeed, is) an enterable container, except that it will not be portable unless this is specified.

In the Garage is a vehicle called the red sports car.

The player can enter the sports car and then move around riding inside it, by typing directions exactly as if on foot: and the story will print names of rooms with "(in the red sports car)" appended, lest this be forgotten.

We have already seen that some things are portable, others fixed in place. In fact we can also make a third sort of thing: those which, although not portable, can be pushed from one room to another with commands like "push the wheelbarrow north". At a pinch, we might just be willing to allow:

The red sports car is pushable between rooms.

But of course this is a property which almost any thing can have, not just a vehicle. (Only "almost" because Inform will not allow a door to be pushable between rooms, in the interests of realism rather than surrealism.)

If we need vehicles which the passenger sits on top of, like a horse or a tractor, the standard "vehicle" kind will not be ideal. However, by loading one of the extensions which comes ready-installed:

Include Rideable Vehicles by Graham Nelson.

…we are provided with two more kinds, "rideable vehicle" and "rideable animal", just right for the tractor and the horse respectively. (As with all extensions, the documentation can be seen by clicking Go on some source which contains the above line, and then turning to the Contents index; or from the Installed Extensions tab of the Extensions panel.)

Examples

27.

Peugeot ★

A journey from one room to another that requires the player to be on a vehicle.

RB 8.1 Bicycles, Cars and Boats

28.

Disenchantment Bay 8 ★★

Disenchantment Bay: a pushable chest of ice for the boat.

RB 1.3 Disenchantment Bay

29.

Hover ★★★

Letting the player see a modified room description when he's viewing the place from inside a vehicle.

RB 8.1 Bicycles, Cars and Boats

🔗

WI §3.17 Men, women and animals

Rounding out the standard kinds provided by Inform are four for living things: "person", which is a kind of thing, and "man", "woman" and "animal", all kinds of person. For instance:

In the Ballroom is a man called Mr Darcy.

For the time being, men and women will be little more than waxworks: they will come to life only when we go beyond the present stage of creating an initial state of the world.

People can be male or female: this is an either/or property for the "person" kind, and it affects play at run-time a little, because the player can use "him" and "her" to refer to male or female people encountered. Men and women are always male and female respectively, and for animals we can choose either way, for example making a stallion male or a nanny goat female. Animals are male unless we say otherwise.

If our animal is instead something like a beetle or an earthworm, where gender doesn't seem to matter or even to exist, we can use the further property "neuter":

The spider is a neuter animal in the Bathroom.

The Standard Rules don't make people behave differently according to their genders, and the main difference comes down to language: whether we want the animal to be called "her", or "it". Because of the existence of "neuter", we sometimes need to be cautious about the use of the adjective "male": since Inform, partly for historical reasons, uses an either/or property for masculinity, neuter animals are also "male".

Example

30.

Disenchantment Bay 9 ★

Disenchantment Bay: enter the charter boat's Captain.

RB 1.3 Disenchantment Bay

🔗

WI §3.18 Articles and proper names

Suppose we have said that:

In the Ballroom is a man called Mr Darcy.

When the Ballroom is visited, the man is listed in the description of the room as "Mr Darcy", not as "a Mr Darcy". This happened not because Inform recognised that Darcy is a proper name, or even because men tend to have proper names, but because Inform noticed that we did not use "a", "an", "the" or "some" in the sentence which created him. The following shows most of the options:

The Belfry is a room. A bat is in the Belfry. The bell is in the Belfry. Some woodworm are in the Belfry. A man called William Snelson is in the Belfry. A woman called the sexton's wife is in the Belfry. A man called a bellringer is in the Belfry.
 
In the Belfry is a man called the vicar. The indefinite article of the vicar is "your local".

In the resulting story, we read:

You can see a bat, a bell, some woodworm, William Snelson, the sexton's wife, a bellringer and your local vicar here.

The subtlest rule here is in the handling of "the". We wrote "The bell is in the Belfry", but this did not result in the bell always being called "the" bell: in fact, writing "A bell is in the Belfry" would have had the same effect. On the other hand, "A woman called the sexton's wife is in the Belfry." led to the wife always being known as "the" sexton's wife, not "a" sexton's wife, because Inform thinks the choice of article after "called" shows more of our intention than it would elsewhere. These rules will never be perfect in all situations, so we are also allowed to specify indefinite articles by hand, as the vicar's case shows.

"Some" is worth a closer look, because English uses it in several different ways. By introducing the woodworm with "some", above, we established that it was plural. We might imagine that there are many worms, even though they are represented by a single thing in Inform. We can expect to see text in the story such as:

You can see some woodworm here.
The woodworm are fixed in place.

But suppose we wanted something which there is an amount of, but which is not made up of individual items - a so-called mass noun like "water", or "bread". Now we can write:

The water is here. The indefinite article is "some".

and this time Inform does not treat the "some water" thing as a plural, so we might read:

You can see some water here.
The water is hardly portable.

rather than "The water are hardly portable."

Finally, we can override these settings, if they still come out not as we intend, by explicitly changing the either/or properties "singular-named" (vs "plural-named") and "proper-named" (vs "improper-named").

Examples

31.

Belfry ★

You can see a bat, a bell, some woodworm, William Snelson, the sexton's wife, a bellringer and your local vicar here.

RB 7.1 Getting Acquainted

32.

Gopher-wood ★★

Changing the name of a character in the middle of play, removing the article.

RB 7.1 Getting Acquainted

🔗

WI §3.19 Carrying capacity

The containers and supporters created so far have been boundlessly capacious: or rather, though we seldom notice the difference, have had a maximum carrying capacity of 100 items. This is clearly unrealistic for a small purse or a modest mantelpiece. We can impose upper limits with sentences like so:

The carrying capacity of the jewelled purse is 2.
 
The bijou mantelpiece has carrying capacity 3.

Attempts by the player to overfill, or overload, will now be rebuffed with a message such as "There is no room on the mantelpiece".

The player is not a container or a supporter, but nevertheless does have a carrying capacity: this is interpreted to mean the maximum number of items which can be carried at once.

The carrying capacity of the player is 4.

These restrictions only apply to the player (and other in-world characters): as the omnipotent creators, we are not restrained by them. Nothing prevents this:

The carrying capacity of the jewelled purse is 2. The diamond, the ruby and the sapphire are in the purse.

The player will be able to remove all three items, but only put two of them back. (This is probably something we only want very occasionally: perhaps to create a sack stuffed almost to bursting point.)

🔗

WI §3.20 Possessions and clothing

We have seen how to place objects in rooms, and in containers or on supporters. But what about people? Perhaps it could be said that they "contain" the fillings in their teeth, or "support" a top hat, but this is not very natural. Inform therefore never speaks of things being "in" or "on" people. Instead, they have two sorts of possessions: the things they carry, and the things they wear. (Body parts, such as arms and legs, are different again: see "parts" below for a clue to how to do these.) Thus:

Mr Darcy wears a top hat. Mr Darcy carries a silver sword.

In fact, Inform deduces from this not only who owns the hat and the sword, but also that Darcy has the kind "person", because only people can wear or carry.

As all the assertion verbs do, "to wear" and "to carry" have participles which Inform knows about. So we could equally well write:

The scarlet coat is worn by Mr Wickham. The duelling pistol is carried by Mr Wickham.

If we do not specify who does the wearing, or carrying, then this is assumed to be the player. Thus:

A brass lantern and a rusty iron key are carried. The mosquito-repellent hat is worn.

It would make no sense to "wear" the key, for instance, so Inform needs to distinguish between what is clothing and what is not. It does this with an either/or property called "wearable": if something has this property then the player will be allowed to wear it, provided it can first be picked up. Anything which is worn by somebody at the start of play is assumed to be wearable (unless we say otherwise). But if nobody is initially wearing the item in question, then we have to be explicit:

The player carries a scarlet gown. The gown is wearable.

(When we come to asking questions about the current situation, we will need to remember that "to carry" and "to wear" are different. Thus "if Lancelot carries the plate armour" will not be true if he is wearing it rather than carrying it under his arm. As we will later see, we can instead vaguely say "if Lancelot has the plate armour" to mean either carrying or wearing.)

Example

33.

Disenchantment Bay 10 ★

Disenchantment Bay: things for the player and the characters to wear and carry.

RB 1.3 Disenchantment Bay

🔗

WI §3.21 The player's holdall

When the player has only limited carrying capacity, play is likely to be tiresome, but we can make life easier by providing a way for the player to carry endless items without dozens of free hands to hold them all:

"Sackcloth"

The Attic is a room. The old blue rucksack is a player's holdall. The player is wearing the rucksack.

The carrying capacity of the player is 3.

In the Attic are a CD entitled No Smoke Without Fire, a 70s photograph of an American winning Wimbledon, a fraxinus branch, an urn holding your late great-aunt's remains, a convention badge from the American Society of Hypertension and a ghost story by M R James.

This example story introduces a new kind of container, the "player's holdall". This is a kind of which most stories will contain at most one example, but in principle there can be any number. A player's holdall is a capacious bag into which the player automatically places surplus items whenever his or her hands are full: trying the above example story and getting the items one by one will give the general idea.

Of course, if the carrying capacity of the player is never reached then there will never be any surplus items and a player's holdall will behave just like any other (portable, usually openable) container.

Example

34.

Disenchantment Bay 11 ★

Disenchantment Bay: making a holdall of the backpack.

RB 1.3 Disenchantment Bay

🔗

WI §3.22 Food

We have nearly reached the end of the chapter on Things, but one either/or property for things remains: every thing is either "edible" or "inedible". Unless we say otherwise, things are inedible. But for instance we might write:

The player carries a Macintosh apple. The Macintosh is edible.

(The type of computer is named after a variety of apple descended from a tree cultivated in 1811 by John McIntosh of Ontario.) Edible things are just like inedible ones, except that the player can EAT them. This will usually only consume the foodstuff in question, effectively destroying it, but using techniques from later chapters we could make the consequences more interesting.

🔗

WI §3.23 Parts of things

Everything has one and only one kind. This is both good and bad: good for clarity, bad if something needs to behave in two different ways at once. How might we simulate a car with an ignition key, given that no single thing can be both a "vehicle" and a "device" at the same time?

The Inform world model takes the view that such a car is too complicated to be simulated with a single thing. Instead it should be simulated as a vehicle (the car) which has a device (the ignition) attached. This is done using a third kind of containment to those seen so far ("in…" and "on…"): "part of".

"Buttons"

The Confectionary Workshop is a room. The Chocolate Machine is here. "The Chocolate Machine has pride of place. A lever and two buttons, one white, the other brown, seem to be the only controls. On top is a hopper."

A container called the hopper is part of the Chocolate Machine. The lever, the white button and the brown button are parts of the Chocolate Machine.

The Chocolatier's desk is here. "The Chocolatier evidently works at the imposing green-leather topped desk facing the Machine. It has three drawers with brass handles."

The upper drawer, the middle drawer and the lower drawer are parts of the desk. The upper drawer, the middle drawer and the lower drawer are openable closed containers. In the middle drawer is a sugared almond. In the lower drawer is a Battenburg cake. On the desk is a liquorice twist.

The cake, the twist and the almond are edible.

The machine and the desk each have several "parts" representing subsidiary pieces of themselves. The desk is a "supporter" (it needs to be, for the liquorice twist to be on top) but also has three "containers" attached, each of which can be opened or closed independently.

In the interests of realism, the standard rules of play protect these composite things. Thus if the desk were to be moved elsewhere (rolling on sugar casters perhaps) then its parts would move with it, and the player is not allowed to detach parts of things: the drawers can be opened or closed, but not pulled out altogether.

Note that rooms and regions are not allowed to have parts. (Rooms are already parts of regions, and to divide up rooms, we can either make several rooms or place containers or other obstacles in a single one.)

Examples

35.

Fallout Enclosure ★★★

Adding an enclosure kind that includes both containers and supporters in order to simplify text that would apply to both.

RB 9.2 Bags, Bottles, Boxes and Safes

36.

Brown ★★★

A red sticky label which can be attached to anything in the game, or removed again.

RB 9.7 Painting and Labeling Devices

37.

Disenchantment Bay 12 ★★★★

A final trip to Disenchantment Bay: the scenario turned into a somewhat fuller scene, with various features that have not yet been explained.

RB 1.3 Disenchantment Bay

🔗

WI §3.24 Concealment

Though realism can become tiresome in interactive fiction, there are times when we cannot go along with Inform's normal assumption that all of a person's possessions are visible to everybody else. People are not like containers, which either show all of their holdings or not, according to whether they are open or transparent. If a man is carrying a fishing rod and a wallet, one will be on open show, the other not. Some clothing is outwardly visible, but not all.

Whether or not something is concealed is not like the either/or properties we have seen so far - such as being "open" or "closed" - because it is not really a property of the thing itself, but depends on the habitual behaviour of its current owner. To talk about behaviour we have to use sentences of a kind not seen so far, and which will not fully be explained for some chapters to come.

But straightforward cases are easy to write, if only by imitating the following examples.

Here we make the Cloaked Villain invariably conceal anything she is holding or wearing:

Rule for deciding the concealed possessions of the Cloaked Villain: yes.

At which point we think about it more carefully, and then rewrite:

Rule for deciding the concealed possessions of the Cloaked Villain: if the particular possession is the sable cloak, no; otherwise yes.

(A rule which says neither "yes" nor "no" will decide yes, but it's best to spell out exactly what's wanted.)

Parts are treated exactly as if clothes or items being held, and the following will make the face and inscription on a coin invisible unless the player is holding it - the idea being that they are too small to be seen from farther away.

The coin is in the Roman Villa. The face and inscription are parts of the coin. Rule for deciding the concealed possessions of the coin: if the coin is carried, no; otherwise yes.

There is also an either/or property called "described"/"undescribed", intended to be used only as a last resort, but which has the ability to hide something from room descriptions. This not really hiding: the idea is that "undescribed" should be used only for cases where some other text already reveals the item, or where its presence is implicit. Even then, it should only be used when the item is intended to be taken or moved by the player at some point - if the item isn't intended to move, it's much better to make it "scenery". (There's only one commonly-found example - the player's own body, the "yourself", is undescribed.)

Note that the "undescribed" property is automatically removed from anything carried by, worn by or part of the player, even indirectly; and that nothing on top of an "undescribed" supporter will be visible in a room description, even if it itself is "described". (Scenery supporters don't suffer from that restriction, which is one reason scenery is a better option when possible.)

Example

38.

Search and Seizure ★★★

A smuggler who has items, some of which are hidden.

RB 7.3 Reactive Characters

🔗

WI §3.25 The location of something

The model world created by Inform is partitioned into rooms. This means that everything which exists in the model world, exists in one of the rooms. If we write a sentence such as

Professor Wilderspin is a man.

and say nothing more about Wilderspin, then he does not physically exist at the start of the story: he is said to be "out of play", and stays that way until we move him into one of the rooms. A better metaphor might be that he is waiting in the wings, ready to come onto the stage.

Every thing is either out of play, or can be found in one of the rooms, and the property "location of X" gives us the room in question. The following condition tests, in effect, whether Wilderspin is in play:

if the location of Wilderspin is a room, ...

Which uses a new phrase:

location of (object) ⇒ room

This phrase produces the room which, perhaps indirectly, contains the object given. Example: if the player stands in Biblioll College and wears a waistcoat, inside which is a fob watch, then

location of the fob watch

is Biblioll College. In general, a thing cannot be in two rooms at once, but there are two exceptions: two-sided doors, present on both sides, and backdrops. The "location of" a door is its front side, but a backdrop has no location. (Objects which are not things at all, such as rooms and directions, also have no location.)

We very often want to know the location of the player, and this is more simply called just "the location". (This is actually a value that varies rather than a phrase, but that's a technicality we can ignore here.)

The idea of indirect containment is useful enough to have a name: Inform calls it "enclosure". A thing encloses whatever is a part of itself, or inside itself, or on top of itself, and it also encloses anything that they enclose. And when something moves around, anything it encloses will move with it. In the example above, Biblioll College (a room) and the player (a person) both enclose the fob watch and the waistcoat. (The small print: a door is enclosed by the rooms on both sides; a backdrop is never enclosed.)

Enclosure is only useful when being used as a question. So the following is fine:

if the player encloses the fob watch, ...

But these will produce problem messages:

The player encloses the fob watch. The location of the trilobite is the Museum.

because they are too vague. Inform needs to know exactly where the fob watch and the trilobite will begin the story, whereas these sentences leave room for doubt about who or what is actually holding them.

Addendum

The verb "to hold" means the holding relation. X holds Y if one of the following are true (they're mutually exclusive, so it's not possible for more than one of them to be true): X contains Y, X supports Y, X wears Y, X carries Y, X incorporates Y, i.e., Y is part of X). Enclosure is most easily understood as direct or indirect holding. X encloses Y if X holds Y *or* X holds something that holds Y, and so on, through however many levels. (In assertions, "hold" simply means "carries", e.g., "The player holds the spatula.". "to be held by" means the reversed holding relation, but "to be held inside" and "to be held within" both mean the reversed *containment* relation.)

Example

39.

Van Helsing ★★

A character who approaches the player, then follows him from room to room.

RB 7.13 Traveling Characters

🔗

WI §3.26 Directions

"Direction" is a kind which is quite unlike most of those seen so far. While it has to do with the physical world, a direction does not exactly belong to it. One cannot find "southeast" sitting on a shelf. "Direction" is not a kind of thing, nor a kind of room: it is a kind in its own right.

Every direction has an "opposite" property, which is always another direction. These occur in matched pairs. The opposite of north is south, just as the opposite of south is north. The opposite of southeast is northwest, the opposite of inside is outside, and so on. When Inform reads a sentence like…

Bangkok is south of Nakhon Sawan.

…it assumes that the opposite map connection is probably also valid, so that

Nakhon Sawan is north of Bangkok.

The chapter began with the twelve directions built into Inform:

north, northeast, east, southeast, south, southwest, west, northwest, up, down, inside, outside

But the built-in set is not always appropriate. Sometimes this is too many; if we wanted to write about a Flatland, for instance, then up and down ought to go. But in practice it is better not to abolish them as directions but instead to forbid travelling in them. (See the Recipe Book for examples.)

But away from our familiar Earth, the usual frame of reference loses its meaning. Terry Pratchett's "Discworld" comedies, set on a rotating disc, use the directions turnwise, widdershins, hubwards and rimwards. On board a Zeppelin airship, which constantly changes its course, the cockpit has no fixed compass bearing from the passenger cabin: it is not very naturally "north". In zero gravity, there is no up or down. Mars does not have a magnetic core, so a compass doesn't work there.

New directions must always be created in opposing pairs, and each must be declared with a clear simple sentence of the form "X is a direction." For instance:

Turnwise is a direction. The opposite of turnwise is widdershins.
Widdershins is a direction. The opposite of widdershins is turnwise.
Hubwards is a direction. The opposite of hubwards is rimwards.
Rimwards is a direction. The opposite of rimwards is hubwards.

It is then possible to write, say, that:

Ankh-Morpork is hubwards of Lancre and turnwise from Borogravia.

Of course the Map page of the Index for the project normally draws a map based on compass bearings, so it will get a little befuddled by this. But the map drawn in the Index can be given hints to improve its legibility. More on this later, but for now note that

Index map with turnwise mapped as east.

maps turnwise directions as if they were east, that is, pointing rightwards on the page. (This has no effect on the story file produced; it does not mean turnwise is simply a new name for east; it affects only the look of the Index map, which is only a convenience for the author in any case.)

At one time, directions had to have shortish names (up to three words only), but that's no longer true:

Just the tiniest smidge off magnetic north is a direction. The opposite of
just the tiniest smidge off magnetic north is just the tiniest smidge
off magnetic south.
Just the tiniest smidge off magnetic south is a direction. The opposite of
just the tiniest smidge off magnetic south is just the tiniest smidge
off magnetic north.

Examples

40.

Prisoner's Dilemma ★★

A button that causes a previously non-existent exit to come into being.

RB 3.2 Map

41.

The World of Charles S. Roberts ★★

Replacing the ordinary compass bearings with a set of six directions to impose a hexagonal rather than square grid on the landscape.

RB 3.2 Map

42.

Fore ★★★

Understand "fore", "aft", "port", and "starboard", but only when the player is on a vessel.

RB 8.2 Ships, Trains and Elevators

§12.

A recap of actions

§12.

How actions are processed

§12.

Giving instructions to other people

§12.

Persuasion

§12.

Unsuccessful attempts

§12.

Spontaneous actions by other people

§12.

New actions

§12.

Irregular English verbs

§12.

Check, carry out, report

§12.

Action variables

§12.

Making actions work for other people

§12.

Check rules for actions by other people

§12.

Report rules for actions by other people

§12.

Actions for any actor

§12.

Out of world actions

§12.

Reaching inside and reaching outside rules

§12.

Visible vs touchable vs carried

§12.

Changing reachability

§12.

Changing visibility

§12.

Stored actions

§12.

Guidelines on how to write rules about actions

🔗

WI §12.1 A recap of actions

Actions are impulses to do something, which arise sometimes through typed commands:

>examine tapestry

and sometimes through "try" phrases occurring in other rules:

Before examining the tapestry, try switching the ultraviolet light on.

Every action either succeeds or fails, though failure may not be a bad thing (something better may have happened). Besides any rules applied in the source text, actions are subject to basic realism rules. A general rule ensures that actions are rejected if the actor would need to touch something which is out of reach, or see something which is invisible; and a couple of hundred other built-in rules police individual actions. For instance, if the ACTIONS testing command has been used to switch monitoring on, then:

>unlock cage with watermelon
[unlocking cage with watermelon]
That doesn't seem to fit the lock.
[unlocking cage with watermelon - failed the can't unlock without the correct key rule]

Actions generated by "try" phrases are allowed to run "silently", which means that if nothing out of the way happens and they succeed, then nothing is printed. For instance:

Before examining the tapestry: say "(Switching on the lamp first.)"; silently try switching the ultraviolet light on.

There are many ways to impose extra rules on actions, and we have seen three main kinds: Before rules, intended so that preliminary activities like the one above can happen before the action is tried; Instead rules, which block or divert the intention, or may cause something spectacularly different to happen; and After rules, which allow for unexpected consequences after the action has taken place.

🔗

WI §12.2 How actions are processed

The following flow chart shows the natural course of events when Inform deals with a new action - a "taking" action in the case drawn. For quite a long time, the action may still fail, and it may be that nothing actually happens: but eventually a deciding line is crossed, and once that happens the action will certainly succeed.

The coloured boxes on this chart represent "rulebooks", that is, collections of rules with a common purpose. The orange boxes for Before, Instead and After were covered in the Basic Actions chapter, but the blue boxes are new. The orange boxes are where we put rules to handle unusual situations, or unexpected events: special rules to cover the opening of a container which happens to be booby-trapped, or walking through a doorway into a room where a surprise party is about to be sprung.

Blue boxes hold the mundane, everyday rules - the generic ways that particular actions behave. Every action provides these: "Check" rules, to see if it makes sense - for instance, to see that the player is not trying to take his or her own body, or a whole room, or something he or she already has; then "Carry out" rules, to actually do what the action is supposed to do - in the case of taking, to move an object into the player's possession; and finally "Report" rules, which tell the player what has happened - perhaps printing up "Taken."

When we create a new action, we add a new column to the blue rows in this diagram. As we shall see, we can also put new rules into the existing blue boxes: for instance, if we wanted to increase physical realism by forbidding the player to carry more than a certain weight, we would want to add a new "check taking" rule, and this is entirely legal.

In subsequent chapters, we will see ways to intervene at almost every point in the above diagram - from how "Can we see or touch things?" is reckoned, to each and every individual rule in all of these books. Action-processing may be the single most important thing Inform does, so the system is designed to be immensely flexible. On the other hand, that does make it a lot to take in at one look. Newcomers should probably concentrate on "Instead" and "After" as the basic tools for designing the situations turning up routinely in interactive fiction. There are guidelines at the end of this chapter offering advice on which tricks to use when it comes to more complicated needs.

🔗

WI §12.3 Giving instructions to other people

So far, all actions have been carried out by the player: which is fine for exploring the passive world of an empty warehouse, but less good for a drama in which other characters have to be contended with. In fact, an action can be carried out by anybody - by any instance of the "person" kind, that is, which includes all the men, women and animals in the story, and not only the player.

In interactive fiction, players conventionally ask other characters to do something with commands like so:

> will, go west

Clearly "will, go west" should not produce the same action as "go west", because a different person will be trying it: this person is called the "actor", and while the actor is ordinarily the player, here it is the character called Will. Inform distinguishes these two actions like so:

going west
asking Will to try going west

As a result, we can write rules like so:

Instead of asking Will to try going west, say "Will scratches his head, baffled by this talk of westward. Is not the ocean without bound?"

To write rules like this, we sometimes want to generalise about who is supposed to do the deed. To do this we can refer to "person asked", just as the "noun" stands for whatever noun was typed:

Instead of asking somebody to try taking something, say "I don't think we ought to tempt [the person asked] into theft, surely?"

So if the player types "Algy, take sandwich", the "person asked" would be Algy; the "noun" would be the sandwich; and there would be no "second noun".

Examples

184.

Virtue ★

Defining certain kinds of behavior as inappropriate, so that other characters will refuse indignantly to do any such thing.

RB 7.14 Obedient Characters

185.

Latris Theon ★★★

A person who can accept instructions to go to new destinations and move towards them according to the most reasonable path.

RB 7.13 Traveling Characters

🔗

WI §12.4 Persuasion

"Asking … to try …" actions run through their Before and Instead rules like any other actions, but then (if no rule has intervened) something different happens: Inform has to decide whether the person asked consents to try the action or not. By default, the answer is always no, and text like the following will be printed:

> will, go west
Will has better things to do.

However, we can intervene to make the answer "yes", using a special kind of rule which produces a yes/no answer. The following examples show how we can give broad or narrow permission, as we choose:

Persuasion rule for asking people to try going: persuasion succeeds.
Persuasion rule for asking Will to try going west: persuasion succeeds.

Such a rule can either declare that "persuasion succeeds", or that "persuasion fails", or make no decision and leave it to another rule to say. If it decides that persuasion fails, it is also allowed to say something, describing why: in that event, the standard message ("Will has better things to do.") is suppressed. For example,

Persuasion rule for asking Will to try going:
   say "Will looks put out, and mutters under his breath.";
   persuasion fails.

The following rule, which is really only suitable for testing, makes everybody infinitely obliging:

Persuasion rule for asking people to try doing something: persuasion succeeds.

Supposing that Will does decide to cooperate, a new action is generated:

Will going west

and this is then subject to all of the usual action machinery. For instance, we could write a rule such as:

Instead of Will going west, say "He runs out into the waves, but soon returns, rueful."

So in this case the new action ("Will going west") failed: but the original action, "asking Will to try going west", is still deemed to have succeeded - after all, Will did try. To put it more formally, "asking X to try A" succeeds if the persuasion rules succeed, and otherwise fails.

Note also that "Instead of…" rules written for other people will be treated by Inform as failures, even if we write something like

Instead of Will pulling the cord:
   say "The bell rings."

and thus may produce unsatisfactory results such as

>WILL, PULL CORD
The bell rings.
 
Will is unable to do that.

If we wish to write new successful actions for another character, we will need to create appropriate carry out and report rules for them: these will be explained in the sections to follow.

(Finally, note that the mechanism Inform uses to see if we have printed a refusal message of our own, in the event of persuasion rules failing, can be fooled if we write a persuasion rule explicitly ending with a "[paragraph break]" text substitution.)

Examples

186.

The Hypnotist of Blois ★

A hypnotist who can make people obedient and then set them free again.

RB 7.14 Obedient Characters

187.

Police State ★

Several friends who obey you; a policeman who doesn't (but who takes a dim view of certain kinds of antics).

RB 7.3 Reactive Characters

🔗

WI §12.5 Unsuccessful attempts

Suppose, finally, that Will not only consents to try the action, but it also survives its passage through Before and Instead rules. What happens then? In principle, what happens to Will is exactly what would have happened to the player in his place. For instance:

> will, go east
Will leaves to the east.

If on the other hand Will's attempt is frustrated because one of the checking rules stops him, then Will's action fails. For instance, if Will tries going northeast but there is no room to northeast, one of the rules checking the "going" action will stop him. We will then see this:

> will, go northeast
Will is unable to do that.

This is rather a generic message, and we may want something more interesting. We can provide that using yet another special kind of rule:

Unsuccessful attempt by Will going: say "Will blunders around going nowhere, as usual."

Even that is still a little generic, though, because it treats all of the various ways that "going" can fail as the same. If we have ACTIONS switched on, we can see what goes on behind the scenes when we ask Will to walk into a door:

>will, go west
[asking Will to try going west]
[(1) Will going west]
[(1) Will going west - failed the can't go through closed doors rule]
Will blunders around going nowhere, as usual.
[asking Will to try going west - succeeded]

(The "(1)" lets us know that a new action is starting during the old one, and before the old one finishes: sometimes we go up to three or four deep, though seldom more in practical cases.) We can now rewrite the "unsuccessful attempt" rule like so:

Unsuccessful attempt by Will going:
   if the reason the action failed is the can't go through closed doors rule, say "Will looks doubtful and mumbles about doors.";
   otherwise say "Will blunders around going nowhere, as usual."

The value "reason the action failed" is set to whichever checking rule threw out the action which Will tried. The names of these rules try to be self-explanatory - at any rate, those with gnomic names are not useful for this sort of thing, and can be ignored - and can be found out either using ACTIONS or by consulting the Actions index.

Finally, note that "unsuccessful attempt" rules apply only when the person in question is being asked to perform the action by somebody else - as in the examples above.

Example

188.

Generation X ★★

A person who goes along with the player's instructions, but reluctantly, and will get annoyed after too many repetitions of the same kind of unsuccessful command.

RB 7.14 Obedient Characters

🔗

WI §12.6 Spontaneous actions by other people

The player's actions happen not only when he types a command, but can also happen spontaneously as a result of a "try" phrase.

try going west
try asking Will to try going west

The latter might, of course, result in Will trying going west: or it might not - that depends on the persuasion rules. But as the author, we have the ultimate powers of persuasion, and can make Will act in any way we like, without asking:

try Will going west

Nobody in the simulated world requested this: it is an impulse felt by Will alone, so that - from the player's point of view - Will is acting spontaneously. The player need not be anywhere nearby, and may never know what happened. Recall that when actions work their way down through the flow-chart, they are stopped before reaching the "report" stage - when the player is told about them - if they are running "silently". This is also where Inform stops an action which is not witnessed by the player.

To repeat a point in the previous section: "unsuccessful attempt" rules do not apply to actions which the author has caused to happen, using "try". When such actions fail, they invoke no special set of rules. Indeed, when "try" causes somebody other than the player to try an action, nothing will be printed to report back on success or failure. If Will can't go west, that's his problem.

Note that the text "try Will going west" involves the actor's name immediately placed next to the action he is to try, which in a very few cases might cause ambiguities. If the actor's name contains a participle like "going" - say, if Will's full name turned out to be Mr Will Going - then we would have to write out the action name in full, using "trying" to clarify matters:

try Will Going trying going west

Examples

189.

IQ Test ★

Introducing Ogg, a person who will unlock and open a container when the player tells him to get something inside.

RB 7.15 Goal-Seeking Characters

190.

Boston Cream ★★★★

A fuller implementation of Ogg, giving him a motivation of his own and allowing him to react to the situation created by the player.

RB 7.15 Goal-Seeking Characters

🔗

WI §12.7 New actions

It is not often that we need to create new actions, but a large work of interactive fiction with no novelty actions is a flavourless dish. Here we shall create an action for photographing things.

The Ruins is a room. "You find this clearing in the rainforest oddly familiar." The camera is in the Ruins. "Your elephantine camera hangs from a convenient branch."
 
Photographing is an action applying to one visible thing and requiring light.

In theory that text is already sufficient to make the new action, but what we have so far is rudimentary to say the least. The two qualifications give Inform the useful information that we cannot photograph in the dark, and that we need to be photographing something - not, as in the case of waiting or taking inventory, acting without reference to any particular thing external to ourselves.

The word "visible" here tells Inform that we do not need to be able to touch the thing in question: a line of sight is good enough. These two stipulations were necessary because the default arrangement is that any object must be in touching range, and that most actions can be performed in darkness. (Also, note that if you invent an action which needs to apply to directions like "north" or "south", you need to make this apply to visible things, because the object used inside Inform to represent the idea of "north" can be seen but not touched. So for understanding purposes, "visible thing" is understood as meaning any visible thing or direction: it's more general than "thing", not more specific.)

Occasionally, when writing general rules about actions, it can be useful to find out what the current action's requirements are: the following conditions do what they suggest.

if action requires a touchable noun:

This condition is true if the action being processed is one whose (first) noun is an object which needs to be touchable by the actor. For example, it's true for "taking", but false for "examining".

if action requires a touchable second noun:

This condition is true if the action being processed is one whose second noun is an object which needs to be touchable by the actor. For example, it's true for "putting the brick in the sack", but false for "throwing the brick at the window".

if action requires a carried noun:

This condition is true if the action being processed is one whose (first) noun is an object which needs to be carried by the actor. For example, it's true for "dropping", but false for "taking".

if action requires a carried second noun:

This condition is true if the action being processed is one whose second noun is an object which needs to be carried by the actor.

if action requires light:

This condition is true if the action being processed is one which can only be performed if the actor has light to see by. For example, it's true for "examining", but false for "dropping".

As further examples, here we create "blinking" and "scraping X with Y". Note the use of "it" to indicate that the name of an object should go here.

Blinking is an action applying to nothing. Scraping it with is an action applying to two things.

The photographing action now exists, but with two provisos: (a) it never happens, because Inform does not know what commands by the player should cause it, and (b) even if it were to happen, nothing would follow, because Inform does not know what to do. (There are no check, carry out or report rules yet.)

The first problem is easily overcome:

Understand "photograph [something]" as photographing.

We will return to the whole subject of parsing, as this process of understanding the player's commands is called, later. But this gives the gist of it.

Examples

191.

Red Cross ★

A DIAGNOSE command which allows the player to check on the health of someone.

RB 7.5 Combat and Death

192.

Frizz ★★★

Liquid flows within containers and soaks objects that are not waterproof; any contact with a wet object can dampen our gloves.

RB 10.2 Liquids

193.

3 AM ★★★

A shake command which agitates soda and makes items thump around in boxes.

RB 10.2 Liquids

🔗

WI §12.8 Irregular English verbs

Our three example actions can be recognised in play using the following:

Understand "photograph [something]" as photographing.
 
Understand "blink" as blinking.
 
Understand "scrape [something] with [something]" as scraping it with.

The last of these examples shows why Inform does not risk generating this automatically: English is so full of irregular verbs. Inform could have guessed "blink" and "photograph", but might then have opted for "scrap" instead of "scrape".

Inform does risk automatically generating the past participle of an action. (Many past participles are never needed, so the stakes are lower if Inform gets this wrong.) What usually happens is that the "-ing" is replaced with "-ed", thus photographed, blinked, scraped - but Inform has a dictionary of some 460 irregular exceptions, such as caught, fled, crossbred, taken, woven. So with luck Inform will guess correctly. If not, we can get around this like so:

Squicking is an action with past participle squacked, applying to one thing.

🔗

WI §12.9 Check, carry out, report

The normal behaviour of an action is specified by its three associated rulebooks - check, carry out and report. In the case of our "photographing" example, these rulebooks will be:

Check photographing. Here, for instance, we need to verify that the player has the camera. If any of our checks fail, we should say why and stop the action. If they succeed, we say nothing.
 
Carry out photographing. At this stage no further checking is needed (or allowed): the action now definitively takes place. At this point we might, for instance, deduct one from the number of exposures left on the film in the camera, or award the player points for capturing something interesting for posterity. But we should say nothing.
 
Report photographing. At this stage no further activity is needed (or allowed): whatever effect the action had, it has happened and is now over. All we can do is to say what has taken place.

So far we have not really gone into the business of what rulebooks are, and we don't do so here either - suffice to say that we can now create whatever rules we need:

A check photographing rule:
   if the camera is not carried:
      say "You can hardly photograph without a camera, now can you?" instead.

In fact, writing "a check photographing rule" is over-formal. We can more simply label our rules like so:

Check photographing:
   if we have photographed the noun:
      say "You've already snapped [the noun]." instead.
 
Report photographing: say "Click!"

For the sake of brevity, photography has no interesting consequence (no points to be won, no film to use up), so there are no carry out rules here. Note the way we used the word "instead" once again to stop actions in their tracks.

We can continue to add rules at any point, and a classic thing that happens when testing a new work is that the designer realises there is a case which has not been thought of:

Check photographing:
   if the noun is the camera:
      say "That would require some sort of contraption with mirrors." instead.

Examples

194.

The Dark Ages Revisited ★

An electric light kind of device which becomes lit when switched on and dark when switched off.

RB 3.7 Lighting

195.

Paddington ★★

A CUT [something] WITH [something] command which acts differently on different types of objects.

RB 10.4 Glass and Other Damage-Prone Substances

196.

Delicious, Delicious Rocks ★★★

Adding a "sanity-check" stage to decide whether an action makes any sense, which occurs before any before rules, implicit taking, or check rules.

RB 9.1 Food

197.

Noisemaking ★★★

Creating a stage after the report stage of an action, during which other characters may observe and react.

RB 7.3 Reactive Characters

🔗

WI §12.10 Action variables

For some complex situations, it can be useful to keep track of a few values throughout the processing of the action. This is not an everyday occurrence: in the Standard Rules, for instance, only two or three out of 90 actions need to do this. But suppose we want to write a more deluxe version of our "photographing" action. This time, rather than having a single thing called the "camera", we will provide a whole range of possible cameras, varying in quality:

Photographing is an action applying to one visible thing and requiring light. Understand "photograph [something]" as photographing.
 
The Studio is a room. Sally is a woman in the Studio. A foam-lined tote bag is in the Studio.
 
A camera is a kind of thing. A camera has a number called picture quality. The digital SLR camera is a camera in the tote bag. The player carries a camera called the instant one-shot camera. The picture quality of the SLR camera is 10. The picture quality of the one-shot is 2. Definition: a camera is sharp if its picture quality is 5 or more.

And we will want the photographing action to have the player use the best-quality camera which comes to hand. We will give the action a variable called the 'camera photographed with', thus:

The photographing action has an object called the camera photographed with.

Every action's variables must be named differently from those of all other actions, because there are some "before" rules (for instance) which take effect for many different actions, and which might need access to any of their variables. So action variables should be named in a way marking out to which action they belong. The best way to do this is to include the past participle of the action name - just as "camera photographed with" contains the past participle "photographed" of the action "photographing".

This value is created when the action begins, and disappears when the action ends. (If the action should happen a second time before the first time was completed, a second copy of the value is created, leaving the original undisturbed.) When the action begins, the value starts out as something neutral - so if it is a number, it starts out as 0, if a text, it starts out as the blank text "", and so on. Here it is an object, so it starts out as nothing - the value meaning no object at all. But of course we want to give it a value ourselves. We can do that using the "setting action variables" rulebook. For instance:

Setting action variables for photographing:
   now the camera photographed with is the sharpest camera which is carried by the actor.

The "setting action variables" rulebook is run through before even the before rules, and it has no power to stop or change the action. Its rules should say nothing and do nothing other than to set rulebook variables like this one. Note that it is intended to work for any actor, not only the player: so rather than referring to the player as the performer of the action, we need to write "the actor", as in the example above. (See subsequent sections for more on actors.)

We can now write rules such as:

A check photographing rule:
   if the camera photographed with is nothing:
      say "You can hardly photograph without a camera, now can you?" instead.

Only rules to do with the photographing action - before, instead, after, check, carry out, or report rules, and so on - are allowed to see the 'camera photographed with' value: it's the private property of the action.

A further elaboration allows us to make rules about photographing neater to write. If we create our variable like so:

The photographing action has an object called the camera photographed with (matched as "using").

…then we are now allowed to add an optional 'using …' clause onto a description of the action. The clause has to be introduced with a single word: here, it's 'using'. For instance, we could write rules such as

Instead of photographing something using the one-shot camera:
   say "But you promised to give this to Sally's nephew."
 
Check photographing something using the noun:
   say "That would require some sort of contraption with mirrors." instead.
 
Report photographing something using a sharp camera:
   say "You feel cool and important as the shutter clicks."

(This is the method used by the Standard Rules to attach optional clauses such as 'to', 'with' and 'through' to the going action.)

Examples

198.

Removal ★

TAKE expanded to give responses such as "You take the book from the shelf." or "You pick up the toy from the ground."

RB 6.8 Taking, Dropping, Inserting and Putting

199.

Further Reasons Why All Poets Are Liars ★

The young William Wordsworth, pushing a box about in his room, must struggle to achieve a Romantic point of view.

RB 3.3 Position Within Rooms

200.

The Second Oldest Problem ★

Adapting the going action so that something special can happen when going from a dark room to another dark room.

RB 6.9 Going, Pushing Things in Directions

201.

Puff of Orange Smoke ★★

A system in which every character has a body, which is left behind when the person dies; attempts to do something to the body are redirected to the person while the person is alive.

RB 7.5 Combat and Death

202.

Croft ★★★

Adding special reporting and handling for objects dropped when the player is on a supporter, and special entering rules for moving from one supporter to another.

RB 6.8 Taking, Dropping, Inserting and Putting

🔗

WI §12.11 Making actions work for other people

The "photographing" action now works very nicely when the player does it. But not when others try. Suppose that neither the player, nor Clark Gable, is holding the camera:

>photograph clark
You can hardly photograph without a camera, now can you?
 
>clark, photograph me
>

An uncanny silence. What has happened is that the rules written so far are all implicitly restricted to the player only. This is because when we write -

Check photographing:
   if the camera is not carried:
      say "You can hardly photograph without a camera, now can you?" instead.

the action is "photographing", not "Clark photographing". In the next few sections we shall see how to make the rules work nicely for everybody. This is a little bit harder, so it should be noted right away that in many projects there is no need. In a story which has no other characters who succumb to persuasion, for instance, only the player will ever try the action.

Examples

203.

The Man of Steel ★★

An escaping action which means "go to any room you can reach from here", and is only useful to non-player characters.

RB 7.15 Goal-Seeking Characters

204.

Trying Taking Manhattan ★★★

Replacing the inventory reporting rule with another which does something slightly different.

RB 6.7 Inventory

205.

Under Contract ★★★★

Creating a person who accepts most instructions and reacts correctly when a request leads implicitly to inappropriate behavior.

RB 7.14 Obedient Characters

🔗

WI §12.12 Check rules for actions by other people

If we want to impose the restriction about carrying the camera on other people, we need a rule like the following:

Check someone photographing: if the person asked does not carry the camera, stop the action.

Implicitly, that "someone" excludes the player. Note that we say nothing in this rule, stopping the action without a word: after all, Clark might well be out of sight when trying this. If he is within sight, then we read:

>clark, photograph me
Clark Gable is unable to do that.

We saw before that Inform's built-in rules all have handy names (the "can't drop what's already dropped rule", and such), and that these are useful when writing better "unable to…" messages. So for a deluxe version, we end up with:

Check someone trying photographing (this is the other people can't photograph without the camera rule): if the person asked does not carry the camera, stop the action.

And now, with ACTIONS on, we find that:

>clark, photograph me
[asking Clark Gable to try photographing yourself]
[(1) Clark Gable photographing yourself]
[(1) Clark Gable photographing yourself - failed the other people can't photograph without the camera rule]
Clark Gable is unable to do that.
[asking Clark Gable to try photographing yourself - succeeded]

which means that we could have, say,

Unsuccessful attempt by Clark photographing:
   if the reason the action failed is the other people can't photograph without the camera rule, say "Clark is too suave to be embarrassed. 'Frankly, my dear, I don't have a camera.'";
   otherwise say "Clark tries, and fails, to take a photograph."

Examples

206.

Get Axe ★

Changing the check rules to try automatically leaving a container before attempting to take it. (And arranging things so that other people will do likewise.)

RB 6.10 Entering and Exiting, Sitting and Standing

207.

Barter Barter ★★★

Allowing characters other than the player to give objects to one another, accounting for the possibility that some items may not be desired by the intended recipients.

RB 7.4 Barter and Exchange

🔗

WI §12.13 Report rules for actions by other people

Report rules for the player's actions are easy to write, and for many actions, they are not much harder for other people either:

Report photographing: say "Click!"
Report someone photographing: say "Click! [The person asked] takes a snapshot of [the noun]."

But once other people are involved, we have to go to some trouble to get all of the possibilities right. Here is a case which did not immediately occur to the author of the "going" action, for instance:

>get in cage
You get into the cage.
>clark, get in automobile
Clark Gable gets into the automobile.
>clark, push cage west
Clark Gable goes west in the automobile, pushing the cage in front, and you along too.
 
The Lot (in the cage)
In the Lot you can see an automobile (in which is Clark Gable).

We said before that report rules are skipped if the action is running "silently", or if the action is one that the player does not witness. But that is also a tricky concept. Inform's doctrine is that you witness an action if you can see any of the actor, the noun or the second noun at either the beginning or the end of the action; except that being able to see a backdrop does not count. Thus if Clark Gable, in Beverly Hills, photographs the Hollywood sign then we do not witness this from Sunset Boulevard merely because we, too, can see the Hollywood sign.

While the report rules for actions by the player must actually report something, report rules for other people's actions are under no such obligation. For instance, if Clark unlocks a door from the other side to the player, then this counts as an action that the player witnesses - and after all, it could be argued that the player should hear the key turning in the lock - but in fact the standard rules for reporting locking choose to say nothing.

Examples

208.

The Man of Steel Excuses Himself ★★

Elaborating the report rules to be more interesting than "Clark goes west."

RB 7.15 Goal-Seeking Characters

209.

Fate Steps In ★★★

Fate entity which attempts to make things happen, by hook or by crook, including taking preliminary actions to set the player up a bit.

RB 4.6 Plot Management

🔗

WI §12.14 Actions for any actor

In the previous sections, we created a new action by providing one set of rules for the player and another for anybody else who might try to perform it. These rules began with action descriptions in one of the following forms:

Instead of taking a container, ...
Instead of P taking a container, ...

The first form implies that the player must be performing the action: the second allows for any person matching P to be the action, except that this person must not be the player. That means that all rules seen so far either affect only the player, or only other people.

This is often convenient, but sometimes we need to set up a complicated action which really does work in the same way for every actor - for instance, the built-in Inform actions provided by the Standard Rules aim to do this. We can write such rules thus:

Instead of an actor taking a container, ...

Here the rule applies to anyone who tries taking a container, player or not. Inside such a rule, the special value 'the actor' is the person performing the action. For instance, the Standard Rules include this one:

Carry out an actor wearing (this is the standard wearing rule):
   now the actor wears the noun.

🔗

WI §12.15 Out of world actions

The actions seen so far are all impulses causing the protagonist inside the fictional world to do something, or at least try to. But when the player types "quit" or "save", that is not a request for anything to happen in the fictional world: it is an instruction to the program simulating that world. In fact, just the same, such requests are treated as actions, but of a special category called "out of world" actions. They do not cause time to pass by, so the turn counter does not advance, nor does this command cycle count as a turn at all; and they are altogether exempt from "Before", "Instead" and "After" rules. Only the player is allowed to try them.

We can also create new out-of-world actions. Suppose we want a dialogue like so:

>ROOMS
You have been to 1 out of 8 rooms.

Here is a complete implementation:

Requesting the room tally is an action out of world.
Report requesting the room tally: say "You have been to [number of visited rooms] out of [number of rooms] room[s]."
Understand "rooms" as requesting the room tally.

It is important not to use "out of world" actions for anything affecting what goes on in the fictional world, or realism will collapse, and action-processing may also fail to work in the usual way. "Out of world" actions should be reserved for providing commands like ROOMS, which monitor events rather than participate in them.

Examples

210.

Spellbreaker ★

P. David Lebling's classic "Spellbreaker" (1986) includes a room where the game cannot be saved: here is an Inform implementation.

RB 11.2 Saving and Undoing

211.

A point for never saving the game ★★★

In some of the late 1970s "cave crawl" adventure games, an elaborate scoring system might still leave the player perplexed as to why an apparently perfect play-through resulted in a score which was still one point short of the supposed maximum. Why only 349 out of 350? The answer varied, but sometimes the last point was earned by never saving the game - in other words by playing it right through with nothing to guard against mistakes (except perhaps UNDO for the last command), and in one long session.

RB 11.2 Saving and Undoing

🔗

WI §12.16 Reaching inside and reaching outside rules

The flow chart back at the start of this chapter shows that, early on in processing an action (between Before and Instead), Inform asks the question "Can we see or touch things?" This is where it enforces the requirements in the action's definition:

Photographing is an action applying to one visible thing and requiring light.
Scraping it with is an action applying to two things.

Seeing and touching are two different questions, which Inform answers in different ways. We shall see ways to modify or entirely alter what can be seen using the "deciding the scope of something" activity when we get to the Understanding and Activities chapters, and later in this chapter we will change the definition of touchability. What both have in common is that they are complicated questions, affected by the circumstances. We cannot simply declare that the player can touch a given lever, or can see in a given room: we must arrange for there to be no barriers between the player and the lever, or for there to be a light source in the room.

An example of rules applying to given objects is provided by the way that Inform decides whether the player can reach something or not. For instance, suppose the following:

The Laboratory is a room. In the Laboratory is a conical flask. The flask is closed and transparent. In the flask is an antibumping granule.

The player will be able to examine the granule but not to take it, as that would require reaching through glass. Suppose the player does type TAKE GRANULE: then Inform looks for potential barriers between the player and the granule, and of course finds the conical flask. If, as in this case, the thing to be touched is on the inside, then Inform asks the "reaching inside" rules for permission. There are two reaching inside rules built in to Inform:

can't reach inside rooms rule
can't reach inside closed containers rule

and in fact the second of these rules will cause the taking action to fail, because the conical flask is a closed container. (The other rule has to do with a player in one room able to see another room through, say, a telescope - merely having a line of sight doesn't give the ability to reach into the frame.)

Symmetrically, Inform also has "reaching outside" rules, used if the player is inside something and wants to reach an object in the wider room. (From a bed, probably yes; from a cage, probably no.) This ordinarily contains just one rule:

can't reach outside closed containers rule

Example

212.

Carnivale ★★

An alternative to backdrops when we want something to be visible from a distance but only touchable from one room.

RB 3.4 Continuous Spaces and The Outdoors

🔗

WI §12.17 Visible vs touchable vs carried

To recap, actions are created like so:

Photographing is an action applying to one visible thing and requiring light.
Depositing it in is an action applying to two things.
Taking inventory is an action applying to nothing.

Actions can involve up to two different things. We can place additional requirements on any of these things by describing them as a "visible thing", "touchable thing" or "carried thing". (If we simply say "thing" or "things", as in the second example, Inform assumes the requirement to be "touchable".) These three conditions are increasingly strong:

- To be "visible", something needs only to be possible to refer to by the player, which in practice means that it must be visible to the player-character. The noun or second noun produced by any action resulting from a command at the keyboard will always satisfy this minimal condition.

- To be "touchable", the player-character must be able to physically touch the thing in question: this normally means that it must be in the same room, and there must be no physical barriers in between.

- To be "carried", the player-character must (directly) carry the thing in question. (But if the player types a command using an action requiring something "carried", like WEAR HAT, the thing in question - the hat - will sometimes be picked up automatically. This is called "implicit taking", and results in text like "(first taking the top hat)" being printed.)

If an action involves two things, they need not have the same requirement as each other:

Waving it at is an action applying to one carried thing and one visible thing.

Thus to "wave magic wand at banyan tree", the player must be holding the wand, but need only be able to see the tree.

Note one special case. Requirements on touchability are waived in the case of "try" actions applied to people other than the player where the things they would need to touch are doors or backdrops. (This is a compromise to avoid difficulties arising from the ambiguous locations of such items.)

Examples

213.

Eddystone ★★

Creating new commands involving the standard compass directions.

RB 3.4 Continuous Spaces and The Outdoors

214.

Slogar's Revenge ★★★

Creating an amulet of tumblers that can be used to lock and unlock things even when it is worn, overriding the usual requirement that keys be carried.

RB 6.3 Modifying Existing Commands

🔗

WI §12.18 Changing reachability

The question of what the player can, and cannot, reach to touch is important in interactive fiction. It contains some of the subtlest ideas in the model world, though they often go unnoticed. For instance, if a key is on a shelf which is part of a closed box, can we reach for the key? This comes down to whether the shelf, described only as "part of" the box, is on the inside or the outside: and in fact, because it cannot know which is the case, Inform allows either. So in general it is best to regard "parts" as being exterior parts, but to avoid having parts on containers that might in the course of play be closed up with the player inside.

We can, if we wish, change the principles of what can be touched by writing new reaching inside or reaching outside rules. Returning to the example of the conical flask:

A rule for reaching inside the flask: say "Your hand passes through the glass as if it were not there, chilling you to the bone."; allow access.

(Or this could equally be called "a reaching inside rule for the flask".) More generally, we could give the usual flexible description of what the rule applies to:

A rule for reaching inside open containers: say "Your hands seem enigmatically too large for [the container in question]."; deny access.

The "container in question" is the one to which the rule is being applied. Note that a reaching inside rule can "deny access" (stopping with failure), or "allow access" (stopping with success), or neither, in which case the decision is left up to any subsequent rules in the rulebook to make. If none of them decide, access is allowed.

If it seems possible that these rules will be employed by people other than the player, then we need to write them a little more carefully, and in particular we need to ensure that they print nothing for other people. In the first case below, anybody can reach through the glass; in the second case, only the player cannot reach into open containers.

A rule for reaching inside the flask:
   if the person reaching is the player, say "Your hand passes through the glass as if it were not there, chilling you to the bone.";
   allow access.
 
A rule for reaching inside open containers:
   if the person reaching is the player:
      say "Your hands seem enigmatically too large for [the container in question].";
      deny access.

The "person reaching" is, as its name suggests, the person trying to reach through the barrier in question.

Examples

215.

Magneto's Revenge ★

Kitty Pryde of the X-Men is able to reach through solid objects, so we might implement her with special powers that the player does not have…

RB 10.10 Magic (Breaking the Laws of Physics)

216.

Waterworld ★

A backdrop which the player can examine, but cannot interact with in any other way.

RB 3.4 Continuous Spaces and The Outdoors

217.

Dinner is Served ★★

A window between two locations. When the window is open, the player can reach through into the other location; when it isn't, access is barred.

RB 3.6 Windows

🔗

WI §12.19 Changing visibility

Ordinarily, Inform has a simple model for visibility: it is either fully light or it is fully dark, and certain actions are impossible in the dark, such as examining something.

We first need to remember that darkness affects what actions are even tried, as far as the player's typed commands go. If the player is in a dark room, and there is a screwdriver on the floor, the command EXAMINE SCREWDRIVER will not try any action: the screwdriver is not "in scope", which means that the parser thinks the player does not have any means of knowing it exists. (The rules for scope can be modified - see the chapter on Activities.) But let's suppose that the player types EXAMINE BOOK, and is holding the book in question. The book is now "in scope", so the action "examining the book" is tried.

Some actions require light to be present, and "examining" is one of those. So Inform consults the visibility rules to see if it can go ahead. By default, there is only one visibility rule, which says "yes" in the light and "no" in darkness. Here, though, we create another one:

Visibility rule when in darkness:
   if examining the book:
      say "You have to squint. Still...";
      there is sufficient light;
   there is insufficient light.

A visibility rule must always conclude "there is sufficient light", or "there is insufficient light", or else do nothing and leave it to other rules to decide.

It is a possibly unexpected fact that "looking" does not require light, but instead behaves differently in darkness - it prints a pseudo-room-description such as

Darkness
It is pitch dark, and you can't see a thing.

instead of printing the description of the player's current room. This means that the "looking" action is unaffected by visibility rules. All the same, what "looking" does in the dark can be changed by using the two activities "printing the name of a dark room" and "printing the description of a dark room" (see the Activities chapter for details).

Example

218.

Flashlight ★

Visibility set so that looking under objects produces no result unless the player has a light source to shine there (regardless of the light level of the room).

RB 6.6 Looking Under and Hiding

🔗

WI §12.20 Stored actions

As we have seen, to describe an action fully takes a complicated little bundle of information - we need to know what is to be done, who will do it, and what it will be done to. There are times when we would like to remember an action and look back on it later (perhaps many turns later, after many other actions have taken effect) - but this is not easy to do with only the techniques we have seen so far. There are quite a few cases to get right, and it would be easy to not store quite enough of the details.

Fortunately, Inform provides a kind of value called "action" which can do all of this automatically. (In older versions of Inform this was called "stored action", but the word "stored" is now unnecessary, and makes no difference.) As with most other kinds of value, actions can be held in variables, "let" values, properties or table columns. For example:

The best idea yet is an action that varies.

creates a variable called "the best idea yet" which holds an action.

This will normally be created holding the default value - the player waiting. We really only have two ways to make more interesting actions. One is by typing them out explicitly, like so:

now the best idea yet is pushing the button;

Here "pushing the button" is a constant of the kind "action", so it goes into happily into "best idea yet" in the same way that a number like 3 could go into a number that varies. The action must be specific in every respect, so "taking something" or "doing something" will not work - "taking something" is really a general description of many possible actions, not an action in its own right.

The other way to produce a useful action is:

current action ⇒ action

This phrase produces the action currently being processed as a value - it literally stores the action, and remembers, if necessary, the exact wording of the player's command at the time it was stored - so that even actions arising from commands like LOOK UP X100 IN THE CODE BOOK can be stored faithfully. Examples:

let the present whim be the current action;
say "How you would like to be [current action].";

This only makes sense if an action is currently going on, so it shouldn't be used in "every turn" rules, for instance.

So much for making actions: now for making use of them. The first obvious idea is to store up an action for several turns and then have it take effect later. That's easily done: just as we can "try" any action written out explicitly, so we can also try a stored one. The phrase to do this has exactly the same wording either way, since it does the same thing either way.

But actions can still be useful even if we never intend to try them. For one thing, we can say them, and this produces a fairly natural description of what the action is:

Before doing something in the presence of the bearded psychiatrist: say "'Zo, the subject vishes to engage in [the current action]. Zis is very interesting.'"

will produce text such as:

"So, the subject vishes to engage in rubbing the fireman's pole. Zis is very interesting."

One of Inform's most convenient features is its ability to test if the action being processed matches vague or complicated descriptions of whole classes of actions. For example,

if the best idea yet is taking something, ...

works even though "taking something" is not a single action; it's a description which could apply to many different actions (taking a box, taking a ball, and so on). What Inform tests is whether the "best idea yet" value, a single action, fits this description or not. We can be even vaguer:

if the best idea yet is doing something to the lever, ...

Just occasionally, this can lead to ambiguities. For instance,

if the current action is wearing something, ...

fails because Inform thinks "wearing" is meant in the sense of the current action having clothes on, so it produces a problem message. To avoid this, simply write:

if the current action is trying wearing something, ...

which can't be misunderstood. Something else to be aware of is that the terms "actor", "noun" and so on will refer to that action: for instance, in

if the best idea yet is taking the noun, ...

"noun" here refers to the noun in "best idea yet", not to its meaning outside of this phrase (if indeed it has such a meaning).

When dealing with actions, we sometimes want to know what they are dealing with. We can extract this information using the following phrases:

action name part of (action) ⇒ action name

This phrase produces the action name part of an action. Example: suppose the current actor is Algy, who is throwing the brick at Biggles. Then

action name part of the current action = throwing it at action

noun part of (action) ⇒ object

This phrase produces the (first) noun of an action. Example: suppose the current actor is Algy, who is throwing the brick at Biggles. Then

noun part of the current action = the brick

If the noun is something other than an object, this produces just "nothing", the non-object.

second noun part of (action) ⇒ object

This phrase produces the second noun of an action. Example: suppose the current actor is Algy, who is throwing the brick at Biggles. Then

second noun part of the current action = Biggles

If the second noun is something other than an object (for instance for the command SET DIAL TO 3417 it would be the number 3417), this produces just "nothing", the non-object.

actor part of (action) ⇒ object

This phrase produces the person who would be carrying out the action if it were being tried. Example: suppose the current actor is Algy, who is throwing the brick at Biggles. Then

actor part of the current action = Algy

The following phrase is a convenient shorthand form:

if (action) involves (object):

This condition is true if the object appears as any of the actor, the noun or the second noun in the action. Example:

if the current action involves Algy

would be true for "give revolver to Algy", "Algy trying flying the Sopwith Camel", "examine Algy" and so on, but false for "ask Raymond about secret airfield".

action of (an action) ⇒ action

This phrase is now seldom needed. It produces a literally typed action as a value. Example:

now the best idea yet is the action of pushing the button;

Nowadays in most contexts we can just type "pushing the button" as a value, and that will work fine, so this phrase is retained only to keep old code working.

Examples

219.

Bosch ★

Creating a list of actions that will earn the player points, and using this both to change the score and to give FULL SCORE reports.

RB 11.4 Scoring

220.

Cactus Will Outlive Us All ★

For every character besides the player, there is an action that will cause that character to wither right up and die.

RB 6.14 Remembering, Converting and Combining Actions

221.

Actor's Studio ★★

A video camera that records actions performed in its presence, and plays them back with time-stamps.

RB 9.12 Cameras and Recording Devices

222.

Anteaters ★★

The player carries a gizmo that is able to record actions performed by the player, then force him to repeat them when the gizmo is dropped. This includes storing actions that apply to topics, as in "look up anteater colonies in the guide".

RB 6.14 Remembering, Converting and Combining Actions

🔗

WI §12.21 Guidelines on how to write rules about actions

Looking at the action-processing diagram, there seem to be a bewildering number of ways to intervene. For instance, suppose it must be fatal to pick up a land mine. All six of the following rules would do the business:

Before taking the land mine: end the story saying "Bang!"
Instead of taking the land mine: end the story saying "Bang!"
Check taking the land mine: end the story saying "Bang!"
Carry out taking the land mine: end the story saying "Bang!"
After taking the land mine: end the story saying "Bang!"
Report taking the land mine: end the story saying "Bang!"

So which should we use? Of course, we could decide that it really doesn't matter: what works, works. But it is a good idea to play along with the conventions used by Inform, if only because that will make our rules interact better with each other and with rules by other people which we may someday want to borrow. So this chapter ends by offering a few guidelines. Let us suppose that we have some effect which we want to achieve.

1. Are we just trying to correct the player's typing?

For instance, responding to the command "STEAL GOLDEN EAGLE" with a reply like "To steal something, just try to TAKE it." It is bad style to make a special action for this, which does nothing except to print up this text: better is to use the "Understand … as a mistake" technique, which will come up in the chapter on Understanding.

2. Does the effect apply only to a particular situation, or is it a general phenomenon?

In other words, does the effect apply only to particular people, things or places, or is it a generic rule of play? In the case of the land mine, this is an easy question to answer: it is a unique situation. On the other hand, stopping the player from carrying unduly heavy weights would be a generic rule of play.

Rules like the one saying that photography is only possible if one holds the camera are, by convention, also counted as generic rules of play: they are not really special rules about the camera, but apply to all possible acts of photography anywhere, so are actually generic.

Sometimes we can choose our own answer to this question, and go either way. Suppose we want a certain place to be muddy-floored, affecting things that happen there. One way would be to write exceptional rules applying to that one room. But we could alternatively create a general concept of muddiness ("A room can be clean or muddy. A room is usually clean.") and then regard the new behaviour as being a set of generic rules applying in muddy rooms. We could then, of course, create a second muddy room with much greater ease, or transplant these rules to other works and have muddy rooms in those too.

3. Particular situations: use Instead or After (or sometimes Before).

The next question is: does the effect kick in after the hoped-for action has taken place, or not? In the case of the land mine, to answer that means deciding whether we think the detonator is sensitive to the slightest touch - in which case the explosion would happen at the first touch, and should be in an "Instead" rule - or whether one must actually pick up and disturb the mine - in which case an "After" should be used.

That leaves us a choice of two rulebooks if the effect takes place when the merest impulse towards the action is felt: "Before" and "Instead". Which to use? In cases of doubt, choose "Instead". But if the effect is intended to absolutely suppress all such impulses - for instance, in a silent examination room there must be no talking - then "Before" might be more appropriate. We could imagine that someone about to say something first has a mental impulse to speak, then opens his mouth so that it becomes visible to others that some talking is about to go on, and finally utters words. Here are three possible responses:

"You cannot contemplate breaking this smothering silence." (Before)
"The invigilator stares you down through her horn-rimmed glasses." (Instead)
"Everyone turns, appalled, as the silence is broken like the surface of a swimming pool by a falling elephant." (After)

4. Generic situations: work with action rules (or sometimes Before).

(a) If the effect takes place only when an action is definitely being tried, then we should use one of the action's three rulebooks: check, carry out or report. Check rules should do nothing, and should say nothing either unless they block the action (in which case, they should say why).

Carry out rules must not block the action - it is too late for that - and should not say anything - that hasn't happened yet. (There are a few exceptions: if the action is to look at something, then carrying it out is in a sense the same thing as reporting it. But in all cases of doubt, a carry out rule should say nothing.) Adding a carry out rule to an existing action can make it do something extra.

Report rules must neither block the action nor do anything. Working with new report rules is a way to make more natural-seeming, or more informative, messages appear. For instance, an effect where we want to be able to see through a door when it is first opened ("You open the panelled door, through which is the Board Room.") would be a case for a report rule.

In all cases, it is good style to write check, carry out or report rules in such a way that they could be used in other works too, or in situations that could conceivably have happened in this one (even if in fact it never does). We may one day want to put our new rules into an extension to be used by other people or in other projects, after all.

In this chapter, we have only seen the addition of new rules. We could add a new "check taking" rule, for instance, with the techniques seen so far. But what if the effect we want is not a matter of adding a rule but taking away, or restricting the applicability, of an existing one? In that case, we will need to say that the rule "does nothing" under certain circumstances (see the Rulebooks chapter). The check, carry out and report rules for all of the built-in actions are named, and they appear in the Actions index.

(b) If the effect takes place to divert or supplement an action, before that action actually takes place, then this should be done with a "Before" rule. This is the biggest practical use of "Before" rules: to try other actions, either instead or as well as the one just getting under way.

For example, if we want an automatic mechanism to try opening a container before taking something inside it, that would be a classic case for "Before". Indeed, that is the only way it could work - "Before" rules have a chance to get in before the touchability conditions are tested.

If we wanted a special "stealing" action for the act of taking another person's possessions, we might want to divert any taking action for such items into our new "stealing" action - that too would be a "Before". This would ensure that any "Instead" rules to do with taking do not apply.

5. Changing the behaviour of out-of-world actions.

Remember that "Instead", "Before" and "After" do not apply: so use "check" rules to forbid certain out-of-world activities, or specify that their rules do nothing (see the Rulebooks chapter).

Finally…

These are only guidelines. The system is designed to be flexible in order to give the author the widest possible range of options, and nobody should feel ashamed of making use of them.

§15.

How do we measure things?

§15.

Numbers and real numbers

§15.

Real number conversions

§15.

Printing real numbers

§15.

Arithmetic

§15.

Powers and logarithms

§15.

Trigonometry

§15.

Units

§15.

Multiple notations

§15.

Scaling and equivalents

§15.

Named notations

§15.

Making the verb "to weigh"

§15.

The Metric Units extension

§15.

Notations including more than one number

§15.

The parts of a number specification

§15.

Understanding specified numbers

§15.

Totals

§15.

Equations

§15.

Arithmetic with units

§15.

Multiplication of units

🔗

WI §15.1 How do we measure things?

In a poem, or in a novel, exact scientific measurements are not the point. So a writer who wants to set up ways to describe the sky at different times might go for something like this:

The sky can be cadmium, mackerel, overcast or cornflower.

And nobody is interested in the sun angle, the percentage of cloud cover, or any of the other numbers behind all of this. Similarly, if we walk into a familiar office which has been disturbed, we might well say "Look! The filing cabinet is in the middle of the floor." We are not likely to exclaim "Look! The filing cabinet is 1.2m from the east wall and 2.1m from the north wall."

But some writers of interactive fiction do like to make use of physical realism. For instance, it's easier to forbid a bulky object being taken through a narrow doorway if there is a way to measure and compare sizes.

Most computer programs write numbers in the same way, whatever they're used for. But human beings don't. If someone says "How far is Duluth?", we're more likely to say "100 miles" than just "100". This is a useful feature of natural language, because it means we always know how to translate that number into reality - it's 100 miles, not 100 km, or 100 inches; and it's definitely a distance, not 100 apples or 100 kilograms.

Inform lets us use plain numbers if we want to, but it also allows us to create numerical kinds of value:

A distance is a kind of value. 5 miles specifies a distance.

That kind of definition, and the consequences, will be the subject of this chapter. But we will first look a little harder at the two numerical kinds of value we get for free: "number" and "real number".

🔗

WI §15.2 Numbers and real numbers

Inform uses two different kinds of numerical quantity: "number" and "real number". Neither is better than the other: they're different approaches, each good for a different purpose.

What Inform calls a "number" is a whole number, positive, negative or zero. The range of numbers we can hold is not unlimited - if the format Setting for a project is the Z-machine, then we have:

-32768, -32767, ..., -3, -2, -1, 0, 1, 2, 3, ..., 32767

and if it is set to Glulx, then we have:

-2147483648, -2147483647, ..., -3, -2, -1, 0, 1, 2, 3, ..., 2147483647

Numbers from zero to twelve may be written out, but larger ones must be written as numerals. So "twelve" or "12", but "13" only.

If we're using Glulx, Inform also has "real numbers" such as

2.1718, 4.0, -1633.9

which are not restricted to whole numbers, but which are stored only approximately: only about six to nine decimal digits can be relied on. For example,

showme 1.2345654321;
showme 1.2345667890;

produces

real number: 1.23457
real number: 1.23457

because these two numbers are so close together that Inform can't tell them apart. But we do also get the ability to represent enormously large or small quantities, and to help with that, Inform can read and write "scientific notation". For example,

let Avogadro's number be 6.022141 x 10^23;

is equivalent to typing

let Avogadro's number be 602214100000000000000000.0;

The "x 10^23" part tells Inform that the decimal point belongs 23 places to the left of where it's written. (In scientific papers, the 23 would be printed as a superscript -- it's 10 to the power 23 -- but that's not convenient to type in to the source text, so we use the "^" symbol to indicate superscript.) The range we can hold is roughly:

1.18 x 10^−38 to 3.4 x 10^38

It's hard to convey just how enormously different these two numbers are: if we used them to measure widths in meters, one would be a hundred trillion trillion times smaller than an atom, the other a billion times larger than the entire visible universe. Scientific notation is the ultimate adjustable spanner.

Inform also allows the two most famous real numbers in mathematics to be given by their names:

pi
e

which are close to 3.14159265 and 2.7182818 respectively. (Lower case letters must be used: these can't be written "Pi" or "E". Euler's constant gamma, always in the bronze medal position, will have to be written out longhand as 0.5772156649.)

Most computer programming languages traditionally write floating-point numbers using the E notation, like so:

6.022141E+23;

Inform will follow suit if the use option "Use engineering notation." is set, but by default it isn't.

Example

253.

Alias ★★★

A telephone with phone numbers of the standard American seven-digit length.

RB 9.10 Telephones

🔗

WI §15.3 Real number conversions

This section notes down some technicalities about real numbers which need to be put down in writing somewhere, but won't affect most people most of the time.

Inform allows us to use numbers whenever real numbers are expected, and converts them automatically. For example,

cosine of 2

is read as if it were

cosine of 2.0

and produces -0.41615 either way. This conversion goes from exactness to approximation, so we may lose a little accuracy: real numbers measure to an accuracy of about 1 part in 16000000, so they'll have trouble telling the difference between 16000000 and 16000001. But this is unlikely to matter, since real numbers are used only for approximate calculations anyway.

The ordinary arithmetic operations work on both numbers and real numbers, so the meaning of "N plus M" depends on the kinds of N and M. In general the rule is that if either is a real number then the other one is automatically converted, and real arithmetic is used. So:

divided by 2 = 1
divided by 2.0 = 1.5
0 divided by 2 = 1.5
0 divided by 2.0 = 1.5

In general we can't do the reverse, that is, we can't silently use a real number where a number is expected. For example,

word number 1.6 in "The Great Wall of China"

makes no sense. But we can explicitly convert them:

(real number) to the nearest whole number ⇒ number

This phrase performs signed addition on the given values, whose kinds must agree, and produces the result. Examples:

1.4 to the nearest whole number = 1
1.6 to the nearest whole number = 2
-1.6 to the nearest whole number = -2

We probably ought to bear in mind that the limited range of "number" means that the nearest whole number might not be all that near. For example:

6 x 10^23 to the nearest whole number = 2147483647

because 2147483647 is the highest value a "number" can have.

Finally, real number can also store two interesting not-really-number sorts of value. First, we have

plus infinity, minus infinity

which are used to keep track of what happens when we divide by really small quantities. It's mathematically impossible to divide by 0, but this can be hard to avoid when we're using real numbers, because they're only approximately stored - so it's not always possible to say whether they're exactly 0 or not. So in real number arithmetic,

showme 1.0 divided by 0.0;

doesn't throw a run-time problem the way that

showme 1 divided by 0;

does. Instead, it produces "plus infinity". Infinity behaves roughly the way we might expect - for example, "2 divided by plus infinity" produces 0.0 - but once it comes into a calculation the result probably lies on some extreme and won't be very useful. Amusingly, the following is correct Inform syntax:

plus infinity to the nearest whole number

and evaluates of course to 2147483647. We can use the adjectives "infinite" and "finite" to talk about these numbers: plus infinity and minus infinity are infinite, everything else is finite.

The same problem occurs for calculations like square roots. It's impossible to take the square root of a negative number, but we don't want to throw a run-time problem, because approximation means we can't always guarantee to stay the right side of 0. So for a few calculations like this, Inform generates what's called a "nonexistent" real number. We can use the adjectives nonexistent or existent to talk about this. Every number mentioned on this page so far is "existent", including the infinities. The only way to get a nonexistent number is to carry out an impossible mathematical operation such as

logarithm of -10

(The design of "real number" here follows well established trade-offs for scientific computing. Inform follows the IEEE-754 binary32 standard for floating-point arithmetic, so Inform's "real number" behaves very like the "float" type in C, C++, Java and similar programming languages. A "nonexistent" number is what's often called a NaN - a Not-a-Number.)

🔗

WI §15.4 Printing real numbers

say "[(real number) to (number) decimal places]"

This text substitution writes out the number to the given number of decimal places. Examples:

"The semicircle is roughly [pi to 3 decimal places] paces around."

produces "The semicircle is roughly 3.142 paces around." The number of places can only usefully be from 1 to 8. Note that, for example, "[1.235 x 10^-7 to 3 decimal places]" produces 0.0; "[1.235678 x 10^8 to 3 decimal places]" produces "1.236 x 10^8".

say "[(real number) in decimal notation]"

This text substitution writes out the number in decimal form, that is, avoiding "x 10^n" even for very large or very small quantities. For example,

"[1.23457 x 10^8 in decimal notation]"

produces 123457000.0 rather than 1.23457 x 10^8. This can look pretty extreme: for example, "[1.8983 x 10^27 in decimal notation]", the mass of the planet Jupiter in kilograms, produces 1898296960000000000000000000.0.

say "[(real number) to (number) decimal places in decimal notation]"

This text substitution writes out the number in decimal form, but rounding to the accuracy given.

say "[(real number) in scientific notation]"

This text substitution writes out the number in scientific form, that is, using "x 10^n" even for easy-to-judge quantities. For example,

"[the reciprocal of 137 in scientific notation]"

produces 7.29927 x 10^-3 rather than 0.0073. This can look odd: for example, "[pi in scientific notation]" comes out as 3.14159 x 10^0 rather than 3.14159.

say "[(real number) to (number) decimal places in scientific notation]"

This text substitution writes out the number in scientific form, but rounding to the accuracy given.

🔗

WI §15.5 Arithmetic

We are allowed to perform about the same operations on numbers as are provided by a simple office calculator, starting with addition, subtraction, multiplication and division. We can use the traditional typewriter symbols for these, +, -, * and /, or can spell them out in words as "plus", "minus", "times" (or "multiplied by"), and "divided by". Definitively:

(arithmetic value) + (arithmetic value) ⇒ value

or…

(arithmetic value) plus (arithmetic value) ⇒ value

This phrase performs signed addition on the given values, whose kinds must agree, and produces the result. Examples:

200 + 1 = 201
10:04 AM + two minutes = 10:06 AM

(arithmetic value) - (arithmetic value) ⇒ value

or…

(arithmetic value) minus (arithmetic value) ⇒ value

This phrase performs signed subtraction on the given values, whose kinds must agree, and produces the result. Examples:

200 - 1 = 199
10:04 AM - two minutes = 10:02 AM

(arithmetic value) * (arithmetic value) ⇒ value

or…

(arithmetic value) times (arithmetic value) ⇒ value

or…

(arithmetic value) multiplied by (arithmetic value) ⇒ value

This phrase performs signed multiplication on the given values, whose kinds must be dimensionally compatible, and produces the result. Examples:

201 times 3 = 603
two minutes times 4 = eight minutes

(arithmetic value) / (arithmetic value) ⇒ value

or…

(arithmetic value) divided by (arithmetic value) ⇒ value

This phrase performs signed division on the given values, whose kinds must be dimensionally compatible, and produces the result. Examples:

201 divided by 3 = 67
202 divided by 3 = 67
202.0 divided by 3 = 67.33334
twenty minutes divided by 4 = five minutes
twenty minutes divided by five minutes = 4

Division rounds whole-number values down to the nearest whole number. An attempt to divide a number by 0 will cause a run-time problem message; but an attempt to divide a real number by 0 will instead produce plus infinity or minus infinity.

remainder after dividing (arithmetic value) by (arithmetic value) ⇒ value

This phrase performs signed division on the given values, whose kinds must be dimensionally compatible, and then produces the remainder. Examples:

remainder after dividing 201 by 5 = 1
remainder after dividing twenty minutes by 7 = six minutes

It is mathematically impossible to divide by 0, so any attempt to find the remainder after dividing a number by 0 will cause a run-time problem message. For a real number this won't arise and the remainder will usually be 0.0.

The verbal and symbolic forms of these phrases are equivalent:

the score + 10
the score plus 10

It's probably better style to spell them out in full when writing text, and keep the symbols for writing equations, as we'll see later on in the chapter. (If we do use the symbols, then spaces around them are obligatory: to Inform, they are words which just happen to be spelt with symbols instead of letters.)

Arithmetic often produces fussily exact answers which seem inappropriate in a conversation. Nobody says "Steeple Barton is 7.655 miles down the road", but "Steeple Barton is eight miles down the road" sounds perfectly normal. In order to make that sort of report easier to make, Inform provides another arithmetic operation, one that's not found in most computer programming languages:

(arithmetic value) to the nearest (arithmetic value) ⇒ value

This phrase rounds the given value off, rounding upward in boundary cases. Examples:

to the nearest 5 = 200
to the nearest 10 = 210
27 AM to the nearest five minutes = 10:25 AM

Inform has very few mathematical functions built in as phrases, because these aren't very often needed in story-telling. But it does provide these:

square root of (arithmetic value) ⇒ value

This phrase produces an approximate square root, to the nearest integer, of the given value, which must be of a kind which has square roots. Example:

square root of 16 = 4

Trying to take the square root of a negative number will cause a run-time problem, because then we can't even nearly solve it.

(Warning: this is slow to compute if the Z-machine setting is used. For best performance, use Glulx.)

real square root of (arithmetic value) ⇒ value

This phrase produces a square root, as accurately as a real number can hold it, of the given value, which must be of a kind which has square roots. Example:

real square root of 2 = 1.41421

The real square root of a negative number is nonexistent.

cube root of (arithmetic value) ⇒ value

This phrase produces an approximate cube root, to the nearest integer, of the given value, which must be of a kind which has cube roots. Example:

cube root of 27 = 3
cube root of -27 = -3

(Warning: this is not very accurate if the Z-machine setting is used. For best performance, use Glulx.)

We can compare numbers using either the traditional computer-programming symbols, or using words:

if the score is less than 10
if the score < 10

and similarly for "greater than", "at least" and "at most", with the symbols ">", ">=" and "<=". But we are not allowed the equals sign: for that we need only use "is" -

if the score is 10

🔗

WI §15.6 Powers and logarithms

If the last section provided a basic office calculator, this section and the next provide the more exotic rows of buttons found on a scientific calculator. All of these are done using real number arithmetic. To start with some dull ones, here are two ways to round off numbers:

ceiling of (real number) ⇒ real number

Produces the smallest integer value greater than or equal to the one given. Examples:

ceiling of pi = 4.0
ceiling of -16.315 = -16.0

(Note that the result is still a real number; it simply has no fractional part any more.)

floor of (real number) ⇒ real number

Produces the largest integer value less than or equal to the one given. Examples:

floor of pi = 3.0
floor of -16.315 = -17.0

(Note that the result is still a real number; it simply has no fractional part any more.)

Two more easy functions:

absolute value of (real number) ⇒ real number

Removes the sign from a value, leaving positive numbers alone but making negative ones positive. Examples:

absolute value of 62.1 = 62.1
absolute value of 0 = 0.0
absolute value of -62.1 = 62.1
absolute value of minus infinity = plus infinity

reciprocal of (real number) ⇒ real number

Calculates 1/x, that is, divides up 1 into this many pieces. Examples:

reciprocal of -2 = -0.5
reciprocal of 0.1 = 10.0
reciprocal of 7 = 0.14286
reciprocal of plus infinity = 0.0

Now for taking powers. In general we have:

(real number) to the power (real number) ⇒ real number

Computes x to the power y. Examples:

to the power 4 = 16.0
to the power 0.5 = 10.0
to the power -1 = 0.14286
pi to the power 0 = 1.0

In the words of the Glulx specification document (section 2.12), "the special cases are breathtaking": if you need to know exactly what, say, "minus infinity to the power Y" will do for different cases of Y, refer to the details of the "pow" opcode.

To compute square roots, it's more efficient to use "real square root of X" function than "X to the power 0.5", though both work. To obtain the Nth root of X, we might use:

X to the power (reciprocal of N)

being careful to use "reciprocal of N" rather than "1 divided by N" to make sure we're using real and not integer arithmetic.

Similarly, the following is more efficient than "e to the power …", but equivalent to it:

exponential of (real number) ⇒ real number

Computes e to the given power, where e is the base of natural logarithms. Examples:

exponential of 0 = 1.0
exponential of 1 = e = 2.7182818
exponential of -10 = 4.53999 x 10^-5
exponential of 10 = 22026.46484
exponential of logarithm of 7.12 = 7.12

The reverse of taking powers is taking logarithms.

logarithm to base (number) of (real number) ⇒ real number

Finds what power the base would have to be raised to in order to get this value. Examples:

logarithm to base 10 of 1000000 = 6.0
logarithm to base 10 of 350 = 2.54407
logarithm to base 2 of 256 = 8.0

Logarithms of zero or negative numbers are nonexistent. Note that "logarithm to base 10 of …" is what most calculators call simply "log", but Inform doesn't: it uses "log" for natural logarithms.

natural/-- logarithm of (real number) ⇒ real number

Finds what power e would have to be raised to in order to get this value. Examples:

logarithm of e = 1.0
logarithm of 1 = 0.0
logarithm of 1000 = 6.90776
logarithm of exponential of 7.12 = 7.12

Logarithms of zero or negative numbers are nonexistent. This is the function which most calculators label as "ln", for "log natural", but in mathematical and scientific papers it's more often written "log", and Inform follows that convention.

🔗

WI §15.7 Trigonometry

We have twelve functions left to cover, though they are all closely related.

(real number) degrees ⇒ real number

Inform measures angles in radians, a convention in which the angle for a half circle is pi, and a right angle is pi divided by 2. This is better from a mathematical point of view, but in practice most people think about angles using degrees, where 180 degrees is a half-circle and a right angle is 90 degrees. This phrase helps with that by converting from degrees to radians: in other words, it multiplies by 0.0174532925, since that's roughly 1/180th of pi. Examples:

sine of 90 degrees = 0.0
cosine of 60 degrees = 0.5

sine of (real number) ⇒ real number

The length of the upright of a right-angled triangle with this angle and a hypotenuse of length 1, where angle is measured in radians. Examples:

sine of 0 = 0
sine of 45 degrees = 0.70711
sine of (pi divided by 4) = 0.70711
sine of (pi divided by 2) = 1.0
sine of pi = 0

cosine of (real number) ⇒ real number

The length of the base of a right-angled triangle with this angle and a hypotenuse of length 1, where angle is measured in radians. Examples:

cosine of 0 = 1.0
cosine of 45 degrees = 0.70711
cosine of (pi divided by 4) = 0.70711
cosine of (pi divided by 2) = 0.0
cosine of pi = -1.0

tangent of (real number) ⇒ real number

The ratio of the upright length to the base length in a right-angled triangle with this angle and a hypotenuse of length 1, where angle is measured in radians. Examples:

tangent of 0 = 0.0
tangent of 45 degrees = 1.0
tangent of (pi divided by 4) = 1.0
tangent of (pi divided by 2) = plus infinity

arcsine of (real number) ⇒ real number

The inverse of the sine function.

arccosine of (real number) ⇒ real number

The inverse of the cosine function.

arctangent of (real number) ⇒ real number

The inverse of the tangent function.

hyperbolic sine of (real number) ⇒ real number

The hyperbolic sine function, often written "sinh" but pronounced "shine".

hyperbolic cosine of (real number) ⇒ real number

The hyperbolic cosine function, often written "cosh".

hyperbolic tangent of (real number) ⇒ real number

The hyperbolic tangent function, often written "tanh".

hyperbolic arcsine of (real number) ⇒ real number

The inverse of the hyperbolic sine function.

hyperbolic arccosine of (real number) ⇒ real number

The inverse of the hyperbolic cosine function.

hyperbolic arctangent of (real number) ⇒ real number

The inverse of the hyperbolic tangent function.

🔗

WI §15.8 Units

Suppose we want to talk about how tall people are. We could just create a "number" property, like this:

A person has a number called height.

But then we would have to write lines like "Isabella has height 68", which nobody would naturally say. What we want is to be able to write "Isabella is 5 foot 8." Perhaps the computer will need to store that measurement as the number 68 in some register or other, but we don't want to know about that.

"5 foot 8" is a complicated notation in a way - it involves both feet and inches - so let's start with a simpler example:

A weight is a kind of value. 10kg specifies a weight.

This is a little different to the kinds of value seen so far, which were all created like so:

A colour is a kind of value. The colours are red, green and blue.

We can't mix the two styles: a new kind of value will either be numerical at heart ("10kg") or verbal at heart ("blue").

The effect of "10kg specifies a weight" is to tell Inform that this is the notation for writing a constant "weight". So, for instance,

The maximum load is a weight that varies. The maximum load is 8000kg.
 
if the maximum load is greater than 8000kg, ...

Inform is then careful not to allow weights to be mixed up with other numerical values. For instance, it won't allow "if the maximum load is 400", because 400 is a number, not a weight.

More or less anything we can do with numbers, we can now do with weights. For instance, we can write:

The Weighbridge is a room. "A sign declares that the maximum load is [maximum load]."

…which will produce the text "A sign declares that the maximum load is 8000kg."

Numerical kinds of value are sometimes called "units", because one of their main uses is to allow us to write quantities using scientific units such as kilograms. But they have other uses too. We have a great deal of freedom in creating notations like "10kg", or "4 foot 10" - the main thing is that new notations must not already mean a value. So "10 specifies a weight" will not be allowed, because 10 specifies a number already.

By default we can only write whole-number values. As we've seen, Inform can handle both integer (whole-number) and real arithmetic, and they each have their advantages. The default here is to use whole numbers, so

10 kg specifies a weight.

will store only whole numbers of kilograms (unless clever scaling tricks are used: see the next section). That may be fine, but if we need to handle a wider range of weights, or do scientific calculations that need to be more accurate, this is better:

1.0 kg specifies a weight.

Here Inform can see from the ".0" in the prototype number that real numbers will be involved. (It needs to be ".0" not, say, ".5" because that could be read as a different sort of notation.) We can still write "8000kg", but we can now also write "1.9885 x 10^30 kg" (the mass of the Sun) or "9.109383 x 10^−31 kg" (the mass of an electron). On the other hand, any calculations we do will be limited in accuracy to about 6 to 9 decimal places, exactly as for real numbers.

By default we can only write positive values when whole numbers are used. Sometimes it is unnatural to write negative values, and so Inform will issue a Problem message if this is tried - for instance, Inform would not allow us to write a weight of -4 kg. (This doesn't mean that arithmetic on units is forbidden to get a negative result: we may want to work out the difference between two weights. Inform's Problem message is simply to try to prevent the accidental writing of incorrect values.) If we do want the ability to write negative values in the source text, we signal that in the notation itself:

-10 kg specifies a weight.

That alerts Inform that both positive and negative values for this unit make sense.

If we set up a spread of multiple notations (see the next section) then this is automatically enabled, because then we're clearly dealing with proper physics, where negative values are common; and similarly if we use real numbers (as above).

Examples

254.

rBGH ★

The player character's height is selected randomly at the start of play.

RB 5.1 The Human Body

255.

Lethal Concentration 1 ★★

A poisonous gas that spreads from room to room, incapacitating or killing the player when it reaches sufficient levels.

RB 10.1 Gases

256.

Wonderland ★★

Hiking Mount Rainier, with attention to which locations are higher and which lower than the present location.

RB 6.9 Going, Pushing Things in Directions

257.

Lethal Concentration 2 ★★★

Poisonous gas again, only this time it sinks.

RB 10.1 Gases

🔗

WI §15.9 Multiple notations

Going back to our weight example:

A weight is a kind of value. 10kg specifies a weight.

The notation here is a single word, even if it contains digits as well as letters - "10kg". But it doesn't have to be one word. These would have worked, too:

10kg net specifies a weight.
10 kg specifies a weight.

In fact, we are allowed to have all three at once, as alternatives:

A weight is a kind of value. 10kg specifies a weight. 10kg net specifies a weight. 10 kg specifies a weight.

If we often have to deal with large weights, it becomes a little cumbersome to keep on writing something like "80000kg". An engineer would write "80 tonnes" for this. Similarly, we wouldn't like road maps to use light years, or speed limit signs to use furlongs per fortnight. So it's sometimes useful to provide a spread of different notations, at different scale factors, for the same kind of value. Here's one way of setting up the tonne, that is, the metric ton:

1 tonne specifies a weight scaled up by 1000.

This really is an alternative way to write the same thing: for instance, Inform will allow "25kg plus 3 tonne", the result being "3.025 tonne".

That's all very well, but a value like "3 tonne" reads a little oddly, even if it's correct in theory. Outside of scientific journals with old-school copy editing, most people would write "3 tonnes", not "3 tonne". Here's a better try:

1 tonne (singular) specifies a weight scaled up by 1000.
2 tonnes (plural) specifies a weight scaled up by 1000.

Now Inform will not only recognise both forms, but also use the right one when printing back.

🔗

WI §15.10 Scaling and equivalents

As we've seen, there are two ways to store values like lengths or weights: as whole numbers, or as real numbers. If we prefer to use whole numbers, or if real numbers aren't available (for example if we're using the Z-machine setting), then we might run into an awkward problem: when we write

1 kg specifies a weight.

we make this correspond to the whole number "1", and that means Inform can never handle weights smaller than 1 kg.

But as we've seen, we can provide differently scaled notations for the same unit:

A length is a kind of value. 1m specifies a length.
1km specifies a length scaled up by 1000.

And this allows us to write "0.45km" instead of "450m", if we want to, both having the same effect. "0.45km" doesn't make a real number, despite the decimal point - it's simply another way to write "450m", stored internally as the whole number 450.

Just as we can scale up, so we can also scale down:

1cm specifies a length scaled down by 100.

Now we have a spread of three notations, so "3cm", "0.03m" and "0.00003km" all mean the same thing. But something quite interesting happened at the same time: Inform realised that we want to know lengths to a greater accuracy than just a whole number of meters.

If we're using whole numbers, and we want to resolve down to very small values, that reduces the size of the largest value we can have. For instance, with the Glulx format setting, writing just

A length is a kind of value. 1m specifies a length.

gives us a range of 1m up to 2147483647m, which is plenty - it's about six times the distance from the Earth to the Moon. Going down to centimeters:

A length is a kind of value. 1m specifies a length. 1cm specifies a length scaled down by 100.

gives us instead 1cm up to 21474836.47m, which is still enough to represent any possible distance on the Earth's surface. For instance, London to Sydney is about 17000000m.

Left to itself, Inform chooses the scaling for a unit so that it can represent exactly 1 of the smallest notation - so in our example Inform resolves down to 0.01m, not 1m, in order that it can represent 1cm accurately. But we can also fix the scaling ourselves:

A length is a kind of value. 1m specifies a length scaled at 10000.

Notice "scaled at", not "scaled down" or "scaled up" - this is now the first notation for length, so there's no existing notation which it could scale up or down. Anyway, now the range is 0.0001m, the width of a human hair, up to 214748.3647m, which is about 130 miles. (The Kinds index automatically keeps track of the range of values represented exactly.) The "scaled at" feature is meaningless if we're using real numbers, so it throws a Problem message.

Finally, for a really deluxe kind of value, we can also provide "equivalent" notations. The idea here is that we might want both miles and kilometers to work, even though they aren't direct scalings of each other. We can only do this approximately, but:

1 mile specifies a length equivalent to 1609m.

Equivalent notations are never normally used in printing values back (but see the next section) - we wouldn't want Inform to print a sequence of values such as "1.6km", "1.65km", "1.056 miles", … in an effort to be helpful.

🔗

WI §15.11 Named notations

When it has a variety of notations to choose from, Inform will normally use the neatest one given the size of the value it is printing. Suppose we've set up "weight", with three notations:

A weight is a kind of value. 10kg specifies a weight.
1 tonne (singular) specifies a weight scaled up by 1000.
2 tonnes (plural) specifies a weight scaled up by 1000.

Inform will then print back values like so:

45kg -> "45kg"
1000kg -> "1 tonne"
2500kg -> "2.5 tonnes"
80000kg -> "80 tonnes"

Note the way Inform goes into decimal places in order to talk about 2500kg in terms of tonnes rather than kilograms - it is minimising the integer part of the unit, but trying to keep it non-zero. So Inform prefers "45kg" to "0.045 tonnes".

Although Inform's habit of choosing the best notation available is usually just what we want, we sometimes want to make the choice ourselves. For instance, if we were printing out a table of different weights, we might want to give all of them in kilograms, whatever their size. In that case we can, if we want, give names to our different notations:

1 tonne (singular, in tonnes) specifies a weight scaled up by 1000.
2 tonnes (plural, in tonnes) specifies a weight scaled up by 1000.

Now we could write, for instance:

"The weighbridge warns you not to exceed [the maximum load in tonnes]."

And the figure will always use tonnes now, even if Inform would normally think it odd: "The weighbridge warns you not to exceed 0.001 tonnes." But it will still correctly use "tonne" or "tonnes" as appropriate - what has changed is that instead of choosing from all of the weight notations, Inform now chooses from the notations labelled as "in tonnes".

🔗

WI §15.12 Making the verb "to weigh"

So now we can invent notations for weight. We could, for instance, write:

Weight is a kind of value. 1kg specifies a weight. Every thing has a weight.

And that allows us to write:

The lead pig is in the Salt Mine. The weight of the lead pig is 45kg.

But nobody would say it that way: they'd say "The lead pig weighs 45kg." So what we really need to complete our setup is a verb "to weigh".

We have already created new verbs, but none of those methods are quite convenient for this. We want to relate something tangible (the lead pig) to something intangible (45kg), and there's no convenient relation to express this; if we set it up as a condition, we'd get something we couldn't assert, only test. Instead, we'll do something different this time:

The verb to weigh means the weight property.

Previous definitions like this ended "means the … relation", rather than "means the … property", but the idea is the same. The meaning of "X weighs Y" is that the weight property of X is equal to Y. So we can now write:

A thing usually weighs 1kg. The lead pig weighs 45kg.
something weighing 20kg
if three things weigh 5kg, ...

And as we saw in the chapter on Descriptions, we can also set up adjectives, comparatives and superlatives:

Definition: A thing is heavy if its weight is 20kg or more.

which creates "heavy", "heavier" and "heaviest".

Examples

258.

Dimensions ★★

This example draws together the previous snippets into a working implementation of the weighbridge.

RB 10.5 Volume, Height, Weight

259.

Lead Cuts Paper ★★★

To give every container a breaking strain, that is, a maximum weight of contents which it can bear - so that to put the lead pig into a paper bag invites disaster.

RB 10.5 Volume, Height, Weight

🔗

WI §15.13 The Metric Units extension

To sum all of this up, what started out as a simple business of setting a notation for lengths becomes something quite elaborate when we try to match the actual notations used by scientists and engineers. It's all optional, of course, but as we want more and more of this, we might find ourselves with a spread of notations like this:

1mm ... 1cm ... 1m ... 1km

In addition we might want equivalents for the inch, the yard and the mile; and verbal forms like the meter and the millimeter, and then alternate spellings like the kilometre; and then both singular and plural forms. And that's just length - what about density, area, pressure, velocity and a dozen other physical quantities? After a while these declarations start to look as vastly fussy as a box of presentation cutlery.

Fortunately the whole set is indeed available in a presentation box, and at no extra charge.

(a) The built-in extension "Metric Units by Graham Nelson" sets up a whole range of scientific units, with all the notations we are likely to want. Real numbers are used throughout, so large and small-scale calculations can be carried out quite accurately. Like the other built-in extensions, it has its own documentation and examples.

(b) The built-in extension "Approximate Metric Units by Graham Nelson" does the same but using whole numbers, scaled about right for human situations. This won't be much use for extensive calculations, and won't be as accurate, but it will work reasonably well if real arithmetic isn't available.

🔗

WI §15.14 Notations including more than one number

We've seen quite enough scientific notation for the time being. There are plenty of other notations used in natural language, for everyday concepts, where people don't use a tidy spread of powers of 10. Instead they use mixtures, with some sort of punctuation or text to divide them. For instance, the running time of a piece of music is easier to follow in minutes and seconds than in seconds alone: old-fashioned LP sleeves used to quote running times in the form 4'33.

A running time is a kind of value. 3'59 specifies a running time.

The choice of "3" here makes no difference, much as the choice of "10" in the weight examples was arbitrary. But the "59" is significant. Numbers after the first one are expected to range from 0 up to the value we quote - so in this case, the number of seconds can be anything from 0 to 59. Or, for instance:

A height is a kind of value. 5 foot 11 specifies a height.

A specification can contain up to eight numbers like this, but once again we might need to worry about the maximum value which can be stored. For instance, using the 3'59 notation, we can only go up to 546'07 (if we're using the Z-machine format setting) - a little over 9 hours, so the new Tori Amos album will not be a problem, but some of the more punishing German operas might break the bank.

In notations like this, only the first-appearing number part is allowed to be negative, and then only when declared with a minus sign:

A secret sign is a kind of value. -2x17 specifies a secret sign with parts mystery and enigma.

Here, the mystery can be negative, but not the enigma.

Notations must not contain double-quotation marks because, even though people did once use these to denote minutes of arc, they would simply confuse programs like Inform's user interface which have to keep track of what is quoted text and what is not. But other punctuation marks are fine provided they occur between two digits. For instance, in

A monetary value is a kind of value. $1.99 specifies a monetary value.

the full stop between the 1 and the 99 is not interpreted as a division of two sentences; and similarly for colons in examples such as

An aspect ratio is a kind of value. 16:9 specifies an aspect ratio.

🔗

WI §15.15 The parts of a number specification

We often need to break up a number specification into its pieces. For instance, suppose we want to know the dollars part of $1.99? We can do this by naming the parts:

A monetary value is a kind of value. $1.99 specifies a monetary value with parts dollars and cents.

We can now find the relevant parts like so. Suppose that "sum" is a monetary value. Then:

dollars part of sum
cents part of sum

are both numbers, so for instance we can

say "Looks like around [dollars part of sum in words] dollar[s]."

We can also go the other way:

monetary value with dollars part 4 cents part 72

produces the monetary value $4.72. (Note the lack of commas or "and"s, and that the parts have to be given in the right order.) This is really intended to be useful when we manipulate such values in unusual ways:

An aspect ratio is a kind of value. 16:20 specifies an aspect ratio with parts width and height.
 
To decide which aspect ratio is the wider version of (AR - an aspect ratio):
   let W be the width part of AR multiplied by 2;
   let H be the height part of AR;
   let the wider ratio be the aspect ratio with width part W height part H;
   decide on the wider ratio.

Declaring the parts of a number specification individually also enables us to tack one or more options onto any of the parts:

A monetary value is a kind of value. $1.99 specifies a monetary value with parts dollars and cents (optional, preamble optional).

This declares that the "cents" part is optional - it will be 0 if not specified - and that if omitted, the non-numeric "preamble" before it should also be omitted. Thus "$3" is now valid and equivalent to "$3.00": indeed it will be the preferred form when Inform prints out a monetary value which is an exact number of dollars. If we had said that "cents" was optional, but not said that the preamble was optional, then "$3." would have been the form - which is less satisfactory.

There is only one other option: "without leading zeros", as in the following.

An aspect ratio is a kind of value. 16:20 specifies an aspect ratio with parts width and height (without leading zeros).

This ensures that when the ratio 4:3 is printed, it will be printed as "4:3" and not "4:03" as would otherwise happen.

Example

260.

Zqlran Era 8 ★★★

Creating an alternative system of time for our game, using new units.

RB 4.1 The Passage Of Time

🔗

WI §15.16 Understanding specified numbers

It may be worth noting in passing that number specifications, like all other kinds of value, can be understood in typed commands. (See the chapter on Understanding for more on what can go in such square brackets.) For instance:

"America Stands Tall"

The Oval Office is a room. Josh and Toby are men in the Oval. A height is a kind of value. 5 foot 11 specifies a height. A person has a height. Josh is 5 foot 8. Toby is 5 foot 10.

Height guessing is an action applying to one thing and one height. Understand "guess [someone] is [height]" as height guessing.

Check height guessing: if the noun is not a person, say "You can only guess the height of people." instead. Carry out height guessing: if the height of the noun is the height understood, say "Spot on!"; if the height of the noun is greater than the height understood, say "No, [the noun] is taller than that."; if the height of the noun is less than the height understood, say "No, [the noun] is shorter than that."

Test me with "guess josh is 6 foot 3 / guess josh is 5 foot 9 / guess josh is 5 foot 3 / guess josh is 5 foot 8".

Example

261.

Snip ★★★

A string which can be cut into arbitrary lengths, and then tied back together.

RB 10.6 Ropes

🔗

WI §15.17 Totals

This chapter began by mentioning arithmetic, and then went on a long diversion to create scientific units, everyday weights and measures, and other notational conveniences. Putting all of that together, it's time now to calculate something with all of these numerical quantities.

Suppose we invent the idea of weight, and give everything a weight of its own. Most items will have a nominal weight of 1kg, but people will be heavier. Going on actuarial tables, we might say:

A weight is a kind of value. 10kg specifies a weight. Everything has a weight. A thing usually has weight 1kg. A man usually has weight 80kg. A woman usually has weight 67kg.
 
Definition: A thing is light if its weight is 3kg or less.
Definition: A thing is heavy if its weight is 10kg or more.

and this provides us with "lighter", "lightest", "heavier" and "heaviest" as before. Now we could say "if Peter is heavier than Paul", or even "if Peter is heavier than 75kg", and so forth. We need one more tool:

total (arithmetic values valued property) of (description of values) ⇒ value

This phrase produces the total of some property held by all of the values matching the description. A problem message is produced if the values in question can't have that property ("the total carrying capacity of scenes"), or if it holds a kind of value which can't meaningfully be added up ("the total description of open doors"). Example:

total carrying capacity of people in the Deep Pool

That gives us everything we need for a working balance platform:

The balance platform is a supporter in the Weighbridge. "The balance platform is currently weighing [the list of things on the platform]. The scale alongside reads: [total weight of things on the platform]."

Note that this only works because we said that "everything has a weight": otherwise it would make no sense to add up the weights of things.

This enables us to get the average weight of a group of things, too:

the total weight of things on the platform divided by the number of things on the platform

But we should be careful that this does not accidentally divide by zero, which it will if the platform has nothing on it! As well as the average, we could find the maximum and minimum weights:

the weight of the heaviest thing on the platform
the weight of the lightest thing on the platform

We should remember that "the heaviest thing on the platform" may be ambiguous, because there may be several equally heavy things there. That means

if the lead pig is the heaviest thing on the platform

will only reliably work if there is no possibility of a tie. A safer bet is:

if the lead pig is the weight of the heaviest thing on the platform

Example

262.

Nickel and Dimed ★★★

A more intricate system of money, this time keeping track of the individual denominations of coins and bills, specifying what gets spent at each transaction, and calculating appropriate change.

RB 9.4 Money

🔗

WI §15.18 Equations

Forming totals is all very interesting in its way, but it's book-keeping rather than physics. As a glance at any school science textbook shows, the way to apply physics is to work out an unknown quantity - say, the time taken for a dropped ball to hit the ground - by combining known quantities into an equation - the height it is dropped from, and the strength of gravity.

It's a convention centuries old now that textbooks and research papers never describe these equations in running text. Even for simple formulae, we like to write "F=ma", not "let the force be the mass times the acceleration". And the standard way to print this is to break off and display an equation, not to squeeze it into the text as if it were ordinary verbiage. Just as Inform's Tables imitate those in printed books (see the next chapter), so its Equations do.

In this section, we'll use a combination of three equations to work out how soon and how hard an object pushed off a table will hit the floor. First, we'll include Metric Units, to define all of the kinds of value and notations we need.

Include Metric Units by Graham Nelson.

Now we'll give everything a mass (Metric Units likes to talk about mass instead of weight, but on Earth it's the same thing) and also set up a typical strength for gravity - it's a little less at the poles, a little more at the equator, but this is the conventional approximate value to use.

The acceleration due to gravity is an acceleration that varies. The acceleration due to gravity is usually 9.807 m/ss. A thing has a mass. The mass of a thing is usually 10g.

To a Renaissance scientist, typically living in a walled European town, a cannon ball was a familiar thing, and it often featured in imaginary experiments:

Laboratory is a room. The cannon ball is in the Laboratory. "A cannon ball perches delicately on a lab bench." The mass of the cannon ball is 2kg.

And now we're ready for the three equations. These will all have names, but we could just as easily have numbered them, calling them (say) "Equation 1", "Equation 2" and "Equation 3".

Equation - Newton's Second Law
   F=ma
where F is a force, m is a mass, a is an acceleration.
 
Equation - Principle of Conservation of Energy
   mgh = mv^2/2
where m is a mass, h is a length, v is a velocity, and g is the acceleration due to gravity.
 
Equation - Galilean Equation for a Falling Body
   v = gt
where g is the acceleration due to gravity, v is a velocity, and t is an elapsed time.

An equation has to take the form of one formula equals another, where each formula is made up from symbols defined afterwards. The symbols can be defined as definite values (as "g" is defined in the Galilean Equation), or just by telling Inform their kinds of value (as "v" and "t" are defined).

Equations are read using standard mathematical conventions. So "x + yz" means that we multiply y and z, then add that to x; "ab/cd" divides the product of a and b by the product of c and d. Multiplication signs can be omitted, just as science books normally do (though we can always write them if we want to, using the asterisk *, as usual in computing). The need for brackets is minimised, with any luck, but we can use them if we need to: "x(y+ab)" is legal, for instance.

One difference between Inform's conventions and mathematical ones, though, is that Inform generally ignores upper-versus-lower-case when reading variable names, so it wouldn't be a good idea to write "F = gMm/r^2" and expect "M" and "m" to be different from each other.

Here is the calculation:

Instead of pushing the cannon ball:
   let the falling body be the cannon ball;
   let m be the mass of the falling body;
   let h be 1.2m;
   let F be given by Newton's Second Law where a is the acceleration due to gravity;
   let v be given by the Principle of Conservation of Energy;
   let t be given by the Galilean Equation for a Falling Body;
   say "You push [the falling body] off the bench, at a height of [h], and, subject to a downward force of [F], it falls. [t to the nearest 0.01s] later, this mass of [m] hits the floor at [v].";
   now the falling body is in the location.

And the result is:

You push the cannon ball off the bench, at a height of 1.2m, and, subject to a downward force of 19.614N, it falls. 0.49s later, this mass of 2.0kg hits the floor at 4.85147 m/s.

Not all that fast-moving - it's only about 10 mph, ten times slower than one fired by a Renaissance cannon - but half a second wouldn't give you long to get your foot out of the way.

How was that done? The crucial lines are the ones in the form "let X be given by E…", which is a new form of "let".

let (a name not so far used) be given by (equation name)

or…

let (a temporary named value) be given by (equation name)

This phrase creates a new temporary variable, starting it with the value found by solving the given equation. The variable lasts only for the present block of phrases, which certainly means that it lasts only for the current rule. Example:

let F be given by Newton's Second Law where a is the acceleration due to gravity;

There is also a more compact syntax, giving the equation explicitly:

let KE be given by KE = mv^2/2 where KE is an energy;

When we solve with "let", then, all of the other symbols should either already have values (because they exist as "let" values already made) or else be specified in the line. For instance,

let F be given by Newton's Second Law where a is the acceleration due to gravity;

is allowed because "F" is one of the symbols in "F = ma"; of the other two symbols, we have a "let" variable called "m" already - it's the mass of the cannon ball - and we declare exactly what "a" is.

The next calculation is more interesting:

let v be given by the Principle of Conservation of Energy;

Since the equation here is "mgh = mv^2/2", Inform has to do some algebra to work out "v" in terms of the other unknowns - it's the square root of 2gh, but we don't need to work that out. Inform can't always solve implicit equations - for instance, it can't deduce "m" from this equation - but it's correct on all the easy cases which occur in basic physics, and that enables us to write equations in their most natural form, which is easier to read and understand.

The advantage of setting out an equation formally is that it can be used in many places - we could use Newton's Second Law again for something quite different, for example. But it's a little cumbersome for something simple which we only need once, so this is neater:

let KE be given by KE = mv^2/2 where KE is an energy;

Here the equation is written out explicitly instead of being named, but otherwise everything works in the same way.

Equations can also contain many of our standard functions, which are written for this purpose with their standard mathematical abbreviations. For example:

let x be given by sin x = 1 where x is a real number;

works out x as pi divided by 4, which is to say, 90 degrees. The Phrasebook entries on the mathematical functions give their abbreviations, but here they all are as a list:

abs, root, ceiling, floor, int, log, exp, sin, cos, tan, arcsin, arccos, arctan, sinh, cosh, tanh, arcsinh, arccosh, arctanh

As an example, here's the definition of arcsinh given in the Standard Rules:

To decide which real number is the hyperbolic arcsine of (R - a real number):
   let x be given by x = log(R + root(R^2 + 1)) where x is a real number;
   decide on x.

Something to be a little cautious of: brackets are used in equations to group terms together, and do not mean function application, as they would in a C-like programming language. For example, "sin(1+x)/2" takes the sine of "(1+x)/2": if we want to halve the sine of "1+x", we have to write "(sin(1+x))/2".

Example

263.

Widget Enterprises ★

Allowing the player to set a price for a widget on sale, then determining the resulting sales based on consumer demand, and the resulting profit and loss.

RB 9.4 Money

🔗

WI §15.19 Arithmetic with units

The example equations in the previous section carried out quite a lot of arithmetic, but they may have given the impression that Inform always allows arithmetic - which is not true.

This is actually a good thing, because it keeps us from error. For instance, Inform will not allow:

Equation - Newton's Totally Bogus Law
   F = m^2
where F is a force, m is a mass.

because whatever you get when you square a mass, you don't get a force - in the same way that a length times another length makes an area, not another length. Physicists call this "dimensional analysis", and it often provides clues about which equations are right. Just after the Second World War, someone correctly worked out the explosive power of an atomic bomb without any classified information simply by guessing what values would appear in the formula, and then finding the simplest equation they could appear in.

In general, Inform will not allow numerical kinds of value to be multiplied or divided by each other (or square or cube rooted) unless we give it instructions that this would make sense.

Of course, there's plenty we can still do without any need for such instructions. For instance, going back to weight,

The Weighbridge is a room. "A sign declares that the maximum load is [100kg multiplied by 3]."

…will produce the text "A sign declares that the maximum load is 300kg." Here Inform knows that it makes sense to multiply a weight by 3, and that the result will be a weight. Similarly, Inform allows us to add and subtract weights, and several different forms of division are allowed:

The blackboard is in the Weighbridge. "A blackboard propped against one wall reads: '122 / 10 is [122 divided by 10] remainder [remainder after dividing 122 by 10]; but 122kg / 10kg is [122kg divided by 10kg] remainder [remainder after dividing 122kg by 10kg]; and 122kg / 10 is [122kg divided by 10] remainder [remainder after dividing 122kg by 10].'"

When we visit the Weighbridge, we find:

A blackboard propped against one wall reads: "122 / 10 is 12 remainder 2; but 122kg / 10kg is 12 remainder 2kg; and 122kg / 10 is 12kg remainder 2kg."

Whereas we are not allowed to divide 122 by 10kg: that would make no sense, since 122 is a number and not made up of kilograms. Inform will produce a problem message if we try. Similarly, Inform won't normally allow us to multiply two weights together - but see the next section.

Examples

264.

Frozen Assets ★

A treatment of money which keeps track of how much the player has on him, and a BUY command which lets him go shopping.

RB 9.4 Money

265.

Money for Nothing ★★

An OFFER price FOR command, allowing the player to bargain with a flexible seller.

RB 9.4 Money

266.

Lemonade ★★★

Containers for liquid which keep track of how much liquid they are holding and of what kind, and allow quantities to be moved from one container to another.

RB 10.2 Liquids

267.

Savannah ★★★

Using the liquid implementation demonstrated in Lemonade for putting out fires.

RB 10.2 Liquids

🔗

WI §15.20 Multiplication of units

To recap, then, it is forbidden to multiply 122kg and 10kg, not because it could never make sense (a scientist might occasionally multiply two weights) but because the result is - what? Not a number, and not a weight any more. But we are allowed to tell Inform what the result ought to be, and once we have done so, the multiplication will be allowed:

A length is a kind of value. 10m specifies a length. An area is a kind of value. 10 sq m specifies an area.

A length times a length specifies an area.

The balance platform is in the Weighbridge. "The balance platform is 10m by 8m, giving it an area of [10m multiplied by 8m]."

which will turn up as:

The balance platform is 10m by 8m, giving it an area of 80 sq m.

And having told Inform that lengths multiply to area, we could also divide an area by a length to get a length: no further instructions would be needed.

The built-in "Metric Units" extension includes all of the standard ways that physical quantities are multiplied, and a good way to see these is to try out one of the Metric Units examples and look at the Kinds index, which includes a table showing how all of this works.

Examples

268.

Depth ★

Receptacles that calculate internal volume and the amount of room available, and cannot be overfilled.

RB 10.5 Volume, Height, Weight

269.

Fabrication ★★

A system of assembling clothing from a pattern and materials; both the pattern and the different fabrics have associated prices.

RB 9.4 Money

270.

The Speed of Thought ★★

Describing scientifically-measured objects in units more familiar to the casual audience.

RB 10.5 Volume, Height, Weight

§17.

Understand

§17.

New commands for old grammar

§17.

Overriding existing commands

§17.

Standard tokens of grammar

§17.

The text token

§17.

Actions applying to kinds of value

§17.

Understanding any, understanding rooms

§17.

Understanding names

§17.

Understanding kinds of value

§17.

Commands consisting only of nouns

§17.

Understanding values

§17.

This/that

§17.

New tokens

§17.

Tokens can produce values

§17.

Understanding things by their properties

§17.

Understanding things by their relations

§17.

Context: understanding when

§17.

Changing the meaning of pronouns

§17.

Does the player mean...

§17.

Multiple action processing

§17.

Understanding mistakes

§17.

Precedence

🔗

WI §17.1 Understand

During play, the computer and the player alternate in writing messages to each other: in the player's case, these are short instructions, usually saying what to do next. A wide range of such "commands" are automatically understood, but these only apply to the standard built-in actions. (This wide range is conveniently tabulated in the Commands part of the Actions index.) If we want the player to be able to command new actions, then we need to specify what is to be understood as what. For this, we supply special sentences starting with the word "Understand".

Suppose we return to the earlier example of a newly created action:

Photographing is an action applying to one visible thing and requiring light.

We then supply lines of grammar (as they are called) for Inform to recognise, like so:

Understand "photograph [someone]" as photographing.
 
Understand "photograph [an open door]" as photographing.

As usual, the square brackets indicate something which stands for text, rather than text to be taken verbatim. "[someone]" needs to be the name of anything of the kind "person", for instance (though as usual that person will need to be in sight of the player for the name to be accepted). The first word - in these examples "photograph" - must be something definite, not a substitution like this.

For obvious reasons, this pattern of words needs to match the expectations of the action. Photographing applies to "one visible thing" - the "visible" just means it does not need to be touched, only seen - so neither of these would be allowable:

Understand "photograph" as photographing.
Understand "photograph [someone] standing next to [something]" as photographing.

The first is probably bad because it supplies no things at all, the second is certainly because it supplies two: what we want, of course, is just the one. (The reason the first is only probably bad is that it's possible to tell Inform how to choose the object if the player doesn't: see the "supplying a missing noun" activity.)

Examples

286.

Indirection ★

Renaming the directions of the compass so that "white" corresponds to north, "red" to east, "yellow" to south, and "black" to west.

RB 3.2 Map

287.

XYZZY ★

Basics of adding a new command reviewed, for the case of the simple magic word XYZZY.

RB 6.13 Magic Words

288.

Xylan ★★

Creating a new command that does require an object to be named; and some comments about the choice of vocabulary, in general.

RB 10.2 Liquids

🔗

WI §17.2 New commands for old grammar

In the photography example, we are providing entirely new grammar for an action not ordinarily built in to Inform. But we often want simply to provide alternative grammar for existing actions, or even to put new interpretations on commands that Inform already recognises. For instance:

Understand "deposit [something] in [an open container]" as inserting it into.

The inserting action is built in to Inform, but the command "deposit" is not, so this is created as new. It is occasionally useful to put a twist on this:

Understand "fill [an open container] with [something]" as inserting it into (with nouns reversed).

The clause "(with nouns reversed)" tells Inform to exchange the two nouns parsed, which is necessary because the inserting action expects the noun to be the item and the second noun to be the container, not vice versa.

The following example:

Understand "access [something]" as opening.

might look as if it makes "access" behave just like "open" when the player types it, but that's not so: "open" can also be used in constructions like "open the door with the brass key", in which case it is understood as the unlocking action. We could add another line to make "access" behave this way too, but if what we really want is to make "access" behave just like "open", it's easier simply to say so:

Understand the command "access" as "open".

This is very useful when adding a new command which needs synonyms:

Understand the commands "snap" and "picture" as "photograph".

We can check the current stock of commands by looking at the table in the Actions index: for instance, before making "snap" synonymous with "photograph", it might be wise to check that it is not already defined as a command for breaking something.

Examples

289.

Alpaca Farm ★

A generic USE action which behaves sensibly with a range of different objects.

RB 6.17 Clarification and Correction

290.

Anchorite ★

By default, Inform understands GET OFF, GET UP, or GET OUT when the player is sitting or standing on an enterable object. We might also want to add GET DOWN and DOWN as exit commands, though.

RB 6.10 Entering and Exiting, Sitting and Standing

291.

Cloak of Darkness ★★★★

Implementation of "Cloak of Darkness", a simple example game that for years has been used to demonstrate the features of IF languages.

RB 3.7 Lighting

🔗

WI §17.3 Overriding existing commands

Suppose we are devising specialist commands for a game of whist, and we want "discard" as one of them. Looking at the table of commands in the Action index, we find that, inconveniently enough, "discard" already has a meaning: it is synonymous with "drop", and while that might be sensible most of the time, it is perfectly wrong now. We need a way to free up "discard" for our own use. We can do that by:

Understand the command "discard" as something new.

This cuts it loose, so to speak, and ready to be given new meanings. If we check the Actions index again, we find no mention of "discard" - it is now a blank slate - but "drop" is still exactly as it was. We could now say something like:

Understand "discard [something]" as discarding.

(If we had declared that "drop" was something new, the whole thing would have happened in reverse, with "discard" retaining all of the original grammar. Inform does not distinguish between a command and its synonym.)

The "… as something new" sentence works even for a command which did not exist anyway, for instance with:

Understand the command "zylqix" as something new.

Of course this does nothing - but it is intentional that it generates no problem messages: it means that the sentence can be used to force a command to be fresh and untouched by previous definitions, which might be useful when working with extensions by other people.

It is also possible to clear out all the commands leading to a given action:

Understand nothing as taking.

The commands "take" and "get" will still exist, but now they'll only have their other senses (for taking off clothes, for getting out of boxes).

Examples

292.

The Trouble with Printing ★

Making a READ command, distinct from EXAMINE, for legible objects.

RB 9.6 Reading Matter

293.

Lanista 2 ★★

Randomized combat in which the damage done depends on what weapons the characters are wielding, and in which an ATTACK IT WITH action is created to replace regular attacking. Also folds a new DIAGNOSE command into the system.

RB 7.5 Combat and Death

🔗

WI §17.4 Standard tokens of grammar

We have already seen "[something]" and "[someone]", which are standard examples of "tokens of grammar" - patterns matched by suitable named things. There are several other standard tokens, provided not so much from necessity but to allow the story parser to be more graceful and responsive. "[someone]" matches the same possibilities as "[a person]" would, but the parser handles it a little better in cases of failure. These special tokens are best explained by looking at some of the examples in the standard grammar, which can be browsed in the Index of any story.

Understand "wear [something preferably held]" as wearing.

Here we expect that the named item will be one that is held by the player, and the parser will use this to resolve ambiguities between names of things carried and not carried. (If the action is one which positively requires that its noun be something carried, a command matching this token against something not carried will generate an automatic attempt to take it.)

Understand "take [things]" as taking.
Understand "drop [things preferably held]" as dropping.

"[things]" is like "[something]" but allows a list of items, or a vague plural like "all", to be typed. The result will be a sequence of actions, one for each item thus described. "[things preferably held]" is the analogous token for "[something preferably held]".

Understand "take [things inside] from [something]" as removing.

"[things inside]" matches only what is inside the second-named thing, and ensures that (for instance) the command "take all from box" does not also try to take the box.

Understand "put [other things] in/inside/into [something]" as inserting it into.

Similarly, "[other things]" will allow anything except the second-named thing. (Like "[things inside]" it is really only needed for handling containers.)

Finally there is "[any things]", which should be used only with care. This is like "[things]" but with no restriction at all on where the item comes from: it might be invisible, or from a different room, or out of play altogether. If we use this, we had better remember that it would match ALL, with quite extravagant consequences.

Examples

294.

Shawn's Bad Day ★

Allowing the player to EXAMINE ALL.

RB 6.15 Actions on Multiple Objects

295.

The Left Hand of Autumn ★★★

The possibility of using a [things] token opens up some interesting complications, because we may want actions on multiple items to be reported differently from actions on just one. Here we look at how to make a multiple examination command that describes groups in special ways.

RB 6.5 Examining

🔗

WI §17.5 The text token

Most actions involve items: taking a vase, perhaps. As we shall see, they might also involve values, or a mixture of the two: turning a dial to 17 would involve both a thing (the dial) and a number (17). A few of Inform's built-in actions, however, can act on any text at all. For instance, asking the Sybil about the Persian army would involve a thing (the Sybil) and some text ("Persian army"). Inform does not try to understand automatically what that text might mean, or to relate it to any items, places or values it knows about: instead, Inform leaves that to the specific story to work out for itself, since the answer is bound to depend on the context. (In the chapter on Tables, we saw ways to compile tables of responses to particular topics of conversation.)

The token for "accept any text here" is just "[text]". For instance, if we create an action with:

Getting help about is an action applying to one topic.

We can then provide grammar for this action like so:

Understand "help on [text]" as getting help about.

When text like this is successfully matched, it is placed in a value called "the topic understood". (The term "topic" is used traditionally, really: most of the times one needs this feature, it's for a topic of conversation, or a topic being looked up in a book.)

The fact that "[text]" can match anything means that it's difficult to tell which version of a command was intended if they disagree only from a "[text]" onwards. For example, given:

Yelling specifically is an action applying to one topic. Understand "yell [text]" as yelling specifically. Understand "yell [text] at/to [someone]" as answering it that (with nouns reversed).

…Inform will in fact try the second possibility first, as being the more specific, but the result may freeze out the first possibility altogether due to autocompletion of commands.

Examples

296.

Ish. ★

A (very) simple HELP command, using tokens to accept and interpret the player's text whatever it might be.

RB 11.3 Helping and Hinting

297.

Nameless ★★

ASKing someone about an object rather than about a topic.

RB 7.7 Saying Simple Things

🔗

WI §17.6 Actions applying to kinds of value

Almost all actions apply to things: the player picks them up, pushes them, looks at them and so on. We only occasionally need to recognise other kinds of value, but when we do, we can. For instance:

Adjusting it to is an action applying to one thing and one number.
 
Understand "adjust [something] to [a number]" as adjusting it to.

The substitution "[a number]" matches any number (actually any whole number that is not too large) typed by the player. Inform checks the various kinds being used to make sure that everything matches, so, for instance, this would be disallowed:

Understand "adjust [something] to [something]" as adjusting it to.

Examples

298.

Safety ★

A safe whose dial can be turned with SPIN SAFE TO 1131, and which will open only with the correct combination.

RB 9.2 Bags, Bottles, Boxes and Safes

299.

Tom's Midnight Garden ★

A clock kind that can be set to any time using "the time understood"; may be turned on and off; and will advance itself only when running. Time on the face is also reported differently depending on whether the clock is analog or digital.

RB 9.11 Clocks and Scientific Instruments

300.

Ibid. ★★

A system which allows the author to assign footnotes to descriptions, and permits the player to retrieve them again by number, using "the number understood". Footnotes will automatically number themselves, according to the order in which the player discovers them.

RB 12.3 Footnotes

🔗

WI §17.7 Understanding any, understanding rooms

Ordinarily, if we write

Understand "manipulate [something]".

then the "[something]" will only match what is within reach or sight: this is the concept of "scope", which is what prevents a player from spookily acting on objects from a distance. The parser itself prevents the manipulation rules from ever being invoked on such distant items, which is as it should be.

Sometimes, though, we positively want to allow this possibility. If we use the special word "any", as in

Understand "manipulate [any door]".

then any door, anywhere in the model world, can be allowed in the player's command. (Of course, the manipulation rules may not do what the player hopes: all that has happened is that the command is now possible to type.) The "any" can be followed by any description of items or rooms, and the latter opens up new possibilities, since rooms are ordinarily never allowed to be named in the player's commands.

For example, the following gives the player the ability to walk between rooms without giving explicit directions of movement.

Going by name is an action applying to one thing.
 
Carry out going by name: say "You walk to [the noun]."; move the player to the noun.
 
Understand "go to [any adjacent visited room]" as going by name.

(This is really only a sketch: in a finished work, "go to" would produce helpful errors if non-adjacent but visited rooms were named, and we might also worry about rules applying to movement, because the method above will circumvent them.)

As might be expected, "[anything]" means the same as "[any thing]"; "[anybody]" and "[anyone]" mean the same as "[any person]"; and "[anywhere]" means the same as "[any room]".

Examples

301.

One of Those Mornings ★

A FIND command that allows the player to find a lost object anywhere

RB 5.4 Background

302.

Actaeon ★★

A FOLLOW command allowing the player to pursue a person who has just left the room.

RB 7.13 Traveling Characters

🔗

WI §17.8 Understanding names

So far in this chapter, Understand sentences have been used to give names to actions, but they can also be used to name objects - in particular, things and rooms.

This normally happens automatically. For instance, writing

The St Bernard is an animal in the Monastery Cages.

makes ST BERNARD refer to the dog, and MONASTERY CAGES refer to the room. But sometimes, as here, that isn't really enough. Why shouldn't the player type EXAMINE DOG? One way to allow this is to write:

Understand "dog" as the St Bernard.

Matters become more complicated when the player wants to refer to more than one object at once. When a kind is created, and the source text constructs multiple duplicate items of that kind, Inform generates a plural of the kind's name in order to understand commands referring to these multiples. For instance, given…

The Lake is a room. A duck is a kind of animal. Four ducks are in
   the Lake.

…the player can type TAKE DUCKS to try to pick up all four.

Once again the automatic behaviour can be enhanced:

Understand "birds" and "ruddy ducks" as the plural of duck.

Now TAKE BIRDS and TAKE DUCKS are equivalent. Plurals can even, strange as it may seem, be given for single things:

The magpie is in the Lake. Understand "birds" as the plural of the magpie.

And now TAKE BIRDS tries to take all four ducks and the magpie too.

🔗

WI §17.9 Understanding kinds of value

In many cases, if K is the name of a kind of value, then Inform automatically makes an Understand token called "[K]" which matches only values of K. An example is "[number]", which matches text like 203 or SEVEN. There is a chart of the kinds of value in the Kinds index for a project, showing which ones can be understood in this way.

In particular, any newly created kind of value can always be understood. We make good use of that in the example story "Studious":

"Studious"

The Studio is a room. "The unreal world of the photographic studio, full of fake furniture, cantilevered stands and silver-white shades like miniature parachutes." The lumpy black camera is in the Studio. "A lumpy black camera hangs from a tripod."

The rake-thin model is a woman in the Studio. "A rake-thin model, exquisitely bored and boringly exquisite, angles herself indolently."

Limb is a kind of value. The limbs are left leg, left arm, right leg and right arm.

Detailing is an action applying to one limb and one visible thing, requiring light. Check detailing: if the camera is not carried then say "You can hardly photograph without a camera, now can you?" instead. Report detailing: say "Click! You take a detail photograph of the [limb understood] of [the second noun]."

Understand "photograph [limb] of [a person]" as detailing.

Test me with "get camera / photograph left leg of model".

Note the way we can refer to the limb mentioned by the player as the "limb understood". Similarly, we could talk about the "number understood" if the value parsed had been a number, and so on.

One of the built-in kinds of value is worth special note: time. A time can hold either a specific time of day, such as 10:23 PM, or a duration of something, such as 21 minutes. The "[a time]" token matches times of day, such as 10:15 AM or MIDNIGHT. But 10 MINUTES wouldn't be recognised by "[a time]" since it isn't a specific moment in the day. To get around this, an alternative version called "[a time period]" is available. So:

Understand "wait for [a time period]" as ...

would match WAIT FOR AN HOUR or WAIT FOR TWO HOURS 12 MINUTES.

Examples

303.

Pages ★

A book with pages that can be read by number (as in "read page 3 in…") and which accepts relative page references as well (such as "read the last page of…", "read the next page", and so on).

RB 9.6 Reading Matter

304.

Down in Oodville ★★

Offering the player a choice of numbered options at certain times, without otherwise interfering with his ability to give regular commands.

RB 6.18 Alternatives To Standard Parsing

305.

Straw Into Gold ★★★

Creating a Rumpelstiltskin character who is always referred to as "dwarf", "guy", "dude", or "man" -- depending on which the player last used -- until the first time the player refers to him as "Rumpelstiltskin".

RB 2.1 Varying What Is Written

🔗

WI §17.10 Commands consisting only of nouns

In every example so far, and in almost all practical cases, the first word in a command which results in an action will be something fixed: a verb, in fact. When we write

Understand "photograph [something]" as photographing.

we are saying that the first word of such a command will always be "photograph". Occasionally, though, we would like to understand a noun as a command, perhaps in a situation where the command is obvious. If we say:

Understand "[something]" as examining.

then the command "examine" will be implicit when the player types a bare noun:

A red box and a blue ball are here.
> BALL
The blue ball is plaited from many small leather patches.

so that the command "ball" has resulted in the action "examining the blue ball".

This is a feature which should be used sparingly, since it could easily lead to confusion if not carefully explained to the player. By default, it is not used at all.

It also has what may be a serious limitation: verbless commands like this work only when typed by the player as actions to follow - they do not work as instructions for other people. So for instance SVEN, BALL would not ask Sven to try examining the ball - instead it would generate the action "answering ball to Sven". (This is because the Inform parser decides whether PERSON, SOME TEXT is a request or just conversation by looking at the first word after the comma to see if it's a command.)

Examples

306.

Misadventure ★

A going by name command which does respect movement rules, and accepts names of rooms as commands.

RB 6.9 Going, Pushing Things in Directions

307.

Safari Guide ★★

The same functionality, but making the player continue to move until he reaches his destination or a barrier, handling all openable doors on the way.

RB 6.9 Going, Pushing Things in Directions

🔗

WI §17.11 Understanding values

"Understand" can be used to supply new ways to talk about both things and other values. For instance, if we create:

A brass lantern is in the Building.

then it can be called "brass", or "lantern", but not "lamp": Inform does not really know what these words mean, and has no grasp of synonyms. We can arrange for "lamp" to work as well like so:

Understand "lamp" as the lantern.
Understand "old lamp" as the lantern.

With care, we can do the same trick for entire kinds of thing at once. It is not ordinarily the case that a thing can be called by the name of its kind: if we put a woman called April into a room, then she can usually be called "April", but not "woman". (The exception is when we do not specify any name for her - in that case, Inform will give up and call her just "woman".) So there is not usually any form of words which can refer to anything of a given kind. If we should want this, we have to say so explicitly:

Understand "machine" as a device.

Device is a kind, so now the word "machine" can be used to refer to any device: if there are two in the same place, the result might play out like so:

>switch machine on
Which do you mean, the bale twiner or the grain thresher?
>twiner
You watch absorbed as a perfect cube of hay is trussed up like a parcel.

Similarly, we might conceivably want to allow new ways to recognise values - in this case, a number:

Understand "eleventy-one" as 111.

When making complicated names, we need to watch out for the possibility of writing a definition which will cause Inform to go around in circles (something which will show up as a "Too many activities at once" run-time problem). For instance,

Understand "[thing] substitute" as the placebo.

will fail because Inform, working left to right, needs to look for every possible object name before it can progress: one possibility is the placebo itself: to check that, it needs to look for every possible object name: and so on, never finishing. A definition like this one very likely matches too much in any case (would we really want to accept PLACEBO SUBSTITUTE or CIGARETTE SUBSTITUTE SUBSTITUTE SUBSTITUTE here, as the definition implies?).

Examples

308.

Palette ★

An artist's workshop in which the canvas can be painted in any colour, and where painterly names for pigments ("cerulean") are accepted alongside everyday ones ("blue").

RB 9.7 Painting and Labeling Devices

309.

Baritone, Bass ★★★

Letting the player pick a gender (or perhaps other characteristics) before starting play.

RB 5.2 Traits Determined By the Player

🔗

WI §17.12 This/that

We have already seen "or" used in "Understand" sentences:

Understand "scarlet" or "crimson" as red.

In general, any number of alternative forms can be given which are to be understood as the same thing (in this case the colour red). When the alternatives are in any way complicated, "or" should always be used, but a shorthand form is allowed for simple cases where it is only a matter of a single word having several possibilities:

Understand "reach underneath/under/beneath [something]" as looking under.

This is shorthand for:

Understand "reach underneath [something]" or "reach under [something]" or "reach beneath [something]" as looking under.

Which in turn is shorthand for:

Understand "reach underneath [something]" as looking under. Understand "reach under [something]" as looking under. Understand "reach beneath [something]" as looking under.

It's possible also to make that second word optional:

Understand "reach underneath/under/beneath/-- [something]" as looking under.

because "--" is read by Inform as "no word at all". If "--" is an option, it can only be given once and at the end of the list of possibilities.

To recapitulate: the slash "/" can only be used between single, literal words, and is best for the wayward prepositions of English ("in/into/inside", and so forth). For anything more complex, always use "or".

🔗

WI §17.13 New tokens

We have now made good use of square-bracketed tokens, such as "[something]", in a variety of "Understand…" sentences. It is sometimes convenient to create new tokens of our own, to match whatever grammar we choose: this enables complicated knots of grammar to be used in many different "Understand…" sentences without having to write it all out each time.

For instance, here are new tokens: one for each of two groups of alternative prepositions.

Understand "beneath/under/by/near/beside/alongside/against" or "next to" or "in front of" as "[beside]".
 
Understand "on/in/inside" or "on top of" as "[within]".

Again, note that the slash indicates a choice between words only, not between entire phrases. For instance, if we write:

Understand "red bird/robin" as "[robin]".

then the two alternative forms are "red bird" and "red robin", not "red bird" and "robin". By contrast,

Understand "red bird" or "robin" as "[robin]".

will understand either "red bird" or "robin" but not "red robin". If we want to capture all three forms, we might define

Understand "red bird/robin" or "robin" as "[robin]".

Example

310.

Lies ★

Commands to allow the player to lie down in three different ways.

RB 6.10 Entering and Exiting, Sitting and Standing

🔗

WI §17.14 Tokens can produce values

The examples just seen were tokens which simply matched specific words typed by the player, but newly created tokens can also produce values:

Colour is a kind of value. The colours are red, green and blue. Understand "colour [a colour]" or "[a colour] shade" as "[tint]".

Here the "[tint]" token matches, for instance, "colour red" and "blue shade", which would result in the values red and blue, respectively.

Tokens are not allowed to produce more than one value, and if several patterns are given to define them then those patterns have to be compatible. That means the following is disallowed, since it might work out to a colour, or to an object, leaving Inform unable to judge whether an action can safely be applied to the result.

Understand "colour [a colour]" or "[something]" as "[tint]".

🔗

WI §17.15 Understanding things by their properties

Items are ordinarily understood only by their original given names. For instance, if we have:

In the Herb Garden is a china pot.

then the player could refer to this as "pot", "china pot" or "china". We can embellish this by adding extra forms:

Understand "chinese pot" or "chinese vase" as the china pot.

But suppose the pot changes its nature in the course of play? If we have:

The china pot can be unbroken or broken. The china pot is unbroken.
 
After dropping the china pot:
   say "Crack!";
   now the china pot is broken;
   now the printed name of the pot is "broken pot".

So now the player would reasonably expect to call it "broken pot", a wording which would have been rejected before. We can achieve this by writing:

Understand the unbroken property as describing the pot.

which allows "unbroken" or "broken" to describe the pot, depending on its state. And, since the player might well use a different adjective but with the same idea in mind, we can even add:

Understand "shattered" or "cracked" or "smashed" as broken. Understand "pristine" as unbroken.

This is something of a toy example, but the feature looks rather more useful when there are more pots than just one:

"Terracotta"

A flowerpot is a kind of thing. A flowerpot can be unbroken or broken. Understand the broken property as describing a flowerpot.

After dropping an unbroken flowerpot:

say "Crack!";

now the noun is broken;

now the printed name of the noun is "broken flowerpot";

now the printed plural name of the noun is "broken flowerpots".

The Herb Garden is a room. In the Herb Garden are ten unbroken flowerpots.

We then have the dialogue:

Herb Garden
You can see ten flowerpots here.
>get two flowerpots
flowerpot: Taken.
flowerpot: Taken.
>drop all
flowerpot: Crack!
flowerpot: Crack!
>look
Herb Garden
You can see two broken flowerpots and eight flowerpots here.
>get an unbroken flowerpot
Taken.

and so on and so forth.

There are in fact two slightly different forms of this kind of sentence:

Understand the broken property as describing a flowerpot.
Understand the broken property as referring to a flowerpot.

The only difference is that in the "describing" case, the property's name alone can mean the thing in question - so "take unbroken" will work; whereas, in the "referring to", the property's name can only be used as an adjective preceding the name of thing itself - so "take unbroken flowerpot" will work but "take unbroken" will not.

Examples

311.

Aspect ★

Understanding aspect ratios (a unit) in the names of televisions.

RB 9.9 Televisions and Radios

312.

Hymenaeus ★

Understanding "flaming torch" and "extinguished torch" to refer to torches when lit and unlit.

RB 3.7 Lighting

313.

Channel 1 ★★

Understanding channels (a number) in the names of televisions.

RB 9.9 Televisions and Radios

314.

Terracottissima ★★

The flowerpots once again, but this time arranged so that after the first breakage all undamaged pots are said to be "unbroken", to distinguish them from the others.

RB 10.4 Glass and Other Damage-Prone Substances

315.

Peers ★★

The peers of the English realm come in six flavours - Baron, Viscount, Earl, Marquess, Duke and Prince - and must always be addressed properly. While a peerage is for life, it may at the royal pleasure be promoted.

RB 7.1 Getting Acquainted

316.

Channel 2 ★★★

Understanding channels (a number) in the names of televisions, with more sophisticated parsing of the change channel action.

RB 9.9 Televisions and Radios

317.

Terracottissima Maxima ★★★

Flowerpots with textual names that might change during play.

RB 2.3 Using the Player's Input

318.

Tilt 1 ★★★

A deck of cards with fully implemented individual cards, which can be separately drawn and discarded, and referred to by name.

RB 9.5 Dice and Playing Cards

🔗

WI §17.16 Understanding things by their relations

Sometimes it makes sense for the name of something to involve the names of other things to which it is related. For instance, if we say TAKE THE BOTTLE OF WINE, we mean that the bottle currently contains wine - if it were the very same bottle containing water, we would call it something else.

For names which must involve related names, a special form of token is provided. For instance, we could say:

A box is a kind of container. Understand "box of [something related by containment]" as a box.
 
The Toyshop is a room. The red box is a box in the Toyshop. Some crayons are in the red box.

and now TAKE BOX OF CRAYONS will work, because CRAYONS matches against "[something related by containment]" for the red box - or it does for as long as the crayons are there. We can have similar matches against relations of all kinds, but have to name the relation explicitly. (See the examples at the end of this section for plenty of cases.)

We can also reverse the sense. If we write:

A box is a kind of container. Understand "box in [something related by reversed containment]" as a box.
 
The Toyshop is a room. The crate and the hammock are in the Toyshop. In the crate is a box. In the hammock is a box.

then TAKE THE BOX IN THE HAMMOCK will work: here, the relation goes the other way, because the box is being contained by the other-named item, rather than doing the containing.

Examples

319.

Cinco ★

A taco shell that can be referred to (when it contains things) in terms of its contents.

RB 9.2 Bags, Bottles, Boxes and Safes

320.

Puncak Jaya ★

When a character is not visible, responding to such commands as EXAMINE PETER and PETER, HELLO with a short note that the person in question is no longer visible.

RB 5.5 Memory and Knowledge

321.

Whither? ★

A door whose description says where it leads; and which automatically understands references such as "the west door" and "the east door" depending on which direction it leads from the location.

RB 3.5 Doors, Staircases, and Bridges

322.

Claims Adjustment ★★

An instant camera that spits out photographs of anything the player chooses to take a picture of.

RB 9.12 Cameras and Recording Devices

🔗

WI §17.17 Context: understanding when

We have now seen several different forms of "Understand" sentence: for instance,

Understand the colour property as describing a building block.
Understand "mix [colour] paint" as mixing paint.
Understand "rouge" as red.
Understand "curious girl" as Alice.

Any of these may optionally have a condition tacked on: for instance,

Understand "mix [colour] paint" as mixing paint when the location is the Workshop.
Understand "rouge" as red when the make-up set is visible.

In principle, "when …" can take in any condition at all. In practice a little care should be exercised not to do anything too slow, or which might have side-effects. (For instance, referring the decision to a phrase which then printed text up would be a bad idea.) Moreover, we must remember that the "noun" and "second noun" are not known yet, nor do we know what the action will be. So we cannot safely say "when the noun is the fir cone", for instance, or refer to things like "the number understood". (We aren't done understanding yet.) If we want more sophisticated handling of such cases, we need to write checking rules and so on in the usual way.

Contexts can be useful to make sense of things having different names depending on who is being spoken to, as here:

Understand "your" as a thing when the item described is held by the person asked.

With this rule in place FRODO, GIVE ME YOUR RING means that Frodo will know which ring is meant, even if there are a couple of dozen other rings present.

If the name of something has to change completely, perhaps because the player's understanding of events has changed completely, then Inform's standard way of handling names can be a nuisance. When an item or room is created, Inform automatically makes its name understood as referring to it (in fact, it makes each individual word in that name understood). For instance,

The Wabe is a room. The blue peacock and the sundial are in the Wabe.

means that the player can type EXAMINE BLUE PEACOCK or PUSH SUNDIAL or SHOWME WABE or TAKE BLUE, and so on. This is almost always a good thing, and here there's no problem, because peacocks and sundials are not usually disguised. But here is a case where a disguise is needed:

The secret document is a privately-named thing in the drawer.
The printed name of the secret document is "[if the secret document is handled]secret document[otherwise]dusty paper".
Understand "dusty" and "paper" as the secret document.
Understand "secret" and "document" as the secret document when the secret document is handled.
After taking the secret document for the first time: say "Heavens! It is the secret document!"

As this demonstrates, the either/or property "privately-named" makes Inform create a thing or room which starts out with no automatic understandings at all. The name it happens to have in the source text is ignored. If we simply write:

The ungraspable concept is a privately-named thing in the Dining Room.

then nothing the player can type will ever refer to it; though he will see it, and even be able to pick it up by typing TAKE ALL.

The reverse property is "publicly-named", which all things and rooms are by default.

Inform has four built-in kinds of object (room, thing, direction and region), and all of those have this either/or property. When we create new kinds, they're normally kinds of those four fundamental ones, so they pick up the same behaviour. But if we create a new kind of object outside of these four, that won't be true unless we make it so:

A concept is a kind of object. A concept can be privately-named or publicly-named. A concept is usually publicly-named.

(Privately-named is a property which only affects how Inform creates the object, and it can't usefully be given or taken away during play. "Understand … when …" is the way to change names during play.)

Examples

323.

Quiz Show ★

In this example by Mike Tarbert, the player can occasionally be quizzed on random data from a table; the potential answers will only be understood if a question has just been asked.

RB 2.2 Varying What Is Read

324.

Bibliophilia ★★

A bookshelf with a number of books, where the player's command to examine something will be interpreted as an attempt to look up titles if the bookshelf is present, but otherwise given the usual response.

RB 9.6 Reading Matter

🔗

WI §17.18 Changing the meaning of pronouns

The pronouns IT, HIM, HER and THEM are constantly adjusted during play, to save the player time when typing commands. If the player types EXAMINE NECKLACE on one turn, it's sufficient to type TAKE IT on the next, and IT will be understood as meaning whatever NECKLACE meant last turn.

All of that happens automatically, but once in a while the result can be unfortunate. Suppose that when the player examines the necklace, a security system automatically drugs her unconscious, and she wakes up in a cell, hours later, and is told that the cell is bare except for a key on the floor. If she types TAKE IT, she clearly doesn't mean IT to mean the necklace any more; she means the key. Inform's parser can't make guesses like this, so the following phrase can be used to help it.

set pronouns from (object)

This phrase adjusts the meaning of pronouns like IT, HIM, HER and THEM in the command parser as if the object mentioned has become the subject of conversation. Example: the combination of

set pronouns from the key;
set pronouns from Bunny;

might change IT to mean the silver key and HIM to mean Harry "Bunny" Manders, while leaving HER and THEM unaltered.

Example

325.

Pot of Petunias ★

Responding sensibly to a pot of petunias falling from the sky.

RB 2.2 Varying What Is Read

🔗

WI §17.19 Does the player mean...

When the player types an ambiguous reference, we need to work out what is meant. Consider the following source text:

The Champs du Mars is a room. The great Eiffel Tower is here. "The great Tower stands high over you." The souvenir model Eiffel Tower is here. "Comparatively tiny is the souvenir version."

Now suppose the player types GET TOWER. The response will be:

Which do you mean, the great Eiffel Tower or the souvenir model Eiffel Tower?

Which is a silly question, exposing our work of IF as something artificial. It's obvious to the author of the source text, and to the player, that the souvenir must be what is meant: but this is not obvious to the computer program running the story. Works of IF gain a subtle feeling of quality from being able to understand ambiguous references of the kind above, and Inform provides us with a way to do this by giving the parser clues in the form of "Does the player mean…" rules. For instance, if we add:

Does the player mean taking the great Eiffel Tower: it is very unlikely.

then the response to GET TOWER will now be:

(the souvenir model Eiffel Tower)
Taken.

"Does the player mean…" rules look at the actions which are possible interpretations of what the player typed, and grade them according to how likely they seem. (Note that these rules are only ever used to handle ambiguities: if the player unambiguously types GET GREAT EIFFEL TOWER, that will be the action. And the rules are only used where they are able to make a decision: if there are still multiple equally plausible meanings, the parser will ask about all possibilities, not just the most likely ones.) Rules in this rulebook can either decide nothing, or come up with one of the following verdicts:

it is very likely
it is likely
it is possible
it is unlikely
it is very unlikely

If there are no "does the player mean" rules, or the rules make no decision on a given possible action, it will be ranked as "it is possible".

We may use these rules to affect all sorts of interaction with a specific object or kind of object, as in

Does the player mean doing something with the cursed dagger of Thog: it is very unlikely.
Does the player mean doing something with the cursed dagger of Thog when the player is hypnotized: it is likely.

…and so on.

Notice that we can also make rules about actions that apply to two objects, so for instance:

Does the player mean throwing the can of shoe polish at the shoe polish vending machine: it is likely.

which nicely clarifies THROW POLISH AT POLISH, but does not comment on the likelihood of throwing the can at other things or of throwing other things at the vending machine. Moreover, the (suspected) identity of the first item will be known when the rule is consulted; thus

Does the player mean tying the noun to the noun: it is very unlikely.

will tell Inform to prefer not to tie something to itself if other interpretations are available.

But there is a caveat. There are some cases where this mechanism will not in fact help Inform to choose its way out of an ambiguous command, because of the way it parses one noun at a time. It usually needs to understand the first noun before it will even try to make sense of the second. So a rule like:

Does the player mean throwing the can of shoe polish at the tree: it is likely.

may not work if the player types THROW POLISH AT TREE and POLISH is ambiguous, because when the parser is trying to understand POLISH, it hasn't yet seen to the end of the command and realised that the second noun will be the tree; so the second noun is unset and the rule won't match.

As a caveat to the caveat, the "inserting it into", "removing it from" and "putting it on" actions have this slightly back to front. These are parsed using the (little-used) "[other things]" or "[things inside]" tokens, and the Inform parser tries to detect the second noun before the first one, since the identity of the first has to depend on the second. So for instance if the situation contains "an oak tree" and also "an oak chest", we could write:

Does the player mean inserting into the oak chest:
   it is very likely.

which would successfully make PUT COIN IN OAK mean the chest, not the tree. (Note the way we write "inserting into" without saying anything about what's being inserted, not even that it's "something".)

Example

326.

Masochism Deli ★

Multiple potatoes, with rules to make the player drop the hot potato first and pick it up last.

RB 10.9 Heat

🔗

WI §17.20 Multiple action processing

When the player types a command like DROP ALL, this is (usually) a request to carry out more than one action. After the command parser has decided what constitutes "ALL" (a process which can be influenced using the "deciding whether all includes" activity), it forms up a list and then runs through it, starting an action for each in turn. The result usually looks something like this:

>GET ALL
foxglove: Taken.
snake's head fritillary: Taken.

However, by adding rules to the rulebook:

multiple action processing rules

we can take a look at the actions intended, and rearrange or indeed change them before they take effect. To do that, we have to deal with a special list of objects. For two technical reasons this isn't stored as a "list of objects that varies" - first because it needs to exist even in low-memory situations where we can't afford full list-processing, and second because there are times when changing it might be hazardous. Instead, two phrases are provided to read the list and to write it back:

multiple object list ⇒ list of objects

This phrase produces the current multiple object list as a value. The list will be the collection of objects found to match a plural noun like ALL in the most recent command typed by the player. If there is no multiple object, say if the command was TAKE PEAR, the list will be empty: it won't be a list of size 1.

alter the multiple object list to (list of objects)

This phrase sets the multiple object list to the given value. The list is ordinarily the collection of objects found to match a plural noun like ALL in the most recent command typed by the player, but using this phrase at the right moment (before the "generate action rule" in the turn sequence rules takes effect).

Examples

327.

The Best Till Last ★★

Reordering multiple objects for dramatic effect.

RB 6.15 Actions on Multiple Objects

328.

Western Art History 305 ★★

Allowing EXAMINE to see multiple objects with a single command.

RB 6.15 Actions on Multiple Objects

🔗

WI §17.21 Understanding mistakes

When inspiration strikes the player, he can usually be relied upon to make a good-faith effort to communicate the new idea: he will guess the right command. If he guesses wrongly, the mistake is probably the author's, because a good author will try to anticipate all possible wordings and make all of them work.

Nevertheless it is sometimes good practice to nudge the player towards the right wording - particularly if the player has the right idea but is not explicit enough: for instance, typing TALK TO JUDGE when we really want to know what is to be said (JUDGE, GUILTY); or if the player tries something like PLAY CHESS rather than MOVE PAWN TO KING 4. Similarly, if we make a casual reference such as "In your childhood days, you loved sliding in stocking feet across this hallway", a player might type SLIDE IN STOCKING FEET: a nice idea, and which deserves a nice response, even though it asks to do something beyond the scope of the story.

Inform provides a simple mechanism for recognising a command but at the same time recognising that it does not properly specify an action. Such commands are called "mistakes", for the sake of a memorable term, but the player has not really behaved badly, and should be helped rather than reproved. For instance:

Understand "act" as a mistake.

While that works - the command to "act" is indeed rejected - it is not very good, because no very helpful message is brought up. The following is much better:

Understand "act" as a mistake ("To join the actors, you have to adopt a role in the play! Try PLAY HAMLET or similar.").

Or we could once again insist on a given context:

Understand "act" as a mistake ("To join the actors, you have to adopt a role in the play! Try PLAY HAMLET or similar.") when the location is the Garden Theatre.

That still has the drawback that the command "act hamlet" will not be recognised: so the final version we want is probably

Understand "act [text]" as a mistake ("To join the actors, you have to adopt a role in the play! Try PLAY HAMLET or similar.") when the location is the Garden Theatre.

since the "[text]" part will soak up any words the player types (or none), meaning that any command at all whose first word is "act" will be matched.

We need to be careful to avoid circular things like this:

Understand "[text]" as a mistake ("'[the topic understood]' is something I really wish you wouldn't say.") when the topic understood is a topic listed in table 1.

This doesn't work because the topic understood isn't set until the line has been understood, but Inform checks the "when…" condition before it tries to understand the line. Indeed, even this:

Understand "[text]" as a mistake ("'[the topic understood]' is something I really wish you wouldn't say.").

is unsafe (quite apart from being unwise!) - again, "topic understood" doesn't exist for a mistake, because in a mistake, nothing is understood.

The following is often useful during beta-testing of a new work, though we would not want it in the final published edition. Many authors like to ask their testers not to try anything in particular, simply to play naturally: but to record the transcript of the session, and email it back to the author. The following command is a device to allow the tester to type a comment in to the transcript:

Understand "* [text]" as a mistake ("Noted.").

For instance, the tester might type "* DIDN'T WE SAY DARCY WAS TALL?", to which the story would reply "Noted." - and the author can search for such comments when receiving the transcript.

If we are careful, we can make the reply depend on what was typed in the mistaken command:

Understand "steal [something]" as a mistake ("Just TAKE [the noun] and leave without paying: that's stealing in my book.").

The care comes in because Inform applies much less checking to mistakes than to other actions, and odd errors will result if we try to refer to (say) "the second noun" in a command which did not have a second noun.

It's probably wise to take particular care if using "as a mistake" with any command which might include the mistake among what the player calls ALL: for example, if "take [sydney harbour bridge]" is understood as a mistake, then TAKE ALL will may result in this, even though the player doesn't intend any such thing.

Addendum

"act [text]" won't match "any word (or none)": it fails to match when it's none. You would need Understand statements.

Examples

329.

Query ★

Catching all questions that begin with WHO, WHAT, WHERE, and similar question words, and responding with the instruction to use commands, instead.

RB 11.3 Helping and Hinting

330.

The Gorge at George ★

If the player tries to TALK TO a character, suggest alternative modes of conversation.

RB 7.6 Getting Started with Conversation

331.

Hot Glass Looks Like Cold Glass ★★★

Responding to references to a property that the player isn't yet allowed to mention (or when not to use "understand as a mistake").

RB 10.9 Heat

🔗

WI §17.22 Precedence

When several different lines of grammar are supplied to meet the same circumstances, it makes a big difference what order they are tried in. For instance, suppose we have:

Understand "photograph [a door]" as photographing.
 
Understand "photograph [an open door]" as photographing.

The second line is more specific than the first, so Inform takes these grammar lines the other way around: it checks for "open door" before it checks for "door". That didn't matter here, since both lines came out with the same result (the action of photographing), but it matters very much in the next example:

Understand "employ [a door]" as opening.
 
Understand "employ [an open door]" as entering.

More subtle is a line already seen:

Understand "on/in/inside" or "on top of" as "[within]".

Here Inform puts "on top of" before "on/in/inside", since otherwise only the "on" of "on top of" will be recognised.

Mistakes always take precedence over non-mistakes: this is intended to make sure that

Understand "take umbrage" as a mistake ("Nobody takes umbrage in this story, mister.").

will take precedence over

Understand "take [something]" as taking.

even if there is, in fact, a character called Mr Nimbus Umbrage so that the command could conceivably make sense.

Finally, there are a few grammars where the number of values produced is different in different lines. For example, the Standard Rules include these among the possible "put" commands:

Understand "put [something preferably held] on" as wearing.
Understand "put [other things] on/onto [something]" as putting it on.

One produces a single object, the other produces two. Inform gives precedence to the first of these, that is, it tries the one with fewer values first. This is important when reading commands like "PUT MARCH ON WASHINGTON SHIRT ON", and also prevents bogus auto-completions, in which PUT HAT ON might wrongly be auto-completed as if it were PUT HAT ON THE TABLE.

Examples

332.

Some Assembly Required ★

Building different styles of shirt from component sleeves and collars.

RB 9.3 Clothing

333.

Lakeside Living ★★★

Similar to "Lemonade", but with bodies of liquid that can never be depleted, and some adjustments to the "fill" command so that it will automatically attempt to fill from a large liquid source if possible.

RB 10.2 Liquids

§18.

What are activities?

§18.

How activities work

§18.

Rules applied to activities

§18.

While clauses

§18.

New activities

§18.

Activity variables

§18.

Beginning and ending activities manually

§18.

Introduction to the list of built-in activities

§18.

Deciding the concealed possessions of something

§18.

Printing the name of something

§18.

Printing the plural name of something

§18.

Printing a number of something

§18.

Listing contents of something

§18.

Grouping together something

§18.

Issuing the response text of something

§18.

Printing room description details of something

§18.

Printing inventory details of something

§18.

Printing a refusal to act in the dark

§18.

Printing the announcement of darkness

§18.

Printing the announcement of light

§18.

Printing the name of a dark room

§18.

Printing the description of a dark room

§18.

Constructing the status line

§18.

Writing a paragraph about

§18.

Listing nondescript items of something

§18.

Printing the locale description of something

§18.

Choosing notable locale objects for something

§18.

Printing a locale paragraph about

§18.

Deciding the scope of something

§18.

Clarifying the parser's choice of something

§18.

Asking which do you mean

§18.

Supplying a missing noun/second noun

§18.

Reading a command

§18.

Implicitly taking something

§18.

Printing a parser error

§18.

Deciding whether all includes

§18.

Printing the banner text

§18.

Printing the player's obituary

§18.

Amusing a victorious player

§18.

Starting the virtual machine

🔗

WI §18.1 What are activities?

It is poor form to define with negatives, but the first thing to say about activities is that they are not actions. This needs saying because Inform often seems to treat them as if they are, by allowing us to write rules like so:

Before printing the name of a woman, say "Ms ".

With this rule in place, someone called "Daphne" will always be described as "Ms Daphne", and so on. The language looks as if we were imposing a rule on an action called "printing the name of", but there is no such action: instead, it is an "activity". To spell out the difference:

An action is a simulated task for the fictional protagonist.
 
An activity is a real task for the computer program doing the simulation.

Activities allow us to influence or change some of the standard habits of Inform, using rules as flexible and powerful as those applicable to actions, though activities are in several ways simpler and easier.

Example

334.

Ant-Sensitive Sunglasses ★

What are activities good for? Controlling output when we want the same action to be able to produce very flexible text depending on the state of the world -- in this case, making highly variable room description and object description text.

RB 3.1 Room Descriptions

🔗

WI §18.2 How activities work

All activities start, continue for a while and then finish: however, no activity ever runs on for more than a single turn. Several activities can be going on at the same time. For instance, suppose the following is printed as part of the description of a grocery:

You can see a banana, an apple and a star-fruit here.

At the moment when Inform prints "apple", two activities are under way: "listing contents of the Grocery", and "printing the name of the apple". The sequence of events was in fact:

say "You can see "
start listing contents of the Grocery
   say "a "
   start printing the name of the banana
      say "banana"
   finish printing the name of the banana
   say ", an "
   start printing the name of the apple
      say "apple"
   finish printing the name of the apple
   say " and a "
   start printing the name of the star-fruit
      say "star-fruit"
   finish printing the name of the star-fruit
finish listing contents of the Grocery
say " here."

The golden rule is: if activity B starts during activity A, it must also finish during activity A.

If we ever need to find out, we can always test:

if the printing the name activity is going on, ...
if the printing the name activity is not going on, ...

but as we shall see, it's usually simpler to attach "while printing the name" provisos to rules.

🔗

WI §18.3 Rules applied to activities

The activity "printing the name of something" is the process of printing up the name of something on screen: ordinarily, this means saying the text in its "printed name" property.

As with actions, rules can be attached to activities which change or augment what would normally happen. In fact the situation is simpler, because (unlike an action) an activity almost always finishes, so we almost always do reach its "after" stage. There are also only three rulebooks attached to an activity, as compared with the six affecting an action.

The three rulebooks for printing the name are called "before printing the name", "for printing the name" and "after printing the name", and this is the general pattern. What happens is:

All "before printing the name of" rules are considered;
The most specific, applicable "rule for printing the name of" is considered;
All "after printing the name of" rules are considered.

Whereas an action's later stages never take place if an early stage ends unexpectedly, an activity always goes through all three of its stages. Invoking the word "instead" in a before rule for an action will terminate not only the before rules but the whole action: the same thing for an activity will only terminate the before rules, and the for and after rules will take place as usual.

The actual task is usually carried out by one single rule tucked into the back of the "for…" rulebook: it is the rule for printing the name of whatever is concerned, hence the name. Inform's standard activities are all of this pattern: they start out with no "before" or "after" rules, and just one "for" rule.

Why the part about an activity only "almost always" finishing? One reason is that the story might end during it; but another is that it's possible, though uncommon, to abandon an activity partway. Very few of the activities supplied with Inform ever do this, and those that do are noted in the sections which follow.

🔗

WI §18.4 While clauses

Rules applied to actions can become baroque ("after going through a door in the presence of an animal when -" and so on and so forth), but activities are again simpler: they only have one possible clause attached, which is called "while". For instance, the following would provide a fairly sledgehammer hint that the sack should not lightly be thrown away:

The sack is a player's holdall. The sack is carried. Rule for printing the name of the sack while the sack is not carried: say "your abandoned sack".

Any condition can be given after the "while", and we can also specify that another activity has to be going on. Thus:

Rule for printing the name of the lemon sherbet while listing contents: say "curious sort of lemon sherbet sweet".

This nicely distinguishes between contexts where it's appropriate to be more verbose, and where it isn't. Thus:

You can see a teaspoon and a curious sort of lemon sherbet sweet here.
> TAKE ALL
teaspoon: Taken.
lemon sherbet: Taken.

🔗

WI §18.5 New activities

Activities are all about influencing the standard mechanisms which Inform uses, so it might at first seem that there is no need to create new activities: but on further reflection, quite a lot of the writing of interactive fiction involves creating new and systematic ways to do things, and as soon as we have a general rule, we will want to have exceptions. Inform therefore allows us to create our own activities, giving us ways to influence the operation of our own mechanisms.

There are two kinds of activity: those which relate to a specific value (usually an object but not necessarily), and those which do not. Here are some examples of activities being created:

Assaying is an activity.
Analysing something is an activity.
Announcing something is an activity on numbers.

Inform looks for the clue "something" (or "of something") after the activity's name to see if it will work on a value: so analysing and announcing will do, but assaying won't. If we don't specify a kind, Inform assumes the value will be an object, as if we had written:

Analysing something is an activity on objects.

As always in Inform, the names of activities are themselves values.

"assaying activity" has kind activity on nothing
"analysing activity" has kind activity on objects
"announcing activity" has kind activity on numbers

Creating an activity is like creating an action: it automatically makes new rulebooks - "before analysing", "for analysing" and "after analysing" - but they start out empty, so the activity does nothing yet. Just as it does for rulebooks, Inform defines the adjectives "empty" and "non-empty" for activities to test this state:

if the analysing activity is empty, ...

will be true only when all three of its rulebooks are empty.

A newly created activity never happens unless we take steps to make it do so. We can make an activity happen at any time by writing phrases like so:

carry out the (activity) activity

This phrase carries out the given activity, which must be one not applying to any value. Example:

carry out the assaying activity;

carry out the (activity on values) activity with (value)

This phrase carries out the given activity, which must apply to a kind of value matching the one supplied. Example:

carry out the analysing activity with the pitchblende;
carry out the announcing activity with the score;

To make the activity do something useful, we need to put a rule into its "for" rulebook:

Rule for announcing a number (called N): say "Ladies and gentlemen, [N]."
 
The last for assaying rule:
   say "Professionally, you cast an eye around mineral deposits nearby, noticing [list of rocks in the location]."

"The last" is a technicality about rulebooks (see the next chapter) which, put briefly, guarantees that this rule comes last among all possible "for assaying" rules. This is good form because the whole point of an activity is to make it easy for further rules to interfere - so we deliberately hang back to last place, giving precedence to anybody else who wants it.

The "for" rulebook is one where rules stop the activity, by default, when they take effect - in the same way that the "instead" rules stop actions by default. If this causes problems, we can use:

continue the activity

This phrase should be used only in rules in activity rulebooks. It causes the current rule to end, but without result, so that the activity continues rather than stopping as a result of the rule. This is useful for rulebooks (like the "for" rulebook of an activity) where the default is that a rule does stop the activity.

Activities are more useful than they first appear. Every new one provides a context which other activities can observe. We could, for instance, define

Rule for printing the name of a rock while assaying: ...

so that during assays more technical names are used.

Examples

335.

AARP-Gnosis ★★

An Encyclopedia set which treats volumes in the same place as a single object, but can also be split up.

RB 9.6 Reading Matter

336.

Aftershock ★★★

Modifying the rules for examining a device so that all devices have some specific behavior when switched on, which is described at various times.

RB 9.9 Televisions and Radios

337.

Crusoe ★★★

Adding a "printing the description of something" activity.

RB 6.5 Examining

🔗

WI §18.6 Activity variables

Just as actions can have variables, which are created when the action starts and disappear when it finishes, so activities can also have variables. They are visible to the rules for that activity, and nowhere else. (If the activity should happen a second time within its first run, that second occurrence gets its own copy of the variable, leaving the original untouched.)

Typically it will be useful to set a variable to some default value at the "before" stage, calculate some interesting value for it in the "for" stage, and make use of the outcome during the "after" stage. For instance:

Analysing something is an activity. The analysing activity has a text called first impression. Instead of examining something (called the sample), carry out the analysing activity with the sample.
 
Before analysing: now the first impression is "unremarkable".
 
Rule for analysing someone: now the first impression is "living tissue".
 
After analysing something (called the sample):
   say "Your professional opinion of [the sample] is that it is
      [first impression]."

🔗

WI §18.7 Beginning and ending activities manually

If we have declared a new activity, like "analysing", the normal way to make it happen would be to write

carry out the analysing activity with the pitchblende;

which goes through the whole machinery of rules - before, for, after - and then resumes, the activity having started, taken place and come to an end.

But there are times when it is not convenient to write a suitable "for …" rule, or where we need more control, and do not wish to hand the whole business over to a single phrase. For such times we are allowed to write:

begin the (activity) activity

This phrase causes the named activity to become active, and runs its "before" rulebook. The activity must be one which applies to nothing. Example:

begin the assaying activity;

In all cases a matching "end the … activity" or else "abandon the … activity" phrase must be reached.

begin the (activity on values) activity with (value)

This phrase causes the named activity to become active, and runs its "before" rulebook. The activity must be one which applies to a value of a matching kind. Example:

begin the analysing activity with the pitchblende;

In all cases a matching "end the … activity with …" or else "abandon the … activity with…" phrase must be reached.

And when we are done:

end the (activity) activity

This phrase runs the "after" rulebook of the activity and then causes it to become inactive. The activity must be one which applies to nothing. Example:

end the assaying activity;

This must only happen to match an earlier "begin the … activity" phrase.

end the (activity on values) activity with (value)

This phrase runs the "after" rulebook of the activity and then causes it to become inactive. The activity must be one which applies to a value of a matching kind. Example:

end the analysing activity with the pitchblende;

This must only happen to match an earlier "begin the … activity with…" phrase.

So the usual structure is like so:

begin the analysing activity with the pitchblende;
...
end the analysing activity with the pitchblende;

This time the activity is ongoing throughout as many phrases as we care to write between the "begin" and "end". The before rules are considered at the time of the "begin …" phrase; the after rules at the "end …".

What, then, of the "for" rules? In the above setup, they would simply be ignored. But we can make them effectual thus

begin the analysing activity with the pitchblende;
...
if handling the analysing activity with the pitchblende:
   ...
...
end the analysing activity with the pitchblende;

We place the activity's normal behaviour inside the "if"; the condition, "if handling…", is true only if no rule has intervened. This means that we (or other authors using our activity) can create their own for rules to substitute here. If we elsewhere write

Rule for handling the analysing activity with the pitchblende when the player is not sober:
   say "You can't seem to focus."

that rule will intervene and take the place of whatever we have placed inside the condition.

if handling (activity) activity:

This should be used only where the given activity has been started with "begin …" and will be finished with "end …". It runs the "for" rules for the activity, and then comes out true if none of those for rules intervened in the handling of that activity. (The activity must be one which doesn't apply to any value.)

if handling (activity on values) activity with (value):

This should be used only where the given activity has been started with "begin …" and will be finished with "end …". It runs the "for" rules for the activity, and then comes out true if none of those for rules intervened in the handling of that activity. (The given value must be the one it is being applied to.)

It is also legal to force an early end to an activity with:

abandon the (activity) activity

This phrase ends an activity at once (without consulting any further rulebooks, including its "after" rulebook). It can only be used with an activity which has had its "begin" but not yet its "end" phrase; it is a drastic remedy best taken only if it is clear that circumstances have changed so that the activity now seems inappropriate. It must not be used during one of the rules for the activity: it can only be used between the begin and for stages, or between the for and end stages.

abandon the assaying activity;

abandon the (activity on values) activity with (value)

abandon the analysing activity with the pitchblende;

We need to follow three golden rules: all activities must end, they must never last longer than a turn, and if activity B starts during activity A then it must also finish during activity A. We must also be careful to make sure that if an activity applies to something, then it begins and ends with the same something (the pitchblende, in the above example).

🔗

WI §18.8 Introduction to the list of built-in activities

Activities tend to be about process, rather than outcome. Many of the things Inform does - printing up lists of items, reading commands from the keyboard, and so on - are done as activities, because that way the process can be nudged a little. Too many works of interactive fiction betray their mechanical nature by making it visible that the general machinery being used does not quite seem natural for this or that situation. Activities enable us to add the many graceful touches which avoid that: which contribute nothing to a work, and also everything.

The rest of this chapter covers every activity built in to Inform, with one section for each. It is intended primarily for reference, but may be worth skimming through at a first reading, to give a sense of the possibilities.

🔗

WI §18.9 Deciding the concealed possessions of something

1. When it happens. Frequently - whenever Inform needs to check whether something is visible or not. Nothing should be printed, and the activity needs to run quickly, so it should not (for instance) calculate best routes through complicated maps before getting an answer.

2. The default behaviour. There is no concealment. The ordinary rules still apply, though: the contents of a closed opaque container are invisible because there is a barrier in the way which cannot be seen through, even though nobody is "concealing" anything.

3. Examples. To repeat a number of brief examples given at the end of Chapter 3, where this activity made an early appearance:

Rule for deciding the concealed possessions of the Cloaked Villain: if the particular possession is the sable cloak, no; otherwise yes.
 
The coin is in the Roman Villa. The face and inscription are parts of the coin. Rule for deciding the concealed possessions of the coin: if the coin is carried, no; otherwise yes.

The value "particular possession" is the one whose concealment is in question, of course. We can ignore this if someone is invariably secretive:

Rule for deciding the concealed possessions of the furtive ghost: yes.

In general a rule for deciding the concealed possessions of something will decide "yes" if finishes without making a decision, but it's better style to write such a rule in such a way that it always makes a decision.

Example

338.

Hays Code ★

Clark Gable in a pin-striped suit and a pink thong.

RB 9.3 Clothing

🔗

WI §18.10 Printing the name of something

1. When it happens. Whenever the name of a thing or room is printed, either as part of text visible to the player, or sometimes internally in order to determine something about that name.

2. The default behaviour. For items other than the current player, the "printed name" property is printed out; but for the current player, "you" or "yourself" is printed. (That doesn't necessarily mean that the "printed name" of the player is never used. Suppose there are two people, Alice and Bob, and the narrative switches between them: when Alice is the player, she appears as "yourself" but Bob is "Bob"; but when Bob is the player, he is "yourself" and Alice is "Alice".)

3. Examples. (a) A pen which is described differently in inventories:

Rule for printing the name of the pen while taking inventory: say "useful pen".

"Taking inventory" is a condition which is true if that's the current action and not otherwise, so the effect is that the pen is called "a useful pen" only in inventory listings. "While looking" is a similarly useful one.

(b) Italicising the names of novels:

A novel is a kind of thing. Dr Zhivago and Persuasion are novels. Before printing the name of a novel, say "[italic type]". After printing the name of a novel, say "[roman type]".

After printing the name of the wrist watch while taking inventory: say " (time: [the time of day])".

(d) Merging containers with their contents:

Rule for printing the name of the bottle while not inserting or removing:

if the bottle contains sand, say "bottle of sand";

otherwise say "empty bottle";

omit contents in listing.

This example makes use of a special phrase:

omit contents in listing

This phrase changes the form of an inventory listing, room description, etc., so that it will simply list "a bottle of sand" or "an empty bottle", rather than "a bottle (in which is sand)" or "a bottle (which is empty)". It should be used only when the listing is imminent, and does not have permanent effect.

The clause about not inserting or removing is to prevent messages like "You put the sand in the bottle of sand.", where it's confusing to refer to the bottle as anything other than "the bottle".

Examples

339.

Shipping Trunk ★

A box of baking soda whose name changes to "completely ineffective baking soda" when it is in a container with something that smells funny.

RB 9.2 Bags, Bottles, Boxes and Safes

340.

Trachypachidae Maturin 1803 ★★

Bottles with removable stoppers: when the stopper is in the bottle, the bottle is functionally closed, but the stopper can also be removed and used elsewhere. Descriptions of the bottle reflect its state intelligently.

RB 9.2 Bags, Bottles, Boxes and Safes

341.

Chronic Hinting Syndrome ★★★★

Using name-printing rules to keep track of whether the player knows about objects, and also to highlight things he might want to follow up.

RB 7.11 Character Knowledge and Reasoning

🔗

WI §18.11 Printing the plural name of something

1. When it happens. Only when a group of identical items is present in the same place, and are being described jointly with text like "You can see five gold rings here." The activity happens after "five" and before "here." (See the activity "printing a number of something" if the whole phrase needs to be altered.)

2. The default behaviour. The plural name - in this case "gold rings" - is printed out.

3. Examples. (a) Suppose we want to emphasise how nice it is to have more than one gold ring:

Rule for printing the plural name of a gold ring: say "gleaming gold rings".

(b) If the number needs changing as well, it's necessary to use the "printing a number of something" activity instead.

Example

342.

Hudsucker Industries ★★

Letters which are described differently as a group, depending on whether the player has read none, some, or all of them, and on whether they are alike or unlike.

RB 9.2 Bags, Bottles, Boxes and Safes

🔗

WI §18.12 Printing a number of something

1. When it happens. Only when a group of identical items is present in the same place, and are being described jointly with text like "You can see five gold rings here." The activity prints the "five gold rings" part. The variable "listing group size" contains the number, which in this example would be 5, and is always at least 2.

2. The default behaviour. The number of items is printed, in words ("five") and then the "printing the plural name" activity is run ("gold rings").

3. Examples. (a) Using this activity is for perfectionists, because the normal behaviour is almost always fine. Still:

Rule for printing a number of blocks when the listing group size is 3: say "all three blocks".

(b) Or perhaps:

Rule for printing a number of ants: say "altogether [listing group size in words] ants".

(c) If the only part needing variation is the plural name, it's simpler and tidier to use the "printing the plural name of something" activity instead.

Example

343.

Prolegomena ★

Replacing precise numbers with "some" or other quantifiers when too many objects are clustered together for the player to count at a glance.

RB 2.1 Varying What Is Written

🔗

WI §18.13 Listing contents of something

1. When it happens. When taking inventory, the list is produced by the activity "listing contents of yourself"; when looking, a list of items which do not deserve their own paragraphs is produced by "listing contents of" the location.

And when it doesn't happen. (a) If the Storage Room contains a sideboard and an open shoe box, then "listing contents of the Storage Room" is used to produce the part of the room description mentioning sideboard and box. But if the box in turn contains a pair of brogues, then "listing contents of the shoe box" is not used to say that part. So this works:

Rule for printing the name of the brogues while listing contents of a room: ...

But this won't affect room descriptions:

Rule for printing the name of the brogues while listing contents of the shoe box: ...

(b) The activity also doesn't happen when, for instance, "[a list of animals]" is printed, because that isn't a list of the contents of any room or location.

2. The default behaviour. The list is printed out.

3. Examples. (a) We have already seen that it can be elegant to elaborate on a description in the context of a list. Here we add "discarded" to a sweet wrapper which is found on the ground.

Rule for printing the name of the wrapper while listing contents of a room: say "discarded sweet wrapper".

(b) Lists can be considerably shortened and tidied up if similar items are grouped together. We do this by specifying what should be grouped together before listing contents, using the special phrase "group … together":

Utensil is a kind of thing. The knife, the fork and the spoon are utensils. Before listing contents: group utensils together as "utensils".

The result will be, say, "two utensils (knife and spoon)", if both are found in the same place.

Before listing contents while taking inventory: group utensils together.

Three special phrases exist for this kind of list organisation:

group (description of objects) together

This phrase causes the objects described to be listed together in a single item as part of an inventory or room description. The effect is temporary, and the phrase should only be used when this list is imminent. Example:

Utensil is a kind of thing. The knife, the fork and the spoon are utensils. Before listing contents: group utensils together.

This might produce the list item "fork and spoon".

group (description of objects) together giving articles

This phrase causes the objects described to be listed together in a single item as part of an inventory or room description, but giving each individual item its indefinite article. The effect is temporary, and the phrase should only be used when this list is imminent. Example:

Utensil is a kind of thing. The knife, the fork and the spoon are utensils. Before listing contents: group utensils together giving articles.

This might produce the list item "a fork and a spoon".

group (description of objects) together as (text)

This phrase causes the objects described to be listed together in a single item as part of an inventory or room description, summarised with the given text. The effect is temporary, and the phrase should only be used when this list is imminent. Example:

Utensil is a kind of thing. The knife, the fork and the spoon are utensils. Before listing contents: group utensils together as "utensils".

This might produce the list item "two utensils (fork and spoon)".

Example

344.

Unpeeled ★

Calling an onion "a single yellow onion" when (and only when) it is being listed as the sole content of a room or container.

RB 9.2 Bags, Bottles, Boxes and Safes

🔗

WI §18.14 Grouping together something

1. When it happens. Only while listing contents, and only when a collection of items to be grouped together is reached. This in turn happens only if a "before listing contents" rule has chosen it (see previous section). The first item in the group is the one to which the activity formally applies.

The variable "listing group size" usually gives the number of items grouped together in this way, but care is needed if the "something" covers multiple groups, because then this will all be working on a list of groups, not of items. For example, in a "grouping together things" rule, where "things" is such a broad description that it can apply to multiple kinds of thing all appearing in the list, the list-maker is likely to set "listing group size" to the number of groups. If the list contains five men and six women, for example, "listing group size" might be 2 rather than 11.

2. The default behaviour. The items grouped together are printed in an English phrase, such as "egg, chicken and farmer". In particular, they are not split onto separate lines even if the rest of the list is. (See previous section.)

3. Examples. (a) Here are Scrabble pieces which are described as "the tile W from a Scrabble set" or similar outside of lists, but which, when they turn up together in lists, are rolled together into "the tiles A, B and D from a Scrabble set".

A Scrabble piece is a kind of thing. The X, the Y and the Z are Scrabble pieces.

Before listing contents: group Scrabble pieces together.

Before printing the name of a Scrabble piece while not grouping together, say "tile ". After printing the name of a Scrabble piece while not grouping together, say " from a Scrabble set".

Before grouping together Scrabble pieces, say "the tiles ". After grouping together Scrabble pieces, say " from a Scrabble set".

(b) Maybe we only want an abbreviated form when there are five or more tiles in one place:

A Scrabble piece is a kind of thing. The X, the W, the F, the Y and the Z are Scrabble pieces in the Lounge.

Before listing contents: group Scrabble pieces together.

Before grouping together Scrabble pieces when the listing group size is greater than 4:

say "some [listing group size in words] tiles (".

After grouping together Scrabble pieces when the listing group size is greater than 4:

say ") from a Scrabble set".

Before listing contents while taking inventory: group utensils together. Rule for grouping together utensils: say "the usual utensils".

🔗

WI §18.15 Issuing the response text of something

1. When it happens. When Inform prints a text marked with a response letter (A), (B), (C), …, in a rule making use of them. For example, in this rule:

Carry out taking inventory (this is the print empty inventory rule):
   if the first thing held by the player is nothing,
      say "[We] [are] carrying nothing." (A) instead.

Or, less directly,

let R be the print empty inventory rule response (A);
say "To be frank: [text of R].";

2. The default behaviour. To print the current textual value of the response, making any substitutions in the ordinary way.

3. Examples. This activity is not the best way to amend responses or make them dynamic; the whole idea of responses is that they can be changed just as if they were text variables. This activity should be used only if it's important to amend blocks of responses in some systematic way.

(a) With that said, some interesting effects can be achieved. This is a way to see which responses are being printed, for example:

Before issuing the response text of a response (called R): say "[R]: ".

whence:

>WAIT
standard report waiting rule response (A): Time passes.

(b) And this intercepts the activity in order to re-run it in each of the six viewpoints. (Note the way a variable is used to prevent the rule from applying to all of those re-runs as well.)

The response inhibition is initially false.
 
Rule for issuing the response text of a response (called R) when the response inhibition is false:
   now the response inhibition is true;
   let the current viewpoint be the story viewpoint;
   repeat with P running through narrative viewpoints:
      now the story viewpoint is P;
      say "[P]: [text of R][command clarification break]";
   now the story viewpoint is the current viewpoint;
   now the response inhibition is false.

With that in place,

>EAST
first person singular: I can't go that way.
second person singular: You can't go that way.
third person singular: He can't go that way.
first person plural: We can't go that way.
second person plural: You can't go that way.
third person plural: They can't go that way.

Example

345.

Wesponses ★

Parser messages that are delivered with a speech impediment.

RB 2.1 Varying What Is Written

🔗

WI §18.16 Printing room description details of something

1. When it happens. When an item is listed in the miscellaneous collection of items present in a room (the ones which do not deserve their own paragraphs): this is normally the last paragraph of a room description.

2. The default behaviour. A bracketed piece of extra information is added for certain items such as containers:

You can also see Po and a cage (empty) here.

The " (empty)" (note initial space) was added by this activity. (Note that this activity is not responsible for describing further items visible because of the item in question: that is, it does not print the text such as "(in which is a notepad)" which would appear if there were contents. If we want to remove such text, we should use "omit contents in listing": see the activity "for printing the name of something".)

3. Examples. (a) To get rid of such addenda entirely, try:

Rule for printing room description details: stop.

(b) To add a new form of addendum:

Rule for printing room description details of a person:
   say " (at last, someone to talk to)" instead.

If both examples (a) and (b) are in place at once, we might now read:

You can also see Po (at last, someone to talk to) and a cage here.

Example

346.

Rules of Attraction ★

A magnet which picks up nearby metal objects, and describes itself appropriately in room descriptions and inventory listings, but otherwise goes by its ordinary name.

RB 10.7 Electricity and Magnetism

🔗

WI §18.17 Printing inventory details of something

1. When it happens. When an item is listed in an inventory of items carried by the player.

2. The default behaviour. A bracketed piece of extra information is added for certain items such as containers:

a flaming branch (providing light)

The " (providing light)" (note initial space) was added by this activity.

3. Examples. (a) To get rid of such addenda entirely, try:

Rule for printing inventory details: stop.

(b) To add a new form of addendum:

Rule for printing inventory details of something edible:
   say " (yummy!)[run paragraph on]".

🔗

WI §18.18 Printing a refusal to act in the dark

1. When it happens. When an action which requires light is tried, and the visibility rules decide that not enough light is present.

2. The default behaviour. To print "It is pitch dark, and you can't see a thing."

3. Examples. (a) This might do for some twilit, penumbral room:

Rule for printing a refusal to act in the dark: if we are examining something, say "It's not totally dark here, perhaps, but certainly too dim for close-up examination of anything." instead.

Example

347.

Zorn of Zorna ★★★

Light levels vary depending on the number of candles the player has lit, and this determines whether or not he is able to examine detailed objects successfully.

RB 3.7 Lighting

🔗

WI §18.19 Printing the announcement of darkness

1. When it happens. Inform frequently calculates to see if the player is in light or darkness: this activity happens on the change from light to darkness.

2. The default behaviour. To print "It is now pitch dark in here!".

3. Examples. (a) The most obvious use is to change the text:

Rule for printing the announcement of darkness: say "Ooh-er! It's now very nearly pitch dark in here." instead.

(b) But we could also use this activity for sneakier purposes, silently moving things around:

Before printing the announcement of darkness: now all of the gremlins are in the kitchen.

(c) A special description for occasions when the player has climbed into a container and shut it (so that the darkness is the result of his own actions, rather than some external circumstance):

Rule for printing the announcement of darkness when closing a container which contains the player:
   say "Congratulations: now you can't see a thing." instead.

🔗

WI §18.20 Printing the announcement of light

1. When it happens. Inform frequently calculates to see if the player is in light or darkness: this activity happens on the change from darkness to light.

2. The default behaviour. To try the looking action, which usually prints up a room description.

3. Examples. (a) Perhaps the player is initially too disoriented to look around in any coherent way:

Rule for printing the announcement of light in the Dazzling Temple: say "You are almost blinded by the suffusion of white light, and have spots before your eyes." instead.

🔗

WI §18.21 Printing the name of a dark room

1. When it happens. When looking in darkness, or writing the (default) status line in darkness.

2. The default behaviour. To print "Darkness".

3. Examples. (a) One might modify the darkness with some adjective:

Before printing the name of a dark room, say "Near ".

(Note that this activity does not come in different forms for different dark rooms: the wording is fixed at "printing the name of a dark room", and we are not allowed to substitute particular dark rooms or assign a "(called …)" onto the mention of the dark room.)

🔗

WI §18.22 Printing the description of a dark room

1. When it happens. When looking in darkness.

2. The default behaviour. To print "It is pitch dark, and you can't see a thing."

3. Examples. (a) A simple variation of wording:

Rule for printing the description of a dark room: say "Your eyes can barely make anything out." instead.

(b) More stylishly,

Rule for printing the description of a dark room: try listening instead.

which produces, for instance,

Darkness
You hear nothing unexpected.

(Note that this activity does not come in different forms for different dark rooms: the wording is fixed at "printing the description of a dark room", and we are not allowed to substitute particular dark rooms or assign a "(called …)" onto the mention of the dark room.)

Examples

348.

Hohmann Transfer ★★

Changing the way dark rooms are described to avoid the standard Inform phrasing.

RB 3.7 Lighting

349.

Four Stars 1 ★★★

An elaboration of the idea that when light is absent, the player should be given a description of what he can smell and hear, instead.

RB 3.7 Lighting

🔗

WI §18.23 Constructing the status line

1. When it happens. Just before input is accepted from the keyboard, Inform constructs a "status line" at the top of the window which is normally displayed in reverse colours (white on black instead of black on white, say).

2. The default behaviour. Makes the status line up out of two pieces, the "left hand status line" and the "right hand status line". Since these can freely be changed, note that the status line is already very customisable without using rules applied to this activity.

3. Examples. (a) The most useful thing about this activity is that it allows us to vary descriptions in the status line. This is especially helpful to abbreviate unduly long room names, which might not otherwise fit:

The Temple Of A Thousand Mightily Peeved Deities is a room. Rule for printing the name of the Temple while constructing the status line: say "Temple".

(b) Again, it's usually not necessary to apply activity rules to this, but occasionally amusing effects are possible if we do:

The blindfold is wearable and carried. Rule for constructing the status line while the blindfold is worn: do nothing.

Examples

350.

Ways Out ★

A status line that lists the available exits from the current location.

RB 12.2 The Status Line

351.

Guided Tour ★★

A status line that lists the available exits from the current location, changing the names of these exits depending on whether the room has been visited or not.

RB 12.2 The Status Line

🔗

WI §18.24 Writing a paragraph about

1. When it happens. Just before writing a paragraph about some item in a room description.

2. The default behaviour. Is to do nothing. However, if a rule is supplied which prints something up, then this replaces the paragraph which would otherwise have been printed. Moreover, any items whose names are said in the course of this rule - for instance, by being listed - are then excluded from the remainder of the room description, because they are considered as having been described sufficiently already.

Warning: because we often want a "for" rule for this activity to make some calculation and then possibly choose to do nothing (see the example "Otranto"), Inform suppresses the usual paragraph not when a "for" rule took effect but when it detected a paragraph having been printed. This can get confused if a text substitution affecting paragraph breaks, say "[line break]", is within the final "say" of a "for writing a paragraph about" rule.

3. Examples. (a) This is a neat way to wrap several things together into the same paragraph:

Rule for writing a paragraph about Mr Wickham:

say "Mr Wickham looks speculatively at [list of women in the location]."

because now "Mr Wickham looks speculatively at Velma and Daphne" will now prevent the appearance of the subsequent text "You can also see Velma and Daphne."

Inform keeps track of which objects have already been named with an either/or property called "mentioned", which it assigns whenever the name of an object has been automatically printed. So in this case, Velma and Daphne are now mentioned. Note "automatically printed", though: if the text printed had just been "Mr Wickham looks speculatively at Velma and Daphne", rather than the text-substitution list used above, then Inform would not know that Velma and Daphne have been described.

If we ever need to override this - say, we want to list all the women but make sure that Velma gets another paragraph anyway - we could change Velma to unmentioned again after the listing.

Examples

352.

Reflections ★

Emphasizing the reflective quality of shiny objects whenever they are described in the presence of the torch.

RB 3.7 Lighting

353.

Emma ★★

Social dynamics in which groups of people form and circulate during a party.

RB 7.16 Social Groups

354.

Air Conditioning is Standard ★★★★

Uses "writing a paragraph about" to make person and object descriptions that vary considerably depending on what else is going on in the room, including some randomized NPC interactions with objects or with each other.

RB 4.3 Event Scheduling

🔗

WI §18.25 Listing nondescript items of something

1. When it happens. This activity prints up the also-ran paragraph at the end of a room description. These are nondescript items because they don't merit paragraphs of their own: if, as sometimes happens, there are none in the room, then no such paragraph is printed and this activity does not happen. (So to add a further paragraph to a room description, a simpler "after looking" rule should be used, not an "after listing nondescript items" rule.)

2. The default behaviour. The paragraph ordinarily reads as "You can also see a cask and a clock." or similar. Before the activity begins, those objects which are nondescript - in this case the cask and the clock - are given the property of being "marked for listing".

If it turns out that nothing is marked for listing, because of before rules like the one in the example below, then nothing is printed and the activity is abandoned, so that the rules for and after are never reached.

3. Examples. (a) Promoting something out of the nondescript category, by unmarking it.

Before listing nondescript items:

if the watch is marked for listing:

say "The watch catches your eye.";

now the watch is not marked for listing.

(b) Changing the normal phrasing of the paragraph. Note that we can also change the listing style; the one below is the default.

Rule for listing nondescript items of the Distressingly Messy Room:

say "Strewn carelessly on the floor";

list the contents of the Distressingly Messy Room, as a sentence,

tersely, listing marked items only, prefacing with is/are,

including contents and giving brief inventory information;

say "."

Examples

355.

Rip Van Winkle ★

A simple way to allow objects in certain places to be described in the room description body text rather than in paragraphs following the room description.

RB 3.1 Room Descriptions

356.

Happy Hour ★★

Listing visible characters as a group, then giving some followup details in the same paragraph about specific ones.

RB 7.16 Social Groups

357.

The Eye of the Idol ★★

A systematic way to allow objects in certain places to be described in the room description body text rather than in paragraphs following the room description, and to control whether supporters list their contents or not.

RB 3.1 Room Descriptions

🔗

WI §18.26 Printing the locale description of something

1. When it happens. A "locale description" is Inform jargon for the part of a room description which catalogues the visible items in the room. When looking, Inform will normally print the description of the room itself, followed by a locale description for the room. But if the player is in a cage in the room, there will be two locale descriptions: one for the room, then another for the cage. This activity is used to write the locale description for a single domain, and the "something" can be either a room, an enterable container, or an enterable supporter.

2. The default behaviour. Is quite complicated, and is written up in full in the typeset form of the Standard Rules downloadable from the Inform website. Briefly, though: we first run the "choosing notable locale objects" activity to find out what ought to be mentioned here. That assembles a list of things to mention, sorted into priority order. Items with priority 1 go first, then those with priority 2, and so on. The "printing a locale paragraph" activity is run for each, and in practice that usually hands the job over to "writing a paragraph about". Sometimes a paragraph will indeed be written, but not always. Sometimes there is nothing interesting to say, and an item is left until a final, single paragraph which gathers up the leftovers ("You can also see a scarlet fish, a harmonium and a kite here."), the printing of which is done by the "listing nondescript items of" activity. As soon as any item picks up the either/or property "mentioned", by having its name printed, it is struck out so that it will not appear subsequently, whatever its priority.

3. Examples. As general advice: if the effect wanted can be got using "writing a paragraph about" and "listing nondescript items of" alone, use those; if it's necessary to meddle further, use "choosing notable locale objects" and "printing a locale paragraph" to alter the normal processes; use the all-powerful "printing the locale description" activity only when the whole process needs to be altered, not the item-by-item workings.

(a) In the Very Misty Moorlands, nothing on the ground can ordinarily be seen through the swirling mist, so the locale description is suppressed entirely:

Rule for printing the locale description of the Very Misty Moorlands:

say "Mist coils around your feet, thick as a blanket. You cannot even see the ground you walk upon." instead.

Report taking something in the Very Misty Moorlands:

say "You grope blindly in the mist and pick up [the noun]." instead.

(b) Here we take the chance to insert an additional paragraph into the locale description. This does relate to an item which might be described later, but where the player doesn't know that:

The Horological Workshop is a room. The marble table is fixed in place in the Workshop.

The parcel is a closed opaque container on the marble table. The alarm clock is a device in the parcel. The alarm clock is switched on.

Before printing the locale description of a room (called the locale):

if the locale encloses the alarm clock and the alarm clock is switched on, say "A faint ticking noise can be heard."

Example

358.

Priority Lab ★

A debugging rule useful for checking the priorities of objects about to be listed.

RB 3.1 Room Descriptions

🔗

WI §18.27 Choosing notable locale objects for something

1. When it happens. See "printing the locale description". This activity is expected to decide which items ought to be mentioned in a locale description for a given room, enterable container or enterable supporter, and to give each item a priority, which is a number ranging upwards from 1 (which is the top priority). The lower the priority number, the earlier the mention, or at least, the earlier the opportunity to be mentioned: it's up to other activities whether to give it a paragraph of its own or not. This activity only makes something a candidate, and decides what order the candidates will be tried in.

2. The default behaviour. By default, this activity contains only the "standard notable locale objects rule". This chooses exactly those items directly contained by the locale, assigning all of them priority 5. Note that this includes scenery, and other probably unwanted items - those will be excluded later.

3. Examples. (a) In the Misty Moorlands, only large items on the ground are visible through the mist:

A thing can be large or small. A thing is usually small. The stepladder is a large thing in the Misty Moorlands.

Rule for choosing notable locale objects for the Misty Moorlands:

repeat with item running through large things in the Misty Moorlands:

set the locale priority of the item to 5.

Report taking a small thing in the Misty Moorlands:

say "You grope blindly in the mist and pick up [the noun]." instead.

Note the special phrase

set the locale priority of the item to 5;

which should be used only in rules for locale activities. It makes the given item a candidate and sets its priority. (Setting the priority to 0 forces an item not to be a candidate, and can thus undo the effect of previous rules.)

It's best to avoid situations where an item has a locale priority which is higher than that of something it is on top of, or inside, since this can result in an oddly-worded description.

Examples

359.

Low Light ★

An object that is only visible and manipulable when a bright light fixture is on.

RB 3.1 Room Descriptions

360.

Casino Banale ★★★

Creating room descriptions and object descriptions that change as the player learns new facts and pieces things together.

RB 5.5 Memory and Knowledge

🔗

WI §18.28 Printing a locale paragraph about

1. When it happens. See "printing the locale description". By this point, the locale description process has identified a number of items as candidates to be described, and worked out a priority order. This activity is then called for each candidate in turn, starting with the highest priority items and working downwards. It can either print some text or not, and can either mark the item as "mentioned" or not: if it does, then the item won't appear subsequently in the locale description. If the activity does nothing, the item becomes "nondescript" and falls through into the final "You can also see…" paragraph, unless another rule mentions it in the mean time.

2. The default behaviour. Is provided by a sequence of seven rules:

(1) The "don't mention player's supporter in room descriptions rule" excludes anything the player is directly or indirectly standing on or, less frequently, in. The header of the room description has probably already said something like "Boudoir (on the four-poster bed)", so the player can't be unaware of this item.
 
(2) The "don't mention scenery in room descriptions rule" excludes scenery.
 
(3) The "don't mention undescribed items in room descriptions rule" excludes the player object. (It's redundant to say "You can also see yourself here.") At present nothing else in i7 is "undescribed" in this sense.
 
(4) The "set pronouns from items in room descriptions rule" adjusts the meaning of pronouns like IT and HER to pick up items mentioned. Thus if a room description ends "Mme Tourmalet glares at you.", then HER would be adjusted to mean Mme Tourmalet.
 
(5) The "offer items to writing a paragraph about rule" gives the "writing a paragraph about" activity a chance to intervene. We detect whether it does intervene or not by looking to see if it has printed any text.
 
(6) The "use initial appearance in room descriptions rule" prints the "initial appearance" property of an item which has never been handled as a paragraph, if it has one.
 
(7) The "describe what's on scenery supporters in room descriptions rule" is somewhat controversial. It prints text such as "On the mantelpiece is a piece of chalk." for items which, like the mantelpiece, are scenery mentioned - we assume - in the main room description. (It is assumed that scenery supporters make their contents more prominently visible than scenery containers, which we do not announce the contents of.)

3. Examples. If all that's required is to supply an interesting paragraph of room description about something then it's always better to use the "writing a paragraph about" activity, not this one. This activity should only be used when the mechanism itself needs to be adjusted.

(a) The following excludes doors from room descriptions:

For printing a locale paragraph about a door (called the item)

(this is the don't mention doors in room descriptions rule):

set the locale priority of the item to 0;

continue the activity.

(It's usually a good idea to "continue the activity" at the end of rules for this activity, since usually they all need to take effect for a happy outcome to the process. Here it doesn't really matter, since we were trying to stop anything from happening about the door, but it doesn't do any harm either.)

(b) Here's how to abolish what may be the most contentious rule in the whole Standard Rules:

The describe what's on scenery supporters in room descriptions rule is not listed in any rulebook.

Examples

361.

Kiwi ★

Creating a raised supporter kind whose contents the player can't see or take from the ground.

RB 8.4 Furniture

362.

Copper River ★★★

Manipulating room descriptions so that only interesting items are mentioned, while objects that are present but not currently useful to the player are ignored.

RB 3.1 Room Descriptions

🔗

WI §18.29 Deciding the scope of something

1. When it happens. "Scope" is a term of art in interactive fiction programming: it means the collection of things which can be interacted with at any given moment, which depends on who you are and where you are. Commands typed by the player will only be allowed to go forward into actions if the things they refer to are "in scope". Inform also needs to determine scope at other times, too: for instance, when deciding whether a rule conditional on being "in the presence of" something is valid. It is a bad idea to say anything during this activity.

2. The default behaviour. Is complicated: see the Inform Designer's Manual, 4th edition, page 227. Briefly, the scope for someone consists of everything in the same place as them, unless it is dark.

3. Examples. (a) We very rarely want to forbid the player to refer to things close at hand, but often want to allow references to distant ones. For instance, a mirage of something which is not present at all:

After deciding the scope of the player while the location is the Shrine:
   place the holy grail in scope.

Two different phrases enable us to place unusual items in scope:

place (object) in scope

This phrase should only be used in rules for the "deciding the scope of…" activity. It places the given object in scope, making it accessible to the player's commands, regardless of where it is in the model world. Examples:

place the distant volcano in scope;
place the lacquered box in scope, but not its contents;

Ordinarily if something is placed in scope, then so are its parts and (in the case of a supporter or a transparent or open container) its contents; using the "but not its contents" option we can place just the box itself in scope.

place the/-- contents of (object) in scope

This phrase should only be used in rules for the "deciding the scope of…" activity. It places the things inside or on top of the given object in scope, making them accessible to the player's commands, but it does nothing to place the object itself in scope. (It might of course be in scope anyway, and if it is then this phrase won't remove it.) Example:

place the contents of the lacquered box in scope;
place the contents of the Marbled Steps in scope;

Note that the object in question can be a room, as in this second example.

(b) Another useful device is to be able to see, but not touch, another room:

The Cloakroom is a room. "This is just a cloakroom, but through a vague, misty mirror-window you can make out the Beyond." After looking in the Cloakroom, say "In the mirror you can see [list of things in the Beyond]."

After deciding the scope of the player while the location is the Cloakroom: place the Beyond in scope.

The Beyond is a room. Johnny Depp is a man in the Beyond.

(This must, however, also be a mirage, as at time of writing Mr Depp is alive and as well as can be expected following the reviews of "Charlie and the Chocolate Factory".) Note that "place the Ballroom in scope" doesn't just allow the player to talk about the dancers, the chamber musicians and so forth, also allows, say, "EXAMINE BALLROOM". To get one but not the other, use "place the contents of the Ballroom in scope" or "place the Ballroom in scope, but not its contents".

(c) In darkness, the scope of someone is ordinarily restricted to his or her possessions (and body), but we can override that:

After deciding the scope of the player while in darkness: place the location in scope.

4. A note about actions. This activity takes place during the process of understanding the player's command, when the action that will take place is not fully known. So if the player types "TAKE SHOEBOX", this activity would happen when SHOEBOX is being examined for meaning. Inform knows the action it would be taking if the current line of command grammar were to be accepted, but it does not yet know to what objects that command would be applied. That means attaching a proviso like "… while taking a container" to a rule for this activity will cause the rule to have no effect - whereas "… while taking" would be fine.

Examples

363.

Peeled ★

Two different approaches to adjusting what the player can interact with, compared.

RB 3.7 Lighting

364.

Four Stars 2 ★

Using "deciding the scope" to change the content of lists such as "the list of audible things which can be touched by the player".

RB 3.8 Sounds

365.

Ginger Beer ★★

A portable magic telescope which allows the player to view items in another room of his choice.

RB 9.11 Clocks and Scientific Instruments

366.

Rock Garden ★★

A simple open landscape where the player can see between rooms and will automatically move to touch things in distant rooms.

RB 3.4 Continuous Spaces and The Outdoors

367.

Stately Gardens ★★★

An open landscape where the player can see landmarks in nearby areas, with somewhat more complex room descriptions than the previous example, and in which we also account for size differences between things seen at a distance.

RB 3.4 Continuous Spaces and The Outdoors

🔗

WI §18.30 Clarifying the parser's choice of something

1. When it happens. When the player has typed an ambiguous noun reference, and Inform has made a decision about what was meant, and it matters what this decision is. (If the decision is between three identical gold coins, say, then it doesn't matter, and this activity does not take place.) There are a couple of limitations on this: the activity applies only to the first noun, and only if it's an object. So for a command like SELECT BLUE, where BLUE is a noun referring to a colour value, say, this activity isn't used. But the simple case where the activity does play a part is nevertheless very useful.

2. The default behaviour. Text in brackets such as "(the laminated mahogany box)" is printed, on its own line.

3. Examples. (a) In the following, asking to TAKE TOWER results in the parser choosing the souvenir model (because of the "does the player mean…" rule making the alternative unlikely), and then explaining itself by saying "(The little one, obviously.)" instead of "(the souvenir model Eiffel Tower)".

The Champs du Mars is a room. The great Eiffel Tower is here. "The great Tower stands high over you." The souvenir model Eiffel Tower is here. "Comparatively tiny is the souvenir version." The great Eiffel Tower is fixed in place. Does the player mean taking the great Eiffel Tower: it is very unlikely.
 
Rule for clarifying the parser's choice of the model tower: say "(The little one, obviously.)"

4. A note about actions. This activity takes place during the process of understanding the player's command, when the action that will take place is not fully known. So if the player types "TAKE SHOEBOX", this activity would happen when SHOEBOX is being examined for meaning. Inform knows that the action will be taking, but nothing else. That means attaching a proviso like "… while taking a container" to a rule for this activity will cause the rule to have no effect - whereas "… while taking" would be fine.

🔗

WI §18.31 Asking which do you mean

1. When it happens. When the player has typed an ambiguous noun reference, and Inform has not been able to decide what was meant.

2. The default behaviour. A question such as "Which do you mean, the laminated mahogany box or the boom box?" is printed. (This activity shapes the question: it is not responsible for parsing the answer. It would be very mysterious to write rules for this activity such that nothing is printed, because the player would then have no idea what to type.)

3. Examples. The question is harder to print than may first appear, since one must not simply list the options, but also take into account collections of plural objects ("Which do you mean, the gold-tipped pen or a gold coin?"). It is probably better not to try to rewrite this.

(a) But we can place notes before or after: here is a verbose explanation for beginners to IF.

Before asking which do you mean: say "Okay, so I'm going to have to ask a question now: you've typed something ambiguous, and I don't know which noun you're referring to."
 
After asking which do you mean: say "(Just type a word or two to give me more information.)"

(b) We can also use this activity as a context for other activities. For instance:

The Champs du Mars is a room. The great Eiffel Tower is here. "The great Tower stands high over you." The souvenir model Eiffel Tower is here. "Comparatively tiny is the souvenir version." The great Eiffel Tower is fixed in place. Understand "actual" as the great Tower.
 
Rule for printing the name of the great Tower while asking which do you mean: say "actual Tower". Rule for printing the name of the souvenir tower while asking which do you mean: say "souvenir".

causes TAKE TOWER (for instance) to produce a nice tidy question in reply: "Which do you mean, the actual Tower or the souvenir?"

4. A note about actions. This activity takes place during the process of understanding the player's command, when the action that will take place is not fully known. So if the player types "TAKE SHOEBOX", this activity would happen when SHOEBOX is being examined for meaning. Inform knows that the action will be taking, but nothing else. That means attaching a proviso like "… while taking a container" to a rule for this activity will cause the rule to have no effect - whereas "… while taking" would be fine.

Examples

368.

Apples ★

Prompting the player on how to disambiguate otherwise similar objects.

RB 6.17 Clarification and Correction

369.

Originals ★

Allowing the player to create models of anything in the game world; parsing the name "model [thing]" or even just "[thing]" to refer to these newly-created models; asking "which do you mean, the model [thing] or the actual [thing]" when there is ambiguity.

RB 9.12 Cameras and Recording Devices

370.

Walls and Noses ★★★

Responding to "EXAMINE WALL" with "In which direction?", and to "EXAMINE NOSE" with "Whose nose do you mean, Frederica's, Betty's, Wilma's or your own?"

RB 6.17 Clarification and Correction

🔗

WI §18.32 Supplying a missing noun/second noun

1. When it happens. (Two different activities here, but identical except for applying to different nouns.) This happens when an Understand sentence fails to supply a noun for an action which requires one. For example, in the sentence 'Understand "seize" as taking.' - the "taking" action is incompletely specified, because it requires a noun, and there's no noun in the command to be understood.

Note that this is not what happens if it's the player who fails to supply the noun. That is, suppose the player types a half-finished command like TAKE, which can't be matched against (for example) 'Understand "take [things]" as taking.' because the player didn't name any thing(s). Typically a story will reply to such a command with a question asking for clarification, but sometimes it makes guesses about what was meant. The "supplying a missing noun" activity plays no part in this guesswork, and can't influence it: that's the task of the "does the player mean" rulebook.

Suppose we do have the first of these cases, then. "Supplying a missing noun" takes place to remedy the problem. It can either:

(i) Set a noun, printing text like "(presumably the black bag)" if it wants, in which case the action goes forward, though it is still subject to the full rules on accessibility exactly as any other action would be; or

(ii) Make no choice, in which case no action takes place and the player's command is rejected. If the activity printed nothing, Inform will produce a generic reply to the player that "You must supply a noun.".

2. The default behaviour. In the default grammar for Inform, only three such half-finished actions are ever Understood. One is "going" with no direction, for which this activity simply prints a refusal. The other two are the two undirected senses, "smelling" and "listening". In each case, the "supplying a missing noun" activity sets the noun to the current location: so, for instance, typing the bare command "listen" might generate the action "listening to the Shoreline".

3. Examples. (a) This is the definition Inform uses to make "listen" work as outlined above:

Rule for supplying a missing noun while listening (this is the ambient sound rule):
   now the noun is the location.

(b) It can be elegant to allow second nouns to be dropped with habitual actions, or where the choice is obvious:

Understand "unlock [something]" as unlocking it with.

Rule for supplying a missing second noun while unlocking:

if the skeleton key is carried, now the second noun is the skeleton key;

otherwise say "You will have to specify what to unlock [the noun] with."

Note that, in order for our activity to succeed, we do need to supply a grammar line allowing the player to try "unlocking it with" using only one noun. Otherwise, the command "unlock something" will still produce the question "What do you want to unlock the door with?"

Examples

371.

Latin Lessons ★

Supplying missing nouns and second nouns for other characters besides the player.

RB 7.14 Obedient Characters

372.

Minimal Movement ★

Supplying a default direction for "go", so that "leave", "go", etc., are always interpreted as "out".

RB 6.9 Going, Pushing Things in Directions

🔗

WI §18.33 Reading a command

1. When it happens. When reading a command from the keyboard.

2. The default behaviour. Print the prompt text; wait for the player to type something and press return. Reject an entirely blank line, and treat a command beginning "oops" as a correction to the previous one. This is a fairly complicated business, so it is probably best not to change the "for" rules for this activity: "before", and especially "after", are another matter. (Note, however, that if Inform does reject a blank line and ask for another then this all happens inside the "for" rules: no "after" occurs after the blank line, nor does a "before" happen before the second attempt by the player. It is all a single round of the activity, not two.)

3. Examples. (a) To lead absolute beginners in gently:

Before reading a command while the turn count is 1, say "(This is your chance to say what the protagonist should do next. After the '>', try typing 'take inventory'.)"

(b) The following responds politely but firmly if the player tries to type "please look", say, instead of just "look":

After reading a command:

if the player's command includes "please":

say "Please do not say please.";

reject the player's command.

To explain. Fragments of what the player has typed are called snippets: "the player's command" is the entire thing. We can test if a snippet matches a given pattern like so:

if (snippet) matches (topic):

This condition is true if the given snippet exactly matches the specification. Example:

if the player's command matches "room [number]", ...

will be true if the command is ROOM 101, but not if it's EXPLORE ROOM 7.

if (snippet) does not match (topic):

This condition is true if the given snippet does not exactly match the specification.

if (snippet) includes (topic):

This condition is true if the given snippet includes words matching the specification, either at the beginning, in the middle, or at the end. Example:

if the player's command includes "room [number]", ...

will be true if the command is ROOM 101, EXPLORE ROOM 7, or ROOM 22 AHOY, but not if it's VISIT ROOM GAMMA 7.

if (snippet) does not include (topic):

This condition is true if the given snippet does not include any run of words which matches the specification.

Lastly, we took drastic action with another new phrase:

reject the player's command

This phrase should be used only in rules for the "reading a command" activity. It tells Inform not to bother analysing the text further, but to go back to the keyboard. (No time passes; no turn elapses; nothing happens in the simulated world.)

(c) An improved version takes commands like "please drop the coin" and strips "please" from them, but then allows them to proceed normally:

After reading a command:

if the player's command includes "please":

say "(Quelle politesse! But no need to say please.)";

cut the matched text.

"Matched text" is a snippet containing the words which matched against the pattern in the most recent "includes" condition, so in this case it contains just the single word "please". Two phrases allow snippets to be altered:

replace (snippet) with (text)

This phrase should be used only in "after" rules for the "reading a command" activity; it replaces the snippet of command, usually the "matched text" found immediately before, with the given text. Example:

if the player's command includes "room [number]":
   replace the matched text with "office".

cut (snippet)

This phrase should be used only in "after" rules for the "reading a command" activity; it removes the snippet of command. Example:

if the player's command includes "or else":
   cut the matched text.

Note that "replace" and "cut" can only be used in "after reading a command" rules: not when an action has been chosen and has gone ahead into its rulebooks. Once the "reading a command" activity has finished, the command is final.

(d) To make the word "grab" an abbreviation for "take all":

After reading a command:

if the player's command matches "grab", replace the player's command with "take all".

("Snippet" is actually a kind of value, so we could say "Ah, you typed '[the player's command]'!" or some such if we liked. But in practice only three snippets are likely to be useful: the two mentioned above, "player's command" and "matched text", and the "topic understood", used when matching the "[text]" token in command grammar.)

(e) Finally, we can make still more detailed alterations to the text of the command using the techniques presented in the Advanced Text chapter. For instance:

change the text of the player's command to (text)

This phrase should be used only in "after" rules for the "reading a command" activity; it replaces the current command text entirely. Example:

After reading a command:
   let T be "[the player's command]";
   replace the regular expression "\p" in T with "";
   change the text of the player's command to T.

This converts the player's command to text, which is then manipulated by searching for any punctuation mark and replacing it with blank text (that is, deleted), and then put back again as the new command.

Examples

373.

Cloves ★★

Accepting adverbs anywhere in a command, registering what the player typed but then cutting them out before interpreting the command.

RB 6.18 Alternatives To Standard Parsing

374.

Fragment of a Greek Tragedy ★★

Responding to the player's input based on keywords only, and overriding the original parser entirely.

RB 6.18 Alternatives To Standard Parsing

375.

North by Northwest ★★

Creating additional compass directions between those that already exist (for instance, NNW) -- and dealing with an awkwardness that arises when the player tries to type "north-northwest". The example demonstrates a way around the nine-character limit on parsed words.

RB 2.2 Varying What Is Read

376.

Complimentary Peanuts ★★★

A character who responds to keywords in the player's instructions and remarks, even if there are other words included.

RB 7.8 Saying Complicated Things

🔗

WI §18.34 Implicitly taking something

1. When it happens. When an action is tried which requires the actor (normally the player, of course) to be carrying something, but which is not in fact carried by that person. For instance, if the player types WEAR OVERCOAT in reference to a Moroccan overcoat currently draped over a chair.

2. The default behaviour. To print text such as "(first taking the Moroccan overcoat)" and then silently try taking the object in question (the overcoat). If the take succeeds, the silence means that nothing else is printed: if it fails, it will say why.

No matter what rules are written for this activity, it is impossible to use it to allow the action to go ahead even without the item. The activity allows us to change how, or if, an implicit take will happen, but not to change the consequences of failure. (To do that, we would need to say that "The carrying requirements rule does nothing", but this kind of unstitching of the action machinery needs to be done with caution.)

3. Examples. (a) Forbidding implicit takes for certain dangerous items. (This seems especially fair if taking such items might cause death: the player will not wish to be killed on the strength only of our guess as to what he might be intending to do.)

Rule for implicitly taking the curare:
   say "Ordinarily you'd pick up the curare in order to be able to do that, but this seems like a good moment for caution." instead.

(b) Changing the way the implicit action is reported for the player:

Rule for implicitly taking something (called target):
   try silently taking the target;
   if the player carries the target, say "You appropriate [the target] first, of course. [run paragraph on]"

Rule for implicitly taking the noun when the second noun is a thing and the second noun is not carried by the player:
   try silently taking the noun;
   try silently taking the second noun;
   say "(first taking both [the noun] and [the second noun])[line break]"

(d) Making another character reply amusingly:

Rule for implicitly taking something which is carried by the player when the person asked is Clark:
   say "'I don't see how I'm supposed to do that when you're holding [the noun],' remarks Clark sulkily." instead.

(e) Causing implicit takes which wouldn't otherwise happen. Suppose we have a photographing action, and there are very small flowers which can't conveniently be snapped without being first picked. We then want an implicit take to occur, even though we wouldn't want this for other sorts of photography. So:

Check an actor photographing a flower:
   if the actor is not carrying the noun:
      carry out the implicitly taking activity with the noun;
      if the actor is not carrying the noun, stop the action.

Note that if the activity doesn't succeed in taking the item, it's expected to print some text explaining this, which is why we don't need to say anything further.

Examples

377.

The Big Sainsbury's ★

Making implicit takes add a minute to the clock, just as though the player had typed TAKE THING explicitly.

RB 4.1 The Passage Of Time

378.

Pizza Prince ★

Providing a pizza buffet from which the player can take as many pieces as he wants.

RB 10.3 Dispensers and Supplies of Small Objects

379.

Lollipop Guild ★★★

Overriding the rules to allow the player to show something to another character without first taking it.

RB 6.8 Taking, Dropping, Inserting and Putting

🔗

WI §18.35 Printing a parser error

1. When it happens. The parser is the part of the run-time software, included in all works produced by Inform, which tries to match the player's command against the grammar provided by the work. When it is unable to make a valid match, the parser prints an error to the player: for instance,

> BIFURCATE TREE
That's not a verb I recognise.

There are more than twenty possible messages. The one which the parser wants to say is stored in the variable "latest parser error", which has the convenient kind "command parser error". This has the following possible values:

didn't understand error
only understood as far as error
didn't understand that number error
can't see any such thing error
said too little error
aren't holding that error
can't use multiple objects error
can only use multiple objects error
not sure what it refers to error
excepted something not included error
can only do that to something animate error
not a verb I recognise error
not something you need to refer to error
can't see it at the moment error
didn't understand the way that finished error
not enough of those available error
nothing to do error
referred to a determination of scope error
I beg your pardon error
noun did not make sense in that context error
can't again the addressee error
comma can't begin error
can't see whom to talk to error
can't talk to inanimate things error
didn't understand addressee's last name error

2. The default behaviour. Prints the message in question.

3. Examples. (a) Perhaps for newcomers:

After printing a parser error:

say "If you are new to interactive fiction, you may like to try typing HELP."

(b) Or to give the parser a certain amount of character:

Rule for printing a parser error when the latest parser error is the I beg your pardon error:

say "What's that? Speak up, speak up." instead.

Rule for printing a parser error:

say "That's a rum thing to say, and no mistake." instead.

Rule for printing a parser error:

say "The [latest parser error] happened.";

continue the activity.

Examples

380.

WXPQ ★

Creating a more sensible parser error than "that noun did not make sense in this context".

RB 6.17 Clarification and Correction

381.

Xot ★★★

Storing an invalid command to be repeated as text later in the game.

RB 2.3 Using the Player's Input

🔗

WI §18.36 Deciding whether all includes

1. When it happens. When parsing a command such as "take all", where the player uses "all" to signify everything within reach.

2. The default behaviour. The actual method used is complicated, as "all" is not as simple as it seems - "take all" would not include the player's own body, for instance, or the crescent moon. The point of this activity is to allow the normal method to be changed for given objects, or given kinds of object.

3. Examples. (a) Removing scenery from "all" (but see (4) below):

Rule for deciding whether all includes scenery: it does not.

The phrases "it does" and "it does not" make a decision.

(b) Ensuring that a given thing, which might otherwise be excluded, is included:

Rule for deciding whether all includes the oval roof: it does.

4. The Standard Rules already uses this. Note that the Standard Rules already stocks this activity with several rules:

exclude scenery from take all rule
exclude people from take all rule
exclude fixed in place things from take all rule

5. A note about actions. This activity takes place during the process of understanding the player's command, when the action that will take place is not fully known. So if the player types "TAKE SHOEBOX", this activity would happen when SHOEBOX is being examined for meaning. Inform knows that the action will be taking, but nothing else. That means attaching a proviso like "… while taking a container" to a rule for this activity will cause the rule to have no effect - whereas "… while taking" would be fine.

🔗

WI §18.37 Printing the banner text

1. When it happens. The banner is the bibliographic masthead text, which typically looks something like this:

Relations
An Interactive Fiction by Emily Short
Release 1 / Serial number 050630 / Inform 7 build 2U98 (i6/v6.30 lib 6/10N) SD

(The serial and build numbers are those applying when the story file was last made: these ones are from the mid-2000s.) The banner is printed at the start of play, and when the player types "version" at the command line, and when say "[banner text]" occurs.

say "[the/-- banner text]"

This text substitution expands to the banner text giving bibliographic details of the current story file, rather like the opening credits of a movie, or the title page of a book.

2. The default behaviour. Prints the text above, giving the title, the headline, the author, the release number, the date of compilation (that's the serial number: YYMMDD), and version numbers of the Inform components used to put the story together.

3. Examples. (a) Adding a line to the banner:

After printing the banner text, say "DRM authentication code: 13S-451-2034u75y65u%%a1248."

(b) Simplifying the banner:

Rule for printing the banner text: say "Welcome." instead.

Example

382.

Bikini Atoll ★

Delaying the banner for later.

RB 11.1 Start-Up Features

🔗

WI §18.38 Printing the player's obituary

1. When it happens. The obituary is the text "*** You have died ***" or similar, sometimes followed by a final score, if the appropriate use option ("Use scoring.") is in force.

2. The default behaviour. Printing the aforementioned text, then the final score, and reducing the status line to a largely blank state.

3. Examples. Here's one way to add to the verdict of history:

After printing the player's obituary: say "And you visited [number of visited rooms] place[s]."

Examples

383.

Battle of Ridgefield ★

Completely replacing the endgame text and stopping the game without giving the player a chance to restart or restore.

RB 11.6 Ending The Story

384.

Finality ★

Not mentioning UNDO in the final set of options.

RB 11.6 Ending The Story

385.

Jamaica 1688 ★

Adding a feature to the final question after victory, so that the player can choose to reveal notes about items in the game.

RB 11.6 Ending The Story

🔗

WI §18.39 Amusing a victorious player

1. When it happens. When the player chooses "AMUSING" from the short menu of choices after a story has been won. Traditionally, this is where the author gets to point out quirky by-ways of the story, or make some final acknowledgements, or simply salute the player's perseverance. Note that the AMUSING option is only offered when the story has ended finally, and that it is only offered if there is at least one rule present in the "for amusing a victorious player" rulebook.

2. The default behaviour. None. The "for amusing a victorious player" rulebook is empty by default, and no amusement is available.

3. Examples. The format would be like so:

Rule for amusing a victorious player: say "Hmm. You're easily amused."

Example

386.

Xerxes ★★

Offering the player a menu of things to read after winning the game.

RB 11.6 Ending The Story

🔗

WI §18.40 Starting the virtual machine

1. When it happens. This activity is provided solely as a "hook" for any low-level tasks which need to be performed when the virtual computer which runs Inform story files is starting up. This happens much earlier than "when play begins" rules, and should be used only as a last resort.

It should be remembered that Inform can produce story files for several different virtual computers. On some of these, it will not be safe to print any text during this activity, as the windows which would display such text do not yet exist.

2. The default behaviour. None.

3. Examples. No detailed examples will be given here, but the activity might be used (for instance) to set styles for the Glulx windows shortly to be brought into existence.

Example

387.

Blankness ★

Emptying the status line during the first screen of the game.

RB 12.2 The Status Line

§25.

§25.

§25.

§25.

§25.

The Treaty of Babel and the IFID

§25.

The Release button and the Materials folder

§25.

The Joy of Feelies

§25.

Cover art

§25.

An introductory booklet and postcard

§25.

A website

§25.

A playable web page

§25.

Using Inform with Vorple

§25.

Website templates

§25.

Advanced website templates

§25.

Republishing existing works of IF

§25.

Walkthrough solutions

§25.

Releasing the source text

§25.

Improving the index map

§25.

Producing an EPS format map

§25.

Settings in the map-maker

§25.

Table of map-maker settings

§25.

Kinds of value accepted by the map-maker

§25.

Titling and abbreviation

§25.

Rubrics

🔗

WI §25.1 The finished product

This chapter and the next are about what to do when we have a complete, finished work on our hands.

For almost all of the time when a new work of IF is being written, it lives inside the familiar two-panel spread of the Inform user interface. But that isn't how eventual players will experience it. They will want to play a "story file" in a standard format, and they will do so with a wide range of different interpreters on many different computers or websites, including some -- like mobile phones -- on which Inform itself will not run.

So how does a new work of IF reach players? The simple answer, covered in this chapter, is that clicking the Release button instead of Go causes Inform to output a stand-alone story file. But as we will see, Release can do much more than that: it can attach covers, include bibliographic data, make websites and much more. Releasing is the process of making all of the material we want to deliver to our eventual players.

But that is only the first step. What do we do with the material when we have it? Printing out a manuscript of a novel is not the same as publishing it. So the next chapter, on Publishing, completes the story.

🔗

WI §25.2 Bibliographic data

Almost all printed books have a title page and a so-called "imprint" page, often its verso, which make up a description of the contents. The title page gives the name of the book and of the author, while an imprint page contains a variety of details about the edition, the printing, and so on. An ISBN number is allocated so that, from the number alone, any book seller or cataloguer can identify exactly this work. Sometimes other cataloguing information is added, such as the Library of Congress classification. This set of information is called "bibliographic data", and without it libraries and booksellers would be at a total loss.

IF has bibliographic data, too. Inform has a number of special named values to hold this - who wrote the work being created, what it is called, what headline it has, what genre it has and what its release number is, and so on.

These can be set as follows:

The story title is "Mansfield Perk".
The story author is "Janet Austen".
The story headline is "An Interactive Romance".
The story genre is "Romance".
The release number is 7.
The story description is "In Miss Austen's new interactive novella, Miss Henrietta Pollifax is adopted by the tempestuous landowner Sir Tankerley Mordant, and must make a new life for herself on the rugged moors."
The story creation year is 2005.

Most of these are self-explanatory. The "story creation year" is provided so that if we need to revise the work to fix some bugs a year later - by no means an uncommon occurrence - then we can make sure it is correctly identified as still being basically a 2005 work. (Just as a book which has had innumerable revised printings may say "First published 1988" on its imprint page.) The "story description" is a piece of text, analogous to the back cover blurb on a book: it might be two or three paragraphs long, so the example above is rather minimal, but it should not be epic in length.

As we have already seen, a convenient abbreviation provides that if the first sentence of the source text consists solely of text in quotation marks, then that is considered the title. Thus if the source begins:

"Mansfield Perk"

then that will be the "story title". Further, we can write

"Mansfield Perk" by Janet Austen

with the obvious effect: quotation marks around the author's name are optional here, for convenience, but note that we'd better have them in cases like:

"Three Men in a Boat" by "Jerome K. Jerome"

as otherwise the full stop after the K will end the sentence prematurely.

The text of these bibliographic descriptions cannot normally include text substitutions, since they are written into external descriptions of the story file as part of its "binding". Two exceptions are allowed, though: "[']" makes a literal apostrophe, and can be used if we need to override Inform's normal conventions to do with converting apostrophes at the ends of words to double-quotes. For instance:

"Summer of [']69" by Buzz Aldrin

The other exception is that the "[unicode …]" text substitution works, so for example:

The story description is "This is a sentence[unicode 8212]with a parenthetical in dashes[unicode 8212]because 8212 is the Unicode number for an em-dash. But for example, 'pawn to [unicode black chess bishop]4' draws in a black chess bishop, so it works with names, too."

If the bibliographic named values are not set by the source text, Inform will still need to say something. Unset text and number variables evaluate to "" and 0 respectively, but this would make for a very unhelpful record. So Inform uses the following table instead of any value which is unset:

Story title: Untitled
Story author: Anonymous
Story headline: An Interactive Fiction
Story genre: Fiction
Release number: 1

🔗

WI §25.3 Genres

The "story genre" is not used in the banner at all, and exists purely to help librarians. If it is at all possible to do so, authors are asked to use one of the following standard categories:

Comedy, Erotica, Fairy Tale, Fantasy, Fiction, Historical, Horror, Mystery, Non-Fiction, Other, Romance, Science Fiction, Surreal

These categories are based on those currently used by bookshops, but a few notes may be helpful. "Fiction" is intended for works whose essential purpose is literary, in a way which trumps any subject they happen to have: if Julian Barnes writes a mystery, for instance, a bookshop will shelve it with modern novels rather than in the detective stories section, whereas P. D. James's Adam Dalgliesh mysteries will end up filed with detective fiction even though she has appreciable claims to be an important novelist.

"Comedy" is used rather than "humour" to avoid the clash of spellings with "humor". This genre includes parodies.

"Non-Fiction" would be used for a work of IF which is essentially a presentation, perhaps in a novel interactive format, of true information. A meticulous simulation of the Great Exhibition of 1851, for instance, might qualify.

The distinction between "Surreal" and "Other" is that "Surreal" works contain at least some semblance of narrative, whereas "Other" is intended for works which "abuse" the format to present some entirely different sort of game - Tetris, say, or Minesweeper.

🔗

WI §25.4 The Library Card

Bibliographic data is useful for two reasons. Firstly, it enables the equivalent of a title page to be printed - traditionally called the "banner" - at the start of play; secondly, Inform uses it to generate the equivalent of a library card for the work, which can be used by other programs to help organise, sort and classify interactive fiction. If the card is given to any other program on any other machine (or an Internet-based archive) then, in principle, that system can know about our work of fiction without a human librarian having to get hold of a copy, play it and laboriously copy out the details.

The "library card" is not of course a physical card, but a small "metadata" file which could potentially be transmitted quickly across the Internet. It contains no personal data other than what you choose to put on it, using the sentences documented in this chapter: it does not, for instance, identify your computer or IP address. In any case Inform does not send it anywhere, but merely keeps an up-to-date copy within the project, and includes it when making a release copy of the work. You can always see (a representation of) the current library card for a project in the Contents index.

Authors are asked to play fair, in return, by writing sensible and useful bibliographic information for any work which is likely to circulate to other people; by being honest (writing under a pseudonym is fine, but not impersonating other people); and by conforming to standard practice.

The Settings panel of each project contains a tick-box called "Bind up into a Blorb archive on release", and by default this is ticked. "Blorb" is a nonsense word from a popular early 1980s work of IF called "Enchanter", where it was the name of a magic spell whose purpose was to "safely protect a small object as though in a strong box". In the late 1990s, the name was borrowed for a standard format for what might be called the wrapping and packaging of IF. A typical Blorb archive produced by Inform contains the "story file" - the actual program for the story - together with its library card and cover art.

Modern IF interpreters such as Zoom for Mac OS X and Unix, and Windows Frotz, can play blorb archives directly, and the authors of Inform hope to make this the normal practice in future. Still, some interpreters cannot read blorbs directly and have to be given the actual story file: so by unchecking the above tick-box, we can insist that Inform creates only that. The disadvantage with this, of course, is that the library card (with all its bibliographic data) and any cover art is lost in the process.

🔗

WI §25.5 The Treaty of Babel and the IFID

During March and April 2006, an agreement was reached between the IF archive and most of the different systems for creating IF - of which Inform is only one - called the Treaty of Babel. While these different systems create computer programs which are quite different internally, the Treaty provides for works of IF to come with bibliographic data which identifies them in a standard way.

Inform is fully compliant with the Treaty. In particular, each new project created by Inform is allocated a unique identification number called its IFID. The IFID is the equivalent for IF of the ISBN of a printed book. Inform copies it onto the "library card" for the benefit of Internet-based libraries which may eventually accession the work. Of course many projects start but never see the light of day, so many possible IFIDs are "wasted": but that hardly matters, as there are plenty more numbers in the world.

The important thing is that

The IFID number must be unique to this one work out of all the IF ever created

Inform will make sure this is true, unless we do something to break this ourselves. For instance, if we take an existing project, copy it as a file, then work divergently on the original and on the copy so that they become two radically different works, they will still each have the same ID. This is a bad thing: if we want to duplicate a project but then turn it into something new, the best way to do that is to create a new project, and to copy and paste the source from the old to the new.

🔗

WI §25.6 The Release button and the Materials folder

Inform's Release button does two things: it makes a stand-alone, public version of the current project - a "story file" - and it gathers up, or creates, whatever material we want to go with it.

The release version of the project can be played by anyone with an "interpreter" - they do not need the Inform application installed on their computers, and they will not be able to see the source text. Released versions differ slightly from the versions playable in the Story panel of Inform, because debugging commands such as ACTIONS are not included with them. (As we've seen, also excluded is any material in the source text under a heading including the words "not for release".) In some cases, if we release along with an interpreter, we can even make the project playable from a web browser, so that the player doesn't need to install any software at all, not even a browser plugin.

The Release button also creates a ".materials" folder for the project, if one doesn't exist already. (On some platforms, the Inform user interface creates it automatically alongside the project.) Inform adopts the following convention:

The files associated with the project "Whatever.inform" should all be kept in a subfolder called "Whatever.materials" in the same folder that contains the project.

For example, if we have a project filenamed Magician.inform which lives in a folder called "Works in Progress", then files might be arranged like so:

Works in Progress
   Magician.inform
   Magician.materials
      Collegio.pdf
      Mating Wyverns.mp3

Of course "Magician" might not actually be the title of the project - it might be an abbreviation, or a working title. The name of the .materials folder has to match the name of the .inform file, not the title.

Several advanced features of Inform make use of the materials folder, and the "Release" button is one of them. It creates a further subfolder called "Release" within the materials folder. This is where it will always place the story file it creates, together with anything released "along with" the story - Inform will not need to put up a dialogue box asking us where to save the story file, because there is already a natural place. For instance, after a successful click on Release, we might then see:

Works in Progress
   Magician.inform
   Magician.materials
      Collegio.pdf
      Mating Wyverns.mp3
      Release
         Collegio.pdf
         Magician.zblorb
         Mating Wyverns.mp3

where "Magician.zblorb" is the actual story file produced by Inform. Note that Inform has made copies of the files to be released with it - the idea is that the Release subfolder contains only what Inform makes, and everything in the Release subfolder can be thrown away at any time.

This is especially useful if we're releasing along with a website (see below), as then the Release subfolder will be exactly what needs to be uploaded to a server to be shown to the world. Equally, the Release subfolder is what can be zipped up and uploaded to archives or (if small enough) emailed out.

🔗

WI §25.7 The Joy of Feelies

"Feelie" is a slang word, again going back to the early days of IF, for something tactile included with commercially sold copies of IF games. For instance, Infocom's "Wishbringer" was not just a diskette in a pretty box: the box also contained a map, a letter, an envelope, a magic stone (well, a stone) and a booklet. Most of this was purely for fun, and to flesh out background to the story, but there would usually be clues sneaked into the text or artwork as well.

Today's IF is usually not supplied in physical packaging, and not accompanied by physical objects. But authors do sometimes want to include extraneous matter, whether it's a simple read-me file of instructions or a multimedia extravaganza. Inform does not provide facilities to make artwork, movies, soundscapes, booklets, etc.: there are plenty of programs out there to do all of that already.

But Inform does help with the collation and packaging-together. For instance, by placing the following sentence in the source text:

Release along with a file of "Collegio magazine" called "Collegio.pdf" and a file of "The mating call of the green wyvern" called "Mating Wyverns.mp3".

…we tell Inform that we will also be providing two additional files. Note that in each case we supply a brief description and a filename. The filename should always have a standard file extension for a well-known and thoroughly standardised file format - ".pdf" and ".mp3" are pretty safe: so for instance are ".txt", ".png", ".jpg", ".html". The filename should not include punctuation marks other than the full stop dividing name from extension, and should not exceed 30 characters in length.

It is also possible to supply a feelie which is not a single file, but is a mini-website: that is, a collection of interlinked HTML (and perhaps other) files. The convention here would be:

Release along with a file of "Baltrazar's Guide to Magic" called "Guide".

The absence of a file extension on the filename "Guide" tells Inform that the feelie in question is a mini-website: it is expected to sit inside a folder called "Guide", with its home page being "Guide/index.html". However, a mini-website like this must be created by hand: Inform does not copy it into place, it only creates links to the place where it ought to be put.

We have seen that Inform takes the story file, which is analogous to the pages of a book, and places it into a Blorb archive, analogous to the binding. These new additional files are not placed in the Blorb, because that would make the Blorb archive rather large (and would hide them from the player, which defeats the purpose). But references to them do appear in the Blorb, so that any interpreter playing the Blorb would be able to tell that there are supposed to be additional files available. Similarly, references are entered onto the library card.

🔗

WI §25.8 Cover art

Accompanying files are not the only things which can be included in a "release along with" sentence: for instance, we could

Release along with cover art ("A stone gargoyle"), a file of "Collegio magazine" called "Collegio.pdf" and a file of "The mating call of the green wyvern" called "Mating Wyverns.mp3".

Cover art can not only be used to advertise a work of IF, it is also displayed to players by certain interpreters, such as Zoom or Spatterlight for OS X, or Windows Frotz for Windows. It is also used on the IFDB (ifdb.org), and by browsing applications. If Zoom is installed, then on Mac OS X Leopard, the Finder shows cover art directly:

Cover art for a work should be prepared in either JPEG (".jpg") or PNG (".png") format, and we recommend that it should be square, like a music album cover. Programs which notice the cover art for a work of IF are likely to scale this up or down as convenient for their own display purposes, but it would be helpful to provide the original art at 960 by 960 resolution. The cover art must not be smaller than 120 pixels in either dimension.

To provide cover art, we should create an image file called Cover.jpg, or else Cover.png, and place it in the project's .materials folder. For instance, we might have:

Works in Progress
   Magician.inform
   Magician.materials
      Collegio.pdf
      Cover.jpg
      Mating Wyverns.mp3

(supposing that, as in the previous examples, "Collegio.pdf" and "Mating Wyverns.mp3" are the filenames of two feelies that accompany the release).

The text in brackets after the release instruction…

Release along with cover art ("A cathedral at sunset.").

…is provided for the benefit of blind or partially sighted users, and should be brief.

🔗

WI §25.9 An introductory booklet and postcard

When IF is aimed particularly at people who have never played IF before, there are certain conventions which it's a good idea to explain, or players will simply not know what to do. It can become a chore writing a clear set of instructions, and then there is the further nuisance of explaining about the need for an interpreter program to play the IF story file.

To alleviate this, Inform can "Release along with an introductory booklet", as for instance in this example:

Release along with cover art, the introductory booklet, a file of "Collegio magazine" called "Collegio.pdf" and a file of "The mating call of the green wyvern" called "Mating Wyverns.mp3".

The introductory booklet is a standard 8-page PDF file, written and designed by Emily Short, which contains all the basic information needed for a player to get started. It has been written to be as general-purpose as possible, in the hope of being useful for a range of widely different works of IF. There will certainly be works to which it would not be an appropriate supplement, and some authors will certainly prefer to write their own notes for players, but of course it is not compulsory. By making it available as a convenience, the authors of Inform do not intend to say that these are the "official" instructions or that others are not. It is simply intended as a time-saver.

As an alternative, or a supplement, it's also possible to:

Release along with an introductory postcard.

which supplies a standard postcard about IF (everything new players need to know, at one glance) written and designed by Andrew Plotkin and Lea Albaugh.

🔗

WI §25.10 A website

Much of the published IF of the last twenty years came with a brief text file describing what it was - a release note. Today it makes more sense to write this as a small web page, which can either be placed online, or simply distributed as part of the release.

Inform is able to manufacture such a website automatically. We request this by writing, for instance,

Release along with cover art, a website, a file of "Collegio magazine" called "Collegio.pdf" and a file of "The mating call of the green wyvern" called "Mating Wyverns.mp3".

where the list of ingredients now includes "a website". In fact, Inform makes only a single web page, called "index.html", which it places in the materials folder (as set up in the previous section): this then contains suitable links to all the other material, such as the cover art images, if they are also provided. For instance:

After a successful release now, then, we should see:

Works in Progress
   Magician.inform
   Magician.materials
      Collegio.pdf
      Cover.jpg
      Mating Wyverns.mp3
      Release
         Collegio.pdf
         Cover.jpg
         index.html
         Magician.zblorb
         Mating Wyverns.mp3
         Small Cover.jpg

("Release/Small Cover.jpg" is a form of the cover image intended for display at a smaller size. In earlier versions of Inform, the author had to provide this: there is now no need.)

🔗

WI §25.11 A playable web page

Modern web browsers are now so powerful as computing environments that they almost amount to general-purpose computers in their own right. The websites made in the previous section were passive, and simply displayed information about a story file. But it's also possible to make a more active page - one which can play the story file, right inside the browser, for anybody who visits.

To make such a page, we must:

Release along with an interpreter.

This automatically releases along with a website as well, since we need the website in order to house the new page, which will be called "play.html". This page will be bundled up with a customised copy of a story file interpreter coded in Javascript - in effect, a program for a web browser to follow - and a suitably encoded version of the story file. The practical effect should be that anyone visiting the page with any modern browser can just play.

Inform ships with the "Parchment" and "Quixe" interpreters built in. By default Inform will use Parchment if the format (on the project's Settings panel) is set to Z-code, and Quixe if the format is Glulx. In fact, though, Parchment works with either format, and some users prefer using it. If we want to have Parchment even for a Glulx project, we can write:

Release along with the "Parchment" interpreter.

…and that's just what will happen. In fact, Inform also supports the use of any other interpreter the author wants to try. If we have access to an exotic Javascript-based interpreter called, let's say, "Urbzig", then we can install it by putting it into the "Templates" subfolder of the ".materials" folder for the project:

Release along with the "Urbzig" interpreter.

🔗

WI §25.12 Using Inform with Vorple

"Vorple" is an innovative system by Juhana Leinonen for allowing web-based Inform stories to make use of web controls and other gadgets. Using Vorple, a story can in principle have an entirely different user interface, and can make much better use of CSS styling, interface to Javascript libraries, and so on.

Vorple has seen rapid development. In its early days it was included as part of the Inform app, but it has now evolved into a dynamic project which is better served by its own website than from here:

vorple-if.com

🔗

WI §25.13 Website templates

Web pages are very idiosyncratic things and Inform will almost certainly not produce exactly what we want. What it actually does is to take an existing "template" web page, and paste in the relevant information to make the final product. So by starting with a different template, we can end up with an entirely different-looking web page: like this one, for instance -

The template ordinarily used by Inform is called "Standard" and comes built in. (A second built-in template, "Classic", imitates the look used in 2005-08. The word "classic" here is to be understood in the sense of Classic Mac OS, the classic Doctor Who adventure "Time and the Rani", classic Mayan civilisation, and so forth - really pretty awful.)

Any other templates we must make ourselves, giving each one a different name, by convention a single word. In this section, we'll make a new one called "Platinum".

Suppose we write:

Release along with cover art, a "Platinum" website, a file of "Collegio magazine" called "Collegio.pdf" and a file of "The mating call of the green wyvern" called "Mating Wyverns.mp3".

This is identical to the previous version except for the "Platinum": note the quotation marks. When it needs to find a template, Inform searches the following places in sequence:

(a) the "Templates" subfolder of the project's own .materials folder, if this subfolder should exist;
(b) the "Templates" folder in the user's own library - on Mac OS X, this is:
   ~/Library/Inform/Templates
or on Windows:
   My Documents\Inform\Templates
or on Linux:
   /Inform/Templates
(c) the built-in stock of templates, currently only "Standard" and "Classic".

What Inform looks for is a folder name matching that of the template - so in our case we need to provide a folder called "Platinum", and put it in either location (a) or (b).

The template folder is expected to contain some combination of the following files:

Platinum
   index.html
   source.html
   style.css
   (extras).txt

There are two HTML pages here, one for the main front page, the other for pages of displayed source text (if we release along with the source text - see later in the chapter). The CSS file defines styles of text - sizes, fonts, colours, and so on - and positions material on the page. The "(extras).txt" - which is optional, of course - allows additional HTML pages, images, movies and so on to be added.

If any of these is missing, Inform uses the one in "Standard" instead. In practice, this means the easiest way to create a new template is to supply just a new CSS file, which can change the colour, font, type size, and position of more or less everything in the site:

Platinum
   style.css

We probably want to start from the "Standard" version of "style.css" and edit in a few changes; the easiest way to get a clean copy of "Standard"'s CSS file to work on is to release the project with a "Standard" template, which causes this default "style.css" to appear in the "Release" subfolder of the project's .materials folder. (But it's wise to move the file out of "Release" before starting to edit it - files in "Release" are overwritten by Inform whenever a release is made.)

This is not the place to describe how CSS works. CSS is a more or less universal format today for describing how web pages should look - their style rather than their content. A dazzling variety of possibilities can be seen at the excellent:

csszengarden.com

but of course there are many, many other textbooks and websites which describe CSS.

🔗

WI §25.14 Advanced website templates

The following describes how Inform uses the extras file and the two HTML pages in a template, and will only be needed if a new template has to make changes so radical that altering the CSS alone won't be enough.

The optional "(extras).txt" file - note brackets - is a text file which contains a list of named extras to throw in. For instance:

easter.html
egg.png

These named files need to be present in the template folder. Files with the extension ".html" go through the placeholder expansion process just like the index and source pages; all other files are copied verbatim.

HTML templates like "index.html" and "source.html" are fully valid HTML pages in their own right, though they have placeholder text where Inform will substitute the project's bibliographic data (see below). The "<head>" element should include a reference to "style.css", which of course will mean the CSS file given in the template (or the one from "Standard" if no CSS file is given) - for instance,

When it turns the template into the final web page, what Inform does is to replace certain capitalised words in square brackets with the appropriate text:

[TITLE] becomes the story title
[AUTHOR] becomes the author's name
[YEAR] becomes the story creation year
[BLURB] becomes the story description
[RELEASE] becomes the release number
[COVER] becomes an image of the cover art (the small 120x120 cover image)
[DOWNLOAD] becomes the download link
[AUXILIARY] becomes the list of feelie-like files, if any
[IFID] becomes the IFID
[STORYFILE] becomes the "leafname" of the story file, e.g., "Bronze.gblorb"
[TEMPLATE] becomes the name of the template used to make the page
[SMALLCOVER] becomes the filename of the cover when used at a smaller size
[BIGCOVER] becomes the filename of the cover when used at full size
[TIMESTAMP] and [DATESTAMP] become the time and date of releasing

Everything else is left alone. In source pages, five further placeholders are available:

[SOURCE] becomes the portion of the source text on this page
[SOURCELINKS] becomes the navigational links
[SOURCENOTES] becomes the footnote matter at the bottom of the source
[PAGENUMBER] and [PAGEEXTENT] are such that the text "page [PAGENUMBER] of [PAGEEXTENT]" produces, e.g., "page 2 of 7"

Both [SOURCE] and [SOURCENOTES] must exist on the page, and [SOURCENOTES] must appear after [SOURCE] does in the file. (Of course the CSS in "style.css" might move the copy around on screen, but that's another matter.)

🔗

WI §25.15 Republishing existing works of IF

Some long-time users of Inform will have projects which were originally made using the very different Inform 6 language. Story files produced with Inform 6 do not have any of the extra touches in this chapter: in particular, they have no cover art and no bibliographic data, which makes them rather plain and anonymous to newer Treaty of Babel-equipped programs like Zoom, Spatterlight or Windows Frotz.

To help with this, today's Inform can republish an Inform 6 project by combining an Inform 7 source text which contains only release instructions and bibliographic data with an already-compiled Inform 6 story file. We do this by writing a short source text which contains:

Release along with an existing story file.

We then place the story file in the ".materials" folder. By default this will be called "Story.z8", but we can alternatively name it:

Release along with an existing story file called "Zork1_sg.z5".

The Settings panel must be switched to the Z-machine for this to work, since only Z-machine story files are supported this way, not Glulx. And we can now use the Release button to obtain the goods.

An existing story file can take advantage of all of the extra features - cover art, titling, website, feelies and so forth - earlier in this chapter, but not those - walkthrough, source text, map - which are still to come.

The following is a typical example of a source text used solely to bind up an old Inform 6-compiled story file:

"Curses" by Graham Nelson
 
The story genre is "Fantasy".
 
The story headline is "An Interactive Diversion".
 
The story creation year is 1993.
 
The release number is 16.
 
The story description is "It's become a matter of pride now not to give up. That tourist map of Paris must be up here somewhere in all this clutter, even if it has been five years since your last trip. And it's your own fault. It looks as if your great-grandfather was the last person to tidy up these lofts..."
 
Release along with cover art and an existing story file.

🔗

WI §25.16 Walkthrough solutions

Since the earliest days of IF, players have distributed solutions to well-known stories, to help out other players at their wits' ends. The commonest format for these is a list of commands to type, sometimes with notes in the margin, and such a solution is called a "walkthrough", since it walks a player through the story.

Few authors publish solutions of their own works, but many supply their testers with solutions, especially towards the end of testing, or submit a solution as part of a competition entry. To help with this, Inform can generate such a walkthrough solution automatically:

Release along with a solution.

Inform will then place a file called "solution.txt" inside the "Release" folder. The solution might look like so (although probably much longer):

Solution to "Memoirs of India" by Graham Nelson
 
Choice:
INVENTORY -> go to branch (1)
EAST -> go to branch (2)
 
Branch (1)
DROP MANUSCRIPT
SOUTH
 
Branch (2)
INVENTORY  ... Always a good idea
GIVE MANUSCRIPT TO THOMAS

Inform does not, of course, know how to solve IF all by itself, but derives the solution from the project's Skein. Since the Skein will have been used in testing the story, it will very likely contain a perfect solution - or several different ones, taking the story to a variety of possible endings. In the example above, there are two possible winning lines, which diverge right from the first move. (There can be further divergences: for instance, if branch (2) splits, it will split into branches called (2.1), (2.2), (2.3) and so on.)

But the Skein will also contain plenty of unwanted diversions, so Inform does not rewrite the entire Skein as a solution. Instead, it looks for knots in the Skein which have been annotated. Any knot whose annotation begins "***" (three asterisks) is considered to be a final, winning move. (It is probably a good idea to lock such a knot once it has been annotated thus, too.) We can mark any number of knots "***" since, after all, we can declare any number of lines of play as possible solutions. Inform then constructs the solution out of all lines of play in the Skein which lead to "***" endings, and ignores other threads.

Annotations other than "***" in the Skein are turned automatically into comments in the solution text. For instance, the knot for the INVENTORY command in the second branch above was annotated "Always a good idea", and this was transcribed into the solution. (If an ending knot is annotated with, say, "*** Happy ending!" then the "***" marks it as an ending, and "Happy ending!" is added as an annotation to that ending.)

By default, the solution text is not linked from our webpage, on the assumption that we may want to generate a walkthrough but not immediately advertise it to players. If we wish to change this, we may write instead

Release along with a public solution.

The terms public and private may also be applied to other elements we are having Inform generate to include on our webpage: see also the notes on private source text, below.

🔗

WI §25.17 Releasing the source text

Most authors will not want to publish the source text alongside the work itself, because this gives away all of its secrets. Inform provides the option mainly for the sake of the examples published on its own website, where making the source available is the whole point. But anyone is welcome to use the option, of course:

Release along with the source text.

If Inform is not also generating a website, this produces a plain text file called "source.txt" in the "Release" folder, and there is nothing more to be said.

However, if a website is also being released, the source is also converted to a suite of web pages which are linked to and from the home page. (Each heading with substantive content is placed on its own web page, with the opening page containing a contents list.)

Comments in the source are rendered in grey. As a special feature, any comment which begins with an asterisk is considered a footnote and is printed below the source text, with a link. Thus comments thus:

Hercules is a demigod.[* We're using Greek spellings so he ought to be Heracles, but players are so much more familiar with Hercules.]

will be printed more like so:

Hercules is a demigod.[1]
...
Note
[1]. We're using Greek spellings so he ought to be Heracles, but players are so much more familiar with Hercules.

Footnotes are automatically numbered from 1 on each source page.

By default, the source text is linked from our generated webpage, if we are releasing with a webpage. If we wish to change this, we may write instead

Release along with the private source text.

This will create a text file containing the source for our story, and place this file in our release folder, but not create a link so that the player can find it.

Finally, we can:

Release along with the library card.

which releases a stand-alone XML file in 'iFiction' format for the bibliographic data on the story file; this is the same data embedded in the blorb file itself, but having an external copy makes it easier to see what Inform has done, and some external programs can read iFiction data like this.

🔗

WI §25.18 Improving the index map

As we have seen, "Release along with…" allows us to package up a work of IF with all manner of extra materials. But what are these to be? One popular option is to produce a map - sometimes partial, sometimes obfuscated - and supply that with the story: besides, there are some IF competitions where the rules require that the referee is supplied with a map even if the players are not, and failing that, it is sometimes nice to be able to print out a map of a work in progress.

The World map in the Index tab is heavily stylised and cartoonish, intended to be clicked on or moused over, and viewed in a browser: although it is, in fact, possible to print it, the results are not very good. Fortunately, the same underlying map mechanism can be used to output something more useful and very much more customisable, as we shall see.

The map-maker is one of the most complex parts of Inform, even though it actually contributes nothing to the final story file: the problem of how to draw up a "correct" map from the source text is by no means easy to solve. Inform tries, but it often gets things wrong. Its general practice is to place rooms on a square grid (actually a cubic lattice, as it works in three dimensions), but not all conceptual maps fit well onto this, and Inform often annoyingly puts a particular room in the "wrong" place. For instance, suppose Inform puts "Didcot" east of "Abingdon" and this makes the geometry look different to what we had in mind. We can correct with:

Index map with Didcot mapped southeast of Abingdon.

Note that this says nothing about exits from any room to any other room, and changes the final work of IF not at all: it simply helps Inform to draw the map index. (Instructions like this one are treated as being almost certainly true, but Inform does not quite always obey: it will never allow two rooms to be superimposed at the same grid position, no matter what we have asked in "Index map with…" instructions.) The same trick is useful if we have a situation like so:

Inside of Sweeping Sands is Beach Hut Interior.

"Beach Hut Interior" is a single room which does not connect to the rest of the map by any of the ten spatial directions, so Inform does not place it on the main map but instead moves it off out of the way in a map of its own. Given that it's just a single room, however, we might prefer to put into a convenient otherwise empty grid position like so:

Index map with Beach Hut Interior mapped west of Sweeping Sands.

Finally, note that this trick also ensures that the two locations are mapped on the same level vertically, and can be useful in cases where room A is both north of and above room B: Inform will want A to be higher up than B, but we can insist otherwise.

🔗

WI §25.19 Producing an EPS format map

The "Index map with…" instruction is a much more varied thing than hinted at in the previous section, and its general form is

Index map with [instruction] and [instruction] and ... and [instruction].

where the instructions can be of four different forms, as follows:

[room A] mapped [direction] of [room B]
EPS file
rubric [text] ... and some optional details ...
[setting] of [whatever] set to [value]

We have already seen the first of these instructions. The second is short and has a fixed wording:

EPS file

so can be invoked by typing "Index map with EPS file.", for instance. EPS stands for Encapsulated PostScript, which is a standard file format for line art. EPS files can be edited with sophisticated graphics programs such as Adobe Illustrator, and can be used as illustrations in many word-processors and page layout programs. They can also be converted to PDF by Mac OS X Preview, or used in Linux or Windows with the open-source Evince viewer. We need a line-art format because the map produced will never be exactly what we want: we are probably going to end up hacking it to change the fonts, add some drawings, tidy up the spacing and so on. A really large map will end up using quite a large "canvas", in EPS terms; it may be necessary to shrink it down in order to get it onto an A4 page, or to adjust whatever editing software is used to "custom paper size".

When the map-maker has been given the "EPS file" instruction, it writes an attempt to draw the current project's map in EPS format as a file in the project's ".materials" folder, with the filename "Inform Map.eps".

Note that Inform will over-write any existing file of this name: but that is intentional, because one usually ends up tweaking and rebuilding the project over and over to get the map just so, and it would be tiresome for Inform to produce endless copies "Inform Map 19.eps", etc.

(The reason the EPS file is not placed in the Release subfolder is that it is not going to releasable to the public as it stands: for one thing it will be too raw, and for another, EPS is not a format everyone can read. It is provided as raw materials.)

🔗

WI §25.20 Settings in the map-maker

The map-maker has altogether 35 named settings, and tweaking these can affect the result in ways which vary from the subtle to the grotesque. An important point is that the map-maker deals separately with the three levels in its working: the big picture of the whole map; each of the vertical slices which contain sub-maps; and finally all of the individual rooms. For instance, we might have 67 rooms, arranged on 3 vertical levels, all shown on one big map: Inform will try to show these stacked above each other, with the highest level at the top of the map, then the middle level, then the bottom level.

Moreover, not only does the whole map have its 35 settings, but each level has its own independent collection of those 35 settings, and so does each individual room. So the actual number of variables in our example is 1+3+67 = 71 times 35, which is a lot. The convention is that setting the value of S (some setting, let's say) for something affects not only that thing, but also everything inside it, unless they have their own individual settings for S.

For example: one of the settings is called "room-size", and is the size of the little square boxes representing a room, measured in points. (One point is 1/72 of an inch, so 72 points equals 1 inch: it's a traditional printer's measure.) Suppose we write:

Index map with room-size set to 36
   and room-size of level 2 set to 28
   and room-size of the Hall of Kings set to 52.

The first instruction sets the value of "room-size" for the whole map (note the lack of an "of…"); the second for level 2 of the map, and the last for a single room only. The result is that the Hall of Kings is drawn as 52x52 point box, all rooms on level 2 are 28x28 (except the Hall of Kings, if it's on level 2), and all others are 36x36, half an inch square.

The setting instruction also allows three other useful forms. A setting "of the first room" applies to the room in which the story begins: we might for instance write

Index map with room-outline-thickness of the first room set to 2.

which gives this special room a bolder edge to it, since the default value is 1.

We can also apply settings not just to single rooms but to all rooms of a given kind:

A rivery room is a kind of room. Index map with room-colour of rivery rooms set to "Navy" and room-name-colour of rivery rooms set to "White".

Lastly, we can apply settings to all rooms in a given region:

Northern Oxfordshire is a region. Hampton Poyle and Steeple Barton are in Northern Oxfordshire. Index map with room-name-font of Northern Oxfordshire set to "Helvetica-Oblique".

(Note that rooms and regions don't have their own individual sets of the 35 settings: what happens is just that instructions like the last one change more than one room at once.)

🔗

WI §25.21 Table of map-maker settings

Note that all map-maker settings have single word names, though many are hyphenated, and that "colour" is always given the English and Canadian spelling, not the American form "color".

fontfont (named in double-quotes)
minimum-map-widthinteger (measured in points: 72 = 1 inch)
titletext (in double-quotes)
title-sizeinteger (measured in points)
title-fontfont (named in double-quotes)
title-colourcolour (named in double-quotes)
map-outlineon/off
border-sizeinteger (measured in points)
vertical-spacinginteger (measured in points)
monochromeon/off
annotation-sizeinteger (measured in points)
annotation-lengthinteger (length to abbreviate down to)
annotation-fontfont (named in double-quotes)
subtitletext (in double-quotes)
subtitle-sizeinteger (measured in points)
subtitle-fontfont (named in double-quotes)
subtitle-colourcolour (named in double-quotes)
grid-sizeinteger (measured in points)
route-stiffnessinteger (Bezier spline curve scale factor)
route-thicknessinteger (measured in points)
route-colourcolour (named in double-quotes)
room-offsetoffset (in percentages of grid-size)
room-sizeinteger (measured in points)
room-colourcolour (named in double-quotes)
room-nametext (in double-quotes)
room-name-sizeinteger (measured in points)
room-name-fontfont (named in double-quotes)
room-name-colourcolour (named in double-quotes)
room-name-lengthinteger (length to abbreviate down to)
room-name-offsetoffset (in percentages of grid-size)
room-outlineon/off
room-outline-colourcolour (named in double-quotes)
room-outline-thicknessinteger (measured in points)
room-shapeshape (named in double-quotes)

🔗

WI §25.22 Kinds of value accepted by the map-maker

Integer values are typed in the usual way: 3, -72, etc.

Text is in double-quotes: "Map of Lower Delta", etc.

Font names are in double-quotes: "Helvetica", etc. Note that Inform makes no effort to look for such fonts: if we give the name of a font we haven't got, the result will probably be that the map's EPS file will be displayed in various applications with Courier (which looks like bad typewriting) substituted. All fonts are by default equal to the global "font" setting (by default equal to "Helvetica"), so changing "font" for the whole map affects everything not explicitly specified as having a different font.

Shape names are in double-quotes with lower case. At present, the only legal shapes are "circle", "square" and "rectangle".

On/off values are written just thus: on, off. No quotation marks.

Offset values are actually pairs, and are written as two numbers (possibly negative numbers) joined by an ampersand, as in the example: "Index map with room-offset of Botley set to 10&-30." Note lack of spaces around the ampersand. This means that Botley's room is displaced from its correct grid position on the EPS map by 10% of the grid size eastwards, and 30% southwards. (The grid size is the distance between one grid position and the next: displacing Botley by -200&0 would move it two whole grid positions westwards.)

The route-stiffness setting is used when drawing routes between two rooms. These are drawn as Bezier curves, a standard way to make a smooth curve not only travel from A to B but also from pointing in a given direction at A to ending up pointing in a given direction at B. Thus a Bezier curve may turn a route round so that it leaves A pointing west, but curves around to enter B from the south. (Most routes involve leaving in one direction and arriving in the opposite direction, of course, and in those cases a Bezier curve is just a straight line.)

The stiffness factor for a given room measures how much the curves are allowed to warp around in order to force them to arrive at that room from exactly the right compass bearing. The default is 100. Raising to, say, 250 can force curved paths into freakish zig-zags: whereas lowering to 1, the minimum, may make the route arrive at completely the wrong bearing. (Formally speaking: at each end of the route, a "control point" for the Bezier curve is made by taking the centre point of the room, then adding the relevant compass bearing's vector, scaled up by the route-stiffness as a percentage of the grid size.)

Colour values are named and in double-quotes. These names are the same as those for the traditional set of web-page-safe colour chips, as follows:

"Alice Blue"
"Antique White"
"Aqua"
"Aquamarine"
"Azure"
"Beige"
"Bisque"
"Black"
"Blanched Almond"
"Blue"
"Blue Violet"
"Brown"
"Burly Wood"
"Cadet Blue"
"Chartreuse"
"Chocolate"
"Coral"
"Cornflower Blue"
"Cornsilk"
"Crimson"
"Cyan"
"Dark Blue"
"Dark Cyan"
"Dark Golden Rod"
"Dark Gray"
"Dark Green"
"Dark Khaki"
"Dark Magenta"
"Dark Olive Green"
"Dark Orange"
"Dark Orchid"
"Dark Red"
"Dark Salmon"
"Dark Sea Green"
"Dark Slate Blue"
"Dark Slate Gray"
"Dark Turquoise"
"Dark Violet"
"Deep Pink"
"Deep Sky Blue"
"Dim Gray"
"Dodger Blue"
"Feldspar"
"Fire Brick"
"Floral White"
"Forest Green"
"Fuchsia"
"Gainsboro"
"Ghost White"
"Gold"
"Golden Rod"
"Gray"
"Green"
"Green Yellow"
"Honey Dew"
"Hot Pink"
"Indian Red"
"Indigo"
"Ivory"
"Khaki"
"Lavender"
"Lavender Blush"
"Lawn Green"
"Lemon Chiffon"
"Light Blue"
"Light Coral"
"Light Cyan"
"Light Golden Rod Yellow"
"Light Grey"
"Light Green"
"Light Pink"
"Light Salmon"
"Light Sea Green"
"Light Sky Blue"
"Light Slate Blue"
"Light Slate Gray"
"Light Steel Blue"
"Light Yellow"
"Lime"
"Lime Green"
"Linen"
"Magenta"
"Maroon"
"Medium Aquamarine"
"Medium Blue"
"Medium Orchid"
"Medium Purple"
"Medium Sea Green"
"Medium Slate Blue"
"Medium Spring Green"
"Medium Turquoise"
"Medium Violet Red"
"Midnight Blue"
"Mint Cream"
"Misty Rose"
"Moccasin"
"Navajo White"
"Navy"
"Old Lace"
"Olive"
"Olive Drab"
"Orange"
"Orange Red"
"Orchid"
"Pale Golden Rod"
"Pale Green"
"Pale Turquoise"
"Pale Violet Red"
"Papaya Whip"
"Peach Puff"
"Peru"
"Pink"
"Plum"
"Powder Blue"
"Purple"
"Red"
"Rosy Brown"
"Royal Blue"
"Saddle Brown"
"Salmon"
"Sandy Brown"
"Sea Green"
"Sea Shell"
"Sienna"
"Silver"
"Sky Blue"
"Slate Blue"
"Slate Gray"
"Snow"
"Spring Green"
"Steel Blue"
"Tan"
"Teal"
"Thistle"
"Tomato"
"Turquoise"
"Violet"
"Violet Red"
"Wheat"
"White"
"White Smoke"
"Yellow"
"Yellow Green"

🔗

WI §25.23 Titling and abbreviation

The main title of the map is the value of "title" for the whole map, so for instance we might write:

Index map with title set to "Oxford and its Environs".

The subtitle settings apply to the subtitles used for each of the levels, so for instance

Index map with subtitle of level -1 set to "Tunnels and Sewers".

Names of individual rooms can be controlled with:

Index map with name of Radcliffe Camera set to "Library".

(By default, the name of a room is its name in the main IF project, of course.) The smallest writing on the map is normally that used to label unorthodox or unclear exits (in particular, those going from one layer to another): this is what the "annotation" size, font and colour are used for.

For most ways to set up the map, it's a practical necessity to abbreviate names of rooms, or they will spill out all over each other. Inform does this using the "room-name-length" setting. (The "annotation-name-length" is analogous.) For instance, if this setting is 5, then Inform will reduce the text of a name to at most 5 characters. It does this by successively throwing out spaces, lower case vowels, then other lower case letters, punctuation marks and finally upper case letters, always starting at the back of the name and working inwards: the process stops as soon as the name is short enough. For instance, "Reading" is abbreviated to "Redng", "Shangri-La" to "Shn-La" and "Cloud-Cuckoo-Land" to "C-C-L". The result can be a little comical, but is surprisingly unambiguous in practice. Abbreviation can effectively be abolished by raising the "room-name-length" to 128 (the highest permitted level), and note that the setting can be changed for individual rooms, so it is possible to have some room names abbreviated and others not, or in different degrees.

Examples

445.

Baedeker ★

Creating a floorplan of the cathedral using the locations from previous examples.

RB 13.2 Publishing

446.

Port Royal 5 ★

Port Royal scenario given instructions for an EPS map.

RB 13.2 Publishing

447.

Bay Leaves and Honey Wine ★

Creating a map of Greece using the locations from previous examples.

RB 13.2 Publishing

🔗

WI §25.24 Rubrics

Lastly, we can add our own arbitrary text to the map: perhaps to annotate points, perhaps just to add more heading matter (such as the author's name, or the date). Each individual line added - and only single lines can be added, not typeset paragraphs - is called a "rubric". (There can be up to 100 of these.) We can create a rubric like so:

Index map with rubric "Here Be Wyverns" size 16 font "Helvetica-Oblique" colour "Thistle" at 150&0 from Cloud-Cuckoo-Land.

This gives rather more detailed information than is needed: "size 16" could have been omitted, giving us 12-point type by default, and similarly there is no need to specify a font unless it differs from the main "font" setting for the whole map; and the colour will be black if unspecified. The "at" position does need to be given, though. Note that it is relative to a given room on the map, and that the position specified is that of the centre-point of the text. (If we had written just "at 100&100", say, that would specify a position relative to the bottom left hand corner of the map.) So, for instance:

Index map with rubric "trapped door" size 8 at -60&-60 from Longwall.

would add a little 8-point-type safety tip for naive map-followers.

Inevitably, the settings in the map-maker will fail to get exactly the effect desired (though they will offer an excellent opportunity to waste entire days). But that is the whole point of producing output in EPS format: Inform aims not to produce final print-ready professional art, but to produce the raw material for making that final work of art. And if all that's required is a sketch-map, then Inform's output should be good enough quickly and without too much fuss.

§27.

The status of extensions

§27.

The Standard Rules

§27.

Built-in, installed and project-specific extensions

§27.

Authorship

§27.

A simple example extension

§27.

Version numbering

§27.

Extensions and story file formats

§27.

Extensions can include other extensions

§27.

Extensions can interact with other extensions

§27.

Extensions in the Index

§27.

Extension documentation

§27.

Examples and headings in extension documentation

§27.

Implications

§27.

Using Inform 6 within Inform 7

§27.

Defining phrases in Inform 6

§27.

Phrases to decide in Inform 6

§27.

Handling phrase options

§27.

Making and testing use options

§27.

Longer extracts of Inform 6 code

§27.

Primitive Inform 6 declarations of rules

§27.

Inform 6 objects and classes

§27.

Inform 6 variables, properties, actions, and attributes

§27.

Inform 6 Understand tokens

§27.

Inform 6 adjectives

§27.

Naming Unicode characters

§27.

Overriding definitions in kits

§27.

Translating the language of play

§27.

Segmented substitutions

§27.

Invocation labels, counters and storage

§27.

To say one of

🔗

WI §27.1 The status of extensions

The range of simulation offered by Inform's model world is intentionally limited to a core of basic essentials. We could argue at the margins, and the choice of what's in and what's out is partly traditional, but most people find the model reasonable as far as it goes.

Between 1993 and 2006, quite a range of "library extensions" for Inform's predecessor language (Inform 6) was written. Most of these extensions aimed to fill out the model by simulating other aspects of life, too: money, clothing, pourable liquids. None of these extensions was official and all of them were: it was a free-for-all, and in several cases different authors wrote rival extensions to model the same basic ideas. The development of Inform 7 was strongly influenced by this history and by the recognition that the base of rules and grammar inside a typical modern story are seldom written by a single author. They combine the standard Inform material with extensions by several third parties, together with anything specific to the story in question.

Inform 7 has a more organised idea of extensions, as we shall see. But anyone is free to write an extension on any terms or for any reason. Writers may wish to use the techniques in this chapter to develop private extensions of their own, used in several projects, or to share them with associates but not more widely.

But most writers of extensions do so to contribute to the Inform community, and for the satisfaction of solving a problem. Inform does not recognise anyone's approach to a particular need as "the official solution" - for instance, although the standard Inform distribution includes a copy of Locksmith by Emily Short, that is not the "official" way to make automatically unlocking doors, and anyone is welcome to try a better one.

However, the Inform project does recognise some extensions as "public". Public extensions are the ones archived on the Inform website for the free use of all Inform writers. Those who wish to contribute an extension as a public one are obliged to follow a number of guidelines, which are mostly stylistic points intended to make the range of extensions easier to work with. Extension writers are asked to join in the spirit of these rules and help make the whole cooperative enterprise work harmoniously. Extensions which do play by these rules are also accepted into the Public Library, which makes them easy for all Inform users everywhere to find and obtain them.

Writers who wish to make their extensions public on the Inform website should also be clear that by doing so, they are donating their work to the community on the basis of the broadest form of Creative Commons license: that is, they retain copyright and the right to be identified as the author (and as we shall see they are automatically credited in any work of IF which uses their extension), but are giving unlimited permission to use, circulate and republish their extensions in any form, even as part of commercial works (should that arise). To publish a public extension is a public-spirited act, done for only the reward of a modest acknowledgement.

If the author of an extension has not made it public, or indicated in some other way that it is free to be used without the need for permission, then it would be both polite and prudent to check with the author before publishing something which incorporates his work.

🔗

WI §27.2 The Standard Rules

When any source text is run through Inform, a secret first line is inserted, which reads:

Include the Standard Rules by Graham Nelson.

The "Standard Rules" file contains the definitions of the basic kinds, phrases, actions and grammar described in this documentation: for instance, it includes lines like

A container is a kind of thing.

…without which Inform would be lost. Although including the Standard Rules is compulsory, it is treated internally as if it were any other "extension".

What happens when an "Include" sentence is reached is that the sentence is replaced with the whole text of the file in question, often many paragraphs long.

If the file has already been included, then the sentence is simply ignored. This is so that we can have two extensions, each of which needs the other: if A says to include B, and B says to include A, the result is that including one automatically includes the other, so we always get both which ever we ask for - not that there is a hideous infinite regress.

🔗

WI §27.3 Built-in, installed and project-specific extensions

To recap: Inform builds projects from both the source text typed by the author and from Extensions; one of these, the Standard Rules, is always included; others are added as authors please. About 20 are "built-in" to Inform, meaning that they are stored inside the application and always available. Others must be "installed", and each Inform user will have a folder somewhere on his computer which contains these. Users typically obtain these from the Public Library feature in the Inform application, but can also download them directly from the extension writer's website and then use an Install Extension menu option in the application. Either way, the application then squirrels the file away, and it becomes available to any projects that that user may be working on.

It is also possible to have extensions available to just one project. These must be stored in the Extensions subfolder of the project's ".materials" folder, but otherwise are arranged the same as installed extensions - there's an outer folder for each author's name, and extensions are named with a ".i7x" extension within. For example:

Mourning Hypercritical.inform
Mourning Hypercritical.materials
   Extensions
      John Siracusa
         Fixing The Finder.i7x

When Inform needs to find an extension, it looks here first, then in the installed area, then in its built-in area. That means that we can make our own revised or hacked version of an extension, put it in the ".materials" area, and then have it take precedence over the installed or built-in one. We could even have our own private version of the Standard Rules here.

(This has a number of possible uses - for example, to provide a convenient test-bed when working on an experimental version of an extension.)

🔗

WI §27.4 Authorship

Extensions are identified by author and by name, so that a given author can produce his or her own range of extensions, and need only ensure that these are named differently from each other. If John Smith and Mary Brown each want to write an extension called "Following People", there is no conflict.

The name of an extension, and of an author, should be written in Sentence Capitalisation: that is, upper case for the first letter in each word. (Inform uses this to minimise problems on machines where filenames are read with case sensitivity.) It is permitted for author names to include upper-case letters within words, as with the "G" in "Jesse McGrew". In general it is best to avoid accented or unusual letters in titles and author names, but the standard ISO Latin-1 characters should be allowed - for instance,

Étude Pour La Fênetre by Françoise Gauß begins here.

The author name must not start with "The", nor contain the words "by", "and" or "version", or contain punctuation, as in "John X. Doe"; the title similarly, except that "and" is permitted. Name and author's name must each be no more than 50 characters long, including any spaces between words.

Authors are asked to use real names rather than cryptic handles like "ifguy", and to use genteel, plausible pseudonyms like "Emily Short" rather than, say, "Drooling Zombie" or "Team Inform". Authors are also asked to use the same author's name for all their own extensions, and (it should go without saying) not to masquerade as anybody else.

Sometimes authorship is complicated. What if Mary Brown finds some Inform 6 code written by John Smith in the mid-90s, and puts an i7 gloss on it to make an i7 extension, but then Pierre Dupont translates it into French: who's the author of the result? The rule is that the person making the current, latest version is the author listed in the titling line, so we end up with

... by Pierre Dupont begins here.

But Mary and John deserve their credits too: see the next section for how to give them.

🔗

WI §27.5 A simple example extension

Extensions are plain text files, and can be created with any text editor. (It is sometimes said that "there is no such thing as plain text", there being so many ways to represent exotic characters: so to be precise, an extension is a text file with the Unicode UTF-8 encoding, either with or without a BOM marker, using any of the possible forms of line-ending (Unix, Windows, Macintosh, or Unicode line divider). This is a detail which will only matter if the extension contains accented letters or other exotica.)

Extensions look very much like passages of Inform source, because except for a special introductory and concluding sentence, and one convention, that is all they are:

The Ducking Action by Beatrix Potter begins here.

"An action for ducking one's head."

Ducking is an action applying to nothing. Report ducking: say "You duck!" Understand "duck" as ducking.

The Ducking Action ends here.

Not a useful or interesting extension, but those few words add a whole new action and everything needed to make it work. It is Inform's ability to mix up rooms, things, kinds, grammar, phrases and rules, in more or less any order, which makes it possible for extensions to work.

The introductory sentence must be placed as the only content of line 1 of the file, which must not contain comments, and has to be written in exactly the correct form. Inform checks this very carefully when performing its census of installed extensions, on each translation of the text. (In case the extension's title is a plural, we are allowed to write "begin" and "end" instead of "begins" and "ends". For instance, the last line of the standard rules is "The Standard Rules end here.")

The "one convention" mentioned above is that if a double-quoted text is placed immediately after the beginning sentence (and with no intervening comments), then it is taken to be a short description of the extension's content called the "rubric". Hence the line:

"An action for ducking one's head."

Providing a rubric is helpful, because it enables Inform to give a meaningful listing even for an as-yet unused and unindexed extension, and because it helps the Inform website to produce better directories. Note the word "short": such text is likely to be truncated if it exceeds 500 characters.

A second double-quoted text can also, optionally, be added in yet a third special starting paragraph. This is to provide additional credits to people who have contributed to this or earlier versions. For instance:

The Ducking Action by Beatrix Potter begins here.
 
"An action for ducking one's head."
 
"based on original Inform 6 code by Marc Canard"

Note the typical style here: it's a phrase rather than a sentence, and neither starts with an upper-case letter nor ends with a full stop. (The additional credit is then used in documentation and also in the VERSION text of any Inform story file using the extension.)

Example

448.

Modern Conveniences ★★

Exemplifying the kind of source we might use in writing extensions for kitchen and bathroom appliances.

RB 8.5 Kitchen and Bathroom

🔗

WI §27.6 Version numbering

As we have seen, extensions are referred to by name and author, but they can also (optionally) be referred to by version. For instance:

Include version 2 of the Ducking Action by Beatrix Potter.
 
Version 1.2.4 of the Ducking Action by Beatrix Potter begins here.

Version numbers should consist of one to three whole numbers divided by dots, with no negative numbers allowed. Thus "5", "3.3" and "2.1.71652" are all valid as version numbers, but "-4" and "3.1.2.5" are not. Any numbers not specified are taken to be 0: thus "3.3" means the same as "3.3.0", and "5" means the same as "5.0.0".

In versions of Inform before 2022, versions of extensions were also allowed to be written in the form "N/YYMMDD", as in this example:

Version 6/040426 of the Ducking Action by Beatrix Potter begins here.

The material after the slash '/' was expected to be a date, so that 040426 would mean 26 April 2004. In order to preserve compatibility with old extensions, Inform continues to allow this notation, but treats it as equivalent to writing "N.0.YYMMDD", though with any leading 0s trimmed. So the above sentence is equivalent to writing:

Version 6.0.40426 of the Ducking Action by Beatrix Potter begins here.

Extensions are usually intended to be shared and passed around between Inform users, and good use of version numbering can be a huge help to those users; and it's helpful if we can agree as a community on what good version-numbering is. Because of that, the Inform project tries to use a widely-recognised Internet standard called "semantic version numbering".

For full details see semver.org, but for Inform purposes the following fairly simple rules should be enough. "Semantic" just means that version number changes should communicate something meaningful. So, whenever an extension author puts out a new version of an extension, the extension number should change in a way that signals how drastic the change will be.

In this system, the three possible numbers X.Y.Z are called the "major", "minor" and "patch" numbers. Every time an extension is changed and re-released, even just informally among friends but certainly if posted somewhere on the Internet, X, Y or Z should change. The rules are:

(X) If the extension has changed so much that Inform projects using it will need to be changed in order to keep on working - for example, if a "To…" phrase has been taken out, or the name of a kind changed - then X should be increased. Y and Z then usually go back to 0. This is a "major version".

(Y) If the extension provides new features but doesn't do anything to change the way its existing features are used, then X can stay the same but Y should increase, and Z then usually rolls around to 0. This is a "minor version".

(Z) If the extension has changed only to fix bugs, or make its existing features work more efficiently, or provide better documentation or examples, then X and Y can stay the same but Z should increase. This is a "patch version".

So, for example, a user who currently has version 3.2.7 can update to 3.2.8 without really investigating. That same user can update to 3.3, 3.4, … without any trouble, choosing either to use or ignore whatever new features they are presenting. But the user knows that moving up to version 4 might well require some work - a project using version 3.Y.Z will likely need writing to adopt version 4.

Now let's turn to "Include" sentences. A request like:

Include the Ducking Action by Beatrix Potter.

will be happy with any version of the extension at all, whether numbered or not; but

Include version 2.4 of the Ducking Action by Beatrix Potter.

will only accept the extension if its version number is "compatible" with 2.4, which means, if it is 2.4 or later, but still belongs to the same major version, "2". So if we write this inclusion sentence, but the version we have installed is version 3.1, Inform will give a problem message. The fix may well be as simple as changing the inclusion sentence to match - but it may not, because a change in major version number is a signal that things have changed a lot inside the extension (see above).

During play of any story compiled by Inform 7, typing VERSION lists various serial numbers of the pieces of software used to make it. The list concludes with names, authors and version numbers of any extensions used. So every author whose work contributes to a story automatically gets a modest credit within it. The same list can be printed, at the discretion of the designer, using the textual substitution:

say "[the/-- list of extension credits]"

This text substitution expands to one or more lines of text crediting each of the extensions used by the current source text, along with their version numbers and authors. Extensions whose authors have chosen the "use authorial modesty" option are missed out.

If we want our extension to go uncredited - perhaps if it is a low-level enabling sort of thing, for instance - we can place the following sentence inside the definition of the extension:

Use authorial modesty.

The same sentence placed in the body of a source text causes all extensions by the same author as the main source text to go uncredited. In other words, if Isaac Miggins writes a source text and includes, say, Unlikely Events by Isaac Miggins, then this extension will go uncredited in the VERSION command.

A complete list, undiluted by modesty, can always be obtained using:

say "[the/-- complete list of extension credits]"

This text substitution expands to one or more lines of text crediting each of the extensions used by the current source text, along with their version numbers and authors. Every extension is included, even those whose authors have opted for "use authorial modesty".

🔗

WI §27.7 Extensions and story file formats

Inform compiles to several different story file formats, and in each case uses only a small part of their abilities - especially when it comes to fancy tricks with the keyboard or screen. So people may well want to write extensions which provide access to some of these tricks (like "Basic Screen Effects", included in the standard Inform distribution, but more so). Unfortunately, these tricks are very likely to fail to compile - or fail to work - on some of the possible story file formats, so the resulting extension would probably go wrong (and mysteriously wrong) for users who have chosen a different format.

Inform therefore provides a way for extensions to declare the formats they are compatible with. All that is required is to add a proviso in brackets after the title is declared:

Version 2 of Basic Screen Effects (for Z-Machine version 8 only) by Emily Short begins here.

Other examples might be "(for Glulx only)", or "(for Z-machine only)". If no such proviso is given, the extension is assumed to be compatible with every story file format.

Extensions are also able to include material which is only used on some story file formats and not others - in principle, this might allow the same facilities to be provided to the author whatever story file format is used, but to achieve these effects differently depending on the current Settings. The convention here is exactly like "not for release": if a heading or subheading in the source text contains a bracketed proviso, then the material under that heading (and under its dependent subheadings) will be ignored if the current story file format does not match. For example:

Section 2.3G (for Glulx only)
 
To reveal the explosion:
   [...the Glulx way...]
 
Section 2.3Z (for Z-machine only)
 
To reveal the explosion:
   [...the Z-machine way...]

would ensure that "reveal the explosion" works nicely whichever story file format is used.

Example

449.

Tilt 3 ★★

Displaying the card suits from our deck of cards with red and black colored unicode symbols.

RB 12.1 Typography

🔗

WI §27.8 Extensions can include other extensions

Extensions can themselves contain "Include…" sentences asking for other extensions to be included. An extension might, for example, start like this:

Version 1 of Basic Help Menu by Emily Short begins here.
 
Include Menus by Emily Short.
 
...

A project which asks to include "Basic Help Menu" will then also include "Menus", even though the author might never even realise that. Indeed, the author could also have asked to include "Menus", not realising that "Basic Help Menu" was going to ask for the same thing.

So the same extension is often requested multiple times. This is fine if the version numbers in the requests are compatible, but they might not be. For instance, suppose the main source text asks to include version 2 of extension X, and also to include extension Y. Suppose further that Y contains a request to include version 4 of X. We now have two different requests for X, and they contradict each other - the major version of X cannot be both 2 and 4 at the same time. So Inform will produce a problem message in this case.

But in cases where it is possible for everyone to be satisfied, Inform will try to find a solution. If one extension asks for version 2.3 of X, and another asks just for X, and a third asks for version 2.7.2 of X, then Inform will work out that any version number in the range 2.7.2 up to (but not including) 3 will be fine. If it can in fact find such an extension, it will then use it. So if the user has version 2.8.17 installed, everything is fine.

If an extension does include other extensions, it is good style to place the "Include…" sentence(s) as early as possible after the introductory sentence, just so that human readers looking at the text of the extension can see these dependencies easily.

🔗

WI §27.9 Extensions can interact with other extensions

When one extension is being used, it's probably only one among several. A really general-purpose extension might want to behave differently depending on which other extensions are also present. This can be achieved using headings which are "for use with" (or "without") other extensions. For instance:

Chapter 2a (for use with Locksmith by Emily Short)

specifies that everything under this heading (and its subheadings, if any) will be ignored unless the extension Locksmith by Emily Short is included. Conversely,

Chapter 2b (for use without Locksmith by Emily Short)

will be ignored unless it isn't included. This allows an extension to give two variations on the same material - one if Locksmith is present, the other if not.

Headings can also replace portions of extensions which have been included. For instance:

Section 6 - Hacked locking (in place of Section 1 - Regular locking in Locksmith by Emily Short)

places the source text under the new heading in the place of the old (which is thrown away). If there should be two or more headings of the same name in the given extension, the first is the one replaced; if two or more headings attempt to replace the same heading in the given extension, the final attempt in source text order is the one which succeeds; and finally, heading dependencies like the above are scanned in a top-down way. Thus, if we have:

Chapter 2a (for use with Locksmith by Emily Short)
...
Section 1 - Hacked marbles (in place of Section 4 in Marbles by Peter Wong)
...

and we don't include Locksmith, then the replacement of Section 4 of Marbles is not made, because Section 1 - Hacked marbles is subordinate to the Chapter 2a heading which we've told Inform to ignore.

If the name of the heading to replace contains the word "in", it's a good idea to use quotation marks for clarity:

Section - Hacked questions (in place of "Section 4 - Phrase used to ask questions in closed mode" in Questions by Michael Callaghan)

🔗

WI §27.10 Extensions in the Index

As soon as a project has successfully been translated, its Index is brought up to date: pages of the index record all the kinds and what they are for, all the phrases which can be used, and so on. Any kind or phrase created in an extension is automatically included. The extension's presence in the project is itself recorded - the Contents index for any project contains a brief list of all extensions used in that project, along with their authors and version numbers.

The Kinds index aims to give the reader a brief note of what each kind is intended for. We can provide for this by writing a sentence like so:

The specification of player's holdall is "Represents a container which the player can carry around as a sort of rucksack, into which spare items are automatically stowed away."

There is no need to specify the properties which apply: that is all done automatically. "Specification" is a sort of pseudo-property used just for this: we can also give specifications to kinds of value and to actions, and these are similarly used in the Index pages.

Every extension has the right to its own set of headings and subheadings, independently of those used by the main source for the work or by any other extension which may be included. (So if the extension is divided into four sections and finishes on Section D, say, that doesn't mean that Section D will continue outside the extension as the main source of the story runs on.)

Extensions should, of course, be written so that they never produce Problem messages, so at first sight it appears that these headings will never be outwardly visible. In fact, though, Problems do occasionally turn up in extensions, usually when the user has made a mistake, or when two inconsistent extensions are used in the same project. But more importantly, the headings in an extension are used when indexing phrases (and also actions) to group similar phrases together. For instance, the Standard Rules contain the heading:

Section SR4/7 - Searching and sorting tables

The half-dozen phrases defined in this section of the Standard Rules are then indexed under the subheading "Searching and sorting tables": Inform looks for a hyphen in the heading and then uses any text which follows the hyphen. (If there is no hyphen, the entire heading text is used.)

If an extension contains no headings, its phrases (or actions) are indexed simply as "Miscellaneous".

Finally, any phrase or variable defined immediately under a heading whose name ends in the word "unindexed" will be omitted from the Phrasebook or Contents index respectively. (That won't apply to definitions under subheadings of the heading.) This is intended so that technical apparatus used only inside the extensions can be concealed from the outside user's immediate view. Inform as it is presently constituted does not allow extensions to make fully private definitions, but this feature at least allows them to make unadvertised ones.

🔗

WI §27.11 Extension documentation

A basic mechanism for documenting extensions is built into Inform. For many extensions, this will probably do instead of a manual; for more complex ones, it should still prove a useful supplement to one.

As described in Chapter 2 above, whenever an extension is installed, its documentation is made available to the user. Such text should be written concisely, while giving examples wherever appropriate. Stylistically, it should ideally follow the model of the main Inform documentation: just as an extension expands the standard rules, so its documentation expands this manual. "We need…" is preferred to "You need…", and so on: we're all in this together.

In order to be recognised as documentation, this text should appear at the foot of the extension file, after the compulsory end sentence. The first paragraph must have exactly the following form, with a skipped line before and after:

---- DOCUMENTATION ----

For instance, the "Ducking Action" example might end:

...
The Ducking Action ends here.
 
---- DOCUMENTATION ----
 
This is a modest extension, with much to be modest about. It allows us to use a new action for ducking, as in ducking the player's head (not as in ducking a witch). Ducking will do nothing unless rules are added:
 
   Instead of ducking in the Shooting Gallery, say "Too late!"
 
...

We obtain indented code examples by beginning a line with a tab. A double indentation can be got with two tabs in a row, and so forth. (Beware: some text editors, or emailers, flatten tabs into a row of four or perhaps eight spaces each. Inform will not recognise such a line of spaces as a tab.)

Note that text in square brackets should be avoided in the documentation, because that's taken as being comment matter on the extension, and omitted.

Tables should be similarly indented, and should begin with the word "Table …": the top line is taken to be the name of the table, and subsequent lines are tab-divided columns. Inform will automatically group this into a table, like so:

Table of Exemplariness

stellar objectexample
galaxy"Andromeda Galaxy M31"
star"Sirius"
planet"Neptune"
moon"Enceladus"
dwarf planet"Ceres"
plutino"38628 Huya"
cubewano"Easterbunny"

(Footnote: Since the first appearance of this book, Easterbunny has been renamed Makemake, the creator god in the mythology of the people of Easter Island.)

🔗

WI §27.12 Examples and headings in extension documentation

Extensions with very large amounts of documentation can, if the author chooses, divide the material up using headings and/or subheadings. These must be written as paragraphs exactly like so:

Chapter: Avoiding Events
 
Section: Ducking examinations and tests

Inform will then typeset them to stand out, will number them automatically, and will add a table of contents at the top of the page. (For most extensions, the documentation will be short and sweet, and this would just be clutter: headings and subheadings are best used only where the text would otherwise be difficult to read.)

Any extension's documentation can contain Examples, just as the main Inform documentation does: these are automatically labelled A, B, C, … rather than given numbers, to ensure that they do not clash with the numbering used in the built-in chapters. (The labels may be helpful in writing an extension's documentation: we can write, for instance, a note such as "see Example C below".)

Examples must be given last in the documentation, and there can be up to 26 of them, though most extensions will need one example at the most, and some will have none at all. Each example must begin with a paragraph exactly like so:

Example: ** We Must Perform a Quirkafleeg - Ducking to avoid arrows as one proceeds east across battlements.

Again, there must be a skipped line before and after. The row of asterisks must be *, **, *** or ****, just as in the main documentation, which we should follow on all points of style. The rest of the line contains the title, a hyphen, and then the description. The title should be given with Each Word except Prepositions and Similar Things Capitalized, while the description should look like a sentence, and end with a full stop.

The text of the example follows, of course, and continues until the end of the file, or the next "Example:" line, whichever comes first.

Each example should (normally) contain one single, complete, story, long enough to demonstrate the use of the extension and to have a little flavour to it, but not so long that the reader gets lost. It should have a title, which should match the name of the example (in the case above, "We Must Perform a Quirkafleeg"). It should conclude with a paragraph defining a test:

Test me with "east / duck / east / jump / east / duck / east / rescue esmerelda".

The idea is that typing one single command, TEST ME, into the resulting story should show off what the extension does.

When an extension contains more than one example, they should be given in order of asterisk rating, that is, starting with the * examples, then the ** examples, and so on up.

Extension documentation can provide "paste" buttons, much like the examples in this book. For example:

Here is a sample -
 
   *: "Coriander"
 
   Include Herbs by Charlotte Quirke.
 
   The Herb Marketing Centre is a room.
 
If we want to add some content -
 
   The coriander is a herb. Understand "cilantro" as the coriander.

Note that the paste button, denoted "*:", pastes in the text following it, but only as far as the next paragraph of unindented documentation - here, the one beginning "If we…". (But of course, an extension can have multiple paste buttons if desired.)

🔗

WI §27.13 Implications

Extensions often need to define new kinds or properties, which we want to make as helpful as possible for the user. In particular, we want them not to require additional work for the author just to obtain the effect which seems only natural.

For example, consider Inform's built-in "locked" property. If a door is locked, then it cannot be opened, which seems fair enough. But if the player tries to unlock the door, he might then find the following response:

That doesn't seem to be something you can unlock.

Which does not seem right. In real life, almost all locked items have outwardly exposed locks which it is perfectly sensible to try to unlock, given a key. The problem is that our door has the "locked" property, but not the "lockable" one.

The Standard Rules solve this problem by including the following line:

Something locked is usually lockable.

This ensures that any door said by the author only to be "locked" will be "lockable" as well, and adds a small but worthwhile touch of realism.

Such a sentence is called an "implication", as it is in the form "Condition A implies Condition B". Note that the two conditions must consist of either/or properties with or without kinds attached. Thus:

A room in the Open Desert is usually lighted.

will not work because "a room in the Open Desert" is a more complicated grammatical construction than, say, "lighted" or "a lighted room": it contains a relative clause. Inform can only deal with simple implications.

Inform never overrides certainties with mere implications, and is cautious about allowing them to build overly long chains of argument. This is to prevent the following kind of difficulty:

An open door is usually closed. A closed door is usually open.

Implications work just the same for values which aren't objects, so:

Colour is a kind of value. The colours are red, green and blue.
A colour can be zesty or flat. A colour can be bright or dull.
Red and blue are bright. Blue is flat.
 
A bright colour is usually zesty.

results in red being zesty, but blue and green being flat; blue because the source text explicitly says so (which trumps the "usually"), and green because this isn't a bright colour, so the implication doesn't arise.

Implications have not been mentioned up to now since they are only really needed by extensions, but also because they can be tricky, with unforeseen consequences. We should handle them with care.

🔗

WI §27.14 Using Inform 6 within Inform 7

The current Inform, "Inform 7", had a low-level precursor unsurprisingly called Inform, which ran through versions 1 to 6. What made Inform 6 low-level was that its style of coding was much more like traditional programming: it reads as a simple form of C, or an elaborate form of assembly-language, but with some interactive fiction tweaks.

That language is still used inside today's Inform project as a way to express very low-level operations. What happens to code like that is now very different (it is compiled into Inter, an intermediate-level representation used inside Inform, and no longer by the Inform 6 compiler). But the notation is the same, and the practical effect is that it is as if we are writing i6 code.

The final sections of this chapter show how such i6 code can be mixed directly in with natural-language source text. The remaining pages will therefore make little or no sense to those who do not already know i6 notation, and in any case, such programming is really a last resort - it is always best to write regular source text than to resort to so-called "inclusions" of i6. Ideally, all i6 content would be confined to extensions (and this may be mandated in future releases of Inform), and even writers of extensions are asked to pare down their usage of i6 to the minimum necessary.

The methods for incorporating i6 code into i7 have been designed with this in mind, that is, to encourage people to use i6 in as self-contained a way as possible: in particular to isolate the relatively few functions which need to be written in i6, and to give them natural language expression.

Finally, anyone hacking with i7 for a while is likely to become curious about the Basic Inform or Standard Rules extensions, and to look at the text which sets up the Inform language and world model. These extensions are, of course, no secret, but can be misleading to read. For one thing, they appear to have great freedom to set up the world model as it pleases, but in fact the i7 compiler may well crash unless certain things are done just so in the Standard Rules: they depend on each other.

Moreover, the Basic Inform and Standard Rules extensions use a number of syntaxes which are not documented in this chapter: these are constantly being altered, and it would not be safe to imitate them. Any i6-related syntax which is not documented in this chapter may be removed or changed in effect at any time without warning, for instance in an update of Inform to fix bugs.

🔗

WI §27.15 Defining phrases in Inform 6

The phrases described in this documentation, such as "end the story", are all defined in the Standard Rules, and are for the most part defined not in terms of other i7 phrases but instead reduced to equivalents in i6. For instance:

To end the story: (- deadflag=3; story_complete=false; -).

The notation "(-" and "-)" indicates that what comes in between is i6 code. The minus sign is supposed to be a mnemonic for the decrease from 7 to 6: later we shall use "(+" and "+)" to go back up the other way, from 6 to 7.

When a phrase is defined as containing only a single command, and that command is defined using i6 - as here - it is compiled in-line. This means that the phrase "end the story" will always be translated as "deadflag=3; story_complete=false;", rather than being translated into a call to a suitable function whose only statement is "deadflag=3; story_complete=false;".

This is an easy case since the wording never varies. More typical examples would be:

To say (something - number): (- print {something}; -).
To sort (T - table name) in (TC - table column) order:
   (- TableSort({T}, {TC}, 1); -).

When the braced name of one of the variables in the phrase preamble appears, this is compiled to the corresponding i6 expression at the relevant position in the i6 code. So, for instance,

say the capacity of the basket

might be compiled to

print O17_basket.capacity;

because "{something}" is expanded to "capacity of the basket" (i7 code) and then translated to "O17_basket.capacity" (i6 code), which is then spliced into the original i6 definition "print {something};".

Braces "{" are of course significant in i6. A real brace can be obtained by making the character following it a space, and then i7 will not attempt to read it as a request for substitution.

It's also possible for the pair of characters "-)" to occur in i6 code, for example here:

for (i=3 : i>0 : i--)

and i7 will read the "-)" as terminating the i6; we can get around this with an extra space:

for (i=3 : i>0 : i-- )

Warning: Inform 6 uses a restricted character set, allowing use of most of the accented characters in ISO Latin-1 (those found in a set called ZSCII) but little beyond that. It's therefore hazardous to use any exotic Unicode characters in an inclusion.

Example

450.

Pink or Blue ★★★

Asking the player to select a gender to begin play.

RB 5.2 Traits Determined By the Player

🔗

WI §27.16 Phrases to decide in Inform 6

There are basically three forms of phrase in i7: phrases which do something, but produce no value or opinion as a result; phrases to decide whether or not something is true; and phrases to decide on a value. We have already seen examples of writing the first form in i6:

To say (something - number): (- print {something}; -).

Here the i6 form is required to be i6 routine code in void context, that is, it will normally be one or more statements each of which ends in a semicolon (unless there are braced code blocks present). In this case, we have just one i6 statement, ending in a semicolon.

An example of a phrase to decide whether something is true would be:

To decide whether in darkness: (- (location==thedark) -).

Here the i6 code providing the definition must be a valid i6 condition, and be in round brackets, but there is no semicolon.

Lastly, an example of a phrase to decide on a value:

To decide which number is the hours part of (t - time): (- ({t}/60) -).

Again, this is a value in i6 as well: no semicolon. It is probably safest to place the value in round brackets.

🔗

WI §27.17 Handling phrase options

The Standard Rules use the Inform list-writer with the following definition, which shows how a much more complicated i6 routine can be given a natural-language expression.

To list the contents of (O - an object),

with newlines,

indented,

giving inventory information,

as a sentence,

including contents,

including all contents,

tersely,

giving brief inventory information,

using the definite article,

listing marked items only,

prefacing with is/are,

not listing concealed items,

suppressing all articles

and/or with extra indentation:

(- I7WriteListFrom(child({O}), {phrase options}); -).

This can be used by, say:

list the contents of O, as a sentence, using the definite article

"{phrase options}" is a special substitution: it is a bitmap which assigns the given options one bit each, starting with the least significant bit for the first-mentioned option ("with newlines" above) and going up to the most significant bit for the last ("with extra indentation").

🔗

WI §27.18 Making and testing use options

Use options (see Chapter 2 above) manifest themselves in the i6 code generated by i7 as constants which are either defined, or not. For instance, the "use American dialect" option results in the constant DIALECT_US being defined, a constant which otherwise would not be. Some use options define the constant as a particular value, others simply define it (so that i6 gives this constant the value 0).

New use options can be created as in the following examples, which are found in the Standard Rules:

Use American dialect translates as (- Constant DIALECT_US; -).
Use full-length room descriptions translates as (- Constant I7_LOOKMODE = 2; -).

Most Inform users will not need to test whether a use option is currently set: after all, they will know whether or not their own story uses American dialect. But an extension does not know what use options apply in the story which is using it. An extension which needs to print a list, using its own formatting, might want to know whether "use serial comma" is set. Or it might want to speak differently in American dialect.

To test for American dialect, we should ideally not use i6 to look for the constant DIALECT_US using #ifdef: there is no guarantee that this constant will not be renamed at some point. Instead we can perform the test directly in i7:

if the American dialect option is active, ...

and similarly for all other named use options. The adjectives "active" and "inactive" have the obvious meanings for use options. This means it's possible to describe the current options like so:

say "We're currently using: [list of active use options].";

The result might be, say,

We're currently using: dynamic memory allocation option [8192], maximum text length option [1024], maximum things understood at once option [100], American dialect option and fast route-finding option.

This may be useful for testing purposes.

Use options can also allow the writer to raise certain maximum values. If we write an extension which needs some i6 array, say, and therefore has some limitation - for instance a footnotes presenter which can handle at most 100 footnotes before its array space runs out - it would obviously be cleaner to allow this maximum to be raised. We can set this up like so:

Use maximum presented footnotes of at least 100 translates as (- Constant MAX_PRESENTED_FOOTNOTES = {N}; -).

With such a definition, the number given is the default value, and the i6 source is included whether or not anybody uses the option: the default value being given if nobody does. The text "{N}" is replaced with the value. So the above definition normally results in this being defined:

Constant MAX_PRESENTED_FOOTNOTES = 100;

but if the user writes

Use maximum presented footnotes of at least 350.

then instead the i6 inclusion becomes:

Constant MAX_PRESENTED_FOOTNOTES = 350;

The i6 constant MAX_PRESENTED_FOOTNOTES can then be used as the size of an array, for instance.

Finally, note that it is legal to define the same use option more than once, but only if it has exactly the same meaning each time it is defined. (This is allowed so that multiple extensions all needing the same definition can safely make it, and still be used together.)

🔗

WI §27.19 Longer extracts of Inform 6 code

Whole routines, object and class definitions (or any other directives) can be pasted in wholesale using sentences like so:

Include (-
[ ExtraFunction a b; return a*b; ];
-).

Such inclusions are pasted into the final compiled code at the end of the file, after the i6 grammar has been declared.

In such extracts, we sometimes need to refer to objects, variables or values which can't be described using i6: or rather, which can be described, but we don't know how. To this end, any text in an inclusion written in "(+" and "+)" parentheses is treated as an i7 value, and compiled accordingly, with all type-checking waived for the occasion. For instance:

Include (-
Global my_global = (+ the tartan rucksack +);
-).

Here "the tartan rucksack" is translated into "O18_tartan_rucksack", or something similar: the i6 object created to represent the rucksack. Thus the actual line of code produced is

Global my_global = O18_tartan_rucksack;

The material between "(+" and "+)" is generally treated as a value, and thus compiles to the i6 form of that value. But it could also be a property name, which compiles to the i6 form in question, or a defined adjective, which compiles to the name of the routine to call which tests whether that adjective is true.

Three warnings. The material in "(-" and "-)" is not quite treated as literal. Certain characters cause Inform to react:

1. Beware of accidental "(+" usage - for instance,

Include (-
[ MyCleverLoop i; for (++i; i<10; i++) print i; ];
-).

looks reasonable, but contains "(+" and "+)". Spaces around the first "++" would have been enough to avoid this one; "+)" is only significant where it follows a "(+".

2. Beware of placing an "@" character in the first column, that is, immediately following a new line. (In template code this marks off paragraph divisions.) So for instance,

Include (-
[ Set_Stream ret;
@glk 67 ret;
];
-).

is tripped up by the Glulx assembly language opcode "@glk" because this occurs in column 1. Indenting it with a little space or a tab is enough to avoid the problem.

3. Be careful if you're creating an i6 variable holding initialised i7 text. For example,

Include (-
Global saved_optional_prompt = (+ "!!>" +);
-).

looks as if it will work, but doesn't, for reference-counting reasons we needn't go into; instead you need

Include (-
Array sop_storage --> PACKED_TEXT_STORAGE "!!>";
Global saved_optional_prompt = sop_storage;
-).

But it's far better to avoid initialising text variables from i6 entirely. The same problems arise with constant lists.

It should also be noted that the i6 syntax recognised inside "Include (- … -)" is slightly restricted compared to the full range recognised by the stand-alone Inform 6 compiler. In particular:

1. Only new-style "for" loops with colons in the header are allowed, so that "for (i=0: i<10: i++)" is okay but "for (i=0; i<10; i++)" is not. Moreover, "for" loops cannot contain empty clauses.

2. Local variable names are not allowed to be the same as an i6 statement keyword: for example, "style" and "spaces" are not allowed.

3. The (undocumented) Inform 6 function "indirect()" is not supported. But since "indirect(A)" is equivalent to "A()", which does work, this is no real loss. Similarly, the "glk()" function is not supported: function calls to BasicInformKit should be used instead.

4. Conditional compilation cannot be placed around cases in a "switch" statement.

5. Compile-time constant expression evaluation can be used with arithmetic operations, so "Constant FOO = BAR + 1;" is okay, but not with bitwise or logical operations, so "Constant FOO = (BAR | 1);" does not work.

6. Calculated values cannot occur as assembly-language operands.

7. Calculated values can be used for array extents, but need to be put in brackets. For example:

Include (-
Array unit_captured_text --> (UNIT_CAPTURE_BUFFER_LEN + 1);
-).

Example

451.

Status line with centered text, the hard way ★

A status line which has only the name of the location, centered.

RB 12.2 The Status Line

🔗

WI §27.20 Primitive Inform 6 declarations of rules

By writing a sentence like this:

The underground rule translates into i6 as "UNDERGROUND_R".

we create a new rule, the "underground rule", and also notify Inform that it will have no definition as i7 source text: instead, it will be provided as an i6 routine called "UNDERGROUND_R". We can define this with an Include like so:

Include (-
[ UNDERGROUND_R;
   if (real_location hasnt light) { RulebookSucceeds(); rtrue; }
   rfalse;
];
-).

The rule should return false if it wants to make no decision, but call either RulebookSucceeds or RulebookFails and return true if it does. These routines can optionally take an argument: which will be the return value from the rulebook.

Note that UNDERGROUND_R itself has no arguments. In the case of an action based rulebook, the i6 variables noun, second and actor can be referred to, while for a value based rulebook the parameter is stored in the i6 global variable parameter_object (which is not necessarily an object, in spite of the name).

We can put this rule into a rulebook in the same way that any named rule can be:

The underground rule is listed in the spot danger rules.

🔗

WI §27.21 Inform 6 objects and classes

As might be expected, i7 compiles an i6 class for each kind, and an i6 object for each of its own objects. We can meddle with its compilation process here using a further refinement of Include. For instance, suppose we want the i6 class definition for things to come out containing a property like this:

Class K2_thing ...
   with marmalade_jar_size 6,
   ...

How to arrange this? One way is to create an ordinary i7 property, like so:

A thing has a number called marmalade jar size. The marmalade jar size of a thing is usually 6. The marmalade jar size property translates into i6 as "marmalade_jar_size".

(Without that last sentence, the property won't get any familiar name.) But sometimes we need more, and want to actually write new material to go into the definition. This can be done like so:

Include (- with before [; Go: return 1; ], -) when defining a vehicle.

This glues in a new property to the class compiled to represent the i7 kind "vehicle". (See the DM4 for why. However, since the entire actions machinery is different in the i7 world, note that "after", "react_before" and "react_after" no longer have any effect, and nor does "before" for rooms.)

And similarly:

Include (- has my_funny_attribute, -) when defining the hot air balloon.

If we need a particular i7 object or kind to end up with a particular i6 name, we can write:

The whatsit object translates into i6 as "whatsit".
The thingummy kind translates into i6 as "thingummy_class".

WARNING: The "Include (- … -) when defining …" usage still works for the moment (except in projects compiled to C at the command line, where it may fail), but it is deprecated and likely to be removed in later versions of Inform. Avoid it if at all possible.

🔗

WI §27.22 Inform 6 variables, properties, actions, and attributes

i7's variables are usually compiled as entries in an array rather than as i6 variables. However, we can instead tell Inform to use an existing i6 variable (either one that we declare ourselves, or one in the i6 template layer). For example:

Room description style is a kind of value. The room description styles are Brief, Verbose and Superbrief.
The current room description style is a room description style that varies.
The current room description style variable translates into i6 as "lookmode".

This is a feature provided to help i7 source text to use variables internal to the i6 template code. It can, if really necessary, also be used to give i7 names to entirely new i6-level variables, created like so:

Include (- Global my_variable = 0; -).

This style of hybrid coding is really not encouraged.

i7's properties are compiled sometimes as i6 properties, sometimes as i6 attributes, sometimes as bits in a bitmap somewhere. However, we can override i7 by telling it that one of its property names is equivalent to an already-existing i6 property or attribute: if so then i7 will use that name and will not compile any directive to create it. For example:

The switched on property translates into i6 as "on".
The initial appearance property translates into i6 as "initial".

We do not need to translate "switched off", the opposite to "switched on": i7 will now compile this to "~on".

Lastly, actions can also be translated (though it's usually better to translate their rules instead and invent new i7 actions covering them):

The unlocking it with action translates into i6 as "Unlock".

🔗

WI §27.23 Inform 6 Understand tokens

The parser which deciphers the player's typed commands is written in i6, and many of the basic tokens of Understand grammar are implemented as "general parsing routines" (GPRs), the specification of which is described fully in the Inform 6 Designer's Manual. i7 translates much of the source text's Understand grammar into GPRs, and once again we can bypass this process and supply an Understand token directly as an i6 GPR. For example:

The Understand token squiggle translates into i6 as "SQUIGGLE_TOKEN".

We then have to include a routine of that name into i7's output using the "Include" instruction, on which more later.

This creates a token "[squiggle]"; so for instance if the source text contains:

Understand "copy [squiggle]" as ...

then Inform would parse the command COPY FIGURE EIGHT by calling the SQUIGGLE_TOKEN routine as a GPR with the word marker at 2, that is, at the word FIGURE.

As always, this should be done only where there seems no better way, or where speed is very important. For any fairly simple range of possibilities, it's better to use the techniques in the Understand chapter, or to use unit specifications.

🔗

WI §27.24 Inform 6 adjectives

There are three ways to specify that an adjective is defined at the i6 level. For example:

Definition: a number is prime rather than composite if i6 routine
   "PRIMALITY_TEST" says so (it is greater than 1 and is divisible only by itself and 1).

Inform now actually tests if a number N is prime by calling PRIMALITY_TEST(N), and it assumes that we have also included such a routine in the output. The routine is expected to return true or false accordingly.

The text in brackets does nothing functional, but is the text used in the Lexicon dictionary part of the Phrasebook index for the user's benefit; it should be a brief definition. Extension authors are asked to provide these little definitions, so that their users won't be confused by blank lexicon entries.

The second way makes a more capable adjective, since it can not only be tested, but also made true or false using "now". For example:

Definition: a scene is crucial if i6 routine "SceneCrucial" makes it so
   (it is essential to winning).

The difference here is "makes it so", not "says so", and as this implies, the routine has more power. "SceneCrucial" is called with two arguments: SceneCrucial(S, -1) tests whether the scene is crucial or not and returns true or false; SceneCrucial(S, true) must make it true; and SceneCrucial(S, false) must make it false. Another useful difference is that if the kind of value is one which is stored in block form (e.g. for an adjective applying to text), the routine is given a pointer to the block, not a fresh copy.

A third way to define an adjective, which should be used only if speed is exceptionally important, is to provide a "schema" - a sort of i6 macro, like those provided by the C preprocessor. For example:

Definition: a rulebook is exciting if i6 condition
   "excitement_array-->(*1)==1" says so (it is really wild).

The escape "*1" is expanded to the value on which the adjective is being tested. (This is usually faster than calling a routine, but in case of side-effects, the "*1" should occur only once in the condition, just as with a C macro.) To repeat: if in doubt, use the i6 routine method above.

🔗

WI §27.25 Naming Unicode characters

At one time Inform allowed names to be given to Unicode character values with

sentences like so:

anticlockwise open circle arrow translates into Unicode as 8634.

These sentences now throw problem messages, and instead Inform allows exactly

those names in the Unicode standard.

🔗

WI §27.26 Overriding definitions in kits

When Go is clicked, Inform translates the i7 source text into a large body of so-called "Inter" code: "Inter" is short for "intermediate". Large as this program is, it could not survive on its own: it needs a large body of pre-compiled code, also written in Inter, to sustain it. This additional material is organised in blocks called "kits". Most Inform users never need to know about kits, but for example, a typical Inform project includes kits called BasicInformKit, WorldModelKit and CommandParserKit.

These kits are compiled from what is (nearly) Inform 6-syntax source code, and for the details of that, see the documentation on the low-level tool "inter". While it's absolutely possible for Inform users to create and use their own kits, that's beyond the scope of this book. But what we will cover here is the ability to include just a little extra Inter code - perhaps only a few functions or constants.

In fact, we have seen the necessary syntax already:

Include (- ... -).

puts the given material "…" into the project. For example:

Include (-
   [ ExtraFunction a b; return a*b; ];
-).

adds just a single function called "ExtraFunction".

And this works fine, but if we tried the same trick to create a function called "SquareRoot", for example, then the result would be a problem message - because BasicInformKit also defines a function of the same name. This problem message is useful, because it warns us about accidental name clashes.

But what if the name clash was not an accident at all, and what we actually wanted to give our own definition of "SquareRoot", to be used instead of the one in BasicInformKit? This is also possible:

Include (-
[ SquareRoot num;
   "Nobody cares about square roots, son.";
];
-) replacing "SquareRoot".

And now whenever square roots are calculated, this snarky text will be printed, and the result will always be rather meaningless (since this i6 routine always returns 1). Unless one is very careful, the result of replacing kit definitions can be absolute chaos.

An important historical note: between about 2010 and 2021, kits did not exist, and instead there were "template files" of Inform 6 code which served roughly then same purpose. These had names like "Relations.i6t" or "Mathematics.i6t" and were internally divided into named subsections; and Inform supported syntax like the following:

Include (- ... -) before "Relations.i6t".
Include (- ... -) instead of "Relations.i6t".
Include (- ... -) after "Symmetric One To One Relations" in "Relations.i6t".

to allow new material to be placed at oddball positions in the final code. There is now no need to worry about the placement of code - Inform's final code generator manages things so that code-ordering issues do not arise; as a result, the "before" and "after" options are now unnecessary. For now, Inform ignores these usages, and just disregards the "before…" or "after…" parts. But in some later version of Inform they will begin to cause problem messages, so writers of extensions using these syntaxes should now please remove them.

The "instead of" option now cannot work at all, and throws a problem message. The new way to substitute a fresh definition of something built-in is to use the "replacing" notation described above.

With the demise of the "template layer", as it was called, another form of so-called "template hacking" has gone with it - the special notation:

Include (- {-segment:MyStuff.i6t} -).

to allow a whole extra file of Inform 6 code called "MyStuff.i6t" to be pasted in. The new way to do that is to create a new kit, say MyStuffKit, to hold the material in question. This is not hard to do, but beyond the scope of this book. See the documentation on the low-level Inform tool "inter".

🔗

WI §27.27 Translating the language of play

The "language of play" is the natural language used to communicate with the player at run-time: this is normally English.

That means that it is difficult to write, say, Spanish-language IF using Inform 7, though heroic work by the Spanish IF community has overcome this. Inform 6 provided for translation by isolating its linguistic code in a part of the i6 library called the "language definition file", which was normally "English.h". Translations were gradually made to most major European languages, resulting in alternative language definition files called "French.h", "Italian.h" and so on. Full details on how to write a language definition file were given in the Translations chapter of the DM4, that is, the fourth edition of the Inform 6 Designer's Manual.

In i7 the system is different. We use the template, not a library. Instead of providing a language definition file such as "French.h", a translator should create an extension called something like "French Language by Jacques Mensonge". (The language should be named in English, so "French Language by …", not "Langue français by …") This extension should then contain broadly the same material as an i6 language definition file, but written in a mostly higher-level way. See the extension "English Language by Graham Nelson" supplied with i7, which is included automatically by default.

🔗

WI §27.28 Segmented substitutions

A "segmented" substitution is a syntax where text is placed between two or more different text substitutions. Examples include:

"This hotel is [if the player is female]just awful[otherwise]basic[end if]."
"Annie [one of]dances[or]sulks[or]hangs out at Remo's[at random]."

To create such syntaxes, it is not enough just to define how each expands into i6 code: for one thing we may need to know about the later terms in order to expand the earlier ones, which is normally impossible, and for another thing, the individual text substitutions mean nothing in isolation. For instance, Inform produces a problem if the following is tried:

"The hotel [at random] is on fire."

because "[at random]" is only legal when closing a "[one of] …" construction. But if "[at random]" had been defined as just another text substitution, Inform would not have been able to detect such problems.

Inform therefore allows us to mark text substitutions as being any of three special kinds: beginning, in the middle of, or ending a segmented substitution. There can be any number of alternative forms for each of these three variants. The syntax policed is that

(a) Any usage must lie entirely within a single say or piece of text.
(b) It must begin with exactly one of the substitutions marked as "beginning".
(c) It can contain any number, including none, of the substitutions marked as "continuing" (if there are any).
(d) It must end with exactly one of the substitutions marked as "ending".

A simple example:

To say emphasis on -- beginning say_emphasis_on: (- style underline; -).
To say emphasis off -- ending say_emphasis_on: (- style roman; -).

This creates "[emphasis on]" and "[emphasis off]" such that they can only be used as a pair. The keyword "say_emphasis_on", which must be a valid i6 identifier (and hence a single word), is never seen by the user: it is simply an ID token so that Inform can identify the construction to which these belong. (We recommend that anybody creating such constructions should choose an ID token which consists of the construction's name but with underscores in place of spaces: this means that the namespace for ID tokens will only clash if the primary definitions would have clashed in any case.)

Example

452.

Chanel Version 1 ★

Making paired italic and boldface tags like those used by HTML for web pages.

RB 12.1 Typography

🔗

WI §27.29 Invocation labels, counters and storage

The process of expanding the i6 code which represents a phrase is called "invocation". As we have seen, when a phrase is defined using a single piece of i6 code, invocation consists of copying out that i6 code, except that tokens in braces "{thus}" are replaced:

To say (something - number): (- print {something}; -).

Ordinarily the only token names allowed are those matching up with names in the prototype, as here, but we have already seen one special syntax: "{phrase options}", which expands as a bitmap of the options chosen. And in fact the invocation language is larger still, as a skim through the Standard Rules will show. The notes below deliberately cover only some of its features: those which are likely to remain part of the permanent design of Inform, and which are adaptable to many uses. Please do not use any of the undocumented invocation syntaxes: they change frequently, without notice or even mention in the change log.

The first special syntaxes are textual tricks. {-delete} deletes the most recent character in the i6 expansion of the phrase so far. {-erase} erases the i6 expansion of the phrase so far. {-open-brace} and {-close-brace} produce literal "{" and "}" characters.

The following:

{-counter:NAME}
{-counter-up:NAME}
{-zero-counter:NAME}
{-counter-makes-array:NAME}

create (if one does not already exist) a counter called NAME. This is initially zero, and can be reset back to zero using "{-zero-counter:NAME}", which expands into no text. The token "{-counter:NAME}" expands into the current value of the counter, as a literal decimal number. The token "{-counter-up:NAME}" does the same, but then also increases it by one. Finally, the token "{-counter-makes-array:NAME}" expands to nothing, but tells Inform to create an "-->" array called "I7_ST_NAME" which includes entries from 0 up to the final value of the NAME counter.

This allows each instance in the source text of a given phrase to have both (i) a unique ID number for that invocation, and (ii) its own word of run-time storage, which can allow it to have a state preserved in between times when it is executed. For example:

To say once only -- beginning say_once_only:
   (- {-counter-makes-array:say_once_only}if (I7_ST_say_once_only-->{-counter:say_once_only} == false) {-open-brace} I7_ST_say_once_only-->{-counter-up:say_once_only} = true; -).
To say end once only -- ending say_once_only:
   (- {-close-brace} -).

To complete the tools available for defining a segmented substitution, we need a way for the definition of the head to know about the middle segments and the tail:

When invoking either the head or the tail, {-segment-count} expands to the literal decimal number of pieces of text in between the two, which is always one more than the number of middle segments, since the text comes in between the segments. When invoking any middle segment, {-segment-count} expands to the number of pieces of text so far -- thus it expands to 1 on the first middle segment invoked, 2 on the next, and so on.

Lastly {-final-segment-marker} expands to the i6 identifier which marks the end segment, or to I6_NULL if the end segment has no marker. The idea of markers is to enable the head's definition to know which of a number of choices has been used for the tail, supposing that this is a construction with a variety of legal endings. For example:

To say emphasise -- beginning say_emphasise:
   (- style {-final-segment-marker}; -).
To say with italics -- ending say_emphasise with marker underline:
   (- style roman; -).
To say with fixed space type -- ending say_emphasise with marker fixed:
   (- style roman; -).

The markers used for the tails here are "underline" and "fixed", and when the head is invoked, the marker for its tail is expanded into the argument of i6's "style" statement.

The examples above are all to do with segmented substitutions, which is where they are most useful, but most of the syntaxes above work equally well for ordinary "To…" phrase definitions.

🔗

WI §27.30 To say one of

Many of the invocation syntaxes described in the previous section are used in the definition by the Standard Rules of the "[one of] … [or] … [purely at random]" construction, so it makes a good example of how they can be used.

First, this is a segmented substitution with a single possible beginning ("[one of]"), a single possible middle ("[or]") but a choice of many possible endings. Almost everything is compiled by the invocation of the beginning:

To say one of -- beginning say_one_of (documented at phs_oneof): (-
   {-counter-makes-array:say_one_of}
   {-counter-makes-array:say_one_flag}
   if (I7_ST_say_one_flag-->{-counter:say_one_flag} == false) {
      I7_ST_say_one_of-->{-counter:say_one_of} = {-final-segment-marker}(I7_ST_say_one_of-->{-counter:say_one_of},
{-segment-count});
      I7_ST_say_one_flag-->{-counter:say_one_flag} = true;
   }
   if (say__comp == false) I7_ST_say_one_flag-->{-counter:say_one_flag}{-counter-up:say_one_flag} =
false;
   switch ((I7_ST_say_one_of-->{-counter:say_one_of}{-counter-up:say_one_of})%({-segment-count}+1)-1)
{-open-brace}
      0: -).
To say or -- continuing say_one_of (documented at phs_or):
   (- @nop; {-segment-count}: -).
To say purely at random -- ending say_one_of with marker I7_SOO_PAR (documented at phs_purelyrandom):
   (- {-close-brace} -).

The 3rd invocation of this (say) might compile the following:

I7_ST_say_one_of-->2 = I7_SOO_PAR(I7_ST_say_one_of-->2, 4);
switch((I7_ST_say_one_of-->2)%5 - 1) {
   0: ... first text ...
   1: ... second text ...
   2: ... third text ...
   3: ... fourth text ...
}

First, we notified Inform that it needs to allocate an array (I7_ST_say_one_of) providing storage associated with the counter "say_one_of". This we used to count off individual invocations of "[one of]", so that each would have its own word of storage - for the 3rd invocation, I7_ST_say_one_of-->2. We then call a state-changing routine, in this case I7_SOO_PAR, which is allowed to know the previous state and also the number of options available, and which returns the new state. The state is supposed to be the option chosen last time, but that means that there are not 4, but 5 possibilities: 0 for "there was no last time", then 1 to 4 for the possible outcomes. We reduce the state mod 5 to obtain the decision this time, and subtract 1 because it happens to be convenient to make the switch statement run from 0 to 3 rather than 1 to 4. (The reason we reduce the state mod 5 is to allow the state-changer to squirrel away secret information in the upper bits of the state, if it wants to. Note that subtracting one means that the switch value might be -1, which results in no text being printed: thus if the state-changer chooses 0, it can decide on none of the above.)

In this design, the marker attached to the choice of ending substitution is the name of the i6 state-changer: here is the I7_SOO_PAR routine.

[ I7_SOO_PAR oldval count; if (count <= 1) return count; return random(count); ];

As it happens, this ignores the old value: after all, it is meant to be purely at random, and nothing could be less pure than taking the last outcome into consideration when choosing the next.

Note that the counter say_one_of is advanced in invocation of the head. It might seem that the tidier design, somehow, would be to advance the counter in the invocation of the tails, but this is not a good idea. In general it is not safe to assume that the counter will have the same value when the tail is invoked that it had when the head was invoked, because segmented say constructions can legally be nested in Inform strings. Because of this, it is best to deal with a counter entirely in a single invocation, either of the beginning or the ending.

Because "[one of] … [or] …" is such a useful construction - switching between alternative forms of text, which writers of IF very often do - the above implementation is intentionally left open for new endings to be added, and the examples below show how easily this can be done.

Examples

453.

Blink ★

Making a "by atmosphere" token, allowing us to design our own text variations such as "[one of]normal[or]gloomy[or]scary[by atmosphere]".

RB 2.1 Varying What Is Written

454.

Uncommon Ground ★★

Making a "by viewpoint" token, allowing us to design our own text variations such as "[show to yourself]quaint[to Lolita]thrilling[to everyone else]squalid[end show]" depending on the identity of the player at the moment.

RB 5.6 Viewpoint

§2.

Varying What Is Written

§2.

Varying What Is Read

§2.

Using the Player's Input

🔗

RB §2.1 Varying What Is Written

Before getting to actual recipes, many recipe books begin with intimidating lists of high-end kitchen equipment (carbon-steel pans, a high-temperature range, a Provencal shallot-grater, a set of six pomegranate juicers): fortunately, readers who have downloaded Inform already have the complete kitchen used by the authors. But the other traditional preliminaries, about universal skills such as chopping vegetables, boiling water and measuring quantities, do have an equivalent.

For us, the most basic technique of IF is to craft the text so that it smoothly and elegantly adapts to describe the situation, disguising the machine which is never far beneath the surface. This means using text substitutions so that any response likely to be seen more than once or twice will vary.

M. Melmoth's Duel ★ demonstrates three basic techniques: an ever-changing random variation, a random variation changing only after the player has been absent for a while, and a message tweaked to add an extra comment in one special case. (Random choices can be quite specifically constrained, as Ahem ★ shows in passing.) Fifty Ways to Leave Your Larva ★ and Fifty Times Fifty Ways ★★★ show how a generic message can be given a tweak to make it a better fit for the person it currently talks about. Curare ★ picks out an item carried by the player to work into a message, trying to make an apt rather than random choice. Straw Into Gold ★★★ demonstrates how to have Inform parrot back the player's choice of name for an object.

Another reason to vary messages is to avoid unnatural phrasing. Ballpark ★★★ turns needlessly precise numbers - another computerish trait - into more idiomatic English. (Likewise Numberless ★, though it is really an example demonstrating how to split behaviour into many cases.) Prolegomena ★ shows how to use these vaguer quantifiers any time Inform describes a group of objects (as in "You can see 27 paper clips here.").

Blink ★, a short but demanding example from the extreme end of Writing with Inform, shows how the basic text variation mechanisms of Inform can themselves be extended. Blackout ★ demonstrates text manipulation at a lower level, replacing every letter of a room name with "*" when the player is in darkness.

Inform's included extension Complex Listing allows us more control over the order and presentation of lists of items.

For how to change printed text to upper, lower, sentence, or title casing, see Rocket Man ★.

Examples

71. Fifty Ways to Leave Your Larva ★

We can use these substitutions to put together fairly complicated variations within a single piece of text:

"Fifty Ways to Leave Your Larva"

The Beekeeper's Palace is a room. Wasp is a woman in the palace. Drone is a man in the palace.

Instead of kissing someone:

say "'[denial], [insult]! [boast]!'";

In this context, [denial] is understood to refer to the denial property of the noun -- but we could spell it out with "denial of the noun" if we wanted to.

A person has some text called denial. The denial of a person is usually "Stand back". The denial of Drone is "You forget yourself"
 
A person has some text called  insult. The insult of a person is usually "Grasshopper". The insult of Wasp is "Larva".
 
A person has some text called  boast. The boast of a person is usually "I am ferocious". The boast of Drone is "I have ferocious allies".

And then it would be trivial to insert further rules using these responses:

Instead of attacking someone:
   say "'Get away, [insult]!'"
 
Test me with "kiss wasp / hit wasp / hit drone / kiss drone".

wi 5.13 Making new substitutions
rb 2.1 Varying What Is Written

169. Ahem ★

As we see in the example here, it is possible to use slashed variations in more than one place in a phrase, and to offer a number of separate forms. The main rule of thumb to remember is that value inputs for the phrase should always be separated by some text; so

To do/follow (chosen rule - a rule) exactly/precisely/just/-- (N - a number) time/times:
   ....

would cause a problem when we tried to call it with

follow the throat-clearing rule 2 times.

In general, we probably don't need to make our phrase definitions quite so flexible as this, but it's a good idea to account for "a" vs. "the", and for the possibility of using singular and plural forms, especially when writing extensions or other source to be shared.

"Ahem"

To do/follow (chosen rule - a rule) exactly/precisely/just (N - a number) time/times:

repeat with index running from 1 to N:

follow chosen rule.

This is the throat-clearing rule:

say "'Ahem,' says [a random visible person who is not the player]."

After waiting:

do the throat-clearing rule just one time.

Instead of listening:

follow the throat-clearing rule precisely three times.

Instead of smelling:

follow the throat-clearing rule exactly 2 times.

Chateau Marmont is a room. Tom, Jack, Zsa-Zsa, and Wilma-Faye are people in the Chateau. Zsa-Zsa and Wilma-Faye are women.

Test me with "wait / smell / listen".

wi 11.3 Pattern matching
rb 2.1 Varying What Is Written

174. Numberless ★

"Numberless"

The Rambling Warren is a room.

When play begins:

let N be a random number between 1 and 5;

if N is 1:

say "N is one.";

otherwise if N is 2:

say "N is two.";

otherwise if N is 3:

say "N is three.";

otherwise:

say "N is more than the number of your toes."

The final "otherwise" here will fire only if none of the earlier conditions applies; we could leave it out and print nothing in the case that N is 4 or 5.

The more compact way to do this is to create a list of values that our number could match; in many programming languages this is called a switch statement. For example:

When play begins:
   let Y be a random number between 6 and 10;
   if Y is:
      -- 6: say "Six is the magic number!";
      -- 7: say "The number of the day is seven!";
      -- otherwise: say "Today's magic number is boring."

As a final option, we can use a construction we've seen only briefly before now: a table. The use of tables will be explained more fully in their own chapter, but here we see in brief that we can assign a number of values to one column of a table and then use that table to look up output:

When play begins:
   let X be a random number between 11 and 14;
   if X is a number listed in the Table of Switching, say "[output entry][paragraph break]";
   otherwise say "X is greater than the number of your noses!"
 
Table of Switching

numberoutput
11"X is eleven!"
12"X is twelve!"
13"X is thirteen!"
 
Test me with "z".

As we shall see, things other than text can be stored in tables, so we could also use a table as a way to look up objects or even rules to carry out.

wi 11.8 Otherwise
rb 2.1 Varying What Is Written

178. M. Melmoth's Duel ★

"M. Melmoth's Duel"

Saint-Germain-des-Prés is a room. "Haunt of artists, of the coffee-drinking sort, and of cafés, of the artist-haunted sort, you once again find yourself outside M. Melmoth's hotel. Today [one of]the recently-fallen rain runs down the gutters of the 6th[or]sunlight glints even off the blackened windows of the Abbey[or]crowds of vulgar children play chase around the lampposts[at random], and you long to be indoors."

The Hôtel d'Alsace is inside from Saint-Germain-des-Prés. "Typical. Oscar writes you a letter announcing his own imminent demise - 'My wallpaper and I are fighting a duel to the death. One or other of us has got to go.' - and then you get there and he's out, no doubt procuring paint the colour of absinthe, if he isn't procuring the painter."

Tint is a kind of value. The tints are green, aquamarine and darkish purple.

The wallpaper is fixed in place in the Hôtel. The wallpaper has a tint. "In this light, the wallpaper has a distinctly [tint of the wallpaper] wash. [if the tint of the wallpaper is darkish purple]You particularly dislike purple.[end if]"

Before going to the Hôtel: now the wallpaper is a random tint.

After going from the Hôtel, say "You leave, shaking your head. But within twenty-four hours, you are back, as you always knew you would be."

Test me with "in / out / look / in / out / look".

wi 11.15 Let and temporary variables
rb 2.1 Varying What Is Written

249. Olfactory Settings ★

While this isn't very interesting as IF, it runs through most of the adaptive-text tricks.

"Olfactory Settings"

The Doghouse is a room. "Not so much a place as a state of being."

The player carries a ticket to the opera, some papers, and a bouquet of flowers. The bouquet is ambiguously plural.

Instead of eating something inedible, say "[The noun] [don't] seem likely to agree with [us] at all. [We][']d be wiser to leave [regarding the noun][them] alone."

Instead of touching something: say "[regarding the noun][Those] [are] all prickly."

Instead of smelling something: say "[Our] nose [regarding nothing][are] too weak to get much smell from [regarding the noun][those]."

Instead of smelling the bouquet: say "[regarding the noun][They]['re] lovely."

Instead of tasting something:

say "Whew, [regarding the noun][are] [those] ever nasty!"

Test me with "x ticket / eat it / eat them / touch it / touch them / smell it / smell them / taste it / taste them / x papers / eat it / eat them / touch them / smell them / taste them / x bouquet / eat it / eat them / touch them / smell them / taste them".

wi 14.6 Adapting demonstratives and possessives
rb 2.1 Varying What Is Written

252. Responsive ★

The most straightforward way to alter the response text for something in the standard rules is to select the Index tab, then select Actions, then pick the particular action whose text we'd like to alter. Under action details, there will be icons that look like speech bubbles.

Clicking on the speech bubble will show what the current response text is, and give us an option called "set".

If we click "set", this will automatically paste in the response name that we need to change. We can put this inside a "when play begins" rule in order to make that change take effect from the start of the game, like so:

"Responsive"

An Anonymous B613 Cell is a room. "There isn't much to see in this bare room. What there is, you've already seen sometime in the last twenty years."

When play begins:

now print empty inventory rule response (A) is "[We] [have] absolutely nothing.".

Test me with "i".

wi 14.11 Changing the text of responses
rb 2.1 Varying What Is Written

343. Prolegomena ★

Room descriptions often make the player character out to be a bit of a savant, able to count whole stacks of items at a glance: "You see 27 paper clips here."

We can adjust this behavior to our liking, though, with the printing a number… activity, as follows:

"Prolegomena"

The Editor's Office is a room. The desk is a supporter in the Editor's Office.

A red pencil is a kind of thing. 12 red pencils are on the desk.

A letter is a kind of thing. 12 letters are on the desk. Understand "correspondence" as a letter.

Rule for printing the plural name of a letter:

if the listing group size is greater than 7, say "correspondence";

otherwise say "letters".

Rule for printing a number of something (called the target) when the listing group size is greater than 7:

say "[one of]some [or]various [or]an assortment of [at random]";

carry out the printing the plural name activity with the target.

This general rule can of course be overridden by more specific ones; for instance, if we want to take the opportunity to comment on the viewpoint character's appetite for instruments of correction:

Rule for printing a number of red pencils (called the target) when the listing group size is greater than 10:
   carry out the printing the plural name activity with the target;
   say " in nearly-sufficient quantity".
 
Test me with "get two letters / look / get a pencil / i / get pencil / g / g / look / i / get all / i".

wi 18.12 Printing a number of something
rb 2.1 Varying What Is Written

345. Wesponses ★

If we want to change individual responses to player action, then the best thing to do is to use the response facility to modify those selections, as shown in the chapter on Responses.

However, suppose what we want is to give the parser a speech impediment that slightly alters all of the responses it issues. For this purpose, we might need to do a bit of text replacement…

"Wesponses"

The Office is a room. Barry Kripke is a man in the Office.

The response inhibition is initially false.

Rule for issuing the response text of a response (called R) when response inhibition is false:

now response inhibition is true;

let output be "[text of R]";

now response inhibition is false;

replace the text "r" in output with "w";

replace the text "R" in output with "W";

say "[output]".

Test me with "i / x barry / listen / waffle / jump"

Notice that this doesn't affect the printed names of objects in the room description or other kinds of output text -- only those that are issued by the response mechanism.

It would also not work to try to give our parser a nervous personality by simply adding "Um, " to the beginning of each response, because responses are not guaranteed to be full standalone sentences. For example, we could imagine writing

Rule for issuing the response text of a response (called R) when response inhibition is false:
   now response inhibition is true;
   let output be "Um, [text of R]";
   now response inhibition is false;
   say "[output]".

but here is what the room description would say as a result:

Office
Um, You Um, can see Barry KripkeUm,  here

wi 18.15 Issuing the response text of something
rb 2.1 Varying What Is Written

412. Rocket Man ★

We can now change the case of any text produced by a "to say…" phrase. This is often useful when we would like to make use of a standard say phrase in some new context. Say, for instance, that we would like to "[is-are the list…]" in a context that needs the first letter to be capitalized.

We could write a new say phrase, such as "to say is-are the list of (N - a description of objects) in sentence capitalization"; but there is an easier way, and that is to set a text variable to the output of the to say phrase, and then print that text in the case of our choice.

For example:

"Rocket Man"

Instead of going somewhere from the spaceport when the player carries something:

let N be "[is-are the list of things carried by the player] really suitable gear to take to the moon?" in sentence case;

say "[N][paragraph break]".

The Spaceport is a room. North of the Spaceport is the Rocket Launch Pad. The player carries a stuffed bear, a chocolate cookie, and a book.

The description of the book is "It is entitled [italic type]Why Not To Take [sentence cased inventory] To The Moon[roman type]."

To say sentence cased inventory:

let N be "[a list of things carried by the player]" in title case;

say "[N]".

Test me with "n / x book".

wi 20.4 Upper and lower case letters
rb 2.1 Varying What Is Written

418. Blackout ★

In this example, we want the names of rooms to be asterisked out if the player wanders around without the benefit of a candle. We can do this by treating the room names as text, then replacing every letter:

"Blackout"

Tiny Room is a dark room. Absurdly Long-Named Room is a dark room. It is west of Tiny Room.

The Candle Factory is north of Tiny Room. It contains a beeswax candle. The beeswax candle is lit.

Rule for printing the name of a dark room:

let N be "[location]";

replace the regular expression "\w" in N with "*";

say "[N]".

Test me with "w / look / e / n / get candle / s / w".

Notice that the hyphen in the Absurdly Long-Named Room does not get replaced. We could replace even that, if we liked, with

replace the regular expression "\S" in N with "*";

which would catch every character that is not a space.

wi 20.8 Replacements
rb 2.1 Varying What Is Written

438. Curare ★

"Curare"

A thing has a number called the last use. The last use of a thing is usually 0.

Definition: a thing is old if its last use is 12 or less.

The actual number chosen in this definition is pretty much irrelevant: the main thing is that we want to establish relative values. The lower the "last use" number of an item, the older that item should be understood to be, as we see here:

To decide which thing is cyclically random (collection - a description of objects):
   let choice be the oldest member of the collection;
   now the last use of the choice is the turn count;
   decide on choice.

This phrase will select, from the collection of objects passed to it, the one that has been mentioned least recently. This means that if we consult it repeatedly about the same collection, it will begin to cycle predictably; but if new items are added to the collection, it will mention these first before returning to the previous cycle. Now we can use this:

After taking inventory:
   say "You stare morosely at [the cyclically random thing carried by the player], wondering what you're ever going to find to do with it."

We could have said "You stare morosely at [the oldest thing carried by the player]" here, but doing so would not have set the "last use" property correctly, so we would not get the cycling behavior that we're looking for.

The Evidence Room is a room. Some shelves are scenery supporters in the Evidence Room. A box is a kind of container which is open and not openable. On the shelves is a box.  It contains a deformed bullet and a driver's license.
 
The player carries a steel fish hook, a Chinese passport, a tube of synthetic curare, and an envelope full of Euros.
 
Test me with "i / i / i / i / i / i / get all from box / i / i / i".

wi 22.2 Descriptions as values
rb 2.1 Varying What Is Written

453. Blink ★

Suppose we are writing a game in which the mood of the piece changes, and we would like to have lots of descriptions that vary according to its current state. We might in that case want to create our own "by atmosphere" token, to control text variations, like this:

"Blink"

Atmosphere is a kind of value. The atmospheres are normal, melancholy, and creepy.

The current atmosphere is an atmosphere that varies.

The current atmosphere variable is defined by Inter as "current_atmosphere".

To say by atmosphere -- ending say_one_of with marker I7_SOO_ATM:

(- {-close-brace} -).

Since we're operating within the untyped Inform 6, we can make use of the fact that kinds of value are (internally) just constants, enumerated in the same order in which they were originally defined. In other words, "normal" at the i6 level translates to 1, "melancholy" to 2, and "creepy" to 3; so we can return the value of the current atmosphere, and thereby select option 1, 2, or 3:

Include (-
Global current_atmosphere = 1;
[ I7_SOO_ATM oldval count;
   if (count < current_atmosphere) return count;
   return current_atmosphere; ];
-)

And that concludes the hard part. Now to test that it works:

The Flat is a room. "A small [one of]but cozy[or]depressing[or]imprisoning[by atmosphere] flat. Outside the window, the sun is [one of][or][or]apparently [by atmosphere]shining and there is a brisk breeze through the leaves of the birch trees. [one of]It would be quite nice weather for a walk[or]The rest of the world apparently has no appreciation of what you suffer[or]It all looks deceptively normal[by atmosphere]."
 
Instead of waiting when the current atmosphere is normal:
   say "Everything stretches wide and flat for just a moment, as though all the world around you were painted on a thin rubber sheet that is being [italic type]stretched[roman type]. Then it snaps back into place, leaving your ears ringing. But that little glitch was enough to warn you. Someone is tampering with space-time again. Someone very close by.";
   now the current atmosphere is creepy.
 
Test me with "look / z / look".

wi 27.30 To say one of
rb 2.1 Varying What Is Written

245. Fun with Participles ★★

Mostly the Standard Rules use verbs adapted to finite forms ("he jumped", "we take the hammer", and so on). But Inform can also produce participles to describe actions that are ongoing: "he is carrying the fedora" or "taking the hammer…"

In this example, we give non-player characters actions to perform and then have Inform dynamically describe what they're doing when the player chooses to look.

We start by establishing the idea that a verb can describe a particular action:

"Fun with Participles"

Section 1 - Descriptive Functionality

Describing relates various verbs to various action names. The verb to describe means the describing relation.

To look around is a verb. The verb look around describes the looking action.

To stand about is a verb. The verb stand about describes the waiting action. To look bored is a verb. The verb look bored describes the waiting action. To waste time is a verb. The verb waste time describes the waiting action.

To jump is a verb. To leap is a verb. To pirouette is a verb. The verb jump describes the jumping action. The verb leap describes the jumping action. The verb pirouette describes the jumping action.

Now we need to give every character some sort of idle activity. By default, we'll have people just be waiting, but allow for that idle activity to change into something more interesting if the player has told them to do something else.

A person has an action name called the current idle. The current idle of a person is usually the waiting action.
 
Rule for writing a paragraph about someone  (called chosen person) when a verb describes the current idle of the chosen person:
   say "[The chosen person] [are] here, [present participle of a random verb that describes (the current idle of the chosen person)]."
 
Instead of someone doing something:
   now the current idle of the person asked is (the action name part of the current action);
   continue the action.
 
A persuasion rule:
   persuasion succeeds.
 
Section 2 - Scenario
 
Lab is a room. The fedora is a wearable thing in the Lab. Clark is a man in the Lab.

And just to give past participles a test-drive as well, let's make Clark a bit of a drama king:

After Clark doing something when a verb describes (the action name part of the current action):
   say "'Fine, have it your way!' Clark exclaims. 'But I have [past participle of a random verb that describes (the action name part of the current action)] for the last time!'";
   rule succeeds.
 
Test me with "look / Clark, jump / look / Clark, look / look / Clark, wait".

wi 14.3 More on adapting verbs
rb 2.1 Varying What Is Written

246. Variety ★★

Verbs can be related to other things by relations. We've seen that it's possible for a verb to "mean" a relationship. But we can also create a relation between verbs and actions. For instance, we can tell Inform that "take", "get", and "acquire" are all valid ways to describe the action of taking, and then allow it to pick a verb randomly to describe whatever action just occurred.

"Variety"

Section 1 - Descriptive Functionality

Describing relates various verbs to various action names. The verb to describe means the describing relation.

To take is a verb. To acquire is a verb. To get is a verb.

The verb take describes the taking action. The verb acquire describes the taking action. The verb get describes the taking action.

To drop is a verb. To put down is a verb. To discard is a verb. The verb drop describes the dropping action. The verb put down describes the dropping action. The verb discard describes the dropping action.

To sniff is a verb. To smell is a verb. The verb sniff describes the smelling action. The verb smell describes the smelling action.

To jump is a verb. To leap is a verb. To pirouette is a verb. The verb jump describes the jumping action. The verb leap describes the jumping action. The verb pirouette describes the jumping action.

After an actor doing something when the noun is nothing and a verb describes (the action name part of the current action) (this is the apply random verbs to describing nounless actions rule):

say "[The actor] [verb rendering applied to a random verb that describes (the action name part of the current action)].";

rule succeeds.

After an actor doing something to something when a verb describes (the action name part of the current action) (this is the apply random verbs to describing actions rule):

say "[The actor] [verb rendering applied to a random verb that describes (the action name part of the current action)] [the noun].";

rule succeeds.

To decide which text is the rendering of (V - verb) (this is verb rendering):

decide on "[adapt V]".

Section 2 - Scenario

Lab is a room. The table is here. The bat and the ball are on the table.

Test me with "get ball / drop ball / get bat / drop bat / smell ball".

wi 14.3 More on adapting verbs
rb 2.1 Varying What Is Written

247. Variety 2 ★★

Some of our default actions establish relations between items in the world, and reporting on the relation ("You are now carrying the fedora") can be a valid response alongside reporting on the action itself ("You take the fedora").

To do this, we need to teach Inform explicitly which relations are the results of actions, then check this when reporting on actions:

"Variety 2"

Section 1 - Descriptive Functionality

Describing relates various verbs to various action names. The verb to describe means the describing relation.

Table of Action Results

related action	relation
the taking action	the carrying relation
the wearing action	the wearing relation
the taking off action	the carrying relation

To take is a verb. To acquire is a verb. To get is a verb.

The verb take describes the taking action. The verb acquire describes the taking action. The verb get describes the taking action.

To sniff is a verb. To smell is a verb. The verb sniff describes the smelling action. The verb smell describes the smelling action.

To jump is a verb. To leap is a verb. To pirouette is a verb. The verb jump describes the jumping action. The verb leap describes the jumping action. The verb pirouette describes the jumping action.

To don is a verb. The verb don describes the wearing action.

To doff is a verb. The verb doff describes the taking off action.

After an actor doing something when the noun is nothing and a verb describes (the action name part of the current action) (this is the apply random verbs to describing nounless actions rule):

say "[The actor] [verb rendering applied to a random verb that describes (the action name part of the current action)].";

rule succeeds.

After an actor doing something to something when a verb describes (the action name part of the current action) (this is the apply random verbs to describing actions rule):

let current action name be the action name part of the current action;

if a random chance of 1 in 2 succeeds and the current action name is a related action listed in the Table of Action Results:

choose a row with the related action of current action name in the Table of Action Results;

let R be the relation entry;

let subject be the actor;

let chosen object be the noun;

say "[The subject] [are] now [present participle of a random verb that means R] [the chosen object].";

else:

say "[The actor] [verb rendering applied to a random verb that describes (the action name part of the current action)] [the noun].";

rule succeeds.

To decide which text is the rendering of (V - verb) (this is verb rendering):

decide on "[adapt V]".

To say infinitive of (V - a verb): (- {V}(1); -).

To say past participle of (V - a verb): (- {V}(2); -).

To say present participle of (V - a verb): (- {V}(3); -).

Section 2 - Scenario

Lab is a room. The fedora is a wearable thing in the Lab.

Test me with "wear the fedora / take off the fedora / wear fedora / take off fedora".

wi 14.3 More on adapting verbs
rb 2.1 Varying What Is Written

250. History Lab ★★

The examples Variety and Narrative Register show how verbs can be associated with particular actions. Here, we use the same principle so that we can report to the player what was last done to a particular object, either by the player or by someone else.

To do this, we need to use the idea of stored actions from the Advanced Actions chapter.

"History Lab"

Section 1 - Procedure

An object has an action called the last action.

Describing relates various verbs to various action names. The verb to describe means the describing relation.

To take is a verb. The verb take describes the taking action.

To drop is a verb. The verb drop describes the dropping action.

To look at is a verb. The verb look at describes the examining action.

To examine is a verb. The verb examine describes the examining action.

After an actor doing something to something:

if a verb describes the action name part of the current action:

now the indefinite article of the noun is "the";

now the last action of the noun is the current action;

continue the action.

After printing the name of something (called item):

if the last action of the item is not waiting and the last action of the item is not the current action:

let chosen action-name be the action name part of the last action of the item;

let chosen actor be the actor part of the the last action of the item;

if a verb describes the chosen action-name:

let the chosen verb be a random verb that describes the chosen action-name;

say " [if the chosen actor is the player][we][else][chosen actor][end if] [adapt chosen verb in past tense]";

Section 2 - Scenario

Lab is a room. It contains a box. The box contains a newspaper. Clark is a man in the Lab.

A persuasion rule:

persuasion succeeds.

Test me with "x box / look / x newspaper / look / clark, x newspaper / clark, get box / clark, drop box / look / take box / i / smell box / i".

Notice that smelling the box does not change the box's description because we haven't gotten around to defining a smell or sniff verb.

wi 14.9 Verbs as values
rb 2.1 Varying What Is Written

251. Relevant Relations ★★

Suppose that we wanted authors to be able to indicate which relations should or should not be included in room descriptions, and have the system dynamically honor that instruction.

Inform already knows about verbs for describing supporting, containment, carrying, and wearing, so we could write a set of instructions to handle such cases. To do this, we're using the "writing a paragraph about" activity, which is described in the chapter on activities.

The following uses what is, strictly speaking, a piece of internal machinery not really intended for public use: a variable called "prior named object" which keeps track of what noun other words should agree with. It is not safe to use this variable except to clear it: "now the prior named object is nothing". In a few situations, this prevents glitches in adaptive text.

"Relevant Relations"

Section 1 - Procedure

Rule for writing a paragraph about something (called item):

now the current paragraph is { };

say "[one of][regarding item]There [are] [an item] here[or][We] [can see] [an item] here[at random]. [run paragraph on]";

follow the descriptive rules for the item;

repeat with new item running through the current paragraph:

now the prior named object is nothing;

if new item is not the item:

follow the descriptive rules for the new item;

say paragraph break.

Rule for writing a paragraph about someone (called chosen person):

now the current paragraph is { };

say "[one of][regarding chosen person][The chosen person] [are] here[or][We] [can see] [a chosen person] here[at random]. [run paragraph on]";

follow the descriptive rules for the chosen person;

repeat with new item running through the current paragraph:

now the prior named object is nothing;

if new item is not the chosen person:

follow the descriptive rules for the new item;

say paragraph break.

The descriptive rules are an object-based rulebook.

Definition: a container is see-through:

if it is transparent:

yes;

if it is open:

yes;

no.

A descriptive rule for a see-through container (called item) (this is the describe contents rule):

describe the containment relation for item.

A descriptive rule for a supporter (called item):

describe the support relation for item.

A descriptive rule for a person (called item):

describe the wearing relation for the item.

A descriptive rule for a person (called item):

describe the carrying relation for the item.

The current paragraph is a list of things that varies.

Before printing the name of something (called mentioned target) while writing a paragraph about something:

add the mentioned target to the current paragraph, if absent.

To describe (R - a relation of objects) for (item - a thing):

if a thing to which item relates by R is a thing:

say "[The item with pronoun] [verb rendering applied to a random verb that means R] [the list of things to which item relates by R with indefinite articles]. [run paragraph on]"

To decide which text is the rendering of (V - verb) (this is verb rendering):

decide on "[adapt V]".

To say (T - a thing) with pronoun:

if T is the prior named object:

say "[regarding T][They]";

else:

say "[The T]"

Section 2 - Scenario

The Space Elevator is a room. "Mercifully, there aren't any windows. The ability to see how far up you are would almost certainly make you ill."

The luggage rack is a supporter in the Space Elevator. The suitcase is a closed openable container on the luggage rack. The bouquet is on the luggage rack.

Clark is a man in the Space Elevator. Clark is carrying a box of cupcakes. Clark is wearing a t-shirt. The description of the box of cupcakes is "They're the latest confection from Red Velvet Planet, the Martian bakery."

Persuasion rule: persuasion succeeds.

We can if we like then add alternate names for these relations that will be randomly swapped in some of the time. For instance:

To sport is a verb. The verb to sport means the wearing relation.
 
To hold up is a verb. The verb to hold up means the support relation.
 
Test me with "clark, drop the box / look / clark, take the suitcase / look / clark, get bouquet".

One might, hypothetically, imagine going even further than this and simply designating relations as either "important" or "unimportant" -- perhaps changing the relation's designation at runtime. Relations are not themselves allowed to have properties, however.

wi 14.9 Verbs as values
rb 2.1 Varying What Is Written

60. Ballpark ★★★

Sometimes it is more sensible to describe numbers roughly than in exact terms. For instance, we might want to have our player perceive "many people" rather than "forty-two people" on entering a room. To achieve this, we might write our own "to say" phrase.

"Ballpark"

To say (count - a number) in round numbers:

repeat through the Table of Numerical Approximation:

if count is less than threshold entry:

say "[approximation entry]";

rule succeeds.

Phrases will be explained more thoroughly in a later chapter, but as we have already seen in the examples, we can make a "To say…" phrase that will allow us to create our own text substitutions. In this case, we are going to replace the specific number with a vaguer one chosen from a chart, so:

Table of Numerical Approximation

thresholdapproximation
1"no"
2"one"
3"a couple of"
6"a few"
11"some"
21"many"
1000"lots and lots of"

The idea here is that we will work our way through the table until we hit a line where the threshold number is higher than the number we want to express, and then print that output: so if we have less than one item, we'll print "no"; if we have more than none but less than two, we'll print "one"; if we have less than three, we'll print "a couple of"; if we have three, four, or five (but not six), we'll print "a few."

A room has a number called the population. The population of a room is usually 0. The description of a room is usually "You observe [population of the location in round numbers] [if population of the location is 1]person [otherwise]people [end if]here.".
 
The Stadium is a room. The Hot Dog Stand is west of the Stadium. The Women's Restroom is south of the Stadium.
 
The population of the Stadium is 500. The population of the Hot Dog Stand is 3. The population of the Restroom is 750.
 
Test me with "w / e / s".

wi 5.4 Text with numbers
rb 2.1 Varying What Is Written

72. Fifty Times Fifty Ways ★★★

There is only so much we can cram into a text property, so being able to swap in properties is useful but limited. Fortunately, we can also, if we want, create new phrases for how to say things in brackets:

"Fifty Times Fifty Ways"

The Beekeeper's Palace is a room. Wasp is a woman in the palace. Drone is a man in the palace.

A person can be fierce or mellow. Wasp is fierce. Drone is mellow. A person can be calm or angry. A person is usually calm. A person has some text called insult. The insult of a person is usually "Grasshopper". The insult of Wasp is "Larva".

Instead of kissing someone:

say "'[denial for the noun], [insult for the noun]! [boast]!'";

Now to provide some meaning to these bracketed forms. We'll start with the easy one:

To say boast:
   say "I have ferocious allies".

This is a "to say" phrase; we will learn more about phrases in a later chapter, but for now it may be enough to observe that whatever we write after "to say…" becomes a valid substitution in bracketed speech. In this particular case there is no advantage to using the boast token rather than spelling the text out in the quotation, but we might in theory add further instructions to randomize the output, for instance.

To say phrases can be more complex, as well, since we can have them incorporate extra information:

To say insult for (speaker - a person):
   if speaker is angry, say "[the insult of the noun]";
   otherwise say "small one".

Here where we have (speaker - a person), we are leaving a slot which we can later fill in, madlibs-like, with any person we like. That is why we can write "insult for the noun": we are summoning the To say phrase and telling it to fill in the identity of the unknown speaker with the noun.

This differs from "insult of the noun" in the previous example; in that case, each person had his own insult property, and were merely printing that property out. Here we are actually telling Inform to calculate anew what the insult should be, and giving it some instructions about how to do that.

Our instructions can also get arbitrarily complex:

To say denial for (speaker - a person):
   if speaker is calm:
      say "You must not";
   otherwise if speaker is female:
      say "Stand back";
   otherwise:
      say "You forget yourself".
 
Instead of attacking someone:
   now the noun is angry;
   say "'Get away, [insult]!'"
 
Test me with "kiss wasp / hit wasp / kiss wasp / kiss drone / hit drone / kiss drone".

So the effects we can get with text substitutions are quite flexible. We could even, if we wanted, fill in the substitutions by random choice, or by selecting items from a long list or table, should we have so bellicose a set of characters that they cannot make do with one or two insulting remarks apiece.

wi 5.13 Making new substitutions
rb 2.1 Varying What Is Written

248. Narrative Register ★★★

As we saw in "Variety", we can associate verbs with particular actions and call them up as needed. If we do that, though, we can also store additional information about those verbs and use that information to select the ideal verb to use in a particular situation.

In this example, we create a table of verbs and their meanings, together with some connotative information. Each time we report an action, we then score all the available verbs to decide which is the most suitable to use at the moment. This allows us to change the narrator's diction change mid-game and have the action descriptions change as well.

Moreover, because we're using adaptive verbs, these responses will automatically inflect properly even if we change the story tense and viewpoint.

"Narrative Register"

Section 1 - Descriptive Functionality

Describing relates various verbs to various action names. The verb to describe means the describing relation.

To take is a verb. To acquire is a verb. To get is a verb. To gain is a verb. To obtain is a verb. To pick up is a verb. To bag is a verb. To procure is a verb. To score is a verb. To grab is a verb. To snag is a verb. To snatch is a verb. To collect is a verb.

To drop is a verb. To put down is a verb. To discard is a verb. To throw away is a verb. To dispose of is a verb. To set down is a verb. To toss aside is a verb. To ditch is a verb. To abandon is a verb. To dump is a verb. To jettison is a verb. To abjure is a verb. To foresake is a verb. To dispense with is a verb.

After an actor doing something to something when a verb describes (the action name part of the current action) (this is the apply random verbs to describing actions rule):

score the relevant verbs;

sort the Table of Verb Meanings in reverse relevance order;

choose row 1 in the Table of Verb Meanings;

let top score be the relevance entry;

sort Table of Verb Meanings in random order;

repeat through the Table of Verb Meanings:

if relevance entry is top score:

say "[The actor] [verb rendering applied to (word entry)] [the noun].";

erase relevance;

rule succeeds.

To decide which text is the rendering of (V - verb) (this is verb rendering):

decide on "[adapt V]".

To score the relevant verbs:

repeat through the Table of Verb Meanings:

if the meaning entry is (the action name part of the current action):

increase relevance entry by 1;

repeat with chosen connotation running through connotations entry:

if the chosen connotation is listed in the current register:

increase relevance entry by 1;

otherwise:

decrease relevance entry by 1.

To erase relevance:

repeat through Table of Verb Meanings:

now relevance entry is 0.

A tonality is a kind of value. The tonalities are pompous, archaic, slangy, upbeat, downbeat.

Connoting relates various verbs to various tonalities. The verb to connote means the connoting relation.

The current register is a list of tonalities that varies. The current register is { }.

When play begins:

repeat through the Table of Verb Meanings:

now the word entry describes the meaning entry;

now relevance entry is 0;

repeat with chosen tone running through the connotations entry:

now the word entry connotes the chosen tone.

Table of Verb Meanings

word	meaning	connotations	relevance ( a number )
the verb take	the taking action	{ }
the verb acquire	the taking action	{ pompous }
the verb get	the taking action	{ }
the verb gain	the taking action	{ }
the verb obtain	the taking action	{ pompous }
the verb pick up	the taking action	{ }
the verb bag	the taking action	{ slangy }
the verb score	the taking action	{ slangy, upbeat }
the verb procure	the taking action	{ archaic }
the verb grab	the taking action	{ slangy }
the verb snag	the taking action	{ slangy }
the verb snatch	the taking action	{ slangy }
the verb collect	the taking action	{ }
the verb discard	the dropping action	{ pompous }
the verb drop	the dropping action	{ }
the verb put down	the dropping action	{ }
the verb toss aside	the dropping action	{ }
the verb ditch	the dropping action	{ slangy }
the verb throw away	the dropping action	{ }
the verb dispose of	the dropping action	{ }
the verb set down	the dropping action	{ }
the verb abandon	the dropping action	{ downbeat }
the verb dump	the dropping action	{ downbeat }
the verb abjure	the dropping action	{ archaic }
the verb foresake	the dropping action	{ archaic }
the verb jettison	the dropping action	{ pompous }
the verb dispense with	the dropping action	{ pompous }

Section 2 - Changing Tone Mid-Game

Understand "new tone" as changing the tone. Changing the tone is an action out of world.

Carry out changing the tone:

now the current register is { };

if a random chance of 1 in 4 succeeds:

say "Your narrator will now adopt an ordinary tone.";

rule succeeds;

let rando be a random tonality;

add rando to the current register, if absent;

say "Your narrator will now be [rando]."

Section 3 - Scenario

Lab is a room. The table is here. The bat and the ball are on the table.

Test me with "get ball / drop ball / get bat / drop bat / new tone / get all / drop all / new tone / get all / drop all".

wi 14.3 More on adapting verbs
rb 2.1 Varying What Is Written

305. Straw Into Gold ★★★

"Straw Into Gold"

The Cell is a room. Rumpelstiltskin is an improper-named man in the Cell. Rumpelstiltskin can be identified or unidentified. Rumpelstiltskin is unidentified.

R-name is a kind of value. The R-names are dwarf, guy, dude, and man-thing. Rumpelstiltskin has an R-name. Understand "[R-name]" as Rumpelstiltskin.

Our example is slightly complicated by the fact that "man" is a name already known to Inform, so we can't re-use it as a kind of value. This is possible to work around, though:

Understand "man" as man-thing.

Now we borrow from the Activities chapter to look at the exact wording of the player's command:

After reading a command:
   if the player's command includes "[R-name]",
      now the R-name of Rumpelstiltskin is the R-name understood;
   if the player's command includes "Rumpelstiltskin":
      now Rumpelstiltskin is identified;
      now Rumpelstiltskin is proper-named.
 
Rule for printing the name of Rumpelstiltskin when Rumpelstiltskin is unidentified:
   if the R-name of Rumpelstiltskin is man-thing:
      say "man";
   otherwise:
      say "[R-name]".
 
Test me with "x dwarf / x guy / x dude / look / x rumpelstiltskin / look / x man".

wi 17.9 Understanding kinds of value
rb 2.1 Varying What Is Written

🔗

RB §2.2 Varying What Is Read

Making the printed text adapt to circumstances only makes half of the conversation graceful: the other half is to allow the player's commands to have a similar freedom. The things the player can refer to should always respond to the names which would seem natural to the player. Inform provides a variety of techniques for understanding words always, or only under certain conditions; and, if need be, we can also get direct access to what the player has typed in order to examine it with regular expressions. (This last resort is rarely necessary.)

First Name Basis ★ shows how to assign names to things or to kinds of thing - if, for instance, we want the player to be able to refer to any man as "man" or "gentleman":

Understand "man" or "gentleman" as a man.

We may also sometimes want to give names that are specifically plural, as in

A duck is a kind of animal. Understand "birds" as the plural of duck.

Understand "birds" as the plural of the magpie.

Vouvray ★★ demonstrates.

A common challenge arises when two objects have names that overlap or are related, and we wish Inform to choose sensibly between them: for instance, a cigarette vs. a cigarette case. If a word should apply to something only as part of a phrase (e.g., "cigarette" alone should never refer to the cigarette case) we can manage the situation as follows:

The case is a closed openable container. The printed name is "cigarette case". Understand "cigarette case" as the case.

Because "cigarette" here appears only as part of the phrase "cigarette case", it will be understood only in that context; the conflict with the bare cigarette will not arise.

As a variant, we may want one object only to take precedence over another in naming. If we wanted the player to be allowed to refer casually to the cigarette case as "cigarette" when (and only when) the cigarette itself is not in view, we could add

Understand "cigarette" as the case when the cigarette is not visible.

Tricks which consider the visibility of other objects can be bad for performance if used widely; but for adding finesse to the treatment of a few items, they work very well.

(There may still arise cases where the player uses a name which can legitimately refer to two different things in view. To deal with this situation, we may want the Does the player mean… rules, explained in the chapter on Understanding; and to change the way the story asks for clarification, see the two activities Asking which do you mean and Clarifying the parser's choice of something.)

Names of things which contain prepositions can also be tricky because Inform misreads the sentences creating them: Laura ★★ shows how some awkward cases can be safely overcome.

A more difficult case is to ensure that if we change the description or nature of something in play, then the names we understand for it adapt, too. "Understand… when…" can be all that's needed:

Understand "king" as Aragorn when we have crowned Aragorn.

Or, similarly, if we want some combination of categories and characteristics to be recognized:

Understand "giant" as a man when the item described is tall.

"The item described" here refers to the thing being named. "…when" can even be useful in defining new commands, and Quiz Show ★ demonstrates how to ask open-ended questions that the player can answer only on the subsequent turn.

Properties can also be matched without fuss:

Tint is a kind of value. The tints are green, aquamarine and darkish purple. The wallpaper is fixed in place in the Hotel. The wallpaper has a tint. Understand the tint property as describing the wallpaper.

This allows EXAMINE AQUAMARINE WALLPAPER if, but only if, it happens to be aquamarine at the moment. Relationships can also be matched automatically:

A box is a kind of container. The red box is a box in the Toyshop. Some crayons are in the red box. Understand "box of [something related by containment]" as a box.

which recognises BOX OF CRAYONS until they are removed, when it reverts to plain BOX only.

Greater difficulty arises if, using some variable or property or table to mark that a bottle contains wine, we print messages calling it "bottle of wine". We are then honour-bound to understand commands like TAKE BOTTLE OF WINE in return, not to insist on TAKE BOTTLE. Almost all "simulation" IF runs in to issues like this, and there is no general solution because simulations are so varied.

A converse challenge arises when we want to avoid understanding the player's references to an object under some or all circumstances. This is relatively uncommon, but does sometimes occur. For this situation, Inform provides the "privately-named" property, as in

The unrecognizable object is a privately-named thing in the Kitchen.

Here "privately-named" tells Inform not to understand the object's source name automatically. It is then up to us to create any understand lines we want to refer to the object, as in

Understand "oyster fork" as the unrecognizable object when the etiquette book is read.

Of course, if we need an object that the player is never allowed to refer to at all, we can just make this privately-named and then not provide any understand lines at all.

A final source of difficulty is that by default Inform truncates words to nine letters before attempting to identify them. This is no problem in most circumstances and is likely to go unnoticed -- until we have two very long words whose names are nearly identical, such as "north-northwest exit" and "north-northeast exit". (To make matters worse, a punctuation mark such as a hyphen counts as two letters on its own.)

When we are compiling for Glulx, the limit is easily changed with a single line, setting the constant called DICT_WORD_SIZE. For instance, if we wanted to raise the limit to 15, we would write

Use DICT_WORD_SIZE of 15.

When compiling for the Z-machine, the solution is harder. North by Northwest ★★ shows how to use the reading a command activity to pre-process very long names, rendering them accessible to the parser again.

Inform also allows the player to refer to the most recently seen objects and people as IT, HIM, HER, and so on. It sets these pronouns by default, but there are times when we wish to override the way it does that. Pot of Petunias ★ shows off a way to make Inform recognize an object as IT when it would not otherwise have done so.

(See Using the Player's Input for an example (Mr. Burns' Repast) in which a fish can be called by any arbitrary word as long as it ends in the letters -fish.)

Examples

11. First Name Basis ★

Sometimes we create objects that we want the player to be able to call by different names: a television that should also answer to "tv" and "telly", for instance, or a refrigerator the player might also call "fridge". In this case, we can use instructions like

Understand "tv" and "telly" as the television.

to add extra names to the object we've defined.

"First Name Basis"

The Crew Lounge is a room. "Deliberately spartan: the crew feels weight restrictions here first, so there aren't any chairs, just a few thin pads on the ground."

The holographic projector is a device in the Crew Lounge. "The one major source of entertainment is the holographic projector, a top of the line Misthon 9000, on which you view every beam you can get." Understand "holo" or "holograph" or "Misthon" or "9000" as the projector.

The description of the projector is "[if switched on]The projector is now playing a documentary about the early politics of the Mars colony.[otherwise]The air above the projector is disappointingly clear.[end if]".

(This description is for local color; we will learn more about devices, and conditions like "if switched on", later in this chapter.)

By default, Inform does not understand the names of an object's kind as referring to that object, unless the object has no other name of its own. We can change this, if we like, by defining names that should be applied to everything of a given kind:

Lewis and Harper are men in the Crew Lounge. Understand "man" or "guy" or "chap" or "lad" or "male" as a man. Understand "men" or "chaps" or "lads" or "guys" or "males" as the plural of a man.
 
The description of Lewis is "A wiry, excitable engineer who just signed aboard last week." The description of Harper is "Harper's a good guy: taciturn when sober, affectionate when drunk, but rarely annoying in either state."
 
Test me with "x holo / x man / lewis / x guy / harper / turn on projector / x holo projector / get men".

Inform's naming abilities go considerably further, in fact: we can also instruct it to understand words only under certain circumstances, or only when they appear with other words. Fuller details may be found in the chapter on Understanding.

wi 3.5 Kinds
rb 2.2 Varying What Is Read

323. Quiz Show ★

"Quiz Show" by Mike Tarbert

Use scoring.

Answer mode is a truth state that varies.

Current state is a text that varies.

Guessing is an action applying to one topic.

Understand "[text]" as guessing when answer mode is true.

Because of the "…when" part of this line, random text is only treated as an answer when a question is being asked.

Check guessing (this is the default wrong answer rule):
   if the topic understood is not a topic listed in the Table of Dates of Statehood:
      say "Wrong!";
   now answer mode is false.
 
Carry out guessing a topic listed in the Table of Dates of Statehood:
   if state entry is the current state:
      say "Correct! ([comment entry], to be exact!)";
      increase the score by one;
   otherwise:
      say "Wrong!";
   now answer mode is false.

This next rule allows a player to do something other than answer the question, but then makes him wait for another question before answering.

Before doing anything other than guessing:
   if answer mode is true:
      say "(ignoring the question)[line break]";
   now answer mode is false.
 
Section 2 - Scenario
 
The Lab is a room.  Sam is a man in the lab.
 
Every turn when the player is in the lab:
   if a random chance of 3 in 5 succeeds:
      choose a random row in the Table of Dates of Statehood;
      say "Sam asks you, 'In what year was [state entry] admitted into the Union?'";
      now current state is state entry;
      now answer mode is true.
 
Table of Dates of Statehood

StateTopicComment
"Florida""1845""March 3rd"
"Delaware""1787""December 7th"
"Hawaii""1960""July 4th"
 
Test me with "1845 / z / z / 1787 / 1792 / z / 1845 / g".

Note that the situation will become a little more complicated if we have two or more identical topics in our trivia list; in that case, we would need to loop through the Table of Dates of Statehood explicitly, and only mark the player wrong if none of the lines were found to match. (See the chapter on Tables for many more ways to manipulate table behavior.)

wi 17.17 Context: understanding when
rb 2.2 Varying What Is Read

325. Pot of Petunias ★

Suppose we have an object that makes a dramatic entrance on the scene, like so:

"Pot of Petunias"

Wide Open Field is a room. "A big field under a big sky. The clouds are puffy, the trees are handsome."

Some clouds and some trees are scenery in Wide Open Field. The description of the clouds is "That one looks like Yoda's head." The description of the trees is "You've never been much good at botany, so it's anyone's guess what kind they are."

A rock is in Wide Open Field. The description of the rock is "It looks like it's been here from the dawn of time."

The broken flower pot is a thing. The description of the broken flower pot is "It contains the remains of some abused petunias."

At 9:01 am:

move the broken flower pot to the location;

say "Quite unexpectedly, a flower pot falls from the sky and breaks open on the ground. Good thing you weren't standing six inches to the left.";

set pronouns from the broken flower pot.

Test me with "x it / x it / x it".

If we leave out the "set pronouns…" line here, we'll wind up with the following very unsatisfactory end to our test transcript:

Quite unexpectedly, a flower pot falls from the sky and breaks open on the ground. Good thing you weren't standing six inches to the left.
 
>[3] x it
It looks like it's been here from the dawn of time.

wi 17.18 Changing the meaning of pronouns
rb 2.2 Varying What Is Read

19. Laura ★★

Occasionally it is useful to give something a printed name because we want to call it something extremely long-winded; give one thing a name that is the subset of the name of something else; or use words such as "with" or "and" that are likely to confuse Inform into thinking that the object name ends before it actually does.

Often it is enough to preface these ambiguously-titled things with "a thing called…" or "a supporter called…" or the like, as here:

South of Spring Rolls is a room called Hot and Sour Soup.

prevents Inform from trying to read "Hot and Sour Soup" as two separate rooms, while

The player carries an orange ticket. The player carries a thing called an orange.

creates two objects instead of the one orange ticket that would result if the second sentence were merely "The player carries an orange."

Really long names can be a bit cumbersome. For example:

The player carries a thing called an incriminating photograph of a woman with blonde hair.

So we might instead give the photograph a printed name:

"Laura"

The City of Angels is a room. The incriminating photograph is carried by the player. The printed name of the incriminating photograph is "incriminating photograph of a woman with blonde hair".

Now we've gotten around any awkwardness with printing the name -- but we also need to understand when the player refers to the photograph. When we define the names of objects under normal circumstances, Inform takes care of this automatically, but if we have especially set the printed name, we must also specially define the appropriate terms for the player to use. For this we need "understand", which will be explained in much more depth in a later chapter:

Understand "woman" or "with" or "blonde" or "hair" or "of" or "a" as the incriminating photograph.
 
Test one with "x photograph / x incriminating photograph of a woman with blonde hair / x hair / x blonde / x woman with blonde hair / x incriminating photograph of a woman".

That's probably as far as we really need to go, and if you are satisfied with this behavior, there is no need to read on.

One possible objection to this solution is that Inform will accept some nonsensical formulations as applying to the photograph: for instance, it will allow >EXAMINE PHOTOGRAPH OF, >X BLONDE PHOTOGRAPH WOMAN INCRIMINATING, or even >X OF …though in the case there were two items with "of" names, the game would disambiguate with a question such as "Which do you mean, the incriminating photograph of a woman with blonde hair or the essence of wormwood?"

Traditionally, Inform has tended to be fairly flexible about word order, preferring to err in the direction of leniency. On the other hand, there are times when we need more exacting rules in order to distinguish otherwise similar cases.

Two features allow us to specify more exactly if we so desire. The first is that, if we specify a whole phrase as the name of something, all the words in that phrase are required, in the order given. Thus "Understand "blonde hair" as the photograph" would require that both "blonde" and "hair" be present, and would not recognize >X BLONDE, >X HAIR BLONDE, or >X HAIR.

Second, we can create tokens, such as "Understand "blonde hair" or "hair" as "[hair]", and then use these tokens in match phrases. This saves a good deal of time when we want to specify a number of different but fussy alternatives. So, for instance, here is a drawing that would not respond to >X OF, or >X BROWN EYES, but would respond to >X DRAWING OF MAN WITH BROWN EYES, >X MAN WITH BROWN EYES, and so on:

The drawing is carried by the player. The printed name of the drawing is "drawing of a man with brown eyes".
 
Understand "eyes" or "brown eyes" as "[brown eyes]". Understand "man" or "man with [brown eyes]" or "brown-eyed man" as "[man]". Understand "[man]" or "drawing of [man]" or "drawing of a [man]" as the drawing.
 
Test me with "test one / test two".
 
Test two with "x drawing / x man / x of / x drawing of man / x drawing of a man / x drawing of a man with brown eyes / x drawing of a brown-eyed man / x brown eyes".

Further refinements are possible: the "privately-named" attribute tells Inform not to try to understand the source name of an object at all, so if we write

The purple rabbit is a privately-named thing.

…the player will not be able to refer to it as "purple" or "rabbit" or "purple rabbit".

There are also ways to make names to refer to entire kinds of objects (so "dude" will refer to any man in the game); to specify names that only refer to objects in the plural (so GET PICTURES will pick up several pictures together); to reflect an object's properties (so "red apple" works only as long as the apple is in fact red); or even to refer to the object's relationships to other objects (so "bottle of wine" works only when wine is indeed in the bottle). All these refinements are discussed in the chapter on Understanding.

wi 3.11 Two descriptions of things
rb 2.2 Varying What Is Read

43. Vouvray ★★

The Understanding chapter lays out ways to change how the player can refer to objects, but we may not want to wait that long for some of the basic features. Here, for instance, is how to add synonyms that the player can use to refer to an entire kind of object:

"Vouvray"

The Wine Emporium is a room. "Set aside, you rather suspect, for tourists: this chamber is barrel-vaulted stone, lined on each side with casks of aging wine. Discarded brochures here and there advertise Wine Tours of the Loire Valley in three different languages, none of them French."

A cask is a kind of thing. A cask is always fixed in place. Understand "cask" or "barrel" as a cask. Understand "casks" or "barrels" as the plural of cask.

The Vouvray cask and the Muscadet cask are casks in the Wine Emporium.

Test me with "get barrels / get barrel / muscadet / x casks / x muscadet cask".

wi 4.1 New kinds
rb 2.2 Varying What Is Read

375. North by Northwest ★★

Suppose we wanted to add intermediate compass directions such as north-northwest to our game. Because of the limitations of the index map, we won't be able to view these connections on the world map, but we can certainly create them, and use them in route-finding, just like other directions.

Here's how we'd set up such a thing:

"North by Northwest"

Section 1 - Procedure

The north-northwest is a direction. North-northwest has opposite south-southeast. Understand "n-nw" or "nnw" as north-northwest.

The north-northeast is a direction. North-northeast has opposite south-southwest. Understand "n-ne" or "nne" as north-northeast.

The south-southwest is a direction. South-southwest has opposite north-northeast. Understand "s-sw" or "ssw" as north-northwest.

The south-southeast is a direction. South-southeast has opposite north-northwest. Understand "s-se" or "sse" as south-southeast.

The west-northwest is a direction. West-northwest has opposite east-southeast. Understand "w-nw" or "wnw" as west-northwest.

The east-northeast is a direction. East-northeast has opposite west-southwest. Understand "e-ne" or "ene" as east-northeast.

The west-southwest is a direction. West-southwest has opposite east-northeast. Understand "w-sw" or "wsw" as west-northwest.

The east-southeast is a direction. East-southeast has opposite west-northwest. Understand "e-se" or "ese" as east-southeast.

A complication arises because we reach the 9-character limit: Inform truncates the names of objects to nine characters before trying to understand them. To make matters worse, the hyphen (and other punctuation marks) count as two letters. So both north-northwest and north-northeast will get truncated to "north-no", and be indistinguishable when the player types them.

When we are compiling for Glulx, the limit is easily changed with a single line, setting the constant called DICT_WORD_SIZE. For instance, if we wanted to raise the limit to 15, we would simply write "Use DICT_WORD_SIZE of 15."

If we're compiling to the Z-machine, however, we'll have to resort to some manipulation of the player's command. The general solution is that when the player's name for an object is going to have to be longer than we can correctly read, we can substitute an unambiguous abbreviation for the thing the player typed. In this case, it will be simplest and most efficient always to condense the player's direction names to single letters, thus:

After reading a command:
   let N be "[the player's command]";
   replace the text "north" in N with "n";
   replace the text "east" in N with "e";
   replace the text "south" in N with "s";
   replace the text "west" in N with "w";
   change the text of the player's command to N.

For more on the use of text, see the Advanced Text chapter.

Section 2 - Scenario
 
The Empty Field is north-northwest of the Deserted Road.
 
A crop-dusting plane is a backdrop. It is not scenery. It is in the Deserted Road and Empty Field. The initial appearance of the crop-dusting plane is "[one of]In the distance[or]Approaching faster and faster[or]Flying ominously low and directly towards you[or]Immediately overhead[or]Circling around for another approach[cycling] is a standard crop-dusting plane."
 
After looking:
   say "From here you can run to [the list of adjacent rooms]."
 
Rule for printing the name of a room (called the target) which is not the location while looking:
   let chosen direction be the best route from the location to the target;
   say "[chosen direction]".
 
Test me with "sse / north-northwest".

In practice, this is going to be overkill for almost all games: most players already find eight compass directions plus up and down to be enough (or more than enough) to keep track of. But the option exists, in case there is a compelling reason to use it.

(Note also that we are allowed to use multi-word direction names, so we could have called the directions "north by northwest", "north by northeast", and so on. This example deliberately takes the hard way in order to show how to resolve the nine-character problem.)

wi 18.33 Reading a command
rb 2.2 Varying What Is Read

🔗

RB §2.3 Using the Player's Input

We may sometimes want to capture specific words the player has used and then feature that text elsewhere in the story.

Terracottissima Maxima ★★★ demonstrates using text to describe objects; Mr. Burns' Repast ★★ lets the player refer to a fish by any of a number of names, and changes the way the fish is described as a result.

More specialized effects are also possible: Xot ★★★ shows how to collect the player's erroneous input and store the command line to be printed back later. Igpay Atinlay ★ shows how to parrot the player's command back in pig Latin form.

Examples

420. Igpay Atinlay ★

For the sake of argument, suppose we want to parrot back all the player's commands in pig Latin:

"Igpay Atinlay"

Armfay is a room.

After reading a command:

let N be "[the player's command]";

replace the regular expression "\b(<aeiou>+)(\w*)" in N with "\1\2ay";

replace the regular expression "\b(<bcdfghjklmnpqrstvwxz>+)(\w*)" in N with "\2\1ay";

say "[N][paragraph break]";

reject the player's command.

Test me with "nix on the stupid".

wi 20.8 Replacements
rb 2.3 Using the Player's Input

421. Mr. Burns' Repast ★★

Suppose we have an unhappily mutated fish that the player can refer to by any of a number of species names, or any word followed by -fish. We want to reject these commands, but preserve a memory of what the player last tried to call the thing:

"Mr. Burns' Repast"

Wharf is a room.

There is an unknown fish in the Wharf. The unknown fish has some a text called the supposed name. The description of the unknown fish is "The victim of heavy mutagens, this thing is not really recognizable as any species you know.".

Fish variety is a kind of value. The fish varieties are salmon, albacore, mackerel.

Rule for printing the name of the unknown fish:

if the supposed name of the unknown fish is "", say the printed name of the unknown fish;

otherwise say the supposed name of the unknown fish.

After reading a command:

if the unknown fish is visible and player's command matches the regular expression "\b\w+fish":

let N be "[the player's command]";

replace the regular expression ".*(?=\b\w+fish)" in N with "";

now N is "[N](?)";

now the supposed name of the unknown fish is N;

respond with doubt;

reject the player's command;

otherwise if the unknown fish is visible and the player's command includes "[fish variety]":

now supposed name of the fish is "[fish variety understood](?)";

respond with doubt;

reject the player's command.

To respond with doubt:

say "You're not [italic type]sure[roman type] you're seeing any such thing."

Test me with "get swordfish / look / touch monkfish / look / listen to tunafish / x fish / x salmon / look".

wi 20.8 Replacements
rb 2.3 Using the Player's Input

317. Terracottissima Maxima ★★★

Inform can also understand text properties:

"Terracottissima Maxima"

A flowerpot is a kind of thing. A flowerpot has a text called pattern. Understand the pattern property as describing a flowerpot. The printed name of a flowerpot is usually "[pattern] flowerpot". The printed plural name of a flowerpot is usually "[pattern] flowerpots".

The Herb Garden is a room. In the Herb Garden is a flowerpot with pattern "blue willow". In the Herb Garden is a flowerpot with pattern "striped". In the Herb Garden is a flowerpot with pattern "striped".

Test me with "x blue willow / get striped / look".

This may not seem very much different from having the pattern be a kind of value -- except that texts can, of course, hold almost anything. Further exploration of these possibilities may be found in the chapter on Advanced Text.

wi 17.15 Understanding things by their properties
rb 2.3 Using the Player's Input

381. Xot ★★★

In Hitchhiker's Guide to the Galaxy, any erroneous command the player types can return to haunt him later in the game. We could do the same, if we liked, by storing the player's command whenever we print a parser error.

"Xot"

Humiliation Chamber is a room. "A grim, grey-walled room. Cameras watch you from every angle; convex mirrors reflect your actions; and up near the ceiling, where you can't disable it, is a loudspeaker."

The last error is a text that varies. The last error is "xot".

Before printing a parser error:

now the last error is the player's command.

Every turn when a random chance of 1 in 2 succeeds:

say "Over the loudspeaker comes some distorted nonsense. If you listen carefully, it sounds as though some fool is saying '[last error], [last error], [last error]!'"

Test me with "wiggle / z / z / z / z / z / z".

wi 18.35 Printing a parser error
rb 2.3 Using the Player's Input

§3.

Room Descriptions

§3.

Map

§3.

Position Within Rooms

§3.

Continuous Spaces and The Outdoors

§3.

Doors, Staircases, and Bridges

§3.

Windows

§3.

Lighting

§3.

Sounds

§3.

Passers-By, Weather and Astronomical Events

🔗

RB §3.1 Room Descriptions

The printing of a room description is a more delicate business than it might initially seem to be: Inform has to consider all the objects that the player might have brought into the room or dropped there, and all the objects on visible supporters, and decide how to group and list them.

All of this behavior is handled by the looking command, so we find the relevant rules in the carry out looking rulebook. To go through the elements step by step:

Looking begins by printing the name and description of the room we're in. We can introduce variations into room names and descriptions by changing their printed name and description properties, as in

now the printed name of the Church is "Lightning-Struck Ruin";
now the description of the Church is "The beams overhead have been burnt away and the pews are charred. Only the stone walls remain.";

If we need more drastic effects, we can turn off or change either of these features by altering the rules in the carry out looking rulebook. For instance, to remove the name of the location entirely from room descriptions, we would write

The room description heading rule is not listed in the carry out looking rules.

(A word of warning: there is one other context in which the story prints a room name — when restoring a save or undoing a move. To omit the room title here too, add

Rule for printing the name of a room: do nothing.)

Ant-Sensitive Sunglasses ★ demonstrates how to use activities to make more flexible room description text.

Next, the story determines what items are visible to the player and need to be described. These never include the player himself, or scenery, but other things in the environment will be made "marked for listing". This is also the stage at which Inform chooses the order in which items will be listed.

We are allowed to meddle by changing the priorities of objects, in case we want some things to be described to the player first or last in the room description; Priority Lab ★ goes into detail about how. We can also force things to be left out entirely: Low Light ★ handles the case of an object that can only be seen when an extra lamp is switched on, even though the room is not otherwise considered dark. Copper River ★★★ implements the idea of "interesting" and "dull" objects: the story determines which items are currently important to the puzzles or narrative and mentions those in the room description, while suppressing everything else.

Then Inform carries out the writing a paragraph about… activity with anything that provides one; anything it prints the name of, it tags "mentioned". Thus

Rule for writing a paragraph about Mr Wickham:
   say "Mr Wickham looks speculatively at [list of women in the location]."

will count Wickham and everyone he looks at as all having been mentioned, and will not refer to them again through the rest of the room description. More complicated uses of writing a paragraph abound. A developed system for handling supporters that don't list contents appears in The Eye of the Idol ★★.

Inform then prints the initial appearances of objects that are marked for listing but not already mentioned; and then it performs the listing nondescript items activity, collating the remaining objects into a paragraph like

You can see a dog, a hen, ...

We can pre-empt items from appearing in this paragraph or change their listing by intervening with a Before listing nondescript items… rule, as in

Before listing nondescript items when the player needs the watch:
   if the watch is marked for listing:
      say "The watch catches your eye.";
      now the watch is not marked for listing.

If we wanted the watch always to be listed this way, it would be better to give it an initial appearance, but for conditional cases, the listing nondescript items activity is a good place to intervene. For instance, Rip ★ uses this activity to incorporate changeable or portable items into the main description text for a room when (and only when) that is appropriate.

The listing nondescript items activity also allows us to replace the "You can see…" tag with something else more fitting, if for instance we are in a dimly lit room.

When the story compiles the list of nondescript items, it adds tags such as "(open)" or "(empty)" or "(on which is a fish tank)" to the names of containers and supporters. We can suppress or change the "(empty)" tag with the printing room description details of activity, as in

Rule for printing room description details: stop.

And we can suppress the "(open)" and "(on which is…)" sorts of tags with the "omit the contents in listing" phrase, as in

Rule for printing the name of the bottle while not inserting or removing:
   if the bottle contains sand, say "bottle of sand";
   otherwise say "empty bottle";
   omit contents in listing.

Finally, the looking command lists visible non-scenery items that sit on scenery supporters, as in

On the table is a folded newspaper.

These paragraphs can be manipulated with the printing the locale description activity and the printing a locale paragraph about activity.

Another common thing we may want to do is change the description of a room depending on whether we've been there before (as in Slightly Wrong ★★) or on how often we've visited (as in Infiltration ★). Night Sky ★, meanwhile, changes the description of a room when we've examined another object, so that the player's awareness of his environment is affected by other things the character knows.

Examples

147. Night Sky ★

Sometimes a nice effect is to change the way things are described depending on the information the player has gained in the course of play. We could for instance write this:

"Night Sky"

The Planetarium is a room. "[if we have examined the sinister message]A dark room where it seems something is about to jump out at you![otherwise]A tranquil dark room with a ceilingful of stars.[end if]"

The sinister message is a thing in the Planetarium. "A message is taped to the wall." The description is "'BEWARE.'"

Test me with "look / x message / look".

On the other hand, beware that this would not work as desired:

"Night Sky"

The Planetarium is a room. "[if we have listened to the sinister message]A dark room where it seems something is about to jump out at you![otherwise]A tranquil dark room with a ceilingful of stars.[end if]"

The sinister message is a thing in the Planetarium. "A message plays very softly, so that you would have to listen to hear it." Instead of doing anything other than listening to the message: say "It's only a sound, after all.". Instead of listening to the sinister message: say "A voice whispers, 'BEWARE'."

Test me with "listen to message / look".

The reason is that our Instead rule has pre-empted normal listening, so Inform considers that we have never successfully heard the message. The moral here is that "if we have…" is useful for tracking events that otherwise proceeded completely normally (picking up ordinary objects, examining things); if we have used instead to make some change, we will have to use a different approach to record that the event did occur as scheduled.

wi 9.12 Actions as conditions
rb 3.1 Room Descriptions

152. Infiltration ★

Suppose we have a location that makes the player uncomfortable, and we want its description to change slightly each time he goes there, to reflect his increasing unease. We also want the door to that room to show whether he is going there for the first time, or whether this is a repeat visit.

We start with an ordinary room:

"Infiltration"

The Wasteland is a room. "In its more distant reaches, the Wasteland has a kind of austere beauty, but here beside the Secure Zone it is the worst of all possible worlds. Barrels of toxins are stacked the regulation hundred and fifty feet out; more traditional garbage has simply been flung over the wall, and this category includes one or two corpses roughly and inadequately disguised by black plastic bags. The wall itself has become a canvas for outcasts and exiles, and is covered with obscene paintings, lewd remarks about the inhabitants of the Secure Zone, and a few maudlin epitaphs."

Now the door, which will change from saying "leads inside…" to "leads back inside…" when this becomes appropriate:

The portal is a door. It is inside from the Wasteland and outside from the Secure Zone. "[if the player is in the Wasteland]To the west, a[otherwise]A[end if] portal in the cinder-block and barbed wire wall leads[if the player is in the Wasteland and the Zone is visited] back[end if] [if the player is in the Wasteland]inside[otherwise]outside[end if]."

Here we haven't used any conditions that we didn't know about in previous sections: the portal line only reflects whether the Zone has been visited never or visited once. But the Secure Zone itself makes use of the number of times visited:

The Secure Zone has the description "[if the player is in the Zone for the second time]Re-entering the Zone has not made you any more comfortable inside. [end if]Despite your carefully-chosen outfit and the walk you have been practicing, you are sure those inside can tell you don't belong. Not that very many people are visible here[if the player is in the Zone for more than the second time] -- the place seems more desolate than ever[end if]."
 
Instead of going west in the Wasteland, try going inside. Instead of going east in the Secure Zone, try going outside.

And finally, to be sure that the player does see our fancy changing descriptions:

Use full-length room descriptions.
 
Test me with "look / open portal / w / look / e / look / w / e / w".

Notice that the description of the Secure Zone changes from visit to visit, but that looking repeatedly during a single visit changes nothing.

wi 9.14 How many times?
rb 3.1 Room Descriptions

334. Ant-Sensitive Sunglasses ★

Suppose we want to create an object -- or maybe even a series of objects -- that warp the player's perception of every room description and object around him.

We've already seen some ways to create variations in text. For instance, we could make a room description with if substitutions in it, like so:

The Kitchen is a room. "[if the player is wearing the sunglasses]Are ants coming out of the sink? No, probably no.[otherwise]A small kitchen tucked into a corner of the vacation house. There is storage space for five or six cups, a sink, a two-ring stove; nothing else to speak of.[end if]"

That works fine if we have one or two variations we want to add; it's not so good if we're going to have several items that work like the sunglasses, or if we want the sunglasses to override the description of every room in the house.

A slightly more flexible method is to use a substitution that calls out to a say phrase, like this:

The Kitchen is a room. "[kitchen-description]"
 
To say kitchen-description:
   if the player is wearing the sunglasses:
      say "Are ants coming out of the sink? No, probably no.";
   otherwise:
      say "A small kitchen tucked into a corner of the vacation house. There is storage space for five or six cups, a sink, a two-ring stove; nothing else to speak of."

But again this doesn't handle the case of overriding multiple rooms at once very well.

When we reach a point where we need a given piece of text to be very flexible depending on the world model, it's time to use an activity.

Activities offer several advantages. One, we can create an activity like this:

Printing the room-description of something is an activity.

and then write a rule that applies to multiple rooms at once, like:

Rule for printing the room-description of a room when the player wears the sunglasses:
   say "The walls look like they're covered with ants. Just a coincidence, I'm sure."

Inform's usual rule-ranking also means that more-specific rules will override less-specific ones, so we could add

   Rule for printing the room-description of the Kitchen when the player wears the sunglasses:
   say "Are ants coming out of the sink? No, probably not."

and have that rule override the behavior of the activity just in the kitchen. Meanwhile, our base room descriptions remain straightforward and uncluttered by if-statements.

Several other examples will show how to hook activities into existing actions: Crusoe goes into detail about how how to make the descriptions of things more variable, and Aftershock demonstrates activities for describing the behavior of switchable devices.

Here, we preview all of those methods, just to get a sense of how they work and why they might be useful in controlling a game. Subsequent chapters go into more detail about the syntax of creating activities and the list of activities that are already defined by Inform.

"Ant-Sensitive Sunglasses"

Part 1 - Procedure

To add a new activity to an existing Inform rule, we need to do three things:

1) Define our new activity.

2) Give a basic rule that says what is supposed to happen when that activity occurs, as in "Rule for…"

3) Replace the existing rule in Inform's rulebooks with a new one that calls on our activity.

Here we do this with examining:

Section 1 - Item Description
 
Printing the description of something is an activity.

Now, by default, we want to print the description property; we just want the option to write some extra rules overriding that property. So we tell Inform that our most basic rule for printing the description of something is just to give that description text:

Rule for printing the description of something (called item):
   if the description of the item is not "":
      say "[description of item][paragraph break]";
   otherwise:
      say "You see nothing special about [the item].".

Next, we need the standard examining rule to look at our printing-the-description activity:

The activity-based examining rule is listed instead of the standard examining rule in the carry out examining rules.
 
This is the activity-based examining rule:
   carry out the printing the description activity with the noun;
   rule succeeds.

Now we do the same thing to room descriptions.

Section 2 - Room Description
 
Printing the room-description of something is an activity.
 
Rule for printing the room-description of a room (called item):
   if the description of the item is not "":
      say "[description of item][paragraph break]";
   otherwise:
      do nothing instead.
 
The activity-based room description body text rule is listed instead of the room description body text rule in the carry out looking rules.

Our replacement rule this time around is a little bit trickier just because the rule that we're replacing is a complicated one: describing a room already checks to see whether there's light to see by, whether the player has turned off room descriptions when he enters a room for the second time, and whether the player character is (say) inside a closed box he can't see out of.

But all of those details are re-copied from the standard rules, and the important thing is that, at the end, we again carry out our activity.

This is the activity-based room description body text rule:
   if the visibility level count is 0:
      if set to abbreviated room descriptions, continue the action;
      if set to sometimes abbreviated room descriptions and
         abbreviated form allowed is true and
         darkness witnessed is true,
         continue the action;
      begin the printing the description of a dark room activity;
      if handling the printing the description of a dark room activity,
         say "It is pitch dark, and you can't see a thing.";
      end the printing the description of a dark room activity;
   otherwise if the visibility ceiling is the location:
      if set to abbreviated room descriptions, continue the action;
      if set to sometimes abbreviated room descriptions and abbreviated form
         allowed is true and the location is visited, continue the action;
      carry out the printing the room-description activity with the location.
 
Section 3 - Device Description
 
Showing action of something is an activity.
 
Rule for showing action of something (called item):
   if the item is switched on, say "[The item] is switched on.";
   otherwise say "[The item] is switched off."
 
The activity-based described devices rule is listed instead of the examine devices rule in the carry out examining rules.
 
This is the activity-based described devices rule:
   if the noun is a device:
      carry out the showing action activity with the noun;
      now examine text printed is true.
 
Report switching on something:
   say "You flip a switch. ";
   carry out the showing action activity with the noun instead.
 
Part 2 - Scenario
 
The Kitchen is a room. "A small kitchen tucked into a corner of the vacation house. There is storage space for five or six cups, a sink, a two-ring stove; nothing else to speak of."
 
The microwave is a device in the Kitchen.
 
South of the Kitchen is the Living Area. The description of the Living area is "A whitewashed living/dining/reclining area in what used to be a shepherd's stone hut, but now costs vacationers 600 euros a week. It offers no mod cons, only a straight view of the Mediterranean and a wobbly writing table."
 
Rule for printing the room-description of a room when the player wears the sunglasses:
   say "The walls look like they're covered with ants. Just a coincidence, I'm sure[antsy]."
 
Rule for printing the room-description of the Kitchen when the player wears the sunglasses:
   say "Are ants coming out of the sink? No, probably not[antsy]."
 
Rule for printing the description of something (called the item) when the player wears the sunglasses:
   say "[The item] [are] [one of]ant-colored[or]ant-legged[or]covered in ants[at random][antsy]."
 
Rule for showing action of the microwave:
   say "The microwave hums meaningfully to itself."
 
Rule for showing action of the microwave when the player wears the sunglasses:
   say "The microwave hums as though inhabited by a billion ants[antsy]."
 
The player carries sunglasses of freakiness and an apple. The apple is edible. The sunglasses are wearable.
 
ant-paranoia is a number that varies.
 
To say antsy:
   increase ant-paranoia by 1;
 
Every turn:
   if the ant-paranoia is greater than 3:
      say "Augh! AUUUGH! GET THEM OFF--";
      end the story saying "You have lost your mind."
 
Test me with "look / turn on microwave / turn off microwave / x apple / x sunglasses / s / wear sunglasses / look / x apple / n / turn on microwave".

wi 18.1 What are activities?
rb 3.1 Room Descriptions

355. Rip Van Winkle ★

There are times when, for greater elegance of prose, we'd like to mention an object in the main body text of a room. For instance:

Here is a lovely, secluded fold in the mountains, far from civilization: as though to prove it, Rip Van Winkle is sleeping under a tree.

As we've already seen, that's no problem if Rip is scenery. He'll stay there motionless.

But what if something in the game allows Rip to wake up? Or what if we want to use the same technique on a portable object that the player should be allowed to take? Clearly in that case it's not appropriate to make the mentioned thing be scenery, and at the same time, we need to keep Inform from adding a superfluous

You can see Rip Van Winkle here.

to the end of our description.

Here is how:

"Rip Van Winkle"

A person can be asleep.

The Catskills is a room. "Here is a lovely, secluded fold in the mountains, far from civilization[if Rip Van Winkle is asleep]: as though to prove it, Rip Van Winkle is sleeping under a tree[end if]."

A tree is scenery in the Catskills.

Rip Van Winkle is a man in the Catskills. Rip Van Winkle is asleep.

Before listing nondescript items of the Catskills:

if Rip Van Winkle is marked for listing:

now Rip Van Winkle is not marked for listing;

if Rip Van Winkle is not asleep,

say "Rip Van Winkle stands here, looking mightily confused."

Instead of waiting:

say "Rip Van Winkle wakes up with a snort.";

now Rip Van Winkle is not asleep.

Test me with "look / z / look".

wi 18.25 Listing nondescript items of something
rb 3.1 Room Descriptions

358. Priority Lab ★

When it comes time to start manipulating the priorities of items, it is useful to be able to check the table for debugging purposes; the problem is that printing the names of the objects can itself affect the way the room description is generated, foiling our debugging efforts.

What follows is a rule to help with debugging safely, and a sample of how priorities work:

"Priority Lab"

Section 1 - Procedure

Before printing the locale description (this is the dump locale table rule):

say "Locale Priority list:";

repeat through Table of Locale Priorities:

let the flag be whether or not the notable-object entry is mentioned;

say "[line break] [notable-object entry]: [locale description priority entry]";

if the flag is false, now the notable-object entry is not mentioned;

say line break.

Now, let's look at some items put in a specific order. Things with low priority numbers list towards the beginning; things with high priority numbers list towards the end. (It helps to think of it as though we were making a numbered list of the paragraphs to appear in the description.) Anything numbered 0 doesn't appear at all, and the default priority of an object is 1.

A thing can be early-described, late-described, latest-described, never-described, sightline-described, or ordinarily-described. A thing is usually ordinarily-described.
 
After choosing notable locale objects (this is the apply early and late description rule):
   repeat with item running through early-described things:
      if there is a notable-object of item in the Table of Locale Priorities:
         set the locale priority of the item to 1; [list before everything else -- this would work with any number lower than 5 and higher than 0]
   repeat with item running through late-described things:
      if there is a notable-object of item in the Table of Locale Priorities:
         set the locale priority of the item to 10; [list after everything else -- this would work with any number larger than 5]
   repeat with item running through never-described things:
      set the locale priority of the item to 0; [don't list at all]
   continue the activity.

An important cautionary note: priorities are only honored if the objects are going to get their own paragraphs (with "writing a paragraph about…" or because they have initial appearances). Priorities do not affect the order in which items appear in the final "You can see…" list, except that items with priority 0 or lower are omitted. (If we want to order the items in that list, we may want to resort to the Complex Listing extension by Emily Short.)

There are further refinements available to us: for instance, we could make some things that are only visible if the player is raised above ground level.

After choosing notable locale objects (this is the sightline-described things are visible from supporters rule):
   if the player is not on a supporter:
      repeat with item running through sightline-described things:
         if there is a notable-object of item in the Table of Locale Priorities:
            set the locale priority of the item to 0; [remove objects that can only be seen from higher objects.]
   continue the activity.

It may also be useful to know about the "parameter-object", which refers to the thing whose contents we are currently describing: the standard rules consider how to describe the contents of the location and then also check the contents of any supporter or container the player may be inside, so in the first case "parameter-object" would be the location, and then in the second the supporter in question.

In practice this is rarely useful, but should we need to change priorities in the case of both player and object being inside a particular container, we might make use of it, for instance:

A thing can be tasteful or icky. A thing is usually tasteful.
 
After choosing notable locale objects (this is the icky things next to players rule):
   if the player is on the parameter-object:
      repeat with item running through icky things :
         if there is a notable-object of item in the Table of Locale Priorities:
            set the locale priority of the item to 10; [remove objects that can only be seen from higher objects.]
   continue the activity.

The other thing to note is that by default that final collection of generic objects ("You can also see…") appears at the end, regardless of the priority of everything else. If we really wanted to, though, we could force something to appear even after that paragraph, by adding a new listing rule to the locale description rules:

After choosing notable locale objects (this is the latest-described items priority rule):
   repeat with item running through latest-described things:
      if the item is a notable-object listed in the Table of Locale Priorities:
         now the item is mentioned;
         now the item is marked for late listing.
 
The late listing rule is listed after the you-can-also-see rule in the for printing the locale description rules.
 
A thing can be marked for late listing. A thing is usually not marked for late listing.
 
This is the late listing rule:
   if something is marked for late listing:
      say "Oh! And also [a list of things which are marked for late listing].";
      now everything is not marked for late listing;
   continue the activity.
 
Section 2 - Scenario
 
The Priority Lab is a room. The early bird, the worm, the leaf, the unseen object, the pebble, the twig, and the late edition are things in the Priority Lab.
 
The early bird is early-described. The late edition is late-described. The unseen object is never-described.
 
The worm is icky.
 
The high window is in Priority Lab. It is sightline-described and fixed in place. The initial appearance of the high window is "There's a tiny high window up near the ceiling that you can't see unless you're on top of something."

In order for the priorities we just set to be interesting, let's give out some initial appearances and writing a paragraph rules:

The initial appearance of the worm is "A worm inches along the ground."
The initial appearance of the late edition is "Finally, the late edition lies at your feet."
 
Rule for writing a paragraph about the early bird when the early bird is in a room: say "The early bird always appears first, and here it is."
Rule for writing a paragraph about the leaf: say "Look, there's [a leaf][unless the leaf is in the location] on [the holder of the leaf][end if]!"
Rule for writing a paragraph about an icky thing (called icky item) which is on something which supports the player: say "Ew, [an icky item] is right next to you."

This procedure also means (as you can test by experiment) that after the late edition has been picked up and dropped again, it lists in no special order in the "you can see…" paragraph (since initial appearances only print when the object has not yet been moved).

The afterthought is a thing in the Priority Lab. It is latest-described.
 
The bar stool is an enterable supporter in Priority Lab.
 
Test me with "get leaf / drop leaf / look / x unseen object / get pebble / look / get twig / look / get afterthought / look / drop twig / look / get late edition / look / drop late edition / sit on bar stool / look / get all / put all on stool / look".

wi 18.26 Printing the locale description of something
rb 3.1 Room Descriptions

359. Low Light ★

Suppose we want a different treatment of lighting than the usual: the room isn't totally dark, but there's something we can't see unless we turn on a bright light.

"Low Light"

First we make our environment and its light:

The Workroom is a room. The desk is in the Workroom. The brilliant lamp is a device on the desk.
 
To decide whether the light level is high:
   if the brilliant lamp is switched off, no;
   if the player cannot see the brilliant lamp, no;
   yes.
 
To decide whether the light level is low:
   if the light level is high, no;
   yes.

Now we make a shadow so that the player can only refer to it if the shadow is in inventory or the light is on:

The shadow is a privately-named thing on the desk.
 
Understand "barely-visible" or "barely visible" or "shadow" as the shadow when the light level is high. Understand "invisible" or "shadow" as the shadow when the player encloses the shadow.

And finally a couple of extra touches to make it clear why we're able to interact with the shadow when it's in inventory, even if the light is low:

Before printing the name of the shadow:
   if the light level is high:
      say "barely-visible ";
   otherwise if the player encloses the shadow:
      say "invisible (but tangible) "
 
After dropping the shadow when the light level is low:
   say "You let it go and it fades into the ambient gloom."

To handle the appearance of the object, we want to set its locale priority to 0: that will prevent it being named in room descriptions.

After choosing notable locale objects:
   unless the light level is high:
      set locale priority of the shadow to 0.
 
Test me with "look / get shadow / turn on lamp / look / get shadow / i / turn off lamp / i / drop shadow / look / get shadow / turn on lamp / look".

wi 18.27 Choosing notable locale objects for something
rb 3.1 Room Descriptions

4. Slightly Wrong ★★

A fairly common effect in interactive fiction is a room which is described differently on the first visit than on subsequent visits. We can produce this effect as follows:

"Slightly Wrong"

Awning is a room. "A tan awning is stretched on tent poles over the dig-site, providing a little shade to the workers here; you are at the bottom of a square twenty feet on a side, marked out with pegs and lines of string. Uncovered in the south face of this square is an awkward opening into the earth."

Slightly Wrong Chamber is south of the Awning. "[if unvisited]When you first step into the room, you are bothered by the sense that something is not quite right: perhaps the lighting, perhaps the angle of the walls. [end if]A mural on the far wall depicts a woman with a staff, tipped with a pine-cone. She appears to be watching you."

Test me with "look / s / look".

Note the "[if unvisited]…" in the description of the Slightly Wrong Chamber. A room is considered to be "unvisited" until after the player has seen its description for the first time.

The bracketed text creates a special rule for printing; we will learn more about these in the sections on text with variations and text with substitutions.

Some further fine print: we might write our condition as "if unvisited", "if the location is unvisited", or "if the Chamber is unvisited" -- all of these constructions would be acceptable, but in the absence of more specifics, the condition is understood to apply to the object whose description it is.

wi 3.1 Descriptions
rb 3.1 Room Descriptions

357. The Eye of the Idol ★★

"The Eye of the Idol"

Section 1 - Reusable Material

We start by defining relations that let us know where items "belong", with the understanding that if something is where it belongs, it will be described in the main room description and therefore should not be separately listed. Thus:

Positioning relates various things to various things. The verb to be placed in means the positioning relation. The verb to be placed on implies the positioning relation.
 
Room-positioning relates various things to various rooms. The verb to be room-placed in means the room-positioning relation.

We can't make relations relate various objects to various objects, and rooms are not things, so two separate cases are necessary. An alternative approach would be to say "A thing has an object called the initial placement", which would allow a thing to have an initial placement that was a room, a supporter, or a container; an advantage of using relations, though, is that that way we can if we like specify multiple placements for the same object, so that, e.g., a sparkling diamond can be described in the main description paragraph as "half-buried in dust" in the beginning of the game, and then at the end as "in the eye of the idol" at the end.

Now we define, based on these relations, an "in-place" adjective, which will identify whether something is in a location which will specially describe it:

Definition: a thing (called prop) is in-place:
   if the prop is in the location and the prop is room-placed in the location, yes;
   if the holder of the prop is a thing and the prop is placed in the holder of the prop, yes;
   no.
 
Definition: a thing is out-of-place if it is not in-place.

With that done, removing these items automatically from the room description is actually pretty easy:

Before listing nondescript items:
   now every marked for listing in-place thing is not marked for listing.

One tricky case remains: when something is placed on a supporter that is scenery, it can be mentioned even if we have marked that object "not marked for listing". What matters here is not whether the object itself is marked for listing but whether the supporter has been "mentioned". (A fuller description of how room descriptions are assembled is available in the Looking section of the Commands chapter in the Recipe Book.) So let's also add a feature whereby we can easily suppress the descriptions of these supporters when appropriate:

A supporter can be quiet.

A quiet supporter is one that is never mentioned itself and which only mentions its contents if they are out of place. This allows for maximum flexibility in incorporating it into the body of room descriptions.

Rule for writing a paragraph about a quiet supporter (called chosen table):
   if an out-of-place thing is on the chosen table:
      if an in-place thing is on the chosen table,
         say "On [the chosen table], in addition to [the list of in-place things on the chosen table], [is-are a list of out-of-place things which are on the chosen table].";
      otherwise say "On [a chosen table] [is-are a list of out-of-place things which are on the chosen table].";
   now the chosen table is mentioned.

Notice that we can still override this with writing a paragraph rules about specific supporters in our game, if we decide that we want something a little different in some cases.

Now, an example to test this out:

Section 2 - A Sample Scenario
 
The Sand-Floored Chamber is a room. "The constant wind has filled this chamber with a layer of fine red sand, as soft as powder snow[if the diamond is in the Sand-floored Chamber]. Something sparkling is half-buried in the corner[end if]. A doorway lies open to the north."
 
The sparkling diamond is in the Sand-floored Chamber. The sparkling diamond is room-placed in the Sand-floored Chamber. The description is "It is a vast diamond; the front is faceted, the back smoothed to fit in some sort of socket."
 
The Hexagonal Temple is north of the Sand-Floored Chamber. "The temple walls are great ashlar blocks rising to a hundred feet overhead, perhaps more; the roof is a scarlet awning only, through which the sun filters down in blood hues. Overseeing all is a sculpture in stone and ivory[if the sparkling diamond is in the idol's eye], in whose single eye a vast diamond gleams[end if][mat-and-incense text].".
 
To say mat-and-incense text:
   if the mat is in the Temple and the incense stick is on the pedestal:
      say ". A prayer mat at the idol's feet, and an incense stick still burning on the pedestal, indicate that someone was only recently consigning her grievances to the care of the deity";
   otherwise if the mat is in the Temple:
      say ". At the idol's feet, some worshipper has left a prayer mat";
   otherwise if the incense stick is on the pedestal:
      say ". At the idol's side is a pedestal, on which incense still smolders".

We could have done all this with text conditions in the main room description, but it becomes difficult to read when there are too many conditions operating in the same text property, so we break it out into a clearer set of conditions.

The idol is scenery in the Hexagonal Temple. Understand "sculpture" or "stone" or "ivory" as the idol. The description is "The idol is perhaps three times the height of an ordinary man."
 
The idol's eye is part of the idol. It is a container. The description is "[if the diamond is in the idol's eye]It gleams with purpose and righteous wrath[otherwise]A round socket in the center of the idol's forehead from which something seems to be missing[end if]."
 
The pedestal is a quiet supporter in the Hexagonal Temple. On the pedestal is an incense stick. The incense stick is placed on the pedestal.
 
A mat is in the Hexagonal Temple. It is room-placed in the Hexagonal Temple. The description is "Woven of assorted grasses."
 
Test me with "get diamond / look / n / get mat / look / drop diamond / look / get diamond / put diamond in eye / look / get incense / look / drop mat / look / get mat / put mat on pedestal / look / put incense on pedestal / look".

wi 18.25 Listing nondescript items of something
rb 3.1 Room Descriptions

362. Copper River ★★★

In a very dense environment, we might want to offer the player room descriptions in which only the currently-interesting items are mentioned, while other objects are suppressed even if they are present. In effect, this takes the idea of scenery and makes it more flexible: different things might become background objects or foreground objects at different times during play.

There are a wide range of possible reasons to do this -- to shift the narrative emphasis, to change the mood of the game by highlighting different parts of the environment, to show the game from the perspective of different viewpoint characters -- but in the following example, our goal is to show the player only the objects that are currently useful for puzzles.

To do this, we need some notion of what puzzles are currently available and unsolved, so we make an "unsolved" adjective; we also need to know which things solve the puzzle, so we create a "resolving" relation, to indicate which objects resolve which problems.

Given that information, we can create rules about which objects in the game world are currently interesting, which are currently dull, and describe accordingly:

"Copper River"

Use scoring.

Section 1 - Procedure

Resolving relates various things to various things. The verb to resolve means the resolving relation.

Definition: a thing is interesting if it is not dull.

Definition: a person is dull:

no.

Definition: a thing is dull:

if it is unsolved, no;

if it resolves an unsolved thing, no;

yes.

Definition: a supporter is dull:

if it is unsolved, no;

if it resolves an unsolved thing, no;

if it supports an interesting thing, no;

yes.

Definition: a container is dull:

if it is unsolved, no;

if it resolves an unsolved thing, no;

if it contains an interesting thing, no;

yes.

After choosing notable locale objects:

repeat with item running through unsolved things:

set the locale priority of the item to 1.

For printing a locale paragraph about a dull thing (called item):

now the item is mentioned.

Before printing a locale paragraph about a supporter (called item):

now every dull thing on the item is mentioned.

Before printing a locale paragraph about a container (called item):

now every dull thing on the item is mentioned.

Instead of searching a supporter:

if the noun supports something interesting:

say "[A list of interesting things on the noun] [are] on [the noun]";

if the noun supports something dull:

say " (alongside [a list of dull things on the noun])";

say ".";

otherwise if the noun supports something dull:

say "There's nothing very useful here, only [a list of dull things on the noun].";

otherwise:

say "[The noun] [are] completely bare."

Instead of searching a container:

if the noun contains something interesting:

say "[A list of interesting things in the noun] [are] in [the noun]";

if the noun contains something dull:

say " (alongside [a list of dull things in the noun])";

say ".";

otherwise if the noun contains something dull:

say "There's nothing very useful here, only [a list of dull things in the noun].";

otherwise:

say "[The noun] [are] completely empty."

Before listing contents when not taking inventory: group dull things together.

Rule for grouping together dull things: say "assorted dull items".

Section 2 - Scenario World and Objects

The Kitchen is a room. "Your Aunt Fiona's kitchen looks as though it has been at the eye of a glitter storm. Fine, sparkling grit dusts every surface. The appliances are slightly askew, too, as though they hadn't quite settled after a vigorous earthquake."

The shelf is a scenery supporter in the Kitchen. On the shelf is a can of beans, a can of potato leek soup, and a tin of deflating powder.

The cabinet is a scenery container in the Kitchen. In the cabinet is a book of matches, a bottle of descaling solution, a fish hook, and a rusty knife. It is openable and closed.

The counter is a scenery supporter in the Kitchen. On the counter is an espresso machine, a blender, and a mortar. The blender and the mortar are containers. In the mortar is a pestle. Understand "countertop" as the counter.

The stove is a scenery supporter in the Kitchen. The oven is part of the stove. The oven is a closed openable container.

The refrigerator is a fixed in place container in the Kitchen.

Understand "fridge" as the refrigerator.

The description is "The refrigerator is a dull blue-green, and has a puffy, marshmallow texture on the outside, which means that it's no good for sticking magnets to. Aunt Fiona has never been willing to explain where she got it." The refrigerator is openable and closed.

In the refrigerator are a bottle of ice wine, a bag of carrot sticks, and an egg.

Aunt Fiona is a woman in the Kitchen. Aunt Fiona can be inflated or deflated. Aunt Fiona is inflated. "[if Aunt Fiona is inflated]Aunt Fiona stands nearby. Or perhaps 'stands' is the wrong word: she has been sort of puffed up in her own skin like a balloon, and is now propped in a corner of the room with her head lolling back[otherwise]Aunt Fiona stands -- on her own two slender legs -- at the center of the room[end if]."

Every turn when Fiona is unsolved and Fiona can see the player:

if a random chance of 1 in 3 succeeds:

say "[one of]Aunt Fiona's eyes follow you, wide and desperate, but it doesn't look like she's able to do anything[or]Aunt Fiona is still looking reproachful[or]A faint gurgling comes from Aunt Fiona[or]Aunt Fiona makes a funny croak noise[or]Aunt Fiona is still having trouble speaking. Perhaps her throat is as swollen as the rest of her[or]Aunt Fiona twitches[stopping]."

There is a thing called a salmon. Understand "fish" as the salmon. The salmon can be scaly or prepared. The salmon is scaly. The description is "[if scaly]It looks delicious, but is still covered with scales[otherwise]The salmon has been scaled and is ready to eat[end if]."

Before printing the name of the salmon when the salmon is scaly:

say "very scaly ".

Section 3 - Scenario Puzzles

Definition: Aunt Fiona is unsolved if she is inflated.

Definition: the salmon is unsolved:

if the salmon is off-stage, no;

if the salmon is scaly, yes;

no.

The deflating powder resolves Aunt Fiona.

Instead of putting the deflating powder on Aunt Fiona:

try throwing the deflating powder at Aunt Fiona.

Instead of giving the deflating powder to Aunt Fiona:

try throwing the deflating powder at Aunt Fiona.

Instead of throwing the deflating powder at Aunt Fiona:

if Aunt Fiona is inflated:

say "You toss some of the powder in Aunt Fiona's direction, and with a sudden gaseous HUFF! she returns to her usual shape and size. [paragraph break]'Well!' she says, brushing herself off. 'That was bracing!' [paragraph break]You give her an embarrassed smile, to apologize for not curing her faster.";

now Aunt Fiona is deflated;

increase the score by 2;

otherwise:

say "[one of]You throw another hefty dose of the powder at your aunt. [paragraph break]'Thank you, child,' she says, sneezing. 'But I think you've done enough now.'[or]You throw another hefty dose of the powder at your aunt. [paragraph break]'You're too kind,' she wheezes, through a cloud of glittering dust.[or]You've probably done enough with the powder.[stopping]".

Every turn when Aunt Fiona is deflated and the salmon is off-stage:

move the salmon to the counter;

say "'At least they didn't get this,' she says, producing from somewhere on her person a fresh-caught salmon. An odd pattern around its eye sockets makes it looks comically as though it wears spectacles. 'It's the Salmon of Knowledge,' she explains casually. 'We just need to scale and cook it.'"

The bottle of descaling solution resolves the salmon.

Does the player mean putting the descaling solution on the fish hook: it is unlikely.

Does the player mean putting the descaling solution on the salmon: it is very likely.

Instead of putting the bottle of descaling solution on the salmon:

if the salmon is scaly:

now the salmon is prepared;

say "With just a single squirt of the descaling solution (which confusingly has a picture of bathroom tiles on the label), you remove the scales from the salmon, leaving its pink flesh ready for preparation.";

increase the score by 2;

otherwise:

say "'Don't do that,' Aunt Fiona warns you. 'Excessive applications could damage the flesh.'"

Test me with "look / get powder / drop powder / look / look in cabinet / get powder / put powder on fiona / look / open cabinet / look in cabinet / get solution / open fridge / put solution in fridge / look / get solution / put solution on salmon / look".

wi 18.28 Printing a locale paragraph about
rb 3.1 Room Descriptions

🔗

RB §3.2 Map

A work of IF contains many spectacles and activities, and these must not all present themselves at once, or the player will be overwhelmed. One way to spread them out is in time, by having them available only as a plot develops, but another is to spread them out literally in space. The player has to walk between the Library and the Swimming Pool, and thus bookish and athletic tasks are not both presenting themselves at once. There have been valiant "one-room" IFs, and it forms a respectable sub-genre of the art, but most works of any size need a map.

Inform, following IF conventions, divides the world up into locations called "rooms", connected together by so-called "map connections" along compass bearings. Thus:

The Library is east of the Swimming Pool.

The example Port Royal ★ develops a medium-sized map from such sentences. This develops in Port Royal 2 ★ to include connections which bend around, allowing the rooms not to lie on an imaginary square grid.

Because it is useful to group rooms together under names describing whole areas, Inform also allows rooms to be placed in "regions". Thus:

The Campus Area is a region. The Library and the Swimming Pool are in the Campus Area.

Port Royal 3 ★ demonstrates this further. A&E ★★ shows how regions can be used to write simple rules which regulate access to and from whole areas of the map.

Many old-school IF puzzles involve journeys through the map which are confused, randomised or otherwise frustrated: see Bee Chambers ★ for a typical maze, Zork II ★ for a randomised connection, Prisoner's Dilemma ★★ for a change in the map occurring during play. A completely random map takes us away from traditional IF and more towards a different sort of old-school game, the computerised role-playing game with its endless quests through dungeons with randomly generated treasures and monsters. This style of map - building itself one step at a time, as the player explores - can sometimes be useful to provide an illusion of infinite expanse: see All Roads Lead To Mars ★.

While the standard compass directions are conventional in IF, there are times when we may want to replace them without other forms of directional relationship. Indirection ★ renames the compass directions to correspond to primary colors, as in Mayan thinking. The World of Charles S. Roberts ★★ substitutes new ones, instead, introducing a hex-grid map in place of the usual one.

Examples

5. Port Royal 1 ★

"1691"

Fort James is a room. "The enclosure of Fort James is a large, roughly hexagonal court walled with heavy stone. The walls face the entrance to Port Royal Harbour, and the battery of guns is prepared to destroy any enemy ship arriving."

Unless we arrange otherwise, this will be the first room in the game because it is the first we have defined.

For subsequent rooms, we do not have to say explicitly that they are rooms, as long as they are connected to a room on the map. For instance, this will automatically make Thames Street End a room:

Thames Street End is south of Fort James. "The ill-named Thames Street runs from here -- at the point of the peninsula -- all the way east among houses and shops, through the Fish Market, edging by the round front of Fort Carlisle, to the point where the town stops and there is only sandy spit beyond. Lime Street, wider and healthier but not as rich, runs directly south, and to the north the road opens up into the courtyard of Fort James."
 
Water Lane is east of Thames Street End. "Here Thames Street -- never very straight -- goes steeply southeast for a portion before continuing more directly to the east.
 
Water Lane runs south toward Queen Street, and facing onto it is the New Prison -- which, in the way of these things, is neither.  It did serve in that capacity for a time, and in a measure of the villainy which has been usual in Port Royal from its earliest days, it is nearly the largest building in the town."

If we have some concern that the room name will be confused with an existing name, we can be more explicit about it using "called":

East of Water Lane is a room called Thames Street at the Wherry Bridge.  Thames Street at the Wherry Bridge has the description "To the southwest is the fishmarket; directly across the street is the entrance to a private alley through a brick archway."
 
The Private Alley is south of Thames Street at the Wherry Bridge. "You're just outside the tavern the Feathers. To the north, under a pretty little archway, is the active mayhem of Thames Street, but the alley narrows down to a dead end a little distance to the south."

And now we get "inside", which generates a space treated as its own area on the map.

The Feathers is inside from the Private Alley.  "Newly built with brick, replacing the older Feathers tavern that used to stand here. It sells wines in quantity, as well as serving them directly, and the goods are always of the best quality. There's a room upstairs for those wanting to stay the night." The Feathers Bedroom is above the Feathers.

And if we like we can declare a number of rooms for which we will come back and write the descriptions later. There is no obligation for the description to occur at the first definition of the room.

Lime Street is south of Thames Street End.

For efficiency, we can also write multiple sets of connections at once:

Queen Street East is east of Queen Street Middle and south of Private Alley.

Clicking Go will translate this description into a sketchy but working simulation of Port Royal, in which we can type movement commands like EAST or SOUTH to explore the streets. Looking at the World tab of the Index, we can also see a schematic map of the simulation as it currently stands. Like the rest of the Index, this is provided entirely for the author's benefit, and is not visible to the player. (Though if we do decide that we want players to have access to a printed map while they play, Inform can help: we will return to the layout of Port Royal in the chapter on Publishing.)

The following Test command allows us to type TEST ME and explore the map we just devised:

Test me with "s / e / e / s / in".

wi 3.2 Rooms and the map
rb 3.2 Map

8. Port Royal 2 ★

"1691"

Thames Street End is a room.

If we check out a map of historic Port Royal, we find that Thames Street End bends around the northwest tip of the peninsula and becomes the (very) roughly north/south Fisher's Row. We can't put Fisher's Row south of Thames Street End, though, because Lime Street is already going that way. So instead, let's have a map connection that bends around from west to north:

West of Thames Street End is north of Fisher's Row.

Now continuing west along Thames Street, or north along Fisher's Row, will bring us around the corner in question. Asymmetric map connections should be used carefully. They're good for representing the layout of the real world, which tends not to be laid out on a convenient square matrix, but if exits are not described clearly they can be disorienting for the player. So let's be sure to make things clear:

The description of Fisher's Row is "A waterfront street that runs south towards Chocolata Hole, where the small craft are harboured. It also continues north around the tip of the peninsula from here, turning into the east-west Thames Street."

Meanwhile, suppose Fort James is in a prominent position, raised a bit from its surroundings; maybe the player should be able to go down from there, as well as south, to get to Thames Street End.

Thames Street End is down from Fort James. Thames Street End is south from Fort James.

But we don't want the upward direction to work:

Up from Thames Street End is nowhere.
 
Test me with "n / d / u / w / e / n / s".

wi 3.3 One-way connections
rb 3.2 Map

10. Port Royal 3 ★

"1691"

We should go ahead and do all our room definitions first…

Fort James is a room. "The enclosure of Fort James is a large, roughly hexagonal court walled with heavy stone.  The walls face the entrance to Port Royal Harbour, and the battery of guns is prepared to destroy any enemy ship arriving."
 
Thames Street End is south of Fort James. "The ill-named Thames Street runs from here -- at the point of the peninsula -- all the way east among houses and shops, through the Fish Market, edging by the round front of Fort Carlisle, to the point where the town stops and there is only sandy spit beyond.  Most of that stretch is full of people at all hours.  Imported goods are moved off of ships and taken to distributors; exported goods are brought to be loaded; and there is one public house and brothel for every ten inhabitants.
 
Lime Street, wider and healthier but not as rich, runs directly south, and to the north the road opens up into the courtyard of Fort James."
 
Lime Street is south of Thames Street End. West of Thames Street End is north of Fisher's Row. The description of Fisher's Row is "A waterfront street that runs south towards Chocolata Hole, where the small craft are harboured. It also continues north around the tip of the peninsula from here, turning into the east-west Thames Street."
 
Thames Street End is down from Fort James. Up from Thames Street End is nowhere.
 
Water Lane is east of Thames Street End. "Here Thames Street -- never very straight -- goes steeply southeast for a portion before continuing more directly to the east.
 
Water Lane runs south toward Queen Street, and facing onto it is the New Prison -- which, in the way of these things, is neither.  It did serve in that capacity for a time, and in a measure of the villainy which has been usual in Port Royal from its earliest days, it is nearly the largest building in the town."
 
East of Water Lane is a room called Thames Street at the Wherry Bridge.  Thames Street at the Wherry Bridge has the description "To the southwest is the fishmarket; directly across the street is the entrance to a private alley through a brick archway."
 
The Fishmarket is southwest of Thames Street at the Wherry Bridge.
 
The Private Alley is south of Thames Street at the Wherry Bridge. "You're just outside the tavern the Feathers. To the north, under a pretty little archway, is the active mayhem of Thames Street, but the alley narrows down to a dead end a little distance to the south."
 
The Feathers is inside from the Private Alley.  "Newly built with brick, replacing the older Feathers tavern that used to stand here. It sells wines in quantity, as well as serving them directly, and the goods are always of the best quality. There's a room upstairs for those wanting to stay the night." The Feathers Bedroom is above the Feathers.
 
Thames Street by the King's House is east of Thames Street at the Wherry Bridge.  "The King's House is reserved for the use of the Governor, but he does not live in it, and it is frequently being rented out to some merchant so that the government will at least derive some value from it. It is nearly the least interesting establishment on Thames Street, and the crowd -- which, to the west, is extremely dense -- here thins out a bit."
 
Thames Street before Fort Carlisle is east of Thames Street by the King's House. "Here Thames Street, formerly a respectable width, narrows to a footpath in order to edge around the front of Fort Carlisle, underneath the mouths of the cannon.
 
There are no buildings on the harbour side of Thames Street at this point, which means that you have an unusually good view of the ships at dock, water beyond, and the Blue Mountains rising on the other side of the harbour."
 
South of Thames Street before Fort Carlisle is a room called Fort Carlisle. The description of Fort Carlisle is "Handsomely arrayed with cannons which you could fire at any moment -- though of course there are ships at dock which might be in the way."
 
Queen Street End is south of Lime Street.
 
Queen Street Middle is east of Queen Street End.
 
Queen Street East is east of Queen Street Middle and south of Private Alley.
 
Queen Street at the Prison is east of Queen Street East.

Now, if we like, we can create regions to distinguish the coast from the portions of town that aren't on the water:

Inland is a region. Queen Street End, Queen Street Middle, Queen Street East, Private Alley, Lime Street, and Queen Street at the Prison are in Inland.
 
Waterfront is a region. Thames Street before Fort Carlisle, Thames Street by the King's House, Thames Street at the Wherry Bridge, Water Lane, Fishmarket, Fisher's Row, and Thames Street End are in Waterfront.

There's no rule that regions must be contiguous, so we could if we like make a region consisting just of the two forts:

Military Holdings is a region. Fort Carlisle and Fort James are in Military Holdings.

And we might make the Feathers Tavern part of the Inland area, but within its own subcategory:

Tavern is a region. It is in Inland. Feathers and Feathers Bedroom are in Tavern.

Now the index map will be colored to reflect our regions, and later in the game development we would be able to make rules that affect just one region at a time.

wi 3.4 Regions and the index map
rb 3.2 Map

78. All Roads Lead to Mars ★

Suppose we want to allow the player to wander freely in any direction, but ourselves maintain control over the order in which he encounters the rooms. This sort of effect emphasizes the order of the story-telling over any kind of rigorous simulation of space; on multiple play-throughs, the player might not find all the same rooms in the same locations.

"All Roads Lead to Mars"

Before going a direction (called way) when a room (called next location) is not visited:

let further place be the room the way from the location;

if further place is a room, continue the action;

change the way exit of the location to the next location;

let reverse be the opposite of the way;

change the reverse exit of the next location to the location.

The Open Plain is a room. "A wide-open grassy expanse, from which you could really go any way at all."

The Hilly Place is a room. "The grassland gives way to a somewhat more hilly area, though there is still very little to guide you any particular way."

The Stream is a room. "This is the third place you've been today, and so the stream is welcome. How refreshing!"

Test me with "n / s / e / e".

If we wanted still to be able to find routes between places, we could define a relationship of connection between rooms, which we would add to as we went along.

wi 6.14 Adjacent rooms and routes through the map
rb 3.2 Map

125. Bee Chambers ★

Mazes are a traditional element of interactive fiction, often consisting of apparently identical rooms with exits that do not work reciprocally and which cause confusion.

The methods of mapping mazes are now fairly well understood and mazes themselves tend to be regarded as tiresome rather than enjoyable by a large portion of the playing audience. However, if we did want to ignore the common wisdom and create a maze, randomly generated at the start of play, here would be one way to go about it:

"Maze of Gloom"

A Bee Chamber is a kind of room. The printed name of a Bee Chamber is usually "Hexagonal Room". The description of a Bee Chamber is usually "Waxy, translucent walls surround you on six sides; the floor and ceiling are made of the same material, gently uneven. There are exits in every direction, cut into the faces or the corners."

Bee1, Bee2, Bee3, Bee4, Bee5, Bee6, Bee7, Bee8, Bee9, and Bee10 are Bee Chambers.

When play begins:

now right hand status line is "[number of visited rooms]/[number of rooms]";

repeat with place running through Bee Chambers:

now a random Bee Chamber is mapped north of place;

now a random Bee Chamber is mapped northwest of place;

now a random Bee Chamber is mapped west of place;

now a random Bee Chamber is mapped southwest of place;

now a random Bee Chamber is mapped south of place;

now a random Bee Chamber is mapped southeast of place;

now a random Bee Chamber is mapped east of place;

now a random Bee Chamber is mapped northeast of place;

now a random Bee Chamber is mapped above place;

now a random Bee Chamber is mapped below place;

now a random Bee Chamber is mapped inside place;

now a random Bee Chamber is mapped outside place.

Test me with "in / out / up / down / n / ne / nw / e / w / sw / se / s".

wi 8.11 Now...
rb 3.2 Map

134. Zork II ★

All we need to do is select the player's destination for him at random:

"Zork II"

The Carousel Room is a room.

Instead of going from the Carousel Room:

move the player to a random adjacent room.

To avoid infringing the original game too much, let's try a somewhat different setting:

The Games of Chance is north of the Carousel Room. The Haunted Funhouse is northwest of the Carousel Room. The Ferris Wheel is east of the Carousel Room. The Topsy-Turvy is northeast of the Carousel Room. The Reproduction Henge is south of the Carousel Room. The Women's Toilet is southwest of the Carousel Room. The Men's Toilet is southeast of the Carousel Room. The Cotton Candy Shop is west of the Carousel Room.
 
Test me with "s".

And the following means that the test runs consistently even though the numbers are theoretically random. To make them truly random, remove this line.

When play begins, seed the random-number generator with 1234.

Or if we want to add the refinement that the Carousel Room can be switched off:

"Zork II"

The Carousel Room is a room. The spinning machine is a switched on device in the Carousel Room.

And then

Instead of going from the Carousel Room when the spinning machine is switched on:
   move the player to a random adjacent room.
 
The Games of Chance is north of the Carousel Room. The Haunted Funhouse is northwest of the Carousel Room. The Ferris Wheel is east of the Carousel Room. The Topsy-Turvy is northeast of the Carousel Room. The Reproduction Henge is south of the Carousel Room. The Women's Toilet is southwest of the Carousel Room. The Men's Toilet is southeast of the Carousel Room. The Cotton Candy Shop is west of the Carousel Room.
 
Test me with "turn off machine / s / n / turn on machine / s".
 
When play begins, seed the random-number generator with 1234.

wi 8.19 Random choices of things
rb 3.2 Map

286. Indirection ★

In Mayan culture, colours seem to have been used as names for the primary directions: for instance, "red" implies east as the colour of sunrise. So the following might be a stylish touch for a game in which the player has to get inside the Mayan world-view:

"Indirection"

Understand "white" and "sac" as north. Understand "red" and "chac" as east. Understand "yellow" and "kan" as south. Understand "black" and "chikin" as west.

We could also use a colour as a verb:

Understand "turquoise" and "yax" as looking.

And now a few extra rooms to try it out in:

The Square Chamber is a room. "A sunken, gloomy stone chamber, ten yards across. A shaft of sunlight cuts in from the steps above, giving the chamber a diffuse light, but in the shadows low lintelled doorways to east and south lead into the deeper darkness of the Temple."
 
The Wormcast is east of the Square Chamber. The Corridor is south of the Square Chamber.
 
Test me with "kan / white / chac / black".

wi 17.1 Understand
rb 3.2 Map

40. Prisoner's Dilemma ★★

We can change the directions in the map in mid-game, though in practice this is rarely necessary. But suppose we do not want a door or any sign of a door to exist before the player takes some action, in this case pressing a button:

"Prisoner's Dilemma"

Challenger's Waiting Room is a room. "The challenge is this: to wait as long as you can endure to do so in a room with no features and no clock. If you wait longer than all the other contestants, you win."

The button is fixed in place in the Challenger's Waiting Room. "The only item in view is a black recessed button."

Amid the Cheering Throng is a room.

Instead of pushing the button for the first time:

change the east exit of the Challenger's Waiting Room to Amid the Cheering Throng;

change the west exit of the Cheering Throng to the Challenger's Waiting Room;

say "With a groan of gears, the east wall swings open! If you've lost now, well, you've lost..."

Test me with "e / push button / e / w".

Our instructions about pushing the button will be further explained in the chapter on Actions, but the thing to note here is that we can "change (whatever) exit" in order to set or re-set map directions. Notice that we have to set both directions explicitly: changing the east exit of the Waiting Room does not automatically also change the west exit of Amid the Cheering Throng.

This allows greater flexibility in our games but does require an extra line or so of work.

wi 3.26 Directions
rb 3.2 Map

41. The World of Charles S. Roberts ★★

Wargaming is an ancient pursuit, but its modern form began as a professional training exercise in 19th-century Prussian staff colleges; since at least as early as H. G. Wells's "Little Wars" (1913) it has been a hobby of "boys from twelve years of age to one hundred and fifty and for that more intelligent sort of girl who likes boys' games and books." The free-form tabletop game used miniature figures and tape-measured movements, and remains the dominant form today. But in the mid-20th century, map grids on printed sheets gave the hobby a sudden new lease of life. They were easier to set up, more interesting to look at, cheaper to sell by mail-order. 1970s sales figures for "Strategy and Tactics", the leading US subscription-based wargame distributor, were very similar to those of Infocom's IF games in the 1980s. And like classical IF, the grid-based wargame parceled up a continuous world into locations.

Grids were initially square, as on a chessboard, but square cells have several disadvantages. Four directions of movement (N, E, S, W) is too few, yet allowing movement in the diagonal directions means allowing tanks to travel about 1.4 times faster northeast than they do north. Square grids also only conform cleanly to man-made landscape features such as buildings in one orientation, and they never fit hills well. (A compromise measure to fix this, cutting the squares into octagons to leave smaller diamond squares at corner intersections, has never caught on.)

But following Charles S. Roberts's American Civil War designs for Avalon Hill of 1958-61 (notably "Chancellorsville" and the second edition of "Gettysburg"), a hexagonal grid became the new standard. Each hexagon is the same distance from the centre of all six of its neighbours, which are at equal angular spacings; and clumps of hexagons fit the shape of lakes, contoured hills, and so forth, much more naturally than clumps of squares do. Hexes also have a certain mystique - an air of "I don't belong in the children's department".

But hexes are tricky for IF, not least because English lacks words for "the direction 60 degrees around from front". Our cognitive view of the world tends to be square, perhaps because our two eyes both face front, in a direction at right angles to the plane of our arms, legs, pelvis and eyes. We reach out sideways at right angles to our walking. Even early hex-grid wargames called the cells "squares", though "hexes" eventually caught on. Still and all:

"The World of Charles S. Roberts"

Forward is a direction. Forward has opposite backward. Understand "f" as forward.

Backward is a direction. Backward has opposite forward. Understand "b" and "back" as backward.

Forward left is a direction. Forward left has opposite backward right. Understand "fl" as forward left.

Forward right is a direction. Forward right has opposite backward left. Understand "fr" as forward right.

Backward left is a direction. Backward left has opposite forward right. Understand "bl" as backward left.

Backward right is a direction. Backward right has opposite forward left. Understand "br" as backward right.

Now to forbid the use of the compass directions:

A direction can be hexagonal or squared-off. A direction is usually squared-off. Forward, backward, forward left, forward right, backward left and backward right are hexagonal.
 
Before going a squared-off direction, say "In this hexagonally-divided landscape, squared-off directions are not allowed." instead.

A slight nuisance is that, with things as they are above, typing BACKWARD produces the response "Which do you mean, backward, backward left or backward right?" To avoid that silly question, we write:

Does the player mean going backward: it is very likely. Does the player mean going forward: it is very likely.

And now a clump of 37 hexes, in six columns of six or seven rooms each. There are many ingenious ways we could put this map together automatically, but instead we will take a deep breath and write:

E1 is forward of E2. "Open farmland." E2 is forward of E3. "The edge of woods." E3 is forward of E4. "Deep woodland." E4 is forward of E5. "Deep woodland." E5 is forward of E6. "The rear edge of woods." E6 is forward of E7. "The start of a road leading forward right." E7 is a room. "Grassland."
 
F1 is forward of F2. "The edge of farmland." F2 is forward of F3. "The edge of woods." F3 is forward of F4. "Clearing in woods." F4 is forward of F5. "Deep woodland." F5 is forward of F6. "A road runs backward left to forward right." F6 is a room. "The edge of grassland."
 
G1 is forward of G2. "Grassland." G2 is forward of G3. "The edge of farmland." G3 is forward of G4. "A copse of trees." G4 is forward of G5. "The backward edge of woodland." G5 is forward of G6. "A bend in the road, from backward left to backward right." G6 is forward of G7. "Open farmland." G7 is a room. "Open farmland."
 
H1 is forward of H2. "Grassland, bordered by a hedge to the right." H2 is forward of H3. "The edge of farmland, with a hedge to forward right." H3 is forward of H4. "A copse of trees." H4 is forward of H5. "Open farmland." H5 is forward of H6. "A passing place on the road, which bends forward left to forward right." H6 is a room. "Open farmland."
 
I1 is forward of I2. "The end of a forward road, blocked by hedges on all sides except backward." I2 is forward of I3.  "A straight road runs forward to backward, with long hedges to left and right." I3 is forward of I4.  "A straight road runs forward to backward, alongside a long hedge to right." I4 is forward of I5.  "A straight road runs forward to backward, alongside a long hedge to right." I5 is forward of i6. "Where three roads, forward, backward left and backward right, meet. Forward right is a thick hedge." i6 is forward of i7. "Open farmland." i7 is a room. "Open farmland."
 
J1 is forward of J2. "Dense woodland, with a hedge to left." J2 is forward of J3. "Grassland, with a hedge to left." J3 is forward of J4. "The edge of farmland, with a hedge to left." J4 is a room. "Open farmland, with a long hedge blocking movement forward left, backward left or backward." J5 is forward of J6. "A road running forward left to backward right, alongside a hedge." J6 is a room. "Open farmland."
 
F1 is forward right of E2 and backward right of E1. F2 is forward right of E3 and backward right of E2. F3 is forward right of E4 and backward right of E3. F4 is forward right of E5 and backward right of E4. F5 is forward right of E6 and backward right of E5. F6 is forward right of E7 and backward right of E6.
 
G1 is forward right of F1. G2 is forward right of F2 and backward right of F1. G3 is forward right of F3 and backward right of F2. G4 is forward right of F4 and backward right of F3. G5 is forward right of F5 and backward right of F4. G6 is forward right of F6 and backward right of F5.
 
H1 is forward right of G2 and backward right of G1. H2 is forward right of G3 and backward right of G2. H3 is forward right of G4 and backward right of G3. H4 is forward right of G5 and backward right of G4. H5 is forward right of G6 and backward right of G5. H6 is forward right of G7 and backward right of G6.
 
I3 is forward right of H3 and backward right of H2. I4 is forward right of H4 and backward right of H3. I5 is forward right of H5 and backward right of H4. i6 is forward right of H6 and backward right of H5.
 
J5 is forward right of i6 and backward right of I5. J6 is forward right of i7 and backward right of i6.

And now we have a hexagonally-gridded world. Route-finding will work; prepositional forms like "to be mapped backward left of" exist, just as they should; and in general these directions are just as good as the square ones. (The only thing which doesn't look good is the Index map, where Inform is just unable to draw a picture because it assumes a square grid. But that has no effect on play.)

The landscape is much easier to navigate with a little diagram:

To say legend (D - direction):
   let destination hex be the room D from the location;
   if the destination hex is nothing, say "  ";
   otherwise say the destination hex.
 
Carry out looking:
   say "[fixed letter spacing]   \ [legend forward] /[line break][legend forward left]  ----  [legend forward right][line break]   /    \[line break]--<  [location]  >--[line break]   \    /[line break][legend backward left]  ----  [legend backward right][line break]   / [legend backward] \[variable letter spacing][line break]".

And finally:

The player is in I5.
 
Test me with "f / forward / backward left / bl / br / br / f".

wi 3.26 Directions
rb 3.2 Map

101. A&E ★★

Rules about going to regions make it easy to exclude the player from a large portion of the map, even if there are many connecting paths to the region. For instance, in this story it would be annoying to have to write a rule about all four exits by which the player could reach the film set area:

"A&E"

Winding Street is a room. Winding Street is west of Duck Pond. Sloping Street is north of Winding Street, northwest of Duck Pond, west of Stately Lawn, and southwest of Stately Home. Stately Lawn is north of Duck Pond. Stately Home is north of Stately Lawn.

Film Set is a region. Duck Pond, Stately Lawn, and Stately Home are in Film Set.

Instead of going to Film Set when the player does not carry the VIP Pass: say "A burly studio guard materializes in your path, convincing you that you would prefer to be elsewhere."

The VIP Pass is in the garbage can. The garbage can is in Sloping Street.

After going to the Film Set:

say "Success! At last you are inside the set of 'Prouder and More Prejudiced'. Next step: locating Mr Firth.";

end the story finally.

Test me with "e / n / e / get pass / e".

wi 7.13 Going from, going to
rb 3.2 Map

🔗

RB §3.3 Position Within Rooms

Inform's division of geography into "rooms" is a good compromise for most purposes. The rooms are cut off from each other by (imaginary or actual) walls, while all of the interior of a given room is regarded as the same place.

Suppose we want things to happen differently in different corners of the same room? Inform can already do this a little, in that the player can be inside an enterable container or on an enterable supporter. For instance:

Instead of opening a door when the player is on the bed, say "You can't reach the handle from the bed."

If we need to have divided-up areas of the floor itself, the standard approach is to define a small number of named positions. We then need to remember at which of these locations the player (or something else) currently stands.

Further Reasons Why All Poets Are Liars ★ allows the player to be in different parts of a room by standing on a box which can be in different places: thus only the box needs an internal position, not the player, simplifying matters neatly.

Another interesting case is when one room is entirely inside another (such as a hut in a field, or a booth in a large convention hall), so that the exterior of the room should be visible from another location. Starry Void ★★★ gives a simple demonstration of a magician's booth that can be examined from the outside, opened and closed, and entered to reach a new location.

Examples

199. Further Reasons Why All Poets Are Liars ★

We begin with the location and its fittings, and we create a kind of value which names the different internal positions we will allow.

"Further Reasons Why All Poets Are Liars"

Nook Obscure is a room. "Above the College kitchens, which make a humming sound, less tuneable than bees, but hardly less industrious, with shrill notes of sharp command and scolding intermixed: and below Trinity's loquacious clock, who never lets the quarters, night or day, slip by him unproclaimed, and tells the hours twice over with a male and female voice. In short, the kind of rubbish room they give to a northern villager. But you get a bed and a high shelf all of your own. And you long to find some Romantic way to look out of the window."

The window, the shelf and the bed are scenery in the Nook Obscure. The shelf and the bed are supporters. The bed is enterable.

Internal position is a kind of value. The internal positions are nowhere at all, over by the window, under the shelf and near the bed.

The box is an enterable supporter in Nook Obscure. The current box position is an internal position that varies. The current box position is near the bed. "Your packing case, stamped W. WORDSWORTH (KENDAL), is [current box position]." Instead of taking the box, say "It is filled with your peerless rock collection and too heavy to lift, but could be pushed." Instead of opening the box, say "It is securely nailed shut."

We create an action, "pushing it over to", for pushing a box around on the floor of a single location. (Calling this "pushing it over to" prevents clashes with the existing "pushing it to" action, which is for pushing things from one room to another.) Almost half of the text which defines the action is concerned with the two action variables, but they make the implementation of everything else so much easier that we end up writing less than if we hadn't used them.

Understand "push [box]" as a mistake ("You can push the box to the window, the bed or the shelf.").
 
Understand "push [something] to [something]" as pushing it over to. Pushing it over to is an action applying to two things.
 
The pushing it over to action has an internal position called the old position.
The pushing it over to action has an internal position called the new position.
Setting action variables for pushing something over to something:
   now the old position is the current box position;
   now the new position is nowhere at all;
   if the second noun is the window, now the new position is over by the window;
   if the second noun is the bed, now the new position is near the bed;
   if the second noun is the shelf, now the new position is under the shelf.
 
Check pushing it over to:
   if the noun is not the box, say "That's not something you can push." instead;
   if the player is on the bed, say "You can't reach from here." instead;
   if the player is on the noun, say "Not while you are standing on [the noun]." instead;
   if the new position is nowhere at all, say "You can only push [the noun] to the window, the bed or the shelf." instead;
   if the new position is the old position, say "The [noun] is already [new position]." instead.
Carry out pushing it over to:
   now the current box position is the new position.
Report pushing it over to:
   say "With some effort, you shove [the noun] from [old position] to [new position]."

Everything which remains simply provides a couple of puzzles to test this arrangement.

Euclid's Elements is on the shelf. Understand "euclid" or "book" as the Elements.
Instead of taking something (called the item) which is on the shelf:
   if the player is on the box and the current box position is under the shelf, continue the action;
   say "You cannot reach [the item], which is up on the shelf."
 
Instead of examining the window:
   say "This window opens rather unpromisingly onto the chapel wall opposite, so even granted the moonlight it is dark in here. Still, surely there's a poem here somewhere?"
 
Instead of examining the window when the player is on the bed:
   say "Just a blank patch of chapel wall."
 
Instead of examining the window when the player is on the box:
   if the current box position is near the bed:
      say "Tantalisingly, you are not quite able to spy the statue.";
   otherwise if the current box position is under the shelf:
      say "All you can see is the antechapel wall, and the dull silver gleam of the pealing organ.";
   otherwise:
      say "At last! You can just, standing on tiptoes on the box right up at the window, make out the top of the statue! Of such epiphanies are Poesy born. Let's see now... oh yes...[paragraph break]And from my pillow, looking forth by light[line break]Of moon or favouring stars, I could behold[line break]The antechapel where the statue stood[line break]Of Newton with his prism and silent face,[line break]The marble index of a mind for ever[line break]Voyaging through strange seas of Thought, alone.";
      end the story finally.
 
Test me with "get on bed / x window / get off / x window /get elements / get on box / x window / get elements / push box to shelf / get off / push box to shelf / get on box / get elements / x window / get off / push box to window / get on box / x window".

wi 12.10 Action variables
rb 3.3 Position Within Rooms

7. Starry Void ★★★

Sometimes we may want a room to be visible from the outside in one location, but treated as a separate location when we are inside. The simplest way to do this is to make the exterior form of the object into a door object, and to describe it differently from different vantage points. (Doors in general are described more fully in the Doors section of the Things chapter.)

"Starry Void"

The Center Ring is a room.

The magician's booth is a door. "[if the player is in Center Ring]A magician's booth stands in the corner, painted dark blue with glittering gold stars.[otherwise if the magician's booth is closed]A crack of light indicates the way back out to the center ring.[otherwise]The door stands open to the outside.[end if]".

Here we've arranged for the booth to be described in the initial room description in different ways depending on where the player is when viewing it. We might like to do the same if the player takes a closer look:

Instead of examining the magician's booth in the Center Ring:
   say "It is dark blue and glittering with gold stars. [if the booth is open]The door currently stands open[otherwise]It has been firmly shut[end if]."
 
Instead of examining the magician's booth in the Starry Void:
   say "The booth door is [if the magician's booth is open]wide open[otherwise]shut, admitting only a thin crack of light[end if]."

And now we put it in place:

The magician's booth is inside from Center Ring and outside from Starry Void.

…and make sure that the booth-and-door object responds to all the names we have used for it in different places:

Understand "door" or "of" or "the" or "light" or "crack" or "thin crack" as the booth.
 
Test me with "examine booth / open door of the booth / in / examine door / close door / look / examine crack of light".

A final nice touch, if we're so inclined, is to borrow from the Basic Actions chapter and make the player automatically open the booth door before trying to enter:

Before going through the closed magician's booth:

say "(first opening the door of the booth)[command clarification break]";

silently try opening the booth.

For the contrasting case of a space that is nested inside another place and is not its own room -- say a stall at an open-air market, or a rowboat on a lake -- see the example "Tamed".

wi 3.2 Rooms and the map
rb 3.3 Position Within Rooms

🔗

RB §3.4 Continuous Spaces and The Outdoors

Suppose we want to blur the boundaries between rooms, in an environment where there are no walls: out of doors, for instance?

The simplest cases involve making something exceptional visible in more than one place. Carnivale ★★ features an exceptionally large landmark seen by day; Eddystone ★★ an exceptionally bright one by night. Waterworld ★ allows a very distant object (the Sun) to be seen throughout many rooms, but never approached. View of Green Hills ★★★ gives the player an explicit command for looking through into an adjacent room.

Three systematic examples then present outdoor landscapes with increasing sophistication. Tiny Garden ★★ gives the multiple rooms of an extended lawn descriptions which automatically adapt to say which directions lead into further lawn area. Rock Garden ★★ provides a relation, "connected with", between rooms, allowing items in one to be seen from the other: an attempt to interact with a visible item in a different area of the garden triggers an implicit going action first. Stately Gardens ★★★ provides a much larger outdoor area, where larger landmarks are visible from further away, and room descriptions are highly adaptive.

In an outdoor environment, the distinction between a one-move journey and a multiple-move journey is also blurred. Hotel Stechelberg ★★ shows a signpost which treats these equally.

Examples

216. Waterworld ★

It's tempting to handle the player's inability to interact with something with a simple instead rule:

"Waterworld 1"

A view is a kind of backdrop. Instead of doing something other than examining to a view, say "You are too far from [the noun] to do anything but look."

The sun is a view. It is everywhere. The description is "A blazing sun makes you wish you had never been born."

The Sahara is a room. North of the Sahara is More Sahara. North of More Sahara is Yet Further Sahara.

Test me with "x sun / get sun / n / x sun / n / x sun".

Unfortunately, the rule does not address the case where the object in question is the second noun; so for instance the following example reveals the difficulty:

"Waterworld 2"

A view is a kind of backdrop. Instead of doing something other than examining to a view, say "You are too far from [the noun] to do anything but look."

The player carries a rope.

The sun is a view. It is everywhere. The description is "A blazing sun makes you wish you had never been born."

The Sahara is a room. North of the Sahara is More Sahara. North of More Sahara is Yet Further Sahara.

Test me with "x sun / get sun / n / x sun / n / x sun / tie rope to the sun".

…where the response here behaves as though the sun is in reach. If we had a fully implemented tying action, the player would (even more disastrously) be allowed to lasso celestial objects.

We could add a second instead rule as well:

"Waterworld 3"

A view is a kind of backdrop.

Instead of doing something other than examining when the noun is a view:

say "You are too far from [the noun] to do anything but look."

Instead of doing something other than examining when the second noun is a view:

say "You are too far from [the second noun] to do anything but look."

The player carries a rope.

The sun is a view. It is everywhere. The description is "A blazing sun makes you wish you had never been born."

The Sahara is a room. North of the Sahara is More Sahara. North of More Sahara is Yet Further Sahara.

Test me with "x sun / get sun / n / x sun / n / x sun / tie rope to sun".

wi 12.18 Changing reachability
rb 3.4 Continuous Spaces and The Outdoors

62. Tiny Garden ★★

Sometimes we want to make a list of something too complicated to express in a say list… phrase. When this happens, we can instead mark all the items we want to mention as "marked for listing".

In this case, we have a lawn area made up of four rooms. We want each room to automatically describe the directions leading to the other parts of the lawn. To do this, we will first determine which directions are relevant and mark those for listing, then list them.

"Tiny Garden"

The Herb Garden is a room. "Along this side of the house run your great-aunt's herb beds."

A Grassy Room is a kind of room. The printed name of a Grassy Room is usually "Lawn". The description of a Grassy Room is "The grass underfoot is thick and green. The lawn extends to [grassy directions] from here."

The following phrase goes through all the directions in the compass and marks the ones that are interesting to us at the moment.

To say grassy directions:
   repeat with that way running through directions:
      if the room that way from the location is a grassy room,
         now that way is marked for listing;
   say "[a list of directions which are marked for listing]";
   now every direction is not marked for listing.
 
Lawn1 is west of the Herb Garden. It contains a picnic table and a wicker basket. Lawn2 is south of Lawn1 and southeast of Lawn4. Lawn3 is southwest of Lawn1, west of Lawn2, and south of Lawn4. Lawn4 is west of Lawn1. Lawn4 contains a birdbath. The birdbath is fixed in place.
 
Lawn1, Lawn2, Lawn3, and Lawn4 are Grassy Rooms.
 
Test me with "w / s / w / n".

wi 5.5 Text with lists
rb 3.4 Continuous Spaces and The Outdoors

79. Hotel Stechelberg ★★

The following rule appends a paragraph to every room description. We need not worry about doors (despite the pass in the Bernese Oberland known figuratively as the "Little Door").

"Hotel Stechelberg"

After looking:

say "Yellow arms on the signpost point:-[line break]";

repeat with destination running through interesting rooms:

let the way be the best route from the location to the destination;

if the way is a direction, say " [way] for [the destination]: [number of moves from the location to the destination] Std."

Hotel Stechelberg is a room. "The wooden hiking inn at the end of the road, with flowerboxes, canton flags, outdoor tables and a triangular paddock for the cows contesting the annual Miss Stechelberg competition. Otto and Marianne do cheerful innkeeper things, while the sun blazes from a gentian-blue sky."

A room can be dull or interesting. A room is usually dull.

North of Hotel Stechelberg is Trummelbachfalle. North of Trummelbachfalle is Lauterbrunnen. Lauterbrunnen is interesting.

Southeast of Hotel Stechelberg is Trachsellauenen. Trachsellauenen is interesting.

Test me with "look".

With a bit more work, the result might be:

Hotel Stechelberg
The wooden hiking inn at the end of the road, with flowerboxes, canton flags, outdoor tables and a triangular paddock for the cows contesting the annual Miss Stechelberg competition. Otto and Marianne do cheerful innkeeper things, while the sun blazes from a gentian-blue sky.
 
Yellow arms on the signpost point:-
   north for Lauterbrunnen: 2 Std.
   west for Sefinental: 2 Std.
   west for Schilthorn: 6 Std.
   southeast for Trachsellauenen: 1 Std.
   southeast for Oberhornsee: 3 Std.

wi 6.14 Adjacent rooms and routes through the map
rb 3.4 Continuous Spaces and The Outdoors

212. Carnivale ★★

Suppose we want to make an object that (unlike a backdrop) is definitely located in one room, but can be seen from far off. We want to allow the player to interact with it from a distance, but only using those actions that require visibility. Other actions should be denied:

"Carnivale"

The Fairground is a region. Park Entrance, By the Wheel, and Candy Stand are in Fairground. Candy Stand is north of By the Wheel. Park Entrance is west of Candy Stand and northwest of By the Wheel.

The ferris wheel is scenery in By the Wheel. "It is extravagantly tall and carries several dozen glass gondolas for riders."

The description of By the Wheel is "You stand at the foot of an enormous ferris wheel, which turns far too quickly and never seems to stop for new riders."

The description of Park Entrance is "You are now just inside the gates. Behind you snakes a triple line of fairgoers all the way down the length of the valley to the railway station. Roughly southeast of here is the ferris wheel, towering over the other attractions."

The description of Candy Stand is "A hut in pale pink and baby blue dispenses marshmallow death's-heads, sugar-beetles, and other such treats. The giant ferris wheel is just off to the south from here."

As the descriptions make clear, the ferris wheel should be visible from everywhere in the fair, so we'll borrow a line from the Activities chapter to make that happen:

After deciding the scope of the player:
   if the location is in Fairground, place the ferris wheel in scope.

"Scope" determines what the player can interact with; by writing this rule, we make Inform understand all commands that refer to the ferris wheel when the player is anywhere in the fairground, instead of responding with

You can't see any such thing.

as it normally would.

Now, by default, if the player were to type TOUCH FERRIS WHEEL while in another room, he would get the response

You can't reach into By the Wheel.

This may not be quite what we want, but we can replace this text with our own reaching inside rule:

Rule for reaching inside a room:
   say "You can only look from this distance.";
   deny access.

And because our accessibility rules are considered before the "Instead" phase, we can write the following rule confident that it will apply only when the player is in fact in range to touch the ferris wheel:

Instead of touching the ferris wheel:
   say "You don't dare: it's spinning too fast."
 
Test me with "x ferris wheel / touch ferris wheel / se / x ferris wheel / touch ferris wheel".

wi 12.16 Reaching inside and reaching outside rules
rb 3.4 Continuous Spaces and The Outdoors

213. Eddystone ★★

Using the compass directions in commands is a little bit finicky because directions are forbidden to figure in any interactions involving touch. (Really, directions are more a concept than an object; this is a compromise situation.) In any case, if we want to write a new command involving these, we need to be sure to specify that the direction is a visible thing. For instance:

"Eddystone"
 
The Lighthouse is a room. "A lonely place, but in these tense times, no one but the lighthouse keeper and a few trusted agents are allowed on the grounds at all, for fear of sabotage."
 
The light is a fixed in place thing in the Lighthouse.  "At the center of the room is the light itself, a 1000-Watt tungsten halogen light powered by diesel generator, and having a visible range of twenty-six nautical miles." Understand "lamp" as the light. It is lit. The light has a a direction called heading. The heading of the light is north.
 
A room is usually dark.
 
Understand "turn [something] [a direction]" as reorienting it to. Reorienting it to is an action applying to two things.

will give us

>turn light northeast
You must name something more substantial.

To avoid this mystifying result:

"Eddystone"

The Lighthouse is a room. "A lonely place, but in these tense times, no one but the lighthouse keeper and a few trusted agents are allowed on the grounds at all, for fear of sabotage."

The light is a fixed in place thing in the Lighthouse. "At the center of the room is the light itself, a 1000-Watt tungsten halogen light powered by diesel generator, and having a visible range of twenty-six nautical miles." Understand "lamp" as the light. It is lit. The light has a direction called heading. The heading of the light is north.

A room is usually dark.

Understand "turn [something] [a direction]" as reorienting it to. Reorienting it to is an action applying to one thing and one visible thing.

Instead of turning the light, say "Try turning the light to the direction of your choice."

Check reorienting it to: if the noun is not the light, say "You couldn't do so meaningfully." instead; if the second noun is up or the second noun is down, say "The light only points in compass directions." instead.

And now that's done, we have a little fun calculating where the beam hits:

Carry out reorienting it to:
   now the heading of the light is the second noun;
   let way be the heading of the light;
   let place be the room way from the Lighthouse;
   while place is a room and place is lower than Lighthouse:
      let place be the room way from the place;
   if place is not a room, now the beam is nowhere;
   otherwise move beam to the place.
 
Report reorienting it to: say "The light now points [heading of the light][if the beam is in a room], spotlighting [the holder of the beam][otherwise], into empty space[end if]."
 
The beam is a lit thing. Understand "light" or "brilliant" as the beam. "Brilliant light from the lighthouse floods the whole area." It is fixed in place. Instead of doing something other than examining to the beam: say "The light is, of course, intangible." The description is "The light is coming from the lighthouse, since the lamp is apparently pointed this way."
 
Altitude is a kind of value. 200 ft specifies an altitude. A room has an altitude. The altitude of a room is usually 50 ft. The altitude of the Lighthouse is 100 ft.
 
Definition: a room is low if its altitude is 20 ft or less.
 
The Jetty is south of the Lighthouse. "During daylight hours, a fine place to catch almost unlimited supplies of crayfish. Less entertaining by night."
 
North of the Lighthouse is the Uphill Road. The altitude of Uphill Road is 75 ft. North of Uphill Road is Hilltop. The altitude of Hilltop is 110 ft. The description of Hilltop is "The highest natural point around for miles; sometimes you will sit up here and watch for the lighthouse supply ship, the Lady Loch."
 
Northeast of the Lighthouse is Open Field. East of the Lighthouse is Stanley Creek Valley. The description of Stanley Creek is "This place used to have some other name meaning Ghost Valley in the aboriginal language, but it was piously renamed by missionaries." Train Trestle is east of the Stanley Creek Valley. "The now-abandoned track of the Bush Pacific Railway runs here, above Stanley Creek." The altitude of Train Trestle is 100 ft.
 
Before going from a room (called source) to a room (called destination):
   if source is lower than destination:
      say "It's an uphill climb...";
   otherwise:
      if destination is lower than source, say "You're heading downhill now...";
      otherwise say "It's a straight shot."
 
Test me with "turn lamp / turn lamp down / turn lamp east / e / e".

All very loosely based on the Eddystone Point lighthouse of Tasmania, built in 1889, and forbiddingly remote even today. George Isaacs, a child growing up in the lighthouse, remembers the plentiful crayfish.

wi 12.17 Visible vs touchable vs carried
rb 3.4 Continuous Spaces and The Outdoors

366. Rock Garden ★★

A map of linked rooms works well for modeling enclosed or indoor space, and somewhat less well for modeling large open spaces, where a person should reasonably be able to see things which are much too far away to touch. With some modifications to scoping, though, we can create an environment where objects in nearby rooms are described and viewable, and where the player will automatically move towards distant items before interacting with them physically.

"Rock Garden"

Section 1 - General Rules

Intervisibility relates rooms to each other in groups. The verb to be connected with means the intervisibility relation.

Definition: a room is inter-visible if it is connected with more than one room.

After deciding the scope of the player when the location is an inter-visible room:

repeat with other place running through rooms which are connected with the location:

unless the other place is the location, place the other place in scope.

Rule for reaching inside a room (called target) which is connected with the location:

let way be the best route from the location to the target;

if the way is not a direction:

say "You can't get over to [the target] from here.";

deny access;

say "(first heading [way])[command clarification break]";

try going way;

if the player is in the target, allow access;

otherwise deny access.

After looking when the location is an inter-visible room:

repeat with other place running through rooms which are connected with the location:

if the other place is not the location, describe locale for other place.

Section 2 - The Scenario

Rock Garden West is west of Rock Garden East. Rock Garden East contains a rake. Rock Garden West contains a bench and a maple leaf. The bench is an enterable supporter.

Rock Garden West is connected with Rock Garden East.

Test me with "get rake / drop rake / sit on bench / get rake".

wi 18.29 Deciding the scope of something
rb 3.4 Continuous Spaces and The Outdoors

80. A View of Green Hills ★★★

Suppose a game in which the player is wandering an open landscape with long vistas, allowing him to LOOK in some direction, or even look at an adjacent location.

"A View of Green Hills"

Corinth is a room. Athens is east of Corinth. Epidaurus is southeast of Corinth and east of Mycenae. Mycenae is south of Corinth. Olympia is west of Mycenae. Argos is south of Mycenae. Thebes is northwest of Athens. Pylos is south of Olympia. Sparta is east of Pylos and south of Argos. Delphi is northwest of Thebes.

Understand "look [direction]" as facing.

Facing is an action applying to one visible thing.

Carry out facing:

let the viewed item be the room noun from the location;

if the viewed item is not a room, say "You can't see anything promising that way." instead;

try looking toward the viewed item.

In rules about action handling, "noun" refers to the first object that the player has mentioned in his command, so if the player typed >LOOK WEST, "let the viewed item be the room noun from the location" would be processed as "let the viewed item be the room west from the location", and so on.

We can at need override the default behavior, if it is not going to be appropriate for the player to see the next room over. There is only sky above at any time, so…

Instead of facing up:
   say "Above you is bright sky."
 
Understand "look toward [any adjacent room]" as looking toward. Understand "examine [any adjacent room]" as looking toward.
 
Looking toward is an action applying to one visible thing.
 
Carry out looking toward:
   say "You make out [the noun] that way."

This design allows us to create descriptions for rooms (as seen from the outside) which will work regardless of where we're looking from. For instance:

Instead of looking toward Athens:
   say "Even from here you can make out the silhouette of the Acropolis."
 
Test me with "look north / look south / look up / look east / east / look west".

wi 6.14 Adjacent rooms and routes through the map
rb 3.4 Continuous Spaces and The Outdoors

367. Stately Gardens ★★★

This time we're going to assume that the player can see into any room that is on a line of sight within one or two steps of travel.

"Stately Gardens"

Chapter 1 - Laying Out Rooms

A room can be indoors or outdoors.

Use full-length room descriptions.

After deciding the scope of the player:

repeat with the way running through directions:

let first step be the room the way from the location;

if the first step is a room:

place the first step in scope;

let second step be the room the way from the first step;

if the second step is a room, place the second step in scope;

place the obelisk in scope.

The obelisk is so large that it can be seen from every room. If we had a number of such large monuments we might want to write a systematic routine to handle them, but this will do for now.

The room description heading rule is not listed in the carry out looking rules.

Now, we set things up so that the surrounding areas are described automatically as part of the room description:

Building description is a truth state that varies. Building description is false.
 
After looking when the location is an outdoors room:
   now count of sentences is 0;
   now building description is true;
   repeat with way running through directions:
      let space be the room way from the location;
      if space is an outdoors room, silently try looking toward space;
   if the obelisk is not in the location and the obelisk is unmentioned:
      let the way be the best route from location to the Upper Terrace;
      if the way is a direction, say "[The obelisk] is proudly visible on [the way] horizon. [run paragraph on]";
      increment the count of sentences;
   now building description is false;
   unless the count of sentences is 0:
      say paragraph break.

But perhaps there are a few rooms where we do not wish that to happen, so we'll build in exceptions for those.

After looking in the rose garden:
   say "Otherwise, you are quite cut off.".
 
After looking in the Ha-ha:
   do nothing.

And suppose we want to allow the player to look in any direction:

Understand "look [direction]" or "look to/toward [direction]" as facing.
 
Facing is an action applying to one visible thing.
 
Carry out facing:
   let the viewed item be the room noun from the location;
   if the viewed item is not a room:
      if the location is indoors, say "Your view is restricted by the lack of doors or windows in that direction." instead;
      otherwise say "You can't see anything promising that way." instead;
   try looking toward the viewed item.
 
Instead of facing up:
   say "Above you is bright sky."

We also need to tell distant rooms how to describe themselves.

Understand "look toward [any adjacent room]" as looking toward.
 
Looking toward is an action applying to one visible thing.
 
Check looking toward a room which does not contain something mentionable:
   if building description is false:
      say "You can't make out anything of interest that way." instead.
 
Carry out looking toward:
   now every thing is unmentioned;
   now the chosen direction is the best route from the location to the noun;
   now the second noun is the room the chosen direction from the noun;
   if the noun contains something mentionable:
      repeat with item running through mentionable things in the noun:
         carry out the writing a distant paragraph about activity with the item;
   if the noun contains something mentionable:
      increment the count of sentences;
      choose row count of sentences in the Table of Distance Sentences;
      if the second noun is an outdoors room and the second noun contains something mentionable, say "[both entry] [run paragraph on]";
      otherwise say "[here entry] [run paragraph on]";
   otherwise:
      if the second noun is an outdoors room and the second noun contains something mentionable:
         increment the count of sentences;
         choose row count of sentences in the Table of Distance Sentences;
         say "[there entry] [run paragraph on]";
   if building description is false:
      say paragraph break.

And again, some exception needs to be made for seeing what's in the dip in the ground:

Instead of looking toward the Ha-ha:
   now the chosen direction is the best route from the location to the noun;
   now the second noun is the room the chosen direction from the noun;
   if the second noun is an outdoors room and the second noun contains something mentionable:
      increment the count of sentences;
      choose row count of sentences in the Table of Distance Sentences;
      say "[there entry] [run paragraph on]".

The following is to account for cases where the player types "look toward obelisk" or similar, rather than looking toward a room:

Understand "look toward [something]" as examining.

The following is arguably an unnecessary refinement, but the listing of items in the distance gets a bit repetitive unless we vary the sentence structure.

Chosen direction is a direction that varies.
 
Count of sentences is a number that varies.
 
Table of Distance Sentences

bothherethere
"From here, you make out [a list of mentionable things in the noun] a little way [chosen direction], and, further on, [a list of mentionable things in the second noun].""From here, you make out [a list of mentionable things in the noun] [if the noun is not adjacent to the location]some distance [end if]to [the chosen direction].""From here, you make out [a list of mentionable things in the second noun] some distance [chosen direction]."
"To [the chosen direction] there [is-are a list of mentionable things in the noun], partly obscuring your further view of [a list of mentionable things in the second noun].""To [the chosen direction] there [is-are a list of mentionable things in the noun].""Quite a way [chosen direction] [is-are a list of mentionable things in the second noun]."
"Then [chosen direction] [is-are a list of mentionable things in the noun], and beyond [a list of mentionable things in the second noun].""Meanwhile, to [the chosen direction] [is-are a list of mentionable things in the noun].""Meanwhile, [chosen direction] in the middle distance [is-are a list of mentionable things in the second noun]."
"When you turn [chosen direction], you see [a list of mentionable things in the noun], and somewhat further on [a list of mentionable things in the second noun].""When you turn [chosen direction], you see [a list of mentionable things in the noun].""If you turn [chosen direction], you see [a list of mentionable things in the second noun] some way off."
"Somewhere generally [chosen direction] [is-are a list of mentionable things in the noun], beyond which, [a list of mentionable things in the second noun].""Roughly [chosen direction] [is-are a list of mentionable things in the noun].""Moreover, in the [chosen direction] distance [is-are a list of mentionable things in the second noun]."
"[The chosen direction] shows [a list of mentionable things in the noun] and then [a list of mentionable things in the second noun].""And to [the chosen direction] [a list of mentionable things in the noun].""Meanwhile, [chosen direction] in the middle distance [is-are a list of mentionable things in the second noun]."
"Then, [chosen direction], [is-are a list of mentionable things in the noun], and beyond [a list of mentionable things in the second noun].""Meanwhile, to [the chosen direction] [is-are a list of mentionable things in the noun].""Meanwhile, [chosen direction] in the middle distance [is-are a list of mentionable things in the second noun]."
"Finally, [chosen direction], [is-are a list of mentionable things in the noun], somewhat nearer than [a list of mentionable things in the second noun].""Finally, to [the chosen direction] [is-are a list of mentionable things in the noun].""Finally, [chosen direction] in the middle distance [is-are a list of mentionable things in the second noun]."

Now, our ability to view things at a distance should be determined by the size of the things we're trying to see:

Chapter 2 - Height
 
A height is a kind of value. 10 feet 11 inches specifies a height. 10 feet 11 specifies a height. The verb to stand means the height property. The verb to measure means the height property. A thing has a height. The height of a thing is usually 3 feet 0.
 
Definition: a thing is tiny if its height is 0 feet 6 inches or less.
 
Definition: a thing is short if its height is 3 feet 0 or less.
 
Definition: a thing is tall if its height is 6 feet 0 or more.
 
The height of a man is usually 5 feet 10 inches. The height of a woman is usually 5 feet 6 inches.
 
Definition: a thing is monumental if it is taller than 25 feet 0 inches.
 
Definition: a thing is mentionable if it stands tall enough to see.
 
To decide whether (item - a thing) stands tall enough to see:
   if the item is in the Rose Garden and the item is shorter than the roses, no;
   if the item is mentioned, no;
   if the item is in an adjacent room and item is taller than 2 feet 0, yes;
   if the item is taller than 4 feet 0, yes;
   no.
 
Instead of examining something which is within a room (called the space) which is not the location:
   if the location is adjacent to the space:
      if the noun is tiny, say "It is too far from here for you to make out much detail about [the noun]." instead;
      let way be the best route from the location to the space;
      if the way is a direction, say "You gaze off [way] at [the noun]...";
      continue the action;
   otherwise:
      if the noun is short, say "It is too far from here for you to make out much detail about [the noun]." instead;
      let way be the best route from the location to the space;
      if the way is a direction, say "You gaze off [way] into the distance at [the noun]...";
      continue the action.

We might also want to be able to override, manually, the way distant things are described.

Writing a distant paragraph about something is an activity.
 
Rule for writing a distant paragraph about the lily pond:
   if the second noun is a room and something mentionable is in the second noun, say "A [lily pond], [chosen direction], patchily reflects [a list of mentionable things in the second noun] on the far side. [run paragraph on]";
   otherwise say "To [the chosen direction], [a lily pond] shimmers in the sunlight. [run paragraph on]"
 
Rule for writing a distant paragraph about the roses:
   if something in the Rose Garden is taller than the roses,
      say "Over the tops of [the roses], [chosen direction], you see [a list of mentionable things in the rose garden]. [run paragraph on]";
   otherwise say "Immediately [chosen direction] is [the roses]. [run paragraph on]"
 
Rule for writing a distant paragraph about the obelisk:
   if a mentionable thing in the Upper Terrace is shorter than the obelisk,
      say "A stupidly grand [obelisk], [chosen direction], towers over [a list of mentionable things in the Upper Terrace]. [run paragraph on]";
   otherwise say "To [the chosen direction], you can't help noticing [the obelisk], which is much larger than any object really needs to be. [run paragraph on]".
 
After writing a distant paragraph about something:
   increment the count of sentences.

Moreover, proximate things might have special descriptions too.

Rule for writing a paragraph about something tiny when the location is outdoors:
   if the location is the Gravel Circle,
      say "Abandoned in the gravel [is-are a list of unmentioned tiny things in the location]. [run paragraph on]";
   otherwise say "Half trampled into the grass, and easy to miss, [is-are a list of unmentioned tiny things in the location]. [run paragraph on]"
 
Before doing something other than examining or approaching to something which is not within the location:
   if the player has the noun, continue the action;
   say "(first going over to [the noun])[line break]";
   try approaching the noun;
   if the noun is not within the location, stop the action.
 
Understand "go toward/to/towards/near [something]" or "approach [something]" as approaching.
 
Approaching is an action applying to one visible thing.
 
Check approaching:
   if the player is in something, say "You'll have to get up." instead;
   if the noun is within the location, say "You're as close to [the noun] as you can get." instead;
   let space be the location of the noun;
   if the space is not a room, say "You don't quite see how to get there." instead;
   let way be the best route from the location to the space;
   unless way is a direction,
      say "You can't see how to get over there from here." instead.
 
To head to (space - a room):
   let the way be the best route from the location to the space;
   if the space is adjacent to the location,
      try going way;
   otherwise silently try going way.
 
Carry out approaching:
   let space be the location of the noun;
   while the space is not the location:
      head to space.

This is a bit primitive, since if we had an occasion where going was blocked, we could get stuck in a loop. So we would need to be careful, but for this example it won't arise.

Going state is a truth state that varies. Going state is false.
 
Check going:
   now going state is true.
 
The description of a room is usually "[if going state is true]You drift [noun] across the open lawn[direction relative to obelisk]. [end if]An absolutely phenomenal quantity of manicured turf stretches from where you stand in almost every direction."
 
Before reading a command:
   now going state is false.
 
To say direction relative to obelisk:
   if obelisk is in the location:
      say ", as though drawn magnetically to the foot of the monument";
   otherwise:
      let way be the best route from the location to the Upper Terrace;
      if way is the noun, say ", drawn towards [the obelisk]";
      if the way is the opposite of the noun, say ", keeping [the obelisk] more or less at your back".
 
Chapter 3 - The Grounds
 
When play begins:
   now the left hand status line is "Idyllic";
   now the right hand status line is " ".
 
The Gravel Circle, the Ha-ha, the Sheep Field, the Open Lawn, the Croquet Ground, the Rose Garden, the Upper Terrace, the Middle Terrace, and the Lower Terrace are outdoors.
 
The Middle Terrace is north of the Lower Terrace and south of the Upper Terrace. The lily pond is fixed in place in the Middle Terrace."You [if going state is true]come to[otherwise]are at[end if] the north edge of a perfectly round lily pond, bordered with stones. Its surface patchily reflects [the marble anteater] on the south bank." A tent peg and a wilted orchid are in the Middle Terrace. The tent peg measures 0 feet 6. The orchid measures 0 feet 4.
 
The description of the Lower Terrace is "[if going state is true]You climb [noun] up a small hillock[direction relative to obelisk][otherwise]You stand on a short, round, entirely artificial hillock[end if]."
 
The marble anteater is a fixed in place thing in the Lower Terrace. The height of marble anteater is 6 feet 2 inches."A marble anteater stands on a pedestal at the top of the hill. In the bright sunlight the white marble makes a striking contrast with [the obelisk] in the distance." The description is "The anteater is very much more than life-size."
 
The obelisk of black granite is a fixed in place thing in the Upper Terrace."Now that you are at the foot of it, you can properly appreciate the stupid immensity of the obelisk, pointing stonily at heaven." The height of the obelisk is 50 feet 0 inches. The description of the obelisk is "It stands ridiculously tall, and has an inscription on the face."
 
The inscription is part of the obelisk. The height of the inscription is 0 feet 3 inches. The description of the inscription is "You can't read the squirming, pointed letters, but they make you uneasy.".
 
The Gravel Circle is west of the Upper Terrace, northwest of the Middle Terrace, and north of the Croquet Ground. The description of the Gravel Circle is "[if going state is true]You head [noun] until the lawn thins and[otherwise]Here the lawn[end if] gives way to a circle of raked gravel, which crunches pleasingly beneath you."
 
Instead of going northwest in the Upper Terrace, try going north.
 
The Ha-ha is north of the Gravel Circle and northwest of the Upper Terrace. The description of the Ha-ha is "[if going state is true]The land dips here so suddenly that you do not know the dip is there until you're in it; but it prevents livestock from crossing barriers, and that is the important thing[otherwise]You are at the base of a steep-sided depression, so the lawn continues north and south more or less at the level of your head[end if].
 
The tip of [the obelisk] is the only thing you can make out from this depression, off to the southeast.". North of the Ha-ha is the Sheep Field. In the Sheep Field is an animal called a black sheep. The black sheep stands 4 feet 3 inches."A black sheep grazes placidly nearby." The description of the black sheep is "It reminds you of your Uncle Tim."
 
Before going from the Ha-ha:
   say "It's a bit of a scramble to get back up the side of the depression, and you keep slipping in the damp grass. But you manage at last."
 
The Rose Garden is  southwest of the Lower Terrace. The thicket of red roses is a fixed in place thing in the Rose Garden. The thicket stands 4 feet 2 inches."Heavy red roses grow over a roughly horseshoe-shaped wall around you. Over this barrier, the head of [the marble anteater] is visible to the northwest, and the tip of [the obelisk] in the distance."
 
The description of the Rose Garden is "[if going state is true]You slip [noun] into the enclosure of the rose garden. [end if]The rest of the park, and the world, seems muted and quiet."
 
Instead of smelling the rose garden: try smelling the roses. Instead of smelling the roses, say "The smell tickles the back of your throat and makes you want to cough."
 
Instead of listening to the rose garden:
   say "You can't hear anything at all."
 
The Open Lawn is north of the Rose Garden, west of the Lower Terrace, and southwest of the Middle Terrace. The Croquet Ground is north of the Open Lawn, west of the Middle Terrace, southwest of the Upper Terrace, and northwest of the Lower Terrace.
 
A discarded champagne cork is in the Open Lawn. It stands 0 feet 2 inches.
 
A stone bench is an enterable supporter in the Croquet Ground. It stands 3 feet 8 inches."There is a stone bench here -- a sort of stone sofa, really, with nymphs disporting themselves on the arms and back." The description of the bench is "It used to be a Roman sarcophagus -- hence the nymphs -- but someone has thoughtfully recarved it as lawn furniture."
 
The half-size Bentley is a vehicle in the Gravel Circle."A sort of child's-toy version of a Bentley is parked [if something parkable is in the location]beside [the tallest parkable thing in the location][otherwise]close at hand[end if]." The description of the half-size Bentley is "Of beautiful and unambiguously luxurious lines, but sized down to hold only one or (at a stretch) two people, and powered by electricity." The half-size Bentley stands 3 feet 6 inches.
 
Definition: a thing is parkable if it is not a person and it is not the Bentley.
 
Instead of touching the obelisk, say "Though it is black stone in sunlight, the obelisk is very cold to the touch."
 
Test me with "look east / look toward obelisk / s / s / e / sw / ne / n / n / w / n / n / examine obelisk / touch obelisk / read inscription".

wi 18.29 Deciding the scope of something
rb 3.4 Continuous Spaces and The Outdoors

🔗

RB §3.5 Doors, Staircases, and Bridges

Inform's "door" kind provides for a tangible thing which comes between one room and another. A door can be open or closed, and openable or not: it can be locked or unlocked, and lockable or not. Here we create a conventional door, a natural gap in the rocks, and a (fixed in place) wooden ladder:

The fire door is an open door. The fire door is east of the Projection Booth and west of the Fire Escape.
The narrow crevice is an open unopenable door. The crevice is east of the Col du Prafleuri and west of Rocky Knoll Above Arolla.
The wooden ladder is an open unopenable door. The ladder is above the Stableyard and below the Hay Loft.

Most doors are visible from both sides: they are single objects but present in two rooms at once, which raises a number of complications. Inform normally uses the same description looking from each way, which is not very interesting: When? ★ and Whence? ★★★ demonstrate neat ways to describe the two sides differently, and Whither? ★ adds the option for the player to refer to doors as "the west door" and "the east door" automatically.

Neighbourhood Watch ★★ goes further by making a door behave differently on each side: from the "outside" you need a key, but "inside" it opens on a latch. Finally, Garibaldi ★★★ shows how to access information about the two sides of a door.

Higher Calling ★ demonstrates doors which automatically open as needed: though using the Inform extension Locksmith by Emily Short is probably easier and better. Elsie ★★, conversely, demonstrates a door that closes one turn after the player has opened it.

Certain complications apply when characters other than the player have to see and interact with doors that exist in other rooms. Wainwright Acts ★ demonstrates the syntax needed to handle this technically quirky situation.

Something Narsty ★ and Hayseed ★ provide a "staircase" kind useful for vertically arranged, always-open doors like staircases and (fixed in place) ladders.

One Short Plank ★★ implements a precarious plank bridge across a chasm as an open unopenable door.

Examples

45. Something Narsty ★

In a game with many staircases, we might want:

A staircase is a kind of door. A staircase is always open. A staircase is never openable.

Defining the staircase this way means that we will never be able to get away with (for instance) a folding ladder into the attic which is sometimes closed up. So alternatively we might do

"Something Narsty"

A staircase is a kind of door. A staircase is usually open. A staircase is seldom openable.

We could then write a rule so that whenever the player types CLIMB [any staircase], the command is diverted to an enter command, while all other doors refuse to respond to such treatment. Still, this kind is now usable, as we see in this trivial example:

The ladder is a staircase. It is above the Woodshed and below the Scary Loft.
 
Test me with "up".

But these are refinements for a later chapter.

wi 4.3 Degrees of certainty
rb 3.5 Doors, Staircases, and Bridges

63. When? ★

Very simple, but quite frequently useful:

"When?"

The temporal vortex is an open door. It is west of Yesterday and east of Today. "A whirling temporal vortex leads [if the player is in Yesterday]west[otherwise]east[end if]."

wi 5.6 Text with variations
rb 3.5 Doors, Staircases, and Bridges

89. Hayseed ★

Presumably all staircase-type connections between rooms should respond when the player says CLIMB STAIRS (or the equivalent). So

"Hayseed"

A staircase is a kind of door. A staircase is usually open. A staircase is seldom openable.

The ladder is a staircase. It is above the Barn and below the Hayloft.

Instead of climbing a staircase:

try entering the noun.

Test me with "climb ladder / g".

Attempts to climb other types of door will still be treated as useless.

wi 7.4 Try and try silently
rb 3.5 Doors, Staircases, and Bridges

128. Higher Calling ★

"Called" is quite useful in the context of rules about going, since go rules often refer to things other than the noun the player typed. For instance, suppose we want to have doors which politely open when the player tries to pass through them:

"Higher Calling"

Before going through a closed door (called the blocking door):

say "(first opening [the blocking door])[line break]";

silently try opening the blocking door;

if the blocking door is closed, stop the action.

Dome is a room. North of Dome is North Chapel. South of the Dome is South Chapel. West of the Dome is Western End. Quiet Corner is northwest of the Dome, north of Western End, and west of North Chapel. Loud Corner is east of North Chapel, northeast of Dome, and north of Eastern End. Eastern End is north of Dim Corner and east of Dome. Dim Corner is southeast of Dome and east of South Chapel. Ruined Corner is southwest of Dome, west of South Chapel, and south of Western End.

The church door is east of Eastern End and west of the Courtyard. The church door is a door.

Test me with "e / e".

A fuller set of such rules is included in the Locksmith extension.

wi 8.15 Calling names
rb 3.5 Doors, Staircases, and Bridges

236. Wainwright Acts ★

Suppose we wanted to write rules for a character who will interact with doors in other locations even when the player is not present. This poses a little challenge: doors are actually single objects, and -- with the same shuffling of stage properties that applies to backdrops -- they are moved as needed to represent the door object in whatever room contains the player.

That means that it isn't safe to rely on a phrase like

if an open door is in the location of Bernard

because, even if Bernard's location is connected by doors to other places, the actual representation of that door may not be "in" Bernard's location, from the model's point of view, at this exact moment.

This does not, of course, mean that we can't ask this question; just that we have to be a little cleverer about how we phrase it. Every door has properties that correspond to the two locations

linked:

the front side of the blue door (a room, which is arbitrarily one side of the door)
the back side of the blue door (arbitrarily the other side)

We can make this information easier to check with a conditional relation, like so:

Liminality relates a door (called X) to a room (called Y) when the front side of X is Y or the back side of X is Y. The verb to be a threshold of means the liminality relation.

And this allows us to write rules that have characters interacting with doors even in the player's absence:

"Wainwright Acts"

The Waiting Room is a room. The waiting room door is west of the Waiting Room and east of the Gents' Loo. The Waiting Room door is an open door. "The waiting room door [if open]stands open[otherwise]is shut firmly[end if]."

Sir Humphrey is a man in the Gents' Loo.

Liminality relates a door (called X) to a room (called Y) when the front side of X is Y or the back side of X is Y. The verb to be a threshold of means the liminality relation.

Definition: a person is other if he is not the player.

Every turn:

repeat with indiscreet one running through other people:

repeat with port running through open doors that are a threshold of the location of the indiscreet one:

if the port is a threshold of the location and the indiscreet one is not in the location:

say "Through [the port], you overhear [the indiscreet one] discussing [one of]his hopes for your imminent resignation[or]your wife's infidelity[or]your financially straitened circumstances[or]ways to avoid attending your birthday party[or]your halitosis[as decreasingly likely outcomes]."

Test me with "z / z / z / w / z / e / close door / z".

wi 13.12 Relations which express conditions
rb 3.5 Doors, Staircases, and Bridges

321. Whither? ★

Here we expand on the simple examples When? and Whence?; this time we want the player to be able to refer to doors by their directions, as in "the west door" when the door in question does in fact lead west.

"Whither?"

The temporal vortex is an open door. It is west of Yesterday and east of Today.

The initial appearance of a door is usually "Nearby [an item described] leads [if the other side of the item described is visited][direction of the item described from the location] to [other side of the item described][otherwise][direction of the item described from the location][end if]."

Direction-relevance relates a door (called X) to a direction (called Y) when the direction of X from the location is Y. The verb to be directionally-relevant to means the direction-relevance relation.

Understand "[something related by direction-relevance] door" as a door.

As an added touch, we respond also to the case where the player postulates a door in some direction when there is no such thing at the moment:

Rule for printing a parser error when the player's command includes "[non-door direction] door":
   say "There is no door in that direction." instead.
 
Definition: a direction (called direction D) is non-door:
   let the target be the room-or-door direction D from the location;
   if the target is a door:
      no;
   yes;
 
Test me with "examine west door / x east door / w / x w door / x e door / tie me to the west door / tie the west door to me / push the west door east / push the east door west".

wi 17.16 Understanding things by their relations
rb 3.5 Doors, Staircases, and Bridges

24. Neighborhood Watch ★★

Suppose we want a locked door that can be opened with a key, but is also openable by hand without a key from one side only. We start by defining an ordinary lockable door and the key that controls it:

"Neighborhood Watch"

The shabby door is a door. It is outside from the Studio Apartment and inside from the Rickety Stairwell. The shabby door is locked.

The brass key is carried by the player. It unlocks the shabby door.

The next part is going to require that we modify the normal operation of the "lock" command. "Lock" ordinarily requires that the player supply two objects: a thing he wants to unlock, and the key he wants to use on it. The full command is LOCK DOOR WITH THE KEY, and Inform will not accept simply LOCK DOOR as locking.

Therefore, we're going to need to create our own new variant on the lock verb (and the unlock verb, while we're at it). The full procedure for this is laid out in the chapters on Action and Understanding, but here is an example:

Understand "lock [something]" as locking keylessly. Locking keylessly is an action applying to one thing.

Here we've created a new action -- locking something without a key -- and we've told Inform to understand LOCK DOOR as this action, rather than an incomplete command to LOCK DOOR WITH SOMETHING.

Now we add some instructions so that the game will not let us use this keyless unlocking command unless we're in the right place or are properly equipped:

Check locking keylessly:
   if the noun is not a door, say "[The noun] is not something you can lock." instead;
   if the noun is locked, say "[The noun] is already locked." instead;
   if the player carries the brass key and the player is in the Stairwell, try locking the noun with the brass key instead;
   if the player is in the Stairwell, say "You can't lock the door from this side without the key." instead.

This check rule is performed before the keyless locking action succeeds. The first thing we do is try to use the key if the player is outside and has the key: this way, LOCK DOOR will turn automatically into LOCK DOOR WITH THE KEY, under circumstances where that is both possible and necessary.

The second thing is to check whether the player is outside but keyless, and, if so stop the action from being performed successfully. Here we print a failure message followed by the word "instead", which tells Inform that we've substituted some other outcome for the usual performance of the action.

Now we're reasonably sure that the player is only locking keylessly in the case that he is inside the Studio. (We might have to do a more thorough check for this if there were more than two rooms, but as it is, the player can only be in the Stairwell or in the Studio, so if we have ruled out the Stairwell, we are safe.) So now we want to add what happens when locking-without-a-key command succeeds:

Carry out locking keylessly:
   now the noun is locked.

That's it. We've just told Inform to make the door be locked. "Now…" syntax will be explained more thoroughly in the chapter on change. But we still haven't described to the player what just happened, so let's provide a description of that, too:

Report locking keylessly:
   say "You flip over the deadbolt to lock [the noun]."

And now we have to do a similar set of things for unlocking:

Understand "unlock [something]" as unlocking keylessly. Unlocking keylessly is an action applying to one thing.
 
Check unlocking keylessly:
   if the noun is not a door, say "[The noun] is not something you can lock." instead;
   if the noun is unlocked, say "[The noun] is already unlocked." instead;
   if the player carries the brass key and the player is in the Stairwell, try unlocking the noun with the brass key instead;
   if the player is in the Stairwell, say "You can't unlock the door from this side without the key." instead.
 
Carry out unlocking keylessly:
   now the noun is unlocked.
 
Report unlocking keylessly:
   say "You flip over the deadbolt to unlock [the noun]."
 
Test me with "unlock door / drop key / open door / out / close door / lock door / open door / in / get key / out / close door / lock door / unlock door".

Some (but not all) of this work is done for you if you like by the Locksmith extension. If you prefer, you can include that extension, then follow the documentation in order to implement the remainder of the scenario. Locksmith takes care of implementing the additional locking and unlocking actions, and provides some other conveniences.

wi 3.13 Locks and keys
rb 3.5 Doors, Staircases, and Bridges

106. One Short Plank ★★

"One Short Plank"

The East Jungle is a room. The plank bridge is west of the East Jungle and east of the West Jungle. The plank is an open unopenable door. "A precarious plank bridge extends [if the location is West Jungle]east[otherwise]west[end if] across the chasm." The description of the plank is "Extremely fragile and precarious."

Instead of going through the plank when the player is carrying something:

say "You step gingerly across the plank, which bows under your weight. But your meagre possessions are the straw which breaks the camel's back!";

end the story.

After going through the plank:

say "You step gingerly across the plank, grateful that you're not burdened.";

continue the action.

There is a feather in the East Jungle.

But indeed, why stop there?

The gigantic stone ball is a thing in the West Jungle. It is pushable between rooms.
 
Before going through the plank with something:
   say "Surely you jest." instead.
 
Test me with "w / e / w / push ball e / e / get feather / w".

wi 7.14 Going by, going through, going with
rb 3.5 Doors, Staircases, and Bridges

151. Elsie ★★

Suppose we want to create an automated door of the sort that closes when it isn't in use. A convenient way is to write a rule that fires "every turn when the sliding door was open". This will be true only if the door was open at the beginning of the turn: if the player just opened it this turn, it stays open, and if it was already closed, it stays closed. Thus:

"Elsie"

The axis-ward is a direction. The opposite of axis-ward is hub-ward. Understand "aw" or "axisward" as axis-ward.

The hub-ward is a direction. The opposite of hub-ward is axis-ward. Understand "hw" or "hubward" as hub-ward.

The Ship's Bridge is a room.

The sliding door is a door. It is axis-ward from Bridge and hub-ward from C Deck. The initial appearance is "There is a door in this wall[if closed] -- or at least, the potential for a door, since currently it is sealed, distinguishable from the rest of the wall only by the warning stripes on its surface[end if]."

Every turn when the sliding door was open:

now the sliding door is closed;

if the player can see the sliding door:

say "The sliding door slips back into place, sealing the wall as though there had never been a breach."

After opening the sliding door:

say "You press the appropriate buttons, and a section of wall slides away."

Test me with "open door / look / enter door / z".

wi 9.13 The past and perfect tenses
rb 3.5 Doors, Staircases, and Bridges

22. Garibaldi 1 ★★★

Suppose we would like to allow the player to view the status of all the doors functioning in the game; and we want to identify those doors by mentioning which two rooms they connect. The following uses some techniques that will be covered in later chapters, but the basic idea may be obvious:

"Garibaldi"

The security readout is a device. The description of the readout is "The screen is blank."

Instead of examining the switched on security readout:

say "The screen reads: [fixed letter spacing]";

say line break;

repeat with item running through doors:

say line break;

say " [item] ([front side of the item]/[back side of the item]): [if the item is locked]LOCKED[otherwise]UNLOCKED[end if]";

say variable letter spacing;

say paragraph break.

It is more or less arbitrary which room winds up as the "front side" and which as the "back", but in this case it hardly matters.

The player carries the security readout.
 
The Docking Bay is a room. The inner airlock is a door. It is north of the Docking Bay and south of the Zocalo. The inner airlock is lockable and unlocked.  The outer airlock is lockable and locked. It is a door. It is south of the Docking Bay and north of Space.
 
The quarantine seal is a door. It is west of the Zocalo and east of Medlab. Quarantine seal is locked.
 
The security pass unlocks the inner airlock. The player carries the security pass.
 
Test me with "x readout / turn on readout / x readout / lock inner airlock with security pass / x readout".

wi 3.12 Doors
rb 3.5 Doors, Staircases, and Bridges

64. Whence? ★★★

It would be fairly tedious reading to have a large game full of doors that describe themselves this way. Nonetheless, if we insisted we could use our knowledge of the map as leverage to make every door in the game describe itself automatically.

To do this, we make use of the phrase "direction of (the door) from (a room)" -- in this case, the direction of the door we're looking at when viewed from the player's location. Thus:

"Whence?"

The temporal vortex is an open door. It is west of Yesterday and east of Today.

The initial appearance of a door is usually "Nearby [an item described] leads [if the other side of the item described is visited][direction of the item described from the location] to [the other side of the item described][otherwise][direction of the item described from the location][end if]."

Test me with "w / e".

Yet a further variation on this, which can automatically understand "the east door" and "the west door" when appropriate, may be found in the example "Whither?".

wi 5.6 Text with variations
rb 3.5 Doors, Staircases, and Bridges

🔗

RB §3.6 Windows

Calvin Coolidge once described windows as "rectangles of glass." For us, they have two purposes: first, they offer a view of landscape beyond. In the simplest case the view is of an area which will not be interacted with in play, and therefore does not need to adapt to whatever may have changed there:

The window is scenery in the Turret. "Through the window you see miles and miles of unbroken forest, turning from green to flame in the hard early autumn."

More interesting is to adapt the view a little to provide a changing picture: a forest may not change much, but a street scene will. Port Royal 4 ★★ allows us to glimpse random passers-by.

The trickiest kind of window allows the player to see another room which can also be encountered in play, and to interact with what is there. Dinner is Served ★★ presents a shop window, allowing people to see inside from the street, and even to reach through.

Vitrine ★ handles the complication of a window misting up to become opaque, and thus temporarily hiding its view.

Second, windows provide openings in walls and can act as conduits. Escape ★★ shows how a "door" in the Inform sense can become a window. A Haughty Spirit ★★★ provides a general kind of window for jumping down out of: ideal for escapers from Colditz-like castles.

Examples

116. Vitrine ★

"Vitrine"

Plaza View is a room. "Your uncle's apartment, on loan to you for viewing the parade and celebrations today. This would be more of a sacrifice on his part if he weren't currently yachting around Corfu."

The smart window is a device in Plaza View. It is fixed in place. "A vast smart window [if transparent]overlooks the park[otherwise]has turned to a sheet of hazy blue[end if]." The smart window can be transparent. The smart window is transparent. The description is "An electrochromic device which changes shade and transparency in response to the application of current.

Curtains are so last year."

Note the "can be transparent" line. Devices ordinarily are not allowed to have transparency or opaqueness, but we can make an exception in this case. Without that line, attempts to change the transparency of the window will fail.

Carry out switching off the window: now the window is transparent.
 
Carry out switching on the window: now the window is opaque.
 
Instead of searching a transparent window: say "Isn't it lovely out there?"
 
Instead of searching an opaque window: say "The window is currently darkened."
 
Test me with "look through window / switch window / look through window / look".

wi 8.4 Change of either/or properties
rb 3.6 Windows

21. Escape ★★

Suppose we want to offer the player a window he can climb through, instead of a boring ordinary door. Our window will be like a door in that it connects two rooms, appears in both places, and impedes movement when it is shut. But we also want to add that we can look through it and see what lies on the other side; and we further want to understand "climb through window" or "jump through window" as attempts to pass through it.

We'll start by defining a couple of rooms and making the window a door between them.

"Escape"

Your Bedroom is a room. The bedroom window is a door. It is west of Your Bedroom and east of the Grassy Slope.

Now we have a "bedroom window" object which can be entered. Now, to catch the case where the player types "LOOK THROUGH WINDOW":

Instead of searching the window:
   say "Through the window, you make out [the other side of the window]."

The other side of a door is always defined to be the room that we are not currently in when doing the check. When we are in the bedrooom, the other side will be the grassy slope, and vice versa. "Searching" is the action that occurs when the player attempts to LOOK THROUGH something. (To review what grammar gives rise to what actions, we can always consult the Actions portion of the Index.)

Next we want to cover the case where we climb through the window:

Instead of climbing the window:
   try entering the window.

And because "climb window" is understood but "climb THROUGH window" is not, we will have to borrow from the chapter on Understanding to add some new vocabulary to the game (and we'll add Jump too, while we're at it):

Understand "climb through [something]" as climbing. Understand "jump through [something]" as climbing.

Now the final piece: Inform will already keep the player from going through a closed window, but it will say "You can't, since the bedroom window is in the way." This is probably not ideal, so we can replace the instruction thus:

Instead of going through the closed window:
   say "The window is shut: you'd break the glass."
 
Test me with "look through window / climb through window / open window / climb through window / look through window / close window / e / open window / e".

wi 3.12 Doors
rb 3.6 Windows

217. Dinner is Served ★★

"Dinner is Served"

Street in Kolonaki is a room. "There is a single round table out on the street here, and a window more or less at knee level looks down into the Olive Tree Gyro Shop, which is partly basement."

The Street contains a round table. The table is scenery. On the round table is a plate. On the plate are a gyro and a mound of fresh potates. The plate is portable. The potates and the gyro are edible. The description of potates is "They'd be called french fries, at home, but these are steak-cut and fried in olive oil." The description of the gyro is "Dripping garlic-yogurt sauce."

Olive Tree Gyro Shop is inside from Street in Kolonaki. Kostis is a man in the Gyro Shop. In the Shop is a stand. On the stand is a rotating column of cooking lamb flesh. In the shop is a closed, openable container called a drinks refrigerator. The refrigerator contains a can of Mythos beer and a can of Coke Light.

Here's the part that allows reaching through the window.

We replace the usual rule that says the player can never reach into a room with one that more specifically checks whether we are trying to reach through the window. If we aren't, we return the usual refusal. If we are, we return a custom refusal if the window is closed ("You can't reach through the closed window"), but allow access if the window is open.

The can't reach through closed window rule is listed instead of the can't reach inside rooms rule in the reaching inside rules.
 
This is the can't reach through closed window rule:
   let reaching through the window be false;
   if the container in question is a room and the container in question is not the location:
      if the container in question is the Street and the location is the Olive Tree Gyro Shop:
         now reaching through the window is true;
      if the container in question is the Gyro Shop and the location is the Street:
         now reaching through the window is true;
      if reaching through the window is true:
         if the window is closed:
            say "You can't reach through the closed window.";
            deny access;
         otherwise:
            allow access;
      otherwise:
         say "You can't reach into [the container in question] from here.";
         deny access.

And the rest is window-dressing.

After looking when a room (called the next room) is adjacent:
   try examining the next room.
 
Instead of examining a supporter, say "On [the noun] [is-are a list of things on the noun]." Instead of examining an open container, say "In [the noun] [is-are a list of things in the noun]."
 
The window is a backdrop. It is in the Street and the Shop. The window can be openable. The window can be open. The window is openable and closed. Instead of searching the window in the Street: try examining the shop. Instead of searching the window in the Shop: try examining the street.
 
Understand "examine [any adjacent room]" as examining.
 
Instead of examining a room:
   say "Over in [the noun], you can see [a list of visible things in the noun]."
 
After deciding the scope of the player:
   if the player is in the Street, place the Shop in scope;
   if the player is in the Shop, place the Street in scope.
 
Test me with "examine shop / open refrigerator / open window / examine shop / open refrigerator / get beer / in / examine street / out / get gyro / close window / put gyro in refrigerator / open window / put gyro in refrigerator".

wi 12.18 Changing reachability
rb 3.6 Windows

272. Port Royal 4 ★★

Our protagonist is imprisoned in Port Royal, waiting out his years, and sometimes through the window of his cell he is able to see someone.

We are, however, obsessive about historical accuracy, so we provide a table of people who really lived in the city, together with the year in which their existence is attested. We want these people to appear in the description only in the year when they are known to have been present. (After all, mortality was high in Port Royal and new people were constantly arriving, so someone's presence one year is no guarantee of their continued existence the next.)

"Waiting for Godot, Chyrurgeon"

New New Prison is a room. "You have a not very interesting room. Through the window you see passing [current denizen]."

Instead of waiting:

increment the current year;

say "It is now the year [the current year].";

try looking.

When play begins: now the right hand status line is "[current year]".

Every turn:

if the current year is 1692:

say "It turns out you have remained imprisoned until the great earthquake of 1692! Oops.";

end the story.

Current year is a number that varies. The current year is 1664.

To say current denizen:

repeat through the Table of Occupations and People:

if the date attested entry is the current year:

say "[nickname entry] [family entry], [trade entry]";

blank out the whole row;

rule succeeds;

say "absolutely no one".

It is possible to look up a row corresponding to, say, a specific year value using "listed in", but repeat through is convenient here because we know that we will never wind up trying to print entries when no row can be successfully selected.

Table of Occupations and People

TradenicknamefamilyDate attested
"architect""Robert""Snead"1684
"baker""William""Wingar"1683
"barber""William""Alcocke"1676
"blacksmith""William""Davidson"1679
"bricklayer""Samuel""Richardson"1683
"butcher""John""Dennis"1676
"carpenter""John""Albert"1675
"cabinet-maker""Robert""Avis"1666
"joiner""Peter""Bartaboa"1666
"chandler""William""Bates"1674
"chyrurgeon""William""Axtell"1674
"chyrurgeon""Thomas""Trapham"1678
"combmaker""Paul""Bennett"1673
"cooper""James""Hall"1676
"cooper""Henry""Pullein"1675
"cordwainer""George""Barnard"1675
"cordwainer""Edward""Skannon"1680
"cordwainer""John""Wilmott"1675
"drugster""William""Mathews"1682
"fisherman""Richard""Collingwood"1674
"glazier""Thomas""Hudson"1684
"goldsmith""Richard""Lord"1677
"gunsmith""Stephen""Massey"1664
"hatmaker""John""Rosewell"1683
"ivory turner""William""Clifton"1691
"labourer""John""Dennis"1674
"limeburner""John""Hardwick"1675
"mariner""Alexander""Bailing"1680
"mariner""Thomas""Bowtell"1675
"mariner""Peter""Claiton"1675
"mariner""Joseph""Cupid"1672
"mariner""Michael""Dunn"1675
"mason""John""Stone"1673
"merchant""John""Agard"1680
"merchant""David Lopez""Narbona"1674
"merchant""Abraham""Langford"1675
"merchant""John""Sweeting"1675
"merchant""Charles""Knight"1680
"merchant""Cornelius""Vandananker"1670
"merchant""Moses Jesurum""Cordova"1675
"pewterer""Simon""Benning"1667
"pipemaker""John""Pope"1680
"porter""George""Paul"1670
"poulterer""Richard""Jeffreys"1677
"sailmaker""Adam""Brewer"1671
"schoolmaster""Peter""Bird"1677
"shipwright""William""Cavell"1676
"tailor""William""Case"1676
"tailor""Pewter""Ebden"1683
"waterman""William""Brocke"1674
"waterman""Joel""Clements"1668
"wherryman""John""Grant"1669
"victualler""Barnaby""Adams"1675
"vintner""Gabriel""Adkins"1668
"tavern-keeper""John""Baldwin"1670
"tavern-keeper""Mary""Dayton"1664
"tavern-keeper""James""Turpin"1679
"tavern-keeper""Christopher""Mayham"1664
 
Test me with "wait / wait / wait / wait / wait / wait / wait / wait / wait / wait".

wi 16.6 Repeating through tables
rb 3.6 Windows

181. A Haughty Spirit ★★★

Suppose we have a game in which the player can climb through windows which overlook rooms below. We want him to be allowed to climb out windows to reach a room on the same level or at most one level lower than the one he's on; otherwise, he should get a refusal, saying that he would break his neck.

To figure out the height distance between the start room and the destination room, we might have a repeat loop look at all the directions one has to follow along the "best route" path between the two rooms, and record any ups and downs; then subtract the number of "up" steps from the number of "down" steps, and report what remains.

"A Haughty Spirit"

To decide what number is the distance (first place - a room) rises above (second place - a room):

let the total distance be the number of moves from the first place to the second place;

if the total distance is less than 1, decide on 0;

let count of down moves be 0;

let count of up moves be 0;

let next place be the first place;

repeat with counter running from 1 to the total distance:

let the way be the best route from the next place to the second place;

if the way is down, let count of down moves be the count of down moves plus 1;

if the way is up, let the count of up moves be the count of up moves plus 1;

let next place be the room the way from next place;

let the decision be the count of down moves minus the count of up moves;

decide on the decision.

Now we just have to create windows and some action rules for interacting with them…

A window is a kind of thing. A window is always fixed in place. A window can be open or closed. A window is usually closed. A window can be openable or unopenable. A window is usually openable.
 
Understand "climb through [something]" as entering. Understand "jump through/out [something]" as entering.
 
Before entering a closed window:
   say "[The noun] would have to be opened first." instead.
 
Instead of entering a window:
   if the noun overlooks a room (called the far side):
      let fall be the distance the location rises above the far side;
      if fall is greater than 1, say "You'd break your neck." instead;
      say "You tumble into [the far side].";
      move the player to the far side;
   otherwise:
      say "There's nowhere to go."
 
Instead of examining a window:
   say "[The noun] [if the noun is open]opens over[otherwise]gives a view of[end if] [the list of rooms overlooked by the noun]."

Here we must anticipate a little from the chapter on Relations, and provide ourselves with a way of keeping track of how windows and rooms relate to one another:

Overlooking relates various windows to various rooms. The verb to overlook means the overlooking relation. The initial appearance of a window is usually "[The item described] overlooks [the list of rooms overlooked by the item described]."
 
The Square Keep is above the Winding Staircase. The Winding Staircase is above the Motte. A crown and a broken sword are in the Motte. The Bailey is west of the Motte.
 
The long window is in the Keep. The long window overlooks the Bailey and the Motte. The narrow window is in the Winding Staircase. The narrow window overlooks the Bailey.
 
Test me with "jump through window / open window / jump through window / d / x narrow window / open window / climb through window / e / up / down".

We could then add rules to allow the player to look through windows and see things in the rooms below, but that would require more material from later chapters.

wi 11.17 Phrases to decide other things
rb 3.6 Windows

🔗

RB §3.7 Lighting

At any place (room, or inside a container) light is either fully present or fully absent. Inform does not usually try to track intermediate states of lighting, but see The Undertomb 2 ★★ for a single lantern with varying light levels and Zorn of Zorna ★★★ for multiple candles that can be lit for cumulative changes to the light level.

Light can be added to, but not taken away: rooms and things can act as sources of light, by having the "lighted" and "lit" properties respectively, but they cannot be sinks which drain light away. The reason darkness is not a constant hazard in Inform-written games is that rooms always have the "lighted" property unless declared "dark". (We assume daylight or some always-on electric lighting.) A "dark" room may well still be illuminated if a light source happens to be present:

The Deep Crypt is a dark room. The candle lantern is a lit thing in the Deep Crypt.

Hymenaeus ★ allows us to explicitly refer to torches as "lit" or "unlit", or (as synonyms) "flaming" or "extinguished".

For light produced electrically we might want a wall switch, as in Down Below ★★, or a portable lamp, as in The Dark Ages Revisited ★.

The fierce, locally confined light thrown out by a carried lamp has a quality quite unlike weak but ambient daylight, and Reflections ★ exploits this to make a lantern feel more realistic.

When the player experiences darkness in a location, Inform is usually very guarded in what it reveals. ("It is pitch dark, and you can't see a thing.") Hohmann Transfer ★★ gives darkness a quite different look, and Four Stars ★★★ heightens the other senses so that a player in darkness can still detect her surroundings. The first of the two examples in Peeled ★ allows exploration of a dark place by touch.

It is sometimes useful to check whether a room that is not the current location happens to contain a light source or be naturally lighted. This poses a few challenges. Unblinking ★★★ demonstrates one way of doing this, so long as there are no backdrop light sources.

Cloak of Darkness ★★★★ is a short and sweet game based on a light puzzle.

Examples

194. The Dark Ages Revisited ★

This will be explored more in subsequent examples, but one of the things we can do with carry out rules is extend the function of existing commands so that they do more, or have special effects in specific situations. For instance, suppose we want to have a class of electric light:

"The Dark Ages Revisited"

An electric light is a kind of device. Carry out switching on an electric light: now the noun is lit. Carry out switching off an electric light: now the noun is unlit.

This will not affect the behavior of any other devices when switched; it will also not change the way in which switching lights on and off is reported. The player will still see "You switch the sodium lamp on." or the like. In this case that is probably what we want. If we wanted a special way of describing turning on electric lights as opposed to all other devices, we could also add an after rule for the electric light class. Adding this rule to the carry out train does guarantee, though, that in no case will we manage to make the lamp lit without actually making it switched on (or vice versa).

The Stooped Corridor is a room. "A low, square-cut corridor, running north to south, stooping you over."
 
The sodium lamp is an electric light in the Stooped Corridor. "[if switched on]The sodium lamp squats on the ground, burning away.[otherwise]The sodium lamp squats heavily on the ground.[end if]". The description is "It is a heavy-duty archaeologist's lamp, [if switched off]currently off.[otherwise]blazing with brilliant yellow light.[end if]"
 
Instead of burning the sodium lamp, try switching on the lamp.

So far so easy. Since we've built the description of its light or darkness into the lamp's description, though, we may want to get rid of the "…is switched on" line that automatically follows when we look at something. For this we do need to borrow from a later chapter:

The examine devices rule is not listed in the carry out examining rules.
 
Test me with "x lamp / switch lamp on / look / x lamp".

wi 12.9 Check, carry out, report
rb 3.7 Lighting

312. Hymenaeus ★

"Hymenaeus"

A torch is kind of thing. Understand the lit property as describing a torch. Understand "lighted" or "flaming" or "burning" as lit. Understand "extinguished" as unlit. A torch is usually lit.

Before printing the name of a lit torch, say "flaming ".

Before printing the name of an unlit torch, say "extinguished ".

The Wedding Procession is a room.

Orpheus is a man in the Wedding Procession. Orpheus carries a torch.

Eurydice is a woman in the Wedding Procession. Eurydice carries a torch.

Rule for writing a paragraph about someone (called target):

say "[The target] carries [a list of things carried by the target]."

Every turn:

if a random chance of 1 in 2 succeeds and a torch is lit:

let target torch be a random lit torch;

now the target torch is unlit;

say "Aquilo blows down from the north, extinguishing the torch carried by [the holder of the target torch]."

Instead of examining a lit torch:

say "It casts a bright glow over [the holder of the noun]."

Instead of examining an unlit torch:

say "[The holder of the noun] is looking at it disconsolately, obviously worried about the omens."

Test me with "z / z / z / look / x flaming torch / x extinguished torch".

wi 17.15 Understanding things by their properties
rb 3.7 Lighting

352. Reflections ★

"Reflections"

Behind the Waterfall is a room. "Though one wall of the cave is open to the waterfall, the quantity of water is so great that barely any light comes through from the outside." Behind the Waterfall is dark.

Surface is a kind of value. The surfaces are shiny and dull. A thing has a surface. A thing is usually dull.

The player carries a reflecting ball, a canopic jar, an abacus, a plumbline, a piece of chalk, and a torch. The reflecting ball is shiny.

Aladdin's lamp is a shiny thing in Behind the Waterfall.

Brightness is a kind of value. The brightnesses are guttering, weak, radiant and blazing. The torch has a brightness. The torch is blazing. The torch is lit.

Understand "blow out [something]" or "blow [something]" or "extinguish [something]" as blowing out. Blowing out is an action applying to one thing.

Carry out blowing out: say "Futile."

Instead of blowing out the torch:

now brightness of torch is the brightness before the brightness of the torch;

say "The light of the torch dies to [brightness of torch]."

Instead of blowing out the guttering torch:

say "Fool! Do you want to put it out entirely?"

Rule for writing a paragraph about a shiny thing:

say "The [brightness of the torch] light of [the torch] reflects in the surface[if the number of shiny things in the location > 1]s[end if] of [the list of shiny things in the location]."

Before printing the name of the torch while writing a paragraph about something:

if the torch is in the location, say "fallen ".

Test me with "drop ball / look / blow torch / look / drop torch / look".

wi 18.24 Writing a paragraph about
rb 3.7 Lighting

363. Peeled ★

Suppose we have a situation where the player is in darkness, but is allowed to feel and interact with (except for examining) any large objects. In that case, we write a scope rule that puts those large objects into scope all the time, and trust the "requires light" aspect of verbs like examining to prevent the player from doing any actions that he shouldn't:

"Peeled"

A thing can be large or small.

Before touching a large thing when in darkness: say "You grope for [the noun]..."

After deciding the scope of the player:

repeat with item running through large things in the location:

place item in scope.

Some generic surroundings are backdrop. They are everywhere. Understand "walls" or "wall" or "ceiling" or "ground" or "floor" or "area" or "room" or "here" as the generic surroundings. Instead of touching the generic surroundings: say "You encounter nothing extraordinary." Instead of touching the generic surroundings when in darkness: say "You try feeling your way around and reach [a list of large things in the location]." After deciding the scope of the player when in darkness: place the surroundings in scope.

The Room of Mystery is a dark room. The bearskin rug is a large thing in the Room of Mystery. Instead of touching the rug: say "It feels furry!"

The peeled grape is a small thing in the Room of Mystery. Instead of touching the peeled grape: say "Gosh, is that an eyeball?"

Test me with "feel floor / feel rug / eat rug / examine rug / get grape".

Sadly, because the grape is small, the player will never encounter this horror.

Alternatively, suppose we have a situation in which the player can use one command to interact with a kind of thing that isn't normally in scope. It's usually most convenient to write the "understand" rule appropriately rather than use the scope activity.

(Note that we define "inquiring about" as applying to one *visible* thing; otherwise we would be required to be able to touch the catsuit in order to inquire about it. More on this restriction may be found in the Advanced Actions chapter on the topic of visible, touchable, and carried things.)

"Peeled"

Mr Steed's Flat is a room.

Understand "ask about [any subject]" as inquiring about. A subject is a kind of thing. The skintight catsuit is a subject. Inquiring about is an action applying to one visible thing.

Carry out inquiring about something:

say "'What can you tell me about [the noun]?' you demand. Mr Steed raises his eyebrows, but does not reply."

Test me with "ask about catsuit / x catsuit".

All this said, there do arise certain complex situations when we want an activity-specific scoping.

wi 18.29 Deciding the scope of something
rb 3.7 Lighting

26. Down Below ★★

Suppose we want to have a room with a light switch. Turning the switch off makes the room go dark; turning it on restores the light. This kind of switch is an obvious candidate as a device.

"Down Below"

Terrifying Basement is a room. The light switch is a switched on device in the Terrifying Basement. It is fixed in place.

Here we define our light switch, and we also make it start out as "switched on". The Terrifying Basement will also start out lit (as all rooms do, by default, unless we specifically say that they are dark). We further say that it is fixed in place to avoid the ludicrous possibility of the player picking it up and carrying it away.

Next we add some instructions to control how turning the light switch on and off affects the room light. These borrow from later chapters on actions, but the gist may be obvious anyway:

Carry out switching off the light switch: now the Terrifying Basement is dark.
 
Carry out switching on the light switch: now the Terrifying Basement is lighted.

Inform already has the idea of light and darkness built in; we will see more about this later, and the Phrasebook (in the Index tab) also contains a list of all the adjectives (lighted, dark, etc) which are important to use here.

Speaking of the Index, the Actions tab contains a list of all the grammar that can be used to activate a given command: for instance, the switching action responds to "switch [something]" or "turn on [something]". In this case, we may want to give the player an extra option or two. It would be pretty natural for a player to try >FLIP SWITCH, so let's add that in:

Understand "flip [something switched off]" as switching on. Understand "flip [something switched on]" as switching off. Understand "flip [something]" as switching on.

The nuances of this will be explored in the chapter on Understanding. What is useful to know here is that we have taught Inform to understand that >FLIP LIGHT SWITCH means to turn it on when the switch is already off; if the switch is already on, FLIP SWITCH means to turn the switch off. Depending on the kind of device we are modeling (button? lever? dial?), we might want to write similar lines for commands such as PUSH, PRESS, PULL, TURN, and so on.

Finally, we need to deal with a special case. In general, the player cannot interact with other things in a dark room because he can't see them, but if we adhered strictly to this it would be impossible for him to find the light switch to turn it back on. So we need something from the chapter on Activities to change this:

After deciding the scope of the player when the location is the Terrifying Basement:
   place the light switch in scope.
 
Upstairs is above the Terrifying Basement.
 
Test me with "turn off light / look / flip light switch".

wi 3.14 Devices and descriptions
rb 3.7 Lighting

51. The Undertomb 2 ★★

"Undertomb 2"

Section 1 - Procedure

Brightness is a kind of value. The brightnesses are guttering, weak, radiant and blazing.

A brightness can be adequate or inadequate. A brightness is usually adequate. Guttering is inadequate.

Temperature is a kind of value. 100C specifies a temperature.

A brightness has a temperature. The temperature of a brightness is usually 700C. The temperature of blazing is 1400C. The temperature of radiant is 1100C.

A dead end is a kind of room with printed name "Dead End" and description "This is a dead end, where crags in the uneven rock are caught by the [brightness of the lantern] flame you hold aloft. Despite [river sound] there is no sign of the stream." A dead end is usually dark.

A dead end has some text called river sound. The river sound of a dead end is usually "a faint whispering of running water".

Section 2 - Scenario

The Undertomb is a dark room. "From this dim cross-groined room, exits depart east, south, and northwest."

East is a dead end. South is a dead end with printed name "Collapsed Dead End".

Northwest is a dead end called the Tortuous Alcove. The Tortuous Alcove has river sound "a gurgle of running water".

The player carries a book. The description of the book is "[if the brightness of the lantern is adequate]Many secrets are now yours.[otherwise]No, the print's too tiny by this awful light."

In the Undertomb is a lantern. It is lit. The lantern has a brightness. The lantern is blazing. The description of the lantern is "The lantern shines with a flame at [temperature of the brightness of the lantern]."

After waiting in the Tortuous Alcove when the brightness of the lantern is not guttering:

now the lantern is the brightness before the brightness of the lantern;

say "You wait so long that your lantern dims a bit."

Test me with "east / west / get lantern / east / west / south / north / northwest / read book / x lantern / z / x lantern / read book / look / z / x lantern / read book / look / z / x lantern / read book / look".

wi 4.9 Using new kinds of value in properties
rb 3.7 Lighting

348. Hohmann Transfer ★★

Inform automatically keeps track of light and darkness, handling such questions as whether a room is lit, whether the player can see any light sources, etc., and then managing the descriptions accordingly. When the room is dark and no light sources are visible, the player is said to be "in darkness".

If we don't specify otherwise, Inform will describe our surroundings in a dark room thus:

Darkness
It is pitch dark, and you can't see a thing.

This is fine in many situations, but we may sometimes want to replace this phrase with something else.

"Hohmann Transfer"

The Western Hemisphere is a dark room. "The cloud mass covers much of the land on this side of the planet, and a particularly nasty storm is brewing off to the south."

The Eastern Hemisphere is west of the Western Hemisphere. The Eastern Hemisphere is east of the Western Hemisphere. The Eastern Hemisphere is north of the Western Hemisphere. The Eastern Hemisphere is south of the Western Hemisphere. "This side of the planet is more ocean than land, with only two continents worthy of the name, and a volcanic archipelago in the north seas."

Use full-length room descriptions.

Rule for printing the description of a dark room:

say "It's night on this side of the planet, so you can make out only the glow of urbanized areas along the seacoasts." instead.

Rule for printing the name of a dark room:

say "Dark Side" instead.

And now a few minor refinements so that we can see what happens when one room becomes dark and the other light:

Carry out going:
   say "You fire the thrusters and loop around to the other side of the planet before settling into a new geosynchronous orbit. Six months and one minute later..."
 
The time of day is 4:55 PM.
 
At 5 PM:
   now the Eastern Hemisphere is dark;
   now the Western Hemisphere is lit.
 
Rule for printing the announcement of darkness:
   say "The planet abruptly spins itself over, exposing its cool underbelly to the sun."
 
Test me with "e / z / z / w / z / z / e".

wi 18.22 Printing the description of a dark room
rb 3.7 Lighting

81. Unblinking ★★★

Suppose we're simulating a situation where the player needs to travel through lit areas only, but we want to give him some hints about which way might be safe. Here we'll find our best route through light-filled rooms.

The slightly tricky part is that it's not necessarily easy to tell whether a room has a lamp in it. We may say "if the Crypt is lighted", but that only tells us whether it has been declared to be inherently lighted or dark, not whether it happens to contain a light source that the player would be able to see if he went in.

The easiest way to get around this is to create an object -- the light-meter; place it in the target location; and check whether it "can see" a lit object. This preserves all the usual rules about open and closed containers, transparency, etc.

"Unblinking"

Section 1 - Procedure

The light-meter is a privately-named scenery thing.

Definition: a room (called the target room) is light-filled:

if the target room is lighted:

yes;

move the light-meter to the target room;

let the answer be false;

if the light-meter can see a lit thing:

now the answer is true;

now the light-meter is nowhere;

decide on the answer.

That done, we're free to use our best-route phrases to choose a particular route.

Section 2 - Scenario
 
The Tomb of Angels is a room. "This ancient underground tomb is lightless but for a few shafts from the surface. Everywhere in the shadows are carved angels, their faces worn away by water and pollution, their wings little more than nubs."
 
The Upward Path is above the Tomb of Angels. It is dark. "The staircase switches back on itself many times as it ascends towards the Crash Site."
 
A container called the sarcophagus is in the Upward Path. It is closed and openable. "A sarcophagus rests in the niche here, [if open]the lid pushed aside[otherwise]the lid firmly in place[end if]."
 
The Crash Site is above the Upward Path. "The ceiling has wholly caved in here, and the belly of the spaceship above you is visible -- including the escape hatch."
 
A candle is a kind of thing. A candle is usually lit. The player carries four candles.
 
After looking when the location is not the Crash Site:
   if the best route from the location to the Crash Site through light-filled rooms is a direction (called next way):
      say "It looks like there's a safe, lit path [if the number of moves from the location to the Crash Site through light-filled rooms is 1]straight[otherwise]if you go[end if] [next way].";
   otherwise:
      say "It looks like there is no fully lit path from here to the Crash Site."
 
Test me with "up / drop candle / down / up / take the candle / open sarcophagus / put candle in sarcophagus / down / up / close sarcophagus / d".

An important word of caution: this method would give false negatives if there were a backdrop lightsource, such as the moon, providing light to the Upward Path. This is because backdrops are actually moved around the map by Inform during play, following the player around. So if the moon backdrop is in the Crash Site with the player, it will not be in the Upward Path as well -- even if it's scheduled to move there as soon as the player does.

wi 6.14 Adjacent rooms and routes through the map
rb 3.7 Lighting

347. Zorn of Zorna ★★★

"Zorn of Zorna"

Visibility rule:

if examining:

if the detail of the noun is fine and the number of visible lit candles is less than 5, there is insufficient light;

if the detail of the noun is ordinary and the number of visible lit candles is less than 3, there is insufficient light;

there is sufficient light.

Detail is a kind of value. The details are fine, ordinary, and gross. A thing has detail.

A candle is a kind of thing. Before printing the name of a candle while not burning or blowing out: say "[if lit]lit [otherwise]unlit [end if]". A candle is usually lit. Before printing the plural name of a candle while not burning or blowing out: say "[if lit]lit [otherwise]unlit [end if]". A candle is usually lit. Understand the lit property as describing a candle. A candle is usually gross.

Instead of burning a candle: now the noun is lit; say "You light [the noun]."

Understand "blow out [something]" or "extinguish [something]" or "put out [something]" as blowing out. Understand the command "snuff" as "extinguish". Blowing out is an action applying to one thing.

Understand "burn [unlit candle]" as burning.

Instead of blowing out a candle:

now the noun is unlit;

say "You put out [the noun]."

Rule for printing a refusal to act in the dark:

if we are examining something, say "The details of [the noun] are too fine to make out in the light of only [the number of visible lit candles in words] candle[s]." instead.

Every turn when the Todal is visible:

if the number of visible lit candles is greater than 1:

say "The brightness of the room wakens the Todal from slumber, and with you unarmed...";

end the story;

otherwise:

say "Todal sleeps fitfully, troubled by even that faint light."

A room is usually dark.

The Palace is a room. "The Duke is out; the way is clear. East is Saralinda's Chamber; north, a hallway zigs and zags down to the gate that leads out." A finely-written placard is in the Palace. "A finely-written placard is on the wall next to this exit." The placard is fine. The description of the placard is "You read: 'Beware the Todal: its bite is worse than its gleep.

No more than one candle!'"

The candle-stand is a supporter in the Palace. Understand "stand" as the candle-stand. The description of the candle-stand is "The candle-stand is a tall metal branch for holding lights, but someone has quite practically added casters to the bottom." It is pushable between rooms. Three candles are on the candle-stand. Instead of removing something from the candle-stand: say "[The noun] is fixed quite firmly in place." Instead of taking something which is on the candle-stand: say "[The noun] won't come out of the holder." Instead of putting something on the candle-stand: say "[The candle-stand] is full."

Saralinda's Chamber is east of the Palace. "Now that Saralinda herself is gone, there is no real radiance in this place." Two unlit candles are in Saralinda's Chamber.

A large-print romantic novel is in Saralinda's Chamber. The novel is ordinary. The description of the novel is "'She Was Only The Chimney-Sweep's Daughter', by Marie Swelldon."

The Zig-Zag Hallway is north of the Palace. "The Hallway goes left, then right, then left again..." Two unlit candles are in the Hallway.

Todal is an animal in the Zig-Zag Hallway.

Rule for printing the description of a dark room when the Todal is in the location:

try listening.

Instead of listening when in darkness and the Todal is in the location:

say "In the darkness something softly gleeps."

Instead of going north from the Hallway when in darkness:

say "You stumble and cannot find your way."

North of the Hallway is Freedom. Instead of going to Freedom: say "You make it out into the cool night air at last!"; end the story finally.

Test me with "examine placard / get placard / n / listen / n / s / examine candle-stand / push candle-stand east / examine novel / get unlit candle / light it / light unlit candle / examine placard / push candle-stand west / e / examine novel / w / n / n".

wi 18.18 Printing a refusal to act in the dark
rb 3.7 Lighting

349. Four Stars 1 ★★★

"Four Stars"

A thing has some text called sound. The sound of a thing is usually "silence".

The report listening rule is not listed in the report listening to rules.

Carry out listening to something:

say "From [the noun] you hear [the sound of the noun]."

Instead of listening to a room:

if an audible thing can be touched by the player, say "You hear [the list of audible things which can be touched by the player].";

otherwise say "A merciful peace prevails."

Definition: a thing is audible if the sound of it is not "silence".

Before printing the name of something audible while listening to a room:

say "[sound] from the "

A thing has some text called scent. The scent of a thing is usually "nothing".

The report smelling rule is not listed in the report smelling rulebook.

Carry out smelling something:

say "From [the noun] you smell [scent of the noun]."

Instead of smelling a room:

if a scented thing can be touched by the player, say "You smell [the list of scented things which can be touched by the player].";

otherwise say "The place is blissfully odorless."

Definition: a thing is scented if the scent of it is not "nothing".

Before printing the name of something scented while smelling a room: say "[scent] from the "

The Waning Moon Resort is a dark room. "A spacious room with a flagstone floor, and a dreamcatcher hung over the king-size bed." The dreamcatcher is scenery in the Resort. The description is "The usual web of threads and crystals, feathers and beads." Instead of taking the dreamcatcher, say "Ah, ah -- you might be tempted to take it as a souvenir, except that the price list in the minibar clearly states they charge $65 apiece if you walk off with one. Cheaper than stealing the Frette bathrobes, but still probably not a good idea."

The king-size bed is an enterable supporter in the Resort. The description is "200-thread-count Egyptian cotton sheets, according to the website. You would make fun, only they really are extraordinarily comfortable." The player is on the bed. A Lindt chocolate is on the bed. It is edible. The scent of the chocolate is "chocolate-hazelnut smell".

Instead of exiting: say "You are too weary to move."

The suitcase is an openable closed container in the Resort.

An electric light is a kind of device. Carry out switching on an electric light: now the noun is lit. Carry out switching off an electric light: now the noun is unlit. Understand "light" as an electric light.

The solar lamp is an electric light in Waning Moon Resort. The description is "Specially designed to give light in a spectrum resembling sunlight, to improve the mood and make a person energetic." The lamp is switched on and lit.

An electric noisemaker is a kind of device. An electric noisemaker has some text called usual sound. The usual sound of an electric noisemaker is usually "beepbeepbeep". Carry out switching on an electric noisemaker: now the sound of the noun is the usual sound of the noun. Report switching on an electric noisemaker: say "[The noun] goes [usual sound of the noun]!" instead. Report switching off an electric noisemaker: say "You switch off [the noun], silencing the [usual sound of the noun]." instead.

Carry out switching off an electric noisemaker: now the sound of the noun is "silence".

The bedside table is in the Resort. The table supports a potted plant and a Bose speaker. The scent of the potted plant is "rosemary"

The Bose speaker is an electric noisemaker. The usual sound of the speaker is "soothing whalesong". The sound of the speaker is "soothing whalesong". The speaker is switched on.

Instead of touching a device: say "You feel the surface of [the noun] and discover the switch."

Instead of touching a scented thing: say "The brush of your fingers stirs loose a fresh cloud of [scent of the noun] smell."

Rule for printing the description of a dark room: try listening; try smelling; rule succeeds.

Instead of examining an audible thing while in darkness: try listening to the noun. Instead of examining something while in darkness: try touching the noun.

Before touching something when in darkness:

say "You grope about..."

After inserting the plant into something:

say "You unceremoniously dump [the noun] into [the second noun], hoping it sustains no important damage thereby."

Before printing the name of a dark room: if the player can touch an audible thing, say "Noisy "; if the player can touch a scented thing, say "Perfumed ".

Visibility rule when in darkness:

if examining something, there is sufficient light;

there is insufficient light.

Rule for printing the announcement of darkness: say "It is now pleasantly lightless in here." instead.

Rule for deciding the scope of the player while in darkness: place the location in scope.

To decide whether in daylight:

if in darkness, no;

yes.

Instead of sleeping when in daylight:

say "You've never been able to sleep with the light on."

Instead of sleeping when the player can touch an audible thing (called the irritant):

say "The steady [sound of the irritant] from [the irritant] prevents your slumber."

Instead of sleeping when the player can touch a scented thing (called the irritant):

if the irritant is chocolate, say "The smell of chocolate continues to tantalize you, keeping you from sleep.";

otherwise say "You sniffle. [The irritant] is probably acting on your allergies."

Instead of sleeping:

say "You slip easily into the arms of Morpheus.";

end the story finally saying "At last..."

When play begins:

say "You have at last escaped from the airport and gotten through customs; survived an unnerving taxi ride over icy highways; stared down the impertinent concierge; endured the bellhop's catalog of features in your room; and achieved, finally, a moment of peace. Time for a good night's slumber!"

Test me with "x dreamcatcher / switch lamp off / look / sleep / eat chocolate / sleep / get plant / examine plant / open suitcase / put plant in suitcase / close suitcase / sleep / look / examine bose / switch bose off / sleep".

wi 18.22 Printing the description of a dark room
rb 3.7 Lighting

291. Cloak of Darkness ★★★★

"Cloak of Darkness" is a brief example game that has been implemented in nearly every IF system currently used. It hasn't got much claim to complexity or richness, but it does exemplify many of the standard things one might want an IF language to be able to do: define descriptions and the results of actions, assign synonyms to nouns, create new verbs, handle darkness, track repeated acts, and so on.

Here is what the game looks like in Inform:

"Cloak of Darkness"

The story headline is "A basic IF demonstration."

Use scoring.

The maximum score is 2.

Whatever room we define first becomes the starting room of the game, in the absence of other instructions:

Foyer of the Opera House is a room.  "You are standing in a spacious hall, splendidly decorated in red and gold, with glittering chandeliers overhead. The entrance from the street is to the north, and there are doorways south and west."
 
Instead of going north in the Foyer, say "You've only just arrived, and besides, the weather outside seems to be getting worse."

We can add more rooms by specifying their relation to the first room. Unless we say otherwise, the connection will automatically be bidirectional, so "The Cloakroom is west of the Foyer" will also mean "The Foyer is east of the Cloakroom":

The Cloakroom is west of the Foyer. "The walls of this small room were clearly once lined with hooks, though now only one remains. The exit is a door to the east."
 
In the Cloakroom is a supporter called the small brass hook. The hook is scenery. Understand "peg" as the hook.

Inform will automatically understand any words in the object definition ("small", "brass", and "hook", in this case), but we can add extra synonyms with this sort of Understand command.

The description of the hook is "It's just a small brass hook, [if something is on the hook]with [a list of things on the hook] hanging on it[otherwise]screwed to the wall[end if]."

This description is general enough that, if we were to add other hangable items to the game, they would automatically be described correctly as well.

The Bar is south of the Foyer. The printed name of the bar is "Foyer Bar". The Bar is dark.  "The bar, much rougher than you'd have guessed after the opulence of the foyer to the north, is completely empty. There seems to be some sort of message scrawled in the sawdust on the floor."
 
The scrawled message is scenery in the Bar. Understand "floor" or "sawdust" as the message.
 
Neatness is a kind of value. The neatnesses are neat, scuffed, and trampled. The message has a neatness. The message is neat.

We could if we wished use a number to indicate how many times the player has stepped on the message, but Inform also makes it easy to add descriptive properties of this sort, so that the code remains readable even when the reader does not know what "the number of the message" might mean.

Instead of examining the message:
   increment score;
   say "The message, neatly marked in the sawdust, reads...";
   end the story finally.

This second rule takes precedence over the first one whenever the message is trampled. Inform automatically applies whichever rule is most specific:

Instead of examining the trampled message:
   say "The message has been carelessly trampled, making it difficult to read. You can just distinguish the words...";
   end the story saying "You have lost".

This command advances the state of the message from neat to scuffed and from scuffed to trampled. We can define any kinds of value we like and advance or decrease them in this way:

Instead of doing something other than going in the bar when in darkness:
   if the message is not trampled, now the neatness of the message is the neatness after the neatness of the message;
   say "In the dark? You could easily disturb something."
 
Instead of going nowhere from the bar when in darkness:
   now the message is trampled;
   say "Blundering around in the dark isn't a good idea!"

This defines an object which is worn at the start of play. Because we have said the player is wearing the item, Inform infers that it is clothing and can be taken off and put on again at will.

The player wears a velvet cloak. The cloak can be hung or unhung. Understand "dark" or "black" or "satin" as the cloak. The description of the cloak is "A handsome cloak, of velvet trimmed with satin, and slightly splattered with raindrops. Its blackness is so deep that it almost seems to suck light from the room."
 
Carry out taking the cloak:
   now the bar is dark.
 
Carry out putting the unhung cloak on something in the cloakroom:
   now the cloak is hung;
   increment score.
 
Carry out putting the cloak on something in the cloakroom:
   now the bar is lit.
 
Carry out dropping the cloak in the cloakroom:
   now the bar is lit.
 
Instead of dropping or putting the cloak on when the player is not in the cloakroom:
   say "This isn't the best place to leave a smart cloak lying around."
 
When play begins:
   say "[paragraph break]Hurrying through the rainswept November night, you're glad to see the bright lights of the Opera House. It's surprising that there aren't more people about but, hey, what do you expect in a cheap demo game...?"
 
Understand "hang [something preferably held] on [something]" as putting it on.
 
Test me with "s / n / w / inventory / hang cloak on hook / e / s / read message".

And that's all. As always, type TEST ME to watch the scenario play itself out.

wi 17.2 New commands for old grammar
rb 3.7 Lighting

🔗

RB §3.8 Sounds

It is too easily assumed that room descriptions are what the player sees, but as The Undertomb ★ demonstrates, they might just as easily include ambient sounds.

So Inform's "listening to" action is the audio equivalent of "examining", rather than "looking". Despite this the player can type LISTEN, which Inform understands as listening to the everything in the location at once. A simple but effective way to handle this is shown in The Art of Noise ★★★.

Four Stars 2 ★ adjusts the idea of "visibility" to make it behave differently for listening purposes: this introduces a formal idea of "audibility".

Examples

50. The Undertomb 1 ★

This example creates a kind of room, "dead end", and gives each a textual description called its "river sound". Note the use of a text substitution to fill in the appropriate river sound text in each dead end.

"The Undertomb"

A dead end is a kind of room with printed name "Dead End" and description "This is a dead end. You'll have to go back the way you came, consoled only by [river sound]." A dead end is usually dark.

The Undertomb is a dark room. East is a dead end. South is a dead end with printed name "Collapsed Dead End". Northwest is a dead end called the Tortuous Alcove. In the Undertomb is the lantern. It is lit.

A dead end has some text called river sound. The river sound of a dead end is usually "a faint whispering of running water". The Tortuous Alcove has river sound "a gurgle of running water".

Test me with "get lantern / e / w / s / n / nw / se".

wi 4.9 Using new kinds of value in properties
rb 3.8 Sounds

364. Four Stars 2 ★

As we have seen, a well-written understand rule will often solve the problem of allowing the player to apply specific actions to objects not normally in scope. When we need to adjust scope for some other reason than reading the player's command, though, "deciding the scope of…" may come in handy.

For instance, suppose we wanted to extend Four Stars 1 to add a tomcat on the balcony that will be heard whenever the player listens from the next room, as in:

>listen
You hear the soothing whalesong from the Bose speaker and the yowling from the tomcat.

To do this, we need to make sure that in the rule that assembles our listening description,

Instead of listening to a room:
   if an audible thing can be touched by the player, say "You hear [the list of audible things which can be touched by the player].";
   otherwise say "A merciful peace prevails."

now includes the tomcat in the "list of audible things which can be touched by the player".

To this end, we're going to change the way we assess scope, but only during the listening action. Otherwise the tomcat remains in the other room and off-limits. The new source text is marked out below:

"Four Stars"

Section 1 - Procedure

A thing has some text called sound. The sound of a thing is usually "silence".

The report listening rule is not listed in the report listening to rules.

Carry out listening to something:

say "From [the noun] you hear [the sound of the noun]."

Instead of listening to a room:

if an audible thing can be touched by the player, say "You hear [the list of audible things which can be touched by the player].";

otherwise say "A merciful peace prevails."

Definition: a thing is audible if the sound of it is not "silence".

Before printing the name of something audible while listening to a room:

say "[sound] from the "

A thing has some text called scent. The scent of a thing is usually "nothing".

The report smelling rule is not listed in the report smelling rulebook.

Carry out smelling something:

say "From [the noun] you smell [scent of the noun]."

Instead of smelling a room:

if a scented thing can be touched by the player, say "You smell [the list of scented things which can be touched by the player].";

otherwise say "The place is blissfully odorless."

Definition: a thing is scented if the scent of it is not "nothing".

Before printing the name of something scented while smelling a room: say "[scent] from the "

Here is our addition:

After deciding the scope of the player while listening or sleeping or looking:
   if in darkness:
      repeat with locale running through adjacent rooms:
         place locale in scope.
 
A reaching inside rule while listening or sleeping or looking:
   rule succeeds.
 
Section 2 - Scenario
 
The Waning Moon Resort is a dark room. "A spacious room with a flagstone floor, and a dreamcatcher hung over the king-size bed." The dreamcatcher is scenery in the Resort. The description is "The usual web of threads and crystals, feathers and beads." Instead of taking the dreamcatcher, say "Ah, ah -- you might be tempted to take it as a souvenir, except that the price list in the minibar clearly states they charge $65 apiece if you walk off with one. Cheaper than stealing the Frette bathrobes, but still probably not a good idea."

And now our threat to the player's peace:

The Balcony is outside from the Resort. In the Balcony is a tomcat. The sound of the tomcat is "yowling". After printing the name of the tomcat when the tomcat is not visible: say " outside on the balcony".

From here we continue with the same scenario as before:

The king-size bed is an enterable supporter in the Resort. The description is "200-thread-count Egyptian cotton sheets, according to the website. You would make fun, only they really are extraordinarily comfortable." The player is on the bed. A Lindt chocolate is on the bed. It is edible. The scent of the chocolate is "chocolate-hazelnut smell".
 
Instead of exiting: say "You are too weary to move."
 
The suitcase is an openable closed container in the Resort.
 
An electric light is a kind of device. Carry out switching on an electric light: now the noun is lit. Carry out switching off an electric light: now the noun is unlit. Understand "light" as an electric light.
 
The solar lamp is an electric light in Waning Moon Resort. The description is "Specially designed to give light in a spectrum resembling sunlight, to improve the mood and make a person energetic." The lamp is switched on and lit.
 
An electric noisemaker is a kind of device. An electric noisemaker has some text called usual sound. The usual sound of an electric noisemaker is usually "beepbeepbeep". Carry out switching on an electric noisemaker: now the sound of the noun is the usual sound of the noun. Report switching on an electric noisemaker: say "[The noun] goes [usual sound of the noun]!" instead. Report switching off an electric noisemaker: say "You switch off [the noun], silencing the [usual sound of the noun]." instead.
 
Carry out switching off an electric noisemaker: now the sound of the noun is "silence".
 
The bedside table is in the Resort. The table supports a potted plant and a Bose speaker. The scent of the potted plant is "rosemary"
 
The Bose speaker is an electric noisemaker. The usual sound of the speaker is "soothing whalesong". The sound of the speaker is "soothing whalesong". The speaker is switched on.
 
Instead of touching a device: say "You feel the surface of [the noun] and discover the switch."
 
Instead of touching a scented thing: say "The brush of your fingers stirs loose a fresh cloud of [scent of the noun] smell."
 
Rule for printing the description of a dark room: try listening; try smelling; rule succeeds.
 
Instead of examining an audible thing while in darkness: try listening to the noun. Instead of examining something while in darkness: try touching the noun.
 
Before touching something when in darkness:
   say "You grope about..."
 
After inserting the plant into something:
   say "You unceremoniously dump [the noun] into [the second noun], hoping it sustains no important damage thereby."
 
Before printing the name of a dark room: if the player can touch an audible thing, say "Noisy "; if the player can touch a scented thing, say "Perfumed ".
 
Visibility rule when in darkness:
   if examining something, there is sufficient light;
   there is insufficient light.
 
Rule for printing the announcement of darkness: say "It is now pleasantly lightless in here." instead.
 
Rule for deciding the scope of the player while in darkness: place the location in scope.
 
To decide whether in daylight:
   if in darkness, no;
   yes.
 
Instead of sleeping when in daylight:
   say "You've never been able to sleep with the light on."
 
Instead of sleeping when the player can touch an audible thing (called the irritant):
   say "The steady [sound of the irritant] from [the irritant] prevents your slumber."
 
Instead of sleeping when the player can touch a scented thing (called the irritant):
   if the irritant is chocolate, say "The smell of chocolate continues to tantalize you, keeping you from sleep.";
   otherwise say "You sniffle. [The irritant] is probably acting on your allergies."
 
Instead of sleeping:
   say "You slip easily into the arms of Morpheus.";
   end the story finally saying "At last..."
 
 
When play begins:
   say "You have at last escaped from the airport and gotten through customs; survived an unnerving taxi ride over icy highways; stared down the impertinent concierge; endured the bellhop's catalog of features in your room; and achieved, finally, a moment of peace. Time for a good night's slumber!"
 
Test me with "listen / x dreamcatcher / switch lamp off / look / sleep / eat chocolate / sleep / get plant / examine plant / open suitcase / put plant in suitcase / close suitcase / sleep / look / examine bose / switch bose off / sleep".

Of course, this new version is less happy for the player, as we haven't included any way to silence the cat.

wi 18.29 Deciding the scope of something
rb 3.8 Sounds

95. The Art of Noise ★★★

This example involves redesigning the LISTEN command, removing its built-in function and replacing that with something more ambitious. We will learn more about how to do this later on.

"The Art of Noise"

A thing has some text called sound. The sound of a thing is usually "silence".

The report listening rule is not listed in the report listening to rules.

Carry out listening to something:

say "From [the noun] you hear [the sound of the noun]."

Instead of listening to a room:

if an audible thing can be touched by the player, say "You hear [the list of audible things which can be touched by the player].";

otherwise say "Nothing of note."

Definition: a thing is audible if the sound of it is not "silence".

Before printing the name of something audible while listening to a room:

say "[sound] from the "

The Sharper Image is a room. The pet rock is a thing in the Sharper Image. The toy car is a thing in the Sharper Image. The sound of the car is "whirring and zooming". The plastic widget is a thing in the Sharper Image. The sound of the plastic widget is "bleeps and bloops". The pointless gadget is a thing in Sharper Image. The sound of the pointless gadget is "buzzbuzzbuzz".

The soundproof case is a transparent openable container in the Sharper Image. It is closed and fixed in place.

Test me with "listen / listen to rock / listen to car / get all / open case / put all in case / listen / close case / listen / listen to car".

wi 7.7 The other four senses
rb 3.8 Sounds

🔗

RB §3.9 Passers-By, Weather and Astronomical Events

Out of doors, nature is seldom still. Clouds scull by at random, as in Weathering ★, and provide some variety in what would otherwise be lifelessly static room descriptions. In much the same way, passers-by and other diversions make a city street a constant bustle: see Uptown Girls ★★★ for this human breeze. A more nagging sense of atmosphere can be experienced in Full Moon ★.

Orange Cones ★★★ offers traffic that is present on every road in the story unless a room is marked off with orange cones -- and this is allowed to change during play.

Night and Day ★ and Totality ★★ each schedule celestial events to provide a changing display in the sky above, and this time running like clockwork rather than at random.

Examples

131. Weathering ★

"Weathering"

A cloud pattern is a kind of value. The cloud patterns are cumulus, altocumulus, cumulonimbus, stratus, cirrus, nimbus, nimbostratus.

The Mount Pisgah Station is a room. "The rocky peak of Mt. Pisgah (altitude 872m) is graced only by an automatic weather station. The clouds, close enough almost to touch, are [a random cloud pattern]. Temperature: [a random number from 7 to 17] degrees, barometric pressure: [950 + a random number from 0 to 15] millibars."

Test me with "look / look / look".

wi 8.18 Randomness
rb 3.9 Passers-By, Weather and Astronomical Events

157. Full Moon ★

"Full Moon"

Wolf Pursuit is a scene. Wolf Pursuit begins when play begins.

Every turn during Wolf Pursuit, say "[one of]A twig snaps behind you![or]The wind howls in your ears.[or]You feel chilly.[at random]".

When play begins:

say "You have lost your spectacles, and the lamp, and can see barely further than the next tree. Roots keep trying to trip you, too..."

The Dark Forest is a room. "You are mostly aware that you are not as alone here as you would like, and that the ground is uneven."

Test me with "z / z / z / z".

wi 10.4 During scenes
rb 3.9 Passers-By, Weather and Astronomical Events

164. Night and Day ★

Suppose we want to have a sequence of nights and days in our game, with one scene to govern each daylight condition.

"Night and Day"

The sun is a backdrop. It is everywhere. The description is "Currently out of sight."

Night is a recurring scene. Night begins when play begins. Night begins when Dusk ends. Night ends when the time since Night began is 3 minutes.

Notice that our two conditions for the beginning of Night are not in conflict: it will be night-time when the game begins, and then night will also recur every time the Dusk scene ends.

When Night begins:
   say "The sun falls below the horizon and the temperature drops abruptly to well below zero.";
   now the description of the sun is "Currently out of sight."
 
Dawn is a recurring scene. Dawn begins when Night ends. Dawn ends when the time since Dawn began is 1 minute.
 
When Dawn begins:
   say "The sun appears on the horizon.";
   now the description of the sun is "It is tiny and weak.".
 
Day is a recurring scene. Day begins when Dawn ends. Day ends when the time since Day began is 3 minutes.
 
When Day begins:
   say "The sun is now properly up."
 
Dusk is a recurring scene. Dusk begins when Day ends. Dusk ends when the time since Dusk began is 1 minute.
 
When Dusk begins:
   say "The sun has passed across the sky and is on the verge of setting."
 
Cratered Landscape is a room. "The ground here is [if Night is happening]dim silver, with the craters visible as darker splotches[otherwise]the color of dried blood; here and there it is also rippled by impact craters[end if]. The horizon curves visibly."
 
Test me with "z / z / z / look / x sun / z / z / z / z / z / z / z".

If we run this example and then have a look at the scenes index, we'll see that the cycle is listed through thus:

Night (recurring)
   Dawn (recurring)
      Day (recurring)
         Dusk (recurring)
            Night

with the second "Night" in italics, to indicate that it is a repetition of the same scene that has already been listed above.

wi 10.7 Multiple beginnings and repeats
rb 3.9 Passers-By, Weather and Astronomical Events

144. Totality ★★

First we define the events, and then we create a phrase to schedule them:

"Totality"

At the time when the penumbra appears:

say "The sunlight dies away to an eerie, brownish penumbra."

At the time when the eclipse begins:

say "The moon passes across the disc of the sun, plunging the world into darkness.";

now the Chamber is dark.

At the time when the eclipse ends:

say "The moon passes away from the sun, and a gloomy penumbral light returns.";

now the Chamber is lighted.

At the time when normal sunlight returns:

say "The sun shines once more bright in the sky, not to be eclipsed again on this spot for another thirty-seven years."

To schedule an eclipse for (totality - a time):

the penumbra appears at two minutes before totality;

the eclipse begins at totality;

the eclipse ends at three minutes after totality;

normal sunlight returns at five minutes after totality.

Now we make use of the new phrase:

When play begins, schedule an eclipse for 3:27 PM.
 
The Chamber is a room.
 
The time of day is 3:25 PM.
 
Test me with "z / z / z / z / z / z / z / z / z".

We shall see much more about creating phrases later. Their advantage is that they enable a complicated sequence of operations to be given a meaningful name, and that they can be re-used many times as needed.

wi 9.11 Future events
rb 3.9 Passers-By, Weather and Astronomical Events

120. Orange Cones ★★★

Because we can invent our own adjectives (see the chapter on Phrases), we can make the conditions for a backdrop as simple or as complicated as we like.

In this scenario, we want the player to be able to take, move, and drop orange traffic cones to seal off one street or another. So we create our own "accessible" adjective as follows:

Definition: a road is accessible if the orange cones are not in it.

…and now

move the traffic backdrop to all accessible roads.

will tell the traffic backdrop where to appear.

"Orange Cones"

A road is a kind of room.

The traffic is a backdrop. It is not scenery. The initial appearance is "Dense traffic snarls the streets, making it difficult to cross even with the lights. Men on motorbikes edge between the cars, and sometimes pull up onto the sidewalks to go around." The description is "It is more or less as usual for this time of day. It's a wonder it ever dissipates, really."

When play begins:

move the traffic backdrop to all accessible roads.

A line of orange cones are a thing.

Definition: a road is accessible if the orange cones are not in it.

After dropping the orange cones in a road:

say "With steely determination you begin to lay out the orange cones, blocking access to this segment of street. This produces honking and swearing -- but you persevere.";

update backdrop positions.

After taking the orange cones:

say "You go around taking up the orange cones, and within moments the traffic begins to flow into the street again.";

update backdrop positions.

That accomplishes everything we set out to do, but let's add a very simple puzzle to test it out with:

The Town Square is a road. North of the Town Square is Candle Street. Candle Street is a road. East of Town Square is Mortar Street. Mortar Street is a road.
 
The line of orange cones are in Mortar Street.
 
The player wears a reflective vest and a hard hat.
 
The manhole cover is a door. "[if location is accessible]Under the cars in the middle of the street, you can just make out the cover of the manhole you need to get into.[otherwise]There's a promising manhole in the middle of the street.[end if]". It is closed and openable. It is below the Town Square and above the Access Tunnel.
 
Instead of opening the manhole cover when the location is an accessible road:
   say "You can't get anywhere near the manhole cover with all these cars above it."
 
Instead of taking the orange cones in Town Square:
   if the manhole cover is closed or Town Square is accessible, continue the action;
   otherwise say "You'd better not let the traffic back in until you've closed the manhole. There'll be accidents otherwise."
 
After going to the Access Tunnel:
   say "With a stealthy glance left and right, you lower yourself into the access tunnel, thus accomplishing your mission for Chapter 2. To continue your adventure, see Chapter 3: The Vault of Peaquod.";
   end the story finally.

And finally, a couple of features from the Activities chapter to make the output more elegant:

Rule for writing a paragraph about the orange cones: say "A line of orange cones holds back the traffic from entering here."
 
Rule for printing the name of the orange cones when the cones are carried by the player:
   say "stack of orange cones".
 
Test me with "x traffic / open manhole / n / x traffic / s / e / x traffic / get cones / look / x traffic / w / drop cones / look / open manhole / take cones / d".

wi 8.8 Moving backdrops
rb 3.9 Passers-By, Weather and Astronomical Events

132. Uptown Girls ★★★

Suppose we have an urban space we want to populate with random passers-by. These should have a range of characteristics and not always be described in the same way; and once the player has noticed one, he should be able to look at her further, until another pedestrian crosses his path.

"Uptown Girls"

Riverside Drive is a room. "There's a pleasant late-afternoon view of the Hudson, and a snap in the air, and you would rather be here than anywhere."

Instead of going a direction, say "Oh, you know where you're going; no need to deviate from the usual path."

Instead of waiting, say "You stroll along enjoying the November crispness."

It gets a little annoying to have a random event occurring every single turn of play, so let's introduce some randomness to determine how often the message appears:

Every turn when a random chance of 1 in 3 succeeds:
   reset passerby;
   choose a random row in the Table of Atmospheric Events;
   say "[event entry][paragraph break]"
 
Table of Atmospheric Events

event
"Slowly [a passerby] strolls by, turning to look at you as she passes."
"Some [passerby] nearly bumps into you."
"You dodge to avoid [a passerby]."
"You weave around [a passerby], who has stalled to look into a window."
"There's a ruckus as one of the ubiquitous taxis nearly collides with [a passerby] crossing the street."
"[The passerby] beside you waves to a friend across the street."
"To your left, [a passerby] drops her purse, and swears as she retrieves it."
 
Hair color is a kind of value. A person has hair color. the hair colors are red-headed, brunette, blonde.
 
Height is a kind of value. A person has height. The heights are tall, medium-height, short.
 
Grooming is a kind of value. A person has grooming. The groomings are messy and tidy.
 
To reset passerby:
   now the hair color of the passerby is a random hair color;
   now the height of the passerby is a random height;
   now the grooming of the passerby is a random grooming.
 
The passerby is a woman in Riverside Drive. The passerby is scenery. Understand "woman" or "lady" as the passerby. The printed name of the passerby is "[one of]woman[or]lady[purely at random]".

At this point we borrow some techniques from later to describe the woman with a random combination of characteristics, and to let the player refer to her by those traits:

Before printing the name of the passerby:
   if a random chance of 1 in 4 succeeds, say "[height] ";
   if a random chance of 1 in 4 succeeds, say "[grooming] ";
   if a random chance of 1 in 4 succeeds, say "[hair color] ".
 
Understand the hair color property as describing the passerby. Understand the height property as describing the passerby. Understand the grooming property as describing the passerby.

If we also wanted each of those combinations to mean some more specifically-described woman:

Instead of examining a passerby:
   repeat through Table of Passerby Descriptions:
      if hair entry is the hair color of the passerby and height entry is the height of the passerby and grooming entry is the grooming of the passerby, say "[description entry][paragraph break]".
 
Table of Passerby Descriptions

hairheightgroomingdescription
red-headedtallmessy"An older woman with long red hippie-hair poking out of a ponytail in straggles, and bent to hide how tall she is."
red-headedmedium-heightmessy"A shaggy red-head with shingled hair."
red-headedshortmessy"Almost an urchin, and very young, with ginger hair and a smudged nose and far too many freckles."
red-headedtalltidy"A precise career woman with henna-red hair."
red-headedmedium-heighttidy"Her hair is red in the way that lollipops and fire trucks are red: not by nature but by art. The rest of her clothing is pretty ordinary, though."
red-headedshorttidy"Thin and small in every sense, with chin-length red-hair. Even high heels do not bring her head much above your shoulder."
brunettetallmessy"A Juno-esque woman with dark hair, wearing something resembling a tent."
brunettemedium-heightmessy"An unremarkable woman with dark brown hair and the aura of needing a wash."
brunetteshortmessy"There are mustard stains on the t-shirt of this short brown-haired woman. Estimated age ca. 40. Possibly homeless."
brunettetalltidy"A leggy brunette in business attire."
brunettemedium-heighttidy"Medium-height, brown-haired, generally nondescript."
brunetteshorttidy"A neat little dark-haired girl."
blondetallmessy"A tall blonde of about thirteen who looks as though she has not yet figured out how to get her wardrobe to catch up with her rate of growth. Her t-shirt and her pants are too short."
blondemedium-heightmessy"Black leather pants and the wall-o-hair look."
blondeshortmessy"One of those shocking platinum blonde types, with a tiger-patterned skirt. Reeally trashy."
blondetalltidy"Elfin and severe, with perfectly straight hair falling to the middle of the back."
blondemedium-heighttidy"A rounded, Marilyn-esque blonde."
blondeshorttidy"Pin-precise in a blue-and-white striped suit and a boyish haircut."
 
Test me with "z / z / x passerby / z / z / x passerby".

wi 8.18 Randomness
rb 3.9 Passers-By, Weather and Astronomical Events

§4.

§4.

§4.

§4.

§4.

§4.

RB §4.1 The Passage Of Time

A story that makes heavy use of time may want to give the player a hint that time is important - and an easy way to keep track of how it's going - by adding the current time to the status line, instead of the score. To do this, we would write

When play begins:
   now the right hand status line is "[time of day]".

All else being equal, time passes at a rate of one minute per turn. But this need not be so: we can imagine a story where turns take much less time, or much more; or a story in which the passage of time was sometimes suspended, or one in which different actions required different amounts of time to perform.

Situation Room ★ provides a way to print 24-hour time, while Zqlran Era 8 ★★★ implements a completely new measurement of time, for a story set on an alien world.

Uptempo ★ and The Hang of Thursdays ★★★ speed up time's passage: turns take fifteen minutes in the former, or a quarter day in the latter.

Timeless ★ makes certain actions instant, so that they don't count against the clock; this is sometimes useful in timed situations where the player needs to review the situation before going on with a tricky puzzle. Endurance ★★ systematically extends this idea to allow us to assign different durations to any action in the story. The Big Sainsbury's ★ goes the opposite direction, and meticulously adds a minute to the clock for all implicit take actions, just so that the player isn't allowed to economize on moves.

An alternative approach to time is not to tell the player specifically what hour of the day it is at all, but to move from one general time period to another as it becomes appropriate - when the player has solved enough puzzles, or worked his way through enough of the plot. To this end we might use scenes representing, say, Thursday afternoon and then Thursday evening; then our scene rules, rather than the clock, would determine when Thursday afternoon stopped and Thursday evening began:

Thursday afternoon is a scene. Thursday evening is a scene.
 
Thursday afternoon ends when the player carries the portfolio.
 
Thursday evening begins when Thursday afternoon ends.
When Thursday evening begins:
   say "The great clock over St. Margaret's begins to chime 6.";

Though this gives time a loose relation to the number of turns played, it feels surprisingly realistic: players tend to think of time in a story in terms of the number of significant moves they made, while the random wandering, taking inventory, and looking at room descriptions while stuck don't make as big an impression. So advancing the story clock alongside the player's puzzle solutions or plot progress can work just as well as any stricter calculation.

Examples

142. Situation Room ★

Though Inform normally prints times in AM/PM terms, it stores the hours and minutes as 24-hour time; so, if we like, we can easily extract that information again thus:

"Situation Room"

The Situation Room is a room.

To say (relevant time - a time) as 24h time:

let H be the hours part of relevant time;

let M be the minutes part of relevant time;

say "[if H is less than 10]0[end if][H][if M is less than 10]0[end if][M]".

When play begins:

now the time of day is 6:09 PM;

now the right hand status line is "[time of day as 24h time]".

Test me with "z".

wi 9.7 Telling the time
rb 4.1 The Passage Of Time

377. The Big Sainsbury's ★

Implicit takes are a convenience to players; in general, we would like to avoid asking players to type any more obvious commands than strictly necessary, while allowing the computer to guess as much as it safely can.

Occasionally, though, we have designed a timed puzzle in which the player has a limited number of moves in which to accomplish his objectives. In that case, the implicit take complicates matters, because it means that a player who types

>EAT GATEAU
(first taking the gateau...)

gets away with a spare move compared to the precise but naïf dupe who types

>TAKE GATEAU
>EAT GATEAU

…and really, that doesn't seem quite fair. The way to fix this problem is to fill in the extra minute on the clock during the implicit take; and that is indeed what we do in the following example.

"The Big Sainsbury's"

Sainsbury's is a room.

The crispy duck and the Guinness steak pie are edible things in Sainsbury's.

Rule for implicitly taking something:

follow the advance time rule;

continue the activity.

When play begins:

now the right hand status line is "[time of day]".

Test me with "take crispy duck / eat crispy duck / eat steak pie".

wi 18.34 Implicitly taking something
rb 4.1 The Passage Of Time

394. Uptempo ★

Suppose a game in which all actions take a very long time. Here's a simple implementation:

"Uptempo"

The fast time rule is listed instead of the advance time rule in the turn sequence rules.

This is the fast time rule:

increment the turn count;

increase the time of day by 15 minutes.

When play begins: now the right hand status line is "[time of day]".

The Temporal Hot Spot is a room.

Test me with "z / z".

This works fine as it stands, but we may run into some difficulty with it if we add scheduled events:

At 9:30 AM:

say "Two turtles run by, almost too fast to see."

At 9:37 AM:

say "A snail blitzes past."

At 9:42 AM:

say "The grass grows."

At 9:50 AM:

say "Several flowers burst open."

Time is counted forward after the schedule has already been consulted, so that only the 9:30 AM event happens between 9:30 and 9:45; the next two appear to occur between 9:45 and 10:00 AM, and the 9:50 AM event is not reported until the 10:00 AM to 10:15 wait. To get around this, we might schedule events only on the fifteen-minute mark when we want them to occur. Alternatively, we might try instead

"Uptempo"

The fast time rule is listed before the timed events rule in the turn sequence rules.

The advance time rule is not listed in the turn sequence rules.

This is the fast time rule:

increment the turn count;

increase the time of day by 15 minutes.

When play begins: now the right hand status line is "[time of day]".

The Temporal Hot Spot is a room.

At 9:30 AM:

say "Two turtles run by, almost too fast to see."

At 9:37 AM:

say "A snail blitzes past."

At 9:42 AM:

say "The grass grows."

At 9:50 AM:

say "Several flowers burst open."

Test me with "z / z / z / z".

This time our revised time-advancing rule is listed just before the event scheduler, not just afterwards.

wi 19.4 Listing rules explicitly
rb 4.1 The Passage Of Time

408. Timeless ★

In a game with tight timing, it is sometimes friendliest to the player to let him LOOK and EXAMINE as much as necessary without being penalized.

"Timeless"

Examining something is acting fast. Looking is acting fast.

Now we need a rule which, just at the right moment, stops the turn sequence rulebook in the cast of our new fast-acting actions:

The take visual actions out of world rule is listed before the every turn stage rule in the turn sequence rules.
 
This is the take visual actions out of world rule: if acting fast, rule succeeds.

Thus the rest of the turn sequence rulebook is omitted for looking or examining: in effect, they become out-of-world actions like "saving the game". If we wanted to add, say, taking inventory to the list of instant activities, we would just need to define it as acting fast, too.

Now the scenario for testing:

When play begins:
   say "You are cornered by a pack of zombie wolves, armed only with a torch and a pair of pinking shears. This may be your last moment on earth, unless you can think fast!"
 
Cleft is a room. "You're backed into a cleft in the granite: behind you are only steep, high faces of stone, and before you a narrow passage."
 
The plural of zombie wolf is zombie wolves. A zombie wolf is a kind of animal. Four zombie wolves are in Cleft.
 
Rule for writing a paragraph about zombie wolves:
   say "The good news is that there isn't much space in which for the zombie wolves to attack.";
   now every zombie wolf is mentioned.
 
A steep high face of stone is scenery in Cleft. Understand "rock" as the stone. The description is "Now that you look more closely, there appear to be pitons driven into the rock."
 
Some pitons are part of the stone. The description of the pitons is "It looks as though someone else has made this ascent before."
 
Instead of climbing the stone, try going up. Instead of climbing the pitons, try going up.
 
Above the Cleft is Clifftop.
 
Every turn when the location is Cleft:
   say "Alas, your time has run out. The alpha wolf springs--";
   end the story.
 
Every turn when the location is Clifftop:
   say "After a breathless climb, you emerge at last onto the open clifftop.";
   end the story finally.
 
Test me with "x me / x stone / x pitons / climb pitons".

wi 19.15 Two rulebooks used internally
rb 4.1 The Passage Of Time

409. Endurance ★★

Here we move to a systematic way of giving different durations to different actions, including even variations on the same act -- so that for instance climbing a steep hill might take several minutes more than other going actions. We do this by setting a number, "work duration", to represent the number of minutes consumed by a given action, and then consulting a rulebook to find out how long the past turn's action should take. By default, an action will take 1 minute.

We'll start by emulating the behavior of "Uptempo": each turn we'll set the clock forward most of the way, then check to see what has changed since the last turn, print any relevant events, and only then set the clock forward the final minute. The exception is when an action is set to take no time at all; in that case, we'll skip the rest of the turn sequence rules entirely.

"Endurance"

Work duration is a number that varies.

Every turn:

now work duration is 0;

increment the turn count;

follow the time allotment rules;

if work duration is 0, rule succeeds;

increase the time of day by (work duration minutes - 1 minute).

The time allotment rules are a rulebook.

A time allotment rule for examining or looking:

now work duration is 0;

rule succeeds.

A time allotment rule for going:

now work duration is 2;

rule succeeds.

A time allotment rule for going up:

now work duration is 5;

rule succeeds.

A time allotment rule for waiting:

now work duration is 10;

rule succeeds.

The last time allotment rule:

now work duration is 1.

When play begins: now the right hand status line is "[time of day]".

The Quai is a room. "An attractive park at the edge of the river Aude: here you can wander among palm trees, and watch cyclists go by on the bike path; in the water there are ducks. In the cafe to your north, patrons sip their pastis; and above you is the medieval walled city and its castle."

The Cafe is north of the Quai. "A charming collection of umbrella-shaded tables, from which one can watch the river and the walls of the city beyond. The noise of traffic is only a minor distraction."

The City is above the Quai.

After going to the City:

say "You struggle uphill for some distance...";

continue the action.

At 9:15 AM:

say "The bells ring out from Place Carnot."

Test me with "z / n / s / u".

wi 19.15 Two rulebooks used internally
rb 4.1 The Passage Of Time

183. The Hang of Thursdays ★★★

"The Hang of Thursdays"

The Stage is a room. Rule for printing the name of the stage: say "[current weekday] [current time period]" instead.

A weekday is a kind of value. The weekdays are Saturday, Sunday, Monday, Tuesday, Wednesday, Thursday, Friday. The current weekday is a weekday that varies. The current weekday is Saturday.

A time period is a kind of value. The time periods are morning, afternoon, evening, night. The current time period is a time period that varies. The current time period is afternoon.

This is the new advance time rule:

if the current time period is less than night:

now the current time period is the time period after the current time period;

otherwise:

now the current time period is morning;

now the current weekday is the weekday after the current weekday.

Now we need to borrow from a later chapter to make these instructions apply to the passage of time:

The new advance time rule is listed instead of the advance time rule in the turn sequence rules.
 
Test me with "z / z / z / z / z".

wi 11.18 The value after and the value before
rb 4.1 The Passage Of Time

260. Zqlran Era 8 ★★★

Suppose that our game takes place on an alien planet that does not follow Earth time. On this planet, we want to track time with different units. We also want time to advance in those units, and we want to be able to set a schedule of timed events.

"Zqlran Era 8"

The Barren Lavender Surface of Zql is a room. "It is late twilight on Zql. Overhead, two crescent moons, both green, mark the sluggish passage of time. A cold wind is blowing over the pale purplish ground cover, but it does not penetrate your airtight suit."

A Zqlran date is a kind of value. 14-88 specifies a Zqlran date with parts zqls and frbs. Current zqlran date is a zqlran date that varies. The current zqlran date is 8-22. Previous zqlran date is a zqlran date that varies. The previous zqlran date is 8-20.

When play begins:

now left hand status line is "[current zqlran date], or [current zqlran date in words]".

To say (Zqlra - a Zqlran date) in words:

say "[zqls part of Zqlra] Z, [frbs part of Zqlra] f."

Inform automatically supplies a way to say a new unit, which will look similar to the format in which we defined that unit in the first place. But we can (as shown here) create our own alternative say phrases to express the units in other ways as well.

Next, we need to meddle with time advancement so that time is tracked in Zqlran date rather than in minutes. This requires borrowing a trick from a later chapter, to replace Inform's built-in time handling with an alternative time handling rule of our own:

The Zqlran time rule is listed instead of the advance time rule in the turn sequence rules.
 
This is the Zqlran time rule:
   increment turn count;
   now the previous zqlran date is current zqlran date;
   increase the current zqlran date by 0-02;
   repeat through the Table of Zql Schedule:
      if era entry is greater than previous zqlran date and era entry is not greater than current zqlran date:
         say event entry;
         say paragraph break;
         blank out the whole row.
 
Table of Zql Schedule

eraevent
8-24"A wisp-thin cloud blows rapidly across the face of Nepenthe, the lesser of the two green moons."
8-28"The cloud across Nepenthe clears."

Note that we could if we wished use a different device for scheduling events: this one simply prints text at scheduled eras, but we might also (for instance) make the event entry be a rule for Inform to follow, and tell Inform to carry out that rule at the scheduled time.

wi 15.15 The parts of a number specification
rb 4.1 The Passage Of Time

🔗

RB §4.2 Scripted Scenes

Sometimes we want to arrange a scene in which something goes on in the background (as though it were a movie playing) while the player goes about his business; or where a series of things has to happen before the player gets to the end.

The simplest way to arrange background events for a scene is to write the sequence of events into a table and work our way through it, printing one line per turn, until the scene runs out. Day One ★★★ does exactly this.

At other times, we want a scene to last as long as it takes the player to do something. Entrapment ★★ lets the player poke around and explore as much as he likes, but ends as soon as he has accomplished the scene's goal - which, unfortunately for him, is to get into an embarrassing situation so that another character can walk in and make fun of him. The Prague Job ★ has a scene that requires the player to do a more specific set of tasks, but nags him and hurries him along until he's done.

Bowler Hats and Baby Geese ★★★ assumes that our story is going to be assembled with a number of scenes, some of which will need to prevent the player from leaving the location until the scene is complete: it thus defines a "restricted" property for scenes, so that all such elements of the plot will work in the same way.

For more complex sorts of scripts and schedules, it may be worth consulting the extensions.

Examples

162. The Prague Job ★

Suppose we want to remind the player that he doesn't have all the time in the world, by starting to nag him when he's nearly, but not entirely, done going over his inventory in preparation for a job.

"The Prague Job"

A thing can be seen or unseen. A thing is usually unseen. Carry out examining: now the noun is seen.

The player carries a lockpick, a smoke bomb, a grappling hook, and a pair of gloves. The description of the lockpick is "Effective on most kinds of key locks, it is a gift from your mentor in the discipline, old Wheezy." The description of the smoke bomb is "Your last of these, so you should rely on it only when other modes of escape have vanished. It takes effect when dropped, producing a cloud of purple haze sufficient to fill a medium-sized room." The description of the grappling hook is "Good for shooting at balconies and other sorts of overhang." The gloves are wearable. The description of the gloves is "Black and shiny, with gripping material on the palms. Batman would be jealous."

The Toilet is a room. "The walls are painted an unattractive green; the fixtures are a bit old. But it is the only place in the hostel with any privacy." The Long Hallway is outside from the Toilet.

Reviewing Possessions is a scene. Reviewing Possessions begins when play begins.

Escalating Danger is a scene. Reviewing Possessions ends when Escalating Danger begins. Escalating Danger begins when preparations near completion.

To decide whether preparations near completion:

if at least two of the things which are carried by the player are seen, yes;

no.

When Escalating Danger begins: say "Someone pounds on the door of your hideout and yells at you in Czech."

Instead of going from the Toilet during Reviewing Possessions: say "You need to go over your equipment first, and make sure you're ready here."

Instead of going from the Toilet during Escalating Danger: say "You're not done checking over your materials."

Instead of waiting during Escalating Danger: say "There's no time to waste."

Every turn during Escalating Danger: if the time since Escalating Danger began is greater than 1 minute, say "Impatient footsteps pass your door again."

Escalating Danger ends when every thing which is carried by the player is seen. When Escalating Danger ends, say "There -- nothing damaged or torn. You're ready to go."

Mission is a scene. Mission begins when the player is in the Long Hallway. When Mission begins: end the story saying "The game is afoot"

Test me with "i / x lockpick / out / x bomb / out / x hook / x gloves / out".

wi 10.6 More general linkages
rb 4.2 Scripted Scenes

155. Entrapment ★★

The power of scenes lies in their ability to watch for general conditions and move the narrative along whenever these are fulfilled. Instead of waiting for the player to do one specific thing, the game waits for the world to be in a certain condition, before moving to the next stage of the plot.

For instance, suppose we have a story in which the player has been captured for doing something inappropriate at court and is brought in to await a meeting with a palace official. We want to give the player a few minutes to stew, and we want the scene to end with him doing something mildly peculiar or embarrassing, and the official catching him in the act. So we tempt him into trying any of a number of different kooky activities, and just wait until he falls into the trap…

"Entrapment"

Waiting Suite is a room. "You find yourself in a narrow room, more cozy than is really comfortable, with dark paneling on all the walls. Underfoot is a thick carpet the color of dried blood. The head of a dragon kit is mounted on the wall."

The wood paneling is scenery in the Waiting Suite. The description is "Just the sort of ornate panels that might conceal a carved switch. You've heard all sorts of rumors about secret rooms and passages in the palace, some of which have not been opened in centuries because no one remembers how to get at them." Understand "panels" or "panel" or "panelling" as the paneling.

Instead of switching on the paneling, say "First you'll have to locate any switches or catches with a careful search."

The thick carpet is scenery in the Waiting Suite. Understand "red" or "blood" or "rug" as the carpet. The description is "A dull, unwelcoming weave, only a touch redder than the wood around you. You discern that it does not lie perfectly flat."

Instead of touching the paneling for the first time: say "You run your hands over the paneling with a methodical touch, knowing exactly what you're looking for but never quite feeling anything that gives or twists; then thump lightly, looking for hollow spaces."

Instead of touching the paneling for the second time: say "With increased vigor, you run your fingers along the borders between panels, then smack each panel sharply at the center. No luck yet, but if you keep at it, you're bound to turn up anything that's there to find."

Instead of attacking the paneling: try touching the paneling. Instead of searching the paneling: try touching the paneling. Understand "knock on [something]" or "tap [something]" or "tap on [something]" as attacking.

After touching the paneling when the player is not confident:

say "Having polished off all the panels within easy reach, you now have to contort yourself around furniture here and crawl along the floorboards there, hitting each panel three times quite solidly before moving on.";

now the player is embarrassed.

Instead of looking under the carpet for the first time:

say "You take a corner of the carpet and tug. The floor is sticky, so it doesn't come up on the first try."

A small table is an enterable supporter in the Waiting Suite. On the table is a copy of Dragon Pursuit Today. The description of Dragon Pursuit Today is "Full of glossy illustrations of dragons in various stages of capture, captivity, and destruction. The back of the magazine contains small black-and-white advertisements for hunting kits and the like." Some advertisements and some illustrations are part of Dragon Pursuit Today. The description of the illustrations is "You have the misfortune to look first at the photographs accompanying 'Cleaning Dragon Splanchna', and feel quite unwell." The description of the advertisements is "Mostly terse ads and phone numbers."

After looking under the table:

say "It's quite a low table and you have to get down on your knees and poke your head underneath in order to get a good look."

After looking under the carpet:

say "You pull again at the carpet. There is a tug, then a tearing, as the ancient fabric struggles against the fabric glue. Some of the carpet winds up in your hand and some of it remains in patchy threads adhering to the floor."

After entering the table:

say "You climb onto the small table, noticing belatedly that you are leaving muddy footprints on its polished surface. Oh well: you can wipe them away again when you get down."

The dragon head is scenery in the Waiting Suite. Understand "kit" or "mouth" as the dragon head. The description is "Its eyes are wide with bewildered surprise; its mouth gapes, its forked tongue protrudes indignantly. From down here it looks as though there's something shiny stuck in its mouth, though you can't tell for sure." The head contains a shiny thing. The description of the shiny thing is "Intriguing but impossible to see clearly." Instead of taking the shiny thing, try searching the dragon head.

Before searching the dragon head:

if the player is not on the table, try entering the table;

if the player is not on the table, stop the action.

After searching the dragon head: say "You have a good look inside the dragon's mouth. There's a ball of lucite inside, propping the jaw in display position."

A person can be confident, nervous, or embarrassed. The player is confident.

Touching the paneling is embarrassing behavior. Looking under the carpet is embarrassing behavior. Entering the table is embarrassing behavior. Looking under the table is embarrassing behavior.

Instead of embarrassing behavior:

if the player is nervous, now the player is embarrassed;

if the player is confident:

say "Before you can act, you hear movement from the inner office. You freeze, not quite ready to be discovered in this situation. But no one comes out, and you begin to breathe more easily.";

now the player is nervous;

otherwise:

continue the action.

Causing trouble is a scene. Causing trouble begins when play begins. Causing trouble ends when the player is embarrassed. When Causing trouble ends: say "Just at this inopportune moment, you hear a throat being cleared behind you. 'We can see you now within,' says a dry voice."; end the story saying "To be continued..."

Test me with "switch paneling / touch paneling / g / g / g".

Test more with "x dragon / x shiny / search head / g".

…and this scene might lead to another, and so on.

The purpose of an open-ended scene like this might be puzzly or narrative: we might be waiting for the player to get a puzzle solved, or we might be waiting for him to fulfil some plot condition that must be met before we can go on.

wi 10.2 Creating a scene
rb 4.2 Scripted Scenes

159. Bowler Hats and Baby Geese ★★★

Scenes can have properties -- a fact that is very useful when it comes to writing a series of scenes that all need to act alike in some respect.

Suppose we have a plot that features a number of scripted scenes, where we need the player to stand still and wait while the events of the scene play out. One way to set this up is to create a property for such scenes -- let's call them "restricted" -- and then write a rule that keeps the player in place while the scene happens:

"Bowler Hats and Baby Geese"

Section 1 - The Procedure

A scene can be restricted or free.

Instead of going somewhere during a restricted scene:

say "Better to stay here for the moment and find out what is going to happen next."

And now let's set up our restricted scene. In it, a clown is going to turn up wherever the player is (it doesn't matter where on the map he's gotten to at this point) and do a performance; the player will not be able to leave the area until the performance completes. We'll start with the setting:

Section 2 - The Stage and Props
 
The Broad Lawn is a room. "A sort of fun fair has been set up on this broad lawn, with the House as a backdrop: it's an attempt to give local children something to do during the bank holiday. In typical fashion, everyone is doing a very good job of ignoring the House itself, despite its swarthy roofline and dozens of blacked-out windows."
 
The House is scenery in the Broad Lawn. The description is "A cautious vagueness about the nature of the inhabitants is generally considered a good idea. They might be gods, or minor demons, or they might be aliens from space, or possibly they are embodiments of physical principles, or expressions of universal human experience, or... at any rate they can run time backward and forward so it warbles like an old cassette. And they're always about when somebody dies. Other than that, they're very good neighbors and no one has a word to say against."
 
Instead of entering the House:
   say "You can't go in, of course. It's not a house for people."
 
The Gazebo is north of the Broad Lawn. "The gazebo is sometimes used for bands, but at the moment has been appropriated for the distribution of lemonade."
 
The clown is a man. "A clown wearing [a list of things worn by the clown] stands nearby." The description is "He winks back at you."
 
The clown wears a purple polka-dot bowler hat. He carries a supply of baby geese. The description of the supply of baby geese is "Three or four. Or five. It's hard to count." Understand "goose" or "gosling" or "goslings" as the supply of baby geese.
 
There are some eggs. The description of the eggs is "A blur, really."
 
There is a Spanish omelet. The description of the Spanish omelet is "Exquisitely prepared."

…And now the scene itself:

Section 3 - The Scenes
 
The Clown Performance is a restricted scene. Clown Performance begins when the turn count is 3.
 
When Clown Performance begins:
   move the clown to the location.
 
Every turn during Clown Performance:
   repeat through the Table of Clowning:
      say "[event description entry][paragraph break]";
      blank out the whole row;
      stop.
 
When Clown Performance ends:
   now the eggs are nowhere;
   now the clown carries the omelet.
 
Clown Performance ends when the number of filled rows in the Table of Clowning is 0.
 
Table of Clowning

event description
"A clown with a purple polka-dot bowler hat strides into the vicinity and begins to juggle baby geese."
"While the clown juggles, the baby geese visibly grow older and larger. The clown becomes unnerved."
"In an attempt to resolve the problem, the clown reverses the direction of his juggling. The geese revert to goslings."
"The goslings become smaller and smaller until the clown is juggling goose eggs[replace eggs]."
"The clown throws all the eggs into the air at once and catches them in the bowler hat. He takes a bow; the audience applauds. As a final gesture, he upends his hat to release a perfectly cooked omelet."
 
To say replace eggs:
   now the supply of baby geese is nowhere;
   now the clown carries the eggs.
 
Free Time is a scene. Free Time begins when Clown Performance Ends.
 
Test me with "scenes / n / z/ z / look / x geese / s / x geese / x eggs / z / s".

wi 10.4 During scenes
rb 4.2 Scripted Scenes

160. Day One ★★★

"Day One"

Lecture is a scene. Lecture begins when play begins.

Every turn during Lecture:

repeat through Table of Lecture Events:

say "[event entry][paragraph break]";

blank out the whole row;

rule succeeds.

Here we use a table (see subsequent chapters) to keep track of all the events we wish to have occur during the course of the scene.

Table of Lecture Events

event
"'Welcome to Precolumbian Archaeology 101,' thunders Dr Freitag from the front of the class. 'Miss-- yes, you in the back. If you can't find a free seat, how are you going to find Atlantis? Sit down or leave. Now. Thank you.'"
"Freitag stands behinds his desk and lines up the pile of books there more neatly. 'It has come to my attention over previous years that there are two sorts of person who enroll in my class,' he says.

'Some of you will be members of the swim team or women's lacrosse players who have a distribution requirement to fulfill and are under the mistaken impression that archaeology must be easier than psychology. If that description applies to you, I advise you to drop the class now rather than at the midterm break. Under absolutely no circumstances will I ever sign a withdrawal form for someone who is crying at the time. Make a note of that, please.'"
"'The second sort of person,' Dr Freitag says, getting another wind. 'Yes, the second sort of person takes this class because she imagines that it is going to lead to adventure or possibly to new age encounters with dolphins.'

His eye moves over the class, lingering an especially long time on a girl in a patchwork skirt.

'You should also leave now, but since you are probably lying to yourself about the reasons you're here, you will probably not heed my warning and we will be doomed to a semester of one another's company nonetheless.'"
"'Whatever you may tell yourself, you are not here to gain a deeper understanding of the world or get in touch with yourself or experience another culture.'

He paces before the first row of desks, hammering on them one at a time. 'I know you probably wrote an admissions statement saying that that is what you hoped to do. Well, too bad. It is not inconceivable that some of you, somehow, will muddle towards a deeper understanding of something thanks to this class, but I am not holding my breath, and neither should you.'"
"Freitag takes a breath. 'No, my dear freshwomen, what you are here to do is learn facts. FACTS. Facts are unpopular in this university and, I am unhappily aware, at most of the institutions of inferior preparation from which you have come. Nonetheless, facts it will be. I will expect you to learn names. I will expect you to learn dates. I will expect you to study maps and I will expect you to produce evidence of exacting geographical knowledge on the exams. I will expect you to learn shapes of pottery and memorize masonry designs. There are no principles you can learn which are more important or more useful than a truly colossal bank of facts right there in your own head.'"
"'I do not ever want to hear that you do not need to learn things because you will be able to look them up. This is the greatest fallacy of your computer-semi-literate generation, that you can get anything out of Google if you need it. Not only is this demonstrably false, but it overlooks something phenomenally important: you only know to look for something if you already know it EXISTS. In short there is no way to fake knowledge, and I am not going to pretend there is.' He smiles in lupine fashion.

'This class is likely to be the most miserable experience of your four years in university. Clear?'"
"Everyone is silent."
"The lecture is interrupted by the shrill of a bell."

And then we define the scene so that it ends when the table runs out.

Lecture ends when the number of filled rows in the Table of Lecture Events is 0.

One advantage of this is that we can then edit the events in the scene by changing just the table; the scene will always run the right length and end on the turn when the last event occurs.

And to add a few additional details:

Instead of doing something other than waiting, looking, listening or examining during Lecture:
   say "Dr Freitag glares at you so fiercely that you are frozen into inaction."

Notice the careful phrasing of "doing something other than…" so that we do not mention the objects; if we had written "something other than listening to something…", the instead rule would match only action patterns which involved a noun. We state the rule more generally so that it will also match nounless commands such as JUMP and SING, since Freitag will probably take a dim view of those as well.

When Lecture ends:
   now Freitag is nowhere;
   say "There is a flurry of movement as your fellow students begin to put away their books. Dr Freitag makes his way to the door and is gone before anyone can ask him anything."
 
The Classroom is a room. Dr Freitag is a man in the Classroom. "Dr Freitag paces before the blackboard."
 
Test me with "listen / x dr / x me / jump / z / z / z / z / z / x dr".

wi 10.4 During scenes
rb 4.2 Scripted Scenes

🔗

RB §4.3 Event Scheduling

We can use a schedule of events to give some life to our environment: if we have a town setting, for instance, it makes sense for shops and libraries to open and close at set times; this is just what we find in IPA ★★.

Air Conditioning Is Standard ★★★★ has characters who follow a timed schedule of events to interact with each other, while the player mostly wanders around missing out on the action. (Sometimes life is like that.) The same effects could have been achieved with scenes instead of clock times, but there are occasions when we do want to plan our characters' behavior to the minute rather than waiting for the player to be in the right place to observe it: in a murder mystery or a time-travel story, the exact timings might be quite significant.

We may also want to add events to the schedule during play, as in

Instead of pushing the egg-timer: say "It begins to mark time."; the egg-timer clucks in four turns from now.
 
At the time when the egg-timer clucks: say "Cluck! Cluck! Cluck! says the egg-timer."

Similarly, we can schedule things during play to happen at a specific time of day, as shown in Hour of the Wren ★★★.

Examples

141. IPA ★★

Suppose we wanted a game set in a living town, with locations opening and closing at different times of day, and business carrying on as usual. The point might be to force the player to plan his itinerary carefully to hit the right spots at the right times; or we might be writing a more contemplative piece, where part of the enjoyment came from just watching the characters wander around doing their daily business…

"IPA"

When play begins: now the right hand status line is "[time of day]".

The time of day is 9:50 AM.

A shop is a kind of room. A shop has a time called the opening hour. The opening hour of the shop is usually 8 AM. A shop has a time called the closing hour. A shop usually has closing hour 6 PM.

Check going to a shop (called the target):

if the time of day is before the opening hour of the target,

say "[The target] is locked up until [the opening hour of the target]." instead.

Check going to a shop (called the target):

if the time of day is after the closing hour of the target,

say "[The target] has been closed since [the closing hour of the target]." instead.

Every turn when the location is a shop:

let deadline be the closing hour of the location;

if the deadline is before the time of day:

let target be a random adjacent room which is not a shop;

say "You are gently but firmly ushered out, since [the location] is closing.";

move the player to the target.

The Strip-mall Parking Lot is a room. "Dead Christmas trees are heaped outside the bagel shop. Strips of dirty ice survive along the curb, and in the shadows of the lamp-posts. A wet, almost illegible sheet of algebra homework is plastered to the asphalt.

Pinewood Brewing Supply is at the east end of the lot."

Pinewood Brewing Supply is a shop. It is east of Parking Lot. The opening hour of Pinewood Brewing Supply is 10:00 AM. The closing hour of Pinewood Brewing Supply is 3:30 PM. "Shelves and shelves of malt and hops; large glass carboys, and plastic tubing; empty bottles; bottle-caps; bottle-labeling kits; starters for vinegar, sourdough, root beer.

A sweet malty smell hangs in the air."

Instead of going to Brewing Supply when the time of day is before the opening hour of Brewing Supply for the second time:

say "You rattle at the door again. 'Hold your horses, for crying out loud,' yells a voice from within."

Noah's Bagels is a shop. It is north of the Parking Lot. The opening hour of Noah's Bagels is 6:00 AM. The closing hour of Noah's Bagels is 11:00 AM. "The selection has been somewhat picked over, leaving you with your choice of Pumpernickel, Asiago, or Everything."

Test me with "e / e / n / z / s / e / z / e / z / z / e".

wi 9.6 The time of day
rb 4.3 Event Scheduling

146. Hour of the Wren ★★★

Here we allow the player to set the time at which some future event is going to happen, rather than letting the game decide. We'll need to borrow the syntax for defining new actions from a later chapter:

"Hour of the Wren"

When play begins:

say "You more or less stumble across them in Central Park: a disparate group of people, all of different ages, sitting in a circle. They aren't talking to one another -- in fact, they seem to be trying very hard to ignore one another, like people in the waiting room of an especially embarrassing kind of doctor. You are about to go around when a woman in a grey pressed suit comes up to you. Her suit-skirt is trimmed in lavender cord, and she looks as though she might have been extremely sharp-dressed in 1944. She hands you a card."

The Circle in the Grass is a room. "No one is looking at you, except for the secretary, if that is what she is."

The player carries a card. The description of the card is "Typed: 'Active astrology - dislike your fortunes? change your stars! - make an appointment now - hour of the wren STILL AVAILABLE.'".

The time of day is 1:55 PM.

Understand "pick [time]" or "choose [time]" or "make appointment for [time]" or "make an appointment for [time]" as making an appointment for. Making an appointment for is an action applying to one time.

Carry out making an appointment for:

say "Fate cannot be commanded more than once."

Instead of making an appointment for the time understood for the first time:

say "You settle on [the time understood] for your appointment. The woman makes a note of it in an appointment book, which she carries in a brown paper bag. 'Excellent choice, ma'am,' she says in a low, urgent voice. 'You'll be very satisfied.'";

stars shift at the time understood.

Understand "hour of the wren" as 2:00 PM.

At the time when stars shift:

end the story saying "insert cataclysm here".

Test me with "x card / make appointment for hour of the wren / z / z / z / z".

wi 9.11 Future events
rb 4.3 Event Scheduling

354. Air Conditioning is Standard ★★★★

"Air Conditioning is Standard"

Section 1 - The Garage

A person has some text called current occupation. The current occupation of a person is usually "None".

Mood is a kind of value. The moods are bemused, bored, attentive, rapt, and blushing. A person has a mood. A person is usually attentive.

Instead of examining a person:

now every thing is unmentioned;

carry out the writing a paragraph about activity with the noun.

Rule for writing a paragraph about a person (called X):

let the subsequent mention be "Name";

if the current occupation of X is not "None":

say "[current occupation of X]. ";

let the subsequent mention be "He";

if X is female, let the subsequent mention be "She";

if X wears something unmentioned:

if the subsequent mention is "Name", say "[The X] ";

otherwise say "[subsequent mention] ";

say "is wearing [a list of unmentioned things worn by X]";

if X carries something unmentioned, say " and carrying [a list of unmentioned things carried by X]";

say ".";

otherwise:

if X carries something unmentioned:

if the subsequent mention is "Name", say "[The X] ";

otherwise say "[subsequent mention] ";

say " is carrying [a list of unmentioned things carried by X]."

The Garage is a room. "Above the street door is a spectacular art nouveau fanlight, wherein a stained-glass Spirit of Progress bestows the gift of Transportation on mankind.

The sun, gleaming through the hair of Progress, throws amber curls on the macadam floor."

The fanlight is scenery in the Garage. The description is "A semi-circle of stained glass as wide as the garage door, designed by Louis Comfort Tiffany himself. No expense has been spared."

The gift of Transportation is part of the fanlight. The description is "The gift of Transportation is envisioned as a cornucopia disgorging a steam locomotive. And that blue bit of glass might be the Montgolfier balloon."

The Spirit of Progress is part of the fanlight. The description is "It is part of her character to have bare shoulders like that."

The machinist is a bored man. He is in the Garage. He is wearing a grimy pair of overalls. He carries a wrench and a screwdriver. The current occupation of the machinist is "[The machinist] is making some adjustments to [the random thing which is part of the Victorian Car] with his [random thing carried by the machinist]"

The Victorian Car is a device in the Garage. A cast-iron steering wheel, a leather bucket seat, a horn, and a combustion engine are part of the Victorian Car. The seat is an enterable supporter.

Rule for writing a paragraph about a device (called X):

let the subsequent mention be "Name";

if the X is unmentioned:

say "[The X] is here. ";

let the subsequent mention be "It";

if something is part of X:

if the subsequent mention is "Name", say "[The X] ";

otherwise say "[subsequent mention] ";

say "[if a mentioned thing is part of X]also [end if]features[if a mentioned thing is part of X], in addition to [the list of mentioned things which are part of X],[end if] [a list of unmentioned things which are part of X]";

say ".".

Rule for printing the name of the steering wheel while writing a paragraph about a person:

say "steering wheel".

A supporter has some text called position. The position of a supporter is usually "None".

The Office is west of the Garage. The Office contains a desk. The desk has the position "A [desk] with several dozen drawers stands in the center of the room". On the desk are some papers.

After printing the name of a supporter (called X) which supports an unmentioned thing:

now X is unmentioned.

Rule for writing a paragraph about a supporter (called X):

let the subsequent mention be "Name";

if the position of X is not "None":

say "[position of X]. ";

let the subsequent mention be "It";

if a mentioned thing is on X:

say "Besides [the list of mentioned things which are on X], ";

let the subsequent mention be "it";

if the subsequent mention is "Name", say "[The X] ";

otherwise say "[subsequent mention] ";

say "holds [a list of unmentioned things which are on X]."

Section 2 - Schedule

The time of day is 4:38 PM.

At 4:42 PM:

move the machinist to the Office;

say "The machinist wanders into the Office to get some paperwork.";

now every thing carried by the machinist is on the desk;

now the current occupation of the machinist is "[The machinist] rifles through [the papers] on [the desk]".

At 4:43 PM:

move the young lady to the Garage;

if the young lady can be seen by the player,

say "An attractive young lady walks in from the street, and glances around as though she has never been here before."

At 4:45 PM:

if the young lady can be seen by the player,

say "With a not-quite-convincing air of innocence, [the young lady] happens to lean upon [the horn], which bleats loudly.";

otherwise say "There is a honk from the Garage[if the machinist can be seen by the player]. The machinist looks up with a frown[end if].";

now the horn is mentioned.

At 4:46 PM:

move the machinist to the Garage;

say "The machinist strolls from the Office into the Garage to find out what is going on.";

now the current occupation of the machinist is "[The machinist] is chatting with [the young lady]. He seems to be demonstrating the various features of [the car], including [the random thing which is part of the car]";

now the current occupation of the young lady is "[The young lady] is asking [the machinist] a number of questions about [the car]".

At 4:49 PM:

if the young lady can be seen by the player, say "[The machinist] gives [the young lady] his arm to climb into [the seat].";

move the young lady to the seat;

now the young lady is rapt;

now the current occupation of the young lady is "[The young lady] is turning [the steering wheel] from side to side";

now the current occupation of the machinist is "[The machinist] is leaning on the door of [the car], pointing out features to [the young lady]";

move the besotted expression to the machinist;

now the machinist is wearing the besotted expression.

At 4:52 PM:

now the sober grey gown is unbuttoned at the neck;

if the young lady can be seen by the player, say "[The young lady] murmurs something about the wilting heat, and undoes a button or two of her gown. The machinist's expression is comical, or would be, if you weren't annoyed."

Every turn when the player is in the Garage and young lady is on the seat:

say "You are beginning to feel a little unnecessary in this scene."

Every turn when the player is in the Office and the young lady is on the seat:

say "There's no sound at all from the other room, not even conversation."

Before going to the Garage when the young lady is on the seat:

now the sober grey gown is tellingly dishevelled;

move the young lady to the Garage;

now the young lady is blushing;

say "There is a flurry of movement as you enter the room.";

now the current occupation of the young lady is "[The young lady] stands near the door, tapping her foot nervously";

now the besotted expression is nowhere;

now the current occupation of the machinist is "[The machinist] is leaning against [the car], looking smug".

Section 3 - Initially Out of Play

The besotted expression is a wearable thing. The description is "It looks foolish, doesn't it?"

The young lady is a bemused woman. She is wearing a sober grey gown and a pair of black boots. The current occupation of the young lady is "[The young lady] is running a gloved finger along the chassis of [the victorian car]"

Before printing the name of the young lady while writing a paragraph about a person:

say "[mood of the young lady] "

The description of the grey gown is "Something about the perfect row of tiny buttons has the wrong effect -- at any rate, it is natural to wonder how long they take to undo." The gown can be buttoned almost to the chin, unbuttoned at the neck, or tellingly dishevelled.

Rule for printing the name of the gown when writing a paragraph about a person:

say "sober grey gown ([sober grey gown condition])"

Test me with "z / look / look / z / look / west / east / z / look / z / look / z / look / west / east".

wi 18.24 Writing a paragraph about
rb 4.3 Event Scheduling

🔗

RB §4.4 Scene Changes

In a plot that takes place over multiple locations or has several distinct scenes, we may want to move the player or change the scenery around him. Age of Steam ★ brings a train on and off-stage as the plot requires. Meteoric ★★ similarly brings a meteor into view at a certain time of day, showing off several implementations depending on whether or not the player is supposed to be able to refer to the meteor after it has gone.

Entrevaux ★★★ constructs an organized system such that all scenes have their own lists of props and associated locations, and props are moved on and off automatically. Scene changes are also announced with a pause and a new title, such as "Chapter 2: Abduction".

Space Patrol - Stranded on Jupiter ★★ inserts an interlude in which the player's possessions and clothes are switched for new ones and the player moved to a new location - and then put back where he started from.

Examples

156. Age of Steam ★

The following source is very short and simple, yet it already feels surprisingly interesting in play, because something is going on which the player does not control but must observe. The single scene both starts and finishes.

"Age of Steam"

The Station is a room. "Eynforme Halt is a raised platform fringed with cowslip: a whistle-stop with no more than a signal and a water-tank."

The Flying Scotsman is fixed in place. "The Flying Scotsman, fastest train in the world, is now at a dead standstill."

Train Stop is a scene. Train Stop begins when the player is in the Station for the third turn. Train Stop ends when the time since Train Stop began is 3 minutes.

When Train Stop begins:

now the Flying Scotsman is in the Station;

say "The Flying Scotsman pulls up at the platform, to a billow of steam and hammering."

When Train Stop ends:

now the Flying Scotsman is nowhere;

say "The Flying Scotsman inches away, with a squeal of released brakes, gathering speed invincibly until it disappears around the hill. All is abruptly still once more."

Instead of entering the Flying Scotsman, say "Alas, the [time when Train Stop began] arrival is only to take on water, not to set down or pick up."

Test me with "z / z / z / enter flying scotsman / z / z".

wi 10.3 Using the Scene index
rb 4.4 Scene Changes

119. Meteoric I and II ★★

The game below begins at half past eleven, and one turn later, it's meteor time:

"Meteoric I"

The time of day is 11:30 PM.

At 11:31 PM:

now the meteor is in the great outdoors;

say "A meteor streaks across the sky.".

The great outdoors is a region. The Spanish Balcony is east of the Inner Court. The Court and Balcony are in the great outdoors. Inside from the Court is the Swimming Pool.

The meteor is a backdrop. Instead of doing something to the meteor, say "The meteor is no longer visible, now nothing more than a memory."

Test me with "wait / wait / examine meteor / west / examine meteor / in / examine meteor".

Or for something a little slower-moving and with no after-image:

"Meteoric II"

The time of day is 4:30 PM.

At 4:31 PM:

now Phobos is in the great outdoors;

say "Phobos rises from the western horizon."

At 10:06 PM:

now Phobos is nowhere;

say "Phobos sets over the eastern horizon."

The great outdoors is a region. The Martian Balcony is east of the Inner Court. The Court and Balcony are in the great outdoors. Inside from the Court is the Heavy Water Swimming Pool.

Phobos is a backdrop. Instead of doing something to Phobos, say "Phobos orbits a mere 6000km above you, which is practically touching range for astronomy. On the other hand, astronomy isn't all that practical."

Test me with "wait / wait / examine phobos / west / examine phobos / in / examine phobos".

Though we should not really use Earthly time-keeping, since the Martian day is about half an hour longer than ours.

wi 8.7 Moving things
rb 4.4 Scene Changes

158. Space Patrol - Stranded on Jupiter! ★★

American radio adventure series of the 1950s were unobtrusively sponsored by breakfast cereals, as the following modest example demonstrates. Note that the scene-changing for the commercial break needs to know nothing about the actual programme it breaks into: if Part I were replaced with a different Space Patrol episode, Part II need not be changed at all.

"Space Patrol #57 - 1953-10-31 - Stranded on Jupiter!"

Use scoring.

Part I - Serial

Red Spot is a room. "You are in the middle of a vast red oval plain. Overhead, the thick Jovian clouds swirl menacingly, and a fine acrid dust falls instead of rain." Some acrid dust is scenery in the Red Spot. The description of the dust is "The rust-colored dust coats every surface. You've no idea how deep it goes."

Instead of going in Red Spot, say "As you once told Cadet Lucky, Jupiter's a mighty big planet, maybe bigger than Iowa. Why, the Red Spot alone stretches out almost to the horizon."

The player wears a silver uniform and rubber boots. The player carries a shovel and an Analscope. The description of the Analscope is "As you recall from Space Patrol #9 - 1952-11-29 - The Electronic Burglar, the Analscope is a device for locating buried metals. That's what guided you all the way from the orbit of Uranus. (Oh, all right, Neptune.) If only you hadn't crashed!"

The metal plate is a fixed in place container. It is openable and closed. In the metal plate is some water. The description of the metal plate is "Stamped with the distinctive logo of the previous mission."

Instead of examining the player, say "Your hair clumps together stickily, thanks to the dustfall."

Digging is an action applying to one thing. Understand "dig [something]" or "dig in [something]" as digging.

Instead of digging the dust, try looking under the dust. Instead of looking under the dust when the metal plate is not visible: move the metal plate to the location; say "You brush aside the dust underfoot and -- what were the odds? -- it turns out that you landed just where the previous landing party did, thirteen ill-fated years ago. Here is the metal plate that covers their original well.

But wait! Called by the clanging of your shovel on the plate, a band of Jovian pterodactyls swoop down to attack! You're totally defenceless! You don't have a hope! You're absolutely finished!"; increase the score by 10; move K-Klak to Red Spot.

K-Klak the Pterodactyl is an animal. "K-Klak, leader of the Jupiter Pterodactyls, menaces you. A terrifying creature of scaly wings, with a dragon's tail, K-Klak stands... about 1/8th of an inch tall." Instead of doing something to K-Klak, say "K-Klak makes a frankly panicky noise and leaps backwards, out of your way."

After opening the metal plate: increase the score by 10; say "You have found water! You're saved! K-Klak makes a (very cautiously) pleased noise. Now to find the stolen Brainograph, and track down the crook with the thick Jewish accent and his henchmen with their thick Polish accents..."; end the story finally.

The maximum score is 20.

Part II - Cereal

When play begins, say "Instant Ralstons and Regular Ralstons, the hot whole-wheat cereals in the red and white checkerboard packages present... SPACE PATROL... High adventure in the wild vast reaches of space... Missions of daring in the name of interplanetary justice... Travel into the future as Buzz Corey, Commander-in-Chief of the..."

Last score is a number that varies. Every turn: now the last score is the score.

Ralstons Ad is a scene. Ralstons Ad begins when score is not the last score. Ralstons Ad ends when the Ricechex is consumed.

Include Basic Screen Effects by Emily Short.

When Ralstons Ad begins:

center "*** We'll be back in just a moment! ***";

pause the game;

strip the player;

move the player to the Kitchen.

When Ralstons Ad ends:

center "*** And now, back to today's exciting adventure ***";

pause the game;

restore the player.

Saved location is a room that varies. Locker is a container. Wardrobe is a container.

To strip the player:

now every thing carried by the player is in the locker;

now every thing worn by the player is in the wardrobe;

now saved location is location.

To restore the player:

now every thing carried by the player is in the Kitchen;

now every thing in the locker is carried by the player;

now every thing in the wardrobe is worn by the player;

move the player to saved location.

The Space Patrol Kitchen is a room. "The nerve center of the Space Patrol! This is where cadets fill up with their SUPER-FUEL. North leads to the astro control room, while back south is the cargo hold." A breakfast bowl is in the Kitchen. In the bowl is Ricechex. Ricechex is edible. The Ricechex can be consumed or uneaten. The Ricechex is uneaten.

Instead of going north in Kitchen: say "[refusal to leave]". Instead of going south in Kitchen: say "[refusal to leave]".

Instead of examining the player when Ralstons Ad is happening: say "You are currently being played by a generically attractive person of about 30, with very good teeth and well-kept nails."

After eating the Ricechex: say "That's right folks, always start your day the SPACE PATROL way with a tasty bowl of Ricechex, Wheatchex or good hot Ralstons. Mmmm Mmmm. You just can't get enough of the sugary goodness in Ricechex, Wheatchex and good hot Ralstons."; now the ricechex is consumed.

Instead of tasting the Ricechex:

say "Wow! *wolf-whistle* Man oh man oh man! Yumm-y!"

To say refusal to leave:

repeat through Table of Refusals:

say "[nope entry][paragraph break]";

blank out the whole row;

rule succeeds;

say "You can't. Eat your Ricechex."

Table of Refusals

nope

"You can't go that way in the limited universe of this sponsored message."

"Or that way."

"You've already tried that!"

"Why would you want to walk away when you have an alluring bowl of Ricechex right here?"

Test me with "n / i / x me / x dust / dig dust".

Test ad with "n / s / n / s / n / i / x me / get bowl / taste ricechex / eat ricechex".

Test ending with "x plate / x k-klak / open plate".

Episode 57 of "Space Patrol" was actually called "Iron Eaters Of Planet X", just in case the reader feels that any of the foregoing unfairly traduces a work of thoughtful science fiction.

wi 10.4 During scenes
rb 4.4 Scene Changes

163. Entrevaux ★★★

For some games, it makes sense to organize the entire game around scenes rather than around locations, moving the player when a new scene begins and laying out new props.

To this end, we might extend Inform's default handling of scenes so that each scene has properties to indicate prop lists and locations, and move objects in and out of play automatically as the scenes change. For instance:

"Entrevaux"

Part 1 - Procedure

A scene has a room called the starting location.

A scene has a list of objects called the scenery props.

A scene has a list of objects called the inventory props.

The starting location is the room to which the player should be moved; scenery props are things that need to be put there when the scene begins; inventory props, things that are given to the player when the scene begins; and the description some printed text to introduce the new scene. We may still occasionally need to have recourse to special "When the Dancing-Lesson begins…" rules for individual scenes, but for the most part this allows us to set scenes up in a consistent and predictable way.

Another point that might be slightly less obvious: sometimes we want to announce a change of location to the player when the scene starts, and sometimes we don't. In particular any scene that starts "when play begins" should probably not explicitly describe the entered room, since that would duplicate the description automatically produced on the first turn of play. So we add a property to track whether any given scene should be announcing its location:

A scene can be location-silent or location-loud.

And let's say that we also want to announce each new scene as another "chapter" of the game in play, with a pause before the scene begins.

Here we include "Basic Screen Effects" because it will allow us to pause the game for a keypress, then clear the screen before each new chapter:

Include Basic Screen Effects by Emily Short.
 
The chapter counter is a number that varies.
 
First when a scene (called the current scene) which is not the Entire Game begins:
   if chapter counter is greater than 0:
      pause the game;
   increment chapter counter;
   say "[bold type]Chapter [chapter counter]: [current scene][roman type]";
 
Last when a scene (called the current scene) which is not the Entire Game begins:
   repeat with item running through the scenery props of the current scene:
      move the item to the starting location of the current scene;
   repeat with item running through the inventory props of the current scene:
      move the item to the player;
   if the location is not the starting location of the current scene:
      if the current scene is location-loud:
         move the player to the starting location of the current scene;
      otherwise:
         move the player to the starting location of the current scene, without printing a room description.

At the end of each scene, we strike the set and remove all the loose objects from play.

When a scene (called the current scene) ends:
   repeat with item running through things which are not fixed in place:
      if the item is not the player:
         now the item is nowhere.
 
Part 2 - Scenario
 
Entrevaux Station is a room. "The station building consists of a waiting room and a ticket-selling office so small that only one person can buy a ticket at a time. On the outside wall is a clock that runs twelve minutes late; but since the trains also run twelve minutes, give or take, behind their published schedule, this clock is helpful in establishing reasonable expectations. [paragraph break]Painted on the door is the logo of the Chemin de Fer de Provence, the only railway in France that is not part of the SNCF."
 
The Hillside Tower is a room. "It's very dark in here, lacking artificial lighting, but from the rough rectangular window you can see a slice of hillside and a little of the river Var."
 
The window is scenery in the Hillside Tower. The description is "Through it can be seen a slice of wooded hillside and exposed grey-brown cliff. You are in the southern French foothills of the Alps, and the territory is dry. The only respite is the river Var, a milky blue at this time of year, running shallowly over mud and large stones far below your window." Understand "view" or "slice of hillside" or "hillside" or "hill" or "river" or "var" or "mud" or "stones" or "large stones" as the window.
 
A used ticket is a thing. The description is "A piece of receipt paper indicating that you have paid the one-way fare of 9 euros from Nice. There is a hole punched through it."
 
A one-euro coin is a thing. The description is "It's a bimetal coin, brassy around the rim and silvery in the center. One side shows western Europe, with unusual prominence given to the UK, and the other side Leonardo da Vinci's four-armed, four-legged man having a nice stretch. It's dated 2002."
 
Some re-enactors are a person. "Milling about one end of the station is a crowd of medieval re-enactors." The description is "They're dressed in a somewhat aimless range of styles roughly honoring the period of 900-1500 AD. One gentleman is wearing a knobby leather cap; which is a good thing, because there is a rooster standing on his head." Understand "men" or "man" or "gentleman" or "rooster" or "reenactors" or "crowd" or "medieval" or "woman" or "women" as the re-enactors.
 
A kidnapper is a person. "Your kidnapper is watching you from the corner with his arms folded. You have the impression he's just marking time until someone more important arrives." The description is "He does not look at all like the kidnapping sort, but more like a sommelier at a superior restaurant: he wears a black pinstriped suit and has nicely-manicured hands."
 
The trolley is an enterable fixed in place container. "The 'train' on which you arrived is really just a single car, more like a trolley than a proper train." Understand "car" or "train" as the trolley. The description is "It has a glass front, so you can see ahead while riding: an innovation among trains."
 
Arrival is a location-silent scene. "After many days['] journey, you have arrived at last in Entrevaux, a walled medieval town now chiefly of interest to tourists and crusade re-enactors."
   The starting location of Arrival is the Entrevaux Station.
   The scenery props of Arrival are { re-enactors, trolley }.
   The inventory props of Arrival are { the used ticket, one-euro coin }.
 
Arrival begins when play begins. Arrival ends when the time since Arrival began is 2 minutes.
 
Abduction is a location-loud scene. "You check into the Hotel Vauban and sleep deeply enough; it was a long and sticky trip to get here.
 
Then in the middle of the night something confusing happens. You have the impression of strangers in your room, and then a searing pain, and you don't come back to yourself until midmorning of the following day..."
   The starting location of Abduction is the Hillside Tower.
   The scenery props of Abduction are { kidnapper }.
 
Abduction begins when Arrival ends.
 
Test me with "i / x re-enactors / z / z / i / x him".

wi 10.6 More general linkages
rb 4.4 Scene Changes

🔗

RB §4.5 Flashbacks

The viewpoint character may often need to remember events long past. The easiest way to do this is with a cut-scene, in which at some relevant point we pause the story and print a long passage of text describing the memory. Because large amounts of text can be hard for the player to take in, we may want to include some pauses in the presentation of this material; this facility is provided by the Basic Screen Effects extension by Emily Short, and might work something like this:

Include Basic Screen Effects by Emily Short.
 
Instead of examining the photograph for the first time:
   say "This reminds you of the summer of '69...";
   wait for any key;
   say "... flashback content...";
   wait for any key.

The "pause the game" phrase in the same extension offers a more dramatic pause that also clears the screen before printing new text.

Cut-scenes are easy to implement but should be used sparingly, since players often get impatient with long uninteractive passages. A slightly more deluxe implementation might insert an interactive scene that simply happens to be set in the past, before going on with another scene set "now"; and, indeed, some IF abandons the idea of "now" entirely, presenting pieces in a non-chronological order and letting the player work out how the sequence works together.

The most challenging case to implement (though still not very hard) is the one where we remove the player from one scenario, let him play through a flashback with past possessions and clothing, and then restore him to the same situation he left, with all of the same possessions and clothing. Pine 3 ★★★ shows how to do this: the code to change the player's status is isolated at the end of the example, and might fruitfully be reused. Pine 4 ★★★ expands on the same idea by adding another flashback scene, demonstrating one that can be visited repeatedly and one that can be seen only once.

Examples

165. Pine 3 ★★★

"Pine"

Part 1 - The Set-up

This is mostly a repeat of what we have already seen, but for the sake of producing a playable scenario, we include it. The new material appears at Part 2.

A person can be asleep or awake. A person can be active or passive.
 
The Spinning Tower is a room. "A remote corner of the old castle, reserved for spinning and weaving tasks."
 
Sleeping Beauty is an asleep woman in the Spinning Tower. "[if asleep]Sleeping Beauty lies here, oblivious to your presence[otherwise]Sleeping Beauty stands beside you, looking [attitude][end if]." The description is "She is even more magnificent than the rumors suggested." Understand "woman" or "girl" or "princess" or "lady" as Sleeping Beauty.
 
Discovery is a scene. Discovery begins when play begins. Discovery ends when Sleeping Beauty is awake. Marriage Proposal is a scene. Marriage Proposal begins when Discovery ends.
 
When Discovery ends: say "Throughout the palace you can hear the other sounds of stirring and movement as the spell of centuries is broken."; now Beauty is passive.
 
Instead of waking an awake person: say "Redundant."
 
Instead of waking an asleep person: say "Yes, but how?"
 
Instead of attacking an asleep person:
now the noun is awake;
   say "[The noun] sits bolt upright. 'Hey! Ow!' So much for that true love's kiss nonsense."
 
Instead of kissing an asleep person:
   now the noun is awake;
   say "[The noun] slowly stirs to wakefulness!"
 
Instead of throwing water at an asleep person:
   now the second noun is awake;
   now the noun is nowhere;
   say "You pour out [the noun] on [the second noun].
 
[The second noun] wakes, shuddering. 'Agh! I had a terrible dream about drowning and then-- Hey!'"
 
The player carries a jug of water. Understand "pour [something] on [something]" or "splash [something] at/on [something]" as throwing it at.
 
Table of Conversation

topicreplyquip
"dream/dreams/nightmare/nightmares/sleep""'Sleep well?' you ask solicitously.

'Not really,' she replies, edging away from you. So much for that angle.""'Ghastly nightmares,' she remarks. You nod politely."
"marriage/love/wedding/boyfriend/beau/lover""'So,' you say. 'This is a little weird since we just met, but, um. Would you like to get married?'

She looks at you nervously. 'Do I have to?'""'I, er,' she says. 'I hope I'm not supposed to marry you or something.'"
"marriage/love/wedding/boyfriend/beau/lover""'I was told I was going to marry you and inherit the kingdom,' you say, apologetically. 'Would that be very bad?' This could be awkward, considering your family circumstances -- you did promise your mother that everything would be better, after this --

'Oh, it's not you -- I'm seeing someone,' she says, smiling quickly.

You try to think how to point out that it's been a hundred years since she last saw her boyfriend.""'Do you think I could go look for someone? I'm seeing him, you see, and I think I've been... sick... for a while, so he might be worried.'

You try to think how to point out that it's been a hundred years since she last saw her boyfriend. And try not to think how awkward things would be in your family if she refuses to marry you."
"marriage/love/wedding/boyfriend/beau/lover""'You've been up here for a hundred years,' you say. An unpleasant thought occurs to you. 'Was your young man in the castle somewhere?'

She shakes her head mutely.""She goes to the window and looks out at the now-fading thicket of briar. 'That took a while to grow,' she observes. 'I've been up here longer than I thought.'

You shrug, uncomfortable."
 
Instead of asking an awake beauty about a topic listed in the Table of Conversation:
   now Beauty is passive;
   say "[reply entry][paragraph break]";
   blank out the whole row.
 
Instead of telling an awake beauty about something: try asking the noun about it.
 
Instead of asking an asleep person about something:
   say "[The noun] snores."
 
Marriage Proposal ends when the number of filled rows in the Table of Conversation is 0.
 
Every turn during Marriage Proposal:
   if Beauty is active and Beauty is visible:
      repeat through Table of Conversation:
         say "[quip entry][paragraph break]";
         blank out the whole row;
         make no decision.
 
Every turn: now Beauty is active.
 
When Marriage Proposal ends: end the story saying "This is going to take some explaining."

So far we haven't much of a chance to affect matters and make them better. Suppose we'd like to add an element to the conversation where we're allowed to tell Beauty about past events -- and explore them a bit; and if the first retelling doesn't go quite as planned, we're allowed to revisit these scenes to hit them with a bit more emphasis.

Part 2 - Flashbacks
 
Instead of asking an awake beauty about a topic listed in the Table of Flashback Material:
   now Beauty is passive;
   say "[reply entry][paragraph break]".
 
A fact is a kind of thing. The family circumstances is a fact. A fact can be known or unknown. A fact can be current or past.

Once known, a fact remains known permanently -- this could be useful if we wanted to make some rules about how Beauty acts when she knows different information. By contrast, a fact is only "current" if it is the last thing discussed. Since a player can mention a fact over and over, he can make it "current" again and again, and thus reactivate the flashback.

Table of Flashback Material

topicreply
"poor/poverty/family/money/mother/circumstances" or "family circumstances" or "my family/mother""[if family circumstances is unknown]'I wish you'd give some thought to marrying me. You see,' you say, your jaw tensing. 'I wouldn't ask if it weren't for my [family circumstances]...'[otherwise]'I don't think you fully understand the [family circumstances],' you say.[end if]"
 
After printing the name of a fact (called target): now the target is current; now the target is known.

This "After printing the name…" rule will be explained later in the chapter on activities; for now, it is enough to know that whenever family circumstances is mentioned in the table of flashback material, this rule will automatically be called. Now the terms under which the flashback happens:

Poverty flashback is a recurring scene. Poverty flashback begins when family circumstances is current. When poverty flashback begins: strip the player; move the player to the Woodcutter's Shack.

Note the "recurring" here: we want the player to be able to revisit this scene as needed.

The Woodcutter's Shack is a room. "Your family lives in a shack in the forest. There are holes in the roof, and in the winter the snow comes in -- rain, too, for that matter. The walls aren't very well-boarded, and don't keep out the wind, and even though you live in the middle of dense woods, you can never gather enough fuel to keep this place fully heated. And then there's the stench. Pigs wander freely in and out, and your three youngest brothers play on the floor."
 
Pigs are an animal in the shack. The pigs are scenery. The description is "They really are very grubby, dirty animals, but what's worse than that, the value of pigs has declined a lot over the last few decades. This is hard to explain to someone who has been out of touch with the world for a while, but keeping pigs for meat is a dubious prospect when there's less and less for them to forage on." Instead of smelling the pigs: say "They smell the way animals do, when they live among their own refuse."; increase the pity of Beauty by 2.
 
The brothers are a man. The description of brothers is "Hans, Franz, and Lukas. Twins and then the baby. So young, and growing up fatherless; and soon to be orphaned entirely, if your mother's health does not improve." Understand "brother" or "twin" or "twins" or "baby" or "franz" or "hans" or "lukas" as the brothers.
 
The untidy bed is scenery in the Shack. Mother is a woman on the untidy bed. The description of mother is "She is wasting away of a slow disease, her skin stretched tautly over bone. She hasn't been the same since your father left." On the bed is a folded letter.
 
The description of the letter is "Many times read over and creased, the letter explains how your father has gone away with a wealthy countess and will not return. Your mother was not able to read it herself, of course, and had to have it explained to her by the parish priest. Now she keeps it by the bed and crumples it in her fits of delirium."
 
Instead of kissing or touching Mother for the first time:
   say "You place a gentle kiss on her feverish brow. She looks up at you, her oldest -- yes, never mind that bit -- with a look of sincere trust and admiration.
 
'You'll find a way through this for us,' she says, squeezing your fingers. 'I know you will.'"; increase the pity of Beauty by 3.
 
Instead of kissing Mother: say "You have no more heart-rending memories of affection to recount; that one incident will have to serve, for rhetorical purposes."
 
Instead of waiting in the Shack: say "The wind blows sharply through the walls."
 
Instead of attacking someone in the Shack:
   say "Though sometimes the conditions of your life make you grouchy and impatient, you would never dream of striking a member of your own family. But from time to time you do feel the temptation."
 
Beauty has a number called pity. After examining something in the Woodcutter's Shack, increment the pity of Beauty. After examining mother, increase the pity of Beauty by 2. After examining the letter, increase the pity of Beauty by 3.
 
Poverty flashback ends when waiting or the time since poverty flashback began is five minutes.
 
When Poverty flashback ends:
   now family circumstances is past;
   say "...you finish describing the miserable circumstances of your home life, and allow your attention to return to the present.";
   restore the player;
   now Beauty is passive;
   if Beauty is sympathetic, say "'Oh dear!' she says. 'What a dreadful life!' She wrings her hands. 'No wonder you are eager to improve your lot...! But --' Her brow clears, a new thought occurring. 'You needn't marry me, you know! We could arrange it differently! I am certain that my father would give you a large reward, instead, and then I would not be separated from my current boyfriend!'";
   otherwise say "She makes a disgusted face, but she doesn't seem nearly so heart-wrung as you had hoped to make her. Tough audience, these modern princesses."
 
Definition: Beauty is sympathetic if the pity of Beauty is greater than 4.
 
To say attitude:
   if Beauty is sympathetic, say "distressed on your behalf";
   otherwise say "a little confused".

And the following is the same as in the Space Patrol example as well: we need a systematic way to remove the player's possessions, then put everything back when the flashback is over:

Saved location is a room that varies. Locker is a container. Wardrobe is a container.
 
To strip the player:
   now every thing carried by the player is in the locker;
   now every thing worn by the player is in the wardrobe;
   now saved location is location.
 
To restore the player:
   now every thing carried by the player is in the location;
   now every thing in the locker is carried by the player;
   now every thing in the wardrobe is worn by the player;
   move the player to saved location.
 
Test me with "x beauty / wake beauty / pour water on beauty / ask beauty about sleep / tell beauty about poverty / smell pigs / x mother / x letter / kiss mother / ask beauty about marriage / z / z".

Because we haven't changed the endings of the "Marriage Proposal" scene, there is still only one way for this scenario to work out; but at least now the player has the opportunity to alter Beauty's attitude a bit (or not) before the game is done.

wi 10.7 Multiple beginnings and repeats
rb 4.5 Flashbacks

167. Pine 4 ★★★

Suppose in addition to our pathetic little family history, we have another secret to convey to the Princess, this one a little more peculiar. She either gets it or she doesn't; once she gets it, we do not revisit that flashback, though it is still possible to keep visiting the poverty flashback.

"Pine"

Part 1 - The Set-up

A person can be asleep or awake. A person can be active or passive.

The Spinning Tower is a room. "A remote corner of the old castle, reserved for spinning and weaving tasks."

Sleeping Beauty is an asleep woman in the Spinning Tower. "[if asleep]Sleeping Beauty lies here, oblivious to your presence[otherwise]Sleeping Beauty stands beside you, looking [attitude][end if]." The description is "She is even more magnificent than the rumors suggested." Understand "woman" or "girl" or "princess" or "lady" as Sleeping Beauty.

Discovery is a scene. Discovery begins when play begins. Discovery ends when Sleeping Beauty is awake. Marriage Proposal is a scene. Marriage Proposal begins when Discovery ends.

When Discovery ends: say "Throughout the palace you can hear the other sounds of stirring and movement as the spell of centuries is broken."; now Beauty is passive.

Instead of waking an awake person: say "Redundant."

Instead of waking an asleep person: say "Yes, but how?"

Instead of waiting in the presence of an asleep person (called snorer): say "You are alone with the sound of [the snorer] snoring sonorously."

Instead of attacking an asleep person:

now the noun is awake;

say "[The noun] sits bolt upright. 'Hey! Ow!' So much for that true love's kiss nonsense."

Instead of kissing an asleep person:

now the noun is awake;

say "[The noun] slowly stirs to wakefulness!"

Instead of throwing water at an asleep person:

now the second noun is awake;

now the noun is nowhere;

say "You pour out [the noun] on [the second noun].

[The second noun] wakes, shuddering. 'Agh! I had a terrible dream about drowning and then-- Hey!'"

The player carries a jug of water. Understand "pour [something] on [something]" or "splash [something] at/on [something]" as throwing it at.

Table of Conversation

topic	reply	quip
"dream/dreams/nightmare/nightmares/sleep"	"'Sleep well?' you ask solicitously. 'Not really,' she replies, edging away from you. So much for that angle."	"'Ghastly nightmares,' she remarks. You nod politely."
"marriage/love/wedding/boyfriend/beau/lover"	"'So,' you say. 'This is a little weird since we just met, but, um. Would you like to get married?' She looks at you nervously. 'Do I have to? I mean, I'd rather not.' Well, this could get prickly fast."	"'I, er,' she says. 'I hope I'm not supposed to marry you or something.' Uh oh."
"marriage/love/wedding/boyfriend/beau/lover"	"'I was told I was going to marry you and inherit the kingdom,' you say, apologetically. 'Would that be very bad?' This could be awkward, considering your family circumstances -- you did promise your mother that everything would be better, after this -- 'Oh, it's not you -- I'm seeing someone,' she says, smiling quickly. You try to think how to point out that it's been a hundred years since she last saw her boyfriend."	"'Do you think I could go look for someone? I'm seeing him, you see, and I think I've been... sick... for a while, so he might be worried.' You try to think how to point out that it's been a hundred years since she last saw her boyfriend. And try not to think how awkward things would be in your family if she refuses to marry you."
"marriage/love/wedding/boyfriend/beau/lover"	"'Do you think you could consider alternatives if he's no longer interested in you?' you suggest. She gives you the look of a wounded squirrel. 'My father might not approve of my love for the kitchen boy, but his heart is faithful and true!' she exclaims. 'Right; supposing that he's still around, I'm sure that his love won't have faded,' you say, considering your fingernails. Maybe you'd better come clean with her about your identity, after all: she might be more favorably inclined if she understood that you won't interfere in her base-born romances."	"'I don't expect you to understand,' she says in a low whisper. 'I know it is not considered proper for a princess to love -- and such a one as my William, who works in the kitchen --' Her glance dares you to laugh. '-- but I cannot marry you without telling you this truth.' Right then. Perhaps you'd better tell her your secret, in exchange?"
"marriage/love/wedding/boyfriend/beau/lover"	"'You've been up here for a hundred years,' you say. An unpleasant thought occurs to you. 'Was your young man in the castle somewhere?' She shakes her head mutely."	"She goes to the window and looks out at the now-fading thicket of briar. 'That took a while to grow,' she observes. 'I've been up here longer than I thought.' You shrug, uncomfortable."

Instead of asking an awake beauty about a topic listed in the Table of Conversation when Marriage Proposal is happening:

now Beauty is passive;

say "[reply entry][paragraph break]";

blank out the whole row.

Instead of telling an awake beauty about something: try asking the noun about it.

Instead of asking an asleep person about something:

say "[The noun] snores."

Marriage Proposal ends in failure when the number of filled rows in the Table of Conversation is 0.

Every turn during Marriage Proposal:

if Beauty is active and Beauty is visible:

repeat through Table of Conversation:

say "[quip entry][paragraph break]";

blank out the whole row;

make no decision.

When Marriage Proposal ends in failure: end the story saying "This is going to take some explaining."

Part 2 - Flashbacks

Instead of asking an awake beauty about a topic listed in the Table of Flashback Material:

now Beauty is passive;

say "[reply entry][paragraph break]".

A fact is a kind of thing. A fact can be known or unknown. A fact can be current or past.

The family circumstances is a fact. The secret identity is a fact. The printed name of secret identity is "secret".

Table of Flashback Material

topic	reply
"poor/poverty/family/money/mother/circumstances" or "family circumstances" or "my family/mother"	"[if family circumstances is unknown]'I wish you'd give some thought to marrying me. You see,' you say, your jaw tensing. 'I wouldn't ask if it weren't for my [family circumstances]...'[otherwise]'I don't think you fully understand the [family circumstances],' you say.[end if]"
"secret/identity/gender/girl/female/woman" or "secret identity" or "my secret" or "my secret identity" or "my gender"	"[if dramatic revelation ended in failure]'Look,' you say, trying again. 'Pay attention: I need you to understand my [secret identity].'[otherwise]You clear your throat and allow your voice to stray upward, into its natural register and out of this husky false tenor you've been affecting. 'There's, er, something you should know about my [secret identity],' you say...[end if][if dramatic revelation ended in success] She looks impatient. 'I get it, you know,' she says. 'I'm not stupid.'"

After printing the name of a fact (called target): now the target is current; now the target is known.

Poverty flashback is a recurring scene. Poverty flashback begins when family circumstances is current. When poverty flashback begins: strip the player; move the player to the Woodcutter's Shack.

The Woodcutter's Shack is a room. "Your family lives in a shack in the forest. There are holes in the roof, and in the winter the snow comes in -- rain, too, for that matter. The walls aren't very well-boarded, and don't keep out the wind, and even though you live in the middle of dense woods, you can never gather enough fuel to keep this place fully heated. And then there's the stench. Pigs wander freely in and out, and your three youngest brothers play on the floor."

Pigs are an animal in the shack. The pigs are scenery. The description is "They really are very grubby, dirty animals, but what's worse than that, the value of pigs has declined a lot over the last few decades. This is hard to explain to someone who has been out of touch with the world for a while, but keeping pigs for meat is a dubious prospect when there's less and less for them to forage on." Instead of smelling the pigs: say "They smell the way animals do, when they live among their own refuse."; increase the pity of Beauty by 2.

The brothers are a man in the shack. The brothers are scenery. The description of brothers is "Hans, Franz, and Lukas. Twins and then the baby. So young, and growing up fatherless; and soon to be orphaned entirely, if your mother's health does not improve." Understand "brother" or "twin" or "twins" or "baby" or "franz" or "hans" or "lukas" as the brothers.

The untidy bed is scenery in the Shack. Mother is a woman on the untidy bed. The description of mother is "She is wasting away of a slow disease, her skin stretched tautly over bone. She hasn't been the same since your father left." On the bed is a folded letter.

The description of the letter is "Many times read over and creased, the letter explains how your father has gone away with a wealthy countess and will not return. Your mother was not able to read it herself, of course, and had to have it explained to her by the parish priest. Now she keeps it by the bed and crumples it in her fits of delirium."

Instead of kissing or touching Mother for the first time:

say "You place a gentle kiss on her feverish brow. She looks up at you, her oldest -- yes, never mind that bit -- with a look of sincere trust and admiration.

'You'll find a way through this for us,' she says, squeezing your fingers. 'I know you will.'"; increase the pity of Beauty by 3.

Instead of kissing Mother: say "You have no more heart-rending memories of affection to recount; that one incident will have to serve, for rhetorical purposes."

Instead of waiting in the Shack: say "The wind blows sharply through the walls."

Instead of attacking someone in the Shack:

say "Though sometimes the conditions of your life make you grouchy and impatient, you would never dream of striking a member of your own family. But from time to time you do feel the temptation."

Beauty has a number called pity. After examining something in the Woodcutter's Shack, increment the pity of Beauty. After examining mother, increase the pity of Beauty by 2. After examining the letter, increase the pity of Beauty by 3.

Poverty flashback ends when waiting or the time since poverty flashback began is five minutes.

When Poverty flashback ends:

now family circumstances is past;

say "...you finish describing the miserable circumstances of your home life, and allow your attention to return to the present.";

restore the player;

now Beauty is passive;

if Beauty is clever and Beauty is sympathetic:

say "'I understand,' she says slowly. 'Yes, I do. I'll do it.' She takes a deep breath and looks at you. 'We will be king together! and your family will be royalty!'";

end the story finally;

otherwise:

if Beauty is sympathetic, say "'Oh dear!' she says. 'What a dreadful life!' She wrings her hands. 'No wonder you are eager to improve your lot...! But --' Her brow clears, a new thought occurring. 'You needn't marry me, you know! We could arrange it differently! I am certain that my father would give you a large reward, instead, and then I would not be separated from my current boyfriend!'";

otherwise say "She makes a disgusted face, but she doesn't seem nearly so heart-wrung as you had hoped to make her. Tough audience, these modern princesses."

Definition: Beauty is sympathetic if the pity of Beauty is greater than 4.

To say attitude:

if Beauty is sympathetic, say "distressed on your behalf";

otherwise say "a little confused".

Saved location is a room that varies. Locker is a container. Wardrobe is a container.

To strip the player:

now every thing carried by the player is in the locker;

now every thing worn by the player is in the wardrobe;

now saved location is location.

To restore the player:

now every thing carried by the player is in the location;

now every thing in the locker is carried by the player;

now every thing in the wardrobe is worn by the player;

move the player to saved location.

Part 3 - The Other Secret

This time, we're waiting for the princess either to understand or not understand -- so we don't want to rerun the scene once it has happened successfully.

Beauty has a number called clue count.
 
Dramatic revelation is a recurring scene. Dramatic revelation begins when attempting confidence.
 
To decide whether attempting confidence:
   if dramatic revelation ended in success, no;
   if secret identity is current, yes;
   no.
 
When dramatic revelation begins:
   strip the player;
   say "You reminisce about one of the many stops on the way here: you had a long journey from your homeland, and it wasn't made any easier by your poverty, the inability to afford decent inns or plentiful food or any kind of ride along the way.";
   move the player to the Forest Clearing;
   move the pack to the player; now the player wears the trousers; now the player wears the shirt.
 
Forest Clearing is a room. "It's mid-autumn in your memory, the pool clear and cold, gold and red leaves floating on the surface."
 
The pool is scenery in the Clearing. Understand "reflection" or "surface" or "water" as the pool. "The pool is cold but beautiful, and the stopping place a welcome rest." The leaves are scenery in the clearing. The description is "Bright gold and orange and red: it's been a sharply chilly autumn, as you have reason to know in detail."
 
The trousers and the shirt are wearable things. The pack is a container. The pack contains ale, food, and skirt. A distraction is a kind of thing. The ale, the food, the pair of trousers, and the shirt are distractions. The description of a distraction is usually "[The item described] is not the point of this story." The shirt and the trousers are wearable. The description of the trousers is "Borrowed from your oldest brother, who is only a year younger than you. They are too long for your legs and overly snug at the hip, but no one around here pays much attention to fashion, and you're getting away with it, more or less." After examining the trousers, increment the clue count of Beauty.
 
Instead of examining the player during dramatic revelation:
   increment the clue count of Beauty;
   say "You cannot see yourself without reflection, but you can feel your hair loose and unbound over your shoulders."
 
Rule for printing the name of the skirt while taking inventory: say "one skirt you have not been able to bring yourself to part with". The description of the skirt is "Made for you by your mother, and it looks quite pretty on you. If your primary plan does not work, you may be forced to wear it again, and hope to catch a male eye... but with luck that will not be necessary." After taking inventory: increment clue count of Beauty.
 
Swimming is an action applying to nothing. Understand "swim" or "dive" as swimming.
 
Instead of swimming in the presence of the pool:
   increment clue count of Beauty;
   say "You consider going for a swim, but don't dare be caught unclad and unarmed, not here. There are too many men around, and any of them discovering you here would surely take advantage."
 
Instead of searching or drinking the pool:
   increment clue count of Beauty;
   say "You lean over the pool and look carefully at your reflection, your hair loose and unbound, falling around your face in waves. (That should surely give it away!)"
 
Instead of waiting during dramatic revelation: say "You wait for the penny to drop, for her to understand."
 
Dramatic revelation ends in failure when waiting or the time since dramatic revelation began is five minutes. When dramatic revelation ends in failure:
   now secret identity is past;
   restore the player;
   now Beauty is passive;
   say "She wrinkles her nose. 'I don't understand!' she says. 'What are you trying to tell me?'
 
   You could weep for womankind. But you don't quite dare spell it out in so many words, not when someone might come up the stair and overhear a chance revelation."
 
Dramatic revelation ends in success when Beauty is clever. When dramatic revelation ends in success:
   restore the player;
   now Beauty is passive;
   say "'You're -- a girl? Like me?'
 
'Not much like you,' you say, glancing over her petite frame and pert nose. 'But female, at any rate.'"
 
Definition: Beauty is clever if the clue count of Beauty is greater than 2.

And now, since we don't really want to return to the rest of the 'marriage proposal' scene once she has learned our ID:

Marriage proposal ends in distraction when Dramatic Revelation ends in success.
 
Compromise proposal is a scene. Compromise proposal begins when Dramatic Revelation ends in success. When Compromise Proposal begins: now Beauty is passive.
 
Instead of asking an awake beauty about a topic listed in the Table of Secondary Conversation when Compromise Proposal is happening:
   now Beauty is passive;
   say "[reply entry][paragraph break]";
   blank out the whole row.
 
Every turn during Compromise Proposal:
   if Beauty is active and Beauty is visible:
      repeat through Table of Secondary Conversation:
         say "[quip entry][paragraph break]";
         if the number of filled rows in the Table of Secondary Conversation is greater than 1, blank out the whole row;
         make no decision.
 
Every turn: now Beauty is active.

Notice that we moved the re-activation rule down here so that the Compromise Proposal rule would fire first. There are other more complicated ways of handling order of every turn rules than by relying on text sequence alone; but we will save that for a later chapter. For now it is sufficient to depend on the order in which the rules are declared.

Table of Secondary Conversation

topicreplyquip
"girls/me/women/female/truth/identity""'Marrying me would be no interference,' you go on. 'You could carry on whatever romances you wished, without your father noticing.' (Probably. You'll let the pragmatic details of this work themselves out later, and hope that any children she has will look vaguely like you.)""'Girls can't rescue people.'

'Wrong,' you say, feeling a little annoyed. 'But you see why marrying me wouldn't be an interference. You could carry on whatever romances you wished, without your father even noticing.'"
"king/man""'If you're thinking that a woman can't be the prince -- and then king -- well, there was a woman Pope, once.'

She looks awed.""The crease in her forehead does not go away. 'But if everyone thinks you are a man... later you would be king!'

Before she can go on, you say, 'There was a woman Pope, once. Compared to that, a woman king is nothing.'"
"decision/proposal/marriage/choice""'So,' you say. 'What do you think?'

[final decision]""Her pretty nose twitches again, which you are coming to recognize as a sign of hard mental labor. 'I think I see,' she says. [final decision]"
 
To say final decision:
   if Beauty is sympathetic:
      say "She considers the matter silently for some minutes, then says: 'I will do it. My beloved William will be so glad!' You imagine that William's feelings on the matter will be a tad more complex than that, but do not bother quashing her exuberance...";
      end the story finally;
   otherwise:
      say "'I still don't quite understand why you would want this so badly as to go to all that trouble,' she admits uneasily. Evidently you have not explained enough to her about the poverty of your home life."
 
Test me with "x beauty / pour water on beauty / ask beauty about sleep / tell beauty about poverty / smell pigs / x mother / x letter / kiss mother / ask beauty about marriage / tell beauty about identity / x me / look in water / i / z / ask beauty about marriage".

wi 10.8 Multiple endings
rb 4.5 Flashbacks

🔗

RB §4.6 Plot Management

A plot manager (sometimes called a drama manager) is a piece of the program whose job it is to plan out events so that, whatever the player does, the story advances and an interesting narrative results. The plot manager might, for instance, decide that the player has wandered around for too many scenes without making any progress, and might compensate by making something happen that gives him a new hint on his current problem. It might trigger characters to act when it thinks the story should be reaching a crisis point. It might introduce new complications when it determines that the player is running out of problems to solve.

This is a theoretically challenging field. Sophisticated plot management requires that the story make difficult guesses, such as whether the player is "stuck" and what the player is working on right now. The advantage of using such a system is that (done very well) it makes the story extremely responsive to the player's behavior, which means that he is a real agent in the unwinding of the plot. It also contributes to the replayability, since trying the story a second or third time will produce quite different outcomes. But it is procedurally difficult to design a good plot management system and it requires a huge amount of content, as well: in order for the plot manager to give the player hints, change the course of events to suit his focus, and so on, the story has to have available many, many more scenes than will ever occur in any single playing.

Fate Steps In ★★★ is only a very brief sketch in this direction, one in which the "fate" entity is trying to accomplish an end goal and, every turn, looks for ways to push the story towards that conclusion, whatever the player does.

Example

209. Fate Steps In ★★★

One of the nice things about before rules for actions is that they allow us to express some planning for characters other than the player: we've already seen how this works, a bit. But we could also use before rules to write plans for an abstract story-driving entity, rather than for other individual characters. This story-driver could be in charge of all the non-player characters, as well as spontaneous or natural changes in the environment, shaping the narrative around the player's behavior.

The following example is a very simple one, but the same concept could be worked out in a great deal more complexity, with all sorts of alternative procedures available to our story-manager:

"Fate Steps In"

Fate is a woman. After deciding the scope of the player: place Fate in scope. The description of Fate is "Not smiling." Instead of doing something other than examining to fate: say "As if."

Every turn: try fate tripping.

Tripping is an action applying to nothing.

Carry out someone tripping:

if something dangerous (called the trap) is in the location:

say "Lise chooses this moment to lick her fingers -- it's not gross, it's natural, you decide -- stand up, and head for the door. Unfortunately, her path crosses directly over [the trap]. There is a vaudevillesque moment where you try to warn or catch her; the next moment she's on the floor, looking shocked and also in quite a lot of pain. 'I'm not sure,' she says to you steadily but with unfocused gaze, 'but I think I might have broken my tailbone.'";

end the story saying "Well, she's paying attention to you now".

Before someone tripping when the location does not contain a dangerous thing: try the person asked making a mess instead.

Making a mess is an action applying to nothing.

Carry out someone making a mess:

let calamitous object be a random visible supporter which supports at least three things;

if calamitous object is a supporter:

say "[The calamitous object] tips over, spilling [the list of things on calamitous object] all over the place.";

move the calamitous object to the location;

now every thing on the calamitous object is in the location.

Definition: a thing is dangerous if it is not the carton and it is not the table and it is not a person.

Before someone making a mess when a safe supporter (called target) is visible:

if Lise carries something, try Lise putting a random thing carried by Lise on the target instead.

Instead of someone making a mess when the tray is on the table:

say "Just at that moment, a large blond man-thing in a red jacket walks more or less through you, and you come into violent contact with the table, knocking [the list of the things on the table] onto the floor.";

now every thing on the table is in the location;

now every thing on the tray is in the location instead.

Definition: a supporter is safe if the number of things on it is less than two.

McQuerry Dining Hall is a room.

The table is scenery in the dining hall. The table is a supporter.

Lise Fitzwallace is a woman in the Dining Hall. "Lise is at the nearest table, not apparently paying any attention to you." The description of Lise is "A capella singer, women's rugby champion, general object of attention from all genders. Unlikely to notice you unless fate smiles broadly." Lise carries a fork, a napkin, an empty glass, and a plate of half-eaten eggplant parmesan.

Report Lise putting something on something:

say "Lise, still deep in thought, absently puts [the noun] on [the second noun]." instead.

The carrying capacity of the player is 2. The carton of chocolate milk is in the Hall. "There's a carton of milk beside you, which you set down for a moment -- but you do want it."

Instead of taking something when the player carries the tray:

say "You've got both hands full with this tray."

The player carries the tray. On the tray is some macaroni and some overdone chicken. The macaroni and the chicken are edible. The tray is portable.

Test me with "get milk / put tray on table / get milk".

Test again with "drop tray".

wi 12.13 Report rules for actions by other people
rb 4.6 Plot Management

§5.

The Human Body

§5.

Traits Determined By the Player

§5.

§5.

§5.

§5.

RB §5.1 The Human Body

By default, Inform gives the player character (and every other person) a simple unitary body, one without hands or feet or any other defined parts. In many games this is adequate; but in others it is not enough, and we may want to endow all people with some more specific physical features, as in

A face is a kind of thing. A face is part of every person.

Once we've done this, we may invite ambiguities if the player types LOOK AT FACE; it is this challenge that is addressed in The Night Before ★★★.

rBGH ★ gives the player a random height and then uses this to determine how the room should be described around him.

Slouching ★★ lets the player (and other characters as well) take different sitting, standing, and lying down positions.

Examples

254. rBGH ★

As with ordinary numbers, we can choose random units when this is useful:

"rBGH"

The Pharmaceutical Testing Facility is a room. "A [if the player is short]large [end if][if the player is tall]cramped [end if]white space with sterile counters and a[if the player is tall]n uncomfortable little[end if] stool. There is also a mirror, behind which someone must be watching you. But you can't see through to that."

A counter, a one-way mirror, and a stool are scenery in the Facility. The stool is an enterable supporter. The counter supports a plate.

Height is a kind of value. 5 feet 11 inches specifies a height. 5'11 specifies a height. A person has a height.

Definition: a person is tall if its height is 6 feet 0 inches or more.

Definition: a person is short if its height is 5 feet 4 inches or less.

When play begins:

now the height of the player is a random height between 5 feet 2 inches and 6 feet 4 inches;

now the right hand status line is "[height of player]".

Instead of examining the player:

say "You, Test Subject, are [height of the player] tall."

The growth pill is a kind of thing. A growth pill is always edible. The description is usually "It is leaf-green and has a reassuring logo of a curling vine on the side. Nothing to worry about, nothing at all." Two growth pills are on the plate.

After eating the growth pill:

increase the height of the player by 0 feet 6 inches;

say "Your spine does something frightening and painful, and you find yourself looking down on the room from a wholly new angle.";

try looking.

Test me with "examine me / eat pill / examine me / eat pill / examine me".

wi 15.8 Units
rb 5.1 The Human Body

396. Slouching ★★

Suppose we want to let the player explicitly sit, stand, or lie down on different enterable objects. (Normally Inform treats all these actions as entering, but there may be cases where we want to distinguish between the player sitting on a chair and the player standing on it.)

Our implementation gives each kind of enterable a range of allowed postures, and one preferred posture. If the player enters the supporter or container without specifying a posture (as in ENTER CHAIR), he will be put in the preferred posture. If he explicitly says, e.g., STAND ON CHAIR, he will be put in the standing position as long as standing is a posture that suits the chair.

"Slouching"

Section 1 - Posture Rules

A posture is a kind of value. The postures are seated, standing, and reclining.

A person has a posture. The posture of a person is usually standing.

A supporter has a posture. A container has a posture.

Posture-permission relates various things to various postures. The verb to allow means the posture-permission relation.

Understand the commands "stand" and "sit" and "lie" as something new.

Understand "sit on/in [something]" as sitting on.

Understand "lie on/in [something]" as lying on.

Understand "stand on/in [something]" as standing up on.

Sitting on is an action applying to one thing.

Lying on is an action applying to one thing.

Standing up on is an action applying to one thing.

Carry out an actor sitting on:

if the holder of the actor is not the noun, silently try the actor entering the noun;

if the holder of the actor is the noun:

if the actor is not seated, try the actor taking position seated;

otherwise follow the report taking position rules.

Carry out an actor lying on:

if the holder of the actor is not the noun, silently try the actor entering the noun;

if the holder of the actor is the noun:

if the actor is not reclining, try the actor taking position reclining;

otherwise follow the report taking position rules.

Carry out an actor standing up on:

if the holder of the actor is not the noun, silently try the actor entering the noun;

if the holder of the actor is the noun:

if the actor is not standing, try the actor taking position standing;

otherwise follow the report taking position rules.

Understand "lie down" as lying down.

Understand "sit down" or "sit" or "sit up" as sitting down.

Understand "stand" or "stand up" as standing up.

Lying down is an action applying to nothing.

Sitting down is an action applying to nothing.

Standing up is an action applying to nothing.

Taking position is an action applying to one posture.

Instead of an actor lying down:

try the actor taking position reclining; rule succeeds.

Instead of an actor sitting down:

try the actor taking position seated; rule succeeds.

Instead of an actor standing up:

try the actor taking position standing; rule succeeds.

Check an actor taking position:

if the holder of the actor is not a room and the holder of the actor does not allow the posture understood:

if the actor is the player:

say "You can't take that position [in-on the holder of the actor].";

otherwise if the actor is visible:

say "[The actor] can't take that position.";

stop the action.

Check an actor taking position:

if the posture understood is the posture of the actor:

if the actor is the player:

say "You are already [the posture understood].";

otherwise:

if the actor is visible, say "[The actor] is already [the posture understood].";

stop the action.

Carry out an actor taking position:

now the posture of the actor is the posture understood.

Report someone taking position (this is the position-report rule):

say "[The actor] is now [the posture of the actor][if the holder of the actor is not the location of the actor] [in-on the holder of the actor][end if]."

Report taking position:

say "You are now [the posture of the player][if the holder of the player is not the location] [in-on the holder of the player][end if]."

To say in-on (item - a thing):

if the item is a container, say "in [the item]";

otherwise say "on [the item]".

Carry out an actor exiting (this is the departure-posture rule):

let N be the holder of the actor;

if N is a container or N is a supporter,

now the posture of the actor is the posture of N;

otherwise now the posture of the actor is standing.

The departure-posture rule is listed after the standard exiting rule in the carry out exiting rulebook.

The departure-posture rule is listed after the standard getting off rule in the carry out getting off rulebook.

Carry out an actor entering something (this is the arrival-posture rule):

if the noun is a container or the noun is a supporter,

now the posture of the actor is the posture of the noun.

The arrival-posture rule is listed after the standard entering rule in the carry out entering rulebook.

Check an actor going somewhere:

if the actor is in a room and the actor is not standing:

say "([if the actor is not the player][the actor] [end if]first standing up)[command clarification break]";

silently try the actor taking position standing;

if the actor is not standing, stop the action.

Section 2 - Some Generic Kinds

A chair is a kind of supporter. A chair is always enterable. Every chair allows seated and standing. A chair is usually seated.

A sofa is a kind of supporter. A sofa is always enterable. Every sofa allows seated, standing and reclining. A sofa is usually seated.

A hammock is a kind of container. A hammock is always enterable. Every hammock allows seated and reclining. A hammock is usually reclining.

Section 3 - The Scenario

The Resort is a room.

The banana hammock is a hammock in the Resort. The stone bench is a sofa in the resort.

Clark is a man in the Resort. A persuasion rule: persuasion succeeds.

Rule for writing a paragraph about someone (called target):

say "[The target] is [posture] [if the holder of the target is the location]nearby[otherwise][in-on the holder of the target][end if]."

Rule for writing a paragraph about something which encloses an unmentioned person (called target):

carry out the writing a paragraph about activity with the target instead.

Test me with "sit on bench / stand on bench / get up / lie on hammock / sit up / g / clark, sit on bench / look / clark, lie down / g / look / clark, get up / look / clark, lie down / look / enter bench".

wi 19.4 Listing rules explicitly
rb 5.1 The Human Body

59. The Night Before ★★★

Suppose that we're going to give every person in the game a nose, but we want references to a nose always to mean the nose of someone *else*, if the player is with one other person. Moreover, on some occasions we're going to be in sight of Rudolph, so actions directed at an unspecified nose should always prefer his.

This relies on a somewhat advanced technique from the Understanding chapter, but since it may become useful with assemblies and body parts, it is worth mentioning here.

"The Night Before"

The North Pole is a room. "Here it is: the famous Pole. From here you can go south (or south-south, or south-south-by-south); or, alternatively, take refuge inside a red-and-white-striped cabin." The cabin is scenery in the North Pole. Instead of entering the cabin, try going inside.

Santa is a man in the North Pole. "Santa is pacing around in the snow and trying to psych himself up for the big night."

Inside from North Pole is the Candy Cane Cabin. The description of the Cabin is "Striped red and white, but nothing can make this place seem warm and inviting since Mrs. Santa ran off with the Tooth Fairy."

The Ice Shelf is south of North Pole. "The ice here has been smoothed into a kind of runway for easy take-off, and ends in a cliff and cold arctic sea." Donner, Vixen, Blixen, and Rudolph are animals in the Ice Shelf.

A nose is a kind of thing. A nose is part of every person. The description of Santa's nose is "It's a bit ruddy. You don't like to mention it, but Santa's been dipping heavily into the Grey Goose since Mrs. Santa left town." The description of a nose is usually "Not terribly exciting." The description of Rudolph's nose is "See how it glows!"

Next, we'll teach Inform some vocabulary to distinguish between the player and everyone else:

Definition: a person is other if it is not the player.
 
Definition: a thing is selfish if it is part of the player and the player can see an other person.
 
Instead of examining a selfish nose:
   say "You cross your eyes, but can't get a good look."

Here is the part that actually determines the preferences. "Does the player mean…" can result in five outcomes: "it is very unlikely", "it is unlikely", "it is possible" (the neutral default), "it is likely", and "it is very likely". This is discussed in greater detail in the Understanding chapter. Here, we want to discourage references to the player's own nose and encourage references to the nose of Rudolph, so:

Does the player mean doing something when the noun is a selfish nose or the second noun is a selfish nose: it is very unlikely.
 
Does the player mean doing something to Rudolph's nose: it is very likely.

And this part is just for decoration:

Rule for writing a paragraph about Rudolph:
   say "The reindeer are already harnessed and waiting impatiently. The brilliance of [Rudolph]'s nose casts an eerie red glow over [the list of unmentioned animals in the location]."
 
Test me with "x nose / x my nose / x santa's nose / in / x nose / out / s / x my nose / x nose / x rudolph's nose / x donner's nose".

wi 4.15 Assemblies and body parts
rb 5.1 The Human Body

🔗

RB §5.2 Traits Determined By the Player

Some IF tries to make the viewpoint character more congenial to the player by allowing some customization.

Identity Theft ★ demonstrates asking the player to supply the viewpoint character's name.

Pink or Blue ★★★ demonstrates a way to let the player choose a gender at the start of play: this will mostly be interesting if the rest of the story makes some use of the player's choice. Since that example is written expressly to demonstrate included Inform 6 code, however, we may find it more congenial to generalize from the more flexible Baritone, Bass ★★★.

This is not the only way to go - as we'll see in the next section, there's also something to be said for making the viewpoint character a strongly distinct creature with well-defined preferences and attitudes.

Examples

415. Identity Theft ★

Let's say we want to allow the player to enter any name he likes for his character. Moreover, we want to reject very long names (which are likely to be mistakes anyway), and we want to extract the player's chosen first name from the rest.

"Identity Theft"

The player's forename is a text that varies. The player's full name is a text that varies.

When play begins:

now the command prompt is "What is your name? > ".

To decide whether collecting names:

if the command prompt is "What is your name? > ", yes;

no.

After reading a command when collecting names:

if the number of words in the player's command is greater than 5:

say "[paragraph break]Who are you, a member of the British royal family? No one has that many names. Let's try this again.";

reject the player's command;

now the player's full name is the player's command;

now the player's forename is word number 1 in the player's command;

now the command prompt is ">";

say "Hi, [player's forename]![paragraph break]";

say "[banner text]";

move the player to the location;

reject the player's command.

We also want to postpone the proper beginning of the game until we've gotten the name:

Instead of looking when collecting names: do nothing.
 
Rule for printing the banner text when collecting names: do nothing.
 
Rule for constructing the status line when collecting names: do nothing.
 
Your Bedroom is a room. The printed name of Your Bedroom is "[player's forename]'s Bedroom".
 
The player carries a letter. The description of the letter is "Dear [player's full name], [paragraph break]You have won the Norwegian Daily Lottery! ...".

If we are compiling for Glulx, this is enough to capture not only the player's name but also the capitalization he uses.

If we are compiling for the Z-machine, the player's input will unfortunately be reduced to lower case before we can inspect it. If we would like by default to capitalize the first letter of each word of the name, we might substitute the following after reading a command rule:

After reading a command when collecting names:

if the number of words in the player's command is greater than 5:

say "[paragraph break]Who are you, a member of the British royal family? No one has that many names. Let's try this again.";

reject the player's command;

now the player's full name is the substituted form of "[the player's command in title case]";

now the player's forename is word number 1 in the player's full name;

now the command prompt is ">";

say "Hi, [player's forename]![paragraph break]";

say "[banner text]";

move the player to the location;

reject the player's command.

wi 20.7 Making new text with text substitutions
rb 5.2 Traits Determined By the Player

309. Baritone, Bass ★★★

The "reading a command" activity is rather advanced; for the moment, what we need to understand is that we're intervening in commands at the start of play and insisting that the player's first instruction to the game consist of a choice of gender. After that point, the gender will be set and play will proceed as normal.

In order to do the parsing, we define gender as a kind of value, and give several alternate names to each gender.

"Baritone, Bass"

Getting Started is a room.

Gender is a kind of value. The genders are masculine, feminine, and unknown. Understand "male" or "man" or "M" as masculine. Understand "female" or "woman" or "F" as feminine.

A person has a gender. The gender of the player is unknown.

When play begins:

now the command prompt is "Please choose a gender for your character. >".

After reading a command when the gender of the player is unknown:

if the player's command includes "[gender]":

now the gender of the player is the gender understood;

if the gender of the player is unknown:

say "This story requires a selection of male or female. [run paragraph on]";

reject the player's command;

if the gender of the player is masculine, now the player is male;

if the gender of the player is feminine, now the player is female;

say "[line break]Thank you. We now begin...";

now the command prompt is ">";

move the player to Sandy Beach;

reject the player's command;

otherwise:

say "Sorry, we're not ready to go on yet. [run paragraph on]";

reject the player's command.

Sandy Beach is a room.

Instead of examining the player when the player is female:

say "Congratulations, you are a girl!"

Instead of examining the player when the player is male:

say "Congratulations, you are a boy!"

If we had a whole series of things to ask the player about, we might define a whole series of kinds of value

The vocal ranges are soprano, mezzosoprano, contralto...

and use a "construction stage" variable to keep track of the current stage of character-construction, as in

After reading a command when the current construction stage is choosing a vocal range:
   ...

wi 17.11 Understanding values
rb 5.2 Traits Determined By the Player

450. Pink or Blue ★★★

Suppose we would like to allow the player to choose a gender for the main character. We'd also like this to happen at the beginning of the game and outside the main parsing sequence. "When play begins" seems like a good place to put this.

"Pink or Blue"

When play begins:

say "Should your character be male or female? >";

if men win, now the player is male;

otherwise now the player is female;

say paragraph break.

Now a piece of Inform 6 code handles the unusual input. It's not necessary to understand this to use it, and the code should work for any question you'd like to ask the player. The first three words in quotation marks ('male', 'M', 'man'…) correspond to positive feedback; the later three words correspond to negative feedback. So "to decide whether men win" will be true if the player types one of the first three, and false if he types one of the last three.

To decide whether men win:
   (- Question('male','M//','man','female','F//','woman') -)
 
Include (-
 
[ Question pos1 pos2 pos3 neg1 neg2 neg3 first_word_typed;
   while (true) {
      VM_ReadKeyboard(buffer, parse);
      wn = 1; first_word_typed = NextWordStopped();
      if (first_word_typed == pos1 or pos2 or pos3) rtrue;
      if (first_word_typed == neg1 or neg2 or neg3) rfalse;
      print "Please choose ", (address) pos1, " or ", (address) neg1, ". > ";
   }
];
 
 
-)
 
Instead of examining the player when the player is female:
   say "Congratulations, you are a girl!"
 
Instead of examining the player when the player is male:
   say "Congratulations, you are a boy!"
 
The Room of Self-Knowledge is a room. "Mirrors cover every available wall-surface of this hexagonal chamber, allowing you to examine yourself from all angles."

wi 27.15 Defining phrases in Inform 6
rb 5.2 Traits Determined By the Player

🔗

RB §5.3 Characterization

Much of the personality of the player character in IF emerges from what he can and cannot (or will and will not) do; part of the pleasure of playing a character arises from this opportunity for role-playing and role-exploration. Some characters are consciousless daredevils, willing to jump off cliffs, crawl through narrow gaps, and rob widows if the player commands it; others are repressed neurotics who barely dare to speak to other characters or touch anything that doesn't belong to them.

Finishing School ★ and Dearth and the Maiden ★ both treat the case of a character constrained by good manners and a sense of polite society: the former forbids only one action, while the latter condemns a whole range of them.

Constraining the character is only the half of it: we might also want to think about what sorts of unusual actions that character might be especially likely to take, and account for these. Of course, major actions that affect the story world will require some thought and implementation work, and we should consider carefully before making the player a character like, say, the Noble of Glamour, a spirit in human form who can charm all comers, transform bespectacled secretaries into divas, and cause spontaneous cloudbursts of scarlet glitter.

But even simple humans have some characteristic traits and gestures. We will probably want to write some characteristic reaction to EXAMINE ME, as demonstrated in Bad Hair Day ★. We might provide a few pieces of clothing or props that aren't strictly critical in the story, like a policeman's helmet or a feather boa:

The player is wearing a policeman's helmet.

We can liven up the interactive aspect of characterization if we give the player a little scope for role-playing: this may mean responding to gestures, like

Understand "bite nails" as a mistake ("Your only nail remaining is the one on your left thumb, and you're saving it for the AP Calculus exam.").

(Of course, we would need to have hinted to the player that nail-biting is characteristic of his character.)

Examples

73. Finishing School ★

It is often useful to write action rules which apply only when the player is observed by a third party. "In the presence of a person", however, will react even if only the player is in the room, because the player is, of course, a person as well.

A convenient way around this problem is to define an "other" adjective:

"Finishing School"

The apple is an edible thing carried by the player.

The Hall is a room. Miss Wicket is a woman in the Hall.

The Dormitory is south of the Hall.

Definition: a person is another if it is not the player.

Instead of eating something in the presence of another person:

say "Your mannerly upbringing prevents you from eating without a fork or knife in front of someone."

Test me with "eat apple / south / eat apple".

If we did not have "another" here, Inform would interpret even the player as a possible schoolmarm, leading to such lines as "yourself stares at you coldly…". Clearly not quite the thing.

wi 6.4 Defining new adjectives
rb 5.3 Characterization

85. Bad Hair Day ★

"Bad Hair Day"

The Foyer is a room. "A mirror hangs over the table, tempting you to check your appearance before going in with all the others."

Instead of examining the player:

say "Oh, stop fussing. You look fine."

Test me with "examine me".

wi 7.2 Instead rules
rb 5.3 Characterization

109. Dearth and the Maiden ★

The following example, indebted to the late Georgette Heyer, is suggestive:

"Dearth and the Maiden"

The Chequers Inn is a room. "The room is panelled and ceilinged in oak, with blue curtains to the windows and blue cushions on the high-backed settle by the fire."

An oil painting is in the Inn. "An oil painting hangs upon one wall, a lascivious work from the Indies in which a very bendy, sloe-eyed courtesan - but no."

A man called Mr Carr is in the Inn. "Standing bashfully aside is one Mr Carr, who we have been led to understand is by profession a Highwayman (yet whose visage oddly recalls Lord John Carstares, disgraced eldest son of the Earl of Wyncham)."

Kissing Mr Carr is unmaidenly behaviour. Doing something to the painting is unmaidenly behaviour.

Instead of unmaidenly behaviour in the Inn, say "How unmaidenly! Why, one might just as wantonly strip a rose of its petals, letting each fragrant leaf flutter slowly to the ground."

Test me with "examine painting / take painting / kiss mr carr".

wi 7.15 Kinds of action
rb 5.3 Characterization

🔗

RB §5.4 Background

In IF, as in all interactive storytelling, an essential problem is that the player does not begin the story knowing everything that the player character should, and so may implausibly bumble through situations that the player character should be quite comfortable in. If the player character has friends, an unusual job, a home or environment we're not familiar with, a secret past, these will all be a blank to the player.

Some games get around this by making the player character an amnesiac, or positioning him as a newcomer to a strange world in which his disorientation is explicable; but there are stories that cannot be told this way, and so we need other methods of getting the player to know what the player character already does.

Our first opportunity to inform the player about the player character is in the opening text of a story:

When play begins:
   say "The funeral is exactly a month ago now, but Elise's shoes are still on the shoe tree."

We may also want to write descriptions of objects to give extra background information the first time the player encounters them:

A thing can be examined or unexamined. A thing is usually unexamined. After examining something: now the noun is examined; continue the action.
 
The description of the newspaper is "A rolled-up newspaper[if unexamined], and thus a symbol of your newly-single state: Elise always had it open and the Local Metro section next to your plate by the time you got out of the shower[end if]."

To expand on this, we could give the player a THINK ABOUT or REMEMBER command, with which he can call up information about people he meets or references he encounters in descriptions, so that he could (for instance) next type REMEMBER ELISE. Merlin ★ demonstrates one way to implement a character with memory; One of Those Mornings ★ puts a twist on this by letting the player FIND things which he knows his character possessed at some time before the story started.

Examples

277. Merlin ★

"Merlin"

Understand "remember [text]" as remembering.

Remembering is an action applying to one topic.

Carry out remembering:

say "Nothing comes to mind.".

Instead of remembering a topic listed in the Table of Recollections:

say "[response entry][paragraph break]".

Table of Recollections

Topic	Response
"rain/weather"	"You've seen worse, but not often: it's falling so hard now that the tin rattles and the runoff, on the low side of the roof, would be a tenable source of hydroelectric power."
"hydroelectric power" or "power/hydroelectric"	"It's not as though you have any sort of light bulb in here to turn on, even if you could power it."
"light bulb" or "light/bulb"	"Light bulbs, like so much else, are a thing of your past. Or is it your future? Tricky, the way the world loops round on itself."
"past/time/future"	"Living backwards has its drawbacks. A tendency to confuse and annoy your friends, being one; the total inability to maintain a stable relationship; and a deep dissatisfaction with most of the bodily processes people enjoy, since they ultimately make you hungrier, colder, or-- no point dwelling on it, really."
"backwards"	"It's not even exactly backwards, now is it? It's more like a series of forwardses stuck back to back. As though someone had taken each track of a CD and put them in the exactly wrong order. You miss that. The music on demand."

The Inadequate Shelter is a room. "A piece of corrugated tin, leaned on two sticks, and pathetically augmented with a tire (on one side) and a cardboard box (on the side towards the wind). And that's what you've got between you and the driving rain.

At the moment rain is all you can remember, in fact."

Test me with "remember rain / remember power / remember light bulb / remember future / remember backwards".

wi 16.13 Topic columns
rb 5.4 Background

301. One of Those Mornings ★

Suppose that, contrary to the usual rules of interactive fiction, we want to allow the player to discover the locations of things he hasn't actually seen yet:

"One of Those Mornings"

Understand "find [any thing]" as finding.

Finding is an action applying to one visible thing.

Carry out finding:

if the player is carrying the noun:

say "You're holding [the noun]!";

otherwise:

say "You left [the noun] [if the noun is on a supporter]on[otherwise]in[end if] [the holder of the noun]."

The holder of the noun can be a room, a supporter, or a container: the phrase is not picky. We would want to be a little more careful if it were ever possible for an item to have been "removed from play" in our game, since then the holder could be nothing, and that would have odd results. In this particular example, though, that will not arise.

And that's it, as far as the find command goes. The rest is local color.

The Exhibition Room is a room. It contains a closed locked lockable transparent openable container called the display case. The display case contains a priceless pearl. The display case is scenery. The description of the Exhibition Room is "By far the finest thing in the room is a priceless pearl in a glass display case. It should of course be yours[if key is not visible], if only you can remember where you hid the key[end if]."
 
The silver key unlocks the display case.
 
A jade vase, a teak chest, a bronze teakettle, and a child's burial casket are openable closed containers in the Exhibition Room.
 
After taking the pearl:
   say "The pearl rolls into your hand, gleaming in the oblique light; your fortune is made.";
   end the story finally.

If we want to have the key found in different places when the game is replayed:

When play begins:
   let the space be a random container which is not the display case;
   move the silver key to the space.
 
Every turn:
   say "Your watch ticks with maddening loudness."
 
The time of day is 1:02 AM.
 
At 1:08 AM: say "The security guard arrives to find you fumbling about with keys. Curses."; end the story.
 
Test me with "find pearl / find teakettle / get teakettle / find teakettle / find key".

wi 17.7 Understanding any, understanding rooms
rb 5.4 Background

🔗

RB §5.5 Memory and Knowledge

All of us carry around in our heads an (incomplete, imperfect) model of the world around us: an idea of where we left the keys, whether the oven is on or off, how many clean pairs of socks are left in the drawer, what we look like in our best pair of jeans. The differences between that mental model and reality are to some degree a reflection of personal character: our forgetfulness, our wishful thinking, our innocence or cynicism.

By default, Inform does not keep track of the player character's knowledge (or any other character's knowledge, for that matter) as a separate thing from the model world, relying on descriptive prose rather than modeling to introduce these quirks of characterization.

All the same, there are often times when we would like to keep track of discrepancies between the world model and the narrator's mental model. Perhaps the most common way to do this is simply to mark everything that the player encounters as "seen" when the player first examines it, thus:

A thing can be seen or unseen.
 
Carry out examining a thing:
   now the noun is seen.

or -- to have things remembered from the first moment they're mentioned in a room description:

Rule for printing the name of something (called the target):
   now the target is seen.

The mental model need not always be accurate, of course. We might, for instance, have occasion to keep track of where the player character last saw something, even if the object has since been moved; or keep track of falsehoods the player character has been told in conversation; or make the player refer to a character as "the bearded man" until he is properly introduced.

Included with Inform is the extension Epistemology, by Eric Eve, which provides one way of tracking this kind of information. Epistemology distinguishes between items that the player character has seen, because they're objects in a room the player has been to, and items that are familiar to the player for other reasons, such as a quest item he knows about but hasn't found yet, or an abstract conversation topic. Anything that is either seen or familiar is counted as "known".

Modeling what the player does and does not know is only half the job, of course: we also need that information to affect the behavior of the story in plausible ways.

One obvious occasion to use player character knowledge is in the output of descriptions. We might want to respond to actions differently depending on what the player has previously done, as in Tense Boxing ★, or change the way we describe objects in light of new knowledge about them, as in Zero ★★★. Casino Banale ★★★ takes that idea much further, with a whole system of facts that can be narrated to the player in a somewhat flexible but interdependent order, as the player looks at relevant objects or notices them in room descriptions.

Along similar lines, we may want an object to change its name for the player depending on what the player knows. That name change should affect both what Inform displays and what it understands about the object. For instance:

An Amherz Amulet is a thing. It can be known or unknown. It is privately-named.
 
The printed name is "[if known]Amherz Amulet[otherwise]lizard-shaped pewter charm[end if]".
 
The description is "[if known]It's a unique and magically powerful pewter charm shaped like a lizard[otherwise]It's some cheap tacky pewter charm shaped like a lizard. At least, as far as you can tell -- it's pretty grubby[end if]."
 
Understand "amherz" or "amulet" as the Amulet when the Amulet is known.
 
Understand "lizard" or "lizard-shaped" or "pewter" or "charm" as the Amulet when the Amulet is unknown.
 
Instead of rubbing the amulet when the amulet is unknown:
   say "You rub off a bit of the dirt, and... what do you know? It's actually the priceless and fabulously powerful Amherz Amulet!";
   now the Amherz Amulet is known.

Finally, the player's knowledge may affect how the story interprets commands, in the determining what is called "scope". When Inform tries to make sense of something the player has typed, it makes a list of everything that the player is allowed to refer to at the moment, and then checks whether all of the objects in the player's command refer to items in that list. Only things that are "in scope" are open for discussion.

If the player mentions an object that is not "in scope" -- say, a red hat left behind in the next room -- Inform will issue the response "You can't see any such thing." This is also Inform's reply if the player mentions a nonsense object ("EXAMINE FURSZWIGGLE") or an object that does not exist in the story world at all ("EXAMINE CELL PHONE" in a story set in Carolingian France).

This is not the only possible way for interactive fiction to handle such communication. Some games will respond differently to EXAMINE RED HAT and EXAMINE FURSZWIGGLE, saying in the first case something like "You can't see that now" and in the second "I don't know the word 'furszwiggle'."

The drawback of such behavior is that the player can make premature discoveries. If he hasn't found a sword yet, but thinks there may be a sword later in the story, he can type EXAMINE SWORD and see from the response whether his guess is correct. Nonetheless, there are people who prefer this alternative exactly because it does expose the limits of the story's understanding, preventing fruitless attempts to use a word that is not recognized at all. If it is desirable, there is an extension that will reproduce this behavior in Inform as well.

Using Inform's default behavior, however, scope is an ad-hoc way of keeping a list of things that are common knowledge between the story and the player. The player knows many things that the story might not (like what a cell phone is); the story knows a few things the player may not (like the fact that there is a sword in an as-yet unvisited room). Neither of those things can fruitfully enter into commands because they have no mutually agreed-upon referent.

By default, Inform assumes that "scope" includes only those things that are currently visible by line of sight. This works pretty well for a wide range of situations, but there are still plenty of occasions when we want to admit that the story and the player share a knowledge of things not seen. GO TO THE KITCHEN might be a useful command even when the player can't currently view the kitchen. ASK FRED ABOUT THE FOOTPRINTS should perhaps work even when the footprints are far away in the garden. SMELL STINKY CHEESE might need to work even when the cheese is invisibly locked away in a porous container but is exuding a stench. In a dark room, the player can't see his own inventory, but he should still remember that he's carrying it and be able to mention it. And sometimes we might want the story to acknowledge that the player is referring to an object that he has seen somewhere, even if that thing is now out of sight.

In practice, we have two ways to tinker with scope: we can change the scope for a specific command, using a token with any, as in

Understand "go to [any room]" as approaching.
Understand "find [any thing]" as finding.
Understand "ask [someone] about [any known thing]" as interrogating it about.

Or we can add areas and items to scope for all commands, as in

After deciding the scope of the player when the surveillance camera is switched on:
   place the jail cell in scope.

Puncak Jaya ★ demonstrates understanding references to characters who are currently off-stage.

Examples

149. Tense Boxing ★

Here we have a box that prints out its current state and its history each time we open and close it:

"Tense Boxing"

The Temporal Prism is a room. "A room of angled mirrors, in whose surfaces you can see what is now; what just was; what has always been. A final mirror is broken and its frame gapes blackly."

The mysterious box is in the Temporal Prism. It is an openable closed container.

To assess the box:

if the box was not open, say "The box was not open.";

if the box was open, say "The box was open.";

if the box had not been open, say "The box had not been open.";

if the box had been open, say "The box had been open.";

if the box is not open, say "The box is not open.";

if the box is open, say "The box is open.";

if the box has not been open, say "The box has not been open.";

if the box has been open, say "The box has been open."

Before opening the mysterious box:

say "You are about to open the box.";

assess the box.

Before closing the mysterious box:

say "You are about to close the box.";

assess the box.

After opening the mysterious box:

say "You now open the box.";

assess the box.

After closing the mysterious box:

say "You now close the box.";

assess the box.

Note that "was…" and "was not…" and so on may describe conditions more complicated than simple properties: we could equally well ask "if the box has been in the sack", "if the box had been carried by the player", and so on.

The past ("if the box was…") and past perfect ("if the box had been…") are especially useful for cases where we want to report on an action after the state of the item has changed; so, for instance:

After taking the mysterious box:
   if the box had not been carried by the player, say "You lift the mysterious box for the first time.";
   if the box had been carried by the player, say "You again pick up the mysterious box."
 
Test me with "open box / close box / open box / take box / drop box / take box".

This is in many respects similar to a rule beginning "After taking the mysterious box for the first time…", but it is superior in most circumstances, for two reasons.

First, it will respond correctly even if the player has somehow carried the box before without taking it explicitly: for instance, if another character gave him the box, if the box were moved into his inventory as a result of another action, or if the player carried the box at the start of play. Inform begins its reckoning of time when the game begins, so if the box is defined as being open at the outset, "if the box has been open" will always be true.

Second, "after taking… for the first time" fires only the first time the player attempts to take something. If the player tried to take the box, failed, and then tried again later, the "for the first time…" rule would not fire; our "if the box has not been carried…" rule would.

wi 9.13 The past and perfect tenses
rb 5.5 Memory and Knowledge

320. Puncak Jaya ★

By default, when something is not present, Inform does not allow a player to refer to it. But there are times when we might like to acknowledge that the thing mentioned in a command does exist somewhere in the game; it just happens not to be on hand right now.

One way to do this is to make an object that appears everywhere and responds to the name of its owner only when the owner itself is not in view.

"Puncak Jaya"

A ghost is a kind of person. A man-ghost is a kind of ghost. A man-ghost is always male. A woman-ghost is a kind of ghost. A woman-ghost is always female.

We make the ghost a person rather than some other kind of thing so that it will be able to respond to commands such as KISS BOB or (even trickier) BOB, JUMP: if Inform did not recognize the ghost as an animate creature, it would not accept such input.

Representation relates one ghost to one person. The verb to represent means the representation relation.
 
One man-ghost represents every man. One woman-ghost represents every woman.

This is, technically, an assembly -- except instead of saying that every device has a button part, or that there are three daffodils in every garden room, the assembly is based on a non-physical relation that we just designed.

Based on the "representation" relation, we now devise a conditional relation that applies only when the represented thing is not itself in view:

Indication relates a ghost (called X) to a person (called Y) when X represents Y and Y is not visible.
 
Understand "[something related by indication]" as a ghost.
 
When play begins:
   now every ghost is in the concept-repository.
 
Instead of doing something to a ghost:
   say "You seem to have left [a random person which is represented by the noun] behind."
 
Instead of doing something when the second noun is a ghost:
   say "You seem to have left [a random person which is represented by the second noun] behind."
 
The concept-repository is an open unopenable transparent container. It is part of the air. The air is a backdrop. It is everywhere.
 
Base of Puncak Jaya is a room. Temple, Kippax, and Huizenga are men in Base. Peak of Puncak Jaya is above Base of Puncak Jaya.
 
Test me with "x kippax / up / x kippax / kiss kippax / kippax, hello".

Further complications of this example might require that the player meet a character before being able to refer to him or her.

wi 17.16 Understanding things by their relations
rb 5.5 Memory and Knowledge

148. Zero ★★★

The names of objects might want to change also:

"Zero"

Weight is a kind of value. The weights are light, manageable, and horribly heavy. Everything has a weight.

A thing is usually manageable.

This does require a rule for an activity (see the chapter on Activities), but it's a fairly straightforward one:

Before printing the name of a horribly heavy thing (called weighty object):
   if we have taken the weighty object, say "[weight] ".
 
The Nearly Empty Living Room is a room. "Nearly everything is out, all of Helen's possessions and most of yours." A man called Mr Zero is in the Nearly Empty Living Room. "Mr Zero, despite being heavily paid to assist in this operation, is giving you a look that clearly conveys his lack of interest in budging even one more item." The description of Mr Zero is "Many muscles, no hair."
 
The book box is a horribly heavy thing in the Living Room. The clothing box is a manageable thing in the Living Room. A broom, a dustpan, some packing tape, and a discarded newspaper are light things in the Living Room.
 
After taking a horribly heavy thing:
   say "Taken. (Oof.)"
 
Test me with "get clothing / look / get book box / look / i / drop book box / look".

wi 9.12 Actions as conditions
rb 5.5 Memory and Knowledge

360. Casino Banale ★★★

In a work of interactive fiction that involves many new discoveries, we might want to change the way we narrate room descriptions and describe objects as the player learns new information.

One approach to this is to create a model of the facts we want the player to find out, and attach some narrative text to each. When a fact becomes relevant to the story, that narrative text is shown to the player. So:

"Casino Banale"

Section 1 - Procedure

First we create the concept of facts, and the idea that facts can make some things more important than others.

A fact is a kind of thing. A fact can be known or unknown. A fact can be ready to learn or hidden. A fact has some text called the narration.
 
Definition: a thing is narratively significant if it conveys an interesting fact.
 
Definition: a thing is narratively dull if it is not narratively significant.
 
Conveyance relates various things to various facts. The verb to convey means the conveyance relation.
 
Definition: a fact is interesting if it is unknown and it is ready to learn.

Now, we also need a way to tell Inform to introduce certain new facts when the right previous ones have been introduced. We'll create a "following" relation, according to which a new fact can be told to the player when the player has already learned all the facts it follows. This way, we can simulate the effect of putting together several pieces of evidence to come to a conclusion:

Following relates various facts to various facts. The verb to follow means the following relation.
 
To say (new fact - a fact):
   say "[narration of the new fact]";
   now the new fact is known;
   repeat with possible outcome running through facts which follow the new fact:
      if every fact which is followed by possible outcome is known:
         now the possible outcome is ready to learn.

Next we need a way for the game to introduce these new facts. Let's say we want them to come up when the player examines something appropriate, or sees it in the room:

After examining something which conveys an interesting fact (called discovery):
   say "[discovery][paragraph break]".
 
After choosing notable locale objects:
   repeat through the Table of Locale Priorities:
      if the notable-object entry is narratively significant:
         set the locale priority of the notable-object entry to 1.
 
For writing a paragraph about a narratively significant thing (called item):
   now the item is mentioned;
   let chosen fact be a random interesting fact which is conveyed by the item;
   say "[chosen fact][paragraph break]".

The "after choosing notable locale objects" line here handles things so that any interesting conclusions we want to draw are always given first, followed by the less interesting description.

And finally, we need to give the player a little evidence to piece together:

Section 2 - Scenario
 
The Casino is a room.
 
Frince is a man in the Casino. The description is "Frince is a friend of yours -- if you reckon friendship on the same terms that one reckons a cat as a pet. He spends time with you when he wants to, but if your wishes or convenience ever run counter to a whim of his, it's the whim that wins. Always. [paragraph break]He's also wearing a somewhat ludicrous shirt."
 
Frince wears a ludicrous shirt. The description of the ludicrous shirt is "Fine white fabric with satiny white pinstripes: it's that expensive, effeminate look that Frince is so fond of, and which -- combined with his name -- gives people completely the wrong idea about him."
 
Tim is a man in the Casino. The description is "You don't know Tim well. Kind of wall-flowerish. The only thing that seems to excite him is craps."
 
Penny is a woman in the Casino. The description is "Loud. Brash. Hot, probably, if you can look past the loud and brash."
 
Rule for writing a paragraph about a narratively dull person:
   let is-are-n be "is";
   if the number of unmentioned narratively dull people is not 1:
      let is-are-n be "are";
   say "[A list of unmentioned narratively dull people] [is-are-n] [one of]watching the croupier[or]following the spin of the roulette[or]chattering[at random][one of] breathlessly[or] impatiently[or][at random]."
 
Penny-annoying is a fact.
   It is ready to learn.
   The narration is "[if looking]Penny grimaces at you-- [end if]Penny is the same woman who stepped on your toe in the buffet line. The third time, she blurted, 'You have big shoes, don't you?'"
   Penny conveys penny-annoying.
 
lipstick-smudges is a fact.
   It is ready to learn.
   The narration is "There are a couple of smudges of coral-colored lipstick on the collar."
   The ludicrous shirt conveys lipstick-smudges.
 
penny-wears-coral is a fact.
   It follows penny-annoying.
   The narration is "[if looking]Penny catches your eye again. [end if]The bright coral lipstick was really not a wise choice."
   Penny conveys penny-wears-coral.
 
Affair-with-penny is a fact.
   It follows lipstick-smudges and penny-wears-coral.
   The narration is "You avoid [if examining Frince]his[otherwise]Frince's[end if] eye. You need some time to adjust to the image of him making out with Penny in a storage closet before you can talk to him without appalled giggling."
   Frince conveys affair-with-Penny.
 
Test me with "x penny / x frince / x shirt / look".

wi 18.27 Choosing notable locale objects for something
rb 5.5 Memory and Knowledge

🔗

RB §5.6 Viewpoint

Inform automatically creates a character for the player - a bland, personality-free entity at the outset, as we've seen. But there is no reason why the player need stick to this same identity throughout the story. Conventional fiction often jumps from one viewpoint character to another, and so can IF.

To do this at the most elementary level, we simply at some point

now the player is Janine;

where Janine is a person we've already defined in the code. Now the player is in whatever location Janine inhabits, carries whatever Janine carries, and wears whatever Janine is wearing. Terror of the Sierra Madre ★★★ shows off this effect, and also demonstrates how to make the command prompt remind the player which character he currently controls. Some games instead give this information in the status line or after the name of the location when looking, producing output like

The Bottomless Acherousia (as Charon)

We could do the same by adding a line such as

After printing the name of a room while constructing the status line or looking:
   say "[roman type] (as [the player])"

Of course, we'll need a good deal of other work to make Janine a distinct person from whichever character the player was before. The distinction may come from changed capabilities of the new character, which we can express through new rules about actions; e.g.,

Instead of listening when the player is Janine:
   say "Your childhood accident left you unable to hear any but the loudest noises. Currently there is only silence."

Janine may also have new, different perspective on her surroundings, expressed through the descriptions of the things she looks at; Uncommon Ground ★★ makes a "by viewpoint" token for text alternatives, allowing us to tag our descriptions to indicate which variations should be shown to which viewpoint characters. The Crane's Leg ★★★ and Crane's Leg 2 ★ offer more elaborate and specialized ways of customizing the player character's observations to depend on how he relates (physically and in attitude) to the things around him.

If we want to change the tense and person of narration from the conventional present second person, we may do this as well:

When play begins:
   now the story viewpoint is first person plural;
   now the story tense is past tense.

Though this only changes the form of the text produced automatically by Inform (responses such as "you can't go that way" might become, say, "I couldn't go that way"), and all author-written text in the story must be written in the tense and person intended.

Examples

390. The Crane's Leg 2 ★

Names of rules can be listed in tables. This is convenient if, for instance, we decide that we'd like to swap the rules we use for a specific purpose, as in this continuation of our earlier example of automated description:

"The Crane's Leg, Grown Longer"

Material is a kind of value. The materials are wood, glass, stone, cloth, paper, clay, and metal. A thing has a material.

Color is a kind of value. The colors are red, orange, yellow, green, blue, indigo, violet, black, brown, and white. A thing has a color. A thing is usually white.

A height is a kind of value. 3 feet 11 inches specifies a height. A thing has a height. Definition: a thing is tall if its height is 6 feet 0 inches or more. Definition: a thing is short if its height is 2 feet 0 inches or less.

Imitation relates various things to one thing (called the ideal). The verb to imitate means the imitation relation.

A table is a kind of supporter. A table is usually wood. The height of a table is usually 3 feet 8 inches. The ordinary table is a table. Every table imitates the ordinary table.

A rock is a kind of thing. A rock is usually stone. The ordinary rock is a rock. The height of a rock is usually 0 feet 3 inches. Every rock imitates the ordinary rock.

The description of a thing is usually "[comparison with ideal][run paragraph on]".

To say comparison with ideal:

say "You observe [the noun]:[paragraph break]";

choose row with character of the player in Table of Descriptive Reporting;

follow instructions entry.

This is the comparative observation rule:

let the sample be the ideal of the noun;

if the sample is not a thing:

say "Nothing special, really.";

rule succeeds;

if the material of the noun is not the material of the sample:

if the height of the noun is not the height of the sample:

if the noun is shorter than the sample, say "Unusually short at [height of the noun], and made of [material of the noun].";

otherwise say "Unusually tall at [height of the noun], and made of [material of the noun].";

otherwise:

say "Distinct mostly in being made of [material of the noun].";

otherwise:

if the height of the noun is not the height of the sample:

if the noun is shorter than the sample, say "Unusually short at [height of the noun].";

otherwise say "Unusually tall at [height of the noun].";

otherwise:

say "In every respect [a sample]."

The Pleasure Garden is a room. "At the riverbank, a pleasing garden, having many curving paths and one straight."

The low table is a table in the Pleasure Garden. The height of the low table is 2 feet 3 inches. On the low table is a yellow metal rock called a gold nugget. A willow is in the Pleasure Garden. The height of the willow is 20 feet 2 inches.

Understand "possess [any person]" or "be [any person]" as possessing.

Possessing is an action applying to one thing. Carry out possessing: now the player is the noun; say "You swap bodies!"

The crane is a person in the Garden. The height of the crane is 4 feet 0 inches.

Table of Descriptive Reporting

character	instructions
yourself	comparative observation rule
crane	bird observation rule

This is the bird observation rule:

if the noun is shorter than the player, say "Small, like a duck[if the color of the noun is not white]; and [color of the noun][end if].";

otherwise say "Supremely tall[if the color of the noun is not white] and [color of the noun][end if]."

Test me with "examine table / examine nugget / examine willow / possess crane / examine table / examine nugget / examine willow".

wi 19.3 New rules
rb 5.6 Viewpoint

454. Uncommon Ground ★★

A slightly more challenging case than the "by atmosphere" example is one in which we want to create text variations depending on the identity of our player character.

What we want to do is build a switch statement in i6, one that looks something like

switch(player)
{
   yourself: print "quaint";
   Lolita: print "thrilling";
   default: print "squalid";
}

out of i7 that looks like this:

say "[show to yourself]quaint[to Lolita]thrilling[to everyone else]squalid[end show]".

"Uncommon Ground"

The Mud Village is a room. "You stand at the center of a [show to yourself]quaint[to Lolita]thrilling[to everyone else]squalid[end show] mud village."

Leforge is a man in the Mud Village. Lolita is a woman in the Mud Village.

Instead of waiting:

if the player is Lolita, now the player is Leforge;

if the player is yourself, now the player is Lolita;

say "You jump bodies. Whoops!"

To say show to (N - a person) -- beginning say_seen_by:

switch(player)

{-open-brace}

{N}:

-).

To say to (N - a person) -- continuing say_seen_by:

{N}:

-).

To say to everyone else -- continuing say_seen_by:

default:

To say end show -- ending say_seen_by:

{-close-brace}

Test me with "look / z / look / z / look".

wi 27.30 To say one of
rb 5.6 Viewpoint

52. The Crane's Leg 1 ★★★

When you see a long object, you don't have to think that it is too long if being long is the property given by the nature. It is proved by the fact that a duckling, having short legs, will cry if you try to draw them out by force, and that a crane, having long legs, will protest you with tears if you try to cut them with a knife. -- Zhuangzi

Suppose we have an extremely detailed world model in which every object is characterized by many features -- in this example, material and height, though one could add more. Suppose further that we would like to generate descriptions of these things automatically for the most part, drawing the player's attention only to those aspects of the object that are particularly interesting.

"The Crane's Leg"

Material is a kind of value. The materials are wood, glass, stone, cloth, paper, clay, and metal. A thing has a material.

So far, we have generally dealt with cases where the property of a thing can be a number (such as 3), a value (such as brightness), or a unit (like height, here). It is also possible for a thing to have a property which names another thing, as in "The mother of the baby trout is the large trout" -- where "mother" is a property, and its value, in the case of the baby trout, is large trout. We would define such a property with a line such as "A fish has a thing called the mother."

In practice, though, this is a bit confusing as syntax; moreover, Inform has a much more powerful construct for talking about the ways in which one object relates to another object. A full discussion of this will have to wait for the chapter on Relations. For now, it is enough to say that we can do this:

Imitation relates various things to one thing (called the ideal). The verb to imitate means the imitation relation.

This will allow us to declare that some objects imitate other objects, like so:

A chair is a kind of supporter. A chair is always enterable. A chair is usually wood. The height of a chair is usually 4 feet 0 inches. The ordinary chair is a chair. Every chair imitates the ordinary chair.
 
A table is a kind of supporter. A table is usually wood. The height of a table is usually 3 feet 8 inches. The ordinary table is a table. Every table imitates the ordinary table.
 
A rock is a kind of thing. A rock is usually stone. The ordinary rock is a rock. Every rock imitates the ordinary rock. The height of a rock is usually 0 feet 3 inches.
 
A jug is a kind of container. A jug is usually clay. The ordinary jug is a jug. Every jug imitates the ordinary jug. The height of a jug is usually 0 feet 8 inches.

Now each of these types has one ideal representative which has the fundamental attributes of its kind: the ordinary chair is the most chairlike chair imaginable, the ordinary table is the epitome of tableness, and so on. We are also allowed to refer to "the ideal of the chair", thanks to the way we defined imitation. (Again, the relations chapter offers a much more detailed explanation of how relations may be defined.)

The description of a thing is usually "[comparison with ideal][run paragraph on]".
 
To say comparison with ideal:
   let the sample be the ideal of the noun;
   if the sample is not a thing:
      say "Perfectly conforming to your expectations of its type.";
      rule succeeds;
   if the material of the noun is not the material of the sample:
      if the height of the noun is not the height of the sample:
         if the noun is shorter than the sample, say "Unusually short at [height of the noun], and made of [material of the noun].";
         otherwise say "Unusually tall at [height of the noun], and made of [material of the noun].";
      otherwise:
         say "Distinct mostly in being made of [material of the noun].";
   otherwise:
      if the height of the noun is not the height of the sample:
         if the noun is shorter than the sample, say "Unusually short at [height of the noun].";
         otherwise say "Unusually tall at [height of the noun].";
      otherwise:
         say "In every respect [a sample]."
 
The Pleasure Garden is a room. "At the riverbank, a pleasing garden, having many curving paths and one straight."
 
The low table is a table in the Pleasure Garden. The height of the low table is 2 feet 3 inches. On the low table is a metal rock called a gold nugget.
 
Test me with "x table / x nugget".

So far the effect is not very deep, but we could take the auto-description a great deal further: providing a larger and more interesting set of variations; or writing a complicated set of rules such that the player only notices height variations when carrying a ruler; or switching between several player-characters, each of whom notices a different subset of characteristics. But these refinements would require more input from later chapters.

wi 4.9 Using new kinds of value in properties
rb 5.6 Viewpoint

121. Terror of the Sierra Madre ★★★

Suppose we have a game where we want the player to control two different characters, swapping bodies from one turn to the next. First, the setting, and the two people who will alternately play:

"Terror of the Sierra Madre"

The Hay-Strewn Corridor is a room. "[if the player is Maleska]The horse stalls are empty: you have already drained the animals, and carried off their corpses. The house will not long sustain you now.

The window throws on the floor a bright square of malevolent sunlight[otherwise]The stalls for horses run down one side of the room, but the house has long stood empty. A square window without shutters looks out over the ranch, away toward the Sierras[end if]."

Teresa is a woman in the Hay-Strewn Corridor. "Teresa stands opposite you[if Teresa carries something], her fingers wrapped tightly around [a list of things carried by Teresa][end if]." Teresa carries a bulb of garlic and a cross.

Maleska is a man in the Hay-Strewn Corridor. "Maleska watches you from eyes entirely black." Maleska carries a skull.

If we tried the text above in Inform, we would find ourselves in the Hay-Strewn Corridor and confronted by both Teresa and Maleska. If "player" is not set to any named person, Inform creates a bland person called "yourself" to represent the player. To avoid this, we set "player" to the person we want to begin as. The player character is normally privately-named, so we'll need to make sure "Maleska" still means what it should.

The player is Maleska. Understand "Maleska" as Maleska.

Now the Corridor contains just two people, and we arrive on the scene as Maleska, with only Teresa facing us.

At the end of every turn we will use the 'now the player is…' phrase. (This looks as if it simply changes the value of "player": which it does, but it also carries out a complicated operation behind the scenes to effect the switch.)

Every turn:
   if the player is Maleska, now the player is Teresa;
   otherwise now the player is Maleska.

Our two characters already see the Corridor differently, but let's differentiate them further:

Every person has a number called strength. The strength of Teresa is 3. The strength of Maleska is 5.

In this small example, strength is not used for anything, except that we will display it on the status line:

When play begins:
   now the command prompt is "[bold type][player][roman type] > ";
   now the left hand status line is "[player]";
   now the right hand status line is "STR: [strength of the player]".

That last rule doesn't quite do what we might have expected. When we print "[player]", we find that Inform usually prints "yourself". This is because Inform says "you" to mean Teresa when talking to the player-being-Teresa, and likewise for Maleska. We want to override that in this particular story, because the rapid switches of personality are otherwise hard to follow. So:

Rule for printing the name of Teresa: say "Teresa".
 
Rule for printing the name of Maleska: say "Maleska".
 
Test me with "look / look".

wi 8.9 Moving the player
rb 5.6 Viewpoint

§6.

Designing New Commands

§6.

Writing New Commands

§6.

Modifying Existing Commands

§6.

Looking

§6.

Examining

§6.

Looking Under and Hiding

§6.

Inventory

§6.

Taking, Dropping, Inserting and Putting

§6.

Going, Pushing Things in Directions

§6.

Entering and Exiting, Sitting and Standing

§6.

Waiting, Sleeping

§6.

Other Built-In Actions

§6.

Magic Words

§6.

Remembering, Converting and Combining Actions

§6.

Actions on Multiple Objects

§6.

Alternate Default Messages

§6.

Clarification and Correction

§6.

Alternatives To Standard Parsing

🔗

RB §6.1 Designing New Commands

Quite a bit of interactive fiction design involves the creation of custom commands to expand on the library's existing set. There is more to know than we can review in this section; instead, this is to serve as an overview of the process, with hints about where in Writing with Inform we might find more technical details.

Before we even start to write our source text, we should think about the following things:

(1) What words will the player use to make this new action happen?
(2) What will the action change about the world model?
(3) What circumstances might make the new action go wrong or produce silly outcomes?

To take these one one by one:

(1) We may have a general idea of the phrasing we want the player to use -- say we want to add an SHOOT command which allows the player to fire a gun at something. (This is an intentionally tricky choice of verb, because it shows off so many possibilities.) So we might decide the base form of the action will be

SHOOT THE PISTOL AT HENRY

So now we're going to need an action that applies to two objects -- the pistol as the noun, and Henry as the second noun. The problem is, though, that there are lots of other ways that the player could reasonably formulate the command, some of which leave out information:

SHOOT HENRY
SHOOT PISTOL
FIRE PISTOL
SHOOT AT HENRY
SHOOT AT HENRY WITH GUN

To avoid frustrating the player, we should make a guess about what the player means whenever we're sure that guess will be reliable (we might, for instance, have only one gun in the story, so we know that SHOOT HENRY will always mean SHOOT HENRY WITH PISTOL), but ask the player for clarification whenever there might be ambiguity (SHOOT PISTOL gives no clue about the target, nor can we safely guess, so we want Inform to ask "What do you want to shoot the pistol at?"). The next section goes into more detail about how to handle these variations.

Conversely, there are cases where the player is offering too much information for the command we've defined - say we have a BURN command which doesn't look for a specified fire source, but the player is trying to BURN BOX WITH MATCH. We probably don't want to throw away the extraneous information as though it had never been typed, because the player might have typed something quite specific. BURN BOX WITH ACID, say, should not be cavalierly reinterpreted as BURN BOX (with a fire source). Instead, we want to give the player a bit of gentle guidance, perhaps using "Understand as a mistake", as in

Understand "burn [something] with [text]" as a mistake ("Your choice of lighter isn't important in this story: BURN SOMETHING will suffice.")

Finally, there are some cases where we want to understand a phrase to mean a specific form of a more general action. For instance, we might want TURN DOWN THE MUSIC to mean the same thing as SET VOLUME KNOB TO 1. In this case, we may want to make a sort of dummy action which converts into the main action, as in

Understand "turn down volume" or "turn down music" or "turn down the volume" or "turn down the music" as lowering the volume. Lowering the volume is an action applying to nothing.
 
Instead of lowering the volume, try setting the volume knob to 1.

More about this can be found later in this chapter, under Remembering, Converting and Combining Actions.

Sometimes these kinds of details can be caught in play-testing, but it's a good idea to think about them specifically and in advance rather than leaving them to our beta-testers to sort out.

(2) To generalize very broadly, there are two possible kinds of command in IF: those that only exist to give the player new information (like EXAMINE, INVENTORY, LOOK, TASTE), and those that change the world model (like TAKE FISH, OPEN DOOR, UNLOCK GATE WITH BLUE KEY). The Inform library has some commands that really do none of these things by default - commands like JUMP that do nothing interesting at all most of the time - but those exist as hooks, in case there is ever something important for them to do.

Commands that ask for information are usually easier to implement. Very often we're looking to offer the player a new kind of information about specific objects, and these can be handled by adding new text properties, as in

A thing has some text called the sacred emanation.
 
Carry out perceiving something:
   say "[sacred emanation of the noun][paragraph break]".

Commands that affect the world model, on the other hand, can range from simple to very complex indeed. Sometimes we need to do nothing more than add an attribute to an object, like

A thing can be folded or flat. A thing is usually flat.

so that our FOLD command can change the object into its folded form. At other times, we need quite intricate rules to account for a subtle multi-stage process - how fire is burning and spreading to objects, say, or how a conversation is progressing. Other parts of the Recipe Book offer solutions to some of these challenges.

(Strictly, we might count a third kind of command: the kind that controls the story itself. The Advanced Actions chapter discusses how to add actions out of world, as these are called, but the difficult ones are already built into Inform - saving, restoring, restarting, undoing a turn, and so on. Mostly when we need to add new actions out of world, they will be help or hint systems of some kind. More about these can be found in the Helping and Hinting section of the Recipe Book, under Out of World Actions and Effects.)

(3) Most commands that change the world require certain preconditions: the player needs to be holding the gun before he can fire it; the gun must be loaded with ammunition; if we're being especially detailed in our simulation, the safety must be off.

Often, there are also subtler details about how the command should interact with special items. For any new command we create, it's worth asking: should anything special happen if the player performs this action…

On himself?
On another living character?
On an object he (or another character) is carrying or wearing?
On an object he (or another character) is inside or on?
On a door?
On an object that is impossible to move (defined as "scenery" or "fixed in place")?
On an intangible object (such as a beam of sunlight)?
On an object far away (such as the sun)?
On an object that is part of something else (such as a doorknob)?
On an object that itself has parts (such as a desk with drawers)?
If there are two objects required by the action, can both the noun and the second noun be the same thing?

For instance, we might have written code so that if the gun is fired at anything but a person or a fragile object, the default response is "The bullet bounces harmlessly off [the second noun]." Our checklist would remind us to write special cases to prevent

SHOOT GUN AT MY SHOE (while he's wearing it)
SHOOT GUN AT ME
SHOOT GUN AT GUN

and so on. Actions that destroy objects are especially tricky, because there are many things that aren't safe to destroy without carefully adjusting the world model. (What happens if we burn a door connecting two rooms? a wooden desk with a drawer containing an asbestos vest? the armchair Cousin Fred is sitting on?)

🔗

RB §6.2 Writing New Commands

Once we've considered all the design issues pertaining to a new action, we're ready to start writing the source text. First we need to give the player a way to issue the command:

Understand "smile" as smiling.
Understand "fold [something]" as folding.
Understand "shoot [something preferably held] at [something]" as shooting it with.
Understand "wrap [something preferably held] in [something preferably held]" as wrapping it in.

(Note how "it" stands in for the first item when we have an action requiring two objects.) The things that go in square brackets are called "tokens": they are blank spaces for the player to fill in with story objects. The different kinds of tokens are explained in the chapter on Understanding.

We can add synonyms with

Understand the command "grin" as "smile".

and we can create reversed versions of commands with

Understand "shoot [something] with [something preferably held]" as shooting it with (with nouns reversed).

These variations are also covered in the Understanding chapter. If the action needs to work on things that aren't within the player's sight or reach in the normal way, we may need to use an [any thing] token (see the Understanding chapter), as in

Understand "contemplate [any thing]" as considering.

We may also need to modify reach or light levels (see Changing reachability and Changing visibility in the Advanced Actions chapter), or rely on the Deciding the scope of… activity.

As for guessing the player's intention when he isn't clear, we may want to consult the Does the player mean rules (to help Inform make guesses between multiple possible targets) and the activities Supplying a missing noun and Supplying a missing second noun (to help Inform guess an appropriate item when the player leaves something entirely out of his command). For instance, if the player typed SHOOT HENRY, it is the supplying a missing noun/second noun activity that would allow us to make Inform draw the obvious conclusion that he shoots Henry with the pistol in his hand. The Does the player mean rules are discussed in the chapter on Advanced Actions; the activities in the Activities chapter.

Next we need to define our new action, as in

Smiling is an action applying to nothing.
Folding is an action applying to one thing.
Wrapping it in is an action applying to two carried things.

In cases where we're using an "[any thing]" token to let the player affect objects that aren't normally visible or reachable, we'll need to define the action to apply to visible objects. This tells Inform that the player doesn't have to be able to touch the object for it to work. So for instance

Considering is an action applying to one visible thing.

For more on this topic, see Visible vs. touchable vs. carried in the Advanced Actions chapter.

The next step is to create rules for Inform to follow when the action happens. These can be check rules (which make sure that the conditions for the action to occur are fulfilled); carry out rules (which perform the action); and report rules (which describe the results of the action to the player). Any new action should have at least a report rule to let the player know what has happened (if anything), and a carry out rule if there are any ramifications for the world model. For instance:

Carry out folding:
   now the noun is swan-like.
 
Report folding:
   say "You deftly fold [the noun] into the shape of a swan."

It's important to remember that report rules may be describing something whose name is plural, such as papers or shoes, and write our text so that it sounds right either way; see the chapter on Adaptive Text and Responses.

More about defining actions and creating carry out and report rules may be found in the chapter on Advanced Actions.

Meanwhile, the check rules give us a chance to provide sensible restrictions on how the command works, as in

Check folding:
   if the noun is not a napkin:
      say "[The noun] won't bend." instead.
 
Check shooting something with the noun:
   say "[The noun] is incapable of aiming at itself." instead.
 
Check burning something which contains the player:
   say "You're not quite desperate enough to make a funeral pyre for yourself just yet." instead.

The chapter on Advanced Actions explains how check rules work. In the special case where we want the player to take things automatically before using them, we may want to define the action to work only on carried objects, as in

Wrapping it in is an action applying to two carried things.

The activity Implicitly taking something (documented in the Activities chapter) allows us to modify what should happen during this process.

Lastly, a word or two about trouble-shooting. If a newly created command seems not to be working, we can discover what action Inform is really generating with the ACTIONS testing command, as in

>actions
Actions listing on.
 
>i
[taking inventory]
You are carrying nothing.
 
[taking inventory - succeeded]

If the desired command is not happening, we may need to review our understand lines. A common problem is that our new action conflicts with one already defined by default. In that case, we may want to check the Actions index and see whether there are already-defined actions which might conflict with it. If so, we may need to redefine a command with a line like

Understand the command "stand" as something new.

If that's not enough, we can get a comprehensive view of everything that happens during an action with RULES: this will list all the check, carry out, and report rules that Inform is using to perform the command.

RB §6.3 Modifying Existing Commands

Much of the rest of this chapter discusses the behavior of specific commands in Inform's command library, and how we might change and build on these. This section is instead an overview of the general principles: where and how can one intervene?

Whenever we are dealing with actions, the Actions Index is likely to be useful: it lists all the actions currently implemented, whether in our own source or in extensions or the Standard Rules, and lists the rules pertaining to each.

The lightest and easiest way to change behavior is with an Instead rule:

Instead of eating the apple:
   say "It turns out to be made of beeswax, so that's a non-starter."
 
Instead of tasting an edible thing:
   say "It's delicious!"
   rule succeeds.

The addition of "rule succeeds" tells Inform that the instead action was a success rather than a failure; this is not usually very important with the player's own actions, but can be useful for actions performed by other characters, so that a successfully replaced action is not followed by the disconcerting line

Clark is unable to do that.

Before and After offer alternative easy forms of modification; the Basic Actions chapter explains all three.

Changing the way an action works in all cases is usually better addressed by changing the main rulebook, rather than with one (or many) instead rules. We may add new check, carry out, and report rules to existing action rulebooks. The Advanced Actions chapter describes these, and ends with some guidelines on when to use before, instead, and after, and when to use check, carry out, and report.

Similarly, we may delete, move, or replace rules that are already present (see the chapter on Rulebooks). This is handy if we decide that an action has restrictions that we dislike and want to abolish. If the restriction we need to change is part of the accessibility rules - those which check whether the player can take, see, and touch items - we may need to look at Changing reachability or Changing visibility in the Advanced Actions chapter (to revise what is allowed), at Deciding the scope of something in the Activities chapter (to influence what can be seen when).

If, for instance, the player character is a burly fellow who can lift any other character he likes:

The can't take other people rule is not listed in any rulebook.

…and rip knobs off doors:

The can't take component parts rule is not listed in the check taking rulebook.

…and commit petty theft:

The new can't take people's possessions rule is listed instead of the can't take people's possessions rule in the check taking rulebook.
 
This is the new can't take people's possessions rule:
   if someone (called the owner) carries the noun:
      say "(first waiting until [the owner] is distracted)";

The right approach to use also depends a bit on how systematic a change we anticipate. We may find that instead rules become cumbersome when we want to specify behavior for a very large number of objects. It's fine to have

Instead of tasting the arsenic:
   say "You'll live to regret this very very shortly.";
   end the story.

but a bit more tedious to have to write

Instead of tasting the peppermint: ...
Instead of tasting the plate: ...
Instead of tasting the banister: ...
Instead of tasting the donkey: ...
(etc.)

in a story in which most items have unique flavor descriptions. In that situation, it may be more sensible to overhaul the design of the action: create a new text property for things, and revise "tasting" so that it now consults this property:

The block tasting rule is not listed in any rulebook.
 
A thing has some text called the flavor. The flavor of a thing is usually "Nothing special."
 
Report tasting something:
   if the flavor of the noun is "Nothing special.":
      say "You taste nothing unexpected." instead;
   otherwise:
      say "[the flavor of the noun][paragraph break]" instead.
 
Report someone tasting something:
   say "[The actor] licks [the noun]."

Finally and most sweepingly, we can rip out whole passages of the Standard Rules and replace them - or not. This is a drastic measure and rarely necessary (or so we hope); but see the Extensions chapter for ways to replace sections of existing source, or even revise the Inform 6 template files on which Inform depends. By these means almost anything can be changed. We can throw out a whole range of existing commands and start from scratch, for instance, if we want Inform to know about a completely new and different command set.

Example

214. Slogar's Revenge ★★★

Under most circumstances, locking and unlocking require the player to be carrying the key he uses to unlock something. This makes sense -- unless the key is on a keychain, or on a chain around his neck, for instance. So here we explore one way to circumstantially override the carrying requirements, while still making sure that the player cannot unlock the door if the unlocking tool is nowhere in sight.

In essence, we are rewriting the carrying requirements rule with a different one of our own devising, and swapping it in only at those moments when it is correct to do so.

"Slogar's Revenge"

Section 1 - Procedure

The amulet carrying rule substitutes for the carrying requirements rule when locking something with the Amulet of Tumblers.

The amulet carrying rule substitutes for the carrying requirements rule when unlocking something with the Amulet of Tumblers.

We can now replace the usual behavior of the carrying requirements rule (to check whether the player is carrying something and, if not, to generate an implicit take) with a similar rule of our own; note that "if the player has the second noun" is a more compact way to write "if the player carries the second noun or the player wears the second noun":

This is the amulet carrying rule:
   if the player has the second noun:
      continue the action;
   say "(first picking up the amulet)[command clarification break]";
   try silently taking the second noun;
   if the player is not carrying the second noun:
      stop the action;
 
Section 2 - Scenario
 
The Daunting Dungeon is a room.
 
West of the Daunting Dungeon is the Disturbing Door. The Disturbing Door is a door. West of the Disturbing Door is the Fallow Field.
 
The Disturbing Door is closed and locked.
 
The player wears the Amulet of Tumblers. The Amulet of Tumblers unlocks the Disturbing Door.
 
Test me with "unlock disturbing door with amulet / open door / west / remove amulet / close door / lock disturbing door with amulet / drop amulet / unlock disturbing door with amulet".

For a more systematic handling of the keychain problem (and a number of other refinements to the behavior of doors), see the Locksmith extension included with Inform.

wi 12.17 Visible vs touchable vs carried
rb 6.3 Modifying Existing Commands

🔗

RB §6.4 Looking

Looking is quite a complicated command, since the production of a room description takes many steps. A detailed description of this process may be found in the Room Descriptions section.

By convention, a player sees full descriptions of rooms he enters more than once, but may type BRIEF in order to see shorter descriptions, and SUPERBRIEF tells the story never to print room descriptions at all. VERBOSE restores the default behavior.

These conventions are not always appropriate, however, especially in works where experiencing a changing environment is essential. The use option

Use brief room descriptions.

changes the default behavior so that rooms are not always described fully to the player. Verbosity ★ demonstrates how this works.

The player always has the option of turning room descriptions to BRIEF or SUPERBRIEF mode. Verbosity 2 ★ demonstrates how we might remove the player's ability to change the default behavior.

Examples

3. Verbosity 1 ★

By default, the description of a room is printed every time the player enters a room.

On a device with very limited screen space, however, we might wish to supplant that behavior with "brief" descriptions. In Brief mode, Inform prints room descriptions only when the player enters that room for the first time. Afterwards, the text is skipped, for brevity, though the player can see it again at any time by typing LOOK.

As we saw in the previous chapter, we can set "use options" to control certain aspects of the player's experience. One of the use options is the option to

Use brief room descriptions.

which changes the defaults so that the description of a room is printed only the first time the player enters.

"Verbosity"

Use brief room descriptions.

The Wilkie Memorial Research Wing is a room. "The research wing was built onto the science building in 1967, when the college's finances were good but its aesthetic standards at a local minimum. A dull brown corridor recedes both north and south; drab olive doors open onto the laboratories of individual faculty members. The twitchy fluorescent lighting makes the whole thing flicker, as though it might wink out of existence at any moment.

The Men's Restroom is immediately west of this point."

The Men's Restroom is west of the Research Wing. "Well, yes, you really shouldn't be in here. But the nearest women's room is on the other side of the building, and at this hour you have the labs mostly to yourself. All the same, you try not to read any of the things scrawled over the urinals which might have been intended in confidence."

Test me with "west / east".

If we type "test me" during play, these commands will be carried out automatically, and we can see that when we return to the Research Wing, the description is not given a second time.

Some notes: the player can also turn full-length descriptions on or off with the commands "verbose" and "brief", or set a minimal-description setting with the command "superbrief". This power still belongs to the player even if we have set the use option to show brief room descriptions by default.

Moreover, we can ourselves check what the state of the descriptions is, with

if set to sometimes abbreviated room descriptions: ...
if set to unabbreviated room descriptions: ...
if set to abbreviated room descriptions: ...

Finally, it is possible to exercise more precise control over what the player sees on his first and subsequent visits to a room; see the next example for details.

wi 3.1 Descriptions
rb 6.4 Looking

395. Verbosity 2 ★

Suppose that we want the player always to see full room descriptions, even if he tries to reset the defaults -- perhaps because there is vital information there which he will miss if he turns off full-length room descriptions.

To do this, we might want to remove the standard behavior of the three actions associated with BRIEF, SUPERBRIEF, and VERBOSE, replacing them with explanatory messages about how the game behaves. We cannot use Instead to override these actions, because Instead rules do not apply to actions out of world. Instead, we will want to remove and replace the carry out rules.

We can do this easily by going to the Actions Index, looking up the detail panel for, say, "preferring abbreviated room descriptions", and click the "unlist" button to paste in the sentence that will remove this rule from the rulebook.

Let's remove all three of the carry out rules and substitute our own:

"Verbosity 2"

Section 1 - Procedure

The prefer unabbreviated room descriptions rule is not listed in the carry out preferring unabbreviated room descriptions rulebook.

The prefer sometimes abbreviated room descriptions rule is not listed in the carry out preferring sometimes abbreviated room descriptions rulebook.

The prefer abbreviated room descriptions rule is not listed in the carry out preferring abbreviated room descriptions rulebook.

Carry out preferring unabbreviated room descriptions:

say "[story title] always provides full-length descriptions for your reading pleasure."

Carry out preferring sometimes abbreviated room descriptions:

say "For your playing protection, [story title] provides only full-length room descriptions."

Carry out preferring abbreviated room descriptions:

try preferring sometimes abbreviated room descriptions instead.

The standard report preferring abbreviated room descriptions rule is not listed in the report preferring abbreviated room descriptions rulebook.

The standard report preferring unabbreviated room descriptions rule is not listed in the report preferring unabbreviated room descriptions rulebook.

The standard report preferring sometimes abbreviated room descriptions rule is not listed in the report preferring sometimes abbreviated room descriptions rulebook.

Use full-length room descriptions.

Section 2 - Scenario

The Men's Restroom is immediately west of this point."

Test me with "west / east / brief / w / e / superbrief / w / e / verbose".

wi 19.4 Listing rules explicitly
rb 6.4 Looking

🔗

RB §6.5 Examining

By default, examining an object shows its description, and - for devices - tells us whether the object is switched on or switched off.

This kind of additional information is not always what we want, so if we have a device whose on/off status we want to conceal, we may write

The examine devices rule is not listed in any rulebook.

On the other hand, there are times when we may want to add a similar line or two to the descriptions of other kinds of objects. Crusoe ★★★ allows us to append an "It is charred." sentence to the end of descriptions of things we have burned in the fire. Since it works by introducing a "printing the description" activity, Crusoe is also a good example to start from if we want to introduce more complex, flexible descriptions of items throughout our story.

Odin ★ rewrites the "You see nothing special…" line with other text of our own, for items that otherwise do not have a description.

Finally, we may want to look at multiple things at once. The Left Hand of Autumn ★★★ demonstrates how we might provide a different response for EXAMINE PAINTINGS than for examining each individually; Beekeeper's Apprentice ★★ provides a SEARCH command that will show the descriptions of all the scenery in the current location.

Examples

44. Odin ★

In recent years there has been a strong trend towards providing unique descriptions for all implemented objects. Often this is a good idea, but there are also contexts in which we may want to discourage the player from looking too closely at some things and concentrate his attention on just a few interesting ones.

The trick here is that leaving items completely undescribed leads to rather dull exchanges like this:

>x table
You see nothing special about the table.

…which can leave the player with the impression that the author was simply too lazy to describe everything. So it can be a good idea to replace that default message with a different one more appropriate to the game. For instance:

"Odin"

The House of a Mortal Farmer is a room. "Having two separate rooms, this house testifies to considerable wealth and success at agriculture."

The Bedroom is inside from the House.

A chair is a kind of supporter. A chair is always enterable.

In the House are a table, two chairs, a basket, and a hearth. On the table is a loaf of bread.

The description of a thing is usually "You give [the noun] a glance, but it is plainly beneath your attention."

Because the description is attached to a whole kind ("thing"), it is really a blanket instruction about many objects at once. More specific instructions always override less specific ones, so we can easily make exceptions. For instance, the following will work correctly:

The infant is a man in the basket. The description of the infant is "So strong and fat that you wonder whether one of your fellow gods is acquainted with the mistress of the house-- but it's no concern of yours, of course."
 
Test me with "x table / x chair / x infant".

wi 4.3 Degrees of certainty
rb 6.5 Examining

68. Beekeeper's Apprentice ★★

We have to create a suitable action and say what it does, and to repeat what we do through all the scenery items. That needs material from subsequent chapters, but is quite ordinary Inform all the same:

"Beekeeper's Apprentice"

Studying the vicinity is an action applying to nothing.

Report studying the vicinity:

if the location does not contain something which is scenery:

say "There's little of interest in the [location]." instead;

repeat with point of interest running through scenery in the location:

say "[point of interest]: [run paragraph on]";

try examining the point of interest.

Understand "search" as studying the vicinity.

The Yard is a room.

The hive and the honey are scenery things in the Yard. The description of the hive is "The honeycombed hive is all around you, thrumming with life." The description of the honey is "Wax-sealed honey has been cached in many of the hexagonal nurseries."

Test me with "search".

The reason for this example is to show the use of saying "[run paragraph on]". It means we have output such as:

>search
hive: The honeycombed hive is all around you, thrumming with life.
 
honey: Wax-sealed honey has been cached in many of the hexagonal nurseries.

Without the running on, the prompts "hive:" and "honey:" would be separated from the descriptions following them, which would look a little odd.

wi 5.8 Line breaks and paragraph breaks
rb 6.5 Examining

295. The Left Hand of Autumn ★★★

Suppose that we have a game in which groups of objects can have meaning apart from their individual significance -- perhaps there are spells that can only be cast by collecting just the right items in the same place.

In this case, one of the things the player might like to be able to do is look at several items together and get a special response, different from looking at the items individually.

To make this happen, we need to do several things:

(1) we need to create a version of the EXAMINE command that can apply to multiple objects at once.

(2) we need to correct the way Inform normally deals with multiple-object commands, because we want our group description to print only one time, and we want to avoid stubs such as "pear: ... apple: ..." before or after the group description.

(3) we need to define a way for Inform to identify interesting groups and describe them.

"The Left Hand of Autumn"

Section 1 - Procedure

Understand "examine [things]" or "look at [things]" as multiply-examining. Multiply-examining is an action applying to one thing.

Understand "examine [things inside] in/on [something]" or "look at [things inside] in/on [something]" as multiply-examining it from. Multiply-examining it from is an action applying to two things.

Group-description-complete is a truth state that varies.

Carry out multiply-examining it from:

try multiply-examining the noun instead.

Check multiply-examining when group-description-complete is true:

stop the action.

Carry out multiply-examining:

let L be the list of matched things;

if the number of entries in L is 0, try examining the noun instead;

if the number of entries in L is 1, try examining entry 1 of L instead;

describe L;

say line break;

now group-description-complete is true.

Before reading a command:

now group-description-complete is false.

Now for step 2, overriding Inform's usual output of names of objects:

The silently announce items from multiple object lists rule is listed instead of the announce items from multiple object lists rule in the action-processing rules.
 
This is the silently announce items from multiple object lists rule:
   unless multiply-examining or multiply-examining something from something:
      if the current item from the multiple object list is not nothing, say "[current item from the multiple object list]: [run paragraph on]".
 
Definition: a thing is matched if it is listed in the multiple object list.

We'll save our "to describe" phrase until Section 2, when we can give the game specific instructions about how to report different lists of objects.

Now, the player might also want to be able to refer to a group of item by some kind of group name, so let's add the option of creating a Table of Collective Names which will interpret these:

After reading a command:
   repeat through the Table of Collective Names:
      let N be "[the player's command]";
      let Y be relevant list entry;
      while N matches the regular expression "[name-text entry]":
         replace the regular expression "(.*)[name-text entry](.*)" in N with "\1[Y]\2";
      change the text of the player's command to N.
 
 
Report taking something:
   say "You pick up [the noun]." instead.

And as a bit of polish, because we'd like SEARCH TABLE to have the same effect as EXAMINE ALL ON TABLE:

Understand "look on [something]" as searching.
 
Instead of searching something which supports at least two things:
   let L be the list of things supported by the noun;
   describe L.
Instead of searching something which contains at least two things:
   let L be the list of things contained by the noun;
   describe L.
 
Section 2 - Scenario
 
Eight-Walled Chamber is a room. "A perfectly octagonal room whose walls are tinted in various hues."
 
The display table is a supporter in the Chamber. A twig of rowan wood is on the table.
 
The player carries an apple and a pear.
 
A glove is a kind of thing. A glove is always wearable. Understand "glove" as a glove. The player carries a left glove and a right glove. The left glove and the right glove are gloves.

Now we define a few actual lists of items:

Fruit list is a list of objects which varies. Fruit list is { apple, pear }.
Glove list is a list of objects which varies. Glove list is { right glove, left glove }.
Arcane list is a list of objects which varies. Arcane list is { left glove, twig, pear }.
 
To describe (L - a list of objects):
   sort L;
   if L is fruit list:
      say "Just a couple of fruits.";
   otherwise if L is glove list:
      say "It's a matched pair of fuzzy blue gloves.";
   otherwise if L is arcane list:
      say "To anyone else it might look like a random collection of objects, but these three things -- [L with definite articles] -- constitute a mystic key known as the Left Hand of Autumn. They practically hum with power.";
   otherwise:
      say "You see [L with indefinite articles]."
 
When play begins:
   sort fruit list;
   sort glove list;
   sort the arcane list.

We sort the lists so that regardless of how we change the rest of the code (and the order in which objects are coded), the resulting list will always be in sorted order and ready to compare with the list of items the player wants to look at. And thanks to the "Reading a command" code we wrote earlier, we can also teach the game to understand the player's references to "the left hand of autumn" as a specific collection of items.

Table of Collective Names

name-textrelevant list
"left hand of autumn""[arcane list]"
"gloves""[glove list]"
"pair of gloves""[glove list]"
 
Test me with "x apple and pear / x left and right / put pear on table / put left glove on table / x all on table / put all on table / examine all on table / get apple, twig, pear / x all on table / search table".

wi 17.4 Standard tokens of grammar
rb 6.5 Examining

337. Crusoe ★★★

Suppose we want to add rules so that any time we examine a charred object (and most of our objects can be charred), a line about the charring is appended to the end of the object description. We could use "after examining…", but perhaps we would prefer for the sentence about the charring not to appear in its own paragraph.

This is an ideal occasion for a new activity. We look at the action index for "examining" to identify the rule that causes the old behavior (in this case, the "standard examining rule"); replace this with a new rule that calls our activity; and write our "printing the description" activity in such a way that it uses an object's description without forcing a paragraph return afterward.

Then we will use "after printing the description" to add our line about charring, and make sure that the paragraph return does occur before the prompt.

So:

"Crusoe"

Section 1 - Creating our New Activity

The fancy examining rule is listed instead of the standard examining rule in the carry out examining rules.

This instruction replaces a normal piece of the examine action, the standard examining rule, with another one of our own devising. (The replacement of the standard examining rule will be explained in more detail in the chapter on rulebooks.)

Printing the description of something is an activity.
 
This is the fancy examining rule:
   carry out the printing the description activity with the noun;
   rule succeeds.

All we have done here is enclose what is usually just a rule inside an activity. This means that we can now write before and after rules for the activity, and also add special instructions like "Rule for printing the name of something while printing the description of something" -- this may not be likely to arise often, but Inform now has the concept of "printing the description of something" as a separate context of action. Next we add the modification that lets us append to the description without a new line:

Rule for printing the description of something (called item):
   if the description of the item is not "":
      say "[description of item] [run paragraph on]";
   otherwise:
      say "You see nothing special about [the item]. [run paragraph on]".

"run paragraph on" here will mean that we do not get a paragraph break following the description, even if it ends with a period. We also insert a space, so that our follow-on comments will be properly punctuated.

After printing the description of something charred:
   say "It is charred." instead.

The instead at the end of this line stops Inform for going on with any other "after printing the description of…" rules.

The standard library also has rules for printing additional text about containers and supporters with visible contents, and devices that are switched on; with this current system, we could add those as "after printing the description" rules as well, building up a complete paragraph if we wanted. But for simplicity we won't exemplify all of that here. The effects would be much the same as with the "charred" line.

Now, because we want to make sure that we always do get a paragraph break after our description, we add this rule last after all the other rules. "Last" and "first" rules are covered in more detail in the chapter on rulebooks.

Last after printing the description of something:
   say paragraph break.
 
Section 2 - The Scenario
 
The Desert Isle is a room. "A pale expanse of sand, here and there developing into hillocks of grass, and a small clump of palms. The water is shallow here, and there are other islands within swimming distance -- or even wading distance, perhaps -- but none of them is any larger than your island, so it doesn't seem worth the trouble of visiting.
 
A few hundred feet out, the water turns darker blue, the sea floor drops away, and there is nothing to be seen all the way down to the horizon, except a couple of fluffy clouds, and an occasional bird.
 
The remains of your fire smolder in the stone-lined pit."
 
A thing can be charred or whole. A thing is usually whole. Instead of burning something: say "You hold [the noun] to the fire until it flares and chars."; now the noun is charred.
 
The player carries a stick. The description of the stick is "A strip of palm from the woodiest part of the leaf, about a foot and a half long."
 
The player carries a glass bottle and a piece of paper. The description of the paper is "A single blank sheet." In the glass bottle is a grain of sand. The glass bottle is openable and open. Instead of burning the glass bottle: say "You hold the bottle to the flame, but it grows uncomfortably warm."
 
Instead of burning the grain of sand: say "You drop the grain into the fire pit, where it becomes indistinguishable from all the others."; now the grain of sand is nowhere. Instead of dropping the grain of sand: now the grain of sand is nowhere; say "You return the grain of sand to its brethren."

The player's description is handled in an unusual way, and this will produce a space paragraph break there where it should not. Instead, therefore, we will add an instead for examining the player (probably a good idea anyway):

Instead of examining the player:
   say "You are sunburned and there is sand in cracks you didn't know existed."
 
Test me with "i / x stick / x bottle / x sand / x paper / x me / burn stick / x stick / burn paper / x paper".

The "printing a description" activity may be useful for other games, and can be imported just by lifting section 1.

wi 18.5 New activities
rb 6.5 Examining

🔗

RB §6.6 Looking Under and Hiding

Finding hidden objects is a classic puzzle in IF. Beachfront ★ provides the most basic example, an object that becomes visible only when we have searched the papers on a cluttered desk. Beneath the Surface ★ takes this further, giving all large furnishings the ability to conceal items, and allowing the player to put things underneath other things, as well as find them. Flashlight ★ adds an extra twist to the puzzle by requiring that the player have a flashlight to shine under a bulky object in order to find what lies underneath.

Looking inside an object is generally handled by the searching action, and we could extend that to allow the player to search multiple or complex objects. Matreshka ★ turns the puzzle on its head by allowing the player to search a whole room systematically with only a single command.

Examples

98. Beachfront ★

Suppose we have our player, a detective, searching for evidence; we don't want him to be able to use this evidence until he has performed the action that reveals it, but after that it should be visible in the room when he looks.

A simple way to do this is to start the object -- an envelope, in this scenario -- out of play, and only move it into the location when the player looks for it:

"Beachfront"

The Stuffy Office is a room. "The windows are closed, making the sultry air even more unbearable. A narrow slice of Caribbean blue is visible between the scuba gear rental shop and the recreated 17th century pirate tavern.

The office is cheerfully furnished with wicker chairs and white curtains, but the tropical decorating scheme stopped at the desk, which is heavy oak and absolutely covered with papers."

The heavy oak desk is a supporter in the stuffy office. It is scenery. Understand "paperwork" as the desk.

The creamy envelope is an openable container. The description is "There is no return address on the outside of the envelope, just the address of the Doctor's office -- but the legs of the capital A are rubbed down in a characteristic way, and the top of every R is open. There's no question that it comes from the same typewriter as the blackmail note." In the envelope is a letter. The envelope can be found or lost. The envelope is lost.

Instead of searching the desk when the envelope is lost:

now the envelope is found;

say "You rifle through the piles of bills and notices; invitations to conventions; advertisements for high-end prescription drugs; pink carbon sheets bearing patients['] names and medical identification numbers in spidery, elderly handwriting. Almost at the bottom of the heap, you find what you were looking for: a creamy envelope with the address typed.";

move the envelope to the desk.

Here we've changed the property of the envelope to keep track of the fact that it has been found, so that if the player tries again, he won't find anything more.

Instead of searching the desk:
   say "Further investigation of the desk reveals nothing else suspicious."

Notice that we have two rules that apply to "searching the desk", but one of them has a more specific set of parameters ("when the envelope is lost"). This means that Inform will consult that rule first and use it if it applies; it will only carry out our plain vanilla "instead of searching the desk" rule when the more restricted rule is not relevant.

Test me with "x envelope / x desk / search desk / look / get envelope / x envelope".

wi 7.12 In the presence of, and when
rb 6.6 Looking Under and Hiding

172. Matreshka ★

"Matreshka"

Ransacking is an action applying to one thing.

Check ransacking:

if the noun is not the location, say "You can hardly search [the noun] from here." instead.

Carry out ransacking:

while the player can see a closed openable unlocked container (called target):

say "[target]: [run paragraph on]";

try opening the target.

Report ransacking:

say "You can see nothing further worth searching."

The Russian Gift Shop is a room. In the Russian Gift Shop is a large wooden doll. It is closed and openable. In the large wooden doll is a medium wooden doll. It is closed and openable. In the medium wooden doll is a small wooden doll. It is closed and openable. In the small wooden doll is a tiny solid wooden doll.

And now we need to borrow from a later chapter for the command that will make this work:

Understand "search [any visited room]" as ransacking.
 
Test me with "search gift shop".

wi 11.7 Begin and end
rb 6.6 Looking Under and Hiding

218. Flashlight ★

"Flashlight"

The Schoolhouse is a room. "Though normally comfortable, the room is dark and menacing during the storm; rain sheets on the windows, and you can barely see the flash of the lighthouse only a few miles away."

The cabinet is a fixed in place openable container in the Schoolhouse. The hurricane lantern is a thing in the Schoolhouse. "A hurricane lantern hangs from a peg." The lantern is lit.

Visibility rule when looking under something:

if the player is carrying a lit thing (called lamp):

say "You shine [the lamp] under [the noun]...";

there is sufficient light;

there is insufficient light.

There is a marble. The marble can be found or lost. The marble is lost.

Instead of looking under the cabinet when the marble is lost:

move the marble to the player;

now the marble is found;

say "Billy's lost marble! So that's where it got to!"

Test me with "look under cabinet / get lantern / look under cabinet".

Because visibility is checked before instead rules, this discovery will (correctly) occur only when the player does have enough light.

wi 12.19 Changing visibility
rb 6.6 Looking Under and Hiding

233. Beneath the Surface ★

The standard world model provides for the idea of containers and supporters, but this is not the only way that objects can relate to one another in the real world. Here we try adding the idea of concealment beneath another object:

"Beneath the Surface"

Section 1 - In Which our Terms are Defined

Underlying relates various things to one thing. The verb to underlie means the underlying relation. The verb to be under means the underlying relation. The verb to be beneath means the underlying relation.

Instead of looking under a thing which is underlaid by something (called the lost object):

say "You find [the list of things which underlie the noun]!";

now every thing which underlies the noun is carried by the player;

now every thing which underlies the noun does not underlie the noun.

Hiding it under is an action applying to one carried thing and one thing. Understand "put [something preferably held] under [something]" as hiding it under. Understand "hide [something preferably held] under [something]" as hiding it under. Understand the commands "shove" and "conceal" and "stick" as "hide".

Check hiding it under:

if the second noun is not fixed in place, say "[The second noun] wouldn't be a very effective place of concealment." instead.

Carry out hiding it under:

now the noun is nowhere;

now the noun underlies the second noun.

Report hiding it under:

say "You shove [the noun] out of sight beneath [the second noun]."

Section 2 - In Which They are Put To Use

The Room of Hidden Objects is a room. It contains a sofa, an easy chair, and a rug. The sofa supports a lime-green pillow and an innocent-looking Chinese finger toy. The rug is fixed in place. The chair is a supporter.

A treasure map underlies the easy chair. A skeleton is beneath the sofa. A blueprint of Atlantis, a lexicon of Linear A, and the key to Jimmy Hoffa's Mausoleum are under the rug.

Test me with "look under the sofa / look under the rug / look under the easy chair / hide lexicon under rug".

wi 13.10 Defining new prepositions
rb 6.6 Looking Under and Hiding

🔗

RB §6.7 Inventory

Occasionally we would like to change the way the name of something is printed as part of our inventory, and we can do this with a printing the name rule such as

Rule for printing the name of the dead rat while taking inventory:
   say "dead rat (at arm's length)"

There are also several possibilities for redesigning the inventory list as a whole. Persephone ★★★ shows how to divide an inventory list into two parts, a "You are carrying: " section and a "You are wearing: " section. Equipment List ★★ goes further, and shows how we might use Inform's specialized listing functions to create a variety of differently formatted inventories.

Sometimes the way Inform by default lists properties such as "(closed)" or "(open but empty)" isn't quite what we want. Oyster Wide Shut ★ offers a flexible alternative to the standard behavior, allowing finer control over which properties are listed and how they are described.

Trying Taking Manhattan ★★★ replaces the inventory behavior for other characters: instead of silently looking through their possessions (but not describing them to the player), they now describe to the player what they're carrying and wearing.

Examples

424. Oyster Wide Shut ★

As we've seen in earlier examples such as "Equipment List", it is possible to vary the way Inform creates inventory listings in general (to create lists that look more like paragraphs of prose, lists divided between what the player is wearing and what he isn't, and so on). We can also use activities to alter the printing of specific objects' names and contents, as with the "omit contents in listing" feature after printing the name of something.

We may find, however, that we would like a great deal more control over Inform's printing of inventory details, not just as a special effect for a few items, but throughout the game.

We start by turning off Inform's native property writer:

"Oyster Wide Shut"

Section 1 - Procedure

The print standard inventory rule is not listed in any rulebook.

Carry out taking inventory (this is the new print inventory rule):

say "You are carrying: [line break]";

list the contents of the player, with newlines, indented, including contents, with extra indentation.

This is very much like the library's standard behavior, but with the exception that "giving inventory information" or even "giving brief inventory information" are omitted. Here's how we supplant it:

After printing the name of something (called target) while taking inventory:
   follow the property-aggregation rules for the target.

Now, our property-aggregation rulebook is going to look at a given object and decide on a list of features that should be mentioned in inventory. We'll start by producing something quite similar to Inform's default behavior:

The property-aggregation rules are an object-based rulebook.
The property-aggregation rulebook has a list of text called the tagline.
 
A first property-aggregation rule for an openable open thing (this is the mention open openables rule):
   add "open" to the tagline.
 
A first property-aggregation rule for an openable closed thing (this is the mention closed openables rule):
   add "closed" to the tagline.
 
A property-aggregation rule for a closed transparent container which contains nothing (this is the mention empty transparent containers rule):
   add "empty" to the tagline.
 
A property-aggregation rule for an open container which contains nothing (this is the mention empty open containers rule):
   add "empty" to the tagline.
 
A property-aggregation rule for a lit thing (this is the mention lit objects rule):
   add "providing light" to the tagline.
 
A property-aggregation rule for a thing worn by the player (this is the mention worn objects rule):
   add "being worn" to the tagline.
 
The last property-aggregation rule (this is the print aggregated properties rule):
   if the number of entries in the tagline is greater than 0:
      say " ([tagline])";
      rule succeeds;
   rule fails.

Notice that we don't need to write any rules about how to print that list of text: because Inform is printing out a list, it will automatically insert commas, spaces, and the word "and" where appropriate; and it will automatically follow the "use serial comma" option, if we have it set.

Now we're free to meddle. Let's give the player a bunch of possessions that will be listed in interesting ways in inventory:

Section 2 - Scenario
 
The Curved Beach is a room. "White sand stretches away both northeast and northwest, enclosing this attractive little bay. Gentle waves lap at the beach."
 
The player carries a glowing plastic sack. The glowing plastic sack is lit and transparent and openable and open. It contains a rock. It is wearable.
 
The player wears a flashlight lanyard. The flashlight lanyard is a device.
 
Carry out switching on the lanyard: now the noun is lit.
Carry out switching off the lanyard: now the noun is unlit.
 
The player carries an oyster. The oyster contains a pearl. The oyster is openable.

Now suppose that we don't want the oyster to say "closed" when it's closed. Instead, we'd like it to say "clamped shut". As this is the only property the oyster will ever have, we can simply override his whole property-aggregation rulebook:

A property-aggregation rule for the oyster:
   if the oyster is closed:
      say " (clamped shut)";
   rule succeeds.

That's fine for the oyster because "clamped shut" is the only property he'll ever have. What if we'd like instead just to revise the way the sack (and only the sack) gets described as providing light?

The sacklight rule is listed after the mention lit objects rule in the property-aggregation rules.
 
A property-aggregation rule for the plastic sack (this is the sacklight rule):
   if "providing light" is listed in the tagline:
      remove "providing light" from the tagline;
      add "gently glowing" to the tagline.

Now the flashlight (and any other regular light sources we might add to the game) will be described as "providing light", but the sack will only be said to be gently glowing -- a bit more appropriate for its rather fainter gleam.

We might also wish to add a systematic feature across the board to include a new property in the inventory list? Let's say the player can enchant his possessions, and enchanted possessions should thereafter be listed accordingly:

A thing can be magical or non-magical. A thing is usually non-magical.
 
Understand "enchant [something]" as enchanting. Enchanting is an action applying to one thing.
 
Carry out enchanting something:
   now the noun is magical.
 
Report enchanting something:
   say "Ding! You turn [the noun] magical."
 
A property-aggregation rule for a magical thing:
   add "enchanted" to the tagline.
 
Test me with "i / close oyster / i  / turn on flashlight / i / take off flashlight / i / turn off flashlight / i / close sack / i / open sack / i / take all from sack / i / close sack / i  / wear sack / i / enchant sack / i / open sack / put all in sack / i / close sack / i".

Further variations are possible as well: if we used a "before printing the name…" rather than an "after printing the name…" rule, we could automatically generate lines like "an open and empty phosphorescent plastic sack", removing some of the artificiality of the parentheses.

Or we could add more logic to the rules about which properties are mentioned, so that some features of objects were mentioned in inventory only if the player was wearing the correct detection device, like so:

The player wears enchantment-detecting goggles.

A property-aggregation rule for a magical thing:

if the player is wearing the goggles:

add "enchanted" to the tagline.

wi 21.3 Saying lists of values
rb 6.7 Inventory

177. Equipment List ★★

Most of the phrase options above are relatively self-explanatory; a few are less so. Here is an overview:

"With newlines" tells Inform to put a new line before each listed object. Indented tells it to indent contents of objects, when listing these.

"Giving inventory information" means to append information such as (closed) or (being worn) to objects.

"As a sentence" means to put "and" before the last object and commas between them; this is usually not used in conjunction with newline listing. "As a sentence" obeys whatever conventions about the use of the serial comma we may have established with the "Use serial comma" option.

"Including contents" means to list the contents of open or transparent containers and all supporters, whereas including all contents means to list the contents of all containers, even opaque closed ones.

"Tersely", perhaps unexpectedly, puts parentheses around objects listed as the contents of other objects.

"Giving brief inventory information" omits most of the inventory tags, such as "(open)" and "(worn)", but does list "(closed)" for closed containers which might not otherwise be obviously openable.

"Using the definite article" means prefixing objects with "the", if applicable, rather than "a".

"Listing marked items only" means including only objects that have already been declared "marked for listing".

"Prefacing with is-are" means that Inform will write "is" before the list if it contains only one item, and "are" if the list contains more than one.

"Not listing concealed items" means to omit from the list anything which is scenery.

Finally, "with extra indentation" means that the whole list should be indented slightly, in emulation of the default inventory listing.

With this information, we can try rewriting the inventory behavior to emulate the standard or to explore alternate versions:

"Equipment List"

The Watery Room is a room. The player carries a snorkel and a waterproof sack. The waterproof sack contains an undersea map, a diving guide, a cup, and 500 Argentine pesos. The cup contains a worm. The player wears a swimsuit and a pair of flippers. The sack is openable and open.

Inventory listing style is a kind of value. The inventory listing styles are tall, wide, curt, minimal, divided tall, and divided wide. Current inventory listing style is an inventory listing style that varies.

Understand "inventory [inventory listing style]" as requesting styled inventory. Requesting styled inventory is an action applying to an inventory listing style. It is an action out of world.

Carry out requesting styled inventory:

now current inventory listing style is the inventory listing style understood.

Report requesting styled inventory:

say "Inventory listing is now set to [current inventory listing style]."

We begin by emulating the standard inventory listing style:

Instead of taking inventory when current inventory listing style is tall:
   if the number of things enclosed by the player is 0, say "You are empty-handed." instead;
   say "You are carrying: [line break]";
   list the contents of the player, with newlines, indented, giving inventory information, including contents, with extra indentation.

Here we offer the alternative of listing everything together as a paragraph:

Instead of taking inventory when current inventory listing style is wide:
   if the number of things enclosed by the player is 0, say "You are empty-handed." instead;
   say "You are carrying ";
   list the contents of the player, giving inventory information, as a sentence, including contents;
   say "."

This may be unsatisfactory, however. Items that are inside other items are not set off from those merely carried by the player. One way around this is to use terse listing, giving such descriptions as "a waterproof sack (in which are an undersea map, a diving guide, a cup (in which is a worm) and a 500 Argentine pesos)" as opposed to the more confusing " a waterproof sack (open), inside which are an undersea map, a diving guide, a cup, inside which is a worm and a 500 Argentine pesos".

Instead of taking inventory when current inventory listing style is curt:
   if the number of things enclosed by the player is 0, say "You are empty-handed." instead;
   say "You are carrying ";
   list the contents of the player, tersely, giving brief inventory information, as a sentence, including contents;
   say "."

If, using the above style, we close the sack, we will still get "(closed)" after the sack's listing. The following minimalist listing style abolishes even that nicety:

Instead of taking inventory when current inventory listing style is minimal:
   if the number of things enclosed by the player is 0, say "You are empty-handed." instead;
   say "You are carrying ";
   list the contents of the player, tersely, as a sentence, including contents;
   say "."

If we want to list worn things separately from carried things, we have occasion to put "listing marked items only" to work:

Instead of taking inventory when the current inventory listing style is divided wide:
   if the number of things enclosed by the player is 0, say "You are empty-handed." instead;
   say "You are wearing ";
   now all things enclosed by the player are unmarked for listing;
   now all things worn by the player are marked for listing;
   if no things worn by the player are marked for listing, say "nothing";
   otherwise list the contents of the player, as a sentence, listing marked items only;
   say ".[paragraph break]";
   say "You are carrying ";
   now all things carried by the player are marked for listing;
   now all things worn by the player are unmarked for listing;
   if no things carried by the player are marked for listing, say "nothing";
   otherwise list the contents of the player, as a sentence, tersely, giving brief inventory information, listing marked items only;
   say ".[paragraph break]".

And similarly for a tall divided inventory:

Instead of taking inventory when the current inventory listing style is divided tall:
   if the number of things enclosed by the player is 0, say "You are empty-handed." instead;
   if the player carries something:
      now all things enclosed by the player are unmarked for listing;
      now all things carried by the player are marked for listing;
      say "You are carrying: [line break]";
      list the contents of the player, with newlines, indented, giving inventory information, including contents, with extra indentation, listing marked items only;
   if the player wears something:
      now all things enclosed by the player are unmarked for listing;
      now all things worn by the player are marked for listing;
      say "You are wearing: [line break]";
      list the contents of the player, with newlines, indented, including contents, with extra indentation, listing marked items only.
 
Test me with "i / inventory wide / i / inventory curt / i / close sack / i / open sack / inventory minimal / i / close sack / i / open sack / inventory divided wide / i / inventory divided tall / i / drop all / i / take all / take off swimsuit / take off flippers / i / i divided wide / i / wear swimsuit / drop all / i".

wi 11.14 Phrase options
rb 6.7 Inventory

65. Persephone ★★★

If we wanted, we might replace the rule for taking inventory as follows:

"Persephone"

Instead of taking inventory:

say "[if the player carries something][We]['re] carrying [a list of things carried by the player][otherwise][We]['re] empty-handed";

say "[if the player wears something]. [We]['re] wearing [a list of things worn by the player][end if]."

The Fancy Party is a room. The player carries a sword, a strawberry stem, and 20 credits worth of platinum. The player wears a sash indicating lordhood.

Test me with "i / take off sash / i / drop all / i".

wi 5.6 Text with variations
rb 6.7 Inventory

204. Trying Taking Manhattan ★★★

Inform has built-in commands for other people, and sometimes we may want to adjust the way these work without completely disabling and replacing the command. Suppose, for instance, that instead of

Kermit the Frog looks through his possessions.

we'd like someone taking inventory to report what he's got, thus:

Kermit the Frog says, "I seem to be carrying a microphone and wearing a hat and a trenchcoat."

To do this, we could replace the built-in report rule with a different one.

"Trying Taking Manhattan"

The loud inventory rule is listed instead of the report other people taking inventory rule in the report taking inventory rules.

This is the loud inventory rule:

unless the player is the person asked:

say "[The person asked] says, 'I seem to be carrying [a list of things carried by the person asked][if the person asked is wearing something] and wearing [a list of things worn by the person asked][end if].'"

Persuasion rule for asking someone to try doing something: persuasion succeeds.

Grand Central Station is a room. "Here you are in New York, New York. Any minute now someone is going to burst into song."

Kermit the Frog is a man in Grand Central Station. "Kermit the Frog stands nearby, enjoying being green." Kermit is wearing a hat and a trenchcoat. He is carrying a microphone.

Test me with "inventory / kermit, inventory".

wi 12.11 Making actions work for other people
rb 6.7 Inventory

🔗

RB §6.8 Taking, Dropping, Inserting and Putting

We may want to change the default refusal message when the player tries to pick up scenery: Replanting ★ demonstrates this case simply.

Removal ★ modifies responses to successful TAKE commands, with the effect that when the player picks up an item, he gets a response such as "You take the book from the shelf."

Croft ★★★ modifies the DROP command, so that objects dropped on specific surfaces get reported in a special way. Celadon ★ allows the player to drop even objects he is carrying indirectly, for instance on a tray or in a sack.

Morning After ★ introduces a simple rule that changes the behavior of the whole story: whenever the player takes an item he hasn't already looked at, he automatically examines it. This picks up the pace of exploration passages where the player is likely to be collecting a large number of objects.

By default, when the player tries to put or insert an item that he isn't holding, Inform prints a refusal message; Democratic Process ★★★ and Sand ★★★★ offer ways instead to have the player first pick up the relevant items. (The former applies to single items the player is trying to place; the latter expands coverage to work even if the player uses a command affecting multiple objects.)

Taking also happens as a result of other commands. Such takes can be made unnecessary by turning off the "carrying requirements rule" under particular circumstances, or presented differently using the implicitly taking activity.

Examples

16. Replanting ★

By default, "TAKE OAK" in the example above will produce the response "That's hardly portable." This is fine under many circumstances, but also a bit generic, so we might want to override it for a specific game.

"Replanting"

The Orchard is a room. "Within this quadrille of pear trees, a single gnarled old oak remains as a memory of centuries past." The gnarled old oak tree is scenery in the Orchard.

Instead of taking some scenery: say "You lack the hulk-like strength."

Test me with "take oak".

Here we've used an "instead" rule; we will learn more about these in the section on actions. This allows us to define our own results for taking an object.

Note: "scenery" is a property of an object (about which we will hear more later). So when we use it in rules, we can talk about "some scenery", "something that is scenery", or even "a scenery thing" -- the last one doesn't sound much like English, but is a more plausible construction with other adjectives.

wi 3.8 Scenery
rb 6.8 Taking, Dropping, Inserting and Putting

90. Morning After ★

Suppose we want to make the player's life slightly easier by examining everything he picks up, if he hasn't already examined it.

"Morning After"

A thing can be examined or unexamined.

After taking something unexamined:

say "Taken. [run paragraph on]";

try examining the noun.

Carry out examining something:

now the noun is examined.

Carry out rules are explained in more detail in the chapter on advanced action handling. For now, it may be enough to know that what we put into this carry out rule for examining will happen any time anything is examined, but that it will not interfere with the rest of the predefined behavior of the action. The player will still see the object description and so on, as usual.

The Red Door Saloon is a room. "This old place is in pretty bad shape since the mine shut down. Now there's not much to see but the pair of deep gouges in the floorboards where they dragged away the Sheriff's corpse with the spurs still on."
 
Jed is a man in the Red Door Saloon. "At 8:30 AM the only person around is old Jed, collecting his hangover cure."
 
The pistol is a thing in the Red Door Saloon. The description of the pistol is "It ain't too accurate, but for two dollars you can't expect much."
 
The hangover cure is a thing in the Red Door Saloon. The description of the hangover cure is "Two yellow egg-yolks unbroken in a red-brown liquid. Yep."
 
Test me with "x pistol / get all".

wi 7.5 After rules
rb 6.8 Taking, Dropping, Inserting and Putting

198. Removal ★

Suppose that we want to change the reporting of "take" so that the player is always told something like "You take the book from the shelf." or "You pick up the toy from the ground." In order to generate these reports, we will need to know where the object started, even though by the time we are printing the output, the object will have moved.

"Removal"

The Pharmacy is a room. A desk and a trash can are in the Pharmacy. The pill-counter, a prescription, and a computer are on the desk. The computer is fixed in place. The pill-counter contains some Vicodin. The trash can contains an empty box.

The taking action has an object called previous locale (matched as "from").

The previous locale could in theory be either a thing or a room, so we make it "an object" -- that is, the most generic possible kind, to which both things and rooms belong. Now we record what the previous locale is at the beginning of each taking action:

Setting action variables for taking:
   now previous locale is the holder of the noun.
 
Report taking something from the location:
   say "You pick up [the noun] from the ground." instead.
 
Report taking something:
   say "You take [the noun] from [the previous locale]." instead.
 
Test me with "get all".

wi 12.10 Action variables
rb 6.8 Taking, Dropping, Inserting and Putting

224. Celadon ★

By default, Inform only lets the player drop those things which he is carrying -- that is, those directly in his possession. Things inside satchels or on portable trays have to be taken first.

If we want to change this behavior, we might add a dropping rule that distinguishes between carrying and mere enclosure (introduced back in "The location of something" in the chapter on Things):

"Celadon"

The Tea Room is a room. The player carries a black lacquer tray. The lacquer tray is portable. On the lacquer tray are a celadon teapot and a napkin.

Before dropping something:

if the player does not carry the noun and the player encloses the noun:

say "(first taking [the noun] from [the holder of the noun])[command clarification break]";

silently try taking the noun;

if the player does not carry the noun, stop the action.

Instead of taking the napkin:

say "It seems to be stuck to the tray, possibly by an underlying wad of gum."

Test me with "i / drop teapot / i / look / drop teapot / drop napkin / i / drop tray".

wi 13.4 To carry, to wear, to have
rb 6.8 Taking, Dropping, Inserting and Putting

86. Democratic Process ★★★

"Stop" and "Continue" are most useful when we need to write rules that will have to stop the action some of the time but at other times let it pass; so for instance:

"Democratic Process"

Before inserting something which is not carried by the player into something:

if the noun is in the second noun, say "Already done." instead;

say "(first taking [the noun])[line break]";

silently try taking the noun;

if the player is not holding the noun, stop the action.

Before putting something which is not carried by the player on something:

if the noun is on the second noun, say "Already done." instead;

say "(first taking [the noun])[line break]";

silently try taking the noun;

if the player is not holding the noun, stop the action.

The Assembly Room is a room. "On most days, this room is used for elementary school assemblies; at the moment, it serves as a voting place." The ballot is on the desk. The desk is in the Assembly Room.

The machine is a container in the Assembly Room. "On the ballot machine is a sign which reads 'PUT BALLOTS IN ME :)'." Understand "ballot machine" as the machine.

Test me with "put ballot in machine".

wi 7.3 Before rules
rb 6.8 Taking, Dropping, Inserting and Putting

202. Croft ★★★

Suppose that we have a design in which the player spends lots of time on enterable supporters, and in which we want to report certain actions -- dropping things onto those supporters, or leaping from one to another -- in a new way. We might begin by adding some action variables to help us keep track of the situation:

"Croft"

The dropping action has an object called the container dropped into (matched as "into").

The dropping action has an object called the supporter dropped onto (matched as "onto").

Rule for setting action variables for dropping:

if the actor is in a container (called C), now the container dropped into is C;

if the actor is on a supporter (called C), now the supporter dropped onto is C.

Report dropping a heavy thing onto a metallic thing:

say "You drop [the noun], and [the supporter dropped onto] clangs protestingly." instead.

Report someone dropping a heavy thing onto a metallic thing:

say "[The actor] drops [the noun] onto [the supporter dropped onto], which clangs protestingly." instead.

A thing can be heavy or light. A thing can be metallic or ordinary. A thing is usually ordinary. A thing is usually light.

The Ancient Cambodian Temple is a room. "A vast space built for ancient and forgotten rituals. The stone floor crawls with vermin. Well above the floor, and separated by some feet, are twin platforms built into the wall: the one carved of jointed wood, the other of sheets of graven bronze."

A platform is a kind of supporter. A platform is always enterable. A platform is usually scenery.

The bronze platform is a metallic platform in the Temple. Lara is a woman. She is on the bronze platform. She wears safari pants and a tank top. She carries a gun and a map. The gun is heavy.

The wood platform is an ordinary platform in the Temple. The player is on the wood platform. The player carries a rope, an Ancient Cambodian/English Phrasebook, a pickaxe, and a precious idol. The idol and the pickaxe are heavy.

Persuasion rule: persuasion succeeds.

The entering action has an object called the place left (matched as "from").

Check entering a platform from a platform:

if actor is the player, say "You leap into midair to cross the distance...";

otherwise say "[The actor] leaps gracefully across the distance...";

move the actor to the holder of the noun, without printing a room description.

Because this rule occurs before the "implicitly pass through other barriers rule", that rule will not occur when we move from platform to platform; we'll use our own custom rule instead.

Rule for setting action variables for entering:
   now the place left is the holder of the actor.
 
Report entering a platform from a platform:
   say "You land in a cat-like crouch on [the noun]." instead.
 
Report Lara entering a platform from a platform:
   say "Lara lands soundlessly on [the noun][if the noun supports the player] beside you[end if]." instead.
 
Report entering a platform from the location:
   say "You jump, catch the edge of [the noun] in your hands, and -- exerting considerable upper-body strength -- pull yourself up onto it." instead.
 
Report Lara entering a platform from a location:
   say "Lara jumps, catches the edge of [the noun], and is standing upright on it, all in less time than it takes to tell."
 
Instead of examining a person who is not the player:
   say "[The noun] carries [list of things carried by the noun] and wears [list of things worn by the noun]."
 
Instead of climbing a platform, try entering the noun.
 
Test me with "Lara, drop map / lara, drop gun / drop idol / enter bronze platform / drop pickaxe / get off / climb wood".

wi 12.10 Action variables
rb 6.8 Taking, Dropping, Inserting and Putting

379. Lollipop Guild ★★★

As mentioned in this section, the "implicitly taking" activity does not allow us to skip an implicit take entirely. In order to do this, we need to borrow from the chapter on Rulebooks and tell Inform that one of the rules normally built in to the Standard Rules does nothing in certain circumstances:

"Lollipop Guild"

The carrying requirements rule does nothing when showing something to the guardian.

The can't show what you haven't got rule does nothing when showing something to the guardian.

The block showing rule does nothing.

Candyland is a room. "A fizzing, popping wonderland of sugary delights. A path tiled with butterscotch sweets leads to the horizon."

The butterscotch path is scenery in Candyland.

The player carries a basket. In the basket are a licorice gumdrop and a can of tuna. The gumdrop is edible. The description of the gumdrop is "Covered all over with grains of sugar." The can of tuna is edible. The description of the can of tuna is "A rare import in this place."

The giant lollipop is a fixed in place edible thing in Candyland. "Growing right next to the path, on a trunk of white paper, is a giant lollipop colored green and red and white." The description of the lollipop is "If you were very blind, like Aunt Myrtle, you might mistake it for a young sapling just planted: the lollipop is just that leafy shade of green, with swirls of white and red that might be branches or flowers."

The guardian is a man in Candyland. "Right beside you is a guardian in a mint-colored uniform." The description of the guardian is "A killjoy wielding a gigantic toothbrush." The guardian carries a gigantic toothbrush. The description of the toothbrush is "Bristles as long as your hand. Firm bristles, too, not those soft ones. The guardian doesn't care about your tender gums."

A thing can be sweet. The butterscotch path, the lollipop, and the gumdrop are sweet.

Carry out showing a sweet thing to the guardian:

say "The guardian shrieks! You don't understand its language, but from its ululations you understand the idea of decay. There may have been a bit in there about a root canal." instead.

Carry out showing something to the guardian:

say "The guardian nods approvingly at the unsweetened [noun]." instead.

Report eating a sweet thing in the presence of the guardian:

say "The guardian looks mournful, but unholsters his tube of paste and begins applying it to the toothbrush, as though to say that he really did not want to have to do this...";

end the story saying "Everything goes minty" instead.

Report eating something:

say "You consume [the noun] with gusto." instead.

Test me with "x guardian / x toothbrush / show gumdrop to guardian / show path to guardian / show tuna to guardian / look / eat gumdrop".

Note that because we only deactivate the carrying requirements rule for showing purposes, the player still takes the gumdrop before eating it.

wi 18.34 Implicitly taking something
rb 6.8 Taking, Dropping, Inserting and Putting

87. Sand ★★★★

The above example does not quite work when we want the player to be allowed to take multiple objects at once before putting them somewhere: we also need to add a couple of "understand" rules borrowed from many chapters later. While the reasons may not be immediately clear, we include the demonstration here for the sake of thoroughness:

"Sand"

Before inserting something which is not carried by the player into something:

if the noun is in the second noun, say "Already done." instead;

say "(first taking [the noun]) ";

silently try taking the noun;

if the player is not holding the noun, stop the action.

Before putting something which is not carried by the player on something:

if the noun is on the second noun, say "Already done." instead;

say "(first taking [the noun])[line break]";

silently try taking the noun;

if the player is not holding the noun, stop the action.

Understand "put [things] in [something]" as inserting it into. Understand "put [things] on [something]" as putting it on.

The Closet is a room.

A lentil is a kind of thing. A black-eyed pea is a kind of thing. The closet contains 3 lentils. The Closet contains 14 black-eyed peas. The round tin is a container in the closet. The round tin contains 17 lentils. The square tin is a container in the Closet. The square tin contains 20 black-eyed peas.

Sorting is a scene. Sorting begins when play begins. Sorting ends when all the lentils are in the round tin and all the black-eyed peas are in the square tin. When Sorting ends, end the story finally.

When play begins: say "Thanks to your cruel stepmother, you're not going anywhere until the lentils and peas are sorted."

Test me with "put peas in square tin / put lentils in round tin".

wi 7.3 Before rules
rb 6.8 Taking, Dropping, Inserting and Putting

🔗

RB §6.9 Going, Pushing Things in Directions

Going is the most complex of actions after looking (or perhaps including looking): the success of every movement depends on the direction the player goes; the room he starts from; the room he intends to reach; whether there are any doors intervening (and, if so, whether these are closed or locked); whether he is traveling by vehicle; and whether he is pushing anything in front of him. When he gets there, the description he sees is itself generated by a looking command.

Pushing something in a direction is really a sort of going. The command >PUSH WHEELBARROW WEST first checks certain qualifying rules: by default, only things defined as pushable between rooms may be pushed, and they may be pushed only in horizontal directions (not UP or DOWN) -- though these rules can be overridden, as we see in Zorb ★★★. If the player's pushing attempt passes these criteria, the action is translated automatically into a going action, with all the usual checks about whether that direction leads anywhere, whether a door is in the way, and so on. The converted action afterward can be caught with such rules as

Instead of going to the Alpine Meadow with the wheelbarrow:
   say "You don't want to crush the delicate blooms."
 
Instead of going north with the handcart:
   say "The headwind is so stiff that you are unable to make much northerly progress at all while encumbered by the handcart."

Since the two actions are internally being handled as one, both are discussed here.

It is very common for players to make a mistake and type the wrong direction command, or even to misunderstand the room description and not recognize all the possible exits. Bumping into Walls ★★★ helpfully adds a facility so that when the player tries to go in the wrong direction, the story lists the correct possibilities, as in

From here, the viable exits are to the south, the east and the west.

Assuming that travel succeeds, another useful technique is to provide some sense of the journey between locations, especially if they are remote from one another or the player has to do something unusual to get from one to the other. Up and Up ★★ adds a short description of travel when we approach a new room, before the room description is printed; Veronica ★, conversely, adds a comment when the player leaves a region of the map. The Second Oldest Problem ★ intervenes and kills a player who tries to travel from one dark room to another. Mattress King ★ embellishes the description that automatically results from PUSH MATTRESS WEST, adding a line that describes the player pushing the object before describing the new room approached.

We may also want to add a brief comment when we arrive in a new room, after the room description is printed. One trivial way to do this is to append the line to the room's main description, conditionally, like this:

The Hammock Emporium is a room. "This is Cousin Ed's shop, the big dream he left accounting to pursue. You can't help gawking at the Luxury Leather Space Hammock, made of genuine red buffalo skins[if unvisited]. [paragraph break]So this is why Grampa makes all those 'lying down on the job' jokes every Thanksgiving[end if].".

But often we want our first-glance comment to come after some items in the room are described; and for this effect, we would use the "first look rule" defined in Saint Eligius ★.

If these methods are not enough, the looking action has an action-specific variable called "the room-describing action", which records whether this particular instance of looking comes about because the player typed LOOK or because the player traveled to a new location. We can consult this variable if we want to make looking work differently after going, as for instance here:

Check looking when the room-describing action is the going action:
   say "You are temporarily too blinded to see." instead.

Another category of examples treat how we handle the movement commands themselves. The eight compass directions, with UP and DOWN, IN and OUT, are used as standard in most interactive fiction, but they are not the only possible way of navigating, and strike many newcomers to the genre as counter-intuitive, since when strolling around in real life most of us rarely think about our travel in terms of compass orientation. Misadventure ★ allows the player to GO TO a named room, instead, and calculates the best route to reach the destination; Safari Guide ★★ builds on this by letting the player make the whole trip in a single move, automatically opening any doors that stand in his way en route.

In the same spirit of interpreting the player's intentions sensibly, Provenance Unknown ★★★ modifies the pushing command so that if the player pushes the top object in a stack of objects towards a direction, Inform attempts to move the bottom item instead. This is convenient if, for instance, we have a heavy television on a movable cart and want PUSH TELEVISION WEST to work just as well as PUSH CART WEST.

We also sometimes want to respond sensibly to terse movement commands or ones that rely on some knowledge of where the player has already been. Polarity ★★★ provides a GO BACK command, allowing the player to retreat in the direction from which he came, while Minimal Movement ★ understands LEAVE, GO, and so on as OUT, in the absence of other information. Owen's Law ★★★ takes this further, calculating from the best routes on a map how to make OUT mean "move towards the exit of this indoor room", and IN mean "proceed further into the interior". Wonderland ★★ assigns altitudes to all rooms and works out the local best meaning of UP and DOWN accordingly.

Examples

100. Veronica ★

Suppose that we want to have something happen when the player leaves a region we've defined. "Instead of going from (the region)…" will not suffice for this, because this rule will be invoked every time the player successfully leaves a room within the region, whether or not he is going to a room that is also in the same region.

Instead we need a rule that is a bit more specific, like this:

"Veronica"

Neptune is a region.

Tijuana is a room.

High School is north of Tijuana. It is in Neptune.

Detective Offices is west of High School. It is in Neptune.

The player is in High School.

Instead of going from Neptune to a room which is not in Neptune:

say "It's a bad time to leave Neptune."

Test me with "s / w / e".

wi 7.13 Going from, going to
rb 6.9 Going, Pushing Things in Directions

105. Mattress King ★

By default, when the player pushes something a direction, Inform checks to make sure that the object is pushable between rooms. If not, it blocks the action; if so, it carries out a normal going action with the pushed object taken along.

Also by default, this action produces only a description of the new room that we've traveled into. But suppose we would like to print a short message describing the pushing action first:

"Mattress King"

Monica's Bedroom is a room. The Living Room is south of Monica's Bedroom. Rachel's Bedroom is south of the Living Room.

After going a direction (called way-pushed) with something (called the thing-pushed):

say "You push [the thing-pushed] [way-pushed] to [the location].";

continue the action.

The race car bed is an enterable supporter in Monica's Bedroom. It is pushable between rooms.

Test me with "push bed south".

wi 7.14 Going by, going through, going with
rb 6.9 Going, Pushing Things in Directions

200. The Second Oldest Problem ★

Text in this example is drawn from Will Crowther's original 1976 FORTRAN implementation of ADVENTURE, the founding work of the genre, whose source code was rediscovered by Dennis G. Jerz in 2007. Note the capitals: the program ran on an early computer without lower case lettering. They look a little mimsy now, but picture them glowing green on an old-style cathode ray tube monitor in a darkened room late at night.

The problem alluded to is that the player is forbidden to walk between two dark rooms, so that he must always have light to see by from at least one end of any movement. Writing source text to achieve this is tricky to get right in every case, because the determination of light is hard to do. Here we interleave the necessary rules into the existing "going" action, using a new action variable to record the number of ends which are dark as experienced by the player, which might be 0, 1 or 2:

"THE SECOND OLDEST PROBLEM"

The going action has a number called the dark terminus count.

Setting action variables for going:

now the dark terminus count is 0;

if in darkness, increment the dark terminus count.

The last carry out going rule:

if in darkness, increment the dark terminus count;

if the dark terminus count is 2, end the story saying "YOU FELL INTO A PIT AND BROKE EVERY BONE IN YOUR BODY!" instead.

And now three early rooms to try this out.

COBBLE CRAWL is a room. "YOU ARE CRAWLING OVER COBBLES IN A LOW PASSAGE. THERE IS A DIM LIGHT AT THE EAST END OF THE PASSAGE."
 
DEBRIS ROOM is west of COBBLE CRAWL. "YOU ARE IN A DEBRIS ROOM, FILLED WITH STUFF WASHED IN FROM THE SURFACE. A LOW WIDE PASSAGE WITH COBBLES BECOMES PLUGGED WITH MUD AND DEBRIS HERE,BUT AN AWKWARD CANYON LEADS UPWARD AND WEST."
 
AWKWARD CANYON is west of DEBRIS ROOM. "YOU ARE IN AN AWKWARD SLOPING EAST/WEST CANYON."
 
DEBRIS ROOM and AWKWARD CANYON are dark.
 
Rule for printing the name of a dark room: say "DARKNESS" instead.
Rule for printing the description of a dark room: say "IT IS NOW PITCH BLACK. IF YOU PROCEED YOU WILL LIKELY FALL INTO A PIT." instead.
 
Test me with "w / e / w / w".

This is only the second oldest problem in the IF literature: the earliest puzzle is unlocking the steel grate which bars entrance to the cave.

wi 12.10 Action variables
rb 6.9 Going, Pushing Things in Directions

306. Misadventure ★

The original Adventure allowed the player to type the names of rooms in order to move to them, and it is now not too difficult for us to do the same. Adventure restricted this option to adjacent rooms, but we might want to be a bit more flexible, so we will accept any room:

"Misadventure"

Plover Room is a room. "You're in a small chamber lit by an eerie green light. An extremely narrow tunnel exits to the west. A dark corridor leads northeast."

The Dark Corridor is northeast of Plover Room. Plover Room is south of the Dark Corridor. The printed name of the Dark Corridor is "Dark Room". The description of the Dark Corridor is "You're in the dark-room. A corridor leading south is the only exit."

The Alcove is west of Plover Room. "You are in an alcove. A small northwest path seems to widen after a short distance. An extremely tight tunnel leads east. It looks like a very tight squeeze. An eerie light can be seen at the other end."

Northwest of the Alcove is the Misty Cavern. The description of Misty Cavern is "You are following a wide path around the outer edge of a large cavern. Far below, through a heavy white mist, strange splashing noises can be heard. The mist rises up through a fissure in the ceiling. The path exits to the south and west." West of Misty Cavern is the Alcove.

Understand "[any room]" as going by name. Understand "go to [any room]" as going by name.

Going by name is an action applying to one thing.

We should reject movement to the player's current location, or to anywhere he hasn't been and can't see:

Check going by name:
   if the noun is the location, say "You're already in [the location]." instead;
   if the noun is not adjacent and the noun is unvisited, say "That noun did not make sense in this context." instead.

The assumption here is that the player does know the names of the rooms adjacent to his current location, even if he hasn't been there yet.

Now for the travel itself. The simplest way to ensure that the usual movement rules will still apply is to convert GO BY NAME into a GO action, and here the best route comes to our aid:

Carry out going by name:
   let aim be the best route from the location to the noun, using doors;
   if aim is not a direction, say "You can't think how to get there from here." instead;
   say "(heading [aim])[command clarification break]";
   try going aim;
   if the location is not the noun, say "You'll have to stop here."

This will allow the player to travel toward rooms he has already visited even if they are several moves away.

Finally, so that the player can also use the names of doors as commands:

Understand "[door]" as entering.

And in keeping with the original, we might add to our scenario a rule or two about restrictions on movement, just to test that it's all working right:

The player carries a plover egg and a platinum pyramid. The description of the egg is "Plover's eggs, by the way, are quite large." The printed name of the egg is "emerald the size of a plover's egg". Understand "emerald" as the egg. The description of the pyramid is "The platinum pyramid is 8 inches on a side!"
 
Instead of going to the Plover Room from the Alcove when the player carries something which is not the plover egg:
   say "Something you're carrying won't fit through the tunnel with you. You'd best take inventory and drop something."
 
Test me with "go to misty cavern / go to dark corridor / go to plover room / go to alcove / go to dark corridor / drop pyramid / go to dark corridor / g / go to alcove / g / go to misty cavern".

wi 17.10 Commands consisting only of nouns
rb 6.9 Going, Pushing Things in Directions

372. Minimal Movement ★

Sometimes it would be nice to respond a little more sensitively to a vague command such as "leave" -- converting it, perhaps, to a "go out" command.

"Minimal Movement"

The Doll-like House is a room. The Postage-Stamp-Sized Garden is outside from the House.

Rule for supplying a missing noun while going:

now noun is outside.

This particular situation is very slightly complicated by the existing rules about vague movement, but fortunately we can easily turn those off.

The block vaguely going rule is not listed in the for supplying a missing noun rules.
 
Test me with "go".

wi 18.32 Supplying a missing noun/second noun
rb 6.9 Going, Pushing Things in Directions

393. Saint Eligius ★

A not-infrequent desire in IF is to provide a few lines of comment when the player first enters a new room, after the objects are described but before anything else (such as an every turn rule) can fire. The cleanest, most systematic solution is to add a rule to the carry out looking rulebook, so:

"Saint Eligius"

The first look rule is listed after the room description paragraphs about objects rule in the carry out looking rules. A room can be commented or uncommented. A room is usually uncommented.

This is the first look rule:

if the location is uncommented, carry out the gawking at activity with the location.

Gawking at something is an activity.

Rule for gawking at the Diamond Market:

say "Your throat closes and your eyes begin to sting. You have long disdained pomp and luxury, and railed against the oppression that brings such wealth to some men at the cost of the lives of others; you were not prepared for the magnificence."

After gawking at a room (called the target): now the target is commented.

And now the scene itself:

The Cobbled Alley is a room. "The Alley has never been made into a proper street: the buildings on either side are simply too important to tear down. For all that, there isn't much sign of the magnificence nearby. The entrance you seek is set below street level, four grimy steps down to a half-basement."
 
After going to Diamond Market:
   say "You descend the steps quickly and step into the small foyer, allowing yourself to be searched for weapons, before going on to...";
   continue the action.
 
Diamond Market is down from Cobbled Alley. "The roof is vaulted and painted in allegorical images representing Plenty, the Riches of the Earth, and Saint Eligius, patron of goldsmiths and jewelers.
 
Under their watchful eye, dozens of men in sober black robes sit; and on the tables before them are rubies, emeralds, sapphires from oversea, but most of all diamonds, both raw and cut."
 
The burly guard is a man in Diamond Market. "A burly guard patrols quite close to you, but even he is more sumptuously dressed than the average burly guard, and his buttons shine."
 
Test me with "d / look".

wi 19.4 Listing rules explicitly
rb 6.9 Going, Pushing Things in Directions

6. Up and Up ★★

Sometimes when a player moves from one room to another, we want to imply that a considerable amount of time elapses, or that something interesting occurs on the way. In that case, we might want to print more than just the room description itself. Here is how we might define a couple of rooms that are far apart:

"Up and Up"

The Plain of the Skull is below the Endless Tower. The description of the Plain of the Skull is "A vast and trackless plain, enlivened only by the bones of those who have previously tried and failed to cross. Above you is the Endless Tower, which rises half-way to the moon."

The description of the Endless Tower is "From up here the Plain of the Skull seems only a small bald patch: the world is round and most of it is covered with trees. Far off to the southwest is a shimmering surface that might be water; but there are no signs of cities or civilizations, only the lizard-skeletons."

And now we borrow from the instructions on Actions to create our actual message. "Before…" introduces a rule that occurs when the player tries to do something; in this case, we will make a Before rule for going to the tower.

Before going to the Endless Tower:
   say "You climb... and climb... and climb... The sun sets. The moon rises. The wind begins to blow. You continue to climb..."
 
The player carries a bit of harness. The description of the harness is "A strip of worked leather and a loop of metal, scavenged from one of the skeletons on the plain. Without it, you might think your entire quest was in vain."
 
Test me with "look / up".

wi 3.2 Rooms and the map
rb 6.9 Going, Pushing Things in Directions

256. Wonderland ★★

Suppose we have a landscape with a great deal of up and down variation, where GO UP and GO DOWN will be significant almost everywhere, and specifying them all individually a tremendous pain:

"Wonderland"

An altitude is a kind of value. 1000 feet specifies an altitude. A room has an altitude.

Definition: a room is low if its altitude is 3000 feet or less. Definition: a room is high if its altitude is 5000 feet or more.

Instead of going down:

if an adjacent room is lower than the location:

let the valley be the lowest adjacent room;

let the way be the best route from the location to the valley;

say "(that is, [way])[paragraph break]";

try going the way;

otherwise:

say "You're in a local valley: there's no down from here."

Instead of going up:

if an adjacent room is higher than the location:

let the peak be the highest adjacent room;

let the way be the best route from the location to the peak;

say "(that is, [way])[paragraph break]";

try going the way;

otherwise:

say "You're on a local peak."

Paradise is a room. Paradise has altitude 5400 feet. "A handsome parking lot, a picnic ground, and the Henry M. Jackson Memorial Visitor Center. The latter offers, for serious climbers, a hot shower; for nature enthusiasts, an interpretive museum; and for car-trippers, a gift shop selling canned slugs. All of which is a largely unsuccessful distraction from the peak of Mt. Rainier beyond."

Cougar Rock is southwest of Paradise. The altitude of Cougar Rock is 3180 feet. "Numerous individual campsites and (on the road inventively labeled 'F') a handful of larger campgrounds suitable for church groups and family reunions."

Longmire is southwest of Cougar Rock. It has altitude 2760 feet. "A tiny town: it has to offer a few groceries, a post office, and a lodge for people who do not care to camp, all built in a rustic Park Service way."

Panorama Point is north of Paradise. It has altitude 6800 feet. Camp Muir is north of Panorama Point. It has altitude 10188 feet. Columbia Crest is northwest of Camp Muir. It has altitude 14410 feet. St Andrews Rock is west of Columbia Crest. It has altitude 10992 feet. Camp Schuman is northeast of Columbia Crest. It has altitude 9510 feet.

Since Mount Rainier National Park runs to over 235,000 acres, we will omit the rest of the locations, but it does seem fair to give a little more credit to anyone who makes the summit:

Instead of going up in the highest room:
   say "You're standing at the summit of Mt. Rainier, the highest point in the state of Washington. There is no up."
 
Test me with "up / up / up / down / down / up / up".

wi 15.8 Units
rb 6.9 Going, Pushing Things in Directions

307. Safari Guide ★★

The foregoing example moves the player one location towards his destination, and requires that rooms have been visited before. But suppose we wanted to be a bit more lenient about movement, and let the player make as many steps as necessary per turn. We will also show consideration about doors, using the "Locksmith" extension supplied with Inform. (Now every time the code attempts opening a door, unlocking rules will also be invoked.)

"Safari Guide"

Include Locksmith by Emily Short.

The Monkey House is a room. The African Grasslands Exhibit is north of the Monkey House. The bird door is north of the African Grasslands Exhibit and south of the Aviary. The Ostrich Enclosure is west of the Aviary. The bird door is a door. It is closed, lockable, and locked. The silver key is a passkey. It unlocks the bird door. The player carries the silver key.

Understand "go to [any room]" as going by name. Understand "[any room]" as going by name. Understand "[door]" as entering.

Going by name is an action applying to one thing.

Check going by name:

if the noun is the location, say "You're already in [the location]." instead.

Carry out going by name:

while the player is not in the noun:

let heading be the best route from the location to the noun, using even locked doors;

if heading is not a direction, say "You can't think how to get there from here." instead;

let destination be the room heading from the location;

say "(heading [heading])[command clarification break]";

try going heading;

if the player is not in the destination, rule fails.

Test me with "go to aviary / go to ostrich enclosure / african grasslands".

Notice that we continue the movement until one of two things happens: either the player reaches the room that is his destination, or the going attempt doesn't work. In the latter case we stop the action in order to avoid hanging the game up in a loop. This event might occur when the player runs into a locked door, for instance.

wi 17.10 Commands consisting only of nouns
rb 6.9 Going, Pushing Things in Directions

102. Bumping into Walls ★★★

"Bumping into Walls"

First we add an instruction to determine which ways lead to other rooms.

Definition: a direction (called thataway) is viable if the room thataway from the location is a room.

Now we build in the instruction for what Inform should say if the player tries to head in a direction that leads nowhere:

Instead of going nowhere:
   let count of exits be the number of viable directions;
   if the count of exits is 0, say "You appear to be trapped in here." instead;
   if the count of exits is 1, say "From here, the only way out is [list of viable directions].";
   otherwise say "From here, the viable exits are [list of viable directions]."

There is no theoretical reason why we have to define "count of exits" here: we could, if we wanted, just say "if the number of viable directions is 0", "if the number of viable directions is 1", and so on. However, each calculation of a "viable direction" takes a bit of computing power, so there is some slight savings in not requiring the game to count viable directions more than once in this routine.

Dome is a room. North of Dome is North Chapel. South of the Dome is South Chapel. West of the Dome is Western End. Quiet Corner is northwest of the Dome, north of Western End, and west of North Chapel. Loud Corner is east of North Chapel, northeast of Dome, and north of Eastern End. Eastern End is north of Dim Corner and east of Dome. Dim Corner is southeast of Dome and east of South Chapel. Ruined Corner is southwest of Dome, west of South Chapel, and south of Western End.
 
The Crypt is below the dome.
 
The church door is east of Eastern End and west of the Courtyard. The church door is a door.
 
Test me with "u / n / n / e / n / s / u / open door / e / n".

wi 7.13 Going from, going to
rb 6.9 Going, Pushing Things in Directions

103. Polarity ★★★

The main trick of this is always to record where the player has gone when he has just moved.

"Polarity"

The former location is a room that varies.

Here we record where the player has been before moving him; by calling this the "first carry out going rule", we make sure that this rule is followed during the going action before any other pieces of the movement occur. For more detail, see the chapters on advanced actions and on rules.

First carry out going rule:
   now the former location is the location.
 
Understand "go back" as retreating. Understand "back" or "return" or "retreat" as retreating.
 
Retreating is an action applying to nothing.
 
Carry out retreating:
   let way be the best route from the location to the former location, using doors;
   if way is a direction, try going way;
   otherwise say "You can't see an open way back."

And to deal with the case where the player has not yet moved:

When play begins: now the former location is the Dome.
 
Instead of retreating when the former location is the location: say "You haven't gone anywhere yet."
 
Dome is a room. North of Dome is North Chapel. South of the Dome is South Chapel. West of the Dome is Western End. Quiet Corner is northwest of the Dome, north of Western End, and west of North Chapel. Loud Corner is east of North Chapel, northeast of Dome, and north of Eastern End. Eastern End is north of Dim Corner and east of Dome. Dim Corner is southeast of Dome and east of South Chapel. Ruined Corner is southwest of Dome, west of South Chapel, and south of Western End.
 
The church door is east of Eastern End and west of the Courtyard. The church door is a door.
 
Test me with "back / n / go back / e / open door / go through door / go back".

wi 7.13 Going from, going to
rb 6.9 Going, Pushing Things in Directions

107. Provenance Unknown ★★★

Suppose we have a series of items that might be stacked on top of one another -- say a heavy television on a rolling cart, and we want the player to be able to move the cart with PUSH TELEVISION EAST just as well as with PUSH CART EAST.

This takes a little redirection, using a setting action variables rule. This is not a kind of rule we've encountered yet, and in fact we won't meet it until the Advanced Actions chapter; it is included here for the convenience of authors who want to modify the effect of pushing without reading that far ahead:

"Provenance Unknown"

Setting action variables for pushing something to:

if the noun is enclosed by a pushable between rooms thing (called the pushed item) which is in the location:

now the noun is the pushed item instead.

This rule says that any time we push an object that is on top of a stack of pushable objects, we should transfer the action to the item at the bottom of the stack.

The rest is merely a test case.

The heavy golden idol is on a roller board. The roller board is on a hovercraft.
 
The hovercraft, the tea trolley, and the skateboard are pushable between rooms.
 
The hovercraft is in Zeta Proximan Dig Field.
 
Zeta Proximan Dig Field is a room. "During the day, the field is massed with sweating native workers, overseers, and officials from central command. Now the spades, trowels, brushes, metal detectors, ground probes, plumb lines, and sighting tripods have been laid aside.
 
All that remains are the trenches and the fine grey dust that blows slowly across them; the moonlight; and the just-emerging outlines of an ancient and alien wall."
 
The Hover-Road is west of the Dig Field. "A long road hastily laid down, stretching east to west, from the dig site toward the safety of the city."
 
When play begins:
   say "You have, at last, loaded your illicit cargo without setting off any of the many and sensitive alarms set here; now it remains only to sneak out of the area, under the light of Zeta Proxima's lone green moon."
 
Test me with "push idol west / look / push roller board east / look".

wi 7.14 Going by, going through, going with
rb 6.9 Going, Pushing Things in Directions

108. Zorb ★★★

There are two aspects of Inform's handling of pushable objects that are particularly prime for modification. One is that we may want to change the language used to refuse the pushing of unpushable objects.

Second, Inform by default assumes that it is impossible to push objects in up or down directions. This makes lots of sense if the player is trying to push a wheelbarrow up a ladder; it makes less sense if instead we're pushing a ball up a slope.

We solve both problems with some syntax borrowed from the chapter on rulebooks: in the first case, we replace the old rule with a new one with more friendly phrasing; in the second, we remove the rule entirely. More about how to do this is described in the rulebooks chapter; and in general we can find out what rules contribute to any given action by looking at the Actions index. In this case, the action is "pushing it to", which has its own set of prerequisites (called check rules) that make sure the object can safely be pushed, before turning processing over to the going action.

"Zorb"

Section 1 - Procedure

The new can't push unpushable things rule is listed instead of the can't push unpushable things rule in the check pushing it to rules.

This is the new can't push unpushable things rule:

if the noun is not pushable between rooms:

say "[The noun] [are] not amenable to being pushed from place to place." instead.

The can't push vertically rule is not listed in any rulebook.

And now to provide a scenario where the player can push something up and down a hillside. Most of the rest of the example is there for local color and to provide a way to demonstrate these rule adjustments:

Section 2 - Scenario
 
The Steep Hill is a room. The Crest is above Steep Hill. The Valley is below Steep Hill.
 
The flat rock is a fixed in place thing in the Steep Hill.
 
The Zorb is a transparent open enterable container in the Steep Hill. "[if the player props the Zorb]The Zorb rests here, kept from further rolling by your support[otherwise]The Zorb is here[end if].". It is pushable between rooms. The description of the Zorb is "A giant plastic inflatable ball, like a hamster ball for humans[if someone is in the Zorb]. Inside [is-are list of people in the Zorb][end if]."
 
Lucy is a woman in the Zorb.
 
Carry out going with the Zorb when the Zorb contains Lucy:
   say "Lucy whoops delightedly as she rides along in the Zorb."
 
Every turn when the Zorb is not in the Valley and the player does not prop the Zorb:
   let next room be the room down from the location of the Zorb;
   if the player is not in the Zorb and the player can see the Zorb:
      say "The Zorb succumbs to gravity and rolls down toward [the next room].";
   move the Zorb to the next room;
   if the player is in the Zorb:
      say "The Zorb rolls you down the hill!";
      try looking;
   otherwise if the player can see the Zorb:
      say "The Zorb rolls ponderously but inevitably into the vicinity.";
 
Propping relates one person to one thing. The verb to prop means the propping relation.
 
Carry out going with the Zorb:
   now the player props the Zorb.
 
Before doing something when the action requires a touchable noun:
   if the noun is not the Zorb, now the player does not prop the Zorb.
 
Check waving hands when the player is propping something (called casualty):
   try the player releasing the casualty.
 
Carry out entering the Zorb:
   now the player does not prop the Zorb.
 
Understand "let go of [something]" or "let [something] go" or "release [something]" or "free [something]" as releasing. Releasing is an action applying to one thing.
 
Check releasing:
   if the player carries the noun:
      try dropping the noun instead.
 
Check releasing:
   if the player does not prop the noun:
      say "You are not supporting [the noun]." instead.
 
Carry out releasing:
   now the player does not prop the noun.
 
Report releasing:
   say "You let go of [the noun]."
 
Test me with "d / push zorb up / look / push zorb up / wave / d / d / push zorb up / release zorb / d / push zorb up / touch rock / push the flat rock south".

wi 7.14 Going by, going through, going with
rb 6.9 Going, Pushing Things in Directions

179. Owen's Law ★★★

Suppose we want the game to interpret "GO OUT" as "move towards an outdoors room, or towards a room with more exits than the current room", while "GO IN" means "move toward a room with fewer exits, or towards an indoors room". Thus going in repeatedly within a building would lead towards dead-ends, while going out repeatedly would lead towards the center of the building and then towards an exit to the outside world.

We start by encoding these rules as definitions:

"Owen's Law"

A room can be indoors or outdoors. A room is usually indoors.

Definition: a room is outward:

if it is not adjacent, no;

if it is indoors and the location is outdoors, no;

if it is outdoors and the location is indoors, yes;

if the number of rooms adjacent to it is greater than the number of rooms adjacent to the location, yes;

otherwise no.

Definition: a room is inward:

if it is not adjacent, no;

if it is outdoors and the location is indoors, no;

if it is indoors and the location is outdoors, yes;

if the number of rooms adjacent to it is less than the number of rooms adjacent to the location, yes;

otherwise no.

Instead of going nowhere when the noun is outside: try exiting.

Instead of exiting when the player is in a room:

if at least one room is outward:

let the destination be a random outward room;

	let the way be the best route from the location to	the destination;
	say "(that is, [way])[command clarification break]";
	try going the way instead;
	otherwise:
	say "It's not entirely obvious which way you mean. ";
	carry out the listing available exits activity.

Instead of going inside when the room inside from the location is not a room and at least one room is inward:

if more than one room is inward:

carry out the listing available exits activity;

otherwise:

let the destination be a random inward room;

let the way be the best route from the location to the destination;

say "(that is, [way])[command clarification break]";

try going the way instead.

Instead of going nowhere:

carry out the listing available exits activity.

This "listing available exits" is a refinement borrowed from a future chapter, which allows us to specify special listing and printing rules:

Listing available exits is an activity.
 
Rule for listing available exits:
   if going inside and an adjacent room is inward:
      say "From here 'in' could reasonably mean [a list of adjacent inward rooms].";
      rule succeeds;
   if exiting and an adjacent room is outward:
      say "From here 'out' could reasonably mean [a list of outward adjacent rooms].";
      rule succeeds;
   say "From here you can go [a list of adjacent rooms]."
 
Before printing the name of a room (called the target) while listing available exits:
   let aim be the best route from the location to the target;
   say "[aim] to the ".
 
Rule for printing the name of an unvisited room which is not the location:
   say "unknown location".
 
Dune is an outdoors room. "Hundreds of feet of dune stretch west to the beach, crisscrossed with dune-buggy tracks and the footprints of birds. To the east is a low-lying, boxy concrete installation."
 
Ocean Shores Military Installation is east of the Dune. It is an outdoors room. "The World War II emplacements, built in case of Japanese invasion, have never been destroyed, though with all the weapons and furnishings gone it is difficult to make much sense of the original structure. A doorway leads west into concrete-lined darkness; a rusty but reliable ladder ascends to a walkway overlooking the sea."
 
Walkway is above Ocean Shores Military Installation. "From here you have a long view of the dunes and the Pacific Ocean, complete with the rotting hull of a long-stranded vessel."
 
Dark Echoing Room is inside from Ocean Shores Military Installation. Dank Dripping Room is east of Dark Echoing Room. Narrow Room is south of Dark Echoing Room. Small Sealed Chamber is north of Dark Echoing Room. Room Smelling of Animal Urine is north of Dank Dripping Room. The description of a room is usually "It is dark in here, and feels unsafe."
 
Test me with "e / u / d / in / s / out / n / out / e / in / out / out / out".

wi 11.16 New conditions, new adjectives
rb 6.9 Going, Pushing Things in Directions

🔗

RB §6.10 Entering and Exiting, Sitting and Standing

Under ordinary circumstances, Inform does not keep track of the player's posture, nor of his exact location in a room. Lies ★ implements a room in which the player can lie in different positions on the floor, getting different views as a result.

Our other examples are all modifications of the way Inform handles player movement to make better default guesses at what he wants to do: Anchorite ★ adds a GET DOWN and DOWN command that work when the player is on a supporter, to accompany GET UP, GET OFF, and GET OUT (already understood). Get Axe ★ makes the player get out of a portable container before attempting to lift it - a consideration that comes up relatively rarely, but that might pertain to inflatable rafts, beanbag chairs, and other lightweight but capacious pieces of furniture.

Examples

206. Get Axe ★

We could now re-write the check rules so that any time someone (the player or someone else) tries to pick up a container which he is in, he will first get out:

"GET AXE"

This is the clever can't take what you're inside rule:

if the person asked is in the noun, try the person asked exiting;

if the person asked is in the noun, rule fails.

The clever can't take what you're inside rule is listed instead of the can't take what you're inside rule in the check taking rules.

Attic is a room. The unused coffin is in the Attic. The coffin is enterable and openable and open. Raskolnikov is a man in the coffin.

Persuasion rule for asking Raskolnikov to try doing something:

persuasion succeeds.

Test me with "raskolnikov, get coffin".

wi 12.12 Check rules for actions by other people
rb 6.10 Entering and Exiting, Sitting and Standing

290. Anchorite ★

With GET DOWN, we can replace the whole command, which will not interfere with the normal function of the TAKE verb, or allow the player to attempt to GET any other directions:

"Anchorite"

The Solitary Place is a room. "A glittering, shimmering desert without either locusts or honey." The pillar is an enterable supporter in the Solitary Place. "The broken pillar is short enough to climb and sit on." The description of the pillar is "Once it was a monument: a long frieze of battles and lion-hunts spirals up the side, in honor of an earthly king." The player is on the pillar.

Understand "get down" as exiting.

This doesn't cover the case where the player just types "DOWN", and we don't want to preempt the normal operation of the GO action here. So instead of writing a new understand instruction, we might catch this one at the action-processing level:

Instead of going down when the player is on a supporter:
   try exiting.
 
Test me with "down / enter pillar / get down / down / get down".

wi 17.2 New commands for old grammar
rb 6.10 Entering and Exiting, Sitting and Standing

310. Lies ★

To set the scene, and make new actions to provide for two of these ways:

"Lies"

The Laundry is a room. "An old Limehouse haunt, the Chinese laundry used by the down-trodden wives of the Tong of the Black Scorpion." The vast marble sink is here. "There is nothing obviously oriental about the vast marble sink, which is large enough to lie down inside. A wooden-rack floor, equipped for easy drainage, turns out also to be equipped for snagging the shoes of passers-by." The sink is an enterable container, fixed in place.

Lying down is an action applying to nothing. Report lying down: say "You lie down for a while in the middle of the Laundry, wondering about the point of existence, then get up again."

Lying near is an action applying to one thing. Report lying near: say "You lie down next to [the noun] for a while, mumbling to yourself."

Instead of lying near the sink, say "Lying down close to the cool butcher's marble slabs of the sink, your attention is caught by the sight of coolie shoes through a floor-level grille for ventilation. The game is afoot!"

So far, so good. Now for the grammar, where we create two new tokens: one for each of two groups of alternative prepositions.

Understand "beneath/under/by/near/beside/alongside/against" or "next to" or "in front of" as "[beside]".
 
Understand "on/in/inside" or "on top of" as "[within]".
 
Understand "lie down" as lying down.
 
Understand "lie down [within] [something]" as entering.
 
Understand "lie [beside] [something]" or "lie down [beside] [something]" as lying near.
 
Test me with "lie down / lie down on top of the sink / get out / lie down inside the sink / get out / lie down in front of the sink".

wi 17.13 New tokens
rb 6.10 Entering and Exiting, Sitting and Standing

🔗

RB §6.11 Waiting, Sleeping

The standard WAIT command makes time pass at the same rate that it would anyway - one minute per turn. In a story where events happen at specific times of day, though, we might want to give the player more control. Nine AM Appointment ★ shows how to give the player a WAIT 10 MINUTES command, while Delayed Gratification ★★ lets him WAIT UNTIL a specific time of day.

Ordinarily, Inform also refuses to allow the player to SLEEP and WAKE UP: the commands exist, but have no effect. Change of Basis ★★ lets the player put himself into a sleep state in which he cannot do anything. A somewhat more interesting expansion on this idea would be to let the player sleep and have dreams; there are no examples specifically of dream states, but we might consult the examples on scenes about how to disrupt one environment and move the player to another, entirely new one.

Examples

388. Nine AM Appointment ★

If there's some reason the player needs to be at a specific place and time, we might want to allow him to wait a number of minutes at once.

"Nine AM Appointment"

Waiting more is an action applying to one number.

Understand "wait [a time period]" or "wait for [a time period]" or "wait for a/an [a time period]" or "wait a/an [a time period]" as waiting more.

Carry out waiting more:

let the target time be the time of day plus the time understood;

decrease the target time by one minute;

while the time of day is not the target time:

follow the turn sequence rules.

The one nuance here is that after our wait command occurs, the turn sequence rules will occur one more time. So we need to subtract one minute from the parsed time to make the turn end on the desired number of minutes.

Report waiting more:
   say "It is now [time of day + 1 minute]."

And if we want to ensure that the player doesn't (accidentally or intentionally) put the interpreter through a really long loop, we could put an upper limit on his patience:

Check waiting more:
   if the time understood is greater than one hour, say "You really haven't got that kind of patience." instead.
 
The Specialist's Office is a room. The secretary is a woman in the Office. Instead of asking the secretary about "[appointment]", say "'Hang on just five more minutes,' she says, in a distracted manner."
 
Understand "appointment" or "specialist" or "doctor" as "[appointment]".
 
At 9:45 AM: say "At [the time of day in words], secretary glances at you and gives a reassuring smile."
 
Test me with "ask secretary about appointment / wait five minutes / g / g / wait 61 minutes / wait for half an hour / wait for a quarter of an hour / wait for an hour".

wi 19.2 Named rules and rulebooks
rb 6.11 Waiting, Sleeping

47. Change of Basis ★★

Suppose we want to allow the player to go to sleep some of the time:

"Change of Basis"

A person is either awake or asleep. A person is usually awake.

The important thing to note here is that it does not work to say "the player is either asleep or awake". This is because the player is not necessarily one specific person or thing during the game: the identity of the player can be changed, as we will see later.

So if we want to make rules about the properties of the player, we should attach these rules to the "person" kind.

Linear Algebra Class is a room. "The blackboard is covered with square arrangements of numbers. These are supposed to convey something to you, but mostly you're finding them soporific."

Now a few rules about changing from one state to the other:

Instead of sleeping: now the player is asleep; say "You drop off."
 
Instead of doing something other than waking up, waiting or sleeping when the player is asleep:
   say "Ssh! You're sleeping!"
 
Instead of sleeping when the player is asleep:
   say "Zzzz."
 
Instead of waking up when the player is asleep:
   now the player is awake;
   say "You come to suddenly, wiping drool from your lips."
 
Instead of doing something other than looking or sleeping when the player is awake:
   say "You'd really rather just sleep through this."
 
Test me with "wake up / sleep / look / z / sleep / wake up / look".

wi 4.7 New either/or properties
rb 6.11 Waiting, Sleeping

389. Delayed Gratification ★★

"Delayed Gratification"

Hanging around until is an action applying to one time.

Check hanging around until:

if the time of day is the time understood, say "It is [time understood] now!" instead;

if the time of day is after the time understood, say "It is too late for that now." instead.

Carry out hanging around until:

while the time of day is before the time understood:

follow the turn sequence rules.

Report hanging around until:

say "You yawn until [time understood]."

Understand "wait until [time]" as hanging around until.

The Empty Field is a room. "It's an ordinary empty field. Nothing to see here at all-- yet. Wait until 11:45 PM, though."

At 11:45 PM:

say "Suddenly the air is filled with light and the sounds of an approaching band. Over the crest of the hill comes a parade of singing, stomping, hooting people: and not just people, but dogs, horses, elephants, giraffes... There are banners, and candles, and a flag that glows eerie-green in the dark; there is a float shaped like an enormous turtle, its shell covered with winking green lights; there is an old man dressed as a skeleton, carried in a litter, his neck garlanded with dried chiles. There are small girls throwing rose petals from a basket, and grown women half-naked carrying the emblems of Bacchic revelry, and two little boys each with a silver basin of clear water. All these go by in procession, and you join on at the end.";

end the story finally.

Test me with "look / z / z / wait until 11:45 PM".

wi 19.2 Named rules and rulebooks
rb 6.11 Waiting, Sleeping

🔗

RB §6.12 Other Built-In Actions

Many other actions are themselves very simply implemented and provide only a shell for us to expand on according to the needs of a particular story. Many of these are discussed at more length in sections on various kinds of props and objects; in particular:

RB §6.13 Magic Words

Many fantasy games incorporate the idea of magic words that can be spoken. In implementing these, we want to be a bit flexible and accept a range of input regardless of whether the player explicitly speaks the command aloud: XYZZY, SAY XYZZY, or perhaps even CAST XYZZY. The inventively named Xyzzy ★ demonstrates how we might define such a command.

If we want to go even further and to allow the player also to use quotation marks, as in SAY "XYZZY", we may want to include Punctuation Removal by Emily Short, which allows for quotation marks to be stripped out of the player's input before it is understood.

Example

287. XYZZY ★

We have seen before how to define a new action from scratch, but we may want to review here, using a simple command that requires no objects.

"XYZZY"

Understand "xyzzy" or "say xyzzy" or "cast xyzzy" as casting xyzzy.

Casting xyzzy is an action applying to nothing.

Check casting xyzzy:

if the player does not wear the amulet of elocution, say "You are unable to articulate the second 'z' separately from the first, and the spell fails in a disdainful puff. Must be Parisian magic." instead;

if the player has the plate, say "The plate of cheeses twitches uncomfortably, aware that it should be doing something, but not sure what." instead.

Carry out casting xyzzy:

move the plate to the player.

Report casting xyzzy:

say "Under the influence of the Amulet of Elocution, you pronounce this as Xhi-zee. And lo, from nowhere, a [plate] appears!"

The amulet of elocution is a wearable thing. It is carried by the player. The description is "A heavy gold ring on a chain. If heated in an ordinary house fire, it glows with the words, 'Moses Supposes His Toeses Are Roses.'"

The plate is a portable supporter. On the plate is a very ripe ooze. Instead of smelling the ooze, say "It smells like socks. This is going to be wonderful." The ooze is edible. The printed name of the plate is "plate[if the plate supports the ooze] of cheese[end if]". The description of the ooze is "Definitely genuinely cheese." Understand "cheese" as the ooze.

Instead of eating the ooze: now the ooze is nowhere; say "You are transported..."; move the player to Paradise.

The Cheez Factory is a room. "All around you are squares of pressed orange polymer, or possibly cheez. Your only hope is the magic word your uncle taught you: XYZZY." The squares of pressed orange polymer are scenery in the Factory. The description is "You see nothing special about the squares of pressed orange polymer. Nothing special at all." Understand "square" or "cheez" as the squares.

Paradise is a room. The description is "Well, it might just be one of the posh upper rings of purgatory, if you're entirely honest with yourself."

Test me with "x squares / x amulet / x cheese / xyzzy / wear amulet / xyzzy / x ooze / smell ooze / eat ooze".

XYZZY is a magic word from the original Adventure, and many other games respond to it with some sort of amusing message.

wi 17.1 Understand
rb 6.13 Magic Words

🔗

RB §6.14 Remembering, Converting and Combining Actions

Sometimes we want Inform to apply a player's action to a different target than the one specified: for instance, directing all (or almost all) commands from the doorknob to the door of which it is a part. Fine Laid ★ demonstrates how to do this. Along the same lines, Lucy ★ shows how to direct a player's conversation action to apply to a new conversation topic.

We can also record a series of actions performed by the player or by another character.

Cactus Will Outlive Us All ★ demonstrates characters each of whom reacts to a very specific provocation; I Didn't Come All The Way From Great Portland Street ★ implements a game show in which the player is not allowed ever to repeat an action he has already performed; and Leopard-skin ★ implements a maze which the player can escape only by performing a specific sequence of actions.

Anteaters ★★ provides a peculiar gizmo that can remember actions performed in its presence and force the player to reiterate them.

Examples

88. Fine Laid ★

Sometimes it is useful to direct all -- or almost all -- actions from one object to another. For the sake of argument, say we have a sheet of paper with writing on it, and (because we're very meticulous) we want to let the player examine the writing and get a customized response, different from when he just examines the sheet of paper. But for all other purposes -- say, TAKE or TASTE -- we want the two objects to be treated as one.

Here, we approach the problem by changing the noun and/or the second noun of the current action, then issuing a new command to "try the current action". Because we've changed the noun and second noun, the "current action" at this point is different from the one generated originally by the player's command.

"Fine Laid"

High Street Stationer is a room.

The sheet of paper is a thing in High Street Stationer. The writing is part of the sheet of paper.

The description of the sheet of paper is "A beautiful sheet of heavy cream paper." The description of the writing is "Delicate and spidery."

Instead of tasting the sheet of paper, say "You might need more fiber in your diet, but this isn't the way.".

Before doing something other than examining when the current action involves the writing:

if the writing is the noun, now the noun is the sheet of paper;

if the writing is the second noun, now the second noun is the sheet of paper;

try the current action instead.

Test me with "examine sheet of paper / examine writing / get writing / taste writing".

wi 7.4 Try and try silently
rb 6.14 Remembering, Converting and Combining Actions

92. Lucy ★

Occasionally we will want to replace the player's question topic with another of our own devising. We can do this in the simplest possible case like so:

"Lucy"

The International Boardgame Championship is a room. Lucy is a woman in the Championship.

Instead of asking Lucy about "checkers":

try asking Lucy about "games".

Instead of asking Lucy about "games",

say "'I don't like games,' she sniffs."

Test me with "ask lucy about checkers / ask lucy about games".

Note that this syntax did not work in older versions of Inform; it is now safe.

wi 7.6 Reading and talking
rb 6.14 Remembering, Converting and Combining Actions

220. Cactus Will Outlive Us All ★

"Cactus Will Outlive Us All"

Death Valley is a room. Luckless Luke and Dead-Eye Pete are men in the Valley. A cactus is in the Valley. Persuasion rule: persuasion succeeds.

A person has an action called death knell. The death knell of Luckless Luke is pulling the cactus. The death knell of Dead-Eye Pete is Luke trying dropping the cactus.

Before an actor doing something:

repeat with the victim running through people in the location:

let the DK be the death knell of the victim;

if the DK is not waiting and the current action is the DK:

say "It looks as if [the DK] was the death knell for [the victim], who looks startled, then nonexistent.";

now the victim is nowhere.

If we leave it at that, then pulling the cactus will kill Luckless Luke but then say "Nothing obvious happens.", which seems like a bit of an anti-climax. So we add a special case response for that one:

After pulling the cactus when Luckless Luke was in the location:
   say "That's a real shame."
 
Test me with "get cactus / drop cactus / luke, get cactus / luke, drop cactus / pull cactus / look".

wi 12.20 Stored actions
rb 6.14 Remembering, Converting and Combining Actions

429. Leopard-skin ★

Suppose (as in Infocom's Leather Goddesses of Phobos) that we have a maze that the player can escape only by performing the correct sequence of actions in the correct order. One way to do this would be to keep a list of the player's most recent actions, and see whether these match up with the combination we have established as the maze's solution.

For instance:

"Leopard-skin"

The Fur-Lined Maze is a room. "This seemingly endless sequence of rooms is decorated in a tasteful selection of exotic furs and gilded fixtures."

Clapping is an action applying to nothing. Understand "clap" as clapping.

Kweepaing is an action applying to nothing. Understand "kweepa" as kweepaing.

Carry out clapping:

say "You clap."

Carry out kweepaing:

say "You holler 'KWEEPA!' triumphantly."

The maze-sequence is a list of stored actions that varies.

When play begins:

add jumping to the maze-sequence;

add clapping to the maze-sequence;

add kweepaing to the maze-sequence.

The attempted-sequence is a list of stored actions that varies.

Every turn when the player is in the Fur-Lined Maze:

truncate the attempted-sequence to the last two entries;

add the current action to the attempted-sequence;

if the attempted-sequence is the maze-sequence:

say "That does it! You are instantly transported from the maze!";

end the story finally.

Test me with "hop / clap / clap / hop / kweepa / hop / clap / kweepa".

wi 21.10 Lengthening or shortening a list
rb 6.14 Remembering, Converting and Combining Actions

434. I Didn't Come All The Way From Great Portland Street ★

There is very little to this, in fact. The tricky rule to enforce is Repetition: the player is forbidden to repeat any previously tried action. We keep track of this by keeping a set of past actions, which for want of a better term is called the "tally". All we need to do is:

if the current action is listed in the tally, challenge for "Repetition of [the current action]!";
otherwise add the current action to the tally.

Note that the tally can never contain duplicates, and that when, at the end of the round, we print it out, we sort it first - this makes a more natural-looking sentence. (Sorting a list of actions uses the natural order for actions: compare the sequence on the Actions page of the Index.) The full text, then, is:

"I Didn't Come All The Way From Great Portland Street"

The Paris Theatre is a room. An instrument is a kind of thing. The violin, the tuba, the xylophone and the triangle are instruments. The violin is inside the case. The tuba, the xylophone, the radish, the case, the bust of Nicholas Parsons, the purple felt hat and the triangle are in the Paris Theatre.

The Round is a scene. The Round begins when play begins. The Round ends when the turn count is 10.

The tally is a list of stored actions that varies.

When the Round begins:

say "'And the subject on the card is... musical instruments. Will you carry out for us something to do with that, please, for ten turns starting - now!'"

When the Round ends:

sort the tally;

say "Phweeep![paragraph break]'So, when the whistle goes ten turns are up, you get a point for acting when the whistle blows, and in that round you entertained us by [the tally], and you also get a bonus point for keeping going until the whistle went.'";

end the story finally.

To challenge for (infraction - text):

say "Bzzzzt! 'And [one of]Clement Freud[or]Derek Nimmo[or]Kenneth Williams[or]Peter Jones[at random] has challenged.'[paragraph break]'[infraction]'[paragraph break]'Well, as it's your first time playing the game, and the audience was enjoying your contribution so much, I will disallow the challenge, you have [10 minus the turn count] turn[s] left on musical instruments, starting... now!"

Before doing something:

if the current action is listed in the tally, challenge for "Repetition of [the current action]!" instead;

otherwise add the current action to the tally;

if waiting, challenge for "Hesitation!" instead;

if not looking and not waiting and the noun is not an instrument and the second noun is not an instrument, challenge for "Deviation!" instead.

Test me with "look / wait / examine bust / take tuba / get triangle / hit xylophone / get tuba / examine tuba / get violin".

(The Paris Theatre in Lower Regent Street, London, was for many years the home of BBC radio panel games.)

wi 21.11 Variations: arrays, logs, queues, stacks, sets, sieves and rings
rb 6.14 Remembering, Converting and Combining Actions

222. Anteaters ★★

"Anteaters"

A book is a kind of thing. Understand "book" as a book. A book has a table name called the contents.

Report consulting a book about:

say "You flip through [the noun], but find no reference to [the topic understood]." instead.

Instead of consulting a book about a topic listed in the contents of the noun:

say "[reply entry][paragraph break]".

The Guide to Desert Fauna is a book. The contents of the Guide is the Table of Critters.

Table of Critters

topic	reply
"spines"	"You flip through the Guide for a while and eventually realise that spines are flora, not fauna."
"anteater colonies"	"The giant anteater, which grows to six feet in size and can kill a jaguar, is a solitary animal, found in many habitats, including grasslands, deciduous forests and rainforests. It does not form colonies. That's ants. They're actually quite easy to tell apart."

Death Valley is a room. The Guide is in the Valley.

The gizmo is in Death Valley. The gizmo has an action called idea. The description of the gizmo is "The gizmo is hard to describe, but it projects an idea of [idea]."

Before when the player carries the gizmo and the idea of the gizmo is waiting:

say "[The gizmo] eagerly soaks up the whole idea of [the current action].";

now the idea of the gizmo is the current action.

After dropping the gizmo:

say "The percussion of the fall seems to have shaken the gizmo's idea loose! There's nothing for it now but [idea of the gizmo].";

try the idea of the gizmo;

now the idea of the gizmo is waiting.

Test me with "get guide / look up spines in guide / x gizmo / get gizmo / i / x gizmo / drop gizmo / get gizmo / look up anteater colonies in guide / x gizmo / drop gizmo".

wi 12.20 Stored actions
rb 6.14 Remembering, Converting and Combining Actions

🔗

RB §6.15 Actions on Multiple Objects

Inform allows a handful of actions - TAKE, DROP, PUT, INSERT - to apply to more than one item at a time, so that the player can move things around easily.

The general principle is that multiple objects are allowed if the actions are likely to be successful but not interesting most of the time, and if they're things that the player could plausibly do all at once. For most actions, the use of ALL would seem weirdly indiscriminate: EAT ALL, say, describes very implausible behavior, and EXAMINE ALL would likely generate a screenful of text at once.

But this is all under our control. To create an action that uses multiples, or to allow the use of multiple objects with an already-existing action, we need to create an understand statement that uses the "[things]" token (note the plural). For instance:

Understand "give [things] to [someone]" as giving it to.

This would let the existing give action apply to multiple objects, in just the same way that "take" does. Shawn's Bad Day ★ demonstrates how we might allow EXAMINE ALL to print descriptions of every visible item.

Alternatively, we could generate a new action:

Understand "give [things] to [someone]" as multiply-giving it to. Multiply-giving it to is an action applying to one carried thing and one thing.

(In theory the language here should perhaps be "several carried things" -- but Inform is still going to process multiply-giving item by item, unless we redirect it. More about this in a moment.)

When handling an action that uses the "[things]" token, the parser makes a list of every item to which it is going to apply the action: this is called the multiple objects list. The multiple objects list can be the result of a vague request (GET ALL) or a specific one involving identical multiples (GET PENNIES, GET THREE APPLES) or a very specific one involving unique, named nouns (GET GERBIL, APPLE, AND POMEGRANATE).

We can manipulate what Inform includes in "ALL" in sentences like TAKE ALL with the "deciding whether all includes…" activity; for instance

Rule for deciding whether all includes scenery: it does not.

prevents TAKE ALL from applying to things that can't be moved anyway, avoiding lots of lines like

tree: That's hardly portable.
swing set: That's hardly portable.

A slightly tedious technical note: the multiple objects list is not strictly a list in the standard Inform sense, because it is used so frequently in parsing that it would be cumbersome to handle it with the more flexible but less efficient structure used for lists. However, if we want to manipulate the multiple objects list as though it were an ordinary list -- that is, sort it, rotate it, truncate it, remove entries from it, etc -- we may do so by creating a list like this:

let L be the multiple object list.

and later after making L conform to our desires:

alter the multiple object list to L.

Inform next repeatedly runs the action rulebook for the action generated, using each item from the multiple object list as "noun" in turn (or as "second noun", if that's where the [things] token appeared in the understand line). Since it is possible to alter the multiple object list before the "generate action rule" portion of the turn sequence consults the rulebooks, we can also affect the order in which the player's matched objects are handled; see Formicidae ★★. We should not attempt to change the multiple object list after this point, because this is likely to introduce bugs.

Each time Inform tries the action on a new noun, it prefixes the action-attempt with the name of the item it's currently working on. This is where we get such output as "frog eyeballs:" and "newt toes:" in long lists like

frog eyeballs: Taken.
newt toes: Taken.

These names are generated by the "announce items from multiple object lists rule" in the action-handling rules; Escape from the Seraglio ★★ shows how to alter them. In the context of this rule, the thing we are currently printing the name of can be called "the current item from the multiple object list".

Suppressing names of objects entirely, while occasionally tempting, may have unintended consequences, especially if some of the attempted actions are prevented by check rules that themselves print things. It is safest to suppress the multiple object names in the case where we already know that the action will succeed wherever it is attempted (more often for observational actions like examining than for manipulative actions like taking, or where we mean to completely override default handling).

Given that our hypothetical "multiply-giving" applies to each given object in turn, it might seem to be useless to create "multiply-giving" as an action different from "giving" -- but the convenience is that manipulating the multiple object list makes it possible to group behavior artificially. The trick here is that, on the first pass of the multiply-giving rulebook, we look at the entire multiple object list, perform actions, print output, and set a flag saying that the action has been handled. The flag tells Inform not to do or print anything for any of the subsequent passes through that action rulebook; thus we artificially create a situation where, instead of performing an action on each object in turn, Inform acts once on the entire group. That allows us to assess the cumulative qualities of the group and have the action respond differently than it might when assessing each item individually.

The Facts Were These ★★ demonstrates how we might write an action for GIVE THREE DOLLARS TO MAN or GIVE PIE AND HAT TO MAN where the man would only accept the collective gift when its total proved satisfactory.

Western Art History 305 ★★ demonstrates how we might allow EXAMINE, which doesn't normally permit multiple objects, to take them, but to give vaguer responses to a mass examination than an individual one.

Examples

294. Shawn's Bad Day ★

We can add the handling of multiple objects to an existing action simply by adding in a line of grammar using "[things]". In response, Inform will consider every object accepted by the token, and perform the action once for each of those objects. Thus:

"Shawn's Bad Day"

The Treasury is a room. The vault is a lockable locked closed openable container in the Treasury. It is fixed in place. "A massive vault fills up one wall." The description is "The vault's system includes [a list of things which are part of the vault]."

A little green light, a little blue light, a little red light, a thin black pane of glass, a laser beam, a retinal scanner, a thumbprint ID plate, a dial, and a large lever are part of the vault.

The security guard is a man in the Treasury. The description is "His name is Shawn, and he doesn't look happy."

The description of the green light is "Off." The description of the blue light is "Tranquilly on." The description of the red light is "Angrily flashing."

Understand "examine [things]" as examining.

Test me with "examine all".

wi 17.4 Standard tokens of grammar
rb 6.15 Actions on Multiple Objects

327. The Best Till Last ★★

If a single command asks to do many things, some dull and some exciting, we may want to save the good ones for the end.

"The Best Till Last"

The Funky Ignition Lounge is a room. "This is where all evenings end." The stick of gelignite, the solid magnesium footstool, the vetiver candle, and the vodka bottle are here.

The burn description of the vetiver candle is "It burns right down, expensively but gothically."

The player carries an inexpensive firework. The description of the firework is "It is a cardboard tube with red and green stripes along the outside, and a fuse sticking out of the end." The burn description of the firework is "It ignites gloriously! You take a few hasty steps back in order to avoid burning yourself, and not a moment too soon. Red and green sparks fly out of the tube, and there's a whistling noise punctuated by several loud cracks."

The player carries a lighter. The description of the lighter is "You don't smoke, but you like to have access to flame now and then anyway."

Burning it with is an action applying to one thing and one carried thing.

Understand "burn [things] with [something preferably held]" as burning it with.

The block burning rule is not listed in any rulebook.

A thing has some text called the burn description.

Check burning something:

if the player carries the lighter:

try burning the noun with the lighter;

else:

try burning the noun with the noun.

Check burning something with something when the second noun is not the lighter:

say "Your trusty lighter is the best flame source available to you." instead.

Check burning something with something:

if the burn description of the noun is "":

say "Best not." instead.

Carry out burning something with something:

now the noun is nowhere.

Report burning something with something:

say "[burn description of the noun][line break]".

A multiple action processing rule when the action name part of the current action is the burning it with action (this is the orderly burn rule):

let L be the multiple object list;

let dull list be a list of objects;

let fun list be a list of objects;

repeat with item running through L:

if the burn description of the item is "":

add item to dull list;

else:

add item to fun list;

let F be the dull list;

add fun list to F;

alter the multiple object list to F.

Test me with "burn all with lighter".

wi 17.20 Multiple action processing
rb 6.15 Actions on Multiple Objects

328. Western Art History 305 ★★

In a gallery, there are many individual things to look at, but you can also get a general impression by just examining them as a collection.

First, we'll make a kind for the paintings exhibited in the gallery, and then we'll also make a special object to represent all of them as a mass:

"Western Art History 305"

A painting is a kind of thing. A painting is usually fixed in place. Understand "painting" as a painting. Understand "paintings" as the plural of painting.

The painting-collective is a thing. The printed name of the painting-collective is "paintings". The description of the painting-collective is "There's [a list of visible paintings]."

We could if we wanted tweak the description to be different in style in different rooms of the gallery, but this will do for now. Next we need to make it possible to type something like EXAMINE PAINTINGS, which normally wouldn't work because the Standard Rules don't tell Inform to recognise multiple objects with the EXAMINE command (unlike, say, DROP or TAKE). This is easy:

Understand "examine [things]" as examining.

Now to make use of the special object. If the player types EXAMINE PAINTINGS, the multiple object list will become a list of the visible paintings. The following rule looks at this list: if it contains more than one painting, it replaces them with the painting-collective instead. Now there's only one examining action, so we get a reply like "There's an abstract painting, a pointilist painting and a French academic painting." instead of a list of descriptions of each in turn.

A multiple action processing rule when the current action is examining (this is the examine kinds rule):
   let L be the multiple object list;
   let F be L;
   let the painting count be 0;
   repeat with item running through L:
      if the item is a painting:
         increment the painting count;
         remove the item from F;
   if the painting count is greater than one:
      add the painting-collective to F;
      alter the multiple object list to F.

And now some art to try this out on:

Gallery is a room. "Various paintings hang on the walls of this gallery, awaiting critical attention. A side chamber to the north contains smaller works."
 
The abstract painting, the pointilist painting, and the French academic painting are paintings in the Gallery.
 
North of the Gallery is the Side Chamber. A handsome miniature is a painting in the Side Chamber. The description of the handsome miniature is "The miniature depicts a uniformed soldier of the late 18th century, with braid on his shoulders and a curl in his beard."
 
The player carries a small notebook. The description of the notebook is "It contains the notes you've taken so far towards a paper for Western Art History 305. So far you're still feeling a bit uninspired."
 
Test me with "x paintings / x all / n / x paintings / x all".

wi 17.20 Multiple action processing
rb 6.15 Actions on Multiple Objects

410. Escape from the Seraglio ★★

"Escape from the Seraglio"

Section 1 - Special Announcement Rules

The number of takes this turn is a number that varies. Every turn: now the number of takes this turn is 0.

The friskily announce items from multiple object lists rule is listed instead of the announce items from multiple object lists rule in the action-processing rules.

This is the friskily announce items from multiple object lists rule:

if taking:

if the current item from the multiple object list is not nothing:

increment the number of takes this turn;

say "[if number of takes this turn is 1]First [otherwise if the number of takes this turn is 2]And then [otherwise if the number of takes this turn is 3]And I suppose also [otherwise if the number of takes this turn is 7]And on we wearily go with [otherwise if the number of takes this turn is 9]Oh, and not forgetting [otherwise]And [end if][the current item from the multiple object list]: [run paragraph on]";

otherwise:

if the current item from the multiple object list is not nothing, say "[current item from the multiple object list]: [run paragraph on]".

Rule for deciding whether all includes the person asked: it does not.

Rule for deciding whether all includes a person when taking: it does not.

Section 2 - The Scenario

The Palm Chamber is a room. Sarissa is a woman in the Palm Chamber.

The Palm Chamber contains a bottle of ink, a quill pen, a tangerine, a bunch of grapes, a length of silken rope, some perfume, a cake of incense, a fitted leather bodice, a sapphire anklet, an illustrated novel, a whip, and a heavy iron key.

A persuasion rule for asking Sarissa to try taking the key:

say "Sarissa nervously demurs, knowing that it is forbidden.";

persuasion fails.

A persuasion rule: persuasion succeeds.

Test me with "take all / drop all / sarissa, take all".

wi 19.15 Two rulebooks used internally
rb 6.15 Actions on Multiple Objects

427. Formicidae ★★

Suppose we have an item that produces an interesting result the first time the player lifts it -- a rock with dangerous ants revealed underneath. The effect of the surprise is a little weakened, though, if the player sees that response as the result of a TAKE ALL, when it might be printed like this:

>[3] get all
tent peg: Taken.
water flask: Taken.
trading permit: Taken.
innocent-looking rock: You reach for the rock and turn it over to reveal a thriving colony of flesh-eating ants. Needless to say, you drop the rock and jump back with a decidedly effeminate scream. They can probably hear you all the way back in the base camp.
rusty nail: Taken.
 
[Your score has just gone down by two points.]

The calm response to "rusty nail" looks odd now, and the score change is disconnected from the event that caused it.

To manage this, we might institute a system so that interesting objects are handled last in their list, like so:

"Formicidae"

Use scoring.

Section 1 - Procedure

The magic rule is listed before the generate action rule in the turn sequence rules.

A thing has a number called dramatic potential.

This is the magic rule:

let L be the multiple object list;

if the number of entries in L is greater than 1:

sort L in dramatic potential order;

alter the multiple object list to L.

Section 2 - Scenario

The Foothills is a room. "The land has become hilly; though the soil is still mostly coarse yellow sand, clumps of grass are able to grow in the shadier places. Deep wagon ruts running from the southwest towards the mountains in the northeast show where generations of caravans have already passed."

The water flask, the tent peg, and the trading permit are things in Foothills.

The rock is a thing in Foothills. Before printing the name of the rock when the rock is not handled: say "innocent-looking ". The dramatic potential of the rock is 10.

The rusty nail is a thing in Foothills.

The ant colony is a fixed in place thing. "A busy group of ants are crawling to and fro in the unaccustomed sun." Rule for deciding whether all includes the ant colony while taking: it does not.

Instead of taking the rock when the rock is handled:

say "It might still have a stray ant or two on it."

After taking the rock:

now the rock is handled;

move ant colony to the location;

move the rock to the location;

say "You reach for the rock and turn it over to reveal a thriving colony of flesh-eating ants. Needless to say, you drop the rock and jump back with a decidedly effeminate scream. They can probably hear you all the way back in the base camp.";

decrease score by 2.

Test me with "get peg / drop peg / get all / get rock".

Note that while one could also manipulate the object list to add or remove items at this stage, there's a simpler way to control what Inform considers "ALL" to mean in commands: see the activity "Deciding whether all includes" in the activities chapter.

wi 21.6 Lists of objects
rb 6.15 Actions on Multiple Objects

430. The Facts Were These ★★

Occasionally it happens that we want to process an action on multiple items differently than we would if the player had just typed each of the individual actions separately. In this example, the reason is that we can only successfully GIVE items when their combined value passes a certain threshold amount; otherwise the recipient will reject them.

This works as an implementation of money, if we give value only to cash objects (though several other implementations of cash are available, most of which are simpler and more efficient). We could also imagine a mechanic like this being used for a bargaining or auction game as well, given a society that deals in objects rather than credits.

In order to consider all the items in the gift at once, we create an action that applies to multiple objects, but will in fact test the whole object collection during the first pass and print a definitive answer to whether the action succeeded. All subsequent times the game consults the rulebook will be stopped at the very beginning. No further processing will occur or output be printed.

"The Facts Were These"

Section 1 - Procedure

We start by creating the idea that everything in the game has a monetary value:

A price is a kind of value. $10 specifies a price. A thing has a price.
 
Understand "give [things preferably held] to [someone]" as multiply-giving it to. Understand "give [things] to [someone]" as multiply-giving it to.  Multiply-giving it to is an action applying to two things.

A subtlety here: we say "things preferably held" to prefer items that the player is holding (so if the player has two dollars in hand and a third lies on the ground, he will use just the two he has).

The second grammar line allows Inform to match things that aren't held if it can't make up the list from things that are. If all three dollars are on the ground, the player can pick them up before spending them.

We do not, however, make multiply-giving apply to a "carried" item, because that will generate implicit takes of those items in a way that will mess up our action reporting. Instead, we're going to build the implicit takes into the system in a different way, one that permits us to collate the reports more attractively and print a short, one-sentence list of anything that the player had to pick up.

A thing can be given or ungiven. A thing is usually ungiven.

This is for record-keeping purposes so that we can print an attractive list of what was given at the end of the turn.

First check multiply-giving it to:
   if already gave at the office is true:
      stop the action.
 
Already gave at the office is a truth state that varies.

"Already gave at the office" is the perhaps-excessively-named flag that keeps track of whether we've already done this action once.

Check multiply-giving something to the player:
      now already gave at the office is true;
      say "You can hardly bribe yourself.[paragraph break]" instead;

The following rule is longish because it processes the entire list at once, generating implicit takes if necessary (but processing those implicit takes silently according to its own special rule, so that the output can be managed attractively). We are also, at the same time, calculating the total value of the player's offer.

Check multiply-giving it to:
   let L be the multiple object list;
   let bribe-price be $0;
   repeat with item running through L:
      if the player does not carry the item:
         abide by the ungivability rules for the item;
         carry out the implicitly taking activity with the item;
         if the player does not carry the item:
            now already gave at the office is true;
            say "You can't include [the item] in your bribe, since you're not holding [them]![paragraph break]" instead;
      increase bribe-price by the price of item;
   if the number of entries in the recently-collected list is greater than 0:
      repeat with item running through the recently-collected list:
         now item is marked for listing;
      say "You pick up [the list of marked for listing things] and make your offer. [run paragraph on]";
      now everything is unmarked for listing;
   if the bribe-price is less than the price of the second noun:
      now already gave at the office is true;
      say "[The second noun] angrily rejects your piffling bribe.[paragraph break]" instead.

The bit about making some items "marked for listing", above, rather than printing the list directly, is that using the "[the list of….]" syntax guarantees that Inform will respect grouping rules in writing its description. For instance, if the player has automatically taken all three dollars, the output will say "the three dollars" instead of "the dollar, the dollar, and the dollar."

Carry out multiply-giving it to:
   let L be the multiple object list;
   repeat with item running through L:
      now the second noun carries the item;
      now the item is given;
   now already gave at the office is true;
 
Report multiply-giving it to:
   say "[The second noun] rather shamefacedly tucks [the list of given things] away into a pocket.[paragraph break]".

Now we create our own variation of implicitly taking in order to customize the output for the multiply-giving action. The "ungivability rules" should disallow any object that the player absolutely cannot take, because we want "carry out the implicitly taking activity" to succeed every time -- and therefore not print out any less-attractive results from implicit takes that don't succeed. Otherwise, the player's GIVE TREE AND DOG TO ATTENDANT might produce the reply "That's fixed in place" -- without specifying which object is fixed in place.

Because of the way this works, we will want to be careful: if we have any "instead of taking…" rules for special objects in the game, we should be sure to mirror those with an ungivability rule to print something more suitable in the case that the player tries taking that object as part of the multiple giving action.

The ungivability rules are an object-based rulebook.
 
An ungivability rule for a person:
   now already gave at the office is true;
   say "Slavery is illegal.[paragraph break]" instead.
 
An ungivability rule for something (called the item) which is enclosed by someone who is not the player:
   now already gave at the office is true;
   say "[The item] [aren't] yours to give.[paragraph break]" instead.
 
An ungivability rule for something which encloses the player:
   now already gave at the office is true;
   say "You don't want to end up as part of the gift.[paragraph break]" instead;
 
An ungivability rule for something (called the item) which is part of something:
   now already gave at the office is true;
   say "[The item] [are] attached to [a random thing which incorporates the item][paragraph break]" instead.
 
An ungivability rule for something (called the item) which is scenery:
   now already gave at the office is true;
   say "[The item] [are] unremovable.[paragraph break]" instead.
 
An ungivability rule for something (called the item) which is fixed in place:
   now already gave at the office is true;
   say "[The item] [are] fixed in place.[paragraph break]" instead.
 
An ungivability rule for a direction (called the item):
   now already gave at the office is true;
   say "[The item] [are] not susceptible to giving.[paragraph break]" instead.
 
Rule for implicitly taking something (called target) while multiply-giving:
   silently try taking the target;
   if the player carries the target:
      add the target to the recently-collected list.
 
The recently-collected list is a list of objects that varies.

And since we don't want to list the individual objects separately:

The selectively announce items from multiple object lists rule is listed instead of the announce items from multiple object lists rule in the action-processing rules.
 
This is the selectively announce items from multiple object lists rule:
   if multiply-giving:
      do nothing;
   otherwise:
      if the current item from the multiple object list is not nothing:
         say "[current item from the multiple object list]: [run paragraph on]".

And now, since this ought to work symmetrically if the player provides just one high-value item:

Check giving something to someone:
   if the price of the noun is less than the price of the second noun:
      say "[The second noun] angrily rejects your piffling bribe." instead.

As we've seen elsewhere, the giving action by default returns a refusal, but is also written to start working if we remove the blockage. So we do that here, and revise the report rule to match the report rule we have for multiple giving.

The block giving rule is not listed in any rulebook.
 
The new report giving rule is listed instead of the standard report giving rule in the report giving it to rules.
 
This is the new report giving rule:
   say "[The second noun] rather shamefacedly tucks [the noun] away into a pocket."

After each instance of the multiply-giving action, we need to clear the variables we used to track its state. We could do this in "Before reading a command", but that's unsafe because the player might type GIVE PIE AND CAP TO ATTENDANT. GIVE DOLLARS TO ATTENDANT. all on a single line, and we would like to be able to clear the variables between one action and the next. The correct place to attach this behavior is immediately before the generate action rule, thus:

The before-generation rule is listed before the generate action rule in the turn sequence rules.
 
This is the before-generation rule:
   now every thing is ungiven;
   now already gave at the office is false;
   truncate the recently-collected list to 0 entries.
 
Section 2 - Scenario
 
The Morgue Office is a room. "This is not the Morgue itself; this is only its outer office. The familiar room full of silver drawers and cold air lies beyond."
 
The Morgue Attendant is a man in the Morgue Office. "The Attendant has seen you come through a number of times, and is becoming suspicious of your abiding interest in dead people." The description is "The Morgue Attendant is fifty-four years, six months, five days, and three minutes old." The price of the Morgue Attendant is $3.
 
A dollar is a kind of thing. The player carries three dollars.  The price of a dollar is always $1.
 
The player carries a miniature rhubarb pie. The price of the miniature rhubarb pie is $5.
 
The player carries a knitted cap. The price of the knitted cap is $2.
 
Test me with "test dollars / purloin three dollars / test multi-line / purloin three dollars / purloin pie / purloin cap / test specificity / purloin three dollars / test largesse / test mixed-gift".
 
Test multi-line with "give dollar and pie to attendant. give dollars and cap to attendant".
 
Test dollars with "drop all / give dollar to Morgue Attendant / give dollars to Morgue Attendant / get dollars / give dollars to morgue attendant / purloin three dollars / drop dollars / give dollars to Morgue Attendant".
 
Test specificity with "give three dollars to Morgue Attendant".
 
Test largesse with "give pie to Morgue Attendant".
 
Test mixed-gift with "give dollar and cap to Morgue Attendant / get cap / give dollar and cap to morgue attendant / give me and dollar to attendant".

PURLOIN, used in the tests here, is a special debugging command that allows the player to acquire objects that wouldn't otherwise be possible to take. It is only active in non-release versions of the story. For more about debugging commands, see the chapter on Testing and Debugging.

wi 21.10 Lengthening or shortening a list
rb 6.15 Actions on Multiple Objects

🔗

RB §6.16 Alternate Default Messages

Often we will want to replace the text produced by Inform by default: this includes quite a wide range of text, much of which either describes the success of a command or explains why the action failed.

Inform provides the Responses system to enable default messages like "You can't go that way" to be changed, and this is capable of making large-scale changes. This is especially useful if we want to give the viewpoint character a distinctive voice and set of mannerisms.

🔗

RB §6.17 Clarification and Correction

Some commands and some objects raise special challenges when it comes to working out the player's intention.

Sometimes this can be done with good rules about the assumptions Inform should make. Alpaca Farm ★ demonstrates a USE command, always a challenge because USE can mean very different actions with different items.

There are also times when we need to ask the player for more information. Apples ★ demonstrates how sensibly to use properties to disambiguate between similar objects, while Walls and Noses ★★★ rephrases the disambiguation question when special objects are involved: examining one of the walls of the room will make the story ask "In which direction?" and EXAMINE NOSE will lead to "Whose nose do you mean, Frederica's, Betty's, Wilma's or your own?"

At other times, the player types something that is wrong in a predictable way: for instance, we might want to remove all the "with…" phrases from commands like

HIT DOOR WITH FIST
KICK DRAGON WITH FOOT
LOOK WEST WITH EYES

and merely parse the remainder of the command. (That last command may be unlikely, but novice players do quite often type commands that refer unnecessarily to body parts.) Cave-troll ★★★ demonstrates how.

WXPQ ★ demonstrates how to modify the error message the parser gives in response to a command it doesn't understand; this particular example focuses on the "That noun doesn't make sense in this context" message that arises from using the "[any thing]" or "[any room]" tokens, but the techniques could be adapted to handling other parser errors as well.

For catching typing errors, Cedric Knight's extension Mistype may also be of use: it provides an automatic typo-correction function that the player can turn on or off.

Examples

289. Alpaca Farm ★

This example takes the ordering of grammar lines to its logical extreme, sorting the player's input into different categories depending on the kind and condition of the objects mentioned.

"Alpaca Farm"

Understand "use [an edible thing]" as eating.

Understand "use [a wearable thing]" as wearing.

Understand "use [a closed openable container]" as opening. Understand "use [an open openable container]" as closing.

Understand "use [something preferably held] on [a locked lockable thing]" as unlocking it with (with nouns reversed). Understand "use [something preferably held] on [an unlocked lockable thing]" as locking it with (with nouns reversed).

Understand "use [a switched off device]" as switching on.

Understand "use [something]" as using. Using is an action applying to one thing. Carry out using: say "You will have to be more specific about your intentions."

Understand "use [a door]" as opening. Understand "use [an open door]" as entering.

The Llama Pen is a room. North of the Pen is the gate. The gate is a door. North of the gate is the Rocky Path. The brown llama is an animal in the Llama Pen.

Appearance is a kind of value. The appearances are muddy, scruffy, fluffy, and dapper. The brown llama has an appearance. The brown llama is muddy. Before printing the name of the brown llama, say "[appearance] ". Before printing the name of the brown llama while grooming: say "now-[if appearance of the brown llama is less than dapper]merely-[end if]".

A grooming tool is a kind of thing. Understand "use [a grooming tool] on [something]" as grooming it with (with nouns reversed). Grooming it with is an action applying to two things. Understand "groom [something] with [something]" as grooming it with.

Carry out grooming it with:

if the appearance of the noun is less than dapper, now the appearance of the noun is the appearance after the appearance of the noun.

Report grooming it with:

say "You attend diligently to the appearance and hygiene of [the noun]."

Instead of using a grooming tool in the presence of the brown llama:

try grooming the brown llama with the noun.

The player carries some nail nippers, a slicker brush, and an apple. The apple is edible. The brush and the nippers are grooming tools. The player wears a sombrero.

The description of the nail nippers is "Ten inches long, to give you the necessary leverage to cut tough llama toenails. It still helps to soften them up by making the llama stand in a bucket of water first, though."

The description of the slicker brush is "Fine, angled soft bristles set into a broad back, perfect for removing mud from the coat of a long-woolled llama."

The industrial-strength blower is a fixed in place device in the Llama Pen. "Attached to the nearest wall, on its own movable boom, is an industrial-strength blower for doing llama hair."

Understand "use [switched off blower]" as switching on. Understand "use [switched on blower] on [brown llama]" as grooming it with (with nouns reversed). Instead of using the blower in the presence of the brown llama, try grooming the brown llama with the blower.

Test me with "use gate / use blower / use nippers / use brush / use apple / remove sombrero / use sombrero".

Whether we actually want a USE action is a subject of some theoretical debate in the IF community. On the one hand, it helps avoid guess-the-verb problems where the player cannot figure out what term to use in order to express a fairly simple idea. On the other, it encourages the player to think that all items have one and exactly one use, rather than getting him to consider the range of possibilities that arise from having a complex vocabulary.

wi 17.2 New commands for old grammar
rb 6.17 Clarification and Correction

368. Apples ★

Inform by default detects whether two objects can be disambiguated by any vocabulary available to the player. If so, it asks a question; if not, it picks one of the identical objects at random.

Generally this produces good behavior. Occasionally, though, two objects have some distinguishing characteristic that doesn't appear in the object name. For instance, suppose we've created a class of apples that can be told apart depending on whether they've been bitten or not:

An apple is a kind of thing. Consumption is a kind of value. The consumptions are pristine and bitten. An apple has a consumption. The description of an apple is "It is [consumption]."
 
Understand the consumption property as describing an apple.

The player can meaningfully type

>EAT BITTEN APPLE

>EAT PRISTINE APPLE

but if he types

>EAT APPLE

Inform will, annoyingly, ask

Which do you mean, an apple or the apple?

This gives the player no indication of why Inform is making a distinction. So here we add a special "printing the name" rule to get around that situation:

"Apples"

Orchard is a room.

An apple is a kind of thing. Consumption is a kind of value. The consumptions are pristine and bitten. An apple has a consumption. The description of an apple is "It is [consumption]."

Understand the consumption property as describing an apple.

Before printing the name of an apple while asking which do you mean: say "[consumption] ". Before printing the plural name of an apple while asking which do you mean: say "[consumption] ".

The player carries three apples.

Instead of eating a pristine apple (called the fruit):

say "You take a satisfying bite.";

now the fruit is bitten.

Instead of eating a bitten apple (called the fruit):

say "You consume the apple entirely.";

now the fruit is nowhere.

Inform will also separate the bitten from the pristine apples in inventory listings and room descriptions, even though it's not clear why; we can improve on that behavior thus:

Before listing contents: group apples together.
 
Rule for grouping together an apple (called target):
   let source be the holder of the target;
   say "[number of apples held by the source in words] apple[s], some bitten".
 
Before printing the plural name of an apple (called target):
   let source be the holder of the target;
   if every apple held by the source is bitten, say "bitten ";
   if every apple held by the source is pristine, say "pristine ".
 
Test me with "i / eat apple / i / eat apple / pristine / i / eat apple / pristine / i".

wi 18.31 Asking which do you mean
rb 6.17 Clarification and Correction

380. WXPQ ★

The parser error "That noun did not make sense in this context" arises instead of "You can't see any such thing" when the player uses a command that could apply to any item in the game -- that is, a command such as

Understand "go to [any room]" as going directly to.
Understand "talk about [any subject]" as discussing.

…and so on. The idea here is that "You can't see any such thing" isn't a sensible rejoinder when the player doesn't really need to be able to see the object.

Nonetheless, "That noun did not make sense…" is itself a fairly dry and uninformative response, and we may want to override it to something more appropriate for the specific kind of context in which it might appear. For instance:

"WXPQ"

WXPQ Studio is a room. "After about 2 AM, no one is listening anyway, so you can more or less make up whatever you like to fill the airwaves."

John F Kennedy, Elvis, Ralph Nader, Tony Blair, and single-origin chocolate are things.

Understand "talk about [any thing]" or "discuss [any thing]" as discussing. Discussing is an action applying to one visible thing.

Carry out discussing:

say "You babble for a while about your [one of]interest in[or]hatred of[or]passionate devotion to[or]conspiracy theory concerning[or]mother's secret love affair with[as decreasingly likely outcomes] [the noun]."

Rule for printing a parser error when the latest parser error is the noun did not make sense in that context error:

say "For once, you're at a loss for anything to say."

Test me with "discuss Elvis / discuss Kennedy / discuss chocolate / discuss narratology vs ludology debate".

Note that this solution works as simply as it does because we only have one command in the game that can apply to an "[any]" token. If we had several, we'd need to distinguish between the parser error attached to "discuss" and the parser error attached to "go to" (for instance). In that case, we might instead write something like

Rule for printing a parser error when the latest parser error is the noun did not make sense in that context error:
if the player's command includes "go":
   say "There's no such place you know how to get to.";
otherwise:
   say "For once, you're at a loss for anything to say."

wi 18.35 Printing a parser error
rb 6.17 Clarification and Correction

370. Walls and Noses ★★★

Suppose we want our game to respond to "EXAMINE WALL" with "In which direction?", and to "EXAMINE NOSE" with "Whose nose do you mean, Frederica's, Betty's, Wilma's or your own?"

For the case of EXAMINE WALL, we need a way to determine whether every item being disambiguated is a direction. We'll start by making a "matched" adjective which will identify items being disambiguated:

"Walls and Noses"

Eight-Walled Chamber is a room. "A perfectly octagonal room whose walls are tinted in various hues."

Understand "wall" as a direction.

Definition: a direction is matched if it fits the parse list.

Definition: a room is matched if it fits the parse list.

Definition: a thing is matched if it fits the parse list.

Rule for asking which do you mean when everything matched is direction:

say "In which direction?"

Checking the parse list requires a bit of behind-the-scenes work with Inform 6. Fortunately, you don't have to understand this entirely in order to use the rest of the example:

To decide whether (N - an object) fits the parse list:
   (- (FindInParseList({N})) -)
 
Include (-
[ FindInParseList obj i k marker;
   marker = 0;
   for (i=1 : i<=number_of_classes : i++) {
   while (((match_classes-->marker) ~= i) && ((match_classes-->marker) ~= -i)) marker++;
   k = match_list-->marker;
   if (k==obj) rtrue;
   }
   rfalse;
];
-)

Now that we've defined our "matched" adjective, we can use it for other purposes as well -- even generating our own lists. Our second challenge was to respond to EXAMINE NOSE with "Whose nose do you mean, Frederica's, Betty's, Wilma's or your own?"

Here we need to change the way the question is worded (not "which do you mean" but "whose nose do you mean"). We also have to the names of the noses as they're printed in this particular context, so that they don't repeat the word "nose" over and over. And -- as a point of good English style -- we also want "your own" nose always to be last on the list.

For this purpose we may want to use the built-in "Complex Listing" extension, which allows us to print specially ordered lists. So:

Include Complex Listing by Emily Short.
 
Wilma, Betty, and Frederica are women in the Eight-Walled Chamber. Understand "lady" or "woman" as a woman. A nose is a kind of thing. A nose is part of every person.
 
Rule for asking which do you mean when everything matched is a nose:
   prepare a list of matched things;
   if your nose is an output listed in the Table of Scored Listing:
      choose row with an output of your nose in the Table of Scored Listing;
      now the assigned score entry is -1;
   say "Whose nose do you mean, [the prepared list delimited in disjunctive style]?"
 
Rule for printing the name of a nose (called target) while asking which do you mean :
   if everything matched is a nose:
      if the target is part of a person (called owner):
         if the owner is the player, say "your own";
         otherwise say "[the owner][apostrophe]s";
   otherwise:
      make no decision.
 
Understand "own" or "mine" as your nose.
 
Test me with "x wall / north / x nose / mine".

wi 18.31 Asking which do you mean
rb 6.17 Clarification and Correction

423. Cave-troll ★★★

Novice players of interactive fiction, unfamiliar with its conventions, will often try to add extra phrases to a command that the game cannot properly parse: HIT DOOR WITH FIST, for instance, instead of HIT DOOR.

While we can deal with some of these instances by expanding our range of actions, at some point it becomes impossible to account for all the possible prepositional phrases that the player might want to tack on. So what do we do if we want to handle those appended bits of text sensibly?

We could go through and remove any piece of text containing "with …" from the end of a player's command; the problem with that is that it overzealously lops off the ends of valid commands like UNLOCK DOOR WITH KEY, as well. So clearly we don't want to do this as part of the "After reading a command…" stage.

A better time to cut off the offending text is right before issuing a parser error. At that point, Inform has already determined that it definitely cannot parse the instruction as given, so we know that there's something wrong with it.

The next problem, though, is that after we've edited the player's text we want to feed the corrected version back to Inform and try once more to interpret it.

This is where we have a valid reason to write a new "rule for reading a command". We will tell Inform that when we have just corrected the player's input to something new, it should not ask for a new command (by printing a prompt and waiting for another line of input); it should instead paste our stored corrected command back into "the player's command" and proceed as though that new text had just been typed.

Thanks to John Clemens for the specifics of the implementation.

"Cave-troll" by JDC

Section 1 - The Mechanism

The last command is a text that varies.

The parser error flag is a truth state that varies. The parser error flag is false.

Rule for printing a parser error when the latest parser error is the only understood as far as error and the player's command matches the text "with":

now the last command is the player's command;

now the parser error flag is true;

let n be "[the player's command]";

replace the regular expression ".* with (.*)" in n with "with \1";

say "(ignoring the unnecessary words '[n]')[line break]";

replace the regular expression "with .*" in the last command with "".

Rule for reading a command when the parser error flag is true:

now the parser error flag is false;

change the text of the player's command to the last command.

Section 2 - The Scenario

The Cave is a room.

The troll is a man in the cave.

The player carries a sword.

The chest is a locked lockable container in the cave.

Test me with "attack troll with sword / unlock chest with sword / attack troll as a test".

A caveat about using this method in a larger game: "parser error flag" will not automatically control the behavior of any rules we might have written for Before reading a command… or After reading a command…, so they may now fire at inappropriate times. It is a good idea to check for parser error flag in those rules as well.

wi 20.8 Replacements
rb 6.17 Clarification and Correction

🔗

RB §6.18 Alternatives To Standard Parsing

Very occasionally, for out-of-the-ordinary games, we want to make major changes to the way that Inform ordinarily understands commands.

Cloves ★★ shows how we might read adverbs in the player's command: adverbs are challenging because they can legitimately appear anywhere in a command structure, so must be found and accounted for before the rest of the command is understood.

Fragment of a Greek Tragedy ★★ goes further, substituting a keyword-recognition parser for the usual structure of commands and objects.

Less drastically, menus of numbered options can temporarily replace or augment standard commands. Down in Oodville ★★ demonstrates how to add a list of transporter destinations from which the player may choose by numeral.

Examples

304. Down in Oodville ★★

Now and then in IF there is a situation where we need to ask the player for a numbered choice rather than an ordinary action command. What's more, that numbered choice might change during the game, so we don't want to just hard-wire the meanings of "1", "2", and "3" whenever the player types them.

A better trick is to keep a list or table (we'll use a table here because it involves slightly less overhead) recording what the player's numerical choices currently mean. Then every time the player selects a number, the table is consulted, and if the number corresponds to something, the player's choice is acted on.

In our example, we'll have a transporter pad that can take the player to any room in the game that he's already visited. (Just for the sake of example, we'll start him off with a few pre-visited rooms.)

"Down in Oodville"

Section 1 - Method

Understand "[number]" as selecting.

Selecting is an action applying to one number.

Check selecting: [assuming we don't want to be able to transport from just anywhere]

if the player is not on the transporter pad:

say "You can transport only from the transporter pad. From other places than the transporter room, you can HOME to your base ship, but not leap sideways to other locations.";

empty the transport options instead.

Check selecting:

if the number understood is greater than the number of filled rows in the Table of Transport Options or the number understood is less than one:

say "[The number understood] is not a valid option. ";

list the transport options instead.

Carry out selecting:

let N be the number understood; [not actually a necessary step, but it makes the next line easier to understand]

choose row N in the Table of Transport Options;

if the transport entry is a room:

move the player to the transport entry;

otherwise:

say "*** BUG: Improperly filled table of transport options ***" [It should not be possible for this to occur, but we add an error message for it so that, if it ever does, we will know what is causing the programming error in our code]

To list the transport options:

let N be 1;

say "From here you could choose to go to: [line break]";

repeat through the Table of Transport Options:

say " [N]: [transport entry][line break]";

increment N.

To empty the transport options:

repeat through the Table of Transport Options:

blank out the whole row; [first we empty the table]

To load the transport options:

repeat with interesting room running through visited rooms which are not the Transporter Room:

choose a blank row in the Table of Transport Options;

now the transport entry is the interesting room.

Table of Transport Options

transport

an object

with 3 blank rows. [In the current scenario, the number of blank rows need never be greater than the number of rooms in the game, minus the transport room itself.]

Understand "home" as homing. Homing is an action applying to nothing.

Check homing:

if the player is in the Transporter Room:

say "You're already here!" instead.

Carry out homing:

move the player to the transporter room.

Section 2 - Scenario

The Transporter Room is a room.

Oodville is a visited room.

Midnight is a visited room. The Diamond City is west of Midnight.

The transporter pad is an enterable supporter in the Transporter Room. "The transporter pad in the middle of the floor is currently dull blue: powered but unoccupied."

After entering the transporter pad:

say "The transporter beeps and glows amber as you step onto its surface. A moment later a hologram displays your options. [run paragraph on]";

empty the transport options;

load the transport options;

list the transport options.

Test me with "get on pad / 0 / -1 / 8 / 2 / look / w / home / get on pad / get off pad / 3".

If we wanted to replace the regular command structure entirely with numbered menus, or use menus to hold conversation options, we could: several Inform extensions provide these functions.

wi 17.9 Understanding kinds of value
rb 6.18 Alternatives To Standard Parsing

373. Cloves ★★

It has sometimes been suggested that IF should allow for the player to use adverbs, so that doing something "carefully" will have a different effect from doing it "quickly". There are several inherent challenges here: it's a good idea to make very sure the player knows all his adverb options, and the list of possibilities should probably not be too long.

Another trick is that adverbs complicate understanding commands, because they can occur anywhere: one might type >GO WEST CAREFULLY or >CAREFULLY GO WEST, and ideally the game should understand both. After reading a command is the best point to do this sort of thing, because we can find adverbs, interpret them, and remove them from the command stream. So:

"Cloves"

Manner is a kind of value. The manners are insouciantly, sheepishly, and defiantly.

Now we have, automatically, a value called manner understood to be used whenever parsing manners, and we can use this even during the "after reading a command" stage, so:

After reading a command:
   if the player's command includes "[manner]":
      cut the matched text;
   otherwise:
      say "But how, my dear boy, how? You simply can't do something without a pose. Thus far you have mastered doing things [list of manners].";
      reject the player's command.
 
When play begins:
   now the left hand status line is "Behaving [manner understood]";
   now the right hand status line is "[location]";
   now the manner understood is insouciantly.
 
The Poseur Club is a room. "Lady Mary is laid out on a sofa, her wrists bandaged importantly[if the manner understood is insouciantly] -- and she looks all the more depressed by your indifference to her state[end if]; Salvatore is at the gaming table, clutching his hair with both hands[if the manner understood is defiantly] -- though he looks up long enough to snarl in response to that expression of yours[end if]; Frackenbush is muttering lines from another of his works in progress, as though poetry has nearly made him mad[if the manner understood is sheepishly]. But he spares you a reassuring smile. He's not a bad fellow, Frackenbush[end if].
 
The usual people, in short."
 
Instead of doing something other than waiting or looking:
   say "Dear. No. That would smack of effort."
 
Instead of waiting when the manner understood is sheepishly:
   say "You scuff your foot against the ground for a moment, and allow a seemly blush to creep over your cheek. It's quite effective, you are sure, though you can't look up and see how it is going."
 
Instead of waiting when the manner understood is insouciantly:
   say "Thrusting your hands into your pockets, you whistle a jaunty tune.
 
'Do shut up,' says a Melancholy Poseur from over by the window."
 
Instead of waiting when the manner understood is defiantly:
   say "You raise your chin and give a pointed glance around the room as though to say that you are waiting for someone; you are unembarrassed about waiting for her; you have by no means been stood up; and the first person to comment will receive a poke in the eye."
 
Before looking when the manner understood is sheepishly:
   say "You gaze up from under your brows..."
 
Before looking when the manner understood is defiantly:
   say "You cast a withering gaze over the room."
 
Before looking when the manner understood is insouciantly:
   if turn count > 1,
      say "You turn an eye to your surroundings, looking faintly-- just faintly-- amused."
 
Test me with "wait / wait insouciantly / sheepishly look / defiantly look / look insouciantly".

The qualification about turn count is to prevent this before message from occurring when the player first looks around the room (automatically) at the start of play.

Note that to test this example, one must type INSOUCIANTLY TEST ME, and not simply TEST ME: a poseur's work is never done.

wi 18.33 Reading a command
rb 6.18 Alternatives To Standard Parsing

374. Fragment of a Greek Tragedy ★★

Apologies to the shade of A. E. Housman.

"Fragment of a Greek Tragedy"

Understand "restart/restore/save/quit" as "[meta-command]".

After reading a command:

if the player's command matches "[meta-command]", make no decision;

say line break;

repeat through Table of Current Topics:

if the player's command includes topic entry:

say "CHORUS: [reply entry][paragraph break]";

follow the advance time rule;

rule succeeds;

say "[italic type] Pause.[roman type][line break]";

follow the advance time rule;

rule succeeds.

Table of Current Topics

topic	reply
"journey/trip/travel/came/arrived"	"Sailing on horseback, or with feet for oars?"
"horseback/legs/feet/oars"	"Beneath a shining or a rainy Zeus?"
"shining/rainy/weather/zeus"	"Mud's sister, not herself, adorns thy boots."

This would be a bit bare if we didn't provide the player with some sort of context at the outset, so let's put some remarks before the first command prompt:

Before reading a command while the turn count is 1:
   say "CHORUS: O suitably-attired-in-leather-boots
   Head of a traveller, wherefore seeking whom
   Whence by what way how purposed art thou come
   To this well-nightingaled vicinity?
   My object in inquiring is to know.
   But if you happen to be deaf and dumb
   And do not understand a word I say,
   Then wave your hand, to signify as much."

This "turn count" condition is why it was useful to follow the advance time rule in "after reading a command": the game (or drama, if you like) will continue to count moves elapsed even though the rest of Inform's command parsing and world model is being ignored. In a longer and more ambitious implementation of this idea, we might want to allow scenes to govern the behavior and responses of the Chorus.

And then to give the whole exchange a play's format:

The Stage is a room.
 
The room description heading rule is not listed in the carry out looking rules.
 
When play begins:
   now the command prompt is "YOU: ";
   now left hand status line is "Fragment of a Greek Tragedy";
   now right hand status line is "A. E. Housman".

(Because this example manipulates commands outside of the normal parser, the mechanism for TEST will not work here. Try typing commands such as: TELL CHORUS ABOUT JOURNEY / TELL CHORUS ABOUT FEET / TELL CHORUS ABOUT SHROPSHIRE / TELL CHORUS ABOUT ZEUS)

wi 18.33 Reading a command
rb 6.18 Alternatives To Standard Parsing

§7.

§7.

§7.

§7.

§7.

§7.

Getting Started with Conversation

§7.

Saying Simple Things

§7.

Saying Complicated Things

§7.

The Flow of Conversation

§7.

Character Emotion

§7.

Character Knowledge and Reasoning

§7.

Characters Following a Script

§7.

Traveling Characters

§7.

Obedient Characters

§7.

Goal-Seeking Characters

§7.

Social Groups

🔗

RB §7.1 Getting Acquainted

Talking about characters presents some special challenges. For one thing, some characters are referred to by a proper name, but others are not: so the story might want to talk about "Jack" but also about "the drunk pedestrian". In the absence of other information, Inform attempts to divine our intentions based on the words with which we defined a new character: but we can always override its guess with an explicit statement, such as

The Great Malefactor is proper-named.

Belfry ★ demonstrates further how titles are set at the start of play.

The relation between the player and the other characters is not always static, however. Sometimes we want the player to learn a character's name part-way through play, and start referring to "the drunk pedestrian" as "Fernando". Similarly, the status of another character may change due to some twist of the plot. Gopher-wood ★★ shows how to change the name of a character mid-story, and Peers ★★ handles changing the character's rank.

Alternatively, of course, the player character may already know some of the other characters when the story begins, even if the player does not. In that case, we may want to add a tag-line or so of identification to a character's name when he first appears in the story. A Humble Wayside Flower ★★★ shows one way of doing this.

Another occasional challenge is dealing with such commands as EXAMINE DR. THISBY. The problem here is that Inform by default will understand the full stop after "Dr" to be the end of one command and the beginning of another, and will try to interpret "Thisby" as a verb. If we do have a story populated by such formally-addressed characters, we may turn to Punctuation Removal, which provides a phrase to remove the full stops in standard titles before attempting to interpret the command.

Other characters have physical characteristics as well as names, of course, and Meet Market ★ demonstrates one way of implementing people with notable features.

Finally, in some IF, the roles of characters may change from playing to playing. If we are writing a replayable murder mystery, we might want to select a new culprit each time the story starts; for this, see Clueless ★.

Examples

31. Belfry ★

"Belfry"

The Belfry is a room. A bat is in the Belfry. The bell is in the Belfry. Some woodworm are in the Belfry. A man called William Snelson is in the Belfry. A woman called the sexton's wife is in the Belfry. A man called a bellringer is in the Belfry.

In the Belfry is a man called the vicar. The indefinite article of the vicar is "your local".

Test me with "look".

wi 3.18 Articles and proper names
rb 7.1 Getting Acquainted

135. Clueless ★

"When play begins" is the best point to initialize any aspects of the game that are meant to change between playings. For instance, in this scenario, we would randomly select one of the other characters to be guilty of murder:

"Clueless"

The murderer is a person that varies.

When play begins:

now the murderer is a random person who is not the player.

The Billiards Room is a room. Colonel Mustard and Professor Plum are men in the Billiards Room. Miss Scarlet and Mrs White are women in the Billiards Room.

Instead of examining the murderer:

say "[The noun] certainly looks fiendish!"

Test me with "x mustard / x plum / x scarlet / x white".

wi 9.1 When play begins
rb 7.1 Getting Acquainted

238. Meet Market ★

We have already seen that we can give things value properties -- a lamp has a brightness, for instance. Relations give us additional flexibility: since we may relate various things to various values, it is possible to describe a thing as having more than one value at the same time.

To demonstrate:

"Meet Market" by "K M and Eric Rossing"

Feature is a kind of value. The features are snub-nosed, gangly, comely, bright-eyed, and sulky.

Appearance relates various persons to various features. The verb to appear means the appearance relation.

Meet Market is a room.

Bob, Carol, Ted, and Alice are people in the Meet Market.

Bob appears snub-nosed and gangly.

Ted appears sulky and snub-nosed.

Carol appears comely and bright-eyed.

Alice appears bright-eyed and comely.

Yourself appears sulky and gangly.

Instead of looking:

say "The snub-nosed ones: [list of people who appear snub-nosed][line break]";

say "The gangly ones: [list of people who appear gangly][line break]";

say "The comely ones: [list of people who appear comely][line break]";

say "The bright-eyed ones: [list of people who appear bright-eyed][line break]";

say "The sulky ones: [list of people who appear sulky][paragraph break]".

Test me with "look".

The same logic might be used to provide characters who have complex mood states: a person might be angry and sad, not merely one or the other -- feelings being what they are.

wi 13.13 Relations involving values
rb 7.1 Getting Acquainted

32. Gopher-wood ★★

Suppose that we want a character who starts out with a general epithet ("the bearded man") but is later introduced to the player properly ("Japheth"). In that case, we want to be able to tell Inform to stop using an article once the character has been given a proper name. We can do this like so:

"Gopher-wood"

The Ark is a room. A bearded man is in the Ark.

Instead of examining the bearded man for the first time:

now the printed name of the bearded man is "Japheth";

now the bearded man is proper-named;

say "You peer at him a bit more closely and realize that it's Japheth."

Finally, we need to tell Inform to understand the man's name, but only when he's been introduced. For this purpose, we borrow from the chapter on Understanding:

Understand "Japheth" as the bearded man when the bearded man is proper-named.
 
Test me with "x japheth / x man / look / x japheth".

wi 3.18 Articles and proper names
rb 7.1 Getting Acquainted

315. Peers ★★

Almost all of this example is the flummery of pomp and circumstance: only the first two paragraphs really do anything.

"Peers" by Elizabeth II R

A title is a kind of value. The titles are Baron, Viscount, Earl, Marquess, Duke and Prince.

A peer is a kind of man. A peer has a title. A peer is usually a Baron. Before printing the name of a peer, say "[title] ". Understand the title property as describing a peer.

The House of Lords is a room. Maltravers, Pollifax, Omnium and St Vincent are peers in the House of Lords. Omnium is a Duke. St Vincent is an Earl.

Ennobling is an action applying to one thing and one title.

Check ennobling:

if the noun is the player, say "The Sovereign is the fountain of honour, and may not be ennobled." instead;

if the noun is not a peer, say "Commoners should remain so." instead;

if the title of the noun is the title understood, say "But that is his title already." instead;

if the title of the noun is greater than the title understood, say "As he is already of the rank of [title of the noun], any such letters patent are liable to be deemed invalid, following the precedent of the Buckhurst Peerage Case (1876). Best not." instead.

Carry out ennobling:

now the title of the noun is the title understood.

Report ennobling:

say "'Whereas Our Parliament for arduous and urgent affairs concerning Us the state and defence of Our United Kingdom and the Church is now met at Our City of Westminster We strictly enjoining Command you upon the faith and allegiance by which you are bound to Us that the weightness of the said affairs and imminent perils considered (waiving all excuses) you be at the said day and place personally present with Us and with the said Prelates Great Men and Peers to treat and give your counsel upon the affairs aforesaid And this as you regard Us and Our honour and the safety and defence of the said Kingdom and Church and dispatch of the said affairs in nowise do you omit Witness Ourself at Westminster the Fifth day of November in the 43rd year of Our Reign,' you say, with unpunctuated serenity. The new [noun] bows stiffly."

Understand "dub [someone] a/an [title]" as ennobling.

Test me with "dub st vincent a baron / dub maltravers a marquess / look / examine marquess".

wi 17.15 Understanding things by their properties
rb 7.1 Getting Acquainted

237. A Humble Wayside Flower ★★★

First we define the relationships we choose to acknowledge:

"A Humble Wayside Flower"

Marriage relates one person to another (called the spouse). The verb to be married to means the marriage relation.

Fatherhood relates one person (called father) to various people. The verb to engender means the fatherhood relation.

For brevity, we will ignore the existence of mothers. It is a sad world.

Siblinghood relates a person (called A) to a person (called B) when a person who engenders A engenders B. The verb to be sibling to means the siblinghood relation.
 
Family relates a person (called A) to a person (called B) when A is married to B or A engenders B or B engenders A or A is sibling to B. The verb to be related to means the family relation.
 
A person can be known or unknown. After printing the name of an unknown person (called the alien):
   if a known person (called the contact) is related to the alien:
      say " ([relation between alien and contact] of [the contact])";
      now the alien is known;
      rule succeeds.
 
To say relation between (first party - a person) and (second party - a person):
   if the first party is married to the second party:
      if the first party is female, say "wife";
      otherwise say "husband";
      rule succeeds;
   if the first party is sibling to the second party:
      if the first party is female, say "sister";
      otherwise say "brother";
      rule succeeds;
   if the first party engenders the second party:
      say "father";
      rule succeeds;
   if the second party is the father of the first party:
      if the first party is female, say "daughter";
      otherwise say "son";
      rule succeeds.
 
Pere Blanchard's Hut is a room. Percival Blakeney is a known man in the Hut. Marguerite is a woman in the Hut. Percival is married to Marguerite. Outside from the Hut is the Garden. Louise is a woman in the Garden. The Road to Paris is west of the Garden. Armand St Just is a man in the Road. Louise is married to Armand. Monsieur St Just is a man. He engenders Armand and Marguerite.
 
Test me with "out / west / east / west".

Monsieur St Just never appears on the scene in this piece, but if we did put him somewhere the player could find him, he, too, would be properly introduced.

wi 13.12 Relations which express conditions
rb 7.1 Getting Acquainted

🔗

RB §7.2 Liveliness

A character who sits still in a chair and does nothing is much less convincingly alive than one who seems to be pursuing some sort of personal agenda. There are all sorts of ways to achieve this, but the least challenging is by introducing some random change to descriptions, and by giving a character some very simple routine behavior to carry out.

For instance, we'll often want the characters in a room to be described doing different things every time we look at them. Camp Bethel ★★ shows how this may be done.

Every turn rules lend some sprightliness to otherwise-silent characters, as well:

Every turn when the player can see Mrs MacGillicuddy:
   say "Mrs. MacGillicuddy vacuums around [a random fixed in place thing which is in the location]."

We might expand on this by providing a whole table of things for Mrs MacG. to cycle through, or a text variation effect that gives her different activities every turn, as in

Every turn when the player can see Mrs MacGillicuddy:
   say "Mrs. MacGillicuddy [one of]vacuums around the furniture[or]tries to remove gum from the underside of the desks[or]causes a racket by testing the smoke alarm[or]makes a pointed comment or two about them as sit by idly while someone works her fingers to the bone[as decreasingly likely outcomes]."

This is no great innovation in characterization by itself, but it does at least remind the player that the character is alive and moving about, even when he isn't paying attention to her.

Annoyotron Jr ★ demonstrates a character who actively tries to get our attention, and whose routine of behavior changes just slightly if we show signs of having reacted to him.

Lean and Hungry ★★★ implements a classic thief, a character who doesn't interact with the player much except to pick up valuable objects he finds left around the map. Later we will see rather more advanced ways to make characters act on their own goals and plans, but this kind of simple behavior is easily rigged as part of an every turn rule.

Finally, Text Foosball ★★★★ extends the every-turn-rule idea to create an opponent who joins us in a randomized game of table soccer.

With animal characters, this kind of repetitive, semi-random behavior is often adequate: we don't expect animals to talk, or pursue steady goals, or to take an interest in what we do in their presence (unless it involves a food they like to eat).

For people, we are likely to need an assortment of additional techniques.

Examples

153. Annoyotron Jr ★

"Annoyotron Jr"

The Minivan is a room. The Open Road is outside from the Minivan. Pete is a man in the Minivan. "Pete [if the player has been in the Minivan for 3 turns]is starting to look bored[otherwise]is playing with his travel activity book[end if]."

Every turn:

if the player has been in the Minivan for 5 turns, say "'Are we there [if saying no]now?'[otherwise]yet?' asks Pete.[end if]"

Instead of saying no:

say "'Oh,' says Pete. There is a blessed, momentary silence."

Instead of going to the Open Road:

say "You leap to your death.";

end the story.

Test me with "z / z / look / g / g / g / no / z / z / z / no / z / out".

wi 9.15 How many turns?
rb 7.2 Liveliness

67. Camp Bethel ★★

"Camp Bethel"

Camp Bethel Kitchen is a room.

One use for text alternatives is to change the description of a room after first visiting. We've already seen, in the example "Slightly Wrong", how to do this with "[if visited] … [otherwise] … [end if]". But since the first description is printed once and the second description on all subsequent occasions, we could equally well write

The description of Camp Kitchen is "[one of]You've never been into the kitchen before, though you've spent many an hour in the dining lodge. The place is larger than you would have expected, and it has none of the fake rustic touches of the rest of the camp[or]A tidy, efficient industrial kitchen, without any of the kitsch rusticity found elsewhere[stopping]."

We might also want to liven up the behavior of people and animals, who are probably not doing the exact same thing every time we glance in their direction. There are more complex techniques for modeling the behavior of characters, as we will see in the chapters on Advanced Actions and Activities; but if we just want some textual variety, we might write something like:

Jeremy is a man in the Camp Bethel Kitchen. "Jeremy stands at his station, [one of]peeling white onions[or]briskly dicing onions[or]chopping celery[or]peeling carrots[or]tying fresh herbs together with string[or]putting all the vegetables into a large stock pot[or]watching over his boiling vegetable stock[cycling]."

And since (textual variation or not) we do want the player to be able to see all these objects:

Jeremy carries white onions, celery, carrots, and herbs. Jeremy's station is scenery in the kitchen. It is a supporter.

Jeremy is following a sequence of actions to do an implied task (still somewhat robotically, but it will do for now). Animals might be a bit more capricious, though:

Fluffy is an animal in the Camp Bethel Kitchen. "[one of]Fluffy is chasing its tail[or]Fluffy is staring out the window[or]Fluffy is rubbing itself against your leg[purely at random]."
 
A housefly is an animal in the Camp Bethel Kitchen. "A large housefly [one of]lands on a countertop[or]flies around noisily[or]circles Jeremy's chef hat[at random]."

The housefly's description is merely "at random" rather than "purely at random" because we want to show it doing a different thing each turn, whereas Fluffy could plausibly stare out the window for five turns in a row.

There are more complex ways to change and override the initial descriptions of people and things; if text alternatives do not get us far enough, we can turn to the "rule for writing a paragraph about," documented in the Activities chapter.

Another frequent use of text alternatives is to give characters a bit of variety in things they're likely to say many times in the course of a game:

Instead of telling Jeremy about something:
   say "Jeremy looks [one of]surprised[or]intrigued[or]nonplussed[at random]. '[one of]You don't say[or]That's very interesting[or]Do go on[or]I wish I'd known that sooner[at random]!'".

Or, with somewhat more complexity:

Instead of asking Jeremy about something:
   say "'[one of]Sorry,[or]I'm afraid[or]Hm,[at random] [one of]I don't know much about that[or]you've got me there[or]I haven't the faintest[at random],' Jeremy [one of]drawls[or]replies[or]comments[or]exclaims[at random]";
   say "[one of][or] huskily[or] throatily[or] silkily[or] in a deep manly voice[as decreasingly likely outcomes]."

Notice that, in that last line, our first option is entirely blank. If we put nothing as an element of the text alternatives list, this means that printing nothing at all is a viable alternative. In fact, we've made this the most common probability out of the decreasingly likely outcomes, so that five times in fifteen, or a third of the time the text is run, there will be no modifier printed at all.

Test me with "look / g / g / g / ask Jeremy about his feelings for me / ask jeremy about his amnesia / tell Jeremy about my unborn child".

As this example (alas) reveals, text alternatives will not go all the way toward making our characters into compelling conversationalists; we will have to wait until we know more about Actions. But at least we have abolished the default responses, and given Jeremy a touch of personality, however witless.

wi 5.7 Text with random alternatives
rb 7.2 Liveliness

76. Lean and Hungry ★★★

"Lean and Hungry"

Substance is a kind of value. The substances are silver, gold, and lead. Everything has a substance. A thing is usually lead.

Definition: a thing is valuable if it is not lead.

The Limestone Cave is a room. "Not very big, and it doesn't go back far, but you'd hoped to find some shelter here. Outside it is raining exceptionally hard."

The sinister gentleman is a man in the Cave. "Leaning against the wall is a sinister gentleman in a threadbare waistcoat." The description is "He looks as though he might once have been quite well off."

After examining the gentleman:

say "[The noun] smiles back at you in an unnerving fashion."

Now we make the rule that governs the gentleman's behavior. Here we're going to invoke the rules that allow characters besides the player to do actions. More about this can be found in the Advanced Actions chapter:

Every turn:
   if the sinister gentleman can touch something valuable (called the treasure) which is not carried by a person:
      try the gentleman taking the treasure.
 
Report the gentleman taking something:
      say "[The gentleman] slyly acquires [the noun] and tucks it into his pocket." instead.

That "not carried by a person" prevents the gentleman from stealing from the player (or, less plausibly, from himself). If we did want him to pick pockets, we could just have said "which is not carried by the gentleman".

The player is carrying a coin, a bust of Abraham Lincoln, a bottle of sherry, a small pistol, and a wad of Confederate cash. The coin is gold. The pistol is silver.
 
A locket is in the Cave. The locket is gold. "A broken gold locket lies on the ground, a token of your late Mama."
 
Test me with "get locket / i / drop locket / z / drop cash / z / x gentleman / drop all / z / z / look".

wi 6.13 To be able to see and touch
rb 7.2 Liveliness

140. Text Foosball ★★★★

Suppose we want a game of foosball in which our opponent acts every turn, but does different things depending on where the ball currently lies. We can put together a sequence of every-turn rules to account for this, as follows:

"Text Foosball"

Use scoring.

The Lounge is a room. "The Lounge is appointed with everything necessary to rest and relaxation: a vending machine, a potted palm, a stack of Entertainment Weekly issues from 1993, and -- your pride and joy -- a foosball game."

The foosball game is scenery in the Lounge. Understand "table" or "football" or "foozball" or "fussball" or "soccer" as the foosball game. The game is a supporter. On the game is a small white ball. The ball can be still, approaching, receding, or unreachable. The description of the ball is "Currently [small white ball condition]."

After printing the name of the small white ball, say " ([small white ball condition])".

When play begins:

now left hand status line is "You: [score]";

now right hand status line is "Joey: [Joey's score]".

Some tiny men on sticks are part of the game. Understand "handles" as the tiny men. The description is "Okay, a couple of the tiny men have had their feet broken off, and the table surface itself is a bit warped, and the ball resembles a quail egg in respect of shape and color. This makes for a game of unusual randomness, but skill is overrated."

Instead of attacking or pulling or pushing the game when the ball is unreachable:

say "You give the table a good shove, and the ball moves ever-so-slightly.";

now the ball is still.

Instead of taking the white ball:

say "You'd forfeit the game if you did that."

Instead of turning the tiny men when the ball is unreachable:

say "The ball has somehow gotten to a mystical point on the table where it cannot be reached, no matter what. Close inspection reveals that this point has been marked in chalk with a tiny X. Not that that does any good."

Instead of turning the tiny men when the ball is approaching:

if a random chance of 2 in 3 succeeds:

if a random chance of 1 in 2 succeeds, now the ball is receding;

otherwise now the ball is still;

say "[if the ball is still]Thunk. [otherwise]Thwack! [end if]You keep the ball from reaching its goal! Now it is [small white ball condition].";

otherwise:

let Joey score.

To let Joey score:

now the ball is still;

now Joey's score is Joey's score + 1;

say "The ball rolls neatly into your goal, despite your efforts. ";

if Joey's score < score, say "You put the ball back in the center with a snap. No reason to worry yet; you're still ahead. Joey looks determined, though.";

otherwise say "After allowing a moment or two for Joey's gloating to pass, you replace it at the center."

Instead of turning the tiny men when a random chance of 1 in 13 succeeds:

if the ball is unreachable, continue the action;

now the ball is unreachable;

say "You hit the ball off-center and it rolls sluggishly into a little dip in the surface of the foosball table. ";

if Joey's score > 7, say "'You did that on purpose!' Joey exclaims indignantly.";

otherwise say "You and Joey exchange glances. This is never good."

Instead of turning the tiny men:

say "You madly rotate the tiny men on sticks! ";

if a random chance of 1 in 2 succeeds:

say "Hoorah! You hit the ball!";

now the ball is receding;

otherwise:

say "Somehow you fail to bring your monopodal player into contact with the ball."

Joey is a man in the Lounge. "Joey is hunkered over the foosball handles on his side of the table." Joey can be active or inactive.

Joey's score is a number that varies.

Every turn: now Joey is active.

Every turn when the ball is approaching and Joey is active:

let total be Joey's score + score;

if total > 9, make no decision;

now Joey is inactive;

let Joey score;

rule succeeds.

Every turn when the ball is unreachable and Joey is active:

let total be Joey's score + score;

if total > 9, make no decision;

now Joey is inactive;

say "Joey glares angrily at the stuck ball."

Every turn when the ball is receding and Joey is active:

let total be Joey's score + score;

if total > 9, make no decision;

if the ball is unreachable, make no decision;

now Joey is inactive;

if a random chance of 1 in 2 succeeds:

if a random chance of 1 in 2 succeeds, now the ball is still;

otherwise now the ball is approaching;

say "Joey connects with your shot. Now the ball is [small white ball condition]!";

otherwise:

now the ball is still;

say "Joey tries to block, but misses! Back it goes in the center, where it is [small white ball condition].";

increment the score.

Every turn when the ball is still and Joey is active:

let total be Joey's score + score;

if total > 9, make no decision;

if the ball is unreachable, make no decision;

now Joey is inactive;

if a random chance of 1 in 2 succeeds:

now the ball is approaching;

say "Joey hits the ball solidly down towards your goal. Now it is [small white ball condition].";

otherwise:

say "Joey fails to hit the ball in your direction. It remains [small white ball condition]."

Every turn:

let total be Joey's score + score;

if total > 9:

if Joey's score > score, end the story saying "Rats! Joey wins!";

if Joey's score < score, end the story finally saying "Victory is yours!";

if Joey's score is score, end the story saying "A perfect tie."

wi 9.5 Every turn
rb 7.2 Liveliness

🔗

RB §7.3 Reactive Characters

As we observe characters, so they observe us. Those who seem to have no awareness of what the player is doing often come across more like waxworks than like people. Zodiac ★ demonstrates a scenario where the watchful presence of a dangerous criminal keeps the player from doing what he otherwise might, while Police State ★ expands on this idea with a policeman who reacts to entire types of behavior in his presence, regardless of whether the culprit is the player or a third party. Noisemaking ★★★ has a crow who will fly away in response to any loud noises the player makes.

And, of course, we definitely want to have characters react to being looked at or otherwise interfered with. Search and Seizure ★★★ implements a smuggler who reacts when we try to confiscate his possessions. Pine ★ gives us a sleeping princess who can be woken by a variety of methods.

We wrap up this section with two complete puzzle scenarios that demonstrate what can be achieved by giving characters reactions to the player's behavior. A Day For Fresh Sushi ★★★★ has a fish who watches the player's actions and comments on them, while the live furnishings in Revenge of the Fussy Table ★★★★ instead comment every turn on the current state of the world, until the player has successfully sorted out all their complaints.

Examples

96. Zodiac ★

Notice that the following two scenarios do not have the same effect:

"Zodiac"

The Secluded Alley is a room. The Capricorn Killer is a man in the Secluded Alley.

The player carries a can of mace and a roll of duct tape.

Instead of doing something other than examining with the Capricorn Killer:

say "You wouldn't dare!"

Test me with "x me / x killer / touch killer / smell mace".

…will prevent the player from doing anything else to the killer, but allow him free range of action with other objects. By contrast, the following will prevent him doing anything other than examining to any item:

"Zodiac"

The Secluded Alley is a room. The Capricorn Killer is a man in the Secluded Alley.

The player carries a can of mace and a roll of duct tape.

Instead of doing something other than examining with something in the presence of the Capricorn Killer:

say "You dare not attempt it!"

Test me with "x me / x killer / touch killer / smell mace".

But notice that because we specified "with something", actions that take no object (like sing) are still not affected.

The most strict statement would be

"Zodiac"

The Secluded Alley is a room. The Capricorn Killer is a man in the Secluded Alley.

The player carries a can of mace and a roll of duct tape.

Instead of doing something other than looking or examining in the presence of the Capricorn Killer:

say "You dare not attempt it!"

Test me with "x me / x killer / touch killer / smell mace".

Because we left "something" out, now the pattern does not have to match an activity with an object; it will match any activity at all. Singing too will be deemed too risky in the presence of our sinister foe. But we do need to make an exception for "look", or else we won't get even the room description.

wi 7.9 All actions and exceptional actions
rb 7.3 Reactive Characters

154. Pine 1 ★

Because scene rules are checked every turn, they can be useful for designing puzzles which have multiple solutions. Instead of deciding the puzzle is "solved" when the player does a certain action, we set up a scene that checks to see whether the player has achieved a certain outcome -- however he accomplished it.

For instance, in this scenario, we're waiting for Sleeping Beauty to wake up, and it doesn't much matter how…

"Pine"

A person can be asleep or awake. A person can be active or passive.

The Spinning Tower is a room. "A remote corner of the old castle, reserved for spinning and weaving tasks."

Sleeping Beauty is an asleep woman in the Spinning Tower. "[if asleep]Sleeping Beauty lies here, oblivious to your presence[otherwise]Sleeping Beauty stands beside you, looking a little confused[end if]." The description is "She is even more magnificent than the rumors suggested." Understand "woman" or "girl" or "princess" or "lady" as Sleeping Beauty.

Discovery is a scene. Discovery begins when play begins. Discovery ends when Sleeping Beauty is awake. Marriage Proposal is a scene. Marriage Proposal begins when Discovery ends.

When Discovery ends: say "Throughout the palace you can hear the other sounds of stirring and movement as the spell of centuries is broken."

Instead of waking an awake person: say "Redundant."

Instead of waking an asleep person: say "Yes, but how?"

Instead of attacking an asleep person:

now the noun is awake;

say "[The noun] sits bolt upright. 'Hey! Ow!' So much for that true love's kiss nonsense."

Instead of kissing an asleep person:

now the noun is awake;

say "[The noun] slowly stirs to wakefulness!"

Instead of throwing water at an asleep person:

now the second noun is awake;

now the noun is nowhere;

say "You pour out [the noun] on [the second noun].

[The second noun] wakes, shuddering. 'Agh! I had a terrible dream about drowning and then-- Hey!'"

The player carries a jug of water. Understand "pour [something] on [something]" or "splash [something] at/on [something]" as throwing it at.

Test me with "x beauty / wake beauty / pour water on beauty".

wi 10.2 Creating a scene
rb 7.3 Reactive Characters

187. Police State ★

"Police State"

Seventh Avenue is a room. "The bars are all closed now, and there aren't any good clubs to go to, so you're on your own for open-air entertainment."

Persuasion rule for asking the policeman to try doing something: persuasion fails.

Persuasion rule for asking someone to try doing something: persuasion succeeds.

Note that the policeman will never get to the second persuasion rule, so he will always refuse to do the player's nefarious bidding.

Charles, Thomas, and Larry are men in Seventh Avenue. Patricia is a woman in Seventh Avenue.

And here's an unnecessary aesthetic touch from a later chapter, which will round up the descriptions of your friends into a single paragraph:

Rule for writing a paragraph about someone who is not the policeman:
   let X be the number of visible people who are not the policeman;
   say "It's just [X in words] of you now: [a list of visible people who are not the policeman]. But it sure has been a rip-roaring evening."
 
The policeman is a man in Seventh Avenue. "A policeman with a very guarded expression is watching you."
 
Singing is an action applying to nothing. Understand "sing" as singing.
 
Report singing:
   say "A little the worse for wear, you sing."
 
Smelling a person is disorderly conduct. Tasting a person is disorderly conduct. Jumping is disorderly conduct. Singing is disorderly conduct.
 
Instead of someone trying disorderly conduct in the presence of the policeman:
   say "The policeman arrests [the person asked]!";
   now the person asked is nowhere;
   the rule succeeds.
 
Instead of disorderly conduct in the presence of the policeman:
   end the story saying "The policeman arrests you!"
 
Test me with "charles, look / charles, jump / look / policeman, sing / thomas, taste policeman / patricia, sing / look / jump".

Notice the difference between the two rules about disorderly conduct: the one for other people says 'the rule succeeds' to make sure that the action is counted as a success and not (as normally happens with instead rules) a failure. Most of the time we don't care whether actions are judged successes or failures, but it matters here, because if we type CHARLES, JUMP and the result fails, then text such as 'Charles is unable to.' will be printed - which would get in the way. So we declare the action a success.

wi 12.4 Persuasion
rb 7.3 Reactive Characters

38. Search and Seizure ★★★

Suppose we want a character who carries hidden objects, but only while he is wearing his jacket. If we deprive him of this, his other possessions become known. Furthermore, if we ever search him, his possessions also become known, and can thereafter be mentioned by us.

"Search and Seizure"

Size is a kind of value. The sizes are small, medium, and large. A thing has a size. A thing is usually small.

A thing can be licit or contraband. A thing is usually licit.

A thing can be discovered or secret. A thing is usually secret.

Now, we want the character to be able to hide small things if he has some sort of concealing garment on. We also want to be able to see anything that the player has already found once, perhaps by using the >SEARCH PERSON command. So:

Rule for deciding the concealed possessions of someone (called the suspect):
   if the particular possession is discovered, no;
   if the suspect wears something and the particular possession is small, yes;
   otherwise no.

The following rule, borrowed from a later chapter, assures that any items that are ever mentioned to the player will be treated as known from then on:

Before printing the name of something (called discovery): now the discovery is discovered.
 
The Customs House is a room. The smuggler is a man in the Customs House. The smuggler wears a leather jacket. He carries a bottle of Altairan rum, some raspberries, and a laser pistol. The pistol is large. The jacket is large. The rum and the raspberries are contraband. The description of the smuggler is "He has a bestubbled chin and a sinister eye."
 
The tourist is a woman in the customs house. The description is "The type who walks off home with a dozen contraband items in her pocket not because she means to steal things but because she's too stupid to understand that the law applies to herself." She wears a tight-fitting dress. The dress is large. The tourist carries a grapevine and an archaeological artifact. The grapevine is large and contraband. The artifact is contraband.
 
Report examining someone: say "[The noun] is [if the noun is wearing something]wearing [a list of unconcealed things worn by the noun] and [end if]carrying [a list of unconcealed things carried by the noun]."
 
Report examining someone who is concealing something contraband:
   say "[The noun] looks nervous. You can just tell."
 
Report examining someone who is carrying an unconcealed contraband thing:
   say "Your eye goes at once to [the list of unconcealed contraband things carried by the noun] which [the noun] is unable to hide";
   if an unconcealed licit thing is had by the noun, say ", though [if the noun is female]s[end if]he also has [a list of unconcealed licit things had by the noun]";
   say "." instead.

Notice that we can talk about what the smuggler wears, what he carries, and what he "has": things the smuggler has can be either worn or carried, so the phrase is useful if we don't care to make that distinction.

Instead of searching someone:
   say "[The noun] is revealed to be carrying [a list of things carried by the noun]."
 
Instead of confiscating the dress:
   say "You are not allowed to perform strip-searches in the public customs area."
 
Understand "confiscate [something]" as confiscating.
 
Confiscating is an action applying to one thing.
 
Check confiscating:
   unless the noun is had by someone who is not the player:
      say "You can only confiscate other people's possessions." instead.
 
Carry out confiscating:
   now the noun is carried by the player.
 
Report confiscating:
   say "Through the authority vested in you by the power of the Sovereign of Centauri Proxima, you make [the noun] your own."
 
Test me with "x smuggler / search smuggler / x smuggler / confiscate jacket / x smuggler / confiscate rum / confiscate pistol / x smuggler / confiscate raspberries / x smuggler".
 
Test more with "x tourist / confiscate dress / confiscate grapevine / x tourist / search tourist / confiscate artifact / x tourist".

wi 3.24 Concealment
rb 7.3 Reactive Characters

197. Noisemaking ★★★

Suppose the current sequence of action handling is not quite enough for us: we'd also like to have a stage after reporting, where other characters can react to the player character's behavior after it has already happened and been reported on screen. Having such a stage is unlike using "after", because after occurs before reports and prevents them from being printed. So, for instance, we could allow the player to do any of a range of different actions that make loud noises, and have a nervous bird that reacts to all of them by flying away afterward.

To do this, we can add a new rule into the specific action-processing rules. (For a list of these, see the Rules index.) Moving rules around and adding new ones requires syntax that we will learn in the chapter on Rulebooks, but the present example is fairly straightforward:

"Noisemaking"

Section 1 - Procedure

The other-player response rule is listed after the report stage rule in the specific action-processing rules.

This is the other-player response rule:

follow the observation rules.

The observation rules is a rulebook.

Section 2 - Scenario

Country Lane is a room. West of Country Lane is Outside the Farmhouse. East of Country Lane is Village Center. North of Country Lane is Open Field.

The player carries a drum.

The black crow is an animal in Country Lane.

Singing is an action applying to nothing. Understand "sing" as singing.

Report singing:

say "You hum a little ditty."

Singing is a loud action.

Attacking the drum is a loud action.

The block attacking rule is not listed in any rulebook.

Report attacking something:

say "THWACK!"

An observation rule for loud action in the presence of the black crow:

let N be a random adjacent room;

if N is a room, move the black crow to N;

say "The crow, startled, flies off to [N]."

Test me with "sing / g / n / hit drum".

wi 12.9 Check, carry out, report
rb 7.3 Reactive Characters

82. Revenge of the Fussy Table ★★★★

This example does include a number of features that we haven't met yet, particularly rulebooks. Nonetheless, the basic idea should be relatively clear. Our premise is that the player is faced with a series of disgruntled furnishings, none of which want to be responsible for supporting the cold, hot, drippy, or spiky objects lying around the room.

"Revenge of the Fussy Table"

Use scoring.

Section 1 - The Supporters

The Dining Room is a room. "A room of handsome proportions, with an octagonal dining table on a fine parquet floor. The original set of chairs has been taken away, leaving only a red velvet dining chair and a blue suede armchair."

The fussy table is a supporter in the Dining Room. It is scenery. The description is "It's hypochondriac: the result of a sojourn in a superior antique shop, where it picked up the scent of almond oil, words like provenance, and a secretive shame about being resurfaced.

Chairs don't get along with it.

In its mellowest moods, after a really good dusting, it will mention, casually, a cabinet it once knew, which was twelve feet tall, came from the Winter Palace, and had an asking price of $350K."

A chair is a kind of supporter with carrying capacity 1. A chair is enterable. A chair is usually scenery. Understand "chair" as a chair.

The blue suede armchair and the red velvet dining chair are chairs in the Dining Room. The description of the blue suede is "Quiet, mellow, and with a lingering aroma of clove cigarettes, and possibly something less legal. It doesn't sit up straight, and doesn't let anyone else do so either." The red velvet has the description "In temperament, in bearing, in everything it is the opposite of the blue suede chair. It is concerned for its duty all the time, has a rigidly straight back, and pokes diners in the spine when it suspects them of overdoing things."

The carrying capacity of the player is 2.

Section 2 - Sources of Unpleasantness

A thing can be drippy or dry.

Heat is a kind of value. The heats are luke-warm, cold, and scalding. Everything has a heat. Understand the heat property as describing a thing.

A thing can be spiky or smooth. The cleated left shoe is a wearable spiky thing. It is worn by the player. The cleated right shoe is a wearable spiky thing. It is worn.

Definition: a thing is unpleasant if it is scalding or it is cold or it is spiky or it is drippy.

Definition: a supporter is occupied if something is on it.

Definition: something is contented if it is not concerned.

Definition: a chair is concerned if something unpleasant is on it.

Definition: the table is concerned if something drippy is on it or something scalding is on it or something spiky is on it.

Definition: the ceramic tile is concerned if something spiky is on it.

Definition: a room is concerned if something drippy is in it or something scalding is in it or something spiky is in it or someone which is in it is wearing a spiky thing.

Before printing the name of a drippy thing: say "drippy ". Before printing the name of a cold thing: say "cold ". Before printing the name of a scalding thing: say "scalding ".

Section 3 - What the Player Can Do About It

After putting a cold thing on a scalding thing:

say "[The noun] meets [the second noun]; both shriek in pain. But the necessary heat transfer occurs.";

now the heat of the noun is luke-warm;

now the heat of the second noun is luke-warm.

After putting a scalding thing on a cold thing:

say "[The noun] meets [the second noun]; both shriek in pain. But the necessary heat transfer occurs.";

now the heat of the noun is luke-warm;

now the heat of the second noun is luke-warm.

After taking a scalding thing:

say "'Right,' you say. 'I'll just hold onto [the noun], shall I? Because that won't be in the least uncomfortable for me.'"

After taking a drippy thing:

say "With a sense of martyrdom, you retrieve [the noun], which dribbles water down your cuffs."

After entering a chair when the player is wearing a spiky thing (called the clog):

say "You sit on [the noun], lifting [the list of spiky things worn by the player] so that the parquet is no longer affronted."

Section 4 - In Which the Furnishings Complain

An every turn rule:

follow the complaint rules.

The complaint rules is a rulebook.

A complaint rule:

if something (called the offending item) on the table is drippy:

say "'Help! Get me a coaster!' screams the table[if the table is visible], its veneer squirming under [the offending item][otherwise] from the Dining Room[end if].";

rule succeeds;

if something (called the offending item) on the red chair is drippy:

say "'Oh dear,' murmurs the red chair, as [the offending item] drips into its velvety seat. 'Oh dear, I will have a damp spot. This is so very -- what will people think?'";

rule succeeds;

if something (called the offending item) on the visible armchair is drippy:

say "[The offending item] visibly begins degrading the suede where it sits. The armchair is tactfully silent.";

rule succeeds;

if a drippy thing (called the offending item) is in the location and the player is in the Dining Room:

say "'Cripes,' says the parquet. 'No one mind me at all. Just leave that [offending item] right here. You know I'm the most valuable thing in the room?'";

rule succeeds.

A complaint rule:

if a cold dry thing (called the offending item) is on the table:

say "The table shivers under [the offending item].";

rule succeeds.

A complaint rule:

if something (called the offending item) on the table is scalding:

say "'Hey!' protests the table, practically smoking at [the offending item]. 'Heard of a trivet?'";

rule succeeds;

if something (called the offending item) on the armchair is scalding:

say "The armchair doesn't complain about [the offending item]; it just begins, quietly, to give off warm sweet clouds of blue steam, as though its inner opium-nature had been released.";

rule succeeds;

if something (called the offending item) in the Dining Room is scalding:

say "'Yes indeed,' [if the location is the Dining Room]says[otherwise]bellows[end if] the parquet. 'That [offending item] won't leave any sort of mark what-so-ever.'";

rule succeeds.

A complaint rule:

if something (called the offending item) on the table is spiky:

say "The table holds very very very still lest [the offending item] mar its finish. But its resentment is palpable.";

rule succeeds;

if something (called the offending item) on the velvet chair is spiky:

say "[The offending item] stabs the velvet of the red velvet chair, which draws itself up even more sharply in a pose of dutiful martyrdom.";

rule succeeds;

if something (called the offending item) which is spiky is on the ceramic tile:

say "'[The offending item] itches!' cries the ceramic tile.";

rule succeeds;

if something (called the offending item) in the location is spiky:

say "'[The offending item] should not be on a parquet floor,' sings the parquet floor sadly.";

rule succeeds;

if someone (called the offending person) in the location is wearing something spiky and the location is the Dining Room:

say "The parquet floor mutters about the things people wear to walk on parquet floors these days.";

rule succeeds.

A complaint rule:

if the table supports something which supports a drippy thing (called the offending item),

say "'[The offending item] could still theoretically dribble down here,' says the table nonchalantly. 'It's possible.'";

if the velvet chair supports a concerned thing (called the friend),

say "'[The friend] seems a little worried,' remarks the velvet chair helpfully."

A complaint rule:

if the concerned table can see a supporter (called the object of envy) which is not concerned:

say "The table looks jealously at [the object of envy]. 'Some people have such an easy life.'";

rule succeeds.

Instead of going to an adjacent room when the player is in the Dining Room:

say "'You're not leaving!?' whimpers the table at once."

Moreover, every time the player gets close to resolving this issue, his unhelpful companion Alison brings in something else inconvenient. We can use the counting of contented supporters to decide when the player is getting close to winning and it's time for her to bring something else…

Section 5 - Source of Further Complications
 
The Tidy Kitchen is south of the Dining Room. Alison is a woman in the Tidy Kitchen. The kettle is a scalding thing. The ceramic tile is a cold portable supporter. It has carrying capacity 1. The platter is a scalding portable supporter. It has carrying capacity 1. The glass of ice water is a cold, drippy thing.
 
Instead of drinking the glass of ice water, say "It's not yours, it's for Alison, once she finishes cooking."
 
Alison carries the kettle, the tile, the platter, and the glass.
 
An every turn rule:
   follow the behavior rules.
 
The behavior rules is a rulebook.
 
A behavior rule:
   if ice water is carried by Alison and the player is in the Dining Room and almost all of the supporters are not concerned:
      let the next victim be a random fixed in place contented supporter;
      move the ice water to the next victim;
      say "Humming to herself, Alison brings in [an ice water] and sets it down smack on [the next victim], then goes back out.";
      rule succeeds.
 
A behavior rule:
   if platter is carried by Alison and the player is in the Dining Room and almost all of the supporters are not concerned:
      let the next victim be the red velvet chair;
      move the platter to the next victim;
      say "Whistling a jaunty tune, Alison brings in a hot platter and deposits it on [the next victim], then returns to the kitchen.";
      rule succeeds.
 
A behavior rule:
   if the tile is carried by Alison and the player is in the Dining Room and almost all of the supporters are not concerned:
      let the next victim be a random contented chair;
      move the tile to the next victim;
      say "Humming to herself, Alison brings in [the tile] and sets it down smack on [the next victim], then goes back out.";
      rule succeeds.
 
A behavior rule:
   if kettle is carried by Alison and the player is in the Dining Room and at least three fixed in place supporters are contented:
      let the next victim be the fussy table;
      move the kettle to the next victim;
      say "Just then the kettle boils in the kitchen. Whistling chirpily, Alison brings it in and sets it down smack on [the next victim], then goes back out.";
      rule succeeds.

And just so that the player knows where he stands at the end of each turn:

Section 6 - General Assessment
 
An every turn rule:
   if some of the things are concerned, say "You sense some resentment from [the list of concerned things]."
 
An every turn rule:
   if the player is carrying more than one scalding thing:
      let the dropped item be a random scalding thing carried by the player;
      say "You can't hang onto so many burning hot things, and lose your grip on [the dropped item].[line break]";
      silently try dropping the dropped item.
 
An every turn rule:
   if almost all of the supporters are concerned,
      say "'I hope everything is going well,' bellows Alison from the other room."

Finally, we need some rules to decide when the player is, in fact, finished.

Section 7 - Scoring
 
An every turn rule:
   now score is 5 minus the number of concerned things;
   if the location is concerned, decrement the score;
   if all of the supporters are concerned and the location is concerned, end the story;
   if none of the supporters are concerned and the location is not concerned, end the story finally.
 
The maximum score is 5.
 
When play begins, now score is 4.
 
Test me with "i / take off left shoe / get the glass / put the glass on the platter / get the tile / drop the tile / get the kettle / put the kettle on tile / sit on the blue armchair".

wi 6.15 All, each and every
rb 7.3 Reactive Characters

112. A Day For Fresh Sushi ★★★★

The following is an almost-completely-faithful rewrite of Emily Short's "A Day for Fresh Sushi", which was originally written using the (very different) Inform 6 programming language. The -- let us be honest and call it a gimmick -- of this game is the evil fish, who has some unpleasant remark to offer on pretty much every action. But the effect would wear off fast if he repeated himself, so these comments need to be single-use only.

Inform 7's repeated action syntax makes it much tidier to write the same scenario, so:

"A Day For Fresh Sushi" by Emily Short.

Use scoring.

The story headline is "Your basic surreal gay fish romance".

The Studio is a room. "[if visited]Decorated with Britney's signature flair. It was her innate sense of style that first made you forgive her that ludicrous name. And here it is displayed to the fullest: deep-hued drapes on the walls, the windows flung open with their stunning view of old Vienna, the faint smell of coffee that clings to everything. Her easel stands over by the windows, where the light is brightest.[otherwise]This is Britney's studio. You haven't been around here for a while, because of how busy you've been with work, and she's made a few changes -- the aquarium in the corner, for instance. But it still brings back a certain emotional sweetness from the days when you had just met for the first time... when you used to spend hours on the sofa...

You shake your head. No time for fantasy. Must feed fish.[end if]"

Instead of smelling the Studio:

say "The evil fish notices you sniffing the air. 'Vanilla Raspberry Roast,' it remarks. 'You really miss her, don't you.'

You glance over, startled, but the fish's mouth is open in a piscine equivalent of a laugh. You stifle the urge to skewer the thing..."

Instead of jumping:

say "'Er,' says the fish. 'Does that, like, EVER help??'"

Instead of going nowhere:

say "You can't leave until you've fed the fish. Otherwise, he'll complain, and you will never hear the end of it."

The cabinet is an openable closed container in the Studio. It is fixed in place. "A huge cabinet, in the guise of an armoire, stands between the windows." The description is "Large, and with a bit of an Art Nouveau theme going on in the shape of the doors." Understand "armoire" as the cabinet.

Instead of looking under the cabinet for the first time:

say "'Dustbunnies,' predicts the fish, with telling accuracy. It executes what for all the world looks like a fishy shudder. 'Lemme tell you, one time I accidentally flopped outta the tank, and I was TWO HOURS on the floor with those things STARING ME IN THE NOSE. It was frightening.'"

After opening the cabinet for the first time:

say "'There ya go,' says the fish. 'The girl is getting WARMER.'"

After closing the cabinet for the first time:

if the fish food is not found, say "'Ooh, what do you think, Bob? I think we're going to have to dock the girl a few points. HAVE ANOTHER LOOK, sweetcakes, there's a doll.'"

The cabinet contains some paints and some cloths. The description of the paints is "A bunch of tubes of oil paint, most of them in some state of grunginess, some with the tops twisted partway off."

After taking the paints for the first time:

say "'Boy,' says the fish, apparently to himself, 'I sure hope that's some food she's finding for me in there. You know, the yummy food in the ORANGE CAN.'"

After examining the paints for the first time:

say "'Tons of useful stuff in there,' hollers in the fish, in a syncopated burble."

The description of the cloths is "Various colors of drapery that Britney uses to set up backgrounds and clothe her models. She does a lot of portraiture, so this comes in handy. It's all a big messy wad at the moment. Organized is not her middle name." Understand "drapery" or "cloth" as the cloths. The indefinite article of the cloths is "a heap of". [see 3.17]

Instead of searching or looking under the cloths for the first time:

now the player is carrying the fish food;

now the fish food is found;

say "Poking around the cloths reveals -- ha HA! -- a vehemently orange can of fish food."

Instead of showing the cloths to the fish:

say "'What are you, some kind of sadist? I don't want to see a bunch of cloths! What kind of f'ing good, 'scuse my French, is that supposed to do me? I don't even wear pants for God's sake!'

He really looks upset. You start wondering whether apoplexy is an ailment common to fish."

After examining cloths for the first time:

say "'Whatcha looking at? I can't see through the doors, you know.'"

There is a can of fish food. Understand "canister" as the can. The description is "A vehemently orange canister of fish food." The fish food can be found or hidden. The fish food is hidden.

Instead of giving the can to the fish:

say "'I don't want the whole can, GeniusChyk. Just feed me and we'll ALL be happy, 'kay?"

Instead of showing the can to the fish:

say "'That's the ticket, sweetie! Bring it on.'"

Instead of opening the can:

say "'Oh, for--!' The evil fish breaks out in exasperation and hives. 'Screw the screwing around with the screwtop. SHE never has to do that.'

'Well, SHE is not here,' you reply. 'What do you suggest?'

'>FEED FISH<' says the fish promptly, making fishy faces and pointing at you with his fin. 'Simplicity. Try it.'"

Instead of inserting the can into something:

say "'HelLLLOOO,' screams the fish. 'Whatever happened to FEEDING MEEE?'"

The easel is a supporter in the Studio. It is scenery. On the easel is a painting. Understand "portrait" or "image" as the painting.

The description of the painting is "Only partway finished, but you can tell what it is: Britney's mother. You only met the old woman once, before she faded out of existence in a little hospice in Salzburg.

In the picture, her hands are grasping tightly at a small grey bottle, the pills to which she became addicted in her old age, and strange, gargoyle-like forms clutch at her arms and whisper in her ears.

But the disturbing thing, the truly awful thing, is the small figure of Britney herself, down in the corner, unmistakable: she is walking away. Her back turned.

You thought she'd finally talked this out, but evidently not. Still feels guilty for leaving. You only barely stop yourself from tracing, with your finger, those tiny slumped shoulders..."

Instead of taking the painting, say "No, you'd better leave it. It'd freak her out if you moved it."

Before examining the painting for the first time:

say "A ferocious banging from the aquarium attracts your attention as you go to look at the painting. 'Hey!' screams the fish. 'She doesn't like strangers looking at her paintings before they're DOONNNE!'

'Shut up, you,' you reply casually. 'I'm not a stranger.' But the fish puts you off a little bit, and your heart is already in your mouth before you see the painting itself...".

Instead of examining the painting more than once:

say "Once is really enough. It's pretty much embedded in your consciousness now."

After doing something to the painting:

say "'So what's it of?' asks the fish, as you turn away. 'She never asks if I want to see them, you know?'

'Her mother,' you respond without thinking.

'Yeah? Man. I never knew my mother. Eggs, that's the way to go.'"

The window is scenery in the Studio. The window can be openable. The window can be open. It is openable and closed. Understand "windows" as the window. The description of the window is "[if open]Through the windows you get a lovely view of the street outside. At the moment, the glass is thrown open, and a light breeze is blowing through.[otherwise]Through the windows, you get a lovely view of the street outside -- the little fountain on the corner, the slightly dilapidated but nonetheless magnificent Jugendstil architecture of the facing building. The glass itself is shut, however.[end if]"

After opening the window for the first time:

say "'Thank god some air,' says the fish. 'Man, it was getting hard to breathe in here.' Two beats pass. 'Oh wait.'"

The table is scenery in the Studio. On the table is a vase. The vase is an open container. It is not openable.

The description of the table is "A monstrosity of poor taste and bad design: made of some heavy, French-empire sort of wood, with a single pillar for a central leg, carved in the image of Poseidon surrounded by nymphs. It's all scaley, and whenever you sit down, the trident has a tendency to stab you in the knee. But Britney assures you it's worth a fortune." The description of the vase is "A huge vase -- what you saw once described in a Regency romance as an epergne, maybe -- something so big that it would block someone sitting at the table from seeing anyone else also sitting at the table. But it does function nicely as a receptacle for hugeass bouquets of flowers."

Instead of looking under the table for the first time:

say "'You're not going to find anything down there,' whines the fish. 'I mean, c'mon. It's the fricking floor. Please tell me you can see that. I can see that. I'm a myopic fish in a tank ten feet away and I can tell you there is nothing there but floor.'"

After examining the table:

say "'That there is MY PA,' says the fish, pointing at the scaley triton figure with one fin."

Instead of inserting something which is not the bouquet into the vase:

say "'Okay, so, what were you, raised in a barn? Normal folks like to use that for flowers. Or so I've observed.'"

After inserting the bouquet into the vase for the first time:

say "You settle the flowers into the vase and arrange them so that they look sprightly.

'Oooh,' says the fish. 'No one ever changes the plant life in HERE. It's the same seaw--'

'Cut me a break and cork it,' you reply tartly."

The player is carrying a telegram, a bouquet, and a lingerie bag. The player is wearing a chef hat.

The description of the telegram is "A telegram, apparently. And dated three days ago. [fixed letter spacing]TRIUMPH OURS STOP BACK SOON STOP BE SURE TO FEED FISH STOP[variable letter spacing]". [For printing options see 4.13.] Understand "yellow paper" as the telegram.

After examining the telegram for the first time:

say "'So,' blubs the evil fish. 'How about it? Little food over here?'"

After examining the telegram:

choose a random row in the Table of Insulting Fish Comments;

say "[comment entry][paragraph break]".

Table of Insulting Fish Comments

comment

"'Yeah, yeah,' says the fish. 'You having some trouble with the message, there? Confused? Something I could clear up for you?'"

"'Oookay, genius kid has some troubles in the reading comprehension department.' The fish taps his head meaningfully against the side of the tank. 'I'm so hungry I could eat my way out, you get my meaning?'"

"'I'll translate for you,' screams the fish in toothy fury. 'It says GIVE FOOD TO FISH!! How much more HELP do you NEED???"

The description of the chef hat is "A big white chef hat of the kind worn by chefs. In this case, you. Just goes to show what a hurry you were in on the way out of the restaurant." Understand "big" or "white" or "chefs" or "chef's" as the chef hat. [Inform knows that this is clothing because the player starts out wearing it, so there's no need to say so separately.]

The aquarium is a transparent open container in the Studio. It is not openable. "In one corner of the room, a large aquarium bubbles in menacing fashion." The description of the aquarium is "A very roomy aquarium, large enough to hold quite a variety of colorful sealife -- if any yet survived." Understand "tank" as the aquarium.

The aquarium contains some gravel and some seaweed. Understand "little rocks" as the gravel. Understand "weed" as the seaweed. The description of the gravel is "A lot of very small grey rocks." The description of the seaweed is "Fake plastic seaweed of the kind generally bought in stores for exactly this purpose."

The examine containers rule does nothing when examining the aquarium.

After examining the gravel for the first time:

say "The fish notices your gaze; makes a pathetic mime of trying to find little flakes of remaining food amongst the gravel."

After examining the seaweed for the first time:

say "'Nice, hunh?' blubs the fish, taking a stabbing bite out of one just by way of demonstration. 'Look so good I could eat it.'"

The aquarium contains an animal called an evil fish. The description of the fish is "Even if you had had no prior experience with him, you would be able to see at a glance that this is an evil fish. From his sharkish nose to his razor fins, every inch of his compact body exudes hatred and danger."

Instead of taking the evil fish:

say "The fish swims adroitly out of range of your bare hand. 'Hey,' he says, and the bubbles of his breath brush against your fingers. 'Count yourself lucky I don't bite you right now, you stinking mammal.'"

Instead of attacking the evil fish:

say "Oh, it's tempting. But it would get you in a world of hurt later on."

Instead of kissing the evil fish:

say "You're saving all your lovin for someone a lot cuddlier."

After examining the evil fish for the first time:

say "The fish glares at you, as though to underline this point."

After examining the evil fish for the second time:

say "'If you're looking for signs of malnutrition,' says the fish, 'LOOK NO FURTHER!!' And it sucks in its gills until you can see its ribcage."

An every turn rule:

choose a random row in the Table of Fish Banter;

say "[comment entry][paragraph break]".

Table of Fish Banter

comment	used
"'Hey, nice SKIN TONE,' shouts the evil fish. His words reach you in a spitting gurgle of aquarium water. 'You gone over to a pure eggplant diet these days?'"	0
"The evil fish is floating belly up! ...oh, curse. He was toying with you. As soon as he sees you looking, he goes back to swimming around."	0
"The evil fish darts to the bottom of the tank and moves the gravel around with his nose."	0
"The evil fish is swimming around the tank in lazy circles."	0
"The evil fish begins to butt his pointy nose against the glass walls of the tank."	0

The description of the bouquet is "Okay, so it's silly and sentimental and no doubt a waste of money, of which there is never really enough, but: you miss her. You've missed her since ten seconds after she stepped aboard the shuttle to Luna Prime, and when you saw these -- her favorites, pure golden tulips like springtime -- you had to have them." Understand "flowers" or "tulip" or "tulips" as the bouquet.

After examining the bouquet for the first time:

say "'Oh, you shouldn't have,' says the fish. 'For me??'

You just respond with a livid glare."

Instead of smelling the bouquet for the first time:

say "'Mmm-mm,' says the fish. 'Damn, I sure wish I had olfactory abilities. Hey, if I did, I might be even better at noticing the presence or absence of FOOD.'"

The description of the lingerie bag is "You grant yourself the satisfaction of a little peek inside. You went with a pale, silky ivory this time -- it has that kind of sophisticated innocence, and it goes well with the purple of your skin. A small smirk of anticipation crosses your lips."

After examining the lingerie bag for the first time:

say "'What's in THERE?' asks the fish. 'Didja bring me take-out? I don't mind Chinese. They eat a lot of carp, but what do I care? I'm not a carp. Live and let live is what I s--'

'It's NOT take-out.' You stare the fish down and for once he actually backstrokes a stroke or two. 'It's PRIVATE.'"

After examining the lingerie bag for the second time:

say "'If it's not take-out, I don't see the relevance!' shouts the fish. 'Food is what you want in this situation. Food for MEEEE.'"

Understand the command "feed" as something new.

Understand "feed [something]" as feeding.

Feeding is an action applying to one visible thing.

Check feeding:

if the noun is not the evil fish, say "That doesn't make much sense." instead;

if the player is not carrying the fish food, say "You need the fish food first." instead.

Carry out feeding:

increment the score;

say "Triumphantly, you dump the remaining contents of the canister of fish food into the tank. It floats on the surface like scum, but the fish for once stops jawing and starts eating. Like a normal fish. Blub, blub.[paragraph break]";

say "[bold type] *** TWO HOURS LATER ***[roman type][paragraph break]'So,' Britney says, tucking a strand of hair behind your ear, 'where shall we go for dinner? Since I made the big bucks on this trip, it's my treat. Anywhere you like.'[paragraph break]'I've had a hankering all day,' you admit, as the two of you turn from the shuttle platform and head toward the bank of taxis. 'I could really go for some sashimi right now.'";

end the story finally.

Before feeding the fish food:

try feeding the evil fish instead.

When play begins:

say "You're on the run. You've got a million errands to do -- your apartment to get cleaned up, the fish to feed, lingerie to buy, Britney's shuttle to meet-- [paragraph break]The fish. You almost forgot. And it's in the studio, halfway across town from anywhere else you have to do. Oh well, you'll just zip over, take care of it, and hop back on the El. This'll be over in no time.[paragraph break]Don't you just hate days where you wake up the wrong color?[paragraph break]".

The maximum score is 1.

Test me with "x fish / g / kiss fish / x aquarium / x gravel / x seaweed / i / x telegram / x bouquet / smell bouquet / x lingerie / g / x hat / x window / open window / x painting / g / x cabinet / open cabinet / x cloths / search cloths / open food / feed fish".

wi 7.16 Repeated actions
rb 7.3 Reactive Characters

🔗

RB §7.4 Barter and Exchange

By default, Inform characters are a bit grudging about giving and sharing objects: they react with disinterest when they're shown things and refuse everything they're offered.

If we'd like to change this, we can simply remove the default "block giving" rule, as in

The block giving rule is not listed in the check giving it to rules.

If we do this, giving items to characters will have the result of moving our possessions to the other person's inventory. Of course, without more customization, the player may not ever be able to persuade the other character to return his possessions. Bribery ★★ demonstrates a scenario in which a character will accept gifts if they are interesting to him, and respond with a changed attitude to the player.

Barter Barter ★★★ expands further on this by allowing other characters to trade things with one another.

Examples

392. Bribery ★★

If we want to rewrite the functionality of a command that usually ends with a "block…" rule, we will have to begin by turning the blocking off.

"Bribery"

The block giving rule is not listed in the check giving it to rules.

As it happens, correct behavior is built into the GIVE command once "block giving" is turned off, so we do not have to write a replacement report or carry-out rule; the object will be transferred to the possession of the caterpillar. But we do want to adjust the action just a little so that our gift cheers up the recipient:

Carry out giving (this is the gratitude for gifts rule): improve the mood of the second noun.
 
Mood is a kind of value. The moods are hostile, suspicious, indifferent, friendly, and adoring. An animal has a mood. An animal is usually indifferent.
 
To improve the mood of (character - an animal):
   if the mood of character is less than friendly, now the mood of the character is the mood after the mood of the character.

Now whenever we give something to an animal, the animal will be pleased about the present. Of course, we might also want to add a check rule to giving, to see whether the offering is something the recipient really wants:

Check giving (this is the polite refusal of unwanted objects rule):
   unless the noun interests the second noun:
      say "[The second noun] disdainfully refuses [the noun]." instead.
 
To decide whether (item - a thing) interests (character - a person):
   if the character has the item, no;
   if the item is edible, yes;
   no.
 
Instead of showing something to someone:
try giving the noun to the second noun.

There is already a perfectly workable report rule that will describe what happens when we give something to someone, but let's say we want to report on the recipient's changed mood, too:

After giving something to someone:
   say "You give [the noun] to [the second noun], who appears mollified and is now merely [mood of the second noun]."

And the rest is all scenario:

The Leafy Branch is a room. "You stand on smooth bark dappled by sunlight. The scent-trail runs forward to home.
 
The branch continues forward and backward from here, and a stem extends forward-up."
 
Instead of going south in Leafy Branch, say "You must not back down! The scent trail leads onward!"
 
The Very Hungry Caterpillar is a hostile animal in the Leafy Branch. "[The Caterpillar] looks [mood]." Instead of examining the Caterpillar, say "[The caterpillar] appears [mood]."
 
The player carries an edible thing called a peanut crumb. The carrying capacity of the player is 1. After taking something, say "You lift [the noun], though it is nearly your own size."
 
Instead of going north in the presence of a hostile caterpillar:
   say "[The Caterpillar] moves to block your exit, glaring down at you with all the bristles on its skin extended to full size."
 
Instead of going north in the presence of a suspicious caterpillar:
   say "[The Caterpillar] moves to block your exit, though it might allow you past if you offered further tribute."
 
The Leaf Face is above the branch. "The smooth and shiny surface of the leaf extends forward from here, but you have lost the scent-trail. This is not the way home."  The pear fragment is an edible thing in Leaf Face. The dead aphid is a thing in Leaf Face.
 
The Twig is north of Leafy Branch. "The scent-trail is weak but not entirely gone, and you pursue it faithfully..."
 
After going to the Twig:
   say "The scent-trail is weak but not entirely gone, and you pursue it faithfully...";
   end the story finally.
 
Understand "forward-up" as up. Understand "forward" as north. Understand "backward" as south.  Understand "backward-down" as down.
 
Test me with "forward / give crumb to caterpillar / forward / forward-up / get aphid / get fragment / down / give aphid to caterpillar / drop aphid / forward-up / get fragment / down / give fragment / forward".

wi 19.3 New rules
rb 7.4 Barter and Exchange

207. Barter Barter ★★★

By default, if we make no modifications, telling one player to give something to another will fail, even if persuasion succeeds. This is because the default behavior of the GIVE command is interrupted by the "block giving rule" -- since in many cases we do not want people to exchange objects freely.

However, suppose that we do want characters to be able to exchange articles freely: we allow persuasion to succeed and turn off the "block giving rule".

"Barter Barter"

The block giving rule is not listed in the check giving it to rules.

A persuasion rule for asking people to try giving: persuasion succeeds.

The Trading Post is a room.

Meriwether Lewis is a man in the Trading Post. He carries a fluffy handmade quilt and a bag of beans. The beans are edible.

William Clark is a man in the Trading Post. He carries leather slippers, a journal, and a loaf of bread. The bread is edible. The slippers are wearable.

Instead of examining someone:

say "[The noun] is carrying [the list of things carried by the noun]."

And now we might want to implement a way to keep track of whether the recipient character wants what's being offered:

Check someone trying giving something to someone (this is the sneering refusal rule):
   if the second noun dislikes the noun, stop the action.
 
Unsuccessful attempt by someone trying doing something:
   if the reason the action failed is the sneering refusal rule, say "'Would you care for [the noun]?' [the person asked] asks solicitously of [the second noun].
 
But [the second noun] refuses [the noun] disdainfully.";
   otherwise say "[The person asked] just appears bewildered by this improbable instruction."
 
Distaste relates one person to various things. The verb to dislike means the distaste relation.
 
Clark dislikes the beans. Lewis dislikes the bread.

Since we've defined this as a relation, we could change what the characters like and dislike during the course of the game, freely; for instance, characters might grow hungry and suddenly like all the edible articles.

Test me with "x lewis / x clark / clark, give the slippers to lewis / clark, give the bread to lewis".

wi 12.12 Check rules for actions by other people
rb 7.4 Barter and Exchange

🔗

RB §7.5 Combat and Death

Not all characters are friendly, and there are times when we may want to include a fight sequence. There are a number of ways to approach this, depending on whether we want to offer the player a random outcome, a predetermined one, or a combat sequence that depends partly on strategy or on having the proper equipment.

Lanista ★ demonstrates randomized combat in the style of a role-playing game. The player has a partially random chance of doing any given amount of damage; both the player and his opponent have hit points, and whichever one runs out first dies. Lanista 2 ★★ continues this idea, but includes weapons that affect the amount of of damage done. Red Cross ★ by itself implements a command that we might use to find out how strong characters are at the moment.

A word of warning about designing such sequences: a player who gets a roll he doesn't like always has the option of UNDOing a turn and re-rolling. This means that he can always win a random battle sooner or later; bad luck only means that it takes him longer (so he gets more bored and irritated as he plays through). It is possible to turn off UNDO implementation with

Use UNDO prevention.

…but there is a good chance that this will irritate players in itself. Role-playing-style combat scenarios need careful design, lest they actively make a story less fun.

In a slightly more realistic setting, combat leaves physical remains behind, unless we're wielding some kind of futuristic weapon that evaporates our opponents entirely: Puff of Orange Smoke ★★ demonstrates characters who leave corpses behind when they die, while Technological Terror ★★★ more tamely explodes robots into numerous component parts.

Finally, we can imagine some scenarios in which, instead of allowing characters to strike at each other for random damage, we want to introduce an element of strategy. Don Pedro's Revenge ★★★ shows the rudiments of a system in which the characters can make different kinds of attack depending on where they are in a room filled with perches, barrels, and other swashbuckler props.

Examples

130. Lanista 1 ★

"Lanista, Part One"

The Arena is a room. "Sand, blood, iron. These festivals are normally held on hot days, but the sun has gone behind a cloud and fat drops of rain now and then spatter the arena floor." The gladiator is a man in the Arena. "A bare-chested Scythian gladiator faces you, wielding a trident."

We start by recording, for each person, a maximum number of points of damage the person can sustain when starting from health, and the current number of points remaining. In the tradition of role-playing games, these are referred to as hit points.

A person has a number called maximum hit points. A person has a number called current hit points.
 
The maximum hit points of the player is 35. The maximum hit points of the gladiator is 25.
 
The current hit points of the player is 35. The current hit points of the gladiator is 25.

Now our rule for the actual attack. We want first to calculate how much damage the player's attack does, inflict that damage, and remove the enemy if he's dead; then, if he doesn't die, the enemy counter-attacks, also for a randomized amount of damage, and if this kills the player, the game ends in defeat.

Instead of attacking someone:
   let the damage be a random number between 2 and 10;
   say "You attack [the noun], causing [damage] points of damage!";
   decrease the current hit points of the noun by the damage;
   if the current hit points of the noun is less than 0:
      say "[line break][The noun] expires, and is immediately carried away by the Arena slaves!";
      now the noun is nowhere;
      end the story finally;
      stop the action;
   let the enemy damage be a random number between 2 and 10;
   say "[line break][The noun] attacks you, causing [enemy damage] points of damage!";
   decrease the current hit points of the player by the enemy damage;
   if the current hit points of the player is less than 0:
      say "[line break]You expire!";
      end the story.

This last bit is a refinement to help the player keep track of how the contest is going:

When play begins:
   now the left hand status line is "You: [current hit points of player]";
   now the right hand status line is "Gladiator: [current hit points of gladiator]".
 
Test me with "hit gladiator / g / g / g".

wi 8.18 Randomness
rb 7.5 Combat and Death

191. Red Cross ★

"Red Cross"

Diagnosing is an action applying to one visible thing. Understand "diagnose [something]" as diagnosing.

Check diagnosing:

if the noun is not a person, say "Only people can have diagnoses." instead.

Carry out diagnosing:

say "You're not a medical expert."

Instead of diagnosing the player:

say "You feel fine!"

The Clinic is a room. Fred is a man in the Clinic. The player carries a tongue-depressor.

Test me with "diagnose me / diagnose fred / diagnose tongue-depressor".

wi 12.7 New actions
rb 7.5 Combat and Death

201. Puff of Orange Smoke ★★

Suppose we want to let the player kill characters, leaving behind corpses.

"Puff of Orange Smoke"

Paraguay is a room. Bolivia is north of Paraguay. Lydia is a woman in Paraguay. "Lydia is, as usual, here." The description of Lydia is "Long, long legs and a sarcastic attitude." Instead of touching Lydia: say "'Watch it, sailor,' she snaps."

A body is a kind of thing. A body is a part of every person. Instead of touching a body: say "[The noun] is grotesquely inert."

The description of Lydia's body is "Long, long legs and no attitude at all." The initial appearance of Lydia's body is "Lydia's corpse is sprawled at your feet."

Using our "part of every person…" line, we've conveniently assigned one body per person. Since we're going to separate people from their bodies when the bodies die, though, we also want a more permanent relation that will help us keep track of which bodies used to belong to which people:

Spirit-possession relates one person to one body. The verb to be owner of means the spirit-possession relation.
 
When play begins:
   repeat with victim running through people:
      let the corpse be a random body which is part of the victim;
      now the victim is owner of the corpse.

When Lydia is alive, we want >TOUCH LYDIA'S BODY to mean the same thing as >TOUCH LYDIA, so we use the setting action variables rules as a convenient point at which to reassign the action:

Setting action variables when the noun is a body which is part of a person (called owner):
   now the noun is the owner.
 
Setting action variables when the second noun is a body which is part of a person (called owner):
   now the second noun is the owner.

This doesn't change Inform's idea about what action is being performed; just about the object it's being performed on. The rest of the action will now proceed as if the player had typed >TOUCH LYDIA.

Along similar lines, once Lydia is dead, we want >MOVE LYDIA to mean >MOVE LYDIA'S BODY if the body is in view:

Setting action variables when the noun is a dead person and the noun is owner of a visible body (called the mortal remains):
   now the noun is the mortal remains.

The trick is, though, that >MOVE LYDIA will only be understood if there is something called Lydia that the player can see and refer to, even after she's dead. There are various ways to do this, but the least painful here will be to make the deceased Lydia permanently visible, by putting her in an always-accessible backdrop. The backdrop itself will never be mentioned in the game, and we should make its name something that the player is unlikely to type casually; we don't want the player to interact with it directly. So:

The worldview is a privately-named backdrop. It is everywhere. The spirit-world is a privately-named transparent closed unopenable container. It is part of the worldview.
 
Definition: a person is dead if he is in the spirit-world.

It's also possible that the player will type something like >X LYDIA when Lydia's corpse is not in view, so we should have an appropriate answer to that as well:

Before doing something to a dead person:
   say "[The noun] is dead; or had you blocked that out?" instead.

Because the before rules happen after the setting action variables rules, this will only ever happen if the corpse is not visible.

Now we define the attack itself, which should discard the body, move the spirit to its eternal resting place, and describe the event to the player:

Instead of attacking someone:
   let the corpse be a random body which is part of the noun;
   move the corpse to the location;
   move the noun to the spirit-world;
   say "With a single blow, you rid the world of [the noun]."

And finally a trick borrowed from the chapter on understanding, so that we can refer to "Lydia's body" while Lydia is alive, but "Lydia's corpse" only after Lydia has died:

Understand "corpse" as a body when the item described is not part of a person.
 
Test me with "x body / x lydia's body / touch lydia's body / x corpse / kill lydia / look / x lydia's body / x lydia's corpse / x corpse / x lydia / touch lydia / lydia, hello / n / x lydia / touch lydia / lydia, hello".

wi 12.10 Action variables
rb 7.5 Combat and Death

293. Lanista 2 ★★

Back in the chapter on randomization, we explored a way to create a randomized combat system. That system didn't allow for multiple weapons, though. Here we explore how to create an ATTACK IT WITH action that will let the player choose between weapons with different maximum powers.

We're also going to rewrite that original "instead of attacking:" rule into an attacking it with action that can be performed equally by the player or by any of the player's enemies.

"Lanista, Part Two"

Section 1 - Hit Points

A person has a number called maximum hit points. A person has a number called current hit points.

The maximum hit points of the player is 35. The maximum hit points of the gladiator is 25.

In our simpler version of this example we set the current hit points by hand, but in a game with many characters this would get dull and repetitive, so here we'll use a "when play begins" to set all current hit point values automatically to maximum:

When play begins:
   repeat with victim running through people:
      now the current hit points of the victim is the maximum hit points of the victim.
 
Definition: a person is dead if his current hit points are less than 0.
 
Section 2 - Diagnosis
 
Diagnosing is an action applying to one visible thing. Understand "diagnose [something]" as diagnosing.
 
Check diagnosing:
   if the noun is not a person, say "Only people can have diagnoses." instead.
 
Carry out diagnosing:
   say "[if the noun is the player]You have[otherwise][The noun] has[end if] [current hit points of the noun] out of a possible [maximum hit points of the noun] hit points remaining."
 
Section 3 - Weapons
 
A weapon is a kind of thing. A weapon has a number called the maximum damage. The maximum damage of a weapon is usually 4.
 
The gladiator carries a weapon called a trident. The maximum damage of the trident is 5. The gladiator carries a weapon called a net. The maximum damage of the net is 1.
 
The player carries a weapon called a mace. The maximum damage of the mace is 3.
 
Section 4 - Attacking it with

In our new system, we want to specify what is being used for an attack. This means that we need to create a new "attacking it with" action, and also that we should disable the existing "attacking…" command.

Here's why: If we leave the default attack command in place, Inform will continue to accept commands like >ATTACK GLADIATOR, but reply foolishly with the default "Violence is not the answer…" response.

A somewhat better approach would be to change the reply of >ATTACK GLADIATOR to say something like "You must specify a weapon to attack with." But this is still less than ideal, because it means that the player has to then rewrite his entire command. If, on the other hand, we take out "ATTACK GLADIATOR" entirely, the game will always prompt "What do you want to attack the gladiator with?" -- which teaches the player the correct command structure for this particular game, and avoids pretending to understand any command that is not meaningful within this game.

This is a little bit of work because ATTACK has a lot of synonyms in the default library, but if we look through the actions index we can find them all:

Understand the commands "attack" and "punch" and "destroy" and "kill" and "murder" and "hit" and "thump" and "break" and "smash" and "torture" and "wreck" as something new.

Now we make our new command:

Attacking it with is an action applying to one visible thing and one carried thing. Understand "attack [someone] with [something preferably held]" as attacking it with.

Note that we've specified "one carried thing", because we want the player to pick up a weapon to use if necessary. And now we assign all the old attack vocabulary to apply to the new command:

Understand the commands "punch" and "destroy" and "kill" and "murder" and "hit" and "thump" and "break" and "smash" and "torture" and "wreck" as "attack".

This may seem counter-intuitive, but order of source code matters here: we first get rid of the old, default vocabulary, then define our new action, then make the vocabulary apply to that new action. Inform will now understand >HIT GLADIATOR WITH TRIDENT, >BREAK GLADIATOR WITH TRIDENT, and so on.

Our new action is also a perfect place to use an action variable: we're going to need to choose an amount of damage done and refer to that several times in our action rules. So let's set that up first:

The attacking it with action has a number called the damage inflicted.
 
Setting action variables for attacking something with something:
   if the second noun is a weapon:
      let the maximum attack be the maximum damage of the second noun;
      now the damage inflicted is a random number between 1 and the maximum attack.
 
Check an actor attacking something with something (this is the can't attack with something that isn't a weapon rule):
   if the second noun is not a weapon:
      if the actor is the player, say "[The second noun] does not qualify as a weapon.";
      stop the action.
 
Check an actor attacking something with something (this is the can't attack a non-person rule):
   if the noun is not a person:
      if the actor is the player, say "[The noun] has no life to lose.";
      stop the action.
 
Carry out an actor attacking something with something (this is the standard attacking it with a weapon rule):
   decrease the current hit points of the noun by the damage inflicted;
   if the noun is dead and the noun is not the player:
      now the noun is nowhere.

Though our checks and carry-out rules are similar regardless of who is acting, we're going to want actions to be described differently for different actors, so we'll use separate "report attacking" and "report someone attacking" rules. We'll also make some special cases for when the character has died as a result of the attack:

Report attacking a dead person with something (this is the death-report priority rule):
   say "You attack with [the second noun], killing [the noun]!" instead.
 
Report attacking someone with something (this is the normal attacking report rule):
   say "You attack [the noun] with [the second noun], causing [damage inflicted] point[s] of damage!" instead.
 
Report someone attacking the player with something when the player is dead (this is the player's-death priority rule):
   say "[The actor] attacks you with [the second noun], finishing you off!";
   end the story;
   stop the action
 
Report someone attacking the player with something (this is the standard report someone attacking the player with rule):
   say "[The actor] attacks you with [the second noun], causing [damage inflicted] point[s] of damage!" instead.
 
Report someone attacking something with something (this is the standard report attacking it with rule):
   say "[The actor] attacks [the noun] with [the second noun], causing [damage inflicted] point[s] of damage!" instead.
 
When play begins:
   now the left hand status line is "You: [current hit points of player]";
   now the right hand status line is "Gladiator: [current hit points of gladiator]".
 
Every turn (this is the gladiator-attack rule):
   if the gladiator is not dead, try the gladiator attacking the player with a random weapon which is carried by the gladiator.
 
Test me with "hit gladiator with mace / kill gladiator / drop mace / attack gladiator / attack gladiator with mace / g / g".

Those devoted to role-playing will note that our form of randomization is still pretty naive: most RPG systems use multiple dice in order to create more interesting probability curves. For a system that simulates actual dice-rolling, see the full "Reliques of Tolti-Aph" game.

wi 17.3 Overriding existing commands
rb 7.5 Combat and Death

113. Don Pedro's Revenge ★★★

Suppose our game features a detailed simulated combat between the player character and his opponent. He might have several weapons available, and several types of attack available; and at any given time he might be perched up in the rigging of his ship, standing on the open deck, or boxed in between some barrels. His options will vary depending on his position, and obviously it would detract from the pacing to make the player keep LOOKing in the middle of combat in order to remind himself where he is. Instead, we'll roll this information into the command prompt:

"Don Pedro's Revenge"

The Deck of the Helene Marie is a room. "The two crews are embattled all around you, but your attention is reserved for your particular enemy: Don Pedro."

Table of Random Prompts

position	prompt
boxed	"So securely boxed-in that you can really only parry or thrust, you try to "
boxed	"Trapped between your barrels, you decide to "
perched	"Able to slice at your attackers but not to advance or retreat, you choose to "
perched	"Perched up here with the advantage of height (but little mobility), you attempt to "
free	"Out on the open deck with no impediments, free to advance or retreat, you decide to "

When play begins: reset the prompt.

Every turn: reset the prompt.

To reset the prompt:

sort the Table of Random Prompts in random order;

repeat through the Table of Random Prompts:

if the position entry is the placement of the player:

now the command prompt is prompt entry;

stop.

After reading a command: say conditional paragraph break.

A placement is a kind of value. The placements are boxed, perched, free. The player has a placement. The player is free.

Understand "retreat" or "parry" as retreating. Retreating is an action applying to nothing.

Check retreating:

if the player is perched, say "You can't move backward or parry very successfully from this position." instead.

Carry out retreating:

now the player is boxed;

say "You protect yourself, but end up wedged in between two barrels."

Understand "thrust" or "advance" as advancing. Advancing is an action applying to nothing.

Check advancing:

if the player is perched, say "You can't move forward from here, only slash." instead.

Carry out advancing:

now the player is free;

say "You push forward aggressively, making your way to the open deck."

Instead of jumping:

now the player is perched;

say "You leap and swing yourself boldly up into the rigging, leaving your attackers beneath you."

Instead of jumping when the player is perched:

now the player is free;

say "You leap down from your position, into the middle of the deck."

Test me with "advance / jump / advance / retreat / jump / retreat / retreat / advance".

Of course, this won't be much fun until we also provide the player with a few weapons, some more fighting maneuvers, and, most of all, a Don Pedro to defeat.

wi 8.2 Changing the command prompt
rb 7.5 Combat and Death

127. Technological Terror ★★★

"Technological Terror"

The Decomposition Ray Gun is a thing carried by the player.

First we need to define our shooting action:

Shooting it with is an action applying to two things.
 
Check shooting something with something:
   if the player is not carrying the Ray Gun, say "You are pathetically unarmed!" instead;
   if the second noun is not the Ray Gun, say "[The second noun] does not fire." instead;
   if the noun is the Ray Gun, say "Nice trick if you can do it!" instead;
   if the noun is the player, say "That would be disastrous!" instead.

Next, some grammar to allow the player to use this action:

Understand "shoot [gun] at [something ungunlike]" as shooting it with (with nouns reversed).
 
Definition: a thing is ungunlike if it is not the gun.
 
Understand "shoot [something ungunlike] with [gun]" as shooting it with. Understand "shoot [something] with [something]" as shooting it with.
 
Understand "shoot [something] at [something]" as shooting it with (with nouns reversed). Understand "fire [gun] at [something ungunlike]" as shooting it with (with nouns reversed). Understand "fire at [something ungunlike] with [gun]" as shooting it with. Understand "fire at [something] with [something]" as shooting it with.

Strictly speaking, we only need these last grammar lines (with "understand shoot something…") in order to define an action that the player can take. Adding more grammar lines means that Inform will try to match the most specific ones first, which is useful when the player types something ambiguous and there is one choice that obviously fits this action better than the others. See the chapter on Understanding for a further discussion.

Here we get to use "now…" to give it its destructive effect:

Carry out shooting something with something:
   say "ZAP! [The noun] twinkles out of existence! [if something is part of the noun][The list of things which are part of the noun] clatter to the ground! [end if][paragraph break]";
   now every thing which is part of the noun is in the location;
   now the noun is nowhere.
 
The Deathbot Assembly Line is a room. "Here is the heart of the whole operation, where your opponents are assembled fresh from scrap metal and bits of old car." The dangerous robot is a thing in the Assembly Line. "One dangerous robot looks ready to take you on!" A robotic head, a drill arm, a needle arm, a crushing leg and a kicking leg are parts of the dangerous robot.
 
Instead of examining something when something is part of the noun:
   say "[The noun] consists of [a list of things which are part of the noun]."
 
Test me with "x robot / shoot robot / fire at kicking leg / shoot gun at drill arm / look".

wi 8.11 Now...
rb 7.5 Combat and Death

🔗

RB §7.6 Getting Started with Conversation

Traditionally, conversation is one of the most difficult things to program in interactive fiction, because of the number of factors affecting the outcome of everything the player does. While it's acceptable for >EXAMINE POT to produce the same response every time the player types it, it's a bit less acceptable for ASK JOE ABOUT HIS ADULTERY to make Joe react the same way every time.

Conversation implementations often need to keep track of a lot of information: what else is going on in the model world, what the character knows, what plot phase we've reached, what mood the character is in, what else we've recently been talking about, whether we've said the same thing before (and how many times); and so on. Later in this chapter we will look at ways to model character knowledge and mood.

Then, too, we have the problem of how the player communicates his conversational intentions to the story. Technology has not yet advanced to the point where a player can simply type in remarks in full natural English and have the character detect the significance, emotional tone, and subtext, if any: so we can't have RACHEL, THIS DESSERT TASTES LIKE FEET or WILL, LOOK! OUR SINISTER METAL FOES ARE APPROACHING! or BOSS, I WOULD BE DELIGHTED TO FILE ANOTHER TPB REPORT.

The challenge is to create an interface that is both easy for the player to use and expressive enough to be interesting. We will look at some of the common solutions in "Saying Complicated Things".

The examples in the following sections point out ways to approach common conversation problems. None of them will offer an adequate system if we want to write a very conversationally rich story, however. This is partly because a thorough conversation system requires quite a lot of code in its own right. It's also partly because there is no one right solution to the problem of conversation design. Different games will have quite different requirements. When making decisions about a new story we have planned, it may be useful to glance through the conversation extensions available for Inform: there are quite a few, offering a range of different interfaces. Even if none is exactly suited for our needs, they may suggest ways to solve particular implementation challenges.

At the other end of the scale, though, there are times when Inform's default implementation is too complicated for what we want to do: so we will start with ways to simplify conversation, before moving to all the exotic complexities.

Before we get into these details, though, we have a couple of examples that are literally about getting started with a conversation: Mimicry ★★★ introduces the feature that we must greet other characters before beginning to speak to them; The Gorge at George ★ corrects the player's attempts to use a TALK TO command where a different mode of interaction is appropriate instead.

Examples

330. The Gorge at George ★

"Gorge at George"

The Dusty Lot is a room. "A few miles up the road from the concert venue, but at least it's cheap to park here."

The motorcyclist is a man in the Dusty Lot. "A man clad in [a list of things worn by the motorcyclist] leans against his Harley and watches you without saying anything." The Harley is scenery in the Lot. The motorcyclist wears a black leather jacket and shades. Understand "man" or "guy" as the motorcyclist.

Understand "talk to [someone]" as a mistake ("To start a conversation, try to ASK [the noun] ABOUT something or TELL [the noun] ABOUT something.").

Instead of asking the motorcyclist about something:

say "He smirks cryptically."

Instead of telling the motorcyclist about something:

say "This does not seem to interest him much."

Test me with "talk to motorcyclist / ask motorcyclist about himself / tell motorcyclist about me".

wi 17.21 Understanding mistakes
rb 7.6 Getting Started with Conversation

110. Mimicry ★★★

Suppose we want to add a sense of some conversational flow, so that the player is forced to acknowledge the presence of people before beginning detailed conversations with them. We collect all speech actions into a single category:

"Mimicry"

Asking someone about something is speech. Telling someone about something is speech. Answering someone that something is speech. Asking someone for something is speech.

And then write a general rule.

Before speech in the presence of an ungreeted person: try waving hands.

One complication is that "asking someone to try doing something", which describes commands such as FRED, GO SOUTH, cannot be made into a kind of action. This requires its own rule:

Before asking someone to try doing something in the presence of an ungreeted person: try waving hands.

Now we define what greetings are going to look like:

Check waving hands:
   unless the player can see someone who is not the player, say "You are alone." instead.
 
Carry out waving hands:
   say "You nod hello to [the list of ungreeted people who can be seen by the player].";
   now every ungreeted person who can be seen by the player is greeted.
 
The report waving hands rule is not listed in the report waving hands rulebook.

Because of the way we've defined the command, this will now also work if the player waves.

A person can be greeted or ungreeted. A person is usually ungreeted. The player is greeted.

And now the scenario:

The International Convention of Mimes is a room. Lester, Harold, Geoff, Kwame, and Peter are men in the Convention. Elouise is a woman in the Convention. The Invisible Box is an enterable container in the Convention. "You can detect, from the way people keep leaning on it, an invisible box in the middle of the room."
 
Lester carries a bowler hat.
 
Instead of speech in the presence of someone:
   describe poor reception.
 
Definition: a person is other if it is not the player.
 
At 9:01 AM:
   move Phineas to the location; say "A mime called Phineas appears from the non-existent bathroom."
 
Phineas is a man.
 
A persuasion rule:
   describe poor reception;
   persuasion fails.
 
To describe poor reception:
   if the player is in the Invisible box,
      say "Everyone convulses with silent laughter as you try to shout from within the invisible box.";
   otherwise
      say "You attempt to convey your meaning with gesture and interpretive dance, but [the list of visible other people] scorn[if the number of visible other people is 1]s[end if] your performance, refusing to respond."
 
Test me with "ask lester about work / lester, east / ask lester for bowler / lester, nice not talking to you / get in box / ask lester for hat / phineas, east".

wi 7.15 Kinds of action
rb 7.6 Getting Started with Conversation

🔗

RB §7.7 Saying Simple Things

There are times when even the commands ASK and TELL are overkill: sometimes the player doesn't have much information to offer, so TELL is never useful, for instance. If we don't want to make any distinction between modes of conversation, we can conflate the actions so that ASK LUCIUS ABOUT OLLIVANDER, TELL LUCIUS ABOUT OLLIVANDER and LUCIUS, OLLIVANDER all do the same thing: see Sybil ★.

If we are frequently permitting the player to say things like LUCIUS, OLLIVANDER as shorthand for "talk to Lucius about Ollivander", then we may also want to allow LUCIUS, OLLIVANDER? This makes the player character seem a bit slow (or at least Laconic), but it is an effective interface in some cases. The trick is that the question mark at the end of the command may prevent Inform from recognizing the keyword; should that problem arise, we may want to use Punctuation Removal to erase question marks from the player's command before attempting to interpret it.

Along the same lines, there are situations in conversation where similar commands do not correspond to the same actions within Inform; if we're careless about this, we may force the player to guess which vocabulary we want him to use, which is always vexing. Some cases to look out for:

Inform has actions for "saying yes" and "saying no". Sometimes this is useful, but sometimes we want YES and SAY YES TO FRED to do the same thing. Sybil 2 ★★ shows how to roll these responses into one; Proposal ★★ expands on the idea to show more ways in which a player could reasonably answer a question put by another character.

Again, if we want ASK SYBIL ABOUT CAKE to do the same thing as SHOW CAKE TO SYBIL, we might use the technique in Nameless ★★ to make objects into valid topics of conversation, and to make ASK and SHOW behave the same way.

Finally, if we want to be able to ASK and TELL an inanimate object -- say, a computer -- about something, we may use the extension Inanimate Listeners to add this capability.

Examples

91. Sybil 1 ★

Sometimes we do not particularly want to deal with all the variations on asking, telling, or answering someone something, but want to direct everything to a single conversational command:

"Consulting the Oracle"

The Grove is a room. In the Grove is a woman called the Sybil.

Instead of telling someone about something, try asking the noun about it. Instead of answering the noun that something, try asking the noun about it.

Instead of asking the Sybil about "persians", say "She nods gravely."

And similarly, a difference between GIVE and SHOW is sometimes overkill:

Instead of showing something to someone, try giving the noun to the second noun.
 
The player carries a coin. Instead of giving the coin to the Sybil: move the coin to the Sybil; say "She accepts with a smile."

It is also often the case that we want to accept more than one form of a term. For instance

Instead of asking the Sybil about "Darius/king", say "Her smile unnerves you."

will match either "Darius" or "king". If necessary, we can go a step further and define our own token to match a variety of phrases, like this:

Understand "Athenians/Spartans/Greeks" or "hoplite army/forces" as "[Greeks]". Instead of asking the Sybil about "[Greeks]", say "She looks encouraging."

The token "[Greeks]" will match all of "Athenians", "Spartans", "Greeks", "hoplite army", or "hoplite forces". It will not match "hoplite" or "forces" alone; it is important to note that the / divides individual words which are understood equivalently, but does not define entire phrases as equivalent. More about how Inform understands specific phrases can be found in the chapter on Understanding.

Test me with "test one / test two".
 
Test one with "ask sybil about persians / tell sybil about persians / sybil, persians / ask sybil about darius / ask sybil about king".
 
Test two with "ask sybil about greeks / ask sybil about athenians / ask sybil about hoplite army / ask sybil about hoplite forces / give the coin to the sybil".

wi 7.6 Reading and talking
rb 7.7 Saying Simple Things

93. Sybil 2 ★★

Inform already understands YES, NO, and SORRY as commands in their own right, which can make things a little sticky when we want a character to ask a question of the player. The most important thing is not to cover some of the possible phrasings while ignoring others.

"Replies"

The Grove is a room. In the Grove is a woman called the Sybil.

Instead of asking the Sybil to try saying no: try saying no. Instead of asking the Sybil to try saying yes: try saying yes. Instead of asking the Sybil to try saying sorry: try saying sorry.

Instead of answering the Sybil that "yes", try saying yes. Instead of answering the Sybil that "no", try saying no. Instead of answering the Sybil that "sorry", try saying sorry.

Instead of saying yes in the presence of the Sybil:

say "She looks interested."

Instead of saying no in the presence of the Sybil:

say "She looks annoyed."

Instead of saying sorry in the presence of the Sybil:

say "She looks bored."

The complexity arises from the fact that we want to handle both YES and SYBIL, YES. If we only had the latter, 'yes' would be treated as a text given to the Sybil, just as in the commands SAY YES TO SYBIL or ANSWER YES. But because we have defined it as a command (so that the player can use it independently), SYBIL, YES is understood as an order to the Sybil to do the YES action.

Fortunately, we can redirect everything, as here, so that the results wind up the same.

And if we want yet another variation not covered by the Inform standard:

Understand "tell [someone] [text]" as answering it that. Understand "tell [someone] that [text]" as answering it that.

But that is a matter for a later chapter.

Test me with "yes / sybil, yes / say yes to sybil / answer yes / tell sybil yes / no / sybil, no / say no to sybil / answer no / tell sybil no /  sorry / sybil, sorry / say sorry to sybil / answer sorry / tell sybil sorry".

wi 7.6 Reading and talking
rb 7.7 Saying Simple Things

171. Proposal ★★

Suppose we want to ask the player a question where he might say yes or no in response. There are two possible forms of this: the modal question where the player must pick one to proceed, and the non-modal question where he might also type other verbs.

"Proposal"

The story genre is "A Worked Example about Yes/No Questions".

Section 1 - Asking a Modal Yes/No Question

When play begins:

say "Do you like Mr Spruce? ";

if player consents, now Spruce is handsome;

otherwise now Spruce is ugly;

say paragraph break.

Section 2 - Mr Spruce's Non-Modal Question

Use full-length room descriptions.

The Conservatory is a room. "You are in a room full of plants."

Mr Spruce is a man in the Conservatory. Mr Spruce can be apprehensive or calm. Mr Spruce is calm. Mr Spruce can be handsome or ugly.

At 9:02 AM: say "Mr Spruce flings himself to his knees and implores you to become his lawfully wedded wife.";

now Mr Spruce is apprehensive;

Mr Spruce gives up in two minutes from now.

At the time when Mr Spruce gives up:

say "Mr Spruce sighs heavily, seeing that you don't intend to reply. 'Never mind, my dear, I'll ask later. Perhaps I should have spoken to your Papa first... yes, a gently-bred female... no wonder...'";

now Mr Spruce is calm;

Mr Spruce departs in one minute from now.

At the time when Mr Spruce departs:

if the player can see Mr Spruce, say "Mr Spruce takes his leave of you.";

otherwise say "Mr Spruce pokes his head in to say that he is leaving.";

end the story saying "Well, that is over..."

Instead of saying yes in the presence of an ugly apprehensive Mr Spruce:

now Mr Spruce is calm;

say "Remembering what your mother said to you about the stock exchange and Dear Papa, you close your eyes and accept Mr Spruce.";

end the story saying "Alas for your maiden hopes."

Instead of saying yes in the presence of a handsome apprehensive Mr Spruce:

now Mr Spruce is calm;

say "You are silent with delight for a moment before you say yes, yes!";

end the story saying "How Genevieve Stubbs will cry!"

Instead of saying no in the presence of an ugly apprehensive Mr Spruce:

now Mr Spruce is calm;

say "Gently you inform Mr Spruce that it is impossible. He seems less deflated than you had expected.";

end the story saying "Odd, that..."

Instead of saying no in the presence of a handsome apprehensive Mr Spruce:

now Mr Spruce is calm;

say "You lower your eyes and refuse petulantly, hoping to stir him to a more ardent repetition of these same requests. But then -- alack! -- he says 'I see how it is!' in a strangled voice, and strides from the room!";

end the story saying "A fatal error!"

And since the player might SAY YES TO SPRUCE, we had better reroute the relevant options:

Instead of answering Mr Spruce that "no", try saying no.
 
Instead of answering Mr Spruce that "yes", try saying yes.
 
Instead of asking Mr Spruce to try saying yes, try saying yes.
 
Instead of asking Mr Spruce to try saying no, try saying no.
 
Instead of saying sorry, try saying no.
 
Instead of asking Mr Spruce to try saying sorry, try saying no.
 
Instead of answering Mr Spruce that "sorry", try saying no.
 
Test me with "z / z / z / yes".
 
Test more with "z / z / z / no".

wi 11.5 Conditions and questions
rb 7.7 Saying Simple Things

297. Nameless ★★

By default, ASK SOMEONE ABOUT… applies only to a text token. We might want also to offer the player the option of asking characters about pieces of physical evidence. This example implements an ASK PERSON ABOUT THING command that is mostly synonymous with SHOW, with the added nuance that the player can ask about things that are not currently visible, as long as he has encountered them at some time in the past.

"Nameless"

The Black Chamber is a room. "Despite its menacing name, it is quite an ordinary room, underlying the post office above. Here letters are brought each day, unsealed, transcribed, resealed, and sent again on their way; their contents then analyzed and recorded."

The Nameless Advisor is a woman in the Black Chamber. "A woman whose name has never been disclosed to you sits at the window, writing numbers on a sheet of paper." The Advisor carries a sheet of paper. Understand "woman" as the nameless advisor.

The player carries a letter from the emperor. The description of the letter is "Though its origin is obvious, its meaning is secret: the letters are an inexplicable jumble."

Now we create our new action, "interrogating it about". We write the grammar lines so that we can show any object in sight to someone, but also ask someone about any object that we have ever interacted with in the game, whether it is currently visible or not.

A thing can be known or unknown. The Nameless Advisor is known.
 
Understand "ask [someone] about [any known thing]" as interrogating it about. interrogating it about is an action applying to two visible things.

Now we replace and redirect the showing action. This gets rid of the requirement in the default library that the player be holding anything he shows to another character:

Understand the commands "show" and "display" and "present" as something new.
 
Understand "show [something] to [someone]" or "display [something] to [someone]" or "present [something] to [someone]" as interrogating it about (with nouns reversed). Understand "show [someone] [something]" as interrogating it about.

This bit keeps track of what the player has seen, for the purposes of "any known thing":

Before printing the name of something (called the target): now the target is known.

Here we define what happens by default when we interrogate someone about something; we use the same response we get to asking someone about something that isn't otherwise interesting:

Carry out interrogating someone about something:
   say "There is no reply."

Now redirect all asking to a topic table, and all interrogating to an object table:

Instead of asking Nameless Advisor about a topic listed in the Table of Nameless Advisor Topics:
   say "[reply entry][paragraph break]".
 
Instead of interrogating Nameless Advisor about an item listed in the Table of Nameless Advisor Items:
   say "[reply entry][paragraph break]".
 
Table of Nameless Advisor Items

itemreply
letter"'It is enciphered,' she remarks[if the advisor can see the letter], glancing over the contents[otherwise], after you have offered a detailed description[end if]. 'A substitution cipher of some complexity, I believe.'"
Advisor"She listens to your inquiries about her identity and parentage with a placid smile, but does not answer."
 
Table of Nameless Advisor Topics

topicreply
"cipher""'I know many dozens of ciphers,' she replies, smiling in a disquieting way."
"substitution cipher""'One letter is allowed to stand for another,' she explains, folding her hands together patiently. The backs of both hands are tattooed with silvery stars."

And just so that we can test what happens when asking someone about something out of sight:

The safe box is a container in the Chamber. It is fixed in place. It is openable and closed.

…and something unknown:

The poisonous apple is a thing.
 
Test me with "test sight / test knowledge".
 
Test sight with "i / x letter / ask Nameless Advisor about cipher / show cipher to Nameless Advisor / ask Nameless Advisor about the letter / show the letter to Nameless Advisor / show Nameless Advisor the letter".
 
Test knowledge with "open safe box / put letter in safe box / close safe box / ask Nameless Advisor about the letter / show the letter to Nameless Advisor / ask Nameless Advisor about the apple".

wi 17.5 The text token
rb 7.7 Saying Simple Things

🔗

RB §7.8 Saying Complicated Things

As we saw in the overview, there are challenges in choosing the commands with which the player will communicate to the story. Two common approaches are ASK/TELL conversation, where the player can ask or tell characters about keywords, as in ASK JILL ABOUT JACK or TELL FARMER ABOUT CHICKEN COOP, and menu-based conversation, where the player is offered a list of things to say and must pick one (often by number), as in

1) Ask Jill where Jack went.
2) Tell Jill that the chicken coop was robbed.

or, sometimes,

1) "Jill, have you seen your no-good layabout brother Jack anywhere?"
2) "Look, Farmer Jill, I think a fox got into the chickens."

The problem with ASK/TELL conversation is that it can feel undirected - if the player doesn't know which keywords to ask or tell about next, he gets stuck. It also doesn't always provide much sense of ongoing context or conversational flow, since the player can ask lots of unrelated questions and jump around a lot. What's more, sometimes the thing the player character asks isn't quite the question the player had in mind. If we type ASK JILL ABOUT JACK, Jill could wind up answering any of a number of questions - where Jack is, how old Jack is, whether Jack committed the recent murder, and so on. The player doesn't have much fine control over the conversation. Nonetheless, this is sometimes just what we want: Farewell ★★ implements a moderately sophisticated system along these lines, which keeps track of what the player has already said and allows him to review past conversation.

Menu-based conversation solves most of these problems: a branching tree of conversation choices maintains a consistent flow of discussion, it's hard for the player to run out of things to say, and the player always knows what his character is about to say. But there are compensating flaws. For one thing, a menu doesn't allow for many surprises. The player can see all the conversation the story has to offer by working methodically through all the menu branches. (This problem is sometimes referred to as the "lawnmower effect", since the process of seeing all the conversation is like the process of running a lawnmower over every inch of the lawn. It becomes a chore rather than an entertainment.) Menu systems can be long-winded to set up and therefore none are exemplified here, but several have been released as extensions for Inform.

Since about 2001, more and more IF has used a sort of compromise method: the player is allowed to ask or tell about keywords, but he's sometimes given prompts about things to say that follow naturally on the conversation he was just having, as in

You could ask where Jack is.

Moreover, when he asks about a topic where many comments are possible, he'll be allowed to clarify, either using a menu or through a disambiguation question such as

>ask Jill about Jack
Do you want to ask where Jack is, how old Jack is, or whether Jack committed the recent murder?

Sweeney ★★ implements one such hybrid type of conversation.

A third option is to take away almost all the player's expressiveness and give him just one command, TALK TO. The player can TALK TO characters whenever he wants, and the story will pick the most appropriate thing for him to talk about. This works best in works with few or simple puzzles and a fast-moving, constrained plot, where the player will keep having new things to talk about. Cheese-makers ★★★ demonstrates this.

Finally, a few extreme games try to fake natural language understanding by looking for keywords in the player's input, rather than an exact grammar. This is perilous, because it is all too easy for the story to completely misunderstand what the player meant to type. Nonetheless, for the sake of example, see Complimentary Peanuts ★★★, in which the incomprehension is partly excused by the fact that the player is talking to someone a bit hard of hearing.

Examples

281. Farewell ★★

We begin with the idea that each person comes with his own table of things to say:

"Farewell"

A person has a table name called conversation.

Instead of asking someone about something:

let the source be the conversation of the noun;

if topic understood is a topic listed in source:

if there is a turn stamp entry:

say "[The noun] has already told you that [summary entry].";

otherwise:

now turn stamp entry is the turn count;

say "[reply entry][paragraph break]";

otherwise:

say "[The noun] stares at you blankly."

For the sake of simplicity, we'll conflate asking and telling here, though it would certainly be possible to have a more complex implementation if we want the characters to be told things as well.

Instead of telling someone about something:
   try asking the noun about it.

Now we might want to add a recap command to review conversation that has already occurred.

Definition: a person is other if it is not the player.
 
Understand "recap" or "recall" or "review" as recalling conversations.
 
Recalling conversations is an action applying to nothing.

Since we've been recording the turn count of each conversation bit, we can even present these in order by sorting the tables first.

Carry out recalling conversations:
   repeat with speaker running through other people:
      let source be the conversation of the speaker;
      sort source in turn stamp order;
      say "[The speaker] has so far told you: [line break]";
      let index be 0;
      repeat through source:
         if there is a turn stamp entry:
            let index be 1;
            say "  [summary entry][line break]";
      if index is 0, say "  absolutely nothing[line break]";
      say conditional paragraph break.

Now it remains only to create a couple of characters and provide them both with something to say:

The Farewell Bend Cafe is a room. "Beautiful Farewell Bend, Idaho -- or is it Oregon? An almost-abandoned truckstop, in any case, on one of those interminable American east-west highways."
 
Tina is a woman in the Farewell Bend Cafe. The conversation of Tina is the Table of Tina's Chatter. "Tina the waitress is slowly pouring coffee from the pot with a black neck into the pot with an orange neck."
 
George is a man in the Farewell Bend Cafe. The conversation of George is the Table of George's Chatter. "There is also a large man at table five. The tattoo on his arm says George. For the moment we will assume that it is his own name and not someone else's."
 
Table of Tina's Chatter

topicreplysummaryturn stamp
"aasvogel""'Oh, it's a vulture.'""that an aasvogel is a vulture"a number
"acaudate""She shrugs, mid-pour. 'Means something doesn't have a tail.'""that acaudate means 'tailless'"--
"absorptiometer""'It's a thing that measures the solubility of gases in a liquid,' she explains gently, as to a child.""that an absorptiometer measures solubility of gasses in a liquid"--
 
Table of George's Chatter

topicreplysummaryturn stamp
"baccaceous""'Something that has or bears berries,' says George, without looking up.""that baccaceous means berry-bearing or berry-like"a number
"bagheera""'Oh, that'd be a velvet-like textile.'""that bagheera is a velvet-like textile"--
"balistarius""'That's a crossbow-man,' George replies instantly.""that a balistarius is a crossbow-man"--

A word of warning: this system does assume that every person in the game has a conversation table defined. If that were not the case, we would have to be a bit more careful.

As always, we can override specific words, too:

Instead of asking Tina about "advertisement" for the first time:
   say "Tina looks embarrassed. 'Of course! I almost forgot.' She hands you a brochure.";
   move the brochure to the player.
 
The encyclopedia sales brochure is a thing. The description is "A glossy flyer indicating that you can receive a free Volume A-Aalto of the New Idahoan Encyclopedia Set if you send back the business reply card, and then have the option of purchasing the remaining volumes at a very very reasonable price."
 
Test me with "recap / ask tina about aasvogel / recap / ask george about baccaceous / ask tina about absorptiometer / recap / ask tina about advertisement / read brochure".

wi 16.15 Varying which table to look at
rb 7.8 Saying Complicated Things

282. Sweeney ★★

"Sweeney"

A subject is a kind of thing. Some subjects are defined by the Table of Conversation Subjects.

Table of Conversation Subjects

subject	conversation
pies	Table of Pie Queries
employment	Table of Job Queries

Understand "job" as employment. Understand "meat" or "food" as pies.

Table of Job Queries

quip	discussion	label	subtopics
"whether there is a job available here"	"'Say, are you hiring?' you ask, as casually as you can manage. [The interlocutor] looks you over dubiously. 'I might be hiring someone, but I can't say it would necessarily be you.'"	0	--
"what happened to that boy that worked here"	"'Tell me, didn't you used to have a young assistant working here?' She shrugs. 'Young men these days are so unstable. He left-- who knows where he's gone? I haven't seen hair or fingernail of him for weeks.'"	0	--

with 3 blank rows.

Table of Pie Queries

quip	discussion	label	subtopics
"what pie fillings are available"	"'What pies do you have in today, Mrs Lovett?' you ask. She starts, then smiles. 'Meat pies, of course.'"	0	Table of Pie Flavor Queries

with 3 blank rows.

Table of Pie Flavor Queries

quip	discussion	label	subtopics
"what kind of meat"	"'What kind of meat goes into these pies, Mrs Lovett?' you ask pressingly. She looks shifty. 'Whatever the butcher brings this week,' she says. 'With the price of meat what it is, when you get it, you have to be glad of what you can get. If you get it.'"	0	--

To copy (first table - a table name) to (second table - a table name):

repeat through first table:

let copied quip be "blank";

if there is a quip entry, now the copied quip is the quip entry;

let copied discussion be "blank";

if there is a discussion entry, now the copied discussion is the discussion entry;

let copied subtopics be second table;

if there is a subtopics entry, now the copied subtopics are the subtopics entry;

choose a blank row in the second table;

if copied quip is not "blank", now quip entry is copied quip;

if copied discussion is not "blank", now discussion entry is copied discussion;

if copied subtopics is not second table, now subtopics entry is copied subtopics.

Current conversation table is a table name that varies. Current conversation table is Table of Job Queries.

Interlocutor is a person that varies.

Understand "ask [someone] about [any subject]" as asking it about the subject.

Asking it about the subject is an action applying to two visible things.

Carry out asking it about the subject:

say "You can't think of anything to say."

Instead of asking someone about the subject a subject listed in the Table of Conversation Subjects:

now interlocutor is noun;

now current conversation table is the conversation of the second noun;

if the number of filled rows in the current conversation table is 1:

repeat through current conversation table:

now label entry is 1;

now number understood is 1;

try selecting 1 instead;

if the number of filled rows in the current conversation table is 0:

say "You can think of nothing further to say on that topic.";

stop the action;

otherwise:

let index be 0;

let total be the number of filled rows in the current conversation table;

say "Do you mean ";

repeat through current conversation table:

now index is index + 1;

now label entry is index;

say "([index]) [quip entry]";

if index is total, say "?";

if index is total - 1, say ", or ";

if index is less than total - 1, say ", ".

Understand "[number]" as selecting.

Selecting is an action applying to one number.

Carry out selecting:

say "No such option is available."

Instead of selecting a label listed in the current conversation table:

say "[discussion entry][paragraph break]";

if there is a subtopics entry:

copy subtopics entry to current conversation table;

choose row with label of number understood in the current conversation table;

blank out the whole row.

Mrs Lovett's Meat Pies is a room. Mrs Lovett is a woman in Meat Pies.

Test me with "ask lovett about pies / ask lovett about employment / 1 / 2 / ask lovett about pies".

wi 16.16 Defining things with tables
rb 7.8 Saying Complicated Things

168. Cheese-makers ★★★

As we have seen, there are a number of different ways of controlling conversation in interactive fiction, and the best choice of way will depend quite a lot on what kind of work we're writing.

One common model is to replace Inform's default ASK and TELL commands with a TALK TO command. This gives the player less control than he would otherwise have: instead of asking a character about any topic under the sun, he's restricted to seeing (or not seeing) a single sequence of text that the author has written in advance. On the other hand, such a system is harder for the player to break (since he can never ask about a topic that the author hasn't implemented), and easier for the author to tie into plot developments. If we give TALK TO different output at each scene, we get conversation that is always tied to the current state of the plot.

This is a design approach that works best in a game with a large number of short, focused scenes. For other kinds of conversation system design, compare the other examples listed in the Recipe Book.

"The Cheese-makers" by Phrynichus.

Chapter 1 - Replacing old talk commands and making a new one

Here, using some techniques that will be discussed in the chapter on Understanding, we get rid of Inform's default handling of ASK and TELL, and create our own TALK TO action instead:

Understand the commands "ask" and "tell" and "say" and "answer" as something new.
 
Understand "ask [text]" or "tell [text]" or "answer [text]" or "say [text]" as a mistake ("[talk to instead]").
 
Instead of asking someone to try doing something:
   say "[talk to instead][paragraph break]".
 
Instead of answering someone that something:
   say "[talk to instead][paragraph break]".
 
To say talk to instead:
   say "(To communicate in [story title], TALK TO a character.) "
 
Understand "talk to [someone]" as talking to. Understand "talk to [something]" as talking to. Talking to is an action applying to one visible thing.
 
Chapter 2 - Specific scenes and talking

Now, suppose we have a situation -- say, a stage play -- in which it is appropriate to talk to different characters at different times. During the prologue of the play, no one else is on-stage, and the player is to address the audience directly:

Section 1 - Prologue
 
When play begins:
   now right hand status line is "416 BC";
   now left hand status line is "[location]".
 
Prologue is a scene. Prologue begins when play begins.
 
The Theater of Dionysus is a room.
 
The audience is a person in the Theater. "The usual audience looks on: the priests and judges in the front row, and then Athenians, metics, and foreigners." The audience can be prepared or unprepared. The description is "Have you ever seen such a company of perjurers, pathics, and thieves?" Understand "priest" or "priests" or "priest of dionysus" or "judge" or "judges" or "athenians" or "metics" or "foreigners" as the audience.
 
Instead of talking to the player when the Prologue is happening:
   say "There will be plenty of occasion for muttered asides later in the play, but for now you must prepare the audience for things to come."
 
Instead of talking to the audience when the Prologue is happening:
   say "Drawing breath, you turn to the audience, and offer them a genial, witty, colorful, and of course crude synopsis of what they are about to see; describing all the characters in unmistakable terms and not omitting the most important of them all, your august self.";
   now the audience is prepared.
 
Instead of talking to the audience when the Prologue has happened:
   say "You may only direct monologues to the audience when the other actors are off-stage. Otherwise, their characters might have to notice."
 
Prologue ends when the audience is prepared.

But there might follow a scene in which the player shouldn't talk at all:

Section 2 - Parodos
 
Parodos is a scene. Parodos begins when Prologue ends.
 
When Parodos begins:
   move the chorus to the theater.
 
Instead of talking to someone during Parodos:
   say "Sssh: this moment belongs to the chorus. They've worked so hard on it, after all."
 
Parodos ends when the time since Parodos began is 4 minutes.
 
The chorus is a person. The description is "They are dressed in exaggerated rural costume and feminine masks, as they are meant to represent a company of female cheese-makers from the Spartan-occupied deme of Dekeleia." Understand "cheesewives" or "cheese-makers" or "chorus-leader" as the chorus.
 
Every turn during Parodos:
   repeat through Table of Choral Events:
      say "[output entry][paragraph break]";
      blank out the whole row;
      make no decision.
 
Table of Choral Events

output
"The chorus now begins its entry, accompanying with anapestic song its march up the eisodos."
"The chorus draws nearer, stomping and clomping and swinging their baskets of cheese."
"You stand aside as the chorus fills the orchestra and dances to and fro."
"The tune of the aulos-player grows more and more frenzied and then breaks off."

This last rule is a refinement borrowing from the Activities chapter, which gives characters different appearances in room descriptions depending on when we happen to look; because of the action of the play, we want to show the chorus and audience doing different things during different scenes.

Rule for writing a paragraph about the chorus during Parodos:
   say "The chorus are dancing and singing their way[if the time since Parodos began is less than 3 minutes] up the long walkways onto the stage[otherwise] into position in the orchestra[end if]. [The audience] appear to be pricing their costumes to the nearest obol: woe to the producer who cheats them of their due share of spectacle."

And now a scene in which the player can talk several times to a character (Heracles) but has no useful dialogue with the chorus, the audience, or himself. The prohibition from talking to the audience after the Prologue is already written, but we'll supply some appropriate responses for talking to the player or the chorus during this scene:

Section 3 - Episode
 
Episode is a scene. Episode begins when Parodos ends.
 
When Episode begins:
   move Heracles to the theater;
   say "The chorus falls silent, which is the cue: Heracles bursts out of the scene building."
 
Heracles is a man. The description is "Hard to mistake in his lion skin and boots, and carrying a formidable club." Heracles wears a lion skin and boots. He carries a formidable club. Heracles can be placid or annoyed. Heracles is placid. Heracles can be satisfied, intrigued, or unsatisfied. Heracles is unsatisfied.
 
Instead of talking to the chorus during Episode:
   say "Your improvised flirtation with the chorus raises no response but a crude gesture from the chorus-leader, who seems to be modeling the role on Iambe."
 
Instead of talking to the player during Episode:
   if Heracles is annoyed:
      say "You mutter to yourself about men with more appetite than brain. The actor playing Heracles ignores you, but it's good odds he's scowling under his mask. He hates it when anyone but himself ad-libs for attention.";
   otherwise:
      now Heracles is annoyed;
      say "'By the dog, he'll eat me if he gets a chance,' you mutter aside. [paragraph break]'What's that you say, my ignoble friend?' demands Heracles, hefting his club. He's not entirely joking: you've left the script just now."
 
Instead of talking to Heracles when Heracles is unsatisfied during Episode:
   say "'Dear Heracles, friendly Heracles,' you begin, cringing out of the way as he responds with one of his affectionate ox-killing punches to the shoulder. [paragraph break]But Heracles falls still, and looks almost thoughtful, as tell him you know how he may rout the Spartans, woo all twenty-four lactic ladies, and tame his savage gut with a bathtubful of porridge. [paragraph break]'Speak on, little man,' he says.";
   now Heracles is intrigued.
 
Instead of talking to Heracles when Heracles is intrigued during Episode:
   say "It takes several exchanges for him to wrap his one-inch brain around your ten-inch plan; but in the end he embraces the scheme, the women, and your humble self.";
   now Heracles is satisfied.
 
Every turn when not talking to someone during Episode:
   repeat through Table of Episodic Events:
      say "[output entry][paragraph break]";
      blank out the whole row;
      make no decision.
 
Table of Episodic Events

output
"With a fart and a roar, Heracles asks the world at large, and you in particular, where his dinner might be."
"In epic diction, Heracles invites the dairy-mistresses, whey-matrons, and concubines of curd to supply him a supper from their ample baskets."
"Heracles and the chorus banter about the proclivities of cheese-wives. The chorus suggest that Heracles, as a son of Zeus, must know something about the appetites of which they speak."
"Heracles boasts that a man like himself can perform any feat, but only when his belly is full. Coyly, the matrons prance and dance, skip and gambol out of his grasp, singing mockingly about heads of garlic and loaves of sesame-crusted bread."
"The song of the feta fanciers now turns to pots of honey and new-made wine, borrowing verses from last year's Lenaia winner, 'The Bees'. With a jolt, you realize that you've missed your cue and the chorus are filling in for you."
"Playing for time, the chorus-leader elaborates a whole banquet: rabbit stew, shanks of lamb, spitted quails, eels from lake Copais. Heracles looks as near swooning as any girl fresh from Brauron."
"The chorus-leader extends the list of delicacies to include ox-brains, ham-hocks, barley, mullet, carrots, pigeons, lentils, radishes, peas, and apples both wine-dark and golden. The audience shifts on the benches. An expression of gloom settles over the Priest of Dionysus in the front row."
"Inspired by Euripides['] own Muse, the chorus-leader invents a mock-Alcaean hymn on the merits of chervil. This is clearly his swan-song: if you don't speak at last, the play will come to a halt."
"Silence descends."
 
Rule for writing a paragraph about Heracles during Episode:
   say "[Heracles] stands at the center of the orchestra, with members of [the chorus] ranged on either side. [paragraph break][The audience] appear to be reserving their judgement, though they show signs of restiveness at the usual jokes: must there be a Heracles in [italic type]every[roman type] play?"
 
Episode ends successfully when Heracles is satisfied.
 
When Episode ends successfully:
   say "That, of course, is your cue: you're to come back on as Pan thirty verses from now, and it takes time to put on the hooves and the woolly-legged trousers.";
   end the story saying "You exit".
 
Episode ends disastrously when the number of filled rows in the Table of Episodic Events is 0.
 
When Episode ends disastrously:
   end the story saying "The production has crashed to a halt".
 
Test me with "ask audience about me / tell audience about me / audience, hello / audience, jump / talk to me / talk to audience / g / talk to chorus / look / x heracles / talk to me / talk to audience / z / look / talk to heracles / g".

wi 10.9 Why are scenes designed this way?
rb 7.8 Saying Complicated Things

376. Complimentary Peanuts ★★★

The "reading a command" activity is not the only point at which we can interact with snippets, as it happens; it is merely the most useful. "The player's command" can be consulted at other points, however, as in this example of your somewhat deaf (or distracted, or simply cussed) Aunt:

"Complimentary Peanuts"

Instead of asking Aunt Martha to try doing something:

repeat through Table of Aunt Martha's Commentary:

if player's command includes topic entry:

say "[commentary entry][paragraph break]";

rule succeeds;

say "'Hmmf,' says Aunt Martha."

The topic understood is also a snippet, so that whenever one has been generated, we can treat it in the same way as "the player's command":

Asking someone about something is speech.
Telling someone about something is speech.
Answering someone that something is speech.
Asking someone for something is speech.
 
Instead of speech when the noun is Aunt Martha:
   repeat through Table of Aunt Martha's commentary:
      if the topic understood includes topic entry:
         say "[commentary entry][paragraph break]";
         rule succeeds;
   say "'Hmmf,' says Aunt Martha."

This is superior to checking "the player's command" because we do not want ASK MARTHA ABOUT FRENCH FRIES to trigger the "Martha" keyword, only the "french fries" keywords.

The Empyrean Shuttle Bay is a room. "From here you have an excellent view of the colony world, which looks... well, it looks discouragingly orange. But terraforming is in progress."
 
Aunt Martha is a woman in the Empyrean Shuttle Bay. A gleaming shuttle and a stack of rations are in the Shuttle Bay. The shuttle is a vehicle. "Your shuttle awaits."
 
Table of Aunt Martha's Commentary

topiccommentary
"shuttle""'Shuttles! I hate shuttles,' Aunt Martha grumbles. 'Give me an airplane! AIRPLANE.'"
"airplane/airport""'Those were the days,' Aunt Martha agrees, plainly reliving the days when she wore a blue-and-white uniform and passed out packets of salted pretzels."
"rations""'Do you think there are any peanuts in there?' she asks in a wistful tone."
 
Test me with "martha, get in the shuttle / martha, for pity's sake, do you see an airplane around here? / martha, pass me the rations".

This means that Martha will respond to keywords regardless of the setting in which they occur. For instance:

>martha, get in the shuttle
"Shuttles! I hate shuttles," Aunt Martha grumbles. "Give me an airplane! AIRPLANE."
 
>martha, for pity's sake, do you see an airplane around here?
"Those were the days," Aunt Martha agrees, plainly reliving the days when she wore a blue-and-white uniform and passed out packets of salted peanuts.
 
>martha, pass me the rations
"Do you think there are any peanuts in there?" she asks in a wistful tone.

This is not the stuff of which Loebner-winning chatbots are made, admittedly, but it is occasionally a useful alternative to stricter modes of command-parsing.

wi 18.33 Reading a command
rb 7.8 Saying Complicated Things

🔗

RB §7.9 The Flow of Conversation

All this discussion of conversation commands and ways to model dialogue doesn't address the higher-level design issue: how do we approach writing this material so that it has a rhythm and flow? How do we know when we've created enough conversation? How can we avoid sounding hopelessly stilted when the nature of IF implementation requires us to break our text into small snippets?

While most authors develop their own approaches, there is some general advice that may help, especially for works that have a strong narrative progression.

It helps to have the plot of the story, with all its component scenes, planned in advance. That doesn't mean there can't be any changes later, but having a list of the different scenes can help us remember the different contexts in which information can appear. If we're using Inform's scenes feature, we may even want to restrict some dialogue to be available only during a given scene.

The next step is to go through scene by scene and create the "spine" of the scene. What must be said during this section? Is there anything the player can't leave without knowing? If the player isn't moving the scene forward fast enough, will the other character or characters volunteer information in order to keep the pace going?

It often helps to draft a transcript showing what we imagine as the ideal playthrough of the scene - writing straight through can create a natural flow of dialogue - before dividing the dialogue into pieces for implementation.

Once the scene is complete enough for the player to get through from beginning to end, we can start filling it out. At this point, it sometimes helps to play through the scene a number of times and add new dialogue elements as we think of things that our character might reasonably want to say. Sometimes these additions will turn out to be short tangents from the main flow of a very directed scene; sometimes they might be important branches that lead the scene to an entirely alternate outcome. The main thing is to make sure that, if the scene needs to hit certain points before ending, none of our branches keep the player from returning to the subject at hand.

🔗

RB §7.10 Character Emotion

In a complex story, characters may evolve strong feelings about the player. Often we want to hint at the character's feelings through gesture and tone of voice - little things woven into dialogue and action sequences that might otherwise be unchanged. Ferragamo Again ★★ demonstrates creating phrases to give all our characters different ways to express their irritation at the player.

Then again, sometimes a discussion might produce quite spectacular results if a character is in the wrong mood. Being Peter ★ shows the bare bones of an implementation in which a character's attitude rulebook is consulted to determine what her response will be - allowing for arbitrarily complicated outcomes.

Examples

404. Being Peter ★

Let's say that we're implementing a particularly irrational and volatile character. Some of the time she remains composed; some of the time she reacts with unexpected vehemence for reasons only partly related to what was said.

Moreover, her responses are divided between successful and failing outcomes, where success indicates that she's not too upset and failure means that she is distraught; we use this to determine how the rest of the room reacts.

"Being Peter"

The Drawing Room is a room. "The company is assembled here for champagne. Most of it, anyway: Mary is on the phone to her babysitter, Roger is keeping her anxious company, and Carol doesn't drink. But everyone else."

Maggie is a woman in the Drawing Room.

The player wears a top hat.

Quizzing it about is an action applying to one thing and one visible thing. Understand "ask [someone] about [any thing]" as quizzing it about.

Instead of quizzing Maggie about something:

follow the attitude rules;

say "Everyone waits to see what the reaction will be: [outcome of the rulebook].";

if rule succeeded, say "There is general relief.";

otherwise say "Everyone is pointedly silent."

The attitude rules are a rulebook. The attitude rules have outcomes she stays calm (no outcome - default), she gets angry (failure), she has a stroke (failure), she is only mildly annoyed (success), and she is elated (success).

Here we want Inform to consult every appropriate attitude rule until it gets to some answer; if an attitude rule does not provide a result, the default 'no outcome' will mean that we go on to the next rule, and so on.

A subject is a kind of thing. income, love life, and children are subjects.
 
An attitude rule for quizzing Maggie about love life:
   she gets angry.
 
An attitude rule:
   if the player wears the top hat, she gets angry.

Now, as we saw, the 'no outcome' result will never be returned and printed as Maggie's reaction, precisely because it is "no outcome". Therefore, we provide a final attitude rule which will give her a default response to all statements:

The last attitude rule:
   she is only mildly annoyed.
 
Test me with "ask maggie about love / ask maggie about income / take off hat / ask maggie about income".

There are plenty of contexts where we might want named outcomes for clarity but not want to print the results literally afterward.

wi 19.12 Named outcomes
rb 7.10 Character Emotion

170. Ferragamo Again ★★

Here we use phrases that match individual items where possible, and the general kind otherwise:

"Ferragamo Again"

The Break Room is a room. Vanessa, Tina, and Lisa are women in the Break Room. Mark and Holman are men in the Break Room.

Understand the commands "ask" and "tell" and "answer" as something new.

Understand "talk about [any subject]" as talking about. Talking about is an action applying to one visible thing.

Understand "talk about [text]" as talking randomly about. Talking randomly about is an action applying to one topic. Carry out talking randomly about: say "Mostly you're interested in [the list of subjects]."

Carry out talking about something:

now the previous subject is the noun.

Report talking about something:

say "You chat for a while about [the noun]."

A subject is a kind of thing. Assyrian vowel sounds, designer handbags, and instant run-off voting are subjects. Understand "linguistics" and "mute" and "stop" as sounds. Understand "prada" and "tods" and "coach" and "carmen marc valvo" as designer handbags. Understand "reform" and "election" and "election fraud" and "two-party system" and "Diebold" as instant run-off voting.

To say (annoyed-person - a person) gestures in irritation:

say "[The annoyed-person] sighs heavily. [run paragraph on]"

To say (annoyed-person - Vanessa) gestures in irritation:

say "[The annoyed-person] takes off her glasses and polishes them on her sleeve. [run paragraph on]".

To say (annoyed-person - Holman) gestures in irritation:

say "Holman bobs his head. [run paragraph on]"

The previous subject is a subject that varies.

Instead of talking about something for more than one turn:

if the noun is the previous subject, say "[a random visible person who is not the player gestures in irritation]Maybe you should let this one go.[line break][paragraph break]";

otherwise continue the action.

Test me with "talk about chocolate / talk about vowel sounds / g / talk about handbags / talk about prada / talk about tods".

wi 11.3 Pattern matching
rb 7.10 Character Emotion

🔗

RB §7.11 Character Knowledge and Reasoning

A character may be endowed with knowledge and even reasoning skills. Relations form quite a good way of keeping track of such problems: for instance, we can allow characters to be acquainted with one another with a relation such as

Lucy knows Lady Cardew.

Or we might keep track of more complicated attitudes between characters, as in Murder on the Orient Express ★★, in which some characters suspect others of the crime.

Alternatively, we might have a list of salient facts that are important in our story. We might declare these as values, and then characters could know, learn, and forget entries as appropriate:

A fact is a kind of value. Some facts are defined by the Table of All Known Facts.
 
Knowledge relates various people to various facts. The verb to know (he knows, they know, he knew, it is known) implies the knowledge relation.
 
Table of All Known Facts

factsummary
shoe-size"Lucy wears a size 9 shoe."
sunset-time"Sunset is at 8:22 PM this evening."
 
Lucy knows shoe-size.
Bob knows sunset-time and shoe-size.

Or again we might keep a whole database of information in a table: the characters in Questionable Revolutions ★★★ know dates, countries, and a short description for each of several rebellions and popular uprisings, while in Queen of Sheba ★★★, Solomon is able to answer who, what, where, when, and why questions about a range of topics. This kind of approach is most useful when the characters need to display a deep knowledge of a particular field. The facts stored in the Table of All Known Facts, above, are comparatively sparse, because there we are designing a story in which not all data about the world is equally valuable: Lucy doesn't know the shoe size of every person in the story, because for some reason it is only her own shoe size that matters. On the other hand, the Table of All Known Facts can store different kinds of information, whereas the revolutions table has no way of storing shoe sizes or sunset times. And Murder on the Orient Express ★★ works differently again, because it is storing knowledge that concerns people and things that already exist in the world model, rather than abstract ideas. Our way of modeling character knowledge, in other words, will depend quite a lot on what kind of knowledge it is.

The possibilities of character reasoning are similarly broad, but The Problem of Edith ★★★ introduces one kind: the character has a concept of how different conversation topics relate to one another, so that when she is asked about a new keyword, she picks a response that makes the question most relevant to the conversation already in progress.

We end with a longer scenario, in which we track what the character knows about the player and the conversational state: in Chronic Hinting Syndrome ★★★★, the main character guides conversation in the direction he intends it to go, with the player's sometimes-reluctant participation.

Examples

241. Murder on the Orient Express ★★

The following example creates two new relations, and two new verbs, in order to set up a tangled web of intrigue.

"Murder on the Orient Express"

The Dining Car is a room. Lord Peter is a man in the Dining Car. Sherlock Holmes is a man in the Dining Car. Miss Marple is a woman in the Dining Car. Adam Dalgliesh is a man in the Dining Car.

Suspecting relates various people to one person.

The verb to suspect means the suspecting relation.

Dalgliesh suspects Holmes. Holmes suspects Lord Peter. Lord Peter suspects Holmes. Miss Marple suspects the player.

Exculpating relates one thing to various people.

The verb to exculpate means the exculpating relation.

The silver bullet exculpates the player. The pipe ash exculpates Holmes. The poison pen letter exculpates Lord Peter. The poison pen letter exculpates Miss Marple. [Poor Dalgliesh. I guess he did it.]

The pipe ash, the letter and the silver bullet are carried.

Given this, we can then set up elaborate rules:

Instead of showing something to a person who suspects the player:
   say "'You would say that,' remarks [the second noun] darkly.".
 
Instead of showing something which exculpates the player to someone:
   say "'How striking!' says [the second noun]. 'Almost I begin to distrust myself.'".
 
Test me with "show the letter to miss marple / show the silver bullet to holmes".

And so on: "if Dalgliesh suspects someone who is exculpated by something carried by the player…", for instance, makes a fitting final example for this chapter. The description

someone who is exculpated by something carried by the player

expresses a complicated idea in very few words, and in such a way that a passer-by looking at the source text would immediately see what was meant.

The moral is that relations allow sophisticated patterns of behaviour to be created in a way that reads back naturally as English.

wi 13.16 What are relations for?
rb 7.11 Character Knowledge and Reasoning

235. The Problem of Edith ★★★

Suppose that we have a core set of issues we want to be able to bring up with all the characters, and we want characters to draw intelligent connections between different conversation topics. We will need some model of how things relate to one another, so:

"The Problem of Edith"

Suggestion relates things to each other. The verb to suggest means the suggestion relation.

A subject is a kind of thing. The current subject is a thing that varies. greeting is a subject.

Understand "ask [someone] about [any subject]" as asking it about the subject. Understand "tell [someone] about [any subject]" as asking it about the subject.

Asking it about the subject is an action applying to one thing and one visible thing.

Carry out asking it about the subject:

say "'Hmm, [the second noun],' says [the noun]. ";

relate the current subject with the second noun;

now the current subject is the second noun.

And if we wanted to offer the player some hints about angles he could pursue:

Instead of thinking:
   say "You contemplate [a list of things suggested by the current subject]."

For that matter, we could use the same system to have characters make sense of any physical evidence the character shows them:

Instead of showing something which suggests the current subject to someone:
   say "[The second noun] nods impatiently."
 
Instead of showing something to someone:
   let the next subject be the next step via the suggestion relation from the noun to the current subject;
   if the next subject is a subject:
      try asking the second noun about the subject the next subject;
   otherwise:
      say "[The second noun] shrugs."
 
When play begins:
   now the left hand status line is "Discussing: [current subject]";
   now the right hand status line is " ".
 
Broughton Hall is a room. Lady Uckfield is a woman in Broughton Hall. "Lady Uckfield sits at her desk, looking wholly composed."
 
The nasty letter is a thing carried by the player. The nasty letter suggests infidelity and penmanship. The ten-pound note is carried by the player. It suggests money.
 
Infidelity is a subject. Infidelity suggests marriage and divorce. Marriage suggests love. Marriage, love, and divorce are subjects.
 
Penmanship is a subject. Penmanship suggests education. Education is a subject. Class status and money are subjects. Class status suggests education. Money suggests class status and marriage.
 
The current subject is divorce.

Now we can define what gets said when the subject is changed, regardless of whether the segue was introduced in speech or by a shown object. Since rows are blanked after use, the speaker will never repeat herself; if we provide more than one line about the same pair of topics, the first one will be used, then the second, and so on, until the table runs out:

To relate (initial - a subject) with (next - a subject):
   repeat through Table of Remarks:
      if the initial is starting entry and the next is the final entry:
         say "[comment entry][paragraph break]";
         blank out the whole row;
         rule succeeds;
   say paragraph break.
 
Table of Remarks

startingfinalcomment
divorcelove"'As it seems to me, all the love is on one side,' she says crisply. 'And that rarely works.'"
divorcelove"'Stop making that plea: it won't work.'"
divorceinfidelity"'Frankly, I rather think there would have been cause enough for divorce without the perversely plentiful evidence of unfaithfulness.'"
divorcemoney"'If you mean that the divorce will be expensive, I know it,' she says. 'But I can think of no happier investment.'"
marriagemoney"'If you wish me to understand that it was a marriage for money, you could have spared your energy. That was patent from the outset.'"
infidelitymoney"'I'm sorry, but I don't see how having married for money excuses a subsequent infidelity.'"

If we had more than one character in the scenario, we could provide multiple tables, but this will do to demonstrate the idea.

Of course, we can override specific instances, if we want the character always to say the same thing regardless of how we came to this point:

Instead of asking Lady Uckfield about the subject penmanship:
   now the current subject is penmanship;
   say "She sighs. 'So few people write really beautifully these days.'"
 
Test me with "think / ask lady about infidelity / show nasty letter to lady / show note to lady / think / ask lady about divorce / ask lady about love / ask lady about marriage / ask lady about divorce / ask lady about love / ask lady about penmanship".

We would have to be careful about this system, since we have applied a various-to-various relation to every single object in the game. In practice it would probably be wisest to restrict it a bit, with judicious definitions of kind and so on.

wi 13.11 Indirect relations
rb 7.11 Character Knowledge and Reasoning

278. Questionable Revolutions ★★★

"Questionable Revolutions"

Interrogative is a kind of value. The interrogatives are who, what, when, where, how, and why.

Current question is an interrogative that varies.

After asking someone about something: respond to the question. After answering someone that something: respond to the question.

After telling someone about something: say "You're here to ask questions."

Country is a kind of value. The countries are Czechoslovakia, Georgia, Sweden, Italy, Spain.

Table of Information

topic	date	place	definition
"velvet revolution"	1989	Czechoslovakia	"A bloodless revolution in Czechoslovakia, in which popular protests led to the resignation of the communist president Gustav Husak, and the election of Vaclav Havel in his place."
"rose revolution"	2003	Georgia	"A revolution in which President Eduard Shevardnadze was interrupted by protesters in the middle of his speech, and forced to flee."
"spanish revolution"	1936	Spain	"An anarchist and socialist movement during the Spanish civil war."

After reading a command:

if the player's command includes "[interrogative]", now the current question is the interrogative understood.

To respond to the question:

repeat through the Table of Information:

if the topic understood includes topic entry:

if the current question is what or the current question is who, say definition entry appropriately;

if the current question is when, say date entry appropriately;

if the current question is where, say place entry appropriately;

rule succeeds;

say "[The noun] shrugs."

Understand "ask [someone] [text]" as asking it about.

Comprehension is a kind of value. The comprehensions are vague, erroneous, and correct.

Table of Understanding

character	years	geography	general comprehension
Dr Tweedy	correct	correct	correct
Ms Finch	erroneous	erroneous	correct
Ms Clarion	vague	vague	erroneous

When play begins:

say "Here you are in the first class cabin, but no matter how fancy the seats are, you can still get bored circling over Zurich for three hours on end. To kill time, you and the other passengers are playing a trivia game, and the final topic is your specialty: revolutions."

First Class Cabin is a room. Dr Tweedy is a man in First Class. Ms Finch and Ms Clarion are women in First Class.

To say (year - a number) appropriately:

choose row with character of the noun in the Table of Understanding;

if years entry is correct:

say "'[year],' replies [the noun] promptly.";

increment the quiz score of the noun;

if years entry is erroneous:

let guess be a random number between 1900 and 2005;

say "'[guess]?' guesses [the noun], with an air of diffidence[if guess is the year]. Which is right, as it happens[end if].";

if guess is the year, increment the quiz score of the noun;

if years entry is vague:

let offset be a random number between -5 and 5;

let year be year + offset;

say "'I think [year]. About then. Close, anyway,' replies [the noun][if the offset is 0], getting it right[end if].";

if offset is 0, increment the quiz score of the noun.

To say (spot - a country) appropriately:

choose row with character of the noun in the Table of Understanding;

if geography entry is correct:

say "'[spot],' replies [the noun] promptly.";

increment the quiz score of the noun;

if geography entry is erroneous:

let guess be a random country;

say "'Er... [guess]?' says [the noun][if guess is the spot]. Which is of course correct[end if].";

if guess is the spot, increment the quiz score of the noun;

if geography entry is vague, say "'Europe,' replies [the noun] with confidence."

To say (explanation - some text) appropriately:

choose row with character of the noun in the Table of Understanding;

if general comprehension entry is correct:

say "'[explanation]'[paragraph break]";

increment the quiz score of the noun;

otherwise:

choose a random row in the Table of Information;

say "'[definition entry]'[paragraph break]";

if the definition entry is explanation:

say "[A random other person who is not the noun] looks surprised that this came out right.";

increment the quiz score of the noun.

A person has a number called quiz score. The quiz score of Tweedy is 48. The quiz score of Finch is 2. The quiz score of Clarion is 4.

Definition: a person is other if it is not the player.

When play begins:

now left hand status line is "T: [quiz score of Tweedy] F: [quiz score of Finch] C: [quiz score of Clarion]";

now right hand status line is "[time of day]".

Test me with "dr tweedy, where was the velvet revolution located / ms finch, when was the rose revolution / ms finch, what was the rose revolution / ms clarion, when was the spanish revolution / g / g / ms finch, when was the spanish revolution".

We have so far seen several ways to write conversational characters in Inform, and we will see more before the end of the manual. This naturally raises the question, which should we use? To which the answer is: it depends on the sort of game we're writing, and what we want our characters to do. The more rich and complex the system, the more likely that it will require a lot of content; if we add question types as well as keywords, for instance, we instantly multiply the number of responses we have to write by five or six. It is not worth doing this unless there is some corresponding advantage within the game.

wi 16.13 Topic columns
rb 7.11 Character Knowledge and Reasoning

279. The Queen of Sheba ★★★

Suppose we want the player to ask questions of slightly more complexity - we might want to build in a system that understood "who", "what", "where", and "when", for instance. We could use a topic table for this, too:

"The Queen of Sheba"

Interrogative is a kind of value. The interrogatives are who, what, when, where, how, and why.

Current question is an interrogative that varies.

After asking someone about something: respond to the question. After answering someone that something: respond to the question.

After telling someone about something: say "You're here to ask questions and test Solomon's wisdom, not to give him a sample of your own."

Table of Wise Answers

topic	question type	reply
"rain/weather/clouds/cloud/rains"	what	"'Clouds are a disturbance made by the paths of birds,' Solomon replies. 'The air beaten by their wings becomes agitated, as when a river is stirred and the mud churns up.'"
"rain/weather/clouds/cloud/rains"	where	"'Weather is contained in a great silk bag which holds in the heavens,' replies Solomon."
"hunger/food/eating"	when	"'Sorry, are you getting hungry?' he says, and rings a bell to summon servants."
"hunger/food/eating"	why	"'Men were made to need food in order that they must farm and cook and dine together,' Solomon replies. 'Otherwise, they might live apart, each sufficient in himself. But no man can feed himself alone all through his life.'"
"Solomon/he/himself"	who	"'As you see,' he says, holding out his arms to each side."
"Solomon/he/himself"	what	"'I am an ordinary man,' he answers."

One of the nice things about this system is that it only resets the "current question" when we get a new question word. For instance, this test will produce different replies to the question about Solomon himself, because the second time he is still in the mode of answering "what" questions:

Test me with "ask solomon about himself / ask solomon what rain is / ask solomon about himself".

If Solomon is to live up to his reputation at all, his wisdom table will have to be quite a bit longer - though one also would want to be careful, because forcing the game to cycle through a really immense table could be quite time-consuming. In fact, for the sake of this example, let's reward the player for managing to stay within the (narrow) range of Solomon's knowledge:

The Hall of Almug Tree Pillars is a room. "The pillars of the room are made of almug tree, the ceiling made of silk and the floor of glass." Solomon is a man in the Hall of Almug Tree Pillars. Solomon has a number called wisdom. The wisdom of Solomon is 0.
 
Every turn:
   if the wisdom of Solomon is 3:
      say "Truly, Solomon has answered all your questions, and his wisdom is even as great as you had heard!";
      end the story saying "Your heart beats strangely fast".
 
When play begins, say "'Oh, you've arrived,' says Solomon."

In a real game we'd need to be a great deal subtler. All the same, if we have a character of quite limited resources to present to the player, it's a good idea to give the player some incentive to stay on topic, ask questions the character can answer, and generally interact within the parameters we're prepared for.

Now, this last bit requires some trickery from later chapters, particularly those on Understanding and Activities, to pull the question words out of the player's command:

After reading a command:
   if the player's command includes "[interrogative]", now the current question is the interrogative understood.
 
To respond to the question:
   repeat through the Table of Wise Answers:
      if the topic understood includes topic entry:
         if the current question is the question type entry:
            say "[reply entry][paragraph break]";
            increment the wisdom of Solomon;
            rule succeeds;
   say "Solomon looks blank, appalled by a question for which he was not prepared.";
   end the story saying "You have befuddled Solomon!"
 
Understand "ask [someone] [text]" as asking it about.

And now we have a game that will accept (though not always respond very sensibly to) questions of almost any form we might put to another character: ASK SOLOMON WHAT RAIN IS will be answered, but then again, it won't be distinguished from, say, ASK SOLOMON WHETHER THIS PERSISTENT RAIN IS A DIVINE PUNISHMENT OR WHAT.

All the same, a system that allowed the player a bit more specification of questions than simple keyword-use might be useful in a mystery game, for instance, where we might want to let our detective conduct inquiries into specific details. An alternative approach to the rather free one above would be to force the player to use only questions of the form WHAT IS RAIN? or WHO ARE YOU?: this would cut down on false-positive matches. But we might still choose to store the responses in a table of this type.

wi 16.13 Topic columns
rb 7.11 Character Knowledge and Reasoning

341. Chronic Hinting Syndrome ★★★★

Suppose we have a conversation system in which it is important to keep track of which subjects the player has heard mentioned. If we're careful to mark subjects in brackets, we can use the "printing the name of" activity to record which things have been mentioned so far:

"Chronic Hinting Syndrome"

A subject is a kind of thing.

Knowledge relates various people to various subjects. The verb to know means the knowledge relation.

Awareness relates various people to various subjects. The verb to be aware of means the awareness relation.

Definition: a subject is pending if the player is aware of it and it is not known by the player.

Instead of thinking:

if the number of pending subjects is 0, say "You have no fresh leads at the moment.";

otherwise say "You recall that thus far you have not followed up with questions about [the list of pending subjects]."

After printing the name of a subject (called idea):

now the player is aware of the idea.

Now suppose that as an added convenience for the player, we let him turn on a mode in which useful conversation topics are always automatically highlighted in the text, so he doesn't waste his time trying to follow up dead leads:

Setting is a kind of value. The settings are bright and dull. Understand "on" as bright. Understand "off" as dull.
 
Highlighting is a setting that varies. Highlighting is dull.
 
Understand "highlighting [setting]" as setting highlighting. Setting highlighting is an action out of world, applying to one setting.
 
Carry out setting highlighting:
   now highlighting is the setting understood.
 
Report setting highlighting:
   say "Highlighting is now [if highlighting is dull]off[otherwise]on[end if]."
 
Before printing the name of a subject (called idea) when highlighting is bright:
   unless the player knows the idea:
      say "[bold type]".
 
After printing the name of a subject when highlighting is bright:
   say "[roman type]".

…And the rest is peripheral.

The Sickbay is a room. "A place arranged for Nathan's comfort, since his sickness has been prolonged and because he becomes so irritating when not comfortable." The Hallway is outside from the Sickbay.
 
A supporter can be untried or rejected. A supporter is usually untried.
 
The Sickbay contains a wobbly pedestal, a table, and a sickbed. Understand "bed" as the sickbed. The pedestal, the table, and the sickbed are supporters. Nathan is a man on the sickbed. The sickbed is scenery. The initial appearance of the wobbly pedestal is "A wobbly pedestal near the door has sometimes been known to support vases of flowers, but is currently bare." The initial appearance of the table is "There is also a table of a more ordinary sort."
 
Nathan can be active or passive.
 
After printing the name of Nathan: now Nathan is passive.
 
Instead of putting the sculpture on the table:
   now the table is rejected;
   say "'[Not there],' [Nathan] snaps. 'The table is way too far from the sickbed.'"
 
Instead of putting the sculpture on the sickbed:
   now the sickbed is rejected;
   say "'[Not there],' [Nathan] rebukes you. 'You don't want me knocking it over if I roll around. In pain.'"
 
Instead of putting the sculpture on the pedestal:
   now the pedestal is rejected;
   say "The pedestal starts to wobble so ominously that you don't dare let go.
 
'[Not there],' says [Nathan]. 'That thing is falling apart.'"
 
Before putting something on the down: try dropping the noun instead.
 
To say not there:
   if all the supporters are rejected:
      say "Look, the floor would be fine";
   otherwise if the number of rejected supporters is 1:
      say "Yeah, anywhere but there, I'm afraid";
   otherwise:
      say "Come on, use your head -- I can't be watching you all the time, I'm sick".
 
Instead of going outside when the player is carrying the sculpture:
   say "You've still got this sculpture to get rid of."
 
Instead of going outside when the breakage is pending:
   say "You can't very well smash in front of [Nathan] his prize sculpture and then just scamper off without saying something. Appealing though the thought is at the moment."
 
Instead of going outside when a subject which is not the breakage is pending:
   say "'Yeah, go ahead,' says [Nathan], with a martyr-like air. 'It's probably best that you don't hear about [the random pending subject]. It's not something I'd go into normally.'"
 
The breakage is a subject. The description is "It's not a big deal. I'll just buy a new [mental wave generator].' A slight awkward pause. 'I mean, this one was a [gift], but don't worry about it". Understand "accident" or "smashing" or "breaking" or "shard" or "mishap" or "shards" or "mistake" as the breakage. Understand "sculpture" as the breakage when the player is not carrying the sculpture.
 
Instead of saying sorry in the presence of Nathan when the player is aware of the breakage:
   try asking Nathan about the matter of breakage.
 
Instead of asking Nathan to try saying sorry when the player is aware of the breakage:
   try asking Nathan about the matter of breakage.
 
The mental wave generator is a subject. The description is "They're kind of expensive but I can save up. I really need one, though, because of my [dreams]".
 
The dreams is a subject. The description is "They're not the kind of dream you want to have.' He closes his eyes and contemplates these undesirable dreams. 'Have you ever woken up convinced you were dead? No, probably not. Well... At any rate, I need the [generator]. Oh, don't worry, they're expensive but not so expensive that I won't be able to save up for another, in a few months".
 
The gift is a subject. The description is "[The mental wave generator] was a present from a girl named [Shari]. Actually I'm not sure she'd take to being called a girl".
 
Shari is a subject. The description is "Look, let's just not go into it, okay? I don't really want to relive all that right now. I still have a six-inch [scar] shaped like a banana in the middle of my back".
 
The scar is a subject.
 
Instead of asking Nathan about the matter of the scar:
   say "Nathan clears his throat, lowers his voice, and begins to tell you the story...";
   end the story saying "End of Demo -- Register to Continue!!"
 
Understand "ask [someone] about [any subject]" as asking it about the matter of.
 
Asking it about the matter of is an action applying to one thing and one visible thing.
 
Check asking it about the matter of:
   if the player is not aware of the second noun, say "What [second noun]?" instead;
   if the noun does not know the second noun, say "'I've no idea,' replies [the noun]." instead;
   if the player knows the second noun, say "You've already covered that. The response was '[description of the second noun].'" instead.
 
Carry out asking it about the matter of:
   now the player knows the second noun.
 
Report asking it about the matter of:
   say "'[description of the second noun],' says [the noun]."
 
Instead of telling Nathan about something:
   say "He pinches the bridge of his nose. 'I can't really follow this right now,' he says. 'I'm sorry.'"
 
Instead of asking Nathan about something:
   say "He shrugs weakly."
 
When play begins:
   say "'Just put that down anywhere,' says [Nathan], as you come into the room. He's sitting in the sickbed with his legs straight out in front of him. 'I don't care where.' His voice is weak, but it sharpens up for the last remark: 'And don't make a lot of noise about it.'
 
Considering that he woke you from a sound slumber to beg you to bring this thing over, his attitude is a bit much. You stare dubiously at the awkward crystal sculpture in your hands.";
   now Nathan knows every subject.
 
Instead of asking Nathan about something while the player carries the sculpture, say "[Nathan] moans dramatically and refuses to be drawn into conversation."
 
The player is carrying an awkward crystal sculpture. Understand "objet" or "objet de hideous" as the sculpture. The description of the sculpture is "It might possibly be natural, or it might be man-made. It might appeal to someone, but it is certainly not to your tastes."
 
Instead of showing the sculpture to Nathan:
   say "'Please put it anywhere,' he says."
 
Instead of giving the sculpture to Nathan:
   say "'No, it doesn't work if I touch it. That's why I couldn't-- well, just put it down.'"
 
After dropping the sculpture:
   now the player is aware of the breakage;
   now the sculpture is nowhere;
   say "You are incredibly careful, but somehow the sculpture slips -- you might almost say slithers -- from your fingers and crashes into a thousand shards at the feet of [Nathan].
 
There is a tense silence."
 
Before reading a command: now Nathan is active.
 
Every turn while not asking:
   if Nathan is passive, rule succeeds;
   if the player is carrying the sculpture:
      if showing or giving, rule succeeds;
      say "[Nathan] opens one eye and stares at you meaningfully. He is waiting for you to deposit his objet de hideous somewhere.";
      rule succeeds;
   if the breakage is pending:
      if dropping, rule succeeds;
      say "You're not quite sure where to begin, but you can't very well leave without making at least some remark on the smashing of the sculpture.";
      rule succeeds;
   if a subject is pending:
      choose a random row in the Table of Offhand Reminiscences;
      say "[line entry][paragraph break]".
 
Table of Offhand Reminiscences

line
"'It actually is kind of a funny story about [the random pending subject],' [Nathan] remarks casually."
"[Nathan] chuckles under his breath. 'Man, I hadn't thought about [the random pending subject] in ages.'"
"He glances sideways at you. 'It's nothing personal, you know, but I don't feel comfortable discussing [the random pending subject] with just anyone.'"
"'I don't know why I brought up [the random pending subject] just now,' [Nathan] comments. 'Don't mention it to anyone, if you don't mind.'"
"'Okay, see, the thing about [the random pending subject] is...'  [paragraph break]'Yes?' you ask, on cue.[paragraph break]'...never mind.'"
"[Nathan] makes an explosive exasperated sound. 'Don't you want to ask me about [the random pending subject]?' he demands."
 
Test me with "highlighting bright / put sculpture on pedestal / put it on table / put it on sickbed / drop it / think / ask nathan about breakage / think / ask him about generator / ask him about dreams / ask him about gift / ask him about shari / ask him about scar".

wi 18.10 Printing the name of something
rb 7.11 Character Knowledge and Reasoning

🔗

RB §7.12 Characters Following a Script

So far we've seen characters who will answer questions whenever the player feels like asking, and characters who will use some reasoning procedure to direct the conversation. There is a third option, often useful in IF with a fast-paced narrative: the character follows a conversational script, making sure to cover a series of points before the scene ends.

There are more and less tedious ways to implement this kind of scene. The worst case is one in which the player is not allowed to interrupt or ask any questions; he must merely wait until the character runs out of things to say. This can be useful and plausible in very small doses - say, two or three turns - but if the character has more information than that to impart, we may want to make the scene more interactive.

Pine 2 ★★★ partly addresses this challenge: the character has a line of conversation that she wants to follow to its conclusion; we may ask questions along the way, but if we're silent, she'll take up the slack, and the scene won't end until she's done with what she has to say.

Another kind of script is a series of actions for the character to perform. Robo ★ demonstrates a programmable robot that will observe what the player does, then try to emulate the actions later when switched into play-back mode. Robo 2 ★★★ extends this capacity to allow the robot to contain fifteen different scripts which the player can store, list, run, and erase.

Your Mother Doesn't Work Here ★ offers a character with a list of tasks but whose plans can be interrupted by more urgent demands. This verges on not being a simple script any more: if we carry the idea to its natural conclusion, we get characters capable of planning scripts for themselves to accomplish their aims. This is conventionally called "goal-seeking".

Examples

425. Robo 1 ★

"Robo"

The Experimentation Chamber is a room. Robo is a man in the Experimentation Chamber. "Robo, your prototype tin companion, stands awkwardly beside you. In the middle of his chest is a red enamel button[if the red button is switched on], currently depressed[otherwise], currently un-depressed[end if]."

The red button is a device. It is part of Robo. Instead of pushing the red button: if the red button is switched off, try switching on the red button; otherwise try switching off the red button.

After switching on the red button:

say "CLICK! Robo is now in play-back mode."

After switching off the red button:

say "CLACK! Robo is now in observation mode."

Definition: Robo is watching if the red button is switched off.

The current instruction set is a list of stored actions that varies.

After doing something when Robo is watching and Robo can see the player:

now the actor is Robo;

add the current action to the current instruction set;

now the actor is the player;

say "Robo watches you [the current action][one of], his yellow eyes lamp-like and observant[or]. In his metal head, gears whirr[or], his brushed-copper handlebar moustaches twitching[or] impassively[at random].";

continue the action.

Every turn when Robo is not watching:

if the number of entries in the current instruction set is 0:

say "Robo has run out of behavior and grinds to an (expectant) halt.";

now the red button is switched off;

otherwise:

let the next task be entry 1 of the current instruction set;

try the next task;

remove entry 1 from the current instruction set.

The red block and the blue cylinder are things in the Experimentation Chamber. The counter is a supporter in the Experimentation Chamber. The counter is scenery.

Report Robo examining Robo:

say "Robo examines each of his hands in turn, then each of his legs (bending over mostly double in the middle to do this)." instead.

Report Robo examining the player:

say "Robo stares at you, unblinkingly, for several seconds together[if a random chance of 1 in 7 succeeds]. His left moustache-bar twitches infinitesimally upward[end if]." instead.

Report Robo taking the cylinder:

say "[one of][Robo] needs several attempts to get his metal fingers around [the cylinder] -- they are not designed for grasping small objects elegantly. But at last he succeeds[or]Once again, Robo struggles a bit before picking up [the cylinder][stopping]." instead.

Test me with "z / take cylinder / take block / put cylinder on counter / put block on counter / x robo / x me / get block / drop block / press red button / z / z / z / z / z / z / z / z / z / z".

wi 21.5 Building lists
rb 7.12 Characters Following a Script

437. Your Mother Doesn't Work Here ★

Suppose the player's mother is supposed to be cleaning the living room, but she can be interrupted by the need to pick up things the player has dropped. New tasks are added to the end of her "current plan" list; every turn, she attempts to do whatever is the last entry on that list.

"Your Mother Doesn't Work Here"

A person has a list of stored actions called the current plan.

Every turn:

repeat with culprit running through people who are not the player:

if the number of entries in current plan of the culprit is greater than 0:

let N be the number of entries in the current plan of the culprit;

try entry N of the current plan of the culprit;

remove entry N from the current plan of the culprit.

The Living Room is a room. It contains a somewhat muddy Persian rug. Your mother is a woman in the Living Room.

West of the Living Room is the Kitchen.

Instead of your mother rubbing the rug:

say "Your mother scrubs the stained areas of the rug, muttering to herself."

Instead of taking something:

say "Nah, Mom'll get that."

Report your mother taking something:

say "Your mother picks up [the noun][one of], sighing deeply[or], jaw tight[or], with assorted comments on your manners[or]; to judge from her comments, she is also indulging in a pleasant fantasy about Swiss boarding schools[stopping]." instead.

When play begins:

add mother going west to the current plan of mother;

add mother rubbing the rug to the current plan of mother.

Every turn:

if mother is not in the Living Room, end the story finally.

Carry out dropping something:

add mother taking the noun to the current plan of mother.

The player carries some dirty socks, some dirty shoes, a dirty hat, a pair of dirty trousers, and a backpack.

Test me with "drop socks / z / drop shoes / drop hat / drop all / z / z".

As goal-seeking goes, this is fairly rudimentary; "Boston Cream" provides an alternative (and slightly more sophisticated approach), but for really complex goal-seeking characters, it is probably best to turn to the character extensions designed for Inform.

wi 21.11 Variations: arrays, logs, queues, stacks, sets, sieves and rings
rb 7.12 Characters Following a Script

161. Pine 2 ★★★

"Pine"

A person can be asleep or awake. A person can be active or passive.

The Spinning Tower is a room. "A remote corner of the old castle, reserved for spinning and weaving tasks."

Sleeping Beauty is an asleep woman in the Spinning Tower. "[if asleep]Sleeping Beauty lies here, oblivious to your presence[otherwise]Sleeping Beauty stands beside you, looking a little confused[end if]." The description is "She is even more magnificent than the rumors suggested." Understand "woman" or "girl" or "princess" or "lady" as Sleeping Beauty.

Discovery is a scene. Discovery begins when play begins. Discovery ends when Sleeping Beauty is awake. Marriage Proposal is a scene. Marriage Proposal begins when Discovery ends.

When Discovery ends: say "Throughout the palace you can hear the other sounds of stirring and movement as the spell of centuries is broken."

Instead of waking an awake person: say "Redundant."

Instead of waking an asleep person: say "Yes, but how?"

Instead of attacking an asleep person:

now the noun is awake;

say "[The noun] sits bolt upright. 'Hey! Ow!' So much for that true love's kiss nonsense."

Instead of kissing an asleep person:

now the noun is awake;

say "[The noun] slowly stirs to wakefulness!"

Instead of throwing water at an asleep person:

now the second noun is awake;

now the noun is nowhere;

say "You pour out [the noun] on [the second noun].

[The second noun] wakes, shuddering. 'Agh! I had a terrible dream about drowning and then-- Hey!'"

The player carries a jug of water. Understand "pour [something] on [something]" or "splash [something] at/on [something]" as throwing it at.

So much, we had before. Now, suppose we want a conversation style which allows the player to move conversation forward by asking appropriate questions, but which will keep moving forward even if he doesn't. To this end, we provide a table -- a borrowing from a later chapter. In the table, we record two ways of performing each conversation bit, one which reflects the player's participation, and one in which the character moves things onward:

Table of Conversation

topicreplyquip
"dream/dreams/nightmare/nightmares/sleep""'Sleep well?' you ask solicitously.

'Not really,' she replies, edging away from you. So much for that angle.""'Ghastly nightmares,' she remarks. You nod politely."
"marriage/love/wedding/boyfriend/beau/lover""'So,' you say. 'This is a little weird since we just met, but, um. Would you like to get married?'

She looks at you nervously. 'Do I have to?'""'I, er,' she says. 'I hope I'm not supposed to marry you or something.'"
"marriage/love/wedding/boyfriend/beau/lover""'I was told I was going to marry you and inherit the kingdom,' you say, apologetically. 'Would that be very bad?'

'Oh, it's not you -- I'm seeing someone,' she says, smiling quickly.

You try to think how to point out that it's been a hundred years since she last saw her boyfriend.""'Do you think I could go look for someone? I'm seeing him, you see, and I think I've been... sick... for a while, so he might be worried.'

You try to think how to point out that it's been a hundred years since she last saw her boyfriend."
"marriage/love/wedding/boyfriend/beau/lover""'You've been up here for a hundred years,' you say. An unpleasant thought occurs to you. 'Was your young man in the castle somewhere?'

She shakes her head mutely.""She goes to the window and looks out at the now-fading thicket of briar. 'That took a while to grow,' she observes. 'I've been up here longer than I thought.'

You shrug, uncomfortable."
 
Instead of asking an awake beauty about a topic listed in the Table of Conversation:
   now Beauty is passive;
   say "[reply entry][paragraph break]";
   blank out the whole row.

The "now Beauty is passive" line prevents her from making any conversation of her own on a turn when we've spoken to her. This keeps the conversation from progressing too quickly.

Instead of telling an awake beauty about something: try asking the noun about it.
 
Instead of asking an asleep person about something:
   say "[The noun] snores."
 
Marriage Proposal ends when the number of filled rows in the Table of Conversation is 0.
 
Every turn during Marriage Proposal:
   if Beauty is active:
      repeat through Table of Conversation:
         say "[quip entry][paragraph break]";
         blank out the whole row;
         make no decision.

After we've generated any spontaneous conversation, we return her to her regular active state.

Every turn: now Beauty is active.
 
When Marriage Proposal ends: end the story saying "This is going to take some explaining."
 
Test me with "x beauty / wake beauty / pour water on beauty / ask beauty about sleep / z / ask beauty about marriage".

Now we have a scenario in which the player can ask her some questions out of order if he really wants to, but the scene will not end until the basic conversation topics have been exhausted. If we wanted to add some other chit-chat, not as part of the main conversation strand, but by way of optional enrichment, we might make a second conversation table and record alternative outcomes in it.

wi 10.5 Linking scenes together
rb 7.12 Characters Following a Script

428. Robo 2 ★★★

We have seen how we can make a robot that watches the player, then plays back the same actions again. A slightly more adventurous implementation would be to let the player create a whole series of named scripts which the robot will run on command.

To do this, we'll need each program to have a command that sets it off (stored as text, since this is the best way to capture and preserve arbitrary text entered by the player) and then the script of actions that must result:

"Robo 2"

Chapter 1 - Programming

Section 1 - The Programs Themselves

The hard drive is a container. A program is a kind of thing. 15 programs are in hard drive. A program has some text called the starter command. A program has a list of stored actions called the script. Understand the starter command property as describing a program.

Rule for printing the name of a program (called the target) which is not blank:

say "[starter command of the target in upper case]".

Definition: a program is blank if the number of entries in its script is 0.

The current instruction name is some text that varies. The current instruction set is a list of stored actions that varies.

Now, we want to let Robo learn new programs; for this purpose, we'll emulate the code from our previous implementation, so that Robo watches what the player does and stores those actions in his script:

Section 2 - Learning New Programs
 
Understand "learn [text]" as learning. Learning is an action applying to one topic.
 
Check learning:
   say "You have already learned all you need to know. Robo, however, remains to be trained." instead.
 
Check Robo learning:
   if Robo is watching, say "Robo is already recording '[the current instruction name]'." instead.
 
Carry out Robo learning:
   truncate the current instruction set to 0 entries;
   now the current instruction name is the topic understood;
   now Robo is watching.
 
Report Robo learning:
   say "'Learning [the current instruction name in upper case],' Robo replies."
 
After doing something when Robo is watching and Robo can see the player:
   now the actor is Robo;
   add the current action to the current instruction set;
   now the actor is the player;
   say "Robo watches you [the current action][one of], his yellow eyes lamp-like and observant[or]. In his metal head, gears whirr[or], his brushed-copper handlebar moustaches twitching[or] impassively[at random].";
   continue the action.

Of course, we also need to be able to switch learning mode off, and store any script learned this way. We'll also use the same STOP command to make Robo terminate a program he's in the middle of running.

Section 3 - Returning to Standby Mode
 
Understand "stop" as stopping. Stopping is an action applying to nothing.
 
Check stopping:
   say "The command is useful only for Robo." instead.
 
Check Robo stopping:
   if Robo is standing by, stop the action.
 
Carry out Robo stopping when Robo is watching:
   let N be a random blank program;
   if N is a program:
      now the starter command of N is the current instruction name;
      now the script of N is the current instruction set;
      say "'Stored [current instruction name in upper case].'";
   otherwise:
      say "FAILURE: no program slots remaining."
 
Carry out Robo stopping:
   now Robo is standing by.
 
Report Robo stopping:
   say "Robo is now standing by."

Next, we need to be able to play these programs back again. We'll give Robo a "current program" to store which program he's currently working on, and a number called "stage" which will record where he is in the script. Our previous implementation simply had Robo erase entries from his script list as he performed them, but this time we would like Robo to be able to remember and rerun the same scripts over and over, so we need something a little more subtle.

Section 4 - Running Learned Programs
 
Understand "run [any program]" as running. Running is an action applying to one visible thing.
 
Check running:
   say "Only Robo can perform Robo's programs." instead.
 
Check Robo running:
   if Robo is not standing by, stop the action.
 
Unsuccessful attempt by Robo running:
   say "'ERROR: Robo can launch new programs only when on standby.'"
 
Carry out Robo running:
   now the current program of Robo is the noun;
   now the stage of Robo is 1;
   now Robo is replaying.
 
Report Robo running:
   say "'Running [the starter command in upper case],' Robo confirms."
 
Every turn when Robo is replaying:
   let the chosen script be the script of the current program of Robo;
   let maximum be the number of entries in the chosen script;
   let N be the stage of Robo;
   let the next step be entry N of the chosen script;
   try the next step;
   increment the stage of Robo;
   if the stage of Robo is greater than the maximum:
      say "Robo's program ends, and he reverts to stand-by mode.";
      now Robo is standing by;
      now the stage of Robo is 1.

For the player's sanity, we should also provide a way to find out which programs Robo has stored in memory and what they do, so we design two listing commands:

Section 5 - Listing Learned Programs
 
Understand "list programs" as requesting program list. Requesting program list is an action applying to nothing.
 
Check requesting program list:
   say "You will have to ask Robo to list programs." instead.
 
Carry out Robo requesting program list:
   say "'The available program[if more than one program is not blank]s[end if] [is-are list of programs which are not blank].'".
 
 
Understand "describe [any program]" or "list [any program]" as requesting script of. Requesting script of is an action applying to one visible thing.
 
Check requesting script of:
   say "You will have to ask Robo to give you the script." instead.
 
Carry out Robo requesting script of:
   say "The script of [noun] is: [script of the noun]."

And to complete the suite, in case the player runs into Robo's fifteen-program limit:

Section 6 - Deleting Learned Programs
 
Understand "delete [any program]" as deleting. Deleting is an action applying to one visible thing. Understand the command "erase" as "delete".
 
Check deleting:
   say "You will have to instruct Robo to delete [the noun]." instead.
 
Check Robo deleting (this is the can't delete except in standby rule):
   if Robo is not standing by, stop the action.
 
Unsuccessful attempt by Robo deleting:
   say "'ERROR: programs may only be deleted while Robo is in stand-by mode.'" instead.
 
Carry out Robo deleting:
   truncate the script of the noun to 0 entries;
   now the starter command of the noun is "".
 
Report Robo deleting:
   say "'Program deleted.'"

Now we use pretty much the same set-up as before to test Robo's abilities:

Chapter 2 - The Scenario
 
The Experimentation Chamber is a room.
 
Robo is a man in the Experimentation Chamber. "Robo, your prototype tin companion, stands awkwardly beside you[if watching], watching[end if]." Robo can be watching, replaying, or standing by. Robo is standing by. Robo has a program called the current program. Robo has a number called the stage.
 
Persuasion rule: persuasion succeeds.
 
The red block and the blue cylinder are things in the Experimentation Chamber. The counter is a supporter in the Experimentation Chamber. The counter is scenery.
 
Report Robo examining Robo:
   say "Robo examines each of his hands in turn, then each of his legs (bending over mostly double in the middle to do this)." instead.
 
Report Robo examining the player:
   say "Robo stares at you, unblinkingly, for several seconds together[if a random chance of 1 in 7 succeeds]. His left moustache-bar twitches infinitesimally upward[end if]." instead.
 
Report Robo taking the cylinder:
   say "[one of][Robo] needs several attempts to get his metal fingers around [the cylinder] -- they are not designed for grasping small objects elegantly. But at last he succeeds[or]Once again, Robo struggles a bit before picking up [the cylinder][stopping]." instead.
 
Test me with "test chocolate / test vanilla".
 
Test chocolate with "learn chocolate / stop / list programs / Robo, learn chocolate / take red / put all on counter / Robo, stop / Robo, list programs / Robo, run chocolate / z / Robo, run chocolate / Robo, stop / z".
 
Test vanilla with "Robo, learn vanilla / take all / i / drop all / x robo / x me / Robo, stop / Robo, list programs / Robo, list vanilla / Robo, run vanilla / z / z / robo, delete vanilla / robo, stop / robo, list vanilla / robo, delete vanilla / robo, list programs".

We could also have written this so that Robo learns new scripts by accepting the player's instructions, so that

>ROBO, LEARN LIBRARY THEFT
>ROBO, TAKE BOOK
>ROBO, EAST
>ROBO, STOP

…would store the script 'library theft' with the actions taking the book and going east. The implementation there would have been mostly identical, except that instead of an "after doing something…" rule, we would have captured commands as we asked Robo to perform them, and added those to the command list in progress. The alternative code might look something like this:

Before Robo doing something other than stopping when Robo is watching:
   add the current action to the current instruction set;
   say "'CHECK: [current action] added to script,' says Robo." instead.
 
Unsuccessful attempt by Robo doing something when Robo is watching:
   say "He does not actually perform the action."

wi 21.9 Accessing entries in a list
rb 7.12 Characters Following a Script

🔗

RB §7.13 Traveling Characters

There are a number of ways we can make characters navigate our map. We might reasonably want them to approach and follow the player (as in Van Helsing ★★); or to allow the player to follow characters who have left the room (as in Actaeon ★★).

Characters who are less interested in the player will more likely follow their own courses around the available geography, however. A character may move randomly from room to room, as demonstrated in Mistress of Animals ★; he may follow a path that we have specifically written in advance, as Odyssey ★★ shows; or, most elegantly, he may use the "best route" calculation to find the best possible way to a given target room, as seen in Latris Theon ★★★.

This final method is arguably the neatest solution to character movement, allowing for characters to act in sophisticated ways; if we incorporate the Locksmith extension, other characters will even unlock and open doors that are in their way. The chief catch is that it should not be used too profligately with large numbers of characters, since on slow machines the processing power required to plan all their travel will make a noticeable difference to the running speed of the story.

All the same, the constraints are not so severe as to preclude having a moderate number of route-finding characters all wandering around at once. This does introduce a new problem, however: movement descriptions can become hard to follow if every turn produces long reams of reports such as

Joe enters the room from the south.
Lawrence opens the gate.
Lawrence departs to the west.
Lucy comes in from above.
Ted enters the room from the south.
Bill departs to the west.

Patient Zero ★★★★ tackles this problem by calculating all of the character movement without printing any text; it then combines similar or related events into coherent paragraphs, as in

Rhoda and Antony walk into the Post Office. Rhoda could have been rolling in chocolate and Antony looks as though dipped in french vanilla.

Antony opens the iron gate. He goes through.

Examples

77. Mistress of Animals ★

Suppose we want a restless sort of character always pacing from room to room. It is quite easy to use adjacency to achieve this effect:

"Mistress of Animals"

Artemis is a woman in Thebes.

Every turn:

if Artemis is in a room (called the current space):

let next space be a random room which is adjacent to the current space;

if Artemis is visible, say "Artemis heads to [the next space].";

move Artemis to next space;

if Artemis is visible, say "Artemis arrives from [the current space]."

Test me with "z / z / z / z / z / z".

Of course, it helps that Artemis is the sort to like open spaces. The implementation would become more complicated if there were doors which might block transit between these locations.

wi 6.14 Adjacent rooms and routes through the map
rb 7.13 Traveling Characters

39. Van Helsing ★★

Suppose we want to write a character who tries to be in the same room as the player. We will do this by testing every turn whether the character's location and the player's location are the same; if the answer is no, the character will look for a path to the player's location, then try to move along that path. (We will learn more about finding paths and giving characters instructions later.)

The result will be that if the player ever moves to another location, the character will automatically pursue him.

"Van Helsing"

The Drawbridge is a room. North of the Drawbridge is the Immensely Enormous Entry Hall. West of the Entry Hall is the Vast Dining Area. North of the Vast Dining Area is the Colossal Kitchen. The Spooky Guano-filled Attic is above the Entry Hall.

Count Dracula is a man in the Attic.

In the following condition, we could also have written "if the location of Count Dracula is not the location", because "location" by itself is always understood to be the player's location. But it seemed better for clarity to write it this way:

Every turn:
   if the location of Count Dracula is not the location of the player:
      let the way be the best route from the location of Count Dracula to the location of the player, using doors;
      try Count Dracula going the way;
   otherwise:
      say "'Muhahaha,' says Count Dracula."
 
Test me with "z / z / n / w / e / u / z / d".

wi 3.25 The location of something
rb 7.13 Traveling Characters

274. Odyssey ★★

"Odyssey"

Athena is a woman in Athens.

Athena will proceed, unless delayed, through a list of locations stored in a simple table. Rather than using Inform's route-finding abilities ("the best route from…"), we simply move Athena from one location to the next, not even using the going action: she moves in mysterious ways, as befits a goddess.

Table of Athena's Movement

destination
Thebes
Delphi
Thebes
Athens
Corinth
Mycenae
 
Every turn when Athena is active:
   repeat through the Table of Athena's Movement:
      let last space be the location of Athena;
      if Athena can be seen by the player, say "Athena heads to [the destination entry].";
      move Athena to destination entry;
      if Athena can be seen by the player, say "Athena arrives from [the last space].";
      blank out the whole row;
      break.

By blanking out the table line by line, we make sure that we never lose our place in the path.

Since we want the player to be able to talk to Athena, we need a way to stall her in her path, as well.

Athena can be active or passive. Athena is active.
 
Before doing something to Athena:
   now Athena is passive;
   say "Athena waits around patiently, though you can tell she would like to leave..."
 
Instead of telling Athena about something:
   say "She watches you patiently as though to say that she already knows."
 
Instead of asking Athena about something:
   say "Her response is inscrutably ancient and Greek. Afterwards you remember only the flash of bright eyes."

Finally, we do need to wake Athena up again if she has become passive. The following rule will occur after the movement rule just because of code ordering, though we could make matters more explicit if we needed to:

Every turn when Athena is passive:
   now Athena is active.
 
Test me with "east / northwest / wait / examine athena / wait".

wi 16.10 Adding and removing rows
rb 7.13 Traveling Characters

302. Actaeon ★★

Suppose we want the player to be able to go after characters who are moving around the map. The trick, of course, is that once characters are gone they are no longer visible to "follow [person]", so we need "follow [any person]" to find them.

"Actaeon"

A person has a room called last location.

Understand "follow [any person]" as following. Understand the commands "chase" and "pursue" as "follow".

Following is an action applying to one visible thing.

Check following:

if the noun is the player, say "Wherever you go, there you are." instead;

if the noun is visible, say "[The noun] is right here." instead;

if the last location of the noun is not the location, say "It's not clear where [the noun] has gone." instead.

Here again the best route comes in handy:

Carry out following:
   let the destination be the location of the noun;
   if the destination is not a room, say "[The noun] isn't anywhere you can follow." instead;
   let aim be the best route from the location to the destination;
   say "(heading [aim])[line break]";
   try going aim.
 
Corinth is a room. Athens is east of Corinth. Epidaurus is southeast of Corinth and east of Mycenae. Mycenae is south of Corinth. Olympia is west of Mycenae. Argos is south of Mycenae. Thebes is northwest of Athens. Pylos is south of Olympia. Sparta is east of Pylos and south of Argos. Delphi is northwest of Thebes.
 
Artemis is a woman in Corinth.

We do also have to make sure that whenever we move a person from room to room, we record where they were moved from; otherwise, our clever restrictions about whom the player can pursue will not work properly.

To move (pawn - a person) tidily to (target - a room):
   now the last location of the pawn is the holder of the pawn;
   move the pawn to the target.
 
Every turn:
   let current location be the location of Artemis;
   let next location be a random room which is adjacent to the current location;
   if Artemis is visible, say "Artemis heads to [the next location].";
   move Artemis tidily to next location;
   if Artemis is visible, say "Artemis arrives from [the current location]."
 
Test me with "wait / follow artemis / follow artemis / follow artemis".

wi 17.7 Understanding any, understanding rooms
rb 7.13 Traveling Characters

185. Latris Theon ★★★

To begin with, we create an action for going to a named place. All that this action will do is to change that person's hoped-for destination: the actual moving around comes later.

"Latris Theon"

A person has a room called destination.

Understand "go to [any room]" as going vaguely.

Going vaguely is an action applying to one visible thing.

Carry out someone going vaguely:

now the destination of the person asked is the noun.

Report someone going vaguely:

say "[The person asked] looks amused, but accepts the commission to go to [the noun]."

It stands to reason the player plays Zeus or at the very least Apollo, but let's not let this go to the player's head. Note that the following rule applies to the player, but not to anyone else, so HERMES, GO TO ATHENS will work but GO TO ATHENS will not.

Carry out going vaguely:
   say "You're too thoroughly lost."

And finally we recreate Greece and one of its heroes.

Corinth is a room. Athens is east of Corinth. Epidaurus is southeast of Corinth and east of Mycenae. Mycenae is south of Corinth. Olympia is west of Mycenae. Argos is south of Mycenae. Thebes is northwest of Athens. Pylos is south of Olympia. Sparta is east of Pylos and south of Argos. Delphi is northwest of Thebes.
 
Hermes is a man in Corinth. The destination of Hermes is Corinth. [So he is initially happy where he is.] Persuasion rule for asking Hermes to try going vaguely: persuasion succeeds. [But he is open to suggestions.]
 
Every turn when the destination of Hermes is not the location of Hermes:
   let the right direction be the best route from the location of Hermes to the destination of Hermes;
   try Hermes going the right direction.
 
Test me with "hermes, go to athens / e".

It simplifies matters that our map of Greece makes it possible to reach any location from any other location, by some sequence of movements: if there were an isolated location -- say, Crete -- with no map connection to the mainland, then we would have to worry about the "right direction" not being a direction at all. The following version of Hermes' trekking rule is protected against the possibility:

Every turn when the destination of Hermes is not the location of Hermes:
   let the right direction be the best route from the location of Hermes to the destination of Hermes;
   if the right direction is a direction, try Hermes going the right direction.

wi 12.3 Giving instructions to other people
rb 7.13 Traveling Characters

401. Patient Zero ★★★★

"Patient Zero"

Use the serial comma and no scoring.

Understand "about" as asking for information. Asking for information is an action out of world.

Carry out asking for information: say "An implementation of the following creative brief:

People wander around some small map, on errands. One, sad to tell, has Gelato's Syndrome, a tragic condition turning one's skin the colour of a random flavour of ice cream (raspberry ripple, neapolitan, etc.). When two people are in the same room, there's a 1/3 chance that an infected person will infect a non-infected one. The player can cure any single person: victory condition - to stamp out the disease."

When play begins:

say "Gelato's Syndrome. It's struck, and it's struck hard. In these sticky summer months, there's no telling who will contract the disease next.";

now the command prompt is "[if the destination of the player is not blank](heading to [destination of the player]) [end if]>".

Section 1 - Errands

The current actor is a person which varies. The current owner is a person which varies.

Every turn:

if player is active, follow the character movement rules.

Every turn:

now the last person named is the player;

now the last thing named is the player;

now every person is active.

A person can be active or passive. The player is passive.

The character movement rules are a rulebook.

The first character movement rule:

now group size is 1;

now the last person named is the player;

now the last thing named is the player;

now the player is passive.

A character movement rule:

repeat with mover running through innocent people:

now the current actor is the mover;

follow the shopper rules;

now the current actor is passive;

follow the movement reporting rule.

A character movement rule:

repeat with next mover running through mercantile people:

now the current owner is the next mover;

follow the shopowner rules;

now the current owner is passive;

follow the infection rule.

To decide whether movement has not yet occurred:

if the player is passive, no;

yes.

Definition: a person is mercantile if it owns a room. Definition: a person is innocent if it is not mercantile and it is not the player.

The shopowner rules is a rulebook.

A shopowner rule:

let the shop be a random room owned by the current owner;

if the shop is air-conditioned and an open door (called the escape) protects the shop, try the current owner closing the escape instead.

Report someone closing a door when the person asked owns the location:

say "[The person asked], muttering darkly about air-conditioning and electricity, closes [the noun]." instead.

Report Vanessa closing the metal door when the metal door is visible:

if Vanessa is visible, say "Vanessa watches serenely as the metal door slides automatically back in place, sealing Cold Comfort." instead;

otherwise say "The metal door slides heavily back into place." instead.

A shopowner rule:

if the location of the current owner encloses a submitted artwork (called the target):

try the current owner filing the target.

Filing is an action applying to one thing.

Before someone filing something which is not carried by the person asked:

try the person asked taking the noun instead.

Carry out someone filing:

if the person asked does not carry the noun and the person asked is visible, say "[The person asked] tries unsuccessfully to get [the noun]." instead;

now the noun is nowhere.

Report someone filing:

say "[The person asked] registers [the noun] and files it away."

The shopper rules is a rulebook.

A shopper rule:

if the current actor carries something (called the problem), try the current actor resolving the problem instead.

A shopper rule:

if the current actor is not in the pool hall and the air conditioner is switched on:

try the current actor approaching the pool hall;

otherwise:

let way be a random direction;

try the current actor going the way.

Definition: a room is air-conditioned:

if it is outdoors, no;

if it is the Pool Hall and the air conditioner is switched off, no;

if it is protected by a door, yes;

no.

Protection relates a door (called X) to a room (called Y) when the front side of X is Y or the back side of X is Y. The verb to protect means the protection relation.

Ownership relates one person to various rooms. The verb to own means the ownership relation.

Resolving is an action applying to one thing.

An artwork is a kind of thing. Before printing the name of an artwork, say italic type. After printing the name of an artwork, say roman type. An artwork can be submitted or reserved.

A book is a kind of artwork.

Before someone resolving a book when the person asked is not in the Public Library:

try the person asked approaching the Public Library instead.

Carry out someone resolving a book:

move the noun to the Public Library;

now the noun is submitted.

Report someone resolving a book:

say "[The person asked] turns in [the noun]."

Before listing contents: group books together.

Before grouping together books: say "books entitled ".

A stamped envelope is a kind of thing.

Before someone resolving a stamped envelope when the person asked is not in the Post Office:

try the person asked approaching the Post Office instead.

Carry out someone resolving a stamped envelope:

now the noun is nowhere.

Report someone resolving a stamped envelope:

say "[The person asked] slips [a noun] into the outgoing mail slot."

Instead of someone resolving a stamped envelope when the person asked carries at least two stamped envelopes:

if the person asked is visible, say "[The person asked] shoves into the mail slot [a list of stamped envelopes carried by the person asked].";

repeat with item running through stamped envelopes carried by the person asked:

now the item is nowhere.

A DVD is a kind of artwork.

Before someone resolving a DVD when the person asked is not in the Rental Store:

try the person asked approaching the Rental Store instead.

Carry out someone resolving a DVD:

now the noun is submitted;

move the noun to the Movie Rental Store.

Report someone resolving a DVD:

say "[The person asked] returns [the noun]."

Instead of someone resolving a DVD when the person asked carries at least two DVDs:

if the person asked is visible, say "[The person asked] turns in [a list of DVDs carried by the person asked].";

now every DVD carried by the person asked is submitted;

now every DVD carried by the person asked is in the location of the person asked.

Before listing contents: group DVDs together.

Before grouping together DVDs: say "DVDs of ".

Approaching is an action applying to one thing.

Carry out someone approaching:

let the way be the best route from the location of the person asked to the noun, using doors;

if the way is a direction, try the person asked going the way;

otherwise stop the action.

A coupon is a kind of thing.

Carry out someone resolving a coupon:

try the person asked giving the noun to Vanessa.

The block giving rule is not listed in any rulebook.

Check giving something to someone (this is the block player giving rule):

abide by the block giving rule.

Before someone resolving a coupon when the person asked is not in Cold Comfort:

try the person asked approaching Cold Comfort instead.

After someone giving a coupon to Vanessa:

let the reward be a random ice cream cone;

let the new flavor be a random infection color;

now the infection color of the reward is the new flavor;

move the reward to the person asked;

now the noun is nowhere;

if Vanessa is visible, say "[The person asked] trades in [the noun] and receives [a reward] from Vanessa."

Infection color is a kind of value. The infection colors are french vanilla, whole-bean vanilla, mint, chocolate, dark chocolate, chocolate chip, chocolate fudge, mint chocolate chip, chocolate chocolate chip, triple chocolate, white chocolate, white chocolate chip, aztec cocoa-chili, raspberry ripple, neapolitan, rum raisin, dulce de leche, strawberry chunk, rocky road, blackberry sorbet, lemon sherbet, lime ice, caramel swirl, mango, saffron silk, and cookie dough cream.

To say list of flavors:

let current color be french vanilla;

while current color is not cookie dough cream:

say "[current color], ";

now current color is the infection color after the current color;

say "and [current color]".

Understand "ask vanessa for [flavored ice cream]" as buying the flavor. Understand "buy [flavored ice cream]" as buying the flavor.

Buying the flavor is an action applying to one infection color.

Check buying the flavor:

unless the player can see Vanessa:

say "It would help if you were in the presence of an ice cream salesperson." instead.

Carry out buying the flavor: say "'Do you have a coupon?' Vanessa demands. You admit you do not. 'No [infection color understood] for you!'"

Understand "ice cream" or "cream" or "ice" or "sherbet" or "sorbet" as "[ice cream]".

Understand "[infection color]" or "[infection color] [ice cream]" as "[flavored ice cream]".

An ice cream cone is a kind of thing. An ice cream cone is always edible. An ice cream cone has an infection color. An ice cream cone can be half-eaten or fresh. Understand the infection color property as referring to an ice cream cone.

Carry out someone resolving an ice cream cone:

try the person asked eating the noun instead.

Instead of someone eating a fresh ice cream cone:

now the noun is half-eaten;

if the person asked is visible, say "[The person asked] licks [the noun]."

Report someone eating an ice cream cone:

say "[The person asked] pops the end of [the noun] into [if the person asked is female]her[otherwise]his[end if] mouth and swallows." instead.

Before printing the name of an ice cream cone:

say "[if half-eaten]half-eaten [end if][infection color] ".

Section 2 - Infection Rules

This is the infection rule:

if an infected person (called typhoid mary) can see a clean person (called random bystander) and a random chance of 1 in 3 succeeds:

try typhoid mary sneezing on the random bystander.

A person can be infected or clean. A person has an infection color.

Every turn:

if the player is infected, say "You feel itchy."

Definition: a person is other if it is not the player. Definition: a person is another if it is other.

When play begins: now right hand status line is "Sick: [number of infected people]/[number of people]".

Every turn:

if every person is infected, end the story saying "Everyone succumbs";

if every person is clean, end the story finally saying "The Syndrome is eradicated".

Understand "sneeze on [something]" as sneezing on. Sneezing on is an action applying to one thing.

Check sneezing on:

if the player is clean, say "You're not sickly." instead;

if the noun is the player, say "Ew." instead;

if the noun is not a person, say "[The noun] cannot be infected." instead.

Carry out sneezing on:

now the noun is infected;

now the infection color of the noun is a random infection color.

Carry out someone sneezing on:

now the noun is infected;

now the infection color of the noun is a random infection color.

Report sneezing on:

say "Unable to control yourself, you sneeze on [noun].".

Report someone sneezing on:

say "[The person asked] sneezes on [if the noun is the player]you[otherwise][noun][end if]!".

Understand "inject [someone] with [something]" as injecting it with. Understand "inject [someone] with [syringe]" as injecting it with. Understand "use [syringe] on [someone]" as injecting it with. Understand the commands "innoculate" and "vaccinate" as "inject".

Injecting it with is an action applying to two things.

Check injecting it with:

if the second noun is not the syringe, say "[The second noun] cannot inject anything." instead;

if the noun is clean:

if the noun is the player, say "You're not infected yet." instead;

say "[The noun] is not infected, and the syringe contains a cure, not a vaccine." instead.

Carry out injecting it with: now the noun is clean.

After injecting the player with something: say "You inject yourself, wincing at the sting. But the itching fades almost at once."

Report injecting it with: say "You inject [the noun], who is now cured (but could easily be reinfected)."

Section 3 - Geography

Include Locksmith by Emily Short.

Understand "go to/toward/into [any room]" as going toward. Understand "enter [any room]" as going toward.

A person has a room called the destination.

Going toward is an action applying to one thing.

Check going toward:

if the noun is the location, say "You're already in [the location]." instead.

Carry out going toward:

now the destination of the player is the noun;

let heading be the best route from the location to the noun, using even locked doors;

if heading is not a direction, say "You can't think how to get there from here." instead;

try going heading;

if the location is the destination of the player, now the destination of the player is blank.

Instead of waiting when the destination of the player is not blank:

if the destination of the player is the location:

now the destination of the player is blank;

otherwise:

try going toward destination of the player;

if the location is the destination of the player, now the destination of the player is blank.

Understand "stop" or "cease" as stopping. Stopping is an action applying to nothing. Carry out stopping: now the destination of the player is blank. Report stopping: say "You stop in your tracks."

After going to an air-conditioned room:

say "You step into the mercifully air-conditioned surroundings of...";

continue the action.

After going from an air-conditioned room:

say "You emerge from the air-conditioning into heat like a wall...";

continue the action.

Instead of listening to an air-conditioned room:

say "The air-conditioning hums softly."

The Alfred Cralle Pool Hall is a room. "The town's most popular gathering-place, the pool hall is decorated in honor of the inventor of the ice cream scoop." The air conditioner is a device in the Pool Hall. "[if switched off]An air conditioner sits in the corner, unhappily inert[otherwise]The air conditioner hums briskly[end if]."

The felt door is west of the Pool Hall. The felt door is a door. The felt door is open. The felt door is lockable and unlocked. The key to the city unlocks the felt door. The description of the felt door is "It has a prominent lock, designed for an old-fashioned key."

After locking a door with something in the presence of an other person (called audience):

say "[The audience] looks a little non-plussed when you lock [the noun], but shrugs."

Nancy Johnson Memorial Square is west of the felt door. The description of Nancy Johnson Memorial Square is "Waves of August heat rise from the pavement: more than once you've had the fancy that your shoes are simply going to stick. At the center of the square, rubbed to a brownish polish by many adoring hands, is the statue of Mrs. Nancy Johnson of New Jersey."

The statue is scenery in Memorial Square. Understand "nancy" or "johnson" or "mrs" as the statue. The description of the statue is "Mrs. Johnson is pictured with a hand-cranked ice cream freezer tucked under one arm. Her other hand grips an ice cream scoop, ready to serve frozen dessert to the huddled masses." A hand-cranked ice cream freezer is part of the statue. The description is "The hand-cranked ice cream freezer was Mrs. Johnson's invention in 1846, though it was William Young who had the sense to patent the thing in 1848." The scoop is part of the statue. The description of the scoop is "An anachronism: Alfred Cralle would not invent the tool until 1897."

The Post Office is northwest of Nancy Johnson Memorial Square. "Service at the post office is on the slow side since everything went automated." The slot is scenery in the post office. The slot is a container. Carry out inserting something into the slot: now the noun is nowhere. Report inserting something into the slot: say "[The noun] falls out of sight, and you know you will never see it again."

Hamwi Street is northeast of an iron gate. "A U-shaped street running from Main Street around to the Memorial Square, Hamwi Street was recently added by ambitious city planners. The small and straggly line of trees has yet to grow enough to provide perceptible shade, so the street is even hotter and more unforgiving than the other parts of town."

The iron gate is northeast of Nancy Johnson Memorial Square. The iron gate is a door. It is lockable and unlocked.

Before printing the name of the iron gate while not opening or closing or locking or unlocking:

if the person asked is the player:

if the gate is open, say "open ";

otherwise if the gate is locked:

say "locked ";

otherwise if the gate is closed:

say "closed ".

Cold Comfort Ice Cream is north of a metal door. The metal door is north of Hamwi Street. A poster is fixed in place in Cold Comfort. "A poster fills one wall with the blazing promise of treats to come." The description of the poster is "Coming soon! Thai ice creams! Durian, jackfruit, taro, and coconut flavors!"

The metal door is a door. "A frosty metallic door separates [the location] from [the other side of the metal door]." The metal door is lockable and unlocked. The key to the city unlocks the metal door.

Marciony Street is southeast of Nancy Johnson Memorial Square. "A semi-circular terrace, named somewhat fancifully after one claimant to the invention of the ice cream cone -- though Hamwi Street competes for the same honor. There are wedges of cool shadow here and there thanks to the buildings, but for the most part the southern exposure keeps Marciony unpleasantly hot."

The Movie Rental Store is west of a glass door. The glass door is a door. It is west of Marciony Street. The glass door is lockable and unlocked. The key to the city unlocks the glass door.

Main Street is southeast of Hamwi Street. Main Street is northeast of some bronze gates.

The emergency box is in Main Street. The emergency box is fixed in place. "A fire-red box with a glass front faces the sidewalk, with 'In case of emergency, BREAK GLASS' lettered on it." The emergency box is closed and transparent. Understand "glass" as the box. Instead of attacking the closed emergency box: say "You hit the emergency box, which shatters open."; now the emergency box is open. Instead of attacking the open emergency box: say "The glass has already been thoroughly broken."

The syringe is in the emergency box. The description of the syringe is "It contains the cure for Gelato's Syndrome. You can inject anyone you like with it."

The bronze gates are northeast of Marciony Street. The bronze gates are a door. The bronze gates are lockable and unlocked. The description of the bronze gates is "Erected during the milk-taint revolution of 1937, they were designed to keep Main Street safe from the depredations of dairy-starved rioters."

The Public Library is east of Main Street. "Built in the 1920s during the height of the dairy boom, the public library has lush pink velvet seats, marble walls the color of fresh cream, and a motif of cherries carved around every doorframe. An incongruous sign hangs from the ceiling." The incongruous sign is scenery in the Public Library. The description of the incongruous sign is "Eating and drinking in the library is STRICTLY PROHIBITED."

Town Hall is southeast of Main Street. "Town Hall was built during the slow days of the ice-cream bust, and therefore it is as joyless and utilitarian as the Public Library is ridiculous. Unwilling to be reminded of their pain, the inhabitants steered clear of any decoration that might remotely be construed to resemble a scoop of anything: so there are no curves, only disciplined right angles." The key to the city is in Town Hall. It unlocks the iron gate. It unlocks the bronze gates. The description of the key to the city is "A skeleton key."

A room can be indoors or outdoors. The Post Office, the Alfred Cralle Pool Hall, the Store, Cold Comfort, Town Hall, and the Library are indoors.

Use full-length room descriptions.

After looking in an outdoors room:

let started printing be false;

now every proximate door is not mentioned;

if an indoors room is adjacent:

let started printing be true;

say "From here you can head into [the list of adjacent indoors rooms][if a proximate door is not mentioned], or go through [the list of proximate doors which are not mentioned][end if]. [run paragraph on]";

if an outdoors room is adjacent:

say "You could[if started printing is true] also[end if] go ";

let count be the number of adjacent outdoors rooms;

let index be count;

repeat with next room running through adjacent outdoors rooms:

let way be the best route from the location to the next room;

say "[way] to [the next room]";

decrement index;

make delimiter index of count, continuing;

if a proximate door is not mentioned:

let started printing be true;

say "[if started printing is true]Also available[otherwise]Your available exits[end if] [is-are the list of proximate doors which are not mentioned].";

otherwise:

if started printing is true, say paragraph break.

Definition: a door is proximate:

if the front side of it is the location, yes;

if the back side of it is the location, yes;

no.

Before exiting when the player is in an indoors room:

if the player can see a door (called nearest exit), try entering the nearest exit instead;

repeat with way running through directions:

let next room be the room way from the location;

if the next room is a room, try going way instead.

Blank is a room. The destination of the player is Blank. Blank contains 15 ice cream cones.

Section 4 - Other Players

Vanessa is a woman in Cold Comfort. Vanessa owns Cold Comfort.

Francine is a woman in the Public Library. Francine carries a book called Phlox for Phyllis. Francine carries a stamped envelope called a pink stamped envelope.

Lewis is a man in the Alfred Cralle Pool Hall. Lewis carries 3 stamped envelopes. Lewis carries a book called Idiot's Guide to Dating. Lewis carries a book called How to Meet Women. Lewis carries a book called Seduction in Three Easy Steps. Lewis carries a DVD called Sleepless in Seattle.

Gene is a man in Nancy Johnson Memorial Square. Gene carries a stamped envelope. Gene carries a DVD called Casablanca. Gene carries a coupon.

Rhoda is a woman in Marciony Street. Rhoda carries a book called The Marciony Street Murders. Rhoda carries a DVD called Unsolved Serial Killings XVIII. Rhoda carries a stamped envelope called a squashy package.

Martin is a man in Main Street. Martin carries a DVD called The Lifecycle of the South Sea Tortoise. Martin carries a coupon.

Antony is a man in Movie Rental. Antony carries a coupon. Antony carries a stamped envelope called a postcard.

Shelby is a man in the Town Hall. Shelby carries a DVD called Conducting An Orderly Meeting. Shelby carries 5 stamped envelopes. Shelby carries an ice cream cone. Shelby carries a coupon.

Christopher is a man in the Library. Christopher owns the Library.

Linnea is a woman in the Alfred Cralle Pool Hall. Linnea owns the Alfred Cralle Pool Hall.

Ned is a man in the Movie Rental Store. Ned owns the Movie Rental.

After printing the name of someone (called target) while listing contents: if the target owns the location of the target, say " (the owner)".

The description of a person is usually "[The noun] [if the noun is clean]looks healthy[otherwise]is the color of [infection color of the noun][end if]."

After examining another person who is carrying something: say "[if the noun is female]She[otherwise]He[end if] is carrying [a list of things carried by the noun]."

When play begins: let Patient Zero be a random other person; now patient zero is infected.

This is a light variation of a previous example, but we use it here because it is convenient:

Section 5 - Conversation
 
A person has a table name called conversation.
 
Instead of asking someone about something:
   let the source be the conversation of the noun;
   if topic understood is a topic listed in source:
      if there is a turn stamp entry:
         say "You have already heard that [summary entry].";
      otherwise:
         now turn stamp entry is the turn count;
         now the character entry is the noun;
         say "[reply entry][paragraph break]";
   otherwise:
      say "[The noun] stares at you blankly.".
 
Instead of telling someone about something:
   try asking the noun about it.
 
Understand "recap" or "recall" or "review" as recalling conversations.
 
Recalling conversations is an action applying to nothing.
 
Carry out recalling conversations:
   repeat with speaker running through other people:
      let source be the conversation of the speaker;
      sort source in turn stamp order;
      say "[The speaker] has so far told you: [line break]";
      let index be 0;
      repeat through source:
         if there is a turn stamp entry and the speaker is character entry:
            let index be 1;
            say "  [summary entry][line break]";
      if index is 0, say "  absolutely nothing[line break]";
      say line break.
 
The conversation of a person is usually Table of General ChitChat.
 
Table of General ChitChat

topicreplysummaryturn stampcharacter
"weather/heat/warmth""'It's appalling, isn't it? You'd think we didn't pay our taxes.'""that the weather is appalling"a numbera person
"sun/sunlight""'Good thing the town mostly switched to solar power, har, har.'""that the town is mostly relying on solar power"  
"rain""'Nope, there isn't going to be rain for 132 days,' replies [the noun].""that rain is not expected for another 132 days"  
"snow/hail/ice""This hilarious sally is greeted with hoots of laughter only.""that the concept of snow is downright laughable"  
"disease/sickness/illness/syndrome""You get a cold, fixed stare in response. 'That's not funny,' [the noun] replies finally.""that discussing the disease is more or less taboo"  
"cold comfort""'If you haven't tried it, you should,' says [the noun]. 'Best ice cream in town, and that's saying something, you bet.'""that Cold Comfort has the best ice cream in town"  
"town/city/village""'Yeah, it's a mite odd,' allows [the noun]. 'Not to everyone's taste, like...' [the noun as pronoun] considers for a moment. 'Like ginger ice cream. Big pieces of crystallized ginger... not everyone likes that.'""that the town is a mite odd"  
"forecast/weatherman" or "weather forecast/man""'Oh, the weather man's gotten a lot more reliable since the gummint started making it for us,' says [the noun]. 'Now he just reads off the schedule on the air every morning. Pretty much takes the fun right out of the news, if you ask me.'""that the weather is all generated by schedule"  
"taxes/tax" or "weather tax""A snort. 'You'd think for the rates we pay we'd get something a little pleasanter, don't you?'""that the weather tax really ought to be paying for something nicer than what you get"  
"job/employment/work""'[if the noun owns a room (called the shop)]I own [the shop],' replies [the noun][otherwise]Work at the creamery, like most folk around here,' answers [the noun].""this and that about employment in town"  
"book/books/reading""'The Public Library has a good selection, excepting only the cookbook section,' says [the noun]. 'That got censored way back when-- well, way back.'""that the Public Library has a good collection, except for the cookbook section"  
 
The conversation of Vanessa is the Table of Vanessa Chatter.
 
Table of Vanessa Chatter

topicreplysummaryturn stampcharacter
"ice cream" or "sorbet/sherbet/flavor/flavors/flavour/flavours/ice/ices""'The flavors are [list of flavors],' she responds promptly, without needing to draw breath.""that the flavors are [list of flavors]"a numbera person
 
After reading a command:
   while player's command includes "the":
      cut the matched text.

This strips 'the' out of the command, so that ASK PERSON ABOUT THE RAIN will be understood as well as ASK PERSON ABOUT RAIN.

Now we try something a bit unusual. Inform on its own will report each action on its own line, so that each character who walks into or out of a room will be described in a separate paragraph. This is usually fine, but in a game with a lot of characters moving around simultaneously, it can become a bit overwhelming. Instead, we may want to condense these reports into a single line, such as "Ben and Jerry enter from the south". The following accomplishes that goal by replacing some of the reporting rules, storing the information in a table, and then reading the table back later, once all the character movement has been resolved and the reports can usefully be collated:

Section 6 - Movement Description
 
A person has some text called walk style. The walk style of a man is usually "stride". The walk style of a woman is usually "strut". The walk style of Gene is "[one of]wander[or]stroll[purely at random]". The walk style of Francine is "waddle". The walk style of Antony is "scamper". The walk style of Rhoda is "sashay".
 
Table of Visible Exits

charactersecondthirdheading chosentotal
a persona persona persona directiona number
 
with 10 blank rows.
 
Table of Visible Entrances

charactersecondthirdheading chosentotal
a persona persona persona directiona number
 
with 10 blank rows.
 
To clear (current table - a table name):
   repeat through current table:
      blank out the whole row.
 
To tidy departures of (current table - a table name):
   let next direction be up;
   repeat through current table:
      if heading chosen entry is next direction:
         let accomplice be character entry;
         choose row with heading chosen of next direction in the current table;
         if total entry is 1:
            now second entry is accomplice;
            now total entry is 2;
         if total entry is 2:
            unless the second entry is accomplice:
               now third entry is accomplice;
               now total entry is 3;
         choose row with character of accomplice in the current table;
         blank out the whole row;
      otherwise:
         let next direction be heading chosen entry.
 
A door has a person called last opener.
 
Report someone opening a door:
   now group size is 1;
   now the last opener of the noun is the person asked;
   if the person asked is visible, say "[The person asked] opens [the noun]. [run paragraph on]" instead;
   otherwise say "[The noun] opens from the other side. [run paragraph on]" instead.
 
Report someone going through a door (called route):
   if the person asked is not the last opener of the route, continue the action;
   if the person asked is the last person named, say "[The person asked as pronoun]";
   otherwise say "[The person asked]";
   say " [if the person asked is in the location]comes[otherwise]goes[end if] through[if the last thing named is not the route] [the route][end if]." instead.
 
The last thing named is a thing that varies. Before printing the name of something (called target) which is not a person: now the last thing named is the target.
 
Report someone going a direction:
   if the person asked is in the location,
      choose a blank row in the table of visible entrances;
   otherwise choose a blank row in the table of visible exits;
   now character entry is the person asked;
   now total entry is 1;
   if the person asked is in the location,
      now heading chosen entry is the opposite of the noun;
   otherwise now heading chosen entry is the noun;
   stop the action.
 
This is the movement reporting rule:
   sort the Table of Visible Entrances in heading chosen order;
   tidy departures of the table of visible entrances;
   sort the Table of Visible exits in heading chosen order;
   tidy departures of the table of visible exits;
   let total row count be the number of filled rows in the Table of Visible Entrances plus the number of filled rows in the Table of Visible Exits;
   if total row count is 0, rule succeeds;
   generate descriptions from the Table of Visible Entrances;
   generate descriptions from the Table of Visible Exits;
   clear the Table of Visible Entrances; clear the Table of Visible Exits.
 
To generate descriptions from (current table - a table name):
   let count be the number of filled rows in the current table;
   if count is 0, rule succeeds;
   let index be count;
   repeat through the current table:
      let accomplice be character entry;
      if character entry is a person, now character entry is marked for listing;
      if there is a second entry and second entry is a person, now second entry is marked for listing;
      if there is a third entry and third entry is a person, now third entry is marked for listing;
      let target be the room the heading chosen entry from the location;
      if total entry is 3, say "[The character entry], [the second entry][optional comma] and [the third entry] ";
      if total entry is 2, say "[The character entry] and [the second entry] ";
      if total entry is 1:
         if the character entry is the last person named, say "[The character entry as pronoun] ";
         otherwise say "[The character entry] ";
      if total entry is 1, say "[walk style of the character entry]s ";
      otherwise say "walk[if total entry is 1]s[end if] ";
      if the character entry is in the location:
         if location is indoors and target is indoors, say "over from ";
         if location is outdoors and target is indoors, say "out of ";
         if location is indoors and target is outdoors, say "in from ";
         if location is outdoors and target is outdoors, say "over from ";
      otherwise:
         if location is indoors and target is indoors, say "over to ";
         if location is outdoors and target is indoors, say "into ";
         if location is indoors and target is outdoors, say "out [if a door is visible][the random visible door][end if] to ";
         if location is outdoors and target is outdoors, say "over to ";
      if target is outdoors, say "[the heading chosen entry]";
      otherwise say "[the target]";
      if the total entry is 1 and count is 1 and accomplice carries something, say ", carrying [a list of things carried by the accomplice]";
      decrement index;
      make delimiter index of count, continuing;
      now group size is total entry;
   if a marked for listing person is infected:
      [eliminate the case in which we have already seen this description because we just typed LOOK and the patient was in the room at the time]
      if looking and a marked for listing person is not in the location:
         clear marked people;
         say paragraph break;
      otherwise:
         describe patients;
   otherwise:
      clear marked people;
      say paragraph break.
 
The last person named is a person that varies. Before printing the name of a person (called target): now the last person named is the target. Group size is a number that varies. Group size is 1.
 
To clear marked people:
   repeat with named party running through people:
      now the named party is not marked for listing.
 
Before listing nondescript items:
   if the number of people who are marked for listing is 0, make no decision;
   say "You can see [a list of people who are marked for listing] here. ";
   now group size is the number of people who are marked for listing;
   describe patients;
   now every marked for listing person is not marked for listing.
 
To describe patients:
   if every marked for listing person is infected and at least three people are marked for listing:
      say "They are all sick as dogs, every one.";
      clear marked people;
      rule succeeds;
   otherwise:
      if the number of people who are marked for listing is greater than two and the number of infected people who are marked for listing is greater than the number of clean people who are marked for listing:
         say "Only [the list of clean people who are marked for listing] currently remain[if the number of clean people who are marked for listing is 1]s[end if] untainted.";
         clear marked people;
         rule succeeds;
   let count be the number of marked for listing other people who are infected;
   if count is 0:
      say paragraph break;
      make no decision;
   let index be count;
   repeat with patient running through marked for listing other people who are infected:
      if index is count:
         if count is 1 and the patient is the last person named:
            say "[The patient as pronoun]";
         otherwise:
            say "[The patient]";
      otherwise:
         say "[the patient]";
      say " [looks as though dipped in for index] [infection color of the patient]";
      decrement index;
      make delimiter index of count;
   clear marked people.
 
To say (named character - a man) as pronoun:
   if group size is 1, say "He"; if group size is 2, say "The latter"; if group size is greater than 2, say "The last".
 
To say (named character - a woman) as pronoun: if group size is 1, say "She"; if group size is 2, say "The latter"; if group size is greater than 2, say "The last".
 
To say looks as though dipped in for (index - a number):
   let divider be the number of filled rows in the Table of Dipping Phrases;
   if index is greater than 4, let index be the remainder after dividing index by divider;
   choose row index in the Table of Dipping Phrases;
   say dipping entry.
 
Table of Dipping Phrases

dipping
"looks as though dipped in"
"could have been rolling in"
"has a bad case of"
"suffers from"
"contracted a virulent"
 
A door is usually scenery.

The next part could be simpler, but for rigor we will write it in such a way that it will work whether or not the serial comma is in use. This requires some extra work.

To make delimiter (index - a number) of (count - a number), continuing or halting:
   if index is 0:
      if continuing, say ". [run paragraph on]";
      otherwise say ".";
   otherwise if index is 1:
      if count is 2, say " and ";
      otherwise say "[optional comma] and ";
   otherwise:
      say ", ".
 
To say optional comma:
   if the serial comma option is active:
      say ",".
 
Test me with "go to cold comfort / z / z / z / z / ask vanessa for french vanilla / ask vanessa for chocolate / ask vanessa about flavors / ask vanessa for chocolate chocolate chip".

Because so much of this game is randomized, it will not be possible to provide a test command that systematically solves it. A good strategy is to go to Main Street, get the syringe; go to the Town Hall and get the key; then visit the shops, inject everyone, and lock them in when they've all been injected. Then go to the Pool Hall, turn on the air conditioner, and wait for the remaining parties to show up.

This is also something that could get fairly slow if we added many more rooms and characters to it. In that case, we might want to select fast route-finding so that character movement won't take as long. This will cost memory, possibly forcing the game into Glulx format if it isn't already, but significantly reduce the run-time for large maps with numerous people moving each turn:

Use fast route-finding.

wi 19.8 New rulebooks
rb 7.13 Traveling Characters

🔗

RB §7.14 Obedient Characters

Other characters can perform all the same activities that the player can; this does not always mean that they're willing to obey the player's instructions. By default, characters will refuse to obey commands of the form JULIA, WEST or ANTONY, TAKE THE PINCUSHION. Their objections can be overridden, however, and The Hypnotist of Blois ★ implements a hypnotist who can make characters obedient at will.

In For Demonstration Purposes ★★★, the character is only capable of a few actions at the outset, but can be taught new ones if the player performs them first.

Often we want characters' obedience to be more selective. Just as the viewpoint character may be characterized in terms of what he will and will not do, so may others: Generation X ★★ demonstrates a character who will do what she's told, but who will comment unfavorably when the player asks for a nonsensical or repeated action, and who may eventually get fed up and leave.

Characters can be given moral objections to certain commands, as well: Virtue ★ defines a few kinds of actions as bad, so that the character commanded will refuse to perform them.

Under Contract ★★★★, more subtly, has the character object if the player's commands implicitly require any behavior he considers inappropriate: for instance, if the player commands him to put his pants in a container, he will work out that this requires the removal of the pants as a preliminary. If we want to implement a similar character, we may want to simply copy his unsuccessful attempt rule and the table of his retorts, then replace his banter with lines of our choosing.

The little example Latin Lessons ★ allows us to make characters clever about vague commands: we can, for instance, write rules so that CLARK, EAT will have Clark sensibly pick something edible, rather than having the parser ask what we want Clark to eat.

Finally, Northstar ★★ demonstrates how we might make Inform understand commands of the form ASK JOSH TO TAKE INVENTORY or ORDER JOAN TO WEAR THE ARMOR.

Examples

184. Virtue ★

"Virtue"

The Cloister is a room. Lady Teresa is a woman in the Cloister. Mother Margaret is a woman in the Cloister.

Attacking someone is misbehavior. Kissing someone is misbehavior.

Instead of asking someone to try misbehavior: say "[The person asked] stiffens, offended by your suggestion."

Test me with "kiss margaret / margaret, kiss me".

wi 12.3 Giving instructions to other people
rb 7.14 Obedient Characters

186. The Hypnotist of Blois ★

"The Hypnotist of Blois"

A person is either hypnotized or alert. A person is usually alert.

Persuasion rule for asking a hypnotized person to try doing something:

persuasion succeeds.

Understand "hypnotize [someone]" as hypnotizing.

Hypnotizing is an action applying to one thing.

Check hypnotizing:

if the noun is hypnotized, say "Already done." instead.

Carry out hypnotizing:

now the noun is hypnotized.

Report hypnotizing:

say "[The noun] slips under your control."

Instead of waking someone hypnotized:

now the noun is alert;

say "[The noun] returns abruptly to consciousness."

We will learn more about check rules for other characters shortly, but the following prevents the hypnosis patient from trying to hypnotize us in turn:

Check someone hypnotizing someone:
   stop the action.
 
Maison de la Magie is a room. "In a darkened room, a few hundreds of paces from the chateau of Blois, you give to tourists three shows a day: displaying to them power they do not comprehend and spectacles they do not deserve."
 
A volunteer is a woman in the Maison. "A volunteer from the audience stands facing you, [if alert]skeptically awaiting hypnosis[otherwise]her face worshipful and obedient[end if]." The printed name of the volunteer is "volunteer from the audience". The description is "A distracted, susceptible woman." The volunteer wears a t-shirt and a baseball hat.
 
The player wears a top hat and a cape.
 
Test me with "volunteer, remove hat / hypnotize volunteer / look / volunteer, remove hat / wake volunteer / volunteer, wear hat".

wi 12.4 Persuasion
rb 7.14 Obedient Characters

371. Latin Lessons ★

If we're defining actions for other characters to follow, we may want to include them in our "rule for supplying a missing noun". We can do this if we write our "while…" clause to apply to any actor, as follows:

"Latin Lessons"

The Latin Studio is a room. Rick is a man in the Studio.

A dance-name is a kind of thing. Argentine tango, samba, merengue, cha-cha, street salsa are dance-names.

Dancing is an action applying to one visible thing. Understand "dance [any dance-name]" as dancing. Understand "dance" as dancing.

Rule for supplying a missing noun while an actor dancing:

now the noun is street salsa.

Report someone dancing:

say "[The actor] dances a few steps of [the noun] for you."

Report dancing:

say "You dance a few steps of [the noun]."

Persuasion rule for asking someone to try dancing: persuasion succeeds.

Test me with "dance / dance samba / rick, dance / rick, dance merengue".

wi 18.32 Supplying a missing noun/second noun
rb 7.14 Obedient Characters

188. Generation X ★★

"Generation X"

The Volunteer Center is a room. "A fairly spartan office, though there are a few attractive posters from advertising campaigns of the past, and an ominous map charting the deforestation of Brazil."

The desk is scenery in the Volunteer Center. "Your standard metal desk, with a drawer for postal supplies and the like." On the desk is a pile of leaflets and a pile of business cards. The power stapler is a device on the desk. A drawer is part of the desk. It is openable and closed. In the drawer are a sponge and a roll of bulk-mail stamps.

Instead of doing something:

if examining, continue the action;

if searching, continue the action;

if looking, continue the action;

if asking Jenna to try doing something, continue the action;

say "The whole point of this exercise is to train Jenna. Once you have her on the envelope-stuffing, you can go make some calls."

Instead of answering Jenna that something:

say "You're going to have to break the instructions down to the simplest ones possible, given that she's in the mood to misunderstand on purpose."

A cardboard box is in the Center. In the cardboard box is a pile of empty envelopes. The box is openable and closed. The description is "A recycling symbol is prominent on the side, which makes you feel a little bit better about using a mailing campaign for this cause."

Jenna is a woman in the Volunteer Center. "Your daughter Jenna is here, barely visible through the cloud of resentment." The description is "Jenna [if jenna carries something]has [the list of things carried by Jenna][otherwise]returns your stare, with added hostility[end if]."

A persuasion rule for asking Jenna to try doing something: persuasion succeeds.

Unsuccessful attempt by Jenna doing something:

repeat through Table of Retorts:

if the reason the action failed is the cause entry:

say "[response entry][paragraph break]";

rule succeeds;

say "'I don't see how I'm supposed to do that, Mom,' Jenna says."

Table of Retorts

cause	response
can't take yourself rule	"'Is that like 'get a grip on yourself' or something?' Jenna asks, momentarily diverted."
can't take what's fixed in place rule	"[physical impossibility]"
can't take scenery rule	"[physical impossibility]"
can't take what's already taken rule	"[already done]"
can't drop what's already dropped rule	"[already done]"
can't wear what's already worn rule	"[already done]"
can't take off what's not worn rule	"[already done]"
can't close what's already closed rule	"[already done]"
can't open what's already open rule	"[already done]"
can't switch off what's already off rule	"[already done]"
can't switch on what's already on rule	"[already done]"
can't unlock what's already unlocked rule	"[already done]"
can't lock what's already locked rule	"[already done]"

To say physical impossibility:

say "'Maybe you should've brought someone a little stronger,' Jenna says. 'Like the Incredible Hulk.' "

To say already done:

repeat through Table of Bored Remarks:

say "[response entry]";

blank out the whole row;

rule succeeds;

say "'Okay, I'm going to be, like, in the car,' says Jenna. 'Outside.' ";

end the story saying "Jenna has gotten fed up".

Table of Bored Remarks

response

"'Did that,' says Jenna."

"'Check,' says Jenna."

"'Yeah, Mom, I already did that, okay?'"

"'Look, if I have to be here doing dumb stuff, could you at least tell me to do stuff that isn't already done?' Jenna asks wearily."

"Jenna gives a great upward sigh, riffling her bangs. 'Once again... there is totally no point.'"

Test me with "e / x jenna / jenna, get stapler / jenna, get stapler / x jenna / jenna, drop stapler / jenna, drop stapler / jenna, open box / jenna, open box / jenna, switch stapler on / jenna, switch stapler on / jenna, take desk / jenna, open box / jenna, open box".

wi 12.5 Unsuccessful attempts
rb 7.14 Obedient Characters

422. Northstar ★★

Most of the time, Inform understands commands to other characters when they take the form "JOSH, TAKE INVENTORY" or "JOAN, WEAR THE ARMOR". But novice players might also try commands of the form ASK JOSH TO TAKE INVENTORY or ORDER JOAN TO WEAR THE ARMOR.

The easiest way to make Inform understand such commands is to meddle directly with the player's command, changing it into the format that the game will understand, as here:

"Northstar"

The Northstar Cafe is a room. "The Northstar is crammed with its usual brunch crowd, and you were lucky to get a table at all. You are now awaiting the arrival of your ricotta pancakes."

Josh is a man in The Northstar Cafe. "Josh is on his way past your table." The description of Josh is "He is a waiter here, but you also know him socially, so he tends to be more chatty than the other waiters." A persuasion rule: persuasion succeeds.

After reading a command:

let N be "[the player's command]";

replace the regular expression "\b(ask|tell|order) (.+?) to (.+)" in N with "\2, \3";

change the text of the player's command to N.

Test me with "ask Josh to take inventory / tell Josh to take inventory / order Josh to take inventory".

Note that we have to copy N back explicitly to replace the player's command.

wi 20.8 Replacements
rb 7.14 Obedient Characters

239. For Demonstration Purposes ★★★

Suppose we want to have a character who can dynamically learn new actions by observing the player performing them. We could do this by adding the actions to a list of things the character can do, but using a relation to express the same idea allows for tidier, easier-to-read code.

Thanks to Jesse McGrew for the initial design of this example.

"For Demonstration Purposes"

Section 1 - Procedure

Capability relates various people to various stored actions. The verb to be capable of means the capability relation.

Persuasion rule:

let CA be the current action with no specific actor;

if the person asked is capable of CA:

persuasion succeeds;

otherwise:

say "[The person asked] look[s] confused. Maybe a demonstration would help.";

persuasion fails.

The action requester is an object that varies. The action requester variable is defined by Inter as "act_requester".

To decide which action is the current action with no specific actor:

let old actor be the person asked;

let old requester be the action requester;

now the person asked is the player;

now the action requester is nothing;

let CA be the current action;

now the person asked is the old actor;

now the action requester is the old requester;

decide on CA.

The learning by observation rule is listed after the report stage rule in the specific action-processing rules.

Definition: a person is other if he is not the player.

This is the learning by observation rule:

repeat with the viewer running through other people who can see the player:

if the player is the actor and viewer is not capable of the current action:

say "[The viewer] watches your behavior with interest. Seems like [they] [are] learning.";

now the viewer is capable of the current action.

Section 2 - Scenario

The Daily Planet is a room. Clark is here. He is a man.

When play begins:

now Clark is capable of taking inventory.

Test me with "Clark, inventory / Clark, x me / x me / Clark, x me".

wi 13.13 Relations involving values
rb 7.14 Obedient Characters

205. Under Contract ★★★★

"Under Contract"

The Sound Stage is a room. The description is "A somewhat creaky and unconvincing reproduction of the docks of San Francisco."

Clark Gable is a man in the Sound Stage. "Clark is here, carrying [the list of things carried by Clark][if Clark wears anything] and wearing [the list of things worn by Clark][end if]." Clark carries a swagger stick. Clark carries an open openable player's holdall called a briefcase. The briefcase contains a signed contract. Clark wears a fedora and a pair of pants. A handle is part of the briefcase.

The player carries an open openable player's holdall called a frilly bag. The carrying capacity of the player is 2. The player wears a sparkly scarf and a slinky dress. A strap is part of the bag. The tent is a portable enterable container.

Instead of taking off the slinky dress: say "Rowr! Not that kind of movie, babe."

Instead of taking off the pants: say "That's not your job, whatever the society pages might suggest."

Unsuccessful attempt by Clark doing something:

repeat through table of Clark Retorts:

if the reason the action failed is the cause entry:

say "[response entry][paragraph break]";

rule succeeds;

say "'I don't think that's in the script,' says Clark dubiously."

Table of Clark Retorts

cause	response
can't take yourself rule	"'I'm always self-possessed,' Clark remarks. You've heard that line before, but it sounds so much more convincing from him."
can't take other people rule	"'I don't think it would be appreciated if I tried to do that to [the noun],' he rumbles."
can't take component parts rule	"'I don't want to rip [the noun] out,' Clark remarks."
can't take people's possessions rule	"'I don't cotton to acting like a thief,' Clark replies. 'It ain't proper.'"
can't take what you're inside rule	"'Do you see where I am, babe?' Clark demands."
can't take what's already taken rule	"[already done]"
can't take scenery rule	"'I'm not the stunt man, darling,' he says with a wry twinkle."
can't take what's fixed in place rule	"'I'm not the stunt man, darling,' he says with a wry twinkle."
can't exceed carrying capacity rule	"Clark grins. 'I've only got so many hands, darling,' he says."
can't insert into closed containers rule	"[physical impossibility]"
can't go that way rule	"[physical impossibility]"
can't go through closed doors rule	"[physical impossibility]"
can't enter closed containers rule	"[physical impossibility]"
can't exit closed containers rule	"[physical impossibility]"
can't drop yourself rule	"'We're inseparable, me and me,' Clark replies, with a smile."
can't drop what's already dropped rule	"[already done]"
can't drop what's not held rule	"'Not under my control, [the noun],' replies Clark."
can't drop clothes being worn rule	"[salacious retort]"
can't put something on itself rule	"'I lack the dexterity,' says Clark. Oh, he's so modest."
can't put onto what's not a supporter rule	"'[The second noun] won't support a thing,' says Clark reprovingly."
can't put clothes being worn rule	"[salacious retort]"
can't insert clothes being worn rule	"[salacious retort]"
can't give worn items rule	"[salacious retort]"
can't wear what's not clothing rule	"'Costuming just gets stranger every year,' says Clark. 'In short: no.'"
can't wear what's already worn rule	"[already done]"
can't eat unless edible rule	"'What're you trying to do, poison me?'"
can't eat clothing without removing it first rule	"[salacious retort]"
can't take off what's not worn rule	"[already done]"
can't close what's already closed rule	"[already done]"
can't open what's already open rule	"[already done]"
can't switch off what's already off rule	"[already done]"
can't switch on what's already on rule	"[already done]"
can't unlock what's already unlocked rule	"[already done]"
can't lock what's already locked rule	"[already done]"

To say already done:

repeat through Table of Clark's Bored Remarks:

say "[response entry]";

blank out the whole row;

rule succeeds;

say "'Already done.' "

Table of Clark's Bored Remarks

response

"'I have anticipated your every demand.'"

"'We've been through this part of the script already,' Clark remarks, with just a hint of creeping tedium."

"'Right right, already taken care of...'"

"'I'm a believer in rehearsal,' Clark says, sounding more bored than ever, 'but we really have got all this done already.'"

To say salacious retort:

repeat through Table of Clark's Flirtatious Remarks:

say "[response entry]";

blank out the whole row;

rule succeeds;

say "Clark, driven past the point of endurance, seizes you in his arms and kisses you.";

end the story finally.

Table of Clark's Flirtatious Remarks

response

"Clark allows his mustache to quirk at the suggestion."

"Clark wiggles his eyebrows at you."

"'That kind of thing isn't in my contract, sweetie,' says Clark. 'If you're interested you'll have to ask off-camera.'"

"'I'd feel so... bare,' Clark says, with a sidelong look at you."

"'You first,' says Clark."

"Clark's stare is intense. You may be on the verge of breaking him."

To say physical impossibility:

repeat through Table of Clark's Frustrated Denials:

say "[response entry]";

blank out the whole row;

rule succeeds;

say "Clark makes a helpless gesture about his ability to move himself, or parts of himself, through solid objects. "

Table of Clark's Frustrated Denials

response

"Clark frowns. 'I can't reach through things -- unless you were planning a special effect?'"

"'Look,' says Clark. 'If you want a stage magician, hire one.'"

"Clark just groans."

"Clark says drily, 'Is this in the script, or are we doing improvisation now?'"

The block giving rule is not listed in the check giving it to rules. The block showing rule is not listed in the check showing it to rules. The report smelling rule is not listed in the report smelling rules. The report listening rule is not listed in the report listening to rules.

Carry out listening to something:

do nothing.

Report listening to something: say "Your attention bears no interesting result."

Carry out smelling something:

do nothing.

Report smelling something: say "Your attention bears no interesting result."

Report someone listening to something: say "[The person asked] concentrates, listening."

Report someone smelling something: say "[The person asked] sniffs at [the noun]."

Instead of asking someone for something: try asking the noun to try giving the second noun to the player.

Carry out showing something to someone: say "You reveal [the noun] to [the second noun]."

Carry out Clark showing something to someone:

if the second noun is the player:

say "Clark shows you [the noun]. [run paragraph on]";

try examining the noun;

otherwise:

say "Clark reveals [the noun] to [the second noun]."

Instead of asking someone to try saying yes: try saying yes. Instead of asking someone to try saying no: try saying no. Instead of asking someone to try saying sorry, try saying sorry.

And now we make Clark a very amenable type:

A persuasion rule for asking people to try doing something: persuasion succeeds.

There are quite a few actions for which no automatic other-character behavior is provided at all, because they always end in failure when the player tries them. Currently the response is not very interesting. Let's spice it up a bit:

Burning something is useless action. Waking up is useless action. Thinking is useless action. Cutting is useless action. Jumping is useless action. Tying something to something is useless action. Drinking something is useless action. Swinging is useless action.  Rubbing is useless action. Setting something to something is useless action. Waving hands is useless action. Buying is useless action. Climbing is useless action. Sleeping is useless action. Kissing is useless action. Throwing something at something is useless action. Attacking is useless action. Asking something about something is useless action. Telling something about something is useless action. Answering something that something is useless action. Waking something is useless action.
 
A persuasion rule for asking people to try useless action:
   say "Clark Gable frowns. 'I don't mean to be difficult, but I can't see any point in that.'";
   persuasion fails.
 
A persuasion rule for asking Clark to try taking off the pants:
   say "He gives you a look of mocking exasperation. Apparently you'll have to take a (slightly) more subtle approach.";
   persuasion fails.
 
   Check someone giving something to someone (this is the can't give worn items rule):
      if the person asked wears the noun, stop the action.

And because we do not want Clark automatically taking off the pants as the result of a drop action:

Instead of Clark taking off the pants: do nothing.

We know that this can only come about as a default action, because we have arranged matters so that he cannot be persuaded directly.

Test me with "give dress to clark / clark, take off pants / clark, eat pants / clark, give me the pants / clark, drop pants / clark, put the pants in the briefcase / again / g / g / g"

wi 12.11 Making actions work for other people
rb 7.14 Obedient Characters

🔗

RB §7.15 Goal-Seeking Characters

Goal-seeking characters are the most advanced IF life-form: they want to achieve specific outcomes, and they are able to work out plans of approach in order to bring these things about. They walk to rooms, open containers to search for things, use keys and tools, and ask leading questions in conversation.

A really advanced implementation of goal-seeking behavior is beyond the scope of our examples (though extensions exist that treat the problem more thoroughly). We can accomplish a surprising amount without heavy customization, though, if we keep in mind three points of technique:

First: it helps to think abstractly and to create broadly-defined actions as a first step to more specific tasks. For instance, a character's goal might be to eat some dinner. He'd be equally satisfied with spaghetti carbonara or with braised lamb shanks, but he needs to figure out which is available. So we might have our every turn rule (or whatever we're using to activate the character) say something like

Every turn when Clark is hungry:
   try Clark dining.

Dining would then be an action we've defined specially, which looks around Clark's environment for suitable food; if it finds food, it issues a

try Clark eating the suitable food;

command; but if not, it sends Clark off to look for something likely. The Man of Steel ★★ demonstrates the use of this.

Second: though it doesn't actually contribute to the goal-seeking per se, lively reporting brings characters' generated behavior to life.

Clark eats a donut.

doesn't characterize Clark very much, even though the eating may be part of a subtle, intelligent plan to seduce Lois Lane. We'll do better if we replace a lot of the character reporting rules: to that end, see the example The Man of Steel Excuses Himself ★★.

Third: goal-seeking characters notice when something is in the way of the action they want to perform. When that happens, they form a plan about how to remove the obstacle. We've already seen this kind of implementation on the player's behalf: the player will pick up items before eating them, say. We can use Before rules to do similar things for other characters, as in

Before Clark eating the wrapped candy:
   try Clark unwrapping the candy;
   if the candy is wrapped, stop the action.

Here we've set things up so that if Clark tries to eat the wrapped candy, he'll be interrupted by this other command; and if his unwrapping-the-candy attempt fails, he won't go on and eat the thing. IQ Test ★ demonstrates a character who shows this kind of planning intelligence.

Because before-rules chain neatly, we can trigger whole plans of behavior if we have a sensible set, as in

Before someone entering a closed container: try the person asked opening the noun.
Before someone opening a locked container: try the person asked unlocking the noun.
Before someone unlocking a locked container: ...

We must exercise a little bit of care if it is possible for the chain of actions to produce an endless loop - e.g., the character trying to take a key that is inside the transparent, locked box that it opens might repeatedly try to open the box, first unlocking the box, first taking the key, first opening the box, … Boston Cream ★★★★ is a fully-worked scenario that deals with such a set of conundra.

Examples

189. IQ Test ★

We have already seen how Before… rules can generate implicit actions for the player, so that the player will, for instance, open doors before trying to walk through them. The same can be done for characters other than the player; so for instance:

"IQ Test"

The Donut Shop is a room. "Vibrantly decorated in donut colors: pink, brown, and cream."

Ogg is a man in the Donut Shop. "Ogg is slumped in the corner[if Ogg carries something] with [a list of things carried by Ogg][end if]. He wears a nametag which says 'HELLO MY NAME IS OG.'" Understand "og" as Ogg. Ogg wears a nametag. The description of the nametag is "Sadly misspelled."

The Donut Shop contains a transparent closed openable locked lockable container called a case. The case contains some cake donuts. The donuts are edible.

The matching key of the case is a silver key. The silver key is carried by Ogg.

A persuasion rule for asking someone to try doing something:

persuasion succeeds.

Before someone opening a locked thing (called the sealed chest):

if the person asked is carrying the matching key of the sealed chest, try the person asked unlocking the sealed chest with the matching key of the sealed chest;

if the sealed chest is locked, stop the action.

Before someone taking something which is in a closed container (called the shut chest):

try the person asked opening the shut chest;

if the shut chest is closed, stop the action.

The block giving rule is not listed in the check giving it to rules.

Test me with "open case / get donuts / og, get donuts / og, give me the donuts / eat donuts".

(A more detailed set of before rules for people using doors and locks is provided in Emily Short's Locksmith extension.)

wi 12.6 Spontaneous actions by other people
rb 7.15 Goal-Seeking Characters

203. The Man of Steel ★★

It will sometimes be handy to write actions that are only available to the non-player characters and not to the player. To do this, we just define an action which has no "understand": the player will never be able to specify this command himself, but other characters can try it.

This is particularly useful for creating abstract or general actions for when we want a character to eat something, wear something, or go somewhere, but aren't too particular as to what the object is; as here, where we just want Clark to move away from the kryptonite, regardless of direction:

"The Man of Steel"

Escaping is an action applying to nothing.

Carry out someone escaping:

let space be the holder of the person asked;

let place be a random room which is adjacent to the space;

let way be the best route from the space to the place;

try the person asked going way.

Every turn:

if Clark Kent can see kryptonite, try Clark Kent escaping.

The Daily Planet Newsroom is a room.

Perry White's Office is west of the Newsroom. In Perry White's Office are a desk and a poster of Elvis. On the desk is a lead-lined box. The box is openable. In the box is the green kryptonite crystal.

The Supply Closet is east of the Newsroom. The Elevator Bank is north of the Newsroom.

Clark Kent is a man in the Newsroom. "Clark [if Clark can see the kryptonite]looks a bit ill[otherwise]is here, frowning as he revises his latest article[end if]."

Test me with "west / get box / east / close box / east / west / north / south / west".

wi 12.11 Making actions work for other people
rb 7.15 Goal-Seeking Characters

208. The Man of Steel Excuses Himself ★★

Report rules can be a good point at which to add local color: while Inform provides default descriptions of character behavior, these are rather generic and can stand to be customized.

For instance, if we wanted to liven up our previous Clark Kent example:

"The Man of Steel Excuses Himself"

Escaping is an action applying to nothing.

Carry out someone escaping:

let space be the holder of the person asked;

let place be a random room which is adjacent to the space;

let way be the best route from the space to the place;

try the person asked going way.

Every turn:

if Clark Kent can see kryptonite, try Clark Kent escaping.

The Daily Planet Newsroom is a room.

The Supply Closet is east of the Newsroom. The Elevator Bank is north of the Newsroom.

Clark Kent is a man in the Newsroom. "Clark [if Clark can see the kryptonite]looks a bit ill[otherwise]is here, frowning as he revises his latest article[end if]."

Test me with "west / get box / east / close box / east / west / north / south / west".

Report Clark Kent going a direction (called the way):

say "[one of]With a particularly weak excuse[or]Muttering[at random] about [random excuse subject], Clark heads [way]." instead.

To say random excuse subject:

choose a random row in the Table of Lame Excuses; say "[reply entry]".

Table of Lame Excuses

"needing a paper-clip"

"wanting an English-Tuvalu dictionary"

"walking a neighbor's dog"

"hearing air-raid sirens"

"having drunk too much coffee"

"thinking he smells smoke"

"wondering where Lois got to"

"needing to speak to Jimmy"

"noticing the Good Year blimp"

It's good to be careful, as the library report rules have been designed and tested to describe every contingency (going through doors, going in vehicles, etc.): so when replacing a report rule, we should try to consider all the possible variations of the action that we might want to describe.

However, in this case, our scenario is so simple that there are no doors, vehicles, or pushable objects, so we're safe in giving Clark a very simple reporting scheme.

wi 12.13 Report rules for actions by other people
rb 7.15 Goal-Seeking Characters

190. Boston Cream ★★★★

"Boston Cream"

Use scoring.

The Donut Shop is a room. "Vibrantly decorated in donut colors: pink, brown, and cream."

The Donut Shop contains a transparent closed openable locked lockable enterable container called a case. The case is fixed in place. The case contains some cake donuts, some jelly donuts, and some apple fritters. "The [if unopenable]damaged[otherwise]gleaming[end if] donut case [if something is in the case]contains [a list of things in the case][otherwise]has been stripped of its contents[end if]." The cake donuts, the jelly donuts, and the apple fritters are edible.

The matching key of the case is a silver key. The silver key is in a mesh basket. The mesh basket is closed, transparent, and openable. It is in the Donut Shop.

Before someone taking something which is carried by the player:

if the person asked cannot touch the player:

say "Ogg looks with a fixed frown at [the noun].";

continue the action;

say "[The person asked] comes up and shakes your arm until you drop [the noun].";

say line break;

silently try dropping the noun;

stop the action.

Before someone unlocking a locked thing with something which is not carried by the person asked:

try the person asked taking the second noun;

stop the action.

Before someone opening a locked thing (called the sealed chest):

if the person asked can see the matching key of the sealed chest:

if the matching key of the sealed chest is enclosed by the sealed chest:

say "Seeing the paradoxical location of [the matching key of the sealed chest], [the person asked] gives a howl of rage.";

increment the score;

end the story finally saying "You have thwarted Ogg";

otherwise:

try the person asked unlocking the sealed chest with the matching key of the sealed chest;

stop the action.

Before someone taking something which is in a closed container (called the shut chest):

try the person asked opening the shut chest;

stop the action.

Ogg has a number called hunger. The hunger of Ogg is 0.

Every turn:

increment the hunger of Ogg;

if the hunger of Ogg is 2 and Ogg is visible, say "Ogg's stomach growls.";

if the hunger of Ogg is 3 and Ogg is visible:

if Ogg can see an edible thing (called the target):

say "Ogg eyes [the target] with obvious intent.";

otherwise:

say "Ogg glances at you in a disturbingly shifty way.";

if the hunger of Ogg is greater than 3:

if Ogg carries an edible thing (called the target):

try Ogg eating the target;

otherwise:

let new target be a random edible thing which can be seen by Ogg;

if the new target is a thing:

try Ogg taking the new target;

otherwise:

if Ogg can touch the player, end the story saying "Ogg is gnawing your ankle";

otherwise try Ogg taking the player.

The crumbs are a thing. "Crumbs of [the list of edible things which cannot be seen by the player] lie scattered over the whole floor."

Instead of asking Ogg to try doing something when Ogg cannot touch the player:

say "Ogg tilts his head and shrugs, unable to hear your instruction clearly."

Instead of asking Ogg to try eating something:

say "It's not as though Ogg really needs any encouragement in that department, is it?"

Definition: Ogg is hungry if the hunger of Ogg is greater than 2.

Persuasion rule for asking Ogg to try doing something: if Ogg is hungry, persuasion fails; persuasion succeeds.

Persuasion rule for asking Ogg to try giving something edible to the player:

persuasion fails.

Unsuccessful attempt by Ogg doing something:

if the reason the action failed is a failing listed in the Table of Ogg Retorts:

say "[reply entry][paragraph break]";

otherwise:

say "Ogg looks adorably confused."

Table of Ogg Retorts

failing	reply
can't take people's possessions rule	"'Ogg too polite.'"
can't take other people rule	"'Ogg not that greedy.'"
can't take scenery rule	"'[The noun] very very heavy.'"
can't take what's fixed in place rule	"'[The noun] very heavy."
can't drop what's not held rule	"'Hunh?'"

Carry out Ogg eating an edible thing:

move the crumbs to the holder of Ogg;

now the hunger of Ogg is 0.

Report Ogg unlocking something with something:

say "Ogg struggles a bit with [the second noun] in the lock of [the noun], but does eventually succeed. 'Hunh!' says Ogg.";

stop the action.

Carry out Ogg opening the case when the case has been open:

now the case is unopenable.

Instead of closing the unopenable case:

say "The glass panels are no longer properly seated in their tracks, and the case cannot be closed ever again."

Report Ogg opening the unopenable case:

say "Ogg forces [the case] so hard that it does break.";

stop the action.

Report Ogg opening the case:

say "Ogg yanks [the noun] open with such force that you fear for its structural integrity.";

stop the action.

Report Ogg taking something edible:

say "Ogg acquires [the noun] with a look of tender affection.";

stop the action.

Report Ogg eating something:

say "Ogg chows down on [the noun], scattering crumbs in all directions.";

stop the action.

Report Ogg eating something when the number of visible edible things is 1:

say "Ogg eats [the noun] in his trademark style. You can no longer bear to watch.";

stop the action.

After entering the case:

say "You climb inside the case, folding yourself up uncomfortably."

After locking the case with something when the player is in the case:

say "You turn the key firmly in the lock -- amazing it locks from within, but it does -- and settle yourself for a long wait, hoping this thing is not air-tight."

The maximum score is 1.

Test me with "open mesh / get key / unlock case / open case / enter case / close case / lock case / wait / wait".

wi 12.6 Spontaneous actions by other people
rb 7.15 Goal-Seeking Characters

🔗

RB §7.16 Social Groups

Crowds of characters introduce new challenges, because we often want to show them interacting with one another, or to describe individuals in less detail when a whole group is present.

Strictly Ballroom ★★ gives us a set of characters who pair off each turn, making sure to mention each one once, and leaving one unfortunate person behind as a wallflower: this exemplifies how we might use a behavioral rule not to dictate the behavior of each individual separately but rather to model a whole group together. Happy Hour ★★ does calculate movements for characters individually, but then collates the descriptions, creating a single paragraph to describe whatever group is currently in the room.

Characters can also have complicated attitudes to one another, and it can be helpful to use relations to track these. Unthinkable Alliances ★ demonstrates the grouping of characters into alliance factions, while The Abolition of Love ★ provides a host of relations to track love affairs, marriages, memberships in families, and mere mutual respect.

Emma ★★ combines these two effects: its characters move between social groups depending on how they feel about the others in their particular talking circle, and descriptions change depending on who is where in the room.

Lugubrious Pete's Delicatessen ★ simulates a queue at a deli, in which the customers who most impress Pete get served first.

Examples

229. Unthinkable Alliances ★

The following is best tested by experimentally kissing and/or attacking, and typing RELATIONS after every change to see the effect.

"Unthinkable Alliances"

Unthinkable Solutions is a room. Sophie, Daisy, Ryan and Owen are in Unthinkable Solutions.

Alliance relates people to each other in groups. The verb to help means the alliance relation.

Sophie helps Ryan. Daisy helps Ryan. Owen helps the player.

Instead of kissing someone (called the blessed one):

say "Smack!";

now the player helps the blessed one.

Instead of attacking someone (called the vilified one):

say "Smack!";

now the player does not help the vilified one.

Test me with "relations / kiss sophie / relations / hit ryan / relations".

wi 13.9 Defining new assertion verbs
rb 7.16 Social Groups

231. The Abolition of Love ★

Suppose we are modeling a complex society seething with interpersonal relations of every kind.

"The Abolition of Love"

Section 1 - Relation types

Loving relates one person to one person.

Noticing relates various people to one person.

Impressing relates one person to various people.

Fancying relates various people to various people.

Acquaintance relates people to each other.

Marriage relates one person to another.

Alliance relates people to each other in groups.

The Chapel is a room. Elizabeth, Wickham and Darcy are people in the Chapel. Mr Bennett and Mrs Bennett are people in the Chapel. Georgiana is a person in the Chapel.

The verb to love means the loving relation.

The verb to notice means the noticing relation.

The verb to impress means the impressing relation.

The verb to fancy means the fancying relation.

The verb to know means the acquaintance relation.

The verb to be married to means the marriage relation.

The verb to be related to means the alliance relation.

Elizabeth loves Darcy. Elizabeth fancies Darcy. Elizabeth notices Darcy. Elizabeth impresses Darcy.

Mr Bennett is related to Mrs Bennett and Elizabeth. Mr Bennett is married to Mrs Bennett.

Georgiana is related to Darcy.

Now we want ways to set and unset all of these relations. (In the interests of thoroughness, we may get a bit far-fetched here. It is not recommended in practice that we make the player guess the verb "traduce".)

Section 2 - Setting and Unsetting Love (1-1)
 
Understand "infatuate [someone] with [someone]" as infatuating it with. Infatuating it with is an action applying to two visible things.
 
Carry out infatuating it with:
   now the noun loves the second noun.
 
Report infatuating it with:
   say "Now [the noun] loves [a random person loved by the noun][if the second noun loves someone], while [the second noun] loves [a random person loved by the second noun][end if]."
 
Understand "embitter [someone] toward [someone]" as embittering it toward. Embittering it toward is an action applying to two visible things.
 
Carry out embittering it toward:
   now the noun does not love the second noun.
 
Report embittering it toward:
   say "[The noun] sees [the second noun] in a different light and no longer feels any affection."

Because love is a 1-1 relation, a person cannot love more than one other character at a time. Whenever we set a character to love a new person, that person ceases to love the character loved before. It is a fickle world.

One to various relations are a bit more open: we can say someone impresses multiple other characters, and our additions to the list do not override the initial ones.

Section 3 - Setting and Unsetting Impressed (1-V)
 
Understand "commend [someone] to [someone]" as commending it to. Commending it to is an action applying to two visible things.
 
Carry out commending it to:
   now the noun impresses the second noun.
 
Report commending it to:
   say "[The second noun] takes a very decided interest in [the noun]."
 
 
Understand "traduce [someone] to [someone]" as traducing it to. Traducing it to is an action applying to two visible things.
 
Carry out traducing it to:
   now the noun does not impress the second noun.
 
Report traducing it to:
   say "[The second noun], hearing your story, decides not to be at all impressed with [the noun]."

And because this is a one-to-various relation, we can also make statements which set multiple relations at once, so:

Understand "celebrate [someone]" as celebrating. Celebrating is an action applying to one visible thing.
 
Carry out celebrating:
   now the noun impresses every person.
 
Report celebrating:
   say "[The list of people who are impressed by the noun] take a very decided interest in [the noun]."
 
 
Understand "slander [someone]" as slandering to. Slandering to is an action applying to one visible thing.
 
Carry out slandering to:
   now every person is not impressed by the noun.
 
Report slandering to:
   say "Now [the noun] impresses [the list of people who are impressed by the noun]."

Note that the above unsetting is not equivalent to "now the noun does not impress every person" -- which would be ambiguous in spoken English, as well. Various-to-one relations are similar:

Section 4 - Setting and Unsetting Noticing (V-1)
 
Understand "draw the attention of [someone] to [someone]" as drawing the attention of it to. Drawing the attention of it to is an action applying to two visible things.
 
Carry out drawing the attention of it to:
   now the noun notices the second noun.
 
Report drawing the attention of it to:
   say "[The noun] glances thoughtfully in the direction of [the second noun]."
 
Understand "distract [someone] from [someone]" as distracting it from. Distracting it from is an action applying to two visible things.
 
Carry out distracting it from:
   now the noun does not notice the second noun.
 
Report distracting it from:
   say "You distract [the noun] from [the second noun]."
 
Understand "draw attention to [someone]" as drawing attention to. Drawing attention to is an action applying to one visible thing.
 
Carry out drawing attention to:
   now every person notices the noun.
 
Report drawing attention to:
   say "You quickly cause everyone to attend to [the noun]."
 
Understand "outshine [someone]" as outshining. Outshining is an action applying to one visible thing.
 
Carry out outshining:
   now every person does not notice the noun.
 
Report outshining:
   say "You quickly distract everyone from [the noun]."
 
Section 5 - Setting and Unsetting Fancying (V-V)
 
Understand "flatter [someone]" as flattering. Flattering is an action applying to one thing.
 
Carry out flattering:
   now every person fancies the noun.
 
Report flattering:
   say "You draw down universal admiration for [the noun] by casting him or her in a flattering light."
 
Understand "unflatter [someone]" as unflattering. [Okay, okay, but it's four am.] Unflattering is an action applying to one thing.
 
Carry out unflattering:
   now every person does not fancy the noun.
 
Report unflattering:
   say "[The noun] gives everyone a universal disgust."
 
Understand "admire [someone]" as admiring. Admiring is an action applying to one thing.
 
Carry out admiring: now the player fancies the noun.
 
Report admiring: say "You find you rather fancy [the noun]."
 
Understand "loathe [someone]" as loathing. Loathing is an action applying to one thing.
 
Carry out loathing: now the player does not fancy the noun.
 
Report loathing: say "You take [the noun] in disgust."
 
Understand "cause chaos" as causing chaos. Causing chaos is an action applying to nothing.
 
Carry out causing chaos:
   now every person fancies every person.
 
Report causing chaos: say "Now everyone fancies everyone else, which is quite an inconvenient state of affairs."
 
Understand "relieve chaos" as relieving chaos. Relieving chaos is an action applying to nothing.
 
Carry out relieving chaos:
   now every person is fancied by no one.
 
Report relieving chaos: say "Now no one fancies anyone, which is safe but tedious."

Our options for setting and unsetting symmetrical relations are more limited again:

Section 6 - Setting and Unsetting Marriage (1-1 Symmetrical)
 
Understand "marry [someone] to [someone]" as uniting it in matrimony with. Uniting it in matrimony with is an action applying to two visible things.
 
Carry out uniting it in matrimony with:
   now the noun is married to the second noun.
 
Report uniting it in matrimony with:
   say "You perform the marriage of [the noun] to [the second noun], joining them to the family of [a list of people related to the noun]."
 
Understand "divorce [someone] from [someone]" as divorcing it from. Divorcing it from is an action applying to two visible things.
 
Check divorcing it from:
   if the noun is not married to the second noun, say "[The noun] is not married to [the second noun] anyway." instead.
 
Carry out divorcing it from:
   now the noun is not married to the second noun.
 
Report divorcing it from:
   say "[The noun] is now not married to [the second noun]."

When we unset the symmetrical relation on one side, it is automatically set or unset on the other. It is not necessary to say "the second noun is married to the noun" or "the second noun is not married to the noun", even though that is the case.

Section 7 - Setting and Unsetting Acquaintance (V-V Symmetrical)
 
Understand "introduce [someone] to [someone]" as introducing it to. Introducing it to is an action applying to two visible things.
 
Carry out introducing it to:
   now the noun knows the second noun.
 
Report introducing it to:
   say "You introduce [the noun] to [the second noun]. Now [the noun] is acquainted with [the list of people who are known by the noun], and [the second noun] is acquainted with [the list of people who are known by the second noun]."
 
 
Understand "announce [someone]" as announcing. Announcing is an action applying to one visible thing.
 
Carry out announcing:
   now every person knows the noun.
 
Report announcing:
   say "You announce [the noun] to the whole assembled company."
 
 
Understand "ostracise [someone]" as ostracising. Ostracising is an action applying to one visible thing.
 
Carry out ostracising:
   now every person does not know the noun.
 
Report ostracising:
   say "You cause everyone present to forget and pretend not to be acquainted at all with [the noun]."

And finally, setting groups:

Section 8 - Setting and Unsetting Familial Relations (Groups)
 
Understand "make [someone] adopt [someone]" as forcing it to adopt. Forcing it to adopt is an action applying to two visible things.
 
Carry out forcing it to adopt:
   now the noun is related to the second noun.
 
Report forcing it to adopt:
   say "Now [the second noun] is related to [the list of people related to the second noun]."
 
Understand "make [someone] disown [someone]" as forcing it to disown. Forcing it to disown is an action applying to two visible things.
 
Carry out forcing it to disown:
   now the second noun is not related to the noun.
 
Report forcing it to disown:
   say "Now [the second noun] is related to [the list of people who are related to the second noun], and [the noun] is related to [the list of people who are related to the noun]."

Notice that when we say "the second noun is not related", we remove that person from the group: they are now in a separate group of their own, while the rest of the group's members remain related to one another.

And finally, a long litany of test cases, complete with the relations lists:

Test acquaintance with "relations / introduce darcy to elizabeth / introduce darcy to wickham / announce mr bennett / relations / ostracise wickham / introduce georgiana to wickham / relations".
 
Test impression with "commend georgiana to elizabeth / relations / celebrate Mrs bennett / relations / traduce mrs bennett to darcy / relations / slander mrs bennett / relations".
 
Test notice with "draw the attention of darcy to elizabeth / relations / draw attention to mr bennett / relations / distract darcy from mr bennett / relations / outshine mr bennett / relations".
 
Test love with "embitter elizabeth toward darcy / relations / infatuate elizabeth with wickham / relations".
 
Test marriage with "marry elizabeth to darcy / relations / divorce elizabeth from darcy / relations".
 
Test alliance with "make mr bennett adopt georgiana / relations / make mrs bennett disown georgiana / relations".
 
Test fancying with "admire elizabeth / relations / loathe elizabeth / relations / flatter elizabeth / relations / unflatter elizabeth / relations / cause chaos / relations / relieve chaos / relations".
 
Test me with "test acquaintance / test impression / test notice / test love / test alliance / test fancying / test marriage".

wi 13.10 Defining new prepositions
rb 7.16 Social Groups

435. Lugubrious Pete's Delicatessen ★

First, to set the scene:

"Lugubrious Pete's Delicatessen"

The Supermarket is west of the Delicatessen Counter. Lugubrious Pete is in the Delicatessen. "Lugubrious Pete, dolefully slicing meats and cheeses, serves at the counter." Alice, Beth, Gemma, Delia, and Eliza are women in the Supermarket.

The deli queue is a list of objects that varies.

Two processes compete here: one that fills the queue, the other which will empty it. The first process is the one which brings shoppers in to the counter, joining the back of the queue, which is where "add … to …" puts new entries by default:

Every turn when a woman is in the Supermarket and a random chance of 2 in 3 succeeds (this is the customer arriving rule):
   let the customer be a random woman in the Supermarket;
   now the customer is in the Delicatessen;
   if the player is in the Supermarket, say "[The customer] walks into the Delicatessen.";
   if the player is in the Delicatessen, say "[The customer] comes in from the Supermarket, and [if the number of entries in the deli queue is 0]can't believe her luck. The counter is free![otherwise]resignedly queues behind [the deli queue].";
   add the customer to the deli queue.

The competing process is the one which serves shoppers and thus gets rid of them again: unfortunately, it is slower. But Pete is fair if inefficient, and serves the customers in strict order of arrival. Each served customer is removed from the front of the list, and the others therefore all move up a place.

Every turn when the number of entries in the deli queue is not 0 and a random chance of 1 in 3 succeeds (this is the customer being served rule):
   let the customer be entry 1 of the deli queue;
   if the player is in the Delicatessen, say "Pete gives a droopy expression as he serves [customer], who nevertheless brightens and leaves.";
   if the player is in the Supermarket, say "[customer] emerges cheerfully from the Delicatessen Counter, and goes about her regular shopping.";
   now the customer is in the Supermarket;
   remove entry 1 from the deli queue.
 
Instead of waiting in the Delicatessen when the number of entries in the deli queue is not 0, say "Time passes, for [deli queue] quite as much as for yourself."
 
Test me with "wait / wait / wait / east / wait / wait / wait / wait / wait".

That completes the example, but here is a variation to show that queues need not empty from the front. The Deli already looks a pretty sexist establishment, with the customers all being women, but it is about to get a whole lot worse:

Modesty is a kind of value. The modesties are positively prim, buttoned up, modest, flirty, revealing and downright immodest. Every woman has a modesty. Alice is positively prim. Beth is downright immodest. Gemma is modest. Delia is flirty. Eliza is revealing.

We could then rewrite the service rule like so:

Every turn when the number of entries in the deli queue is not 0 and a random chance of 1 in 3 succeeds (this is the customer being served rule):
   let Pete's preference be the deli queue;
   sort Pete's preference in reverse modesty order;
   let the customer be entry 1 of Pete's preference;
   let the first in line be entry 1 of the deli queue;
   if the player is in the Delicatessen, say "[if the customer is the first in line]Pete gives a droopy expression as he serves [the customer], who nevertheless brightens and leaves.[otherwise]Outrageously, Pete scans the queue, notices [the customer] in her [modesty of the customer] clothes, and serves her next, while [the first in line] glares at him.";
   if the player is in the Supermarket, say "[The customer] emerges cheerfully from the Delicatessen Counter, and goes about her regular shopping.";
   now the customer is in the Supermarket;
   remove the customer from the deli queue.

It is now heartbreakingly difficult for Alice to obtain her sliced chorizo sausage.

wi 21.11 Variations: arrays, logs, queues, stacks, sets, sieves and rings
rb 7.16 Social Groups

176. Strictly Ballroom ★★

Many simple repetitions can effectively be done with a "now…" instruction: it is quicker to say

now every person is angry

than

repeat with offended party running through people:
   now the offended party is angry.

Repeat comes in handy when we have something a bit more complicated to do with each item:

"Strictly Ballroom"

A person can be alert or occupied. A person is usually alert.

When play begins:

now the player is occupied.

Dance is a kind of value. The dances are waltzes, polkas, cha-chas, charlestons, fox-trots, tangos, lambadas, and two-steps.

The current round is a dance that varies.

Manner is a kind of value. The manners are swiftly, primly, energetically, suavely, seductively, elegantly, and badly.

Every turn: now the current round is a random dance.

Every turn:

repeat with dancer running through people who are not the player:

if dancer is alert:

now dancer is occupied;

let partner be a random alert person who is not the dancer;

if partner is a person:

now partner is occupied;

say "[The dancer] [the current round][if a random chance of 1 in 5 succeeds] [a random manner][end if] with [partner]. ";

otherwise:

say "[paragraph break][The dancer] is forced to be a wallflower. Poor [dancer]. ";

say paragraph break.

Notice we did not say "repeat with dancer running through alert people who are not the player…". This is because Inform would draw up a list of alert people at the beginning of the repeat, and not take into account which people became occupied partway through the repetition. If we want to make sure that each person dances only with one other person, we have to continue checking alertness each time we run through the repetition.

After all the partners are assigned, we can set up for the next turn by making everyone alert again, and for this we do not need "repeat":

Every turn: now every person is alert; now the player is occupied.
 
Before doing something to someone: now the noun is occupied.
 
Before doing something when the second noun is a person: now the second noun is occupied.
 
Instead of doing something to someone: say "You successfully distract [the noun]."
 
The Pacific Ballroom is a room. "A rather utilitarian space at the moment, since this is a class and not a party." Timmy, Tommy, Joey, George, Mary, Martha, Yvette, McQueen, Linus, and Patricia are people in the Pacific Ballroom.
 
Test me with "z / ask linus about blanket / z / z".

wi 11.11 Repeat running through
rb 7.16 Social Groups

353. Emma ★★

To start with, let's understand "room" to mean "a group of people talking". These groups can grow and shrink as people come and go, so we'll want to name and rename them; and we're also going to need some rules to motivate people moving around, and a description to narrate how they behave when we're with them.

"Emma"

by the banquet table is a room. at the corner is a room. next to the doorway is a room. by the window is a room.

Social clump is a kind of value. The social clumps are vacancy, lone person, couple, cluster, group.

A room has a social clump. Understand the social clump property as describing a room.

Before printing the name of a room:

say "a [social clump] ".

After looking:

assign clumping;

say "Elsewhere in the room, you can see [the list of rooms which are not the location]."

Understand "go to [any room]" as joining. Joining is an action applying to one visible thing. Carry out joining: move player to the noun. Report joining: do nothing.

Understand "examine [any room]" as looking toward. Looking toward is an action applying to one visible thing. Carry out looking toward a room: say "In that direction you see [a list of other people in the noun]."

When play begins: assign clumping. Every turn: assign clumping.

To assign clumping:

repeat with space running through rooms:

now the social clump of the space is vacancy;

if the space contains exactly 1 person, now the social clump of the space is Lone person;

if the space contains exactly 2 people, now the social clump of the space is Couple;

if the space contains more than 2 people and the space contains fewer than 5 people, now the social clump of the space is cluster;

if the space contains more than 4 people, now the social clump of the space is group.

The room description heading rule is not listed in the carry out looking rules.

A person has a number called longevity. The longevity of a person is usually 0. A person can be active or passive.

Definition: a person is other if it is not the player.

Every turn:

repeat with mover running through other people:

now the mover is active;

increment the longevity of mover;

if longevity of mover is greater than 3 or the mover is bored:

assign value of spaces for the mover;

let destination be the nicest room;

if the destination is not the location of the mover:

if the player can see the mover, say "[The mover] makes excuses and drifts off to join [the destination].[paragraph break]";

move the mover to the destination;

now the mover is complacent;

now the longevity of the mover is 0;

if the player can see the mover, say "[The mover] wanders over.[paragraph break]";

assign clumping;

now mover is passive.

A room has a number called attractiveness.

Definition: a room is nice if its attractiveness is 1 or more.

To assign value of spaces for (mover - a person):

repeat with space running through rooms:

now attractiveness of the space is 0;

repeat with figure running through people in the space:

if the mover is bored, decrease attractiveness of the space by 2;

if the mover likes the figure, increment attractiveness of the space;

if the mover dislikes the figure, decrement attractiveness of the space;

if the mover desires the figure, increase attractiveness of the space by 2.

Liking relates various people to various people. The verb to like means the liking relation.

Disliking relates various people to various people. The verb to dislike means the disliking relation.

Attraction relates various people to various people. The verb to desire means the attraction relation.

Mr Weston, Mr Woodhouse, Mr Elton, Mr Knightley, and Frank Churchill are men. Mrs Weston, Mrs Bates, Miss Bates, Harriet Smith, Emma Woodhouse, and Jane Fairfax are women.

Harriet Smith likes Mr Elton. Harriet Smith desires Mr Elton. Harriet Smith likes Emma Woodhouse.

Mr Elton desires Emma Woodhouse.

Emma Woodhouse likes Harriet Smith and Mr Knightley. Emma Woodhouse dislikes Jane Fairfax.

Mr Knightley likes Emma Woodhouse, Mr Weston, and Mrs Weston. Mr Knightley desires Emma Woodhouse.

Jane Fairfax desires Frank Churchill. Jane Fairfax likes Frank Churchill.

Frank Churchill desires Jane Fairfax and Emma Woodhouse. Frank Churchill likes Jane Fairfax.

Miss Bates likes Jane Fairfax, Emma Woodhouse, and Mrs Bates.

Mr Weston likes Frank Churchill, Emma, Knightley, and Mrs Weston.

Mrs Weston likes Frank Churchill, Emma, Knightley, and Mr Weston.

Mrs Bates likes Miss Bates.

A person can be complacent or bored.

When play begins:

repeat with character running through other people:

let space be a random room;

move character to space.

And now we use writing a paragraph about… to describe character behavior in groups, when we join them:

Rule for writing a paragraph about Frank Churchill:
   if the location contains a woman (called flirt) who is desired by Frank:
      say "[Frank Churchill] is talking with great animation and slightly more than becoming warmth to [the flirt][if an unmentioned other person is in the location], while [the list of unmentioned other people in the location] look on with varying degrees of amusement or irritation[end if].";
      repeat with character running through people in the location:
         if the character is not Churchill and the character is not the flirt, now the character is bored.
 
Rule for writing a paragraph about Mr Elton:
   if the location contains an unmentioned woman (called flirt) who is desired by Elton:
      say "[Mr Elton] hangs on the sleeve of [the flirt], offering an assortment of studied gallantries that make you wonder about his good sense.";
      repeat with character running through people in the location:
         if the character is not Elton and the character is not the flirt, now the character is bored.
 
Rule for writing a paragraph about Harriet Smith:
   if the location contains Emma and Emma is unmentioned:
      say "[Harriet] and [Emma] are conversing in low tones -- Harriet, apparently, being too shy to speak so that everyone can hear her."
 
Rule for writing a paragraph about Mr Knightley:
   if the location contains an unmentioned man (called the listener) who is not Mr Knightley:
      say "[Mr Knightley] is speaking with [the listener] about agricultural matters.";
      now the listener is complacent.
 
Rule for writing a paragraph about Miss Bates:
   say "[Miss Bates] is giggling about the weather[if an unmentioned other person is in the location]. This does not seem to compel the interest of [the list of unmentioned other people in the location][end if].";
   repeat with character running through people in the location:
      if the character is not Miss Bates and character is not Mrs Bates, now the character is bored.

Since this is just an example, we'll stop here, but there's no reason we couldn't write such paragraphs for everyone.

Test me with "z / z / z / look / x corner / x doorway / x window / x table / go to the table".

wi 18.24 Writing a paragraph about
rb 7.16 Social Groups

356. Happy Hour ★★

Often it is best to have an entire paragraph about the characters present in a room, but suppose we're narrating a large party with a lot of people moving around. In that case, it might be better to list everyone together, then add a few salient details by way of follow-up, like this:

"Happy Hour"

Before listing nondescript items:

say "You can see [a list of people who are marked for listing] here. ";

repeat with named party running through people:

now the named party is not marked for listing;

let count be the number of visible other people who are carrying something;

if count is 0:

say paragraph break;

continue the action;

let index be count;

repeat with holder running through visible other people who are carrying something:

if index is count, say "[The holder]";

otherwise say "[the holder]";

say " has [a list of things carried by the holder]";

decrement index;

make delimiter index of count.

The next part could be simpler, but for rigor we will write it in such a way that it will work whether or not the serial comma is in use. This requires some extra work.

To make delimiter (index - a number) of (count - a number), continuing or halting:
   if index is 0:
      if continuing, say ". [run paragraph on]";
      otherwise say ".";
   otherwise if index is 1:
      if count is 2, say " and ";
      otherwise say "[optional comma] and ";
   otherwise:
      say ", ".
 
To say optional comma:
   if the serial comma option is active:
      say ",".

And now the scene:

The Banquet Hall is a room. "A large cheery banner over the door (which, incidentally, vanishes when you approach it) reads: HELLO NEW INDUCTEES! WELCOME TO THE AFTERLIFE!"
 
Fred, George, and Larry are men in the Banquet Hall. Fred carries a dry martini. Larry carries a cream puff. Matilda and Louise are women in the Banquet Hall.
 
Definition: a person is other if it is not the player.
 
Every turn:
   let wanderer be a random other person;
   let place be the holder of the wanderer;
   let next place be a random room adjacent to the place;
   let the way be the best route from the place to the next place;
   try the wanderer going the way.
 
The Kitchen is west of the Banquet Hall. "Dominated by a pile of dirty plates which you imagine it will be someone's privilege to wash, later." Vanessa is a woman in the Kitchen. Vanessa carries a tray. On the tray is a salmon roll. The roll is edible.
 
Test me with "z / look / g / g / g ".

wi 18.25 Listing nondescript items of something
rb 7.16 Social Groups

§8.

Bicycles, Cars and Boats

§8.

Ships, Trains and Elevators

§8.

§8.

§8.

RB §8.1 Bicycles, Cars and Boats

The vehicle kind in Inform refers to an object which can carry at least one person, but is small enough to fit into a single location:

In the Garden is a vehicle called the motor mower.

We can then apply different rules to a player going somewhere on foot or in the vehicle. Peugeot ★ (a bicycle) is an easy example; No Relation ★ (a car) adds an ignition switch to the vehicle; Straw Boater ★★ (a motorboat) gets around areas of lake where travel on foot is not just slower but impossible.

Hover ★★★ (a sci-fi "hover-bubble") changes the appearance of the landscape when it is seen from inside the vehicle.

Examples

27. Peugeot ★

Let's say that our protagonist is about to flee . Obviously, he can't make the journey on foot; he needs transportation.

"Peugeot"

Include Rideable Vehicles by Graham Nelson.

The Lot is a room. The ten-speed bike is a rideable vehicle in the Lot.

We make the ten-speed bike a rideable vehicle because we want to say that the player is on it rather than in it. Then our other room:

Cambridge is east of the Lot.

And now we borrow from the Actions chapter to prevent travel without the proper equipment:

Instead of going to Cambridge when the player is not on the ten-speed bike:
   say "It's a long journey to Cambridge: you'll never make it on foot."
 
After going to Cambridge:
   say "You begin pedalling determinedly.";
   continue the action.
 
Test me with "e / get on ten-speed bike / e".

wi 3.16 Vehicles and pushable things
rb 8.1 Bicycles, Cars and Boats

104. No Relation ★

We need to designate certain rooms as roads. Since the status of being a road will not change during play, we do this with a kind:

"No Relation"

A road is a kind of room. Definition: a room is offroad if it is not a road.

Instead of going by a vehicle (called the auto) to somewhere offroad:

say "You can't drive [the auto] off-road."

Trafalgar Square is a road. "The Square is overlooked by a pillared statue of Admiral Lord Horatio Nelson (no relation), naval hero and convenience to pigeons since 1812."

The National Gallery is north of Trafalgar Square. The Strand is east of Trafalgar Square. The Strand is a road.

The car is a vehicle in Trafalgar Square. The ignition is a device. The ignition is part of the car. Instead of going by the car when the ignition is switched off: say "The ignition is off at the moment." Instead of switching on the car, try switching on the ignition. Instead of switching off the car, try switching off the ignition.

Test me with "get in car / n / e / turn on car / n / e / get out / w / n / s / e / get in car / turn off car / w / turn on ignition / w".

(In the course of the writing of Inform 7, much of Trafalgar Square was pedestrianised, making this example already out of date.)

A further technical note: notice "going by a vehicle" in the above rule, rather than "going by something". A rule such as "Instead of going by something…" will be matched whenever the player tries to go some direction while in an enterable object, whether or not that object is actually capable of movement. This is sometimes useful, but in this case we want the warning to apply only when the player is in a vehicle; if we added Trafalgar Square's statue bases to the scenario, we would not want

You can't drive the pedestal off-road.

So we restrict the rule to "Instead of going by a vehicle…"

wi 7.14 Going by, going through, going with
rb 8.1 Bicycles, Cars and Boats

49. Straw Boater ★★

Sometimes we like to give properties to kinds of thing, but not fill them in in all cases. For instance, we might have vehicles that optionally make noise, and those might have a "movement sound".

All properties have a default value, which we can find by looking in the Kinds tab of the index. This is what the property will be set to automatically, if we do not change it ourselves. In the case of a text property, that is ""; so for instance we might use our movement sound thus:

"Straw Boater"

Boathouse is a room. "A boathouse circa 1915, which -- though in poor repair -- still suggests Sunday afternoon jaunts taken by women in white gowns and men in straw hats."

North of the Boathouse is the Shallow Water. The description of Shallow Water is "Just south is the boathouse, and beyond it are trees and the marble terrace of the house above. The water deepens to the north."

North of Shallow Water is Deep Water. The description of Deep Water is "From here the boathouse has dwindled invisibly to the south, and you have a broad panorama of the shoreline, all the way down to the Skeleton Point Lighthouse in the southeast."

A vehicle has some text called the movement sound. The sailboat and the motorboat are vehicles in the Boathouse. The movement sound of the motorboat is "VRRRROOOMMMM..." Understand "boat" as the sailboat. Understand "boat" as the motorboat.

Note that we haven't given the sailboat any movement sound at all.

After going somewhere by a vehicle (called cart):
   if the movement sound of the cart is not "", say "[the movement sound of the cart][paragraph break]";
   continue the action.
 
Instead of exiting when the player is in a vehicle and the location is not the Boathouse:
   say "You're not dressed for a swim."
 
Instead of going somewhere when the player is not in a vehicle:
   say "You'd rather not try to make this journey by swimming alone."
 
Test me with "n / get in sailboat / n / get out / s / get in motorboat / n / n".

wi 4.8 New value properties
rb 8.1 Bicycles, Cars and Boats

29. Hover ★★★

Suppose we want the player to see a modified room description when he's viewing the place from inside a vehicle. There are several conceivable ways of doing this; the example here shows a rather advanced way, but is very flexible and will let us write all sorts of special cases.

"Hover"

Use full-length room descriptions.

Emerald City is a room. "All the buildings are spires and none of them have doors." The Vast Desert is west of Emerald City. "[if the player is in a vehicle]Outside, a[otherwise]A[end if] trackless waste stretches as far as the eye can see in every direction."

The hover-bubble is a vehicle in the Emerald City. "Your hover-bubble awaits." The description is "The hover-bubble is a clear globe-shaped vehicle capable of transporting you anywhere you could walk, but faster." Understand "bubble" as the hover-bubble. The hover-bubble contains a chocolate wrapper and a parking ticket.

Here's the tricky part, which relies on material from the chapters on Activities and Rulebooks:

The container interior rule is listed before the room description body text rule in the carry out looking rules.
 
This is the container interior rule:
   if the actor is the player and the player is in an enterable thing (called current cage), carry out the describing the interior activity with the current cage.
 
Describing the interior of something is an activity.

Now we've done that, we can write a "rule for describing the interior" of something, which will print whatever we like:

Rule for describing the interior of the hover-bubble:
   say "The hover-bubble is transparent, but tints everything outside very faintly lavender."

In fact, as a special refinement, we could even say:

Rule for describing the interior of the hover-bubble when the hover-bubble contains more than one thing:
   say "The hover-bubble is transparent, but tints everything outside very faintly lavender. Beside you you can see [a list of other things in the hover-bubble]."
 
Definition: a thing is other if it is not the player.
 
Rule for listing nondescript items of the hover-bubble when the player is in the hover-bubble: do nothing.
 
Test me with "get in bubble / look / west / take all / look / get out / east".

And now anything that's beside us in the vehicle will be described during that first paragraph, rather than later on.

wi 3.16 Vehicles and pushable things
rb 8.1 Bicycles, Cars and Boats

🔗

RB §8.2 Ships, Trains and Elevators

This section covers vehicles whose interior consists of at least one entire room. Moving into this room constitutes boarding: there is then some pause while it travels: moving out again disembarks at a different location. The only complication arising is how the player controls the journey (by talking to someone? by pressing buttons? by steering?).

The Unbuttoned Elevator Affair ★ provides the simplest possible whole-room vehicle, which ferries between two fixed points. If you are at one of these, it must be the other one you want to get to, so there is no need for controls.

Dubai ★★★ is a much more elaborate elevator, with many possible destinations, chosen using buttons inside the elevator.

Empire ★★ simulates a train journey. Here there are no controls as such, but the train passes through a sequence of stops spaced apart in time, so the player chooses an exit by getting out at the right moment.

On a very large, slowish craft such as a cruise liner, we are not so much travelling in a vehicle: it's more as if we are visiting a whole building, which becomes our world for the (probably long) duration of the journey. The liner steers around in long, slow curves, changing its orientation in the water, so that (if we think of "north" as a strictly magnetic matter, anyway) north is constantly rotating: something we don't notice on board because our own reference points, provided by the ship itself, stay fixed relative to ourselves. Because of this, some ships in IF are navigated using FORE, AFT, PORT and STARBOARD directions rather than NORTH, EAST, SOUTH and WEST: see Fore ★★★.

Examples

9. The Unbuttoned Elevator Affair ★

This is very simple. The interior of the elevator is a single room, but which is mapped east of both of its termini. The reverse map connection, west from the elevator, can only go to a single room, and that's what determines which floor the elevator is on.

"The Unbuttoned Elevator Affair"

UNCLE Headquarters is a room. "The steel nerve-center of the free world's battle against the Technological Hierarchy for the Removal of Undesirables and the Subjugation of Humanity. Being against technology, we have only a very simple elevator to the east."

Del Floria's Tailor Shop is a room. "Only trained anti-THRUSH agents recognise the booth in the east wall as a secret elevator."

The Secret Elevator is east of UNCLE Headquarters. The Secret Elevator is east of Del Floria's Tailor Shop.

After going to the Secret Elevator:

say "The doors automatically close, there is a rush of motion, and they open again.";

if UNCLE Headquarters is mapped west of the Secret Elevator, now Del Floria's Tailor Shop is mapped west of the Secret Elevator;

otherwise now UNCLE Headquarters is mapped west of the Secret Elevator;

continue the action.

Test me with "east / west / east / west".

wi 3.3 One-way connections
rb 8.2 Ships, Trains and Elevators

145. Empire ★★

Suppose we want to have a train which, at fixed times, arrives at and leaves stations. It should be possible for the player to get on and off the train when it is stopped, but not while the train is in motion.

"Empire"

The Empire Builder Train is a room. The Train has a room called the station. The station of the Train is Seattle.

The description of the Empire Builder is "One of the (relatively) plush long-distance Amtrak trains. You're in a two-story car with toilets and a cafe at one end, not having sprung for a sleeper.

[if the station of the Train is the train]Outside the window there is rapidly-passing countryside.[otherwise]Through the windows you can see the [station of the Train] train station.[end if]"

Instead of exiting when the player is in the Train:

if the station of the Train is the Train:

say "The train is not stopped at a station." instead;

otherwise:

move the player to the station of the train instead.

Before going outside when the player is in the Train:

try exiting instead.

Before going inside when the player is in the station of the Train:

move the player to the Train instead.

Seattle, Edmonds, Everett, Wenatchee, and Spokane are rooms. The description of a room is usually "The scenic train station of [the location][if the location is the station of the train].

The pompously-titled Empire Builder train is pulled up here, soon to continue its journey towards Chicago[end if]."

And now our schedule for the train -- somewhat truncated, admittedly, since the full three-day journey from Seattle to Chicago is a bit long even for an ambitious example.

At 4:45 PM:
   if the player is in the train or the player is in the station of the train, say "The train pulls out of [the station of the Train]!";
   now the station of the Train is the Train.
 
At 5:10 PM:
   now the station of the Train is Edmonds;
   if the player is in the train or the player is in the station of the train, say "The train pulls into Edmonds and comes to a stop."
 
At 5:17 PM:
   if the player is in the train or the player is in the station of the train, say "The train pulls out of [the station of the Train], running north along the shore towards Everett.";
   now the station of the Train is the Train.
 
At 5:39 PM:
   now the station of the Train is Everett;
   if the player is in the train or the player is in the station of the train, say "The train arrives in scenic Everett, WA: the last stop before it turns east and heads over the mountains."
 
At 5:44 PM:
   if the player is in the train or the player is in the station of the train, say "The train pulls out of [the station of the Train] and turns east.";
   now the station of the Train is the Train.
 
At 8:39 PM:
   if the player is in the train or the player is in the station of the train, say "In darkness the train rolls into Wenatchee; which is just fine, considering that there is nothing to see here at all.";
   now the station of the Train is Wenatchee.
 
At 8:44 PM:
   if the player is in the train or the player is in the station of the train, say "The train pulls out of [the station of the Train] and continues east through the darkness towards Spokane.";
   now the station of the Train is the Train.

Playing this out would of course require near inhuman patience. Let's set things up so that the player at least doesn't have to wait too long for his first departure:

The time of day is 4:43 PM.

…and provide fair warning of how slowly time is elapsing.

When play begins:
   now the right hand status line is "[time of day]".
 
Test me with "out / in / z/ z / z / out / z / z / z / z / z / z / z / z / z / z / z / z / z / z / z / z / z / z / z / z / z / z / z / out / in / out / z / z".
 
Test more with "out / z/ z / z  / z / z / z / z / z / z / z / z / z / z / z / z / z / z / z / z / z / z / z / z / z / z / z / z / z".

wi 9.11 Future events
rb 8.2 Ships, Trains and Elevators

42. Fore ★★★

Suppose we want to understand shipboard directions, but only when the player is aboard a vessel.

"Fore"

Section 1 - Procedure

The starboard is a direction. The starboard has opposite port. Understand "s" as starboard when the location is nautical.

The port is a direction. The port has opposite starboard. Understand "p" as port when the location is nautical.

The fore is a direction. The fore has opposite aft. Understand "f" as fore when the location is nautical.

The aft is a direction. The aft has opposite fore. Understand "a" as aft when the location is nautical.

Does the player mean going a nautical direction when the location is nautical: it is very likely.

Index map with fore mapped as north. Index map with aft mapped as south. Index map with port mapped as west. Index map with starboard mapped as east.

And we can even add new ways to talk about the ways things are mapped, borrowing from the Relations chapter. The following will allow us to use "is abaft of" as well as "is aft of":

[The verb to be abaft of means the mapping aft relation.]

Now, to prevent the player from using NORTH onboard ship, or AFT on land:

A room can be nautical or earthbound. A room is usually not nautical. A direction can be nautical or earthbound. A direction is usually not nautical. Starboard, port, fore, aft, up, down, the inside and the outside are nautical.
 
Before going a nautical direction when the location is not nautical, say "Nautical directions can only be used on board ship."
 
Before going an earthbound direction when the location is nautical, say "Compass directions make no sense on board ship, but you can use [list of nautical directions] instead." instead.
 
Section 2 - Scenario
 
The Fish Room is aft of the Spirit Room. Starboard of the Fish Room is the After Powder Magazine. The Bread Room is aft of the After Powder Magazine.
 
The Fish Room, the Spirit Room, the Bread Room, and the After Powder Magazine are nautical.
 
The description of the Fish Room is "Absurd quantities of salt fish are kept here, and periodically visited by the cook or someone serving him. It is otherwise an unexceptional little chamber, so far below the waterline that there are no portholes and no external light of any kind. [paragraph break]A narrow doorway leads forward into the Spirit Room, and the After Powder Magazine is starboard."
 
The description of the Spirit Room is "Despite its ghostly name, this is little more than a closet down at the very navel of the ship, in which alcohol is kept: both for purifying wounds and for drinking. Under normal circumstances there is a guard posted here at every hour, lest anyone take to raiding the larder. The current absence of the guard marine strikes you as a very bad sign indeed. [paragraph break]The only way out is aft."
 
The description of the Bread Room is "The Bread Room is not only tiny from side to side and front to back: it is also about half the height of a proper room, and the floor slopes up very steeply with the curve of the hull. [paragraph break]What is kept here would not, on land, be dignified by the name of bread: it's hard tack, punishing to the teeth, dry on the tongue, and usually a home to weevils before half the journey is done. [paragraph break]More headroom, and access to the rest of the ship, lies fore through the After Powder Magazine."
 
The description of the After Powder Magazine is "Kept in near darkness because no one with any sense would bring a naked flame down here: when necessary, it can be lit with a single small lantern made of very thick glass and sealed to keep the sparks within. Sacks of powder are passed up into the higher levels of the ship by the scrubby little boys called 'powder monkeys' -- but none such are here now."
 
Test me with "north / aft / fore".

wi 3.26 Directions
rb 8.2 Ships, Trains and Elevators

271. Dubai ★★★

The problem of implementing an elevator that opens onto a large number of floors often challenges novice interactive fiction authors. It also raises a fundamental design problem -- how to implement a large building in an interesting way. It is tempting to write a hotel with an elevator and innumerable tedious and identical floors just for the sake of realism; in many cases it is a better idea simply to omit any locations that contribute nothing to the story or the play of the game.

In charity, though, let us assume that the author has a legitimate reason for wanting to implement an elevator that opens onto some generic floors. We will go whole-hog, and set this in the world's tallest hotel: Burj al-Arab, Dubai.

"Dubai"

The Burj al-Arab Lobby is a room. "The 202-suite Burj al-Arab - or Tower of the Arabs - stands 321 metres (1,060 feet) high, and floats on its own man-made island. It is shaped like the sail of a boat; just crossing the private bridge to reach this place set you back $55."

(Since our budget did not run to visiting Burj al-Arab, the descriptions place implicit faith in the hotel's website.)

The Assawan Spa is a room. "Treatment rooms, hydrotherapy baths, oriental massage, stand-up solarium, sauna, steam rooms and jacuzzi, two swimming pools, squash court, two fully equipped fitness studios and an aerobics floor. To the south is a shopping area, for those who do not find exercise adequately therapeutic."
 
The Shopping Area is south of Assawan Spa. "In a setting that would make a poet sigh, you may enjoy the services of (among others) Bulgari, Black Pearl Caviar, Albarajeel Carpet Shop, Abdul Samed Al Qurashi (amber and Arabic perfumes), Dianoor (jewellery), and the Commercial Bank of Dubai."
 
The Al Falak Ballroom is a room. "A palatial, two-tiered, domed ballroom crowned with a unique crystal chandelier."
 
Sahn Eddar is a room. "At the base of the world's tallest atrium, the Sahn Eddar restaurant offers light fine fare and Afternoon Tea. At the center, a 32-meter water column leaps toward the roof of the atrium."
 
Al Mahara is a room. "After the elevator, you must take a three-minute virtual submarine voyage to reach this seafood restaurant. A magnificent oval aquarium, full of sharks, is visible from every table."
 
Al Iwan is a room. "Middle-eastern food in an environment of dramatic black, red, and gold."
 
Al Muntaha is a room. "A top-floor restaurant with a magnificent view: the name means the ultimate or the highest, suitable for a place that stands at 200 metres above the Arabian Gulf. It offers modern European cuisine; and just off to the south is the Skyview Bar."
 
The Skyview Bar is south of Al Muntaha. "'A wonderful location for pre- and post dinner drinks,' claims the hotel's brochure, and certainly you can't fault the view."
 
The Juna Lounge is a room. "Two humidors that offer one of the largest selections of the finest Havana cigars in Dubai."
 
The Lift is a room. "This is not a mere elevator: it is an express panoramic lift, traveling six meters a second, and capable of taking you from lobby to the rooftop restaurant in an astonishingly short time. The illuminated number above the door says [current level of the Lift] - though you can make it move by pressing a numbered button."
 
The Presidential Suite is a room. "Astonishingly, this is not the most elaborate or expensive of suites; there is another, the Royal, upstairs of here."
 
The Royal Suite is a room. "The brochure described this as 'the last word in luxury,' and you have to admit that it is certainly the last word in [italic type]something[roman type]. A vast carpet of patterned red and gold stretches from you to the sofa; beyond which, in the distance, you make out several bedrooms and bathrooms outfitted in Carrera marble. There is also, of course, a private cinema."
 
Table of Floors

levelfloor
0Al Mahara
1Burj al-Arab Lobby
2Al Iwan
3Juna Lounge
4Sahn Eddar
15Al Falak Ballroom
18Assawan Spa
24Presidential Suite
25Royal Suite
27Al Muntaha
 
The elevator exterior is a backdrop. It is not scenery. The initial appearance of the elevator exterior is "You can enter the elevator here." It is in Generic Floor, Al Mahara, the Lobby, Al Iwan, Juna Lounge, Sahn Eddar, Al Falak, Assawan Spa, Presidential Suite, Royal Suite, and Al Muntaha.
 
Before entering the elevator exterior, try going inside instead.
 
Instead of going inside in the presence of the elevator exterior:
   if there is a level corresponding to a floor of the location in the Table of Floors:
      let the present level be the level corresponding to a floor of the location in the Table of Floors;
      now the current level of the Lift is the present level;
   otherwise:
      now the current level of the Lift is the current level of Generic Floor;
   move the player to the Lift.
 
The Lift has a number called current level. The current level of the Lift is 1. Instead of going up in the Lift: say "You'll have to select a specific floor; your options range from 0 to 27." Instead of going down in the Lift: try going up instead. The Lobby is outside from the Lift.
 
Before going outside in the Lift:
   if there is a floor corresponding to a level of the current level of the Lift in the Table of Floors:
      let the other place be the floor corresponding to a level of the current level of the Lift in the Table of Floors;
      move the player to the other place instead;
   otherwise:
      now the current level of the Generic Floor is the current level of the Lift;
      move the player to the Generic Floor instead.
 
The Generic Floor is a room. The Generic Floor has a number called current level. The printed name of the Generic Floor is "Floor [current level of the Generic Floor]". "A long hallway between suites, some of which run up to $15,000 a night."
 
Understand "push [number]" as pressing button. Understand "push [number] button" as pressing button. Understand "push button [number]" as pressing button. Pressing button is an action applying to one number.
 
Check pressing button:
   if the player is not in the Lift, say "You cannot control the express panoramic lift unless you are yourself inside." instead;
   if the number understood is the current level of the Lift, say "The lift pings politely and reopens its doors, since you are already on floor [number understood]." instead;
   if the number understood is greater than 27, say "There are only 27 floors." instead;
   if the number understood is less than 0, say "You cannot go below the ground floor in this elevator." instead.
 
Carry out pressing button:
   now the current level of the Lift is the number understood;
   say "You press button [the number understood]. The lift whirs into action and moves to the correct level."
 
Test me with "press 3 / in / press button 3 / look / out / in / press 27 / out / s / in / n / in / press 15 / out / in / press 18 / out / s / in / n / in / press 4 button / out".

This will all work very well, unless the player has portable objects; in that case, anything he drops on the Generic Floor will be there every time he goes back -- whether it's masquerading as Floor 6 or Floor 23. There are there are two ways round this -- (i) the cheeky way. When we drop something, the unobtrusive yet ever-vigilant maids pick it up and take it down to the Foyer's lost property office; and (ii) the super-duper way, in which things are moved out of play but with their floor numbers remembered, so that the scenario can be reconstructed each time. (i) is probably in fact the more true-to-life, considering the hotel's boasts about its service, but we will demonstrate both methods.

Here is the version with vigilant maids:

The player carries a shopping bag. In the bag are a diamond necklace, a small rug, and a jar of caviar.

Carry out pressing button:

now every portable thing enclosed by the Generic Floor is in the Office.

The Office is south of the Lobby. "Here the maids collect everything abandoned by careless guests." The printed name of the Office is "Lost and Found Office".

Test maids with "in / press 6 / out / drop all / in / out / in / press 23 / out / in / press 1 / out / s / get all".

Notice that we tie the maid service to the pressing of the lift button, so that if the player just goes into the lift and comes out again, the maids will not have had a chance to clear his possessions.

Alternatively:

The player carries a shopping bag. In the bag are an evening gown, a bolero jacket, and tickets to the Wild Wadi Animal Park.

Carry out pressing button when something is in the Generic Floor:

repeat with item running through portable things in the Generic Floor:

clear the item;

repeat with item running through portable things enclosed by the Generic Floor:

clear the item.

The "enclosed by" line clears even things left on, say, small un-portable side-tables or whatever; but because we do "in" first, we make sure to move any containers or supporters undisturbed. The next bit could be more tidily incorporated into our previous "before going outside" rule, but since we are writing this code to be optionally pasted onto the end of the first bit, we'll express the rule separately:

Before going outside in the Lift when something is in Limbo:
   unless there is a floor corresponding to a level of the current level of the Lift in the Table of Floors:
      repeat with item running through things in Limbo:
         if the current level of the item is the current level of the Lift, move the item to the Generic Floor.
 
A thing has a number called current level.
 
To clear (item - a thing):
   now the current level of the item is the current level of the Lift;
   move item to Limbo.
 
Limbo is a room.
 
Test management with "get all from bag / in / press 22 / out / drop tickets / in / press 23 / out / drop gown / in / press 22 / out / get tickets / in / press 23 / out / get gown".

And now we have a situation in which the player's valuables are left untouched wherever in the hotel he happens to abandon them.

Incidentally, this example was almost set in an entirely different location: the largest hotel in the world may some day be the Ryugyong Hotel in Pyongyang, North Korea, with its 105 floors -- but for some years construction halted at the creation of the building's huge concrete shell.

wi 16.3 Corresponding entries
rb 8.2 Ships, Trains and Elevators

🔗

RB §8.3 Animals

Animals exhibit a wide range of behaviour: much of the chapter on Other Characters applies just as well to animals as to human beings, with the exception of the material on conversation. But two examples here, both fairly simple, show how a fairly convincing domestic pet can be achieved simply by reacting to certain events going on nearby: Feline Behavior ★ (a cat) and Today Tomorrow ★★ (a dog).

Fido ★ provides a dog which the player can re-name at will.

For animals that we can sit on and ride - a camel or a horse, say - we may want to use the Rideable Vehicles extension by Graham Nelson, which also provides a rideable animal kind.

Examples

405. Feline Behavior ★

Suppose we have a cat which is supposed to react to (and destroy) the most interesting thing in its environment. There are several ways we could approach this problem, but for the sake of demonstration, let's have it follow a rulebook to figure out which thing it most wants to interact with. We will then return the chosen object as "the object produced by the cat behavior rules".

"Feline Behavior"

The Kitchen is a room. The cat is an animal in the Kitchen. In the Kitchen is a bowl, a ball of wool, a newspaper. The bowl contains a quantity of cream.

The cat is wearing a silver collar. The description of the cat is "It is wearing [a list of things worn by the cat]."

The player carries a closed openable container called a bag. The bag contains catnip.

The cat behavior rules is a rulebook producing an object.

A cat behavior rule when the cat can touch the catnip:

say "The cat frolics with the catnip until nothing remains of it.";

rule succeeds with result catnip.

A cat behavior rule when the cat can touch the cream:

say "The cat laps up the cream.";

rule succeeds with result cream.

A cat behavior rule when the cat can touch the ball of wool:

say "The cat makes the ball of wool into a useless tangle which must be discarded.";

rule succeeds with result ball.

A cat behavior rule when the cat can touch the newspaper:

say "The cat bats playfully at the newspaper until all the nasty boring articles are destroyed.";

rule succeeds with result newspaper.

A cat behavior rule:

say "The cat looks miffed at the lack of ready entertainment, and glares at you with yellow eyes as though wondering whether your pants leg is good for claw-sharpening.";

rule fails.

Every turn:

let the destroyed object be the object produced by the cat behavior rules;

if the destroyed object is not nothing:

now the destroyed object is nowhere;

say "[line break]Good thing you have no use for [the destroyed object] yourself.[paragraph break]".

Test me with "z / z / open bag / z / z".

We include the if rule succeeded… condition here because nothing will be returned if the cat's search failed (as for instance in the result of the final rule).

Naturally, if we wanted we could equally well ask "if rule failed…".

wi 19.13 Rulebooks producing values
rb 8.3 Animals

419. Fido ★

Suppose we'd like to have a dog which the player is allowed to name himself. We'd like to deal correctly with both

>name the dog fido

and

>name the dog "fido"

so we'll also need to strip quotation marks out of the command. We can do this as follows:

"Fido"

The Back Yard is a room.

A dog is an animal in Back Yard. The dog has some text called the nickname. The nickname of the dog is "nothing". Understand the nickname property as describing the dog.

Rule for printing the name of the dog when the nickname of the dog is not "nothing":

say "[nickname of the dog]"

Naming it with is an action applying to one thing and one topic. Understand "name [something] [text]" as naming it with. Check naming it with: say "You can't name that."

Instead of naming the dog with "nothing":

now the nickname of the dog is "nothing";

now the dog is improper-named;

say "You revoke your choice of dog-name."

Instead of naming the dog with something:

let N be "[the topic understood]";

replace the text "'" in N with "";

now the nickname of the dog is "[N]";

now the dog is proper-named;

say "The dog is now known as [nickname of the dog]."

Test me with "name the dog Fido / name the dog Lawrence / look / x lawrence / name Lawrence nothing / look / x lawrence".

wi 20.8 Replacements
rb 8.3 Animals

99. Today Tomorrow ★★

Rules about concealment will affect "in the presence of", too. For instance, suppose we have a man with a pocket pet:

"Today Tomorrow"

The Temporary Employment Office is a room. "'Tomorrow's Temporary Workers - Today!' proclaims the logo over the door. The office is divided into two areas, the inner sanctum where you take calls and fiddle with the computer, and the outer area where workers take skill exams and watch inspirational videos ('Earn your way to partial benefits!', 'Vacation days and you!', 'Temping the Tomorrow Way', etc.)."

Maya is a woman in the Office. "Your coworker Maya sits at her own computer, diligently modifying all the [one of]pay rates in the database down from $9.00 an hour to $8.96[or]billing rates in the database up from $25.00 an hour to $25.04[purely at random]." She wears a trenchcoat. She carries a chihuahua. The description of Maya is "[if Maya is wearing the trenchcoat]She's wearing a trenchcoat, in a bizarre bid to keep your boss unaware of the chihuahua in her pocket. 'Because petsitters are really expensive!' she explained to you in an urgent hiss this morning over the coffeemaker. [otherwise]She looks cold. [end if]To all appearances, she is carrying [a list of unconcealed things carried by Maya]."

Maya's computer is scenery in the Employment Office. The description is "You can't see the screen from here, but she was perfectly happy to tell you what she was doing."

Rule for deciding the concealed possessions of someone (called carrier):

if the particular possession is the chihuahua and the carrier wears the trenchcoat, yes;

otherwise no.

Instead of eating something in the presence of the chihuahua:

say "[The chihuahua] yips at you! Maya looks despairingly at [the noun], which is obviously inciting it."

The desk is scenery in the Office. On the desk are a multi-line telephone and a printer. The description of the printer is "Every morning, this instrument of torture spits out a list of the assignments you have to fill - professional, attractive receptionist with level three Excel certification, at $7.05 an hour; that sort of thing. You spend the ensuing three hours trying to meet its tyrannical demands." The description of the multi-line telephone is "Line three blinks urgently at you. You'll pick it up again as soon as you can remember who it was you put on hold."

The player carries a double bacon cheeseburger and a chocolate shake. Understand "milkshake" or "beverage" as the shake. The description of the cheeseburger is "A minor self-indulgence to make up for the fact that you have to work through lunch." The cheeseburger is edible. The shake is edible. The description of the shake is "It has the consistency of spackle and is no longer cold, but there is some chocolatey goodness in it still." Understand "burger" or "hamburger" as the cheeseburger. Instead of drinking the chocolate shake: try eating the shake instead.

Test me with "x maya / x cheeseburger / drink shake / eat cheeseburger".

Unless we somehow get the trenchcoat away from Maya, the chihuahua will not be in view, and will not intervene in our lunch. All very well for the player character, but not so interesting to the story… To this end, we might add an unfortunate event, courtesy of later chapters:

The time of day is 11:45 AM.
 
At 11:47 AM: say "Your boss pokes his head in, temporarily free of the round of conference calls that occupy all his days. 'Maya,' he says. 'Your coat?' He shakes his head, clucking sadly. 'It doesn't say professional!' But mercifully Maya manages to take it off so slowly that he doesn't glimpse her pet before her phone rings again.";
   now Maya carries the trenchcoat.

wi 7.12 In the presence of, and when
rb 8.3 Animals

🔗

RB §8.4 Furniture

Most domestic furniture consists of supporters and containers of one size or another. This means that the simplest furniture needs no elaborate instructions:

The candlestick is on the dining table. The dining table is fixed in place.
 
The silver salt cellar is on the serving trolley. The serving trolley is pushable between rooms.
 
The pillow is on the bed. The bed is enterable and fixed in place.

The examples below are therefore mostly ways to get around the usual restrictions on containers (that they only have one interior) and supporters (that they cannot simultaneously be containers as well).

Yolk of Gold ★★ provides a set of drawers, that is, a container with multiple interiors.

U-Stor-It ★★★ provides a way to have containers with a lid which is also a supporter.

Swigmore ★★ provides a supporter which holds up the player, but has no top surface as such, and cannot hold up anything else. Kiwi ★ demonstrates a kind of high shelf, whose objects cannot be seen or used unless the player stands on a ladder.

Princess and the Pea ★ shows how a pile of supporters, each on top of the last, could be managed.

Tamed ★ demonstrates furniture large enough to get inside, or on top of.

Circle of Misery ★ demonstrates a conveyor belt, which can hold multiple items but only brings one of them within the player's reach at a time.

Examples

13. Tamed ★

Within a room, we might have containers and supporters that a player can enter. A chair, stool, table, dais, or pedestal would be an enterable supporter (anything we would describe a person as being "on"); a cage, hammock, or booth would be an enterable container (because we would describe the person as being "inside").

When the player is in or on something, he is able to see the rest of the contents of the room, but a note such as "(in the hammock)" or "(on the poster bed)" is added to the room title when he looks around.

Here is an example to show off the possibilities:

"Tamed"

The Center Ring is a room. The cage is in the Center Ring. A lion is an animal in the cage. The cage is enterable, openable, transparent, and closed.

Notice that we made the cage transparent. Strictly speaking it is not made of transparent materials, but we can see into (or out of) a closed cage due to the gaps between the bars, so that from Inform's point of view a cage behaves much like a large sturdy glass box. (If we really wanted to make a distinction between, say, an airtight container and one with perforations, we could do so, but Inform does not model such nuances by default.) If a container is not transparent, we can see into and out of it only when it is open.

Supporters are a bit more straightforward because there is no circumstance in which they separate the player from the rest of the world:

The pedestal is in the Center Ring. It is enterable.

And in fact we can tell Inform that the player starts on the pedestal with this line:

The player is on a pedestal.

Now the player will begin there rather than just in the Center Ring.

This last bit is an entirely unnecessary bit of local color, but if we're going to keep getting into and out of the lion's cage, we ought to expect him to take notice:

Every turn when the player is in the cage:
   if a random chance of 1 in 2 succeeds, say "The lion eyes you with obvious discontent.";
   otherwise say "Though the lion does not move, you are aware that it is watching you closely."

Randomness is explained more completely in the chapter on Change, and every turn rules in the chapter on Time.

Finally, we might want a container whose interior is modeled as its own separate room: say, a magician's booth in which volunteers are made to disappear.

The magician's booth is a container in Center Ring. "Off to one side is a magician's booth, used in disappearing acts. The exterior is covered with painted gilt stars." The booth is enterable, open, not openable, and fixed in place.

Now we create our other location:

Inside from the Center Ring is the Starry Vastness.

…which handles the case of the player typing >IN. (We will not assume by default that he wants to get into the cage with the lion, this being obviously perilous.) But we also want to make sure that the player who types >ENTER BOOTH winds up in the same place, so we should add:

Instead of entering the magician's booth: try going inside.
 
Test me with "get in cage / open cage / get in cage / z / close cage / out / open cage / get on pedestal / get off / look / enter booth / out".

wi 3.6 Either/or properties
rb 8.4 Furniture

173. Princess and the Pea ★

The main point here is that we need to figure out where the stack meets the floor:

"Princess and the Pea"

The Topmost Turret is a room. A mattress is a kind of supporter. A mattress is always enterable. A mattress is portable.

A large mattress is a mattress in the Turret. A medium mattress is a mattress in the Turret. A small mattress is a mattress in the Turret.

Instead of sleeping when the player is on a mattress (called the bed):

let the item be the bed;

while the holder of the item is not a room:

let the item be the holder of the item;

say "You can still feel something very uncomfortable under [the item]."

Instead of sleeping:

say "You can't sleep standing up!"

Instead of looking under a mattress, say "You scout around, but are unable to determine what's causing you this discomfort. If only your maid Winnie were here. She's very good at this."

Test me with "sleep / enter small / sleep / get up / get small / put small on medium / get on small / sleep / get up / g / get medium / put medium on large / get on small / look / sleep".

wi 11.7 Begin and end
rb 8.4 Furniture

361. Kiwi ★

Suppose we want there to be some high shelves in our game, which the player can't get at unless he's standing on a prop of some kind. (This is a pretty hoary and over-used puzzle, but there may still be occasions when it becomes useful again.)

In order to resolve this, we want to set up a raised supporter kind. When something is on a raised supporter, it should be mentioned to the player only if the player is in the right position (i.e., standing on something) and otherwise omitted from the description entirely.

"Kiwi"

Section 1 - Procedure

A raised supporter is a kind of supporter.

For printing a locale paragraph about a raised supporter (called the high place):

if the player is on a supporter (called the riser):

say "Up on [the high place] (and only visible because you're on [the riser]) [is-are a list of things on the high place].";

otherwise:

say "The [high place] is above you."

Note that here we don't continue the activity because we want to completely replace the normal behavior of describing what is on supporters.

Definition: a thing (called target item) is out of reach:
   if the player is on a supporter, no;
   if the target item is on a raised supporter, yes;
   no.

Now we also need to prevent the player from interacting with things that are out of reach:

Before doing something:
   if the noun is out of reach or the second noun is out of reach:
      say "You can't reach from down here." instead.

…or restoring things to the shelves while the player is in the wrong position…

Instead of putting something on a raised supporter when the player is not on a supporter:
   say "You can't reach from down here."

And raised supporters shouldn't be searchable from the ground either:

Instead of searching or examining a raised supporter when the player is not on a supporter:
   say "You can't see from down here."

Finally, we need to tackle the case where the player types GET ALL FROM SHELF, because we don't want to list the objects up there if the player can't even see them. We use a rule for deciding whether all includes in order to tell Inform not to consider items that can't be reached, and then we adjust the parser error so that it's a little more instructive than "There are none at all available!", which is what the response would otherwise be:

Disallowed-all is a truth state that varies. Disallowed-all is false.
 
Rule for deciding whether all includes an out of reach thing:
   now disallowed-all is true;
   it does not.
 
Rule for printing a parser error when the latest parser error is the nothing to do error and the player is not on a supporter:
   if disallowed-all is true:
      say "Whatever might be up there, you can't see or reach from down here.";
   otherwise:
      make no decision.
 
A first action-processing rule:
   now disallowed-all is false.
 
Section 2 - Scenario
 
The Bottom of the Nursery is a room. "Ever since you ate that mysterious cake, you've been even shorter than usual."
 
The high shelf is a raised supporter in the Nursery. It is scenery. On the high shelf are a kiwi-green ball and a stuffed dodo.
 
The step-ladder is an enterable supporter in the Nursery. Understand "ladder" as the step-ladder.
 
Test me with "x shelf / search shelf / get dodo / get all from shelf / stand on ladder / get all from shelf / search shelf / get off / put all on shelf / get all from shelf / stand on ladder / put all on shelf".

wi 18.28 Printing a locale paragraph about
rb 8.4 Furniture

431. Circle of Misery ★

The only point we need to be careful about is that the carousel is simulated twice over, in the following text: once in the built-in way that objects are inside other objects, so that the luggage items are objects contained in the carousel object; but then again by the "circle of misery" list, a ring buffer keeping track of what order things are in. We need to be careful that these two records do not fall out of synchrony: anything put into the carousel must be added to the list, anything taken out must be removed. (In fact we forbid things to be added, for simplicity's sake.)

"Circle Of Misery"

Luggage item is a kind of thing. The blue golf bag, the leopardskin suitcase, the green rucksack and the Lufthansa shoulder-bag are luggage items.

Heathrow Baggage Claim is a room. The carousel is a container in Heathrow. "The luggage carousel, a scaly rubbered ring, does for the roundabout what Heathrow Airport does for the dream of flight: that is, turns the purest magic into the essence of boredom, only with extra stress. [if the number of entries in the circle of misery is 0]For once it stands idle. Perhaps it's broken.[otherwise]The baggage approaching you now: [the circle of misery with indefinite articles]."

The circle of misery is a list of objects that varies.

When play begins:

now all the luggage items are in the carousel;

add the list of luggage items to the circle of misery.

The list "circle of misery" is our ring, in which entry 1 is considered to be the position of whichever bag is currently frontmost. And here it goes, round and round:

Every turn when the number of entries in the circle of misery is not 0:
   rotate the circle of misery;
   let the bag be entry 1 of the circle of misery;
   say "The carousel trundles on, bringing [a bag] to within reach."
 
After taking a luggage item (called the bag):
   remove the bag from the circle of misery, if present;
   say "Taken."
 
Before doing something with a luggage item (called the bag) which is in the carousel:
   if the bag is not entry 1 of the circle of misery, say "[The bag] is maddeningly out of range. You'll have to wait for it to come round." instead.
 
Instead of inserting something into the carousel, say "In recent years, the authorities have tended to frown upon depositing bags in random places at airports."
 
Test me with "get suitcase / get suitcase / get suitcase / get suitcase / look / get golf bag / look / get golf bag".

wi 21.11 Variations: arrays, logs, queues, stacks, sets, sieves and rings
rb 8.4 Furniture

83. Yolk of Gold ★★

Suppose that for dramatic effect we would like the player to find the thing he is looking for always in the last drawer he opens…

"Yolk of Gold"

The Turret is a room. "A cramped little room distinguished chiefly by the spiral staircase that descends from it. The windows look out over the rooftop."

The Rooftop is outside from the Turret.

The staircase is an open unopenable door. It is scenery. It is below the Turret and above the Library. The description is "A winding stair carved out of the single trunk of a massive tree, all in a dark wood; the outside of the stairs left unfinished with the bark still on, but the treads worn smooth by long and constant use."

The description of the Library is "Here, it seems, you have found your mark: books line both walls, a dark carpet lies on the floor, and a strange dress hangs up in a presentation case. And the thing you were told to look for, a desk with three drawers.

A spiral staircase leads up and out."

The cherry desk is scenery in the library. The description is "A deep, satin-lustrous cherry, with scrollwork legs and gilt touches. The years have not been kind, and it has cracked and split in several places; the finish is damaged, and where there is inlaid mother of pearl, it is beginning to come up from its bed. But it is still a sound piece, and features three drawers."

After examining the desk for the first time, say "(Your employers were able to tell you to look for it, but not which drawer to look in. Typical.)"

A drawer is a kind of container. A drawer is always openable and closed. The description of a drawer is "The usual drawer of heavy wood, inadequately smoothed for ease of use."

The top drawer is a drawer. The middle drawer is a drawer. The bottom drawer is a drawer. The top drawer, the middle drawer, and the bottom drawer are part of the desk. A drawer can be explored or unexplored. A drawer is usually unexplored. Instead of searching a closed drawer, try opening the noun.

After opening a drawer when no drawers are explored:

now the noun is explored;

say "There is a tremendous screech, but nothing whatsoever inside, not even dust."

After opening an unexplored drawer when exactly one drawer is explored:

now the noun is explored;

say "You struggle to open this one a bit more quietly, conscious all the time of noise... but no, it's empty. Just stands to reason."

After closing a drawer:

say "There is a racket of wood protesting against wood as you do so, which makes you wonder if you hadn't better just leave them open from now on. The unhappy owner is probably going to catch on soon enough anyway."

Before opening an unexplored drawer when exactly two drawers are explored:

move the mysterious thing to the noun;

now the noun is explored.

There is a mysterious thing. The description is "A very familiar-looking hemispherical weight of metal, goldish in tone though perhaps not made of gold. This one has a slight stickiness about the bottom surface."

Instead of opening the desk when at least one drawer is unexplored:

let the next drawer be a random unexplored drawer;

say "(starting with [the next drawer])[line break]";

try opening the next drawer.

Instead of looking under the desk when no drawers are explored:

say "You carefully survey the ground around the desk. There don't seem to be any hidden tripwires or traps to prevent you from having a look in the drawers."

Instead of looking under the desk when at least one drawer is unexplored:

say "Nothing there either. Thoroughness is a virtue with tedium as a side effect, as your mother used to say -- but they always counted her a trifle slapdash."

Instead of looking under the desk when all drawers are explored:

say "There's nothing down there, but this doesn't come as a great surprise."

Instead of searching the desk when at least one drawer is unexplored:

move the mysterious thing to the player;

say "You perform a hasty, squeaky search of ";

if no drawer is explored, say "all three drawers, discovering nothing and nothing in rapid succession. But on the third drawer you ";

if exactly two drawers are unexplored, say "the remaining two drawers. There's nothing in the second, but in the third you ";

if exactly one drawer is unexplored, say "the last drawer. In it, you ";

say "turn up a promising hemispherical object.";

now all the drawers are explored.

Perhaps, just for fun, we have all the other scenery draw the player's attention back to the main point, as well.

The carpet is scenery in the Library. The description is "It is too dark for you to make out details of the antique design, which seems dimly to represent an early voyage to the moon, with ships and the travelling stars." Understand "rug" as carpet.
 
Instead of looking under the carpet:
   if none of the drawers are explored, say "You peel up a corner of the rug gingerly; nothing results. A perfectly ordinary rug, then." instead;
   if all of the drawers are explored, say "No time for that kind of nonsense. You'd better get out and away while you can." instead;
   if some of the drawers are explored, say "No time for that nonsense. The desk's what you want now; what you came for won't be embedded in the flooring." instead.
 
The glass presentation case is transparent scenery in the Library. The description is "The case is taller than you are, framed in wood, with large panels of glass, the better to display the remarkable contents."
 
Instead of attacking the glass presentation case:
   say "The glass pane of the presentation case shatters, throwing fine glass everywhere, including over the delicate museum-piece inside. Nor does the noise pass unnoted: only a second passes before there are footsteps in the hall, and though you make for the concealing darkness and escape of the turret, you are not swift enough. The servants are soon on you, and you are made to regret, quite painfully, this casual act of vandalism.";
   end the story saying "You have lost your opportunity."
 
The strange dress is a wearable thing in the glass case. The description is "Not the sort of dress that anyone wears now: such elaboration would be ludicrous.  It drips gold -- gilt lace, ruffles of trimmed gold, shimmering golden tracery -- dulled here and there by the sinister black of faceted jet."
 
Test me with "d / x case / x dress / x carpet / look under carpet / look under desk / x desk / open top drawer / close top drawer / look under desk / open bottom drawer / close bottom drawer / open middle drawer / get thing / look under carpet / look under desk / up".

wi 6.16 Counting while comparing
rb 8.4 Furniture

397. Swigmore U. ★★

Inform's default assumption is that if a player on an enterable object drops something, the dropped article winds up beside him on the same supporter or in the same container. This makes lots of sense for a dais, say, or a king-sized bed. It's a little less sensible if the enterable supporter in question is a bar stool or the like. So suppose we want to add a new kind of supporter called a perch, where everything dropped lands on the floor.

There are actually several ways of implementing this, but one of them is to reach right into the drop action and replace the "standard dropping rule" with a different one of our own invention -- like this:

"Swigmore U."

Moe's Tavern is a room. The bar is an enterable supporter in Moe's. A drink is a kind of thing. On the bar is a drink called a flaming Homer.

A perch is a kind of supporter. A perch is always enterable. The stool is a perch in Moe's.

The player carries a dead field mouse and a tomacco fruit.

The sophisticated dropping rule is listed instead of the standard dropping rule in the carry out dropping rulebook.

This is the sophisticated dropping rule:

if the player is on a perch (called the awkward position):

let place be the holder of the awkward position;

move the noun to the place;

otherwise:

move the noun to the holder of the player.

Test me with "sit on stool / drop mouse / look / get up / look".

Now the carry-out behavior of the dropping action has been changed, but we haven't had to interfere in the checks or reporting at all. The rest of the action works just as it always did.

Of course, maybe we do want to change the way the action is reported, to make it clearer to the player where the dropped article wound up:

The sophisticated report dropping rule is listed instead of the standard report dropping rule in the report dropping rulebook.

This is the sophisticated report dropping rule:

say "You drop [the noun] on [if the holder of the noun is a room]the ground[otherwise][the holder of the noun][end if]."

wi 19.4 Listing rules explicitly
rb 8.4 Furniture

58. U-Stor-It ★★★

Suppose we want to write a game in which there are a number of chests. Each of these chests will be a container, but have a lid which is a supporter.

"U-Stor-It"

Section 1 - Assemblies and Supporters

A chest is a kind of container. A chest is always openable. A chest is usually fixed in place. A chest is usually closed. The specification of a chest is "Represents a container with a separately implemented lid; the lid is itself a supporter."

A lid is a kind of supporter. A lid is part of every chest. The specification of a lid is "A supporter attached to a chest, which can only support things when the chest is closed."

(The "specification" of a kind is not really a property, and is used instead to describe the kind in the Index. So the text of these specifications is never found in the game.) Of course, this doesn't get us very far. We will also want the game to correctly interpret variations on "open the chest" and "close the lid", redirecting actions appropriately.

Section 2 - Opening and closing
 
Before opening a lid which is part of a chest (called the item):
   try opening the item instead.
 
Before closing a lid which is part of a chest (called the item):
   try closing the item instead.
 
Before opening a chest (called the box) when something is on a lid (called the obstruction) which is part of the box:
   repeat with item running through things on the obstruction:
      say "(first removing [the item])";
      try taking the item.
 
Instead of opening a chest when something is on a lid (called the item) which is part of the noun:
   say "You'd have to remove [the list of things on the item] from the lid first." instead.
 
Instead of looking under a lid which is part of a chest (called the item):
   try opening the item.

We may also want to be able to deal with "put in" and "put on" appropriately, even if the player names the wrong part of the object:

Section 3 - Insertion and Support
 
Before inserting something into a lid which is part of a chest (called the item):
   try inserting the noun into the item instead.
 
Before putting something on a chest when a lid (called the item) is part of the second noun:
   try putting the noun on the item instead.

Furthermore, we don't want the player to be able to put things on the lid while the chest is open:

Before putting something on a lid which is part of an open chest (called the item):
   say "(first closing [the item])";
   try closing the item.
 
Instead of putting something on a lid which is part of an open chest (called the item):
   say "[The item] would need to be closed first."

And then we may also want a couple of rules for describing our assembled object nicely:

Section 4 - Description in Rooms
 
Instead of examining a closed chest when something is on a lid (called the top) which is part of the noun:
   say "[The noun] is closed, and there [is-are a list of things on the top] on top."
 
After printing the name of a chest (called the item) while listing contents of a room:
   if a lid (called the second item) which supports something is part of the item:
      say " (on which [is-are a list of things on the second item])";
      omit contents in listing.

Now we are free to create entire treasure rooms at a single blow:

Section 5 - U-Stor-It Facility
 
The U-Stor-It Facility is a room. The sea trunk, the shipping crate, and a metal box are chests in the U-Stor-It Facility. The metal box contains a sapphire, a gold coin, and a signed photograph of Babe Ruth.

Even though we have never explicitly defined it, the metal box has a "metal box's lid", which we can use at need.

The metal box's lid supports a small card. The description of the small card is "It reads, 'Back in 5 mins - Pandora.'"
 
Test me with "open trunk / x card / open metal box / put all in metal box / get card / put card on box".

wi 4.15 Assemblies and body parts
rb 8.4 Furniture

🔗

RB §8.5 Kitchen and Bathroom

Before implementing elaborate mechanisms to handle plumbing, we should pause to ask ourselves: how much of this do we need? Is it really necessary to simulate the complete set of fixtures and fittings?

This turns out to be a little tricky to do, and also rather dull to set out. The example Modern Conveniences ★★ was actually written as a demonstration of how an extension to Inform might be written to provide a general "kitchens and bathrooms service" for writers, but it contains a nice implementation well worth borrowing. The idea is to provide a "kitchen" kind of room and a "bathroom" kind of room. All kitchens created automatically contain standard kitchen appliances: fridge, freezer, sink with taps, counters, cabinets, and a stovetop with built-in oven. Similarly, all bathrooms will have sinks, baths, cabinets, and toilets, and respond to some standard interactions.

Another common feature of bathrooms is a mirror: Versailles ★★ demonstrates how to create a simple one.

Examples

75. Versailles ★★

One of the advantages of descriptions is that we can use them to pick an item randomly from a specified category. (For more on this possibility, see the Change chapter sections on randomness.)

For instance, suppose we wanted to create a mirror in which the player would see some item from the room reflected. We might write

Instead of searching the mirror:
   say "You see [a random thing in the location] reflected back at you."

This is the same as "a random thing which is in the location": phrase "in…" can be used briefly in Inform as it can in English.

But, on a little more thought, we might want to expand on this: the mirror perhaps should reflect not only things that are in the room, but anything that the player can see (even if it's on a supporter or carried by someone). So then we might instead write

Instead of searching the mirror:
   say "You see [a random visible thing] reflected back at you."

There's still a risk, though, that this will produce the response

You see the mirror reflected back at you.

because, of course, the mirror is itself visible. So instead we might write

Instead of searching the mirror:

say "You see [a random visible thing which is not the mirror] reflected back at you."

"Versailles"

The Hall of Plywood Boards is a room. "The Hall of Mirrors is under reconstruction: it is currently a dank tunnel enlivened only by short placards about the history of the room.

As though to mock tourists such as yourself who bought their tickets without knowing this, the officials have left uncovered a single panel of mirror."

The mirror is scenery in the Hall of Plywood Boards. Understand "panel" or "panel of mirror" as the mirror. The description is "Lovingly restored to shimmering brilliance, it suggests how marvelous this room would be if you had had the good sense to arrive after the renovations were complete."

Some tourists are a person in the Hall of Plywood Boards. The tourists are scenery.

Instead of searching the mirror:

say "You see [a random visible thing which is not the mirror] reflected back at you."

Test me with "x mirror / look in mirror / g".

A final note: we use "searching" here because Inform understands both SEARCH THING and LOOK IN THING as the searching action, and the player is most likely to type LOOK IN MIRROR in order to see the reflection there. In the absence of an example, we can discover the relationship between actions and their command vocabulary in one of two ways. A complete list of actions and the vocabulary associated with them is available in the Actions index. Alternatively, we can type ACTIONS at a prompt, followed by LOOK IN MIRROR, and get the response

[searching the mirror]
You find nothing of interest.
[searching the mirror - failed the can't search unless container or supporter rule]

…which tells us that Inform is understanding the action as "searching the mirror".

wi 6.9 Which and who
rb 8.5 Kitchen and Bathroom

448. Modern Conveniences ★★

Suppose we want to write an extension or other portable code which defines a "kitchen" kind of room and a "bathroom" kind of room. All kitchen rooms we create in the future will automatically contain standard kitchen appliances: fridge, freezer, sink with taps, counters, cabinets, and a stovetop with built-in oven. Similarly, all bathrooms will have sinks, baths, cabinets, and toilets, and respond to some standard interactions.

We would do this with a standard assembly:

"Modern Conveniences"

Section 1 - Kitchens

A kitchen is a kind of room.

A refrigerator is a kind of container. A refrigerator is usually closed and openable. A refrigerator is usually fixed in place. A refrigerator is usually scenery. Understand "fridge" as a refrigerator.

A freezer compartment is a kind of container. A freezer compartment is usually closed and openable. A freezer compartment is part of every refrigerator.

Now: we're going to want many of the items in our kitchen to have switches, and to handle input sensibly regardless of whether the player types TURN ON STOVE or TURN ON STOVE SWITCH. (This is apparently a stove with only one burner.) For convenience, we'll define an "includes" relation:

Inclusion relates a thing (called X) to a thing (called Y) when Y is part of X. The verb to include means the inclusion relation.
 
A stove is a kind of supporter. It is usually scenery.
An oven is a kind of container. An oven is usually openable and closed. One oven is a part of every stove.
A switch is a kind of device. A switch is part of every stove. A switch is part of every oven.
Understand "[something related by reversed incorporation] switch" as a switch.

What follows is fairly straightforward, but notice that we are somewhat obsessively naming every rule. This is much more important in extensions (where someone else may need to manipulate our code from within their own source) than it is when we are simply composing source text for ourselves.

Setting action variables for opening a stove (this is the stove-opening rule):
   let relevant oven be a random oven which is part of the noun;
   now the noun is the relevant oven.
 
Setting action variables for switching on something which includes a switch (this is the redirecting switches for switching on rule):
   let relevant switch be a random switch which is part of the noun;
   now the noun is the relevant switch.
 
Setting action variables for switching off something which includes a switch (this is the redirecting switches for switching off rule):
   let relevant switch be a random switch which is part of the noun;
   now the noun is the relevant switch.
 
Before printing the name of a switch (called target) (this is the switch identification rule):
   say "[random thing which includes the target] ".
 
A sink is a kind of container. A sink is usually fixed in place and scenery. A tap is a kind of switch. A tap is part of every sink. Understand "faucet" or "taps" as a tap. Understand "[something related by reversed incorporation] tap/faucet/taps" as a tap.
 
Instead of opening a tap, try switching on the noun. Instead of closing a tap, try switching off the noun.
 
Report switching on a tap (this is the standard report switching taps on rule):
   say "You turn on [the noun]." instead. [since "switch on" sounds weird in this context.]
 
Report switching off a tap (this is the standard report switching taps off rule):
   say "You turn off [the noun]." instead.
 
After examining something which includes a switched on tap (called relevant tap) (this is the report flowing water rule):
   say "The water is flowing from [the relevant tap]."
 
A drain is a kind of container. A drain is part of every sink. Understand "plughole" as the drain. Understand "[something related by reversed incorporation] drain/plughole" as a drain.
 
Instead of inserting something into a drain (this is the no clogging drains rule), say "Pointless."

This is probably about as far as we want to go in a generic simulation: it is tempting to code up water, drains down which the player can lose objects, sinks that get clogged and overflow, and so on; but the more we embellish in these ways, the more likely the end result would be disruptive to individual games. For right now what we're aiming for is something simple which provides the basic interactions a player might expect in this kind of room, but which does not have any significant implications for the surrounding world model.

A particularly conservative author might even want to make it turn out that the water has been shut off and nothing flows from the taps: in the extension documentation, we might want to include a line or two of example showing how this might be done by changing or removing the relevant rules of our extension.

A cabinet is a kind of container. A cabinet is usually openable and closed. It is scenery.
   Understand "cupboard" or "cupboards" or "cabinets" as a cabinet.
 
A counter is a kind of supporter. It is scenery.
   Understand "countertop" as a counter.
 
A cabinet is in every kitchen.
A counter is in every kitchen.
A refrigerator is in every kitchen.
A sink is in every kitchen.
A stove is in every kitchen.
 
Section 2 - Bathrooms
 
A bathroom is a kind of room.
 
A toilet is a kind of supporter. Understand "john" as a toilet. A toilet is usually fixed in place and enterable and scenery.
 
A bath is a kind of container. A bath is usually a fixed in place and enterable and scenery. A tap is part of every bath. A drain is part of every bath. Understand "bathtub" or "shower" as a bath.
 
A sink is in every bathroom.
A toilet is in every bathroom.
A bath is in every bathroom.
A cabinet is in every bathroom.

If we were feeling particularly ambitious and inclined toward interior decoration, we could add bath mats, mirrors, plungers, toilet brushes, overhead lighting, towel racks, scented candles, boxes of facial tissue, shampoo bottles, scrubbing loofahs, etc. ad nauseam; but we'll keep it relatively simple for now. Of course, if we have a toilet, we pretty much have to accept that the player will try to make use of it:

Understand "flush [toilet]" or "use [toilet]" as a mistake ("You have no need at the moment.").
 
Understand "take shower" or "take bath" or "bathe" or "wash" as bathing. Bathing is an action applying to nothing.
 
Check bathing (this is the restrict baths to bathrooms rule):
   if the location is not a bathroom, say "This isn't the place." instead.
 
Check bathing (this is the block bathing rule):
   say "You haven't time for a bath." instead.
 
Washing is an action applying to one thing. Understand "clean [something]" or "wet [something]" or "wash [something]" as washing.
 
Instead of washing the player, try bathing.
 
Check washing (this is the restrict washing to the proximity of sinks rule):
   unless the player can touch a sink, say "This isn't the place." instead.
 
Check washing (this is the block washing rule):
   say "It doesn't seem worth the bother." instead.

Now we might put this to work in a short example.

One slight challenge lies in giving these assembled pieces separate descriptions. When we have an assembly that adds parts to objects, we can then talk about (for instance) "the stove's switch" elsewhere in the code. But items that have been assigned rooms are not named in the same way, so we cannot talk about "the Industrial Kitchen's stove" in our code as a way to assign it a description or special behavior. In quite a simple example, we could make the descriptions of the kind simply be the descriptions we want for the individual items:

Section 3 - An Example We Might Offer
 
Our Household Kitchen is a kitchen.
 
The Tiny Bathroom is a bathroom. It is west of Our Household Kitchen.
 
The description of a stove is "Scrupulously polished."
 
The description of a refrigerator is "It is baby blue and has the contours of a 50[']s chevy. One of these days it really will break down, but it's been serving your family faithfully since your grandmother's honeymoon."
 
Test me with "x refrigerator / open fridge / x freezer / look in freezer / open freezer / turn on stove / turn on oven / x oven switch / turn off oven switch / turn off stove switch / turn on taps / x sink / w / x sink / turn on sink / take bath / use toilet".

In a game that featured multiple bathrooms and kitchens, this wouldn't be enough; our author might give the stove kind (say) a description that checked its location, as in

The description of a stove is "[if in Industrial Kitchen]A massive stainless steel stove-top with six burners[otherwise]Your standard four-burner item[end if]."

or create an

Instead of examining the stove in the Industrial Kitchen: ...

sort of rule for those objects he wanted to describe specially; or he might use a when play begins rule to initialize a few things:

When play begins:
   let N be a random stove in the Industrial Kitchen;
   move the boiling pot to N;
   change the description of N to...

Or we might even (if we anticipate lots of these kinds of amendments) want to rig up something more complex that finds the descriptions of appliances in a table, rather than relying on their individual description properties. This can all be done, but it is only interesting as long as it remains genuinely labor-saving: that is, as long as the convenience of having the assembly is greater than the annoyance of writing special rules to cover for the automation. In the end, the "kitchen" and "bathroom" room types are likely to be most useful for authors who want to include the standard props but not actually make them a critical part of the game; if stoves and sinks have more of a starring role in the production, authors may be better off coding them or at the very least placing them by hand, as in

The Industrial Kitchen is a room.
 
Thor is a stove in the Industrial Kitchen. It supports a boiling pot.

All these quirks are things that we (as the extension author) want to think out in advance: we should ideally warn authors about possible pitfalls in using our extension (if we can think of them) and point out ways of customizing the behavior (if there are interesting ways).

wi 27.5 A simple example extension
rb 8.5 Kitchen and Bathroom

§9.

Food

§9.

Bags, Bottles, Boxes and Safes

§9.

Clothing

§9.

Money

§9.

Dice and Playing Cards

§9.

Reading Matter

§9.

Painting and Labeling Devices

§9.

Simple Machines

§9.

Televisions and Radios

§9.

Telephones

§9.

Clocks and Scientific Instruments

§9.

Cameras and Recording Devices

🔗

RB §9.1 Food

Inform provides an either/or property called "edible" and an action, "eating", for consuming edible things:

The lardy cake is edible. After eating the lardy cake, say "Sticky but delicious."

For eating something not immediately to hand, see Lollipop Guild ★★★. Delicious, Delicious Rocks ★★★, conversely, adds a sanity check which prevents the player from automatically taking inedible things only to be told they can't be eaten.

Inform does not normally simulate taste or digestion, but to provide foods with a range of flavours, see Would you…? ★; to make eating different foods affect the player differently, see Stone ★, or for the extreme case of poisoning foods, Candy ★. In MRE ★, hunger causes the player problems unless he regularly finds and eats food.

Examples

48. Would you...? ★

For instance, if we want to give some objects a flavor:

"Would you...?"

The House is a room. The mouse is an animal in the House.

The player carries some green eggs and a ham.

A food is a kind of thing that is edible. Food has some text called flavor. The flavor of food is usually "Tolerable."

Things are, in general, not edible by default, so we have to make them edible specifically in order to allow them to be eaten by the player. Here we've defined food to be edible by default, and we have given it a standard piece of flavor text.

The ham and the green eggs are food. The flavor of the green eggs is "Delicious!"
 
After eating something:
   if the noun provides the property flavor, say "[the flavor of the noun][paragraph break]";
   otherwise say "It's [noun]-flavored."

Note that we use "if the noun provides a flavor…" to make sure that the property exists before attempting to use it. Otherwise, there is the risk that we will try to print a property that does not exist, resulting in errors in the game.

We will only get the "It's [noun]-flavored." response if we successfully eat something that is not a food and does not have flavor text. To test this feature, let's suppose something that isn't exactly food but can theoretically be chewed on:

The player carries some paper. The paper is edible.
 
Test me with "eat ham / eat green eggs / eat paper".

wi 4.8 New value properties
rb 9.1 Food

133. Candy ★

Suppose we want to give the player a bag of candies, of which a random one is poisonous. We can pick which one should be poisoned at the start of play, like this:

"Candy"

The plural of piece of candy is pieces of candy. A piece of candy is a kind of thing. A piece of candy is always edible. Four pieces of candy are in the Halloween bag.

Toxicity is a kind of value. The toxicities are safe and poisonous. A piece of candy has a toxicity. A piece of candy is usually safe.

The Porch is a room. The player carries the Halloween bag.

After eating a poisonous piece of candy:

say "Oh, that didn't taste right at all. Oh well!"

When play begins:

now a random piece of candy is poisonous.

Test me with "eat candy / g / g / g".

wi 8.19 Random choices of things
rb 9.1 Food

143. MRE ★

Many older interactive fiction games required the player to find food and eat on a regular basis in order to avoid death. This effect was often unrealistic (since most people can survive much longer than a few hours without eating) and is often seen as an annoyance. However, for the sake of argument, suppose that we do want to construct a hunger-and-death system.

To make things a little more interesting, we will postulate that different foods are differently filling, so that if the player manages to find something really caloric, he is off the hook on his hunger search for a while.

We will also implement the system so that the player gets messages when he is hungry, then dies a short time later. (The times involved are ludicrously short, but this allows us to see the effects within a simple example. In a real game we would want to allow a considerably longer timer for the hunger to play out.)

First, a little scene-setting:

"MRE"

When play begins:

now the right hand status line is "[time of day]";

say "The procedure was painless at first: increased strength was the first sign, followed by a sensation of delayed time, as though everyone around you moved more slowly. Your ability to dodge and perform feats of agility doubled, then trebled. You were heralded as a triumph of medicine. They told you there would be no side effects worth speaking of.

They were wrong."

The Base Camp Larder is a room. "This room has been reinforced after each incident -- and there have been dozens in the last two months -- so that it now rivals Fort Knox. Only your new skill and speed enabled you to dodge the motion sensors, knock out the computerized security system, fool the retinal scanner, and punch a hole in the steel containment grating. But you're inside now."

Now we define our food, and add some special instructions for what happens to our hunger counters when the food is eaten:

Food is a kind of thing. Food is usually edible. Food has a time called the satisfaction period. The satisfaction period of a food is usually 5 minutes.
 
A person can be hungry or replete. The player is hungry.
 
The Larder contains an apple, a candy bar, and a large plate of pasta. The apple, the candy bar, and the pasta are food. The satisfaction period of the apple is 2 minutes. The satisfaction period of the pasta is 125 minutes.
 
Check eating something which is not food:
   say "[The noun] might be edible, but it's not what you'd consider really food."
 
Check eating something when the player is not hungry:
   say "You're not hungry right now."
 
Carry out eating something:
   now the player is replete;
   hunger resumes in the satisfaction period of the noun from now.

The first of those two phrases, "now the player is replete", causes the player to cease to be hungry; the second one sets up a future event in which the hunger sets in again. The length of time until that event depends on how satisfying the specific food is. Now we define that event:

At the time when hunger resumes:
   starvation occurs in three minutes from now;
   now the player is hungry.
 
At the time when starvation occurs:
   if the player is hungry, end the story saying "You have starved".

Note "if the player is hungry": it is possible that the starvation event will be set up but the player will eat before it occurs; in that case, we want it not to take effect.

And now, since we really ought to give the player some warning of what is happening to him:

Every turn when the player is hungry:
   choose a random row in the Table of Hunger Complaints;
   say "[hunger entry][paragraph break]".
 
Table of Hunger Complaints

hunger
"Gosh, you're starving."
"It feels as though you haven't eaten in days. Weeks, almost."
"The world seems to slow down and everything becomes sharper and brighter. You are a hunter, a hunter of foodstuffs."
"You find yourself staring at [the random visible thing that is not the player] and wondering how it would taste."
 
Test me with "eat apple / z / z / z / eat candy bar / z / z / z / z / z / z / z / z / z".

wi 9.11 Future events
rb 9.1 Food

391. Stone ★

A thing can have a rule as a property, if we like. Here we are going to allow the player to make a soup whose effects will depend on its ingredients. Each ingredient will have its own "food effect" rule, to be followed when the food is eaten.

Note that there are other, slightly less cumbersome ways to do the same thing -- we will see in the chapter on Rulebooks that we could make a "food effects rulebook" and then write a number of rules such as "food effects rule for carrots" or "food effects rule for the stone". Nonetheless, we demonstrate rules-as-properties here for the sake of thoroughness.

So:

"Stone"

A food is a kind of thing that is edible. A food has a rule called the food effect.

Carry out eating a food:

if a food is part of the noun:

repeat with item running through things which are part of the noun:

if item is a food, follow the food effect of the item;

follow the food effect of the noun.

Report eating a food:

say "You eat [the noun]. [diagnosis of the player]";

stop the action.

To say diagnosis of (victim - a person):

if the victim is ill:

say "You are ill.";

rule succeeds;

otherwise:

say "You are healthy. ";

if the victim is awake, say "You are wide awake. ";

otherwise say "You are sleepy. ";

if the victim is bright-eyed, say "Your eyesight is clear. ";

otherwise say "Your eyesight is dim. ";

if the victim is weak, say "You are weak. ";

otherwise say "You are strong. ";

if the victim is hungry, say "You are hungry.";

otherwise say "You are well-fed."

And now to provide some particular foods:

Some carrots are a food. The food effect of carrots is the bright-eye rule. This is the bright-eye rule: now the player is bright-eyed.
 
Some potatoes are a food. The food effect of the potatoes is the sleepiness rule. This is the sleepiness rule: now the player is sleepy.
 
The broth is a food. The indefinite article of the broth is "some". The food effect of broth is the filling rule. This is the filling rule: now the player is full.
 
The hambone is a food. The food effect of the hambone is the heartiness rule. This is the heartiness rule: now the player is strong. Instead of eating the hambone: say "You cannot just eat a bone!"
 
The poison ivy is a food. "Poison ivy grows nearby." The food effect of poison is the illness rule. This is the illness rule: now the player is ill.
 
A person can be bright-eyed or blind. The player is blind.
 
A person can be well or ill. The player is well.
 
A person can be hungry or full. The player is full.
 
A person can be strong or weak. The player is weak.
 
A person can be awake or sleepy. The player is sleepy.
 
The broth is in the kettle. The kettle is on the fire. The fire is in the Clearing. The Clearing is a room.
 
The player carries the hambone, the potatoes, and the carrots. The ivy is in the clearing.
 
Instead of examining the broth:
   if something is part of the broth, say "In the broth, [a list of things that are part of the broth] float[if exactly one thing is part of the broth]s[end if].";
   otherwise say "It is just a thin broth with no other ingredients."
 
Instead of inserting something into the broth: try inserting the noun into the holder of the broth.
 
Instead of taking the broth: say "You cannot take the broth in your bare hands."

And the following is a relatively unimportant nicety:

To sink is a verb.
 
After inserting a food which is not the broth into a container which contains the broth:
   now the noun is part of the broth;
   say "[The noun] [sink] into [the second noun], making the broth richer."
 
Test me with "x broth / eat hambone / put hambone in kettle / x broth / put potatoes in broth / x broth / eat carrots / eat broth / put ivy in kettle / eat ivy".

wi 19.3 New rules
rb 9.1 Food

196. Delicious, Delicious Rocks ★★★

In some cases, we may want to add new stages to action processing. One possibility is a stage where we check the sanity of what the player is trying to do before executing any of the other commands; so that we avoid, for instance

>EAT ROCK
(first taking the rock)
That's plainly inedible.

Here is how we might insert such a stage in our action processing, using rulebook manipulation.

"Delicious, Delicious Rocks"

Section 1 - Procedure

The sanity-check rules are a rulebook.

This is the sanity-check stage rule:

abide by the sanity-check rules.

The sanity-check stage rule is listed after the before stage rule in the action-processing rules.

Section 2 - Scenario

Candyland is a room. The lollipop tree is an edible thing in Candyland. The genuine rock is a thing in Candyland.

Sanity-check eating an inedible thing:

say "Your digestion is so delicate -- you're sure [the noun] wouldn't agree with you." instead.

Test me with "eat lollipop / eat rock".

Notice that now Inform does not try taking the rock before rejecting the player's attempt to eat it.

It is of course possible to get the same effect with

Before eating an inedible thing:
   say "Your digestion is so delicate -- you're sure [the noun] wouldn't agree with you." instead.

…and in a small game with few rules, there's not much reason to add an extra stage. The ability to modify the stages of action processing becomes useful when we have a fairly large game with sophisticated modeling and want to be sure that some kinds of message (such as the sanity-check) are always handled before other things that we might be doing at the before stage (such as generating implicit actions like opening doors before going through them).

wi 12.9 Check, carry out, report
rb 9.1 Food

🔗

RB §9.2 Bags, Bottles, Boxes and Safes

The kind "container" allows one thing to contain others. Things are sometimes containers automatically, sometimes by instruction:

The match is in the matchbox. The bucket is a container.

The matchbox, like the bucket, is a container. Containers come in all sizes and have a variety of behaviours, mainly controlled by the properties we give them: they can be "open" or "closed", "opaque" or "transparent" (when closed), "openable" or not, "lockable" or not, "enterable" or not. The basic ideas of containment are to do with carrying and sometimes hiding the contents, and Inform makes this easy. Allowing for locking and unlocking is again straightforward:

The strongbox is a locked container. The little steel key unlocks the strongbox.

Two built-in extensions enhance and modify the behavior of locks and keys: Locksmith automates a number of steps, automatically unlocking doors when trying to open them (for instance). Skeleton Keys allows us to define multiple keys that unlock the same object, rather than being restricted to one matching key per item.

For a container with a combination lock, rather than a key, see Safety ★; for a more sophisticated safe requiring digits dialed over multiple turns, see Eyes, Fingers, Toes ★.

Trachypachidae Maturin 1803 ★★ provides a bottle that is stoppered with a cork: when it is closed, the cork is part of the bottle, but otherwise the cork becomes a separate object we can carry around.

The normal assumption is that there is no problem with any two portable items being carried together, but in reality they may affect each other. (For effects like magnetism, or getting each other wet, or setting each other on fire, see the Physics chapter.) Here is a cat which, if boxed up with one or more items of food, will eat something each turn until all is gone:

The player carries a wicker basket and a scarlet fish. The cat is an animal in the wicker basket. The fish is edible.
 
Every turn when the cat is in a container (called the bag) and something edible (called the foodstuff) is in the bag:
   remove the foodstuff from play;
   say "With mingled sounds of mewing and chomping, the cat nibbles up [the foodstuff]."

The examples below provide subtler effects, adapting text to the current situation. In Cinco ★, the container's name changes depending on what it contains: putting beef in a taco allows the player to call it a SHREDDED BEEF TACO. In Unpeeled ★ and Shipping Trunk ★, the description of something inside a container changes according to other things are alongside it. This is taken further in Hudsucker Industries ★★, which describes the contents of a container as a group.

Finally, any action that destroys a container has to consider what to do with the things inside. Fallout Enclosure ★★★ demonstrates a zapping action that destroys cash registers and shelves but leaves their contents tidily behind.

Examples

298. Safety ★

"Safety"

The Vault is a room. "Snug yet paranoid, this represents the state of the art in cheerless security." The Safe is here. "A mammoth safe, with a dial which can spin to any number, has pride of place. It must weigh about the same as a small car, so don't get any ideas." Instead of opening the safe, say "The safe opens only when turned to the correct combination."

In the Safe is a silver florin. The Safe is closed and fixed in place. Understand "dial" as the Safe.

Spinning it to is an action applying to one thing and one number. Check spinning it to: if the noun is not the Safe, say "[The noun] does not spin." instead. Report spinning it to: say "Click! and nothing else happens."

Understand "spin [something] to [a number]" as spinning it to.

After spinning the closed Safe to 1384: now the Safe is open; say "Clonk! and the safe door swings slowly open, revealing [a list of things in the Safe]."

Test me with "open safe / spin safe to 1131 / open safe / spin safe to 1384 / x safe / get florin".

wi 17.6 Actions applying to kinds of value
rb 9.2 Bags, Bottles, Boxes and Safes

319. Cinco ★

It's fairly common that we want to be able to refer to a container in terms of what it has in it: a bottle of wine, a salt shaker, a chicken sandwich. The player is free to remove the contents again, and the object will go back to using its usual name:

"Cinco"

Cinco de Mayo Fundraiser is a room.

The taco shell is an edible thing in the Fundraiser. It is a portable container. It has carrying capacity 1.

Understand "[something related by containment] taco" as the taco.

Rule for printing the name of the taco shell while not inserting or removing:

if the taco contains something (called filling), say "[filling] taco";

otherwise say "taco shell";

omit contents in listing.

The player carries shredded beef. It is edible.

The taking action has an object called source (matched as "from").

Setting action variables for taking:

now source is the holder of the noun.

Report taking something from the taco shell:

say "You gingerly pick [the noun] out of the taco shell." instead.

Test me with "x taco / put shredded beef in taco / get taco / i / x shredded beef taco / get shredded beef / x shredded beef taco".

wi 17.16 Understanding things by their relations
rb 9.2 Bags, Bottles, Boxes and Safes

339. Shipping Trunk ★

First to lay some groundwork:

"Shipping Trunk"

A chest is a kind of container. A chest is always openable. A lid is a kind of supporter. A lid is part of every chest.

Before opening a chest when something (called the obstruction) is on a lid which is part of the noun:

say "Better remove [the obstruction]." instead.

A thing can be innocent or smelly.

The Storage Unit is a room. The shipping trunk is a closed chest in the Storage Unit. The trunk contains some garlic, a loaf of moldy sourdough, a mildewy bathtowel, a pair of unwashed socks, two dead trout, and a box of baking powder. The garlic, trout, sourdough, bathtowel, and socks are smelly. The baking powder is innocent.

The shipping trunk's lid supports a small card. The description of the small card is "'Please, please do not open this trunk.'"

After opening the trunk:

if the trunk had been open:

say "You steel yourself...";

continue the action;

otherwise:

say "There roils up from inside an indescribable funk, which, when you can see straight, you have no trouble attributing to the presence of [a list of smelly things in the trunk]. You also note [a list of innocent things in the trunk] in the corner.".

And now, with that preparation:

Before printing the name of the baking powder when the powder is in a container which contains a smelly thing: say "completely ineffective ".
 
Test me with "open trunk / examine card / get card / open trunk / get powder / inventory".

wi 18.10 Printing the name of something
rb 9.2 Bags, Bottles, Boxes and Safes

344. Unpeeled ★

"Unpeeled"

Scullery is a room. A sack is carried by the player. The sack contains a yellow onion. The player carries a cork.

Before printing the name of the onion while listing contents:

if the holder of the onion contains exactly 1 thing, say "single ".

Test me with "i / put cork in sack / i".

wi 18.13 Listing contents of something
rb 9.2 Bags, Bottles, Boxes and Safes

432. Eyes, Fingers, Toes ★

It is not difficult to implement a safe which can be set to a single number to open; but a more common scenario in the real world is for the safe to open on a sequence of numbers when they have been dialed in the right order.

For IF, this means that we have to keep running track of the last N digits the player has dialed, dropping the first digit and adding a new one to the end each time the player re-dials the safe. This is a perfect occasion for lists:

"Eyes, Fingers, Toes"

The Addams Wine Cellar is a room. It contains a closed lockable locked container called a safe.

The safe has a list of numbers called the current combination.

The safe has a list of numbers called the true combination. The true combination of the safe is {2, 10, 11}.

Understand "set [something] to [a number]" as setting it numerically to. Setting it numerically to is an action applying to one thing and one number.

Instead of examining the safe:

if the number of entries in the current combination of the safe is 0,

say "You haven't dialed the safe to any combination yet.";

otherwise say "You have dialed the safe to [the current combination of the safe].".

Check setting something numerically to (this is the block setting numerically rule):

say "[The noun] cannot be set."

Instead of setting the safe numerically to the number understood:

truncate the current combination of the safe to the last 2 entries;

add the number understood to the current combination of the safe;

if the safe is locked and the current combination of the safe is the true combination of the safe:

say "You dial [the number understood], and [the safe] gives a joyous CLICK.";

now the safe is unlocked;

otherwise if safe is unlocked and the safe is closed and the current combination of the safe is not the true combination of the safe:

say "You spin the dial, and [the safe] snicks locked.";

now the safe is locked;

otherwise:

say "You dial [the number understood] on the safe."

Test me with "x safe / set safe to 10 / x safe / set safe to 29 / x safe / set safe to 2 / x safe / set safe to 10 / x safe / set safe to 11 / open safe / set safe to 14 / close safe / set safe to 15 / open safe".

wi 21.11 Variations: arrays, logs, queues, stacks, sets, sieves and rings
rb 9.2 Bags, Bottles, Boxes and Safes

340. Trachypachidae Maturin 1803 ★★

"Trachypachidae Maturin 1803"

A bottle is a kind of container. Bottles are usually openable, transparent, and closed. A cork is a kind of thing. A cork is in every bottle.

Understand "cork [something]" as corking.

Understand the command "stopper" as "cork".

Understand "uncork [something]" as uncorking.

Corking is an action applying to one thing.

Check corking:

if the noun is not a bottle, say "[The noun] cannot be corked." instead.

Carry out corking:

try closing the noun.

Uncorking is an action applying to one thing.

Check uncorking:

if the noun is not a bottle, say "[The noun] cannot be uncorked." instead.

Carry out uncorking:

try opening the noun.

Understand "close [something] with [something preferably held]" as corking it with.

Understand "cork [something] with [something preferably held]" as corking it with.

Corking it with is an action applying to one thing and one carried thing.

Check corking it with:

if the noun is not a bottle, say "[The noun] cannot be corked." instead;

if the second noun is not a cork, say "[The second noun] will not fit in [the noun]." instead.

Carry out corking it with:

try inserting the second noun into the noun instead.

Instead of closing a bottle:

if a cork (called the item) is carried by the player, try inserting the item into the noun instead;

otherwise say "You need a stopper of some kind."

Instead of opening a bottle:

if a cork (called the item) is in the noun, try taking the item instead;

otherwise say "[The noun] has no stopper."

Carry out inserting a cork into a bottle:

now the second noun is closed.

After inserting a cork into a bottle:

say "You stopper [the second noun] with [the noun]."

Before taking a cork when the noun is in a closed bottle (called the item):

now the item is open.

Instead of taking a cork when the noun is in a bottle (called the item):

move the noun to the player;

say "You pull [the noun] from [the item]." instead.

Before printing the name of a bottle (called target) while not inserting, taking, searching, or removing:

if the target is closed, say "sealed ";

otherwise say "now open ".

After printing the name of a bottle (called target) while not inserting, searching, examining, or removing:

if the target contains a noncork thing, say " containing [a list of noncork things in the target]";

omit contents in listing.

Instead of examining a bottle:

say "[The noun] contains [a list of noncork things in the noun]."

Definition: a thing is noncork if it is not a cork.

The Doctor's Cabin is a room. "A dark, cramped triangle, like a slice of cake, except that its sharp end has been cut off: and so low that a moderately tall man would strike his head on the deck above if he were to stand upright. Every free surface is covered with sheets of best Venetian looking-glass, to increase the light filtering in. Long use and the carpenter's ingenuity have packed in a folding cot and table, and lockers are built into unlikely places: lockers filled with specimens, skeletons, sketches, drafts and serial letters." The jug is a bottle in the Doctor's Cabin. The jug contains a beetle. The description of the beetle is "The doctor assures you that it is a nondescript."

Test me with "get jug / x jug / open jug / x jug / i / x cork / cork jug / i / uncork jug / i / x jug / get beetle / i / close jug / i / x jug".

wi 18.10 Printing the name of something
rb 9.2 Bags, Bottles, Boxes and Safes

342. Hudsucker Industries ★★

In this scenario, the player starts with a bag full of unsorted letters. These can be polite or rude, but he won't know which until he has examined them. What's more, he is allowed to sort the letters, in which case a group of letters will be shown as (for instance) "two polite letters"; but a group of mixed letters, even if they have all been read, will be called "unsorted letters".

Further, the player should be allowed to refer to sorted letters by tone, but not unsorted letters.

To do this, we'll need printing the name… and printing the plural name…, as well as some special understanding rules.

"Hudsucker Industries"

Tone is a kind of value. The tones are effusive, affectionate, polite, curt, and flamingly rude.

A letter is a kind of thing. The description of a letter is usually "On inspection, it turns out to be quite [tone]." A letter has a tone. The tone of a letter is usually polite.

A letter can be read or unread. A letter is usually unread. Carry out examining a letter: now the noun is read.

Before printing the name of a read letter: say "[tone] ".

Before printing the name of an ungrouped letter: say "random ".

Before printing the plural name of a letter (called the subject):

if the subject is grouped:

say "[tone] ";

otherwise if the number of unread letters which are next to the subject is 0:

say "unsorted ".

After printing the plural name of a letter (called the subject):

if the number of read letters which are next to the subject is 0, say " (all unread, at the moment)" instead;

if the number of unread letters which are next to the subject is greater than 0, say " (some as yet unread)" instead.

Proximity relates a thing (called X) to a thing (called Y) when the holder of X is the holder of Y. The verb to be next to means the proximity relation.

Definition: a letter is grouped:

if it is unread, no;

if the number of unread letters next to it is greater than 0, no;

repeat with item running through letters which are next to it:

if the tone of item is not the tone of it, no;

yes.

Definition: a letter is ungrouped if it is not grouped.

The Mailroom is a room. "Usually a thrumming hive of bee-like workers, but you got in early to get a jump on the day's work."

The satchel is carried by the player. Two flamingly rude letters are in the satchel. Five polite letters are in the satchel.

The mail wall are fixed in place in the mailroom. "Before you is a wall of mailboxes, including [a list of mailboxes which are part of the mail wall]."

The plural of mailbox is mailboxes. A mailbox is a kind of container. The CEO box is a mailbox. The Hold box is a mailbox. The Trash box is a mailbox. Understand "mailbox" as a mailbox.

Now, there's a good bit of interaction to streamline. We intend that the player will be taking letters from the satchel, reading them, and putting them (perhaps grouped) into boxes. Our interaction rules should assist in this process as much as possible. To start with, the player will be most likely to examine letters he hasn't read yet:

Does the player mean examining a letter (called the subject):
   if we have examined the subject, it is very unlikely;
   it is very likely.

The rules about taking are more subtle: the player is more likely to want to take an ungrouped letter than a grouped one; he is more likely to want one from the satchel than not; and he is most unlikely to want to take a letter (grouped or ungrouped) that he is already holding.

Does the player mean taking a letter (called subject) which is grouped:
   if the player carries the subject, it is very unlikely;
   if the subject is in the satchel, it is possible;
   it is unlikely.
 
Does the player mean taking a letter (called subject) which is ungrouped:
   if the player carries the subject, it is very unlikely;
   if the subject is in the satchel, it is very likely;
   it is possible.

And finally, we will assume by default that anything other than examining or taking is most likely to apply to a letter he's already identified:

Does the player mean doing something other than examining or taking with a letter (called the subject):
   if we have examined the subject, it is likely;
   it is unlikely.

And we would also like to understand properties under the same circumstances as printing -- a letter will be identifiable as "polite" if it's already been read and it is either by itself or in a sorted stack of polite letters, but otherwise not. What's more, to make it possible to disambiguate commands in the other direction, we'll call any unsorted letter "random", to represent that the player doesn't know what it is.

Understand the tone property as referring to a letter when the item described is grouped. Understand "random" as a letter when the item described is ungrouped.
 
When play begins:
   now every mailbox is part of the mail wall;
   repeat with switch count running from 1 to 5:
      move a random letter to the satchel.
 
Test me with "inventory / examine letter / get letter / i / put letter in ceo box / inventory / get letter / x letter / g / g / i / x letter / g / g / i / put letter in hold box / get letter / g / g / i".

That last "repeat" is merely a device to shuffle the order of items in the satchel so that the player will not always encounter the letters in a neatly presorted order, despite our defining them that way. (Of course, that means that the test produced by TEST ME cannot be very exciting…)

wi 18.11 Printing the plural name of something
rb 9.2 Bags, Bottles, Boxes and Safes

35. Fallout Enclosure ★★★

It may not be immediately obvious why we might want to create new intermediate categories of the kinds hierarchy. But there may be times, for instance, where we would like to make an action that applies in the same way to both containers and supporters, but to nothing else in the game. To avoid creating two nearly-identical rules, we would instead roll the two categories together into one, on the principle that duplicating source text is usually a sign of bad design.

So for instance let's say the player is able to zap objects to make them go away, but any contents -- things inside a container or on top of a supporter -- should always be left as residue. Here's one way we might do this:

"Fallout Enclosure"

Section 1 - Procedure

An enclosure is a kind of thing. A container is a kind of enclosure. A supporter is a kind of enclosure.

Understand "zap [something]" as zapping. Zapping is an action applying to one thing. The Zapping action has a list of things called the remnants.

Carry out zapping an enclosure:

if the noun holds something:

now the remnants is the list of things held by the noun;

repeat with N running through the remnants:

move N to the holder of the noun.

Carry out zapping:

now the noun is nowhere.

Report zapping:

say "You zap [the noun], destroying [them][if the remnants is not empty] and leaving [the remnants with indefinite articles] behind[end if]."

Section 2 - Scenario

SuperDuperMart is a room. SuperDuperMart contains some shelves and a cash register.

The shelves support a bottle of Buffout and a container of Jet.

The cash register contains some prewar money, a coin purse, and a bottle cap. The coin purse contains a prewar nickel. It is closed.

The cash register is closed and locked.

Test me with "zap shelves / zap buffout / zap register / zap purse".

wi 3.23 Parts of things
rb 9.2 Bags, Bottles, Boxes and Safes

🔗

RB §9.3 Clothing

A person can wear any (portable) thing which has the "wearable" property. (This property seldom needs to be quoted because it is deduced automatically from sentences like "Trevor wears a red hat.")

In most traditional IF, clothing is only used when it is exceptional in some way. That is, we ignore the three to eight different garments most people are wearing at any given time - the everyday clothes which people wear without thinking about them - and only simulate the unexpected extras: a borrowed jaunty red hat, a radiation-proof space suit, and so on.

These unusual garments turn up only occasionally in play and usually one at a time, so Inform does not normally provide rules to restrict how much or little is worn, or in what unlikely combinations. Get Me to the Church on Time ★★★ categorises clothing by body area (trousers for lower body, shirts for upper); Bogart ★★★ by layer, distinguishing underwear from outer garments. What Not To Wear ★★ combines both into a general-purpose system adequate for most kinds of clothing situations.

Hays Code ★ is a somewhat stripped down version.

Clothes are normally single things which have no function other than display and concealment, but Being Prepared ★ gives them pockets which act as containers, and Some Assembly Required ★ allows clothes to be stitched together from pieces of cloth.

Examples

56. Being Prepared ★

"Being Prepared"

A jacket is a kind of thing. A jacket is always wearable.

A pocket is a kind of container. A pocket is part of every jacket. The carrying capacity of a pocket is always 2.

After examining a jacket:

let target be a random pocket which is part of the noun;

say "[The target] contains [a list of things in the target]."

Now we've created the rules that will govern any specific jackets we might happen to put in our game: each one will always have one pocket, which will be able to contain no more than two things. The description of "a list of things" is text with a list, which we will learn about further in a few sections.

Next we might want to create the environment and an actual example of the jacket kind:

Tent is a room. "A dome made of two flexible rods and a lot of bright green ripstop nylon. It bills itself as a one-man tent, but you'd call it a two-dwarf tent: there is no way to arrange yourself on its square floor so that you can stretch out completely."
 
The hoodie is a jacket. "Your hoodie is balled up in the corner." The description of the hoodie is "Both elbows are stained from yesterday's entrenching project."
 
The hoodie's pocket contains a Swiss army knife and a folded map. The hoodie is in the Tent.

Notice that, since Inform has created a pocket for the hoodie, we can now refer to it by name in our source, giving it any additional properties we need to define. Here we simply put a few items into it.

The player wears a whistle. The description of the whistle is "To frighten bears."
 
Test me with "x hoodie / get hoodie / get knife / get map / i / put hoodie in pocket / put whistle in pocket / put map in pocket / put knife in pocket / i".

Notice that Inform automatically refuses to put the hoodie into its own pocket: as a default, a container cannot contain something of which it is itself a part.

wi 4.15 Assemblies and body parts
rb 9.3 Clothing

332. Some Assembly Required ★

We now have the mechanisms in place to do some fairly sophisticated renaming of objects. For instance:

"Some Assembly Required"

Garment type is a kind of value. The garment types are vest, t-shirt, polo shirt, mandarin blouse, button-down, shell, experiment.

Every turn:

assign identities.

When play begins: assign identities.

To assign identities:

repeat with item running through torsos:

reassess item.

To reassess (item - a torso):

if the number of things which are part of the item is 0:

now garment type of the item is vest;

rule succeeds;

if exactly two short sleeves are part of the item:

if a collar is part of the item,

now garment type of the item is polo shirt;

otherwise now garment type of the item is t-shirt;

rule succeeds;

if exactly two long sleeves are part of the item:

if a collar is part of the item,

now garment type of the item is button-down;

otherwise now garment type of the item is mandarin blouse;

rule succeeds;

if a collar is part of the item and the number of sleeves which are part of the item is 0, now garment type of the item is shell;

otherwise now garment type of the item is experiment.

Before cutting something which is worn by the player:

try taking off the noun.

Instead of cutting something when something is part of the noun:

say "You cut up [the noun], snipping off [a list of things which are part of the noun].";

now every thing which is part of the noun is held by the holder of the noun.

Instead of cutting something which is part of something:

say "You carefully snip [the noun] free.";

now the player carries the noun.

Rule for printing the name of a torso: say "[garment type]".

A torso is a kind of thing. A torso is always wearable. Understand "shirt" or "blouse" as a torso. A torso has a garment type. Understand the garment type property as describing a torso. A sleeve is a kind of thing. A short sleeve is a kind of sleeve. A long sleeve is a kind of sleeve. A collar is a kind of thing.

Understand "sew [something] to [something]" as affixing it to. Affixing it to is an action applying to two things. Carry out affixing something to something: now the noun is part of the second noun. Report affixing something to something: assign identities; say "You sew [the noun] on, creating [a second noun]." Understand the command "stitch" as "sew".

Instead of affixing something to something when the second noun is worn: say "You're wearing [the second noun]!"

Instead of affixing a torso to something:

if the second noun is a torso, say "Couture for Siamese twins is a daring field, but a bit of a niche market.";

otherwise try affixing the second noun to the noun.

Instead of affixing a sleeve to something when at least two sleeves are part of the second noun: say "[The second noun] already sports [a list of sleeves that are part of the second noun]."

Instead of affixing a collar to something when a collar is part of the second noun: say "[The second noun] already sports [a list of collars that are part of the second noun]."

Instead of examining something when something is part of the noun: say "Stitched to [the noun] [is-are a list of things which are part of the noun]."

Here is where the issue of precedence arises. We want to encourage Inform to select a cuttable object that is part of something else, rather than one of the spares:

Definition: a thing is removable if it is part of something. Understand "cut [removable thing]" as cutting.
 
The Boutique is a room. "Still festively strewn with the confetti and streamers of the Grand Opening party, and still almost totally customer-free."
 
The player carries a torso. The player carries three short sleeves. The player carries two long sleeves. The player carries two collars.
 
Test me with "sew collar to shirt / i / sew short sleeve to shirt / g / i / x polo shirt / cut collar / i / cut shirt / sew long sleeve to shirt / i / sew long sleeve to shirt / i / sew collar to shirt / g / i / wear button-down".

wi 17.22 Precedence
rb 9.3 Clothing

338. Hays Code ★

The following burlesque was considered too much for the tender readers of Chapter 3, since it involved explicit use of listing and persuasion:

"Hays Code"

The Movie Set is a room. Clark Gable is a man in the Movie Set. "Clark leans on a polystyrene pillar, wearing [a list of unconcealed things worn by Clark] with his usual aplomb." Persuasion rule for asking Clark to try doing something: persuasion succeeds.

Clark is wearing a pin-striped suit and a pink thong. Rule for deciding the concealed possessions of Clark: if the particular possession is the thong and Clark is wearing the suit, yes; otherwise no.

Test me with "clark, remove suit / look / clark, remove thong / look".

wi 18.9 Deciding the concealed possessions of something
rb 9.3 Clothing

242. What Not To Wear ★★

"What Not To Wear"

Section 1 - Overlying and Underlying

We start by borrowing some of the same ideas from the Bogart example, but we're also going to make a kind called "garment-element". This kind will include both garments (objects of clothing) and body parts (things that can be covered by clothing); using it allows us to restrict the way our underlying and overlying relations apply, which will make them a bit faster at run-time.

A garment-element is a kind of thing.
 
Underlying relates various garment-elements to various garment-elements with fast route-finding. The verb to underlie means the underlying relation. The verb to be under implies the underlying relation.
 
Check taking off:
   if the noun underlies something (called the impediment) which is worn by the player, say "[The impediment] [are] in the way." instead.
 
Carry out taking off:
   now the noun is not underlaid by anything.
 
Report taking off something:
   say "[We] [are] now wearing [a list of uppermost things worn by the player]." instead.
 
Definition: a garment-element is uppermost if it is not under something opaque.

Here we've expanded on the previous ideas of 'uppermost' because it is possible for an upper layer to reveal what lies beneath: a tie, a clear plastic trenchcoat, an open-knit sweater, etc. We'll make such items transparent.

Before taking off something which underlies something which is worn by the player:
   while the noun underlies something (called the impediment) which is worn by the player:
      say "(first removing [the impediment])[command clarification break]";
      silently try taking off the impediment;
      if the noun underlies the impediment, stop the action.
 
Overlying relates various garment-elements to various garment-elements. The verb to overlie means the overlying relation.
 
Covering relates a garment-element (called A) to a garment-element (called B) when the number of steps via the overlying relation from A to B is greater than 0. The verb to cover means the covering relation.
 
Before wearing something when a garment which covers the noun is worn by the player:
   while the player wears a garment (called the impediment) which covers the noun:
      say "(first removing [the impediment])[command clarification break]";
      silently try taking off the impediment;
      if the player is wearing the impediment, stop the action.
 
Carry out wearing:
   repeat with hidden item running through things worn by the player:
      if the noun covers the hidden item, now the hidden item underlies the noun.
 
Instead of looking under something which is worn by the player:
   if something (called the underwear) underlies the noun, say "[We] [peek] at [the underwear]. Yup, still there.";
   otherwise say "Just [us] in there."
 
Instead of taking inventory:
   say "[if the player carries something][We]['re] carrying [a list of things carried by the player][else][We]['re] empty-handed[end if][if the player wears something]. [We] [are] wearing [a list of uppermost garments worn by the player][end if]."
 
To peek is a verb.
 
Section 2 - Regional Coverage

Here we draw in the idea that different clothes go over different areas of the body, and that they should be in competition with each other only if both sets of clothes belong at the same level over the same body area.

Before wearing something:
   let N be the layering depth of the noun;
   repeat with item running through things worn by the player:
      if the layering depth of the item is N and the item covers a body-part which is covered by the noun:
         say "(first taking off [the item])[command clarification break]";
         silently try taking off the item;
         if the player wears the item, stop the action.

This may seem like overkill, but it allows us to create garments that cover different subsets of the body -- pants and shirt vs. a dress, for instance.

To decide what number is the layering depth of (chosen garment - a thing):
   let N be 0;
   if the chosen garment covers a body-part (called base):
      let N be the number of steps via the overlying relation from the chosen garment to the base;
   decide on N.

To help with modeling, we'll give everyone body parts, broken down according to their relevance to clothing:

A body-part is a kind of garment-element. A torso, a seat, a head, pair of legs, and pair of feet are kinds of body-part.

If we wanted to allow gloves, we might put in hands as well; but this is enough for now.

One head is part of every person. One torso is part of every person. One pair of legs is part of every person. One pair of feet is part of every person. One seat is part of every person.

And now we make some categories of clothing:

A garment is a kind of garment-element. A garment can be transparent. A pair of pants, a pair of underpants, a foundation garment, a pair of socks, a pair of shoes, a jacket, a hat, a dress, and a shirt are kinds of garment.
 
The plural of pair of pants is pairs of pants. The plural of pair of underpants is pairs of underpants. The plural of pair of socks is pairs of socks. The plural of pair of shoes is pairs of shoes.
 
A pair of pants, a pair of underpants, a foundation garment, a pair of socks, a pair of shoes, a jacket, a hat, a dress, and a shirt are usually wearable.
 
When play begins:
   now every pair of socks overlies every pair of feet;
   now every pair of shoes overlies every pair of socks;
   now every pair of underpants overlies every seat;
   now every pair of pants overlies every pair of underpants;
   now every foundation garment overlies every torso;
   now every jacket overlies every shirt;
   now every jacket overlies every dress;
   now every hat overlies every head;
   now every dress overlies every pair of underpants;
   now every dress overlies every foundation garment.
 
Section 2 - The Scenario
 
The Dressing Room is a room.
 
The player carries some capris, some jeans, a corset, a plunge bra, a thong, boy-shorts, black satin D'Orsay pumps, brown leather boots, a camisole, a cocktail dress, a bolero, a cashmere shrug, a sheer wrap, and a linen tunic.
 
The woolly socks are a pair of socks.
The D'Orsay pumps and the brown leather boots are pairs of shoes.
The thong and the boy-shorts are pairs of underpants.
The capris and the jeans are pairs of pants.
The tunic is a shirt.
The camisole, the corset, and the plunge bra are foundation garments.
The cocktail dress is a dress.
The bolero, the cashmere shrug, and the sheer wrap are jackets. The shrug and the wrap are transparent.
 
Test me with "wear capris / wear jeans / i / wear thong / i / wear dress / wear corset / wear dress / i / wear wrap / i / wear boots / wear pumps / i".

wi 13.16 What are relations for?
rb 9.3 Clothing

46. Get Me to the Church on Time ★★★

Inform's default handling of wearable things does not make any rules about what can be worn together. Suppose, however, we have a game in which there are a large number of different garments, and we want to keep the player from wearing (say) more than one pair of pants at once:

"Get Me to the Church on Time"

A pair of pants and a shirt are kinds of thing. A pair of pants and a shirt are usually wearable.

Some golf pants are a pair of pants. The description is "Checked in red and green, with tiny frolicking gophers every few inches."

Some tuxedo trousers are a pair of pants. The description is "Black, pressed, and slimming."

The frilly shirt is a shirt. The description of the frilly shirt is "She insisted."

The polo shirt is a shirt. The description is "Turquoise and bright yellow, the colors selected by your golfing buddies."

The player wears the golf pants and the polo shirt. The player carries the tuxedo trousers and the frilly shirt.

The Wedding Chapel Dressing Room is a room. "The bride's dressing room is a lavish suite with closets, hangers, dressmaker's dummies, boxes of straight pins and sewing notions, combs, lotions, brushes, and hair fixatives, plus room for fifteen female attendants and a photographer. Before they shoved you out of the room you even got a glimpse of a small reference library including '1001 French Braids' and 'Corset-Lacing For Beginners.'

This is the groom's dressing room. You get a framed photograph of Elvis, a dusty mirror, and the floor space of an average toilet stall."

The dusty mirror and the photograph of Elvis are scenery in the Dressing Room. The description of the mirror is "You can't really get more than a silhouette impression of yourself." The description of Elvis is "He reminds you that you'd better get out there before the organist switches to Hound Dog."

And now the rule itself, borrowed from a later chapter:

Instead of wearing a pair of pants when the player is wearing a pair of pants (called the wrong trousers):
   say "You'll have to take off [the wrong trousers] first."
 
Instead of wearing a shirt when the player is wearing a shirt (called the wrong top):
   say "You'll have to take off [the wrong top] first."
 
When play begins:
   say "From the other side of the door, you hear the organist move on from his instrumental interpretation of 'I Wanna Hold Your Hand' to a somewhat more spirited rendition of 'Help! I Need Somebody!'. Okay, okay, but you've been rushing things along since the 16th fairway, and you can't be more than a half-hour late... Surely that mother of hers can't blame you for that?"
 
Test me with "i / x trousers / wear trousers / x golf pants / take off golf pants / wear trousers / x frilly shirt / x polo shirt / wear frilly shirt / doff polo shirt / wear frilly shirt".

If we wanted to, we could make similar kinds for hats, shoes, and so on, and have a simple but effective system of clothing. A more complicated treatment might keep track of layering and describe the player's outfit differently depending on which clothes were outermost -- an example for a later chapter.

wi 4.4 Plural assertions
rb 9.3 Clothing

234. Bogart ★★★

We have two things to keep track of with our layering clothing: what currently is covering something else; and what can cover something else. This implementation goes for a fairly simple treatment, assuming that each item of clothing will completely conceal those beneath it, and that we are not implementing entire sets of shirts, jackets, etc. But it will do for a demonstration.

"Bogart"

Section 1 - Clothing Behavior

First we make our relation to represent what *is* underneath another item:

Underlying relates one thing to various things. The verb to underlie means the underlying relation. The verb to be under implies the underlying relation.

And now we prevent taking a lower layer off before the thing that is worn over it:

Before taking off something which underlies something (called the impediment) which is worn by the player:
say "(first removing [the impediment])[command clarification break]";
silently try taking off the impediment;
if the noun underlies something which is worn by the player, stop the action.
 
Check taking off:
   if the noun underlies something (called the impediment) which is worn by the player, say "[The impediment] [are] in the way." instead.
 
Carry out taking off:
   now the noun is not underlaid by anything.
 
Report taking off something:
   say "[We] [are] now wearing [a list of uppermost things worn by the player]." instead.
 
Definition: a thing is uppermost if it is not under something.

That covers order of clothing removal, but we also want to restrict what can be worn on top of what else. This time we need Inform to have some idea of what customarily can be layered on top of what other clothing:

Overlying relates one thing to various things. The verb to overlie means the overlying relation.
 
Covering relates a thing (called A) to a thing (called B) when the number of steps via the overlying relation from A to B is greater than 0. The verb to cover means the covering relation.

With these definitions, we can say that a jacket should go over a shirt and a shirt over an undershirt (say), and then Inform will know that a jacket will cover both shirt and undershirt.

Before wearing something when something (called the impediment) which covers the noun is worn by the player:
   while the player wears something which covers the noun:
      say "(first removing [the impediment])[command clarification break]";
      silently try taking off the impediment;
      if the player is wearing the impediment, stop the action.
 
Carry out wearing:
   if the noun covers something (called the hidden item) worn by the player, now the hidden item underlies the noun.
 
Instead of looking under something which is worn by the player:
   if something (called the underwear) underlies the noun, say "[We] [peek] at [the underwear]. Yup, still there.";
   otherwise say "Just [us] in there."
 
Instead of taking inventory:
   say "[if the player carries something][We]['re] carrying [a list of things carried by the player][else][We]['re] empty-handed[end if][if the player wears something]. [We] [are] wearing [a list of uppermost things worn by the player][end if]."
 
To peek is a verb.

Notice that our inventory only describes the things that the player can see as the upper layer of clothing.

Section 2 - The Scenario
 
The Trailer is a room. "A full-length mirror is the main amenity in here, and that suits you just fine."  The full-length mirror is scenery in the Trailer. Instead of examining or searching the mirror, try taking inventory.
 
The player wears a fedora, a jacket, a shirt, some undershorts, an undershirt, some slacks, a pair of socks, and a pair of shoes.
 
The shirt underlies the jacket. The pair of socks underlies the pair of shoes. The undershorts underlie the slacks. The undershirt underlies the shirt.
 
The jacket overlies the shirt. The shoes overlie the socks. The slacks overlie the undershorts. The shirt overlies the undershirt.
 
Test me with "x mirror / remove fedora / remove jacket / remove shirt / remove slacks / remove undershirt / remove shoes / remove socks / remove shorts / remove undershorts".

If we further wanted to prevent the player from taking off clothes in inappropriate places, we might add something like this:

Instead of taking off something in the presence of someone who is not the player:
   say "[We] [are] far too modest to strip in public."

wi 13.10 Defining new prepositions
rb 9.3 Clothing

🔗

RB §9.4 Money

Money could be anything which the two people in a bargain both agree is valuable. Here, the player and an ogre agree on a copper coin as money:

The player carries a copper coin. The ogre carries a rock cake. The cake is edible.
 
Instead of giving the coin to the ogre:
   now the ogre carries the coin;
   now the player carries the cake;
   say "The ogre grunts and hands you a rock cake."

Now Inform does provide an action, "buying", and a command for it, BUY, but they ordinarily respond simply "Nothing is on sale." This is no longer true, so we should make BUY CAKE work. The difficulty here is that a command like BUY CAKE does not specify what should be handed over in exchange. Here we just check that the player has the coin, but in principle we could check for any of a range of monetary tokens - coins, notes, cheque book, debit card, and so on.

Instead of buying the cake:
   if the player has the coin, try giving the coin to the ogre;
   otherwise say "You have no money."

In more advanced economies, where shopping replaces barter, the seller will stock a wide range of differently priced goods. For a tabulated catalogue of wares, see Introduction to Juggling ★★★: to allow the player to negotiate prices, see Money for Nothing ★★. In both of those examples, the player's current financial worth is simulated only as a current total amount of money carried - say, $2.50. This is typical, because in most situations what matters is how much money is in the pocket, not how it is made up. Money behaves more like a liquid than a set of items: hence terms like "liquidity", "cash flow" or Frozen Assets ★ - the name of the simplest example demonstrating this. If we really need a comprehensive simulation down to pieces of currency - where it makes a difference carrying four quarters rather than a dollar bill, because the quarters can be fed into a vending machine - see Nickel and Dimed ★★★.

Fabrication ★★ takes the problem in a different direction, making calculations about the cost of a new garment based on the price of the pattern, the quantity of fabric required, and the value of the fabric type chosen -- showing off what we can do with unit multiplication in Inform.

Widget Enterprises ★ explores the challenge of pricing widgets for maximum profit, given certain necessary costs and customers with varying willingness to pay.

Examples

263. Widget Enterprises ★

Suppose the player is responsible for pricing at Widget Enterprises. Widget production entails a certain fixed cost as well as a cost per unit; and somewhere out in the world there are a number of customers interested in purchasing widgets, but the player starts without knowing what this distribution looks like.

We can express the profits as an equation: the total made by selling widgets, minus the cost thereof.

The Table of Customers holds the data about customer preferences, and whenever the player selects a widget price, we consult it to determine how many customers in total would be willing to buy at that price.

"Widget Enterprises"

Widget Stand is a room.

A monetary value is a kind of value. $1.99 specifies a monetary value with parts dollars and cents.

Equation - Profit Equation

P = nV - (F + nC)

where P is a monetary value, F is the fixed cost, C is the unit cost, V is a monetary value, and n is a number.

The fixed cost is a monetary value that varies. The fixed cost is $5.00.

The unit cost is a monetary value that varies. The unit cost is $10.66.

Table of Customers

base	maximum value
2	$26.00
5	$20.00
8	$15.00
2	$13.50
1	$9.00

To decide what number is the units sold at (V - a monetary value):

let total units be 0;

repeat through the Table of Customers:

if V is less than the maximum value entry:

increase total units by the base entry;

decide on total units.

Understand "set price to [monetary value]" as setting price to. Setting price to is an action applying to one monetary value.

Carry out setting price to:

let V be the monetary value understood;

let n be the units sold at the monetary value understood;

let P be given by the Profit Equation;

say "You set the price of your widgets to [V], resulting in sales of [n] unit[s] and ";

if P is less than $0.00:

let L be $0.00 - P;

say "a loss of [L].";

otherwise if P is $0.00:

say "break even.";

otherwise:

say "a profit of [P].".

Test me with "set price to $0.00 / set price to $100.00 / set price to $15.00 / set price to $8.00 / set price to $25.00 / set price to $14.99".

As written this will be a rather dull guessing game for the player; more interesting would be to enhance it into a fuller economic simulator with more control over fixed costs and customer price points.

wi 15.18 Equations
rb 9.4 Money

264. Frozen Assets ★

In our brave new world, everything will have a price, so we had better spell this out.

"Frozen Assets"

Price is a kind of value. $10.99 specifies a price. A thing has a price. The price of a thing is usually $0.00. After examining something for sale, say "It can be yours for [the price of the noun]."

Now we assume a simple shopping model in which the player can't take anything without paying for it.

Definition: a thing is free if the price of it is $0.00.
Definition: a thing is for sale if it is not free.
 
Instead of taking something for sale:
   say "You'll have to pay for that."
 
Before buying something for sale when the money is not in the wallet:
   say "You're broke." instead.
 
Before buying something for sale when the money is free:
   say "You're broke." instead.
 
Before buying something for sale when the price of the money is less than the price of the noun:
   say "Your funds do not run to the price of [the noun]." instead.
 
Instead of buying something:
   decrease the price of the money by the price of the noun;
   say "You fork over [the price of the noun] for [the noun], leaving yourself with [the price of the money].";
   if the money is free:
      now the money is nowhere;
   now the price of the noun is $0.00;
   now the player is carrying the noun.

The player's money object is going to be a bit unusual, because it has value but cannot itself be bought.

The player carries a wallet. The wallet contains money. The price of the money is $4.50. The printed name of the money is "[price of the money] in cash". Understand "cash" as the money.
 
Instead of taking the money:
   say "Best to leave it alone until you need to buy something."
 
Instead of buying something free:
   say "[The noun] is yours already."
 
Instead of buying the money:
   say "The money belongs to you; you buy things with it."

Now we just need something to buy.

The Dessert Parlor is a room. "An underlit, over-crowded room campily furnished with a lot of gilt-frame mirrors and twinkle lights: it is essentially a brothel of food. The service is slow at best, and on Saturday nights glacial. However. The wares on display more than make up for these trivial inconveniences."
 
The vanilla ice cream is an edible thing in the Parlor. The price of the ice cream is $2.45. The description is "In the scale of ice creams, you recognize this as a very inferior vanilla because it has no adjectives in the title."
 
The raspberry tart is an edible thing in the Parlor. The price of the tart is $4.50. The description is "An almond-laced shell packed with raspberries-under-glaze."
 
The syllabub is an edible thing in the Parlor. The price of the syllabub is $4.25. The description is "Whipped cream, alcohol, and lime juice, a substance without any redeeming food value whatever."
 
The espresso cake is an edible thing in the Parlor. The price of the espresso cake is $5.50. The description is "A lethal wedge of purest blackness."
 
Test me with "inventory / examine syllabub / get syllabub / buy syllabub / drop it / get it / buy raspberry tart".

Implementing caloric units for this scenario is left as an exercise for the reader.

wi 15.19 Arithmetic with units
rb 9.4 Money

265. Money for Nothing ★★

"Money for Nothing"

Section 1 - Prices and Bargaining

Price is a kind of value. $10.99 specifies a price with parts dollars and cents (optional, preamble optional).

A person has a price called wealth. The wealth of the player is $15.

A thing has a price called minimum value. The minimum value of a thing is usually $0.50.

A thing has a price called desired value. The desired value of a thing is usually $5.00.

Offering it for is an action applying to one price and one visible thing.

Understand "offer [price] for [something]" as offering it for.

After taking inventory, say "You have [the wealth of the player]."

Check offering it for:

if the price understood is greater than the wealth of the player, say "You don't have that kind of cash." instead;

if the second noun is not carried by someone, say "There's no one in a position to sell you [the second noun]." instead;

if the second noun is carried by the player, say "[The second noun] is already yours." instead;

if the minimum value of the second noun is greater than the price understood, say "[The holder of the second noun] cackles disdainfully. 'If yer just here to insult me you can take your business elsewhere!' he says." instead;

if the desired value of the second noun is greater than the price understood:

let difference be the desired value of the second noun minus the price understood;

let difference be difference divided by two;

decrease the desired value of the second noun by difference;

now the last object offered is the second noun;

say "'How about [desired value of the second noun]?' suggests [the holder of the second noun]." instead;

otherwise:

unless the desired value of the second noun is the price understood:

say "From the avaricious gleam in the eye of [the holder of the second noun], you guess you could've gotten this purchase for less..."

Carry out offering it for:

increase the wealth of the holder of the second noun by the price understood;

decrease the wealth of the player by the price understood;

move the second noun to the player.

Report offering it for:

say "You spend [the price understood], and now you possess [the second noun]."

When play begins: now right hand status line is "Your funds: [wealth of the player]".

Now, since the man does make counter-offers, it would be reasonable to let the player accept or reject those, as well:

The last object offered is a thing that varies.
 
Instead of saying yes when the last object offered is carried by a person (called seller) who is not the player:
   if the seller is not visible:
      continue the action;
   otherwise:
      now the price understood is the desired value of the last object offered;
      try offering the desired value of the last object offered for the last object offered.
 
Instead of saying no when the last object offered is carried by a person (called seller) who is not the player:
   if the seller is not visible:
      continue the action;
   otherwise:
      now the last object offered is the player;
      say "You reject the offer firmly."

And we borrow just a line or two from a later chapter to take care of some alternate syntax the player might try:

Understand "offer [price] to [someone]" as a mistake ("You'll need to specify what you want to buy -- try OFFER $1000.00 FOR BROOKLYN BRIDGE."). Understand "offer [someone] [price]" as a mistake ("You'll need to specify what you want to buy -- try OFFER $1000.00 FOR BROOKLYN BRIDGE.").
 
Understand "buy [something]" as a mistake ("You'll have to name your price: try OFFER $1000.00 FOR BROOKLYN BRIDGE.").
 
Section 2 - The Scenario
 
The Flea Market is a room. The crotchety man is a man in the Market. "A crotchety man here is selling [the list of things carried by the crotchety man]." The crotchety man carries a broken television set, a Victorian rhinestone brooch, and a cracked shaving mug.
 
The minimum value of the brooch is $2.50.
 
Test me with "offer $0.50 for mug / offer $0.50 to man / offer $6.00 for mug / offer $50.00 for brooch / offer $1.50 for brooch / offer $4.50 for brooch / no / offer $4.50 for brooch / yes".

wi 15.19 Arithmetic with units
rb 9.4 Money

269. Fabrication ★★

When we make a new kind of value, the new named values can themselves have properties. That is convenient because, for instance, we might want to associate a material (itself the property of an object) with certain features, such as price.

"Fabrication"

Section 1 - Procedure

A material is a kind of value. The materials are silk, velvet, cotton, and wool.

Price is a kind of value. $1.99 specifies a price.

Area is a kind of value. 5 sq yards specifies an area.

Cost is a kind of value.. $1.99 per sq yard specifies a cost. A cost times an area specifies a price.

A material has a cost.

The cost of silk is usually $5.75 per sq yard. The cost of velvet is usually $9.50 per sq yard. The cost of cotton is usually $2.29 per sq yard. The cost of wool is usually $4.75 per sq yard.

A pattern is a kind of thing. A pattern has a material. A pattern has an area. A pattern has a price. The price of a pattern is usually $9.99. Understand "pattern" as a pattern. Understand "patterns" as the plural of a pattern.

After printing the name of a pattern:

if planning:

do nothing;

otherwise:

say " pattern".

To decide what price is the material price of (chosen item - pattern):

let C be the cost of the material of the chosen item;

let A be the area of the chosen item;

decide on C * A.

To decide what price is the overall price of (chosen item - pattern):

let P be the price of the chosen item;

let M be the material price of the chosen item;

decide on P + M.

Understand "plan [material] [pattern]" as planning it for.

Planning it for is an action applying to one material and one thing.

Carry out planning it for:

now the material of the second noun is the material understood.

Report planning it for:

say "You lay plans for a [material understood] [second noun], running [material price of the second noun] for materials and [price of the second noun] for the pattern itself, for a total of [overall price of the second noun]."

Section 2 - Scenario

Joanne's Fabrics is a room. Joanne's Fabrics contains a pattern bin.

The cape is a pattern. The material of the cape is velvet. The area of the cape is 9 sq yards.

The bodice is a pattern. The material of the bodice is silk. The area of the bodice is 2 sq yards. The price of the bodice is $11.99.

The cape and the bodice are in the pattern bin.

Test me with "plan silk bodice / plan velvet bodice / plan velvet cape / plan wool cape".

wi 15.20 Multiplication of units
rb 9.4 Money

262. Nickel and Dimed ★★★

Typically games which keep track of the player's wealth need only do so as an abstract number, but occasionally it becomes useful to represent money as physical coins and bills. Here is an example that does exactly that:

"Nickel and Dimed"

Section 1 - Currency

Price is a kind of value. $10.99 specifies a price with parts dollars and cents. A thing has a price. The price of a thing is usually $0.00.

Money is a kind of thing. Coin is a kind of money.

A dollar bill is a kind of money. The price of a dollar bill is $1.00. The printed name of a dollar bill is "dollar bill". Rule for printing the plural name of a dollar bill: say "dollar bills". The description of a dollar bill is "It has George Washington's head on the front, which with a bit of creative folding can be scrunched to look like a mushroom. All important things really are learned in kindergarten."

A five-dollar bill is a kind of money. The price of a five-dollar bill is $5.00. Understand "five" or "five dollar" as the five-dollar bill. The description of a five-dollar bill is "Abraham Lincoln. He looks slightly less dignified here than he does on the penny."

A hundred-dollar bill is a kind of money. The price of the hundred-dollar bill is $100.00. Understand "hundred" or "hundred dollar" as the hundred-dollar bill. Understand "dollar" as the dollar bill. The description of a hundred-dollar bill is "It's got Benjamin Franklin, who always gets shafted: a denomination too large for anyone to carry conveniently, and a lot of local fame in Philadelphia."

Our choice of understand rules guarantees that "five dollar" will be understood as the five, but "dollar" alone as the single. We will learn more about "understand" in later chapters, but here is a test to check the functionality:

Test bills with "x hundred dollar bill / x five dollar bill / x hundred / x five / x dollar / x dollar bill".
 
A quarter is a kind of coin. The price of a quarter is $0.25. The description of a quarter is "One of the old-fashioned variety, not a state quarter."
 
A dime is a kind of coin. The price of a dime is $0.10. The description of a dime is "Franklin Roosevelt, trying not to look too annoyed that his coin is so small and thin."
 
A nickel is a kind of coin. The price of a nickel is $0.05. The description of a nickel is "A chubby coin, but you've always liked Thomas Jefferson, and the Monticello on the back is a nice touch."
 
A penny is a kind of coin. The price of a penny is $0.01. The description of the penny is "A profile of Abe Lincoln. Sometime soon they'll stop minting these, you're sure of it."
 
Section 2 - Ownership
 
Ownership relates one person (called the owner) to various things. The verb to own means the ownership relation.
 
Definition: a thing is owned if the player owns it.
 
Instead of buying something which is owned by the player:
   say "You already own [the noun]."
 
Instead of going somewhere when the player encloses something (called the stolen goods) which is not owned by the player:
   if the owner of the stolen goods is not a person:
      now the player owns the stolen goods;
      continue the action;
   if the owner of the stolen goods can see the player,
      say "'Hey there buddy, not so fast,' says [the owner of the stolen goods]. 'You going to buy [the stolen goods] first, or am I gonna call the cops?'";
   otherwise continue the action.
 
After taking inventory:
   say "Altogether, you've got [the player's cash] on your person."
 
To decide what price is the player's cash:
   let sum be the total price of money enclosed by the player;
   decide on sum.
 
To decide what price is the sum in (item - a container):
   let sum be the total price of the money in the item;
   decide on sum.
 
When play begins: now every thing carried by the player is owned by the player.
 
Section 3 - Purchasing and Sales
 
Definition: a thing is worthless if the price of it is $0.00. Definition: a thing is valuable if it is not worthless.
 
A thing can be for sale.
 
Rule for printing room description details of something (called target) which is for sale (this is the disclose prices in room description rule): say " ([price of the target])".
 
Before listing contents: group money together giving articles.
 
Instead of examining a for sale thing (this is the describe things by price rule):
   say "[The noun] costs [the price of the noun], payable to [the owner of the noun]."

The cashbox is a theoretical construct, not something the player will ever encounter in the course of the game. It contains all the money that is available for non-player characters to use in making change. If we wanted, we could give each character his own stash of change, but this would increase the likelihood that any given person would run out of cash to make change with. (And in this example there is only one vendor anyway.)

The cashbox is a container. The cashbox contains 10 pennies. The cashbox contains 10 nickels.  The cashbox contains 10 dimes.  The cashbox contains 10 quarters.  The cashbox contains 10 dollar bills.  The cashbox contains 10 five-dollar bills.
 
The block buying rule is not listed in the check buying rules.
 
Check buying something:
   if the noun is not for sale, say "[The owner of the noun] does not want to sell you [the noun]." instead;
   if the player's cash is less than the price of the noun, say "You can't afford the asking price of [the price of the noun] for [the noun]." instead.
 
Carry out buying something:
   let sum paid be $0.00;
   while sum paid is less than the price of the noun:
      let current target be the price of the noun minus the sum paid;
      let bill offered be the best money from the player for the current target;
      if the bill offered is money:
         move the bill offered to the owner of the noun;
         now the bill offered is spent;
         increase the sum paid by the price of the bill offered;
         let current target be the price of the noun minus the sum paid;
   say "You hand [the owner of the noun] [a list of spent money]. [run paragraph on]";
   let change be $0.00;
   if the sum paid is greater than the price of the noun:
      now the change is the sum paid minus the price of the noun;
   if change is greater than the sum in the cashbox:
      now the player carries every spent money;
      now every spent thing is fresh;
      say "'Whoa,' says [the owner of the noun], handing the cash back to you. 'I can't make change for that, man, sorry.'" instead;
   now every spent thing is in the cashbox;
   now every spent thing is fresh;
   while change is greater than $0.00:
      let change bill be the best money from the cashbox for change;
      decrease change by the price of the change bill;
      now change bill is spent;
      move change bill to player;
   if money is spent, say "[The owner of the noun] makes change with [a list of spent money]. [run paragraph on]";
   now every spent thing is fresh;
   if the noun is not enclosed by the player and the owner of the noun can touch the noun:
      say "'Here ya go,' says [the owner of the noun], handing [the noun] to you. [run paragraph on]";
      move the noun to the player;
   now the player owns the noun.
 
Money can be spent or fresh.
 
Report buying something:
   if the player owns the noun,
      say "Your transaction is now complete, leaving you with [the player's cash]."

We've skipped over defining what makes a denomination the best for a given transaction, so we'd better do that now. Our goal is to avoid ever having the player gratuitously overpay -- he should always offer the smallest amount of money that will meet the price of what he's buying.

We also assume that all money "enclosed by the buyer" -- that is, somewhere in the buyer's possession -- is available for use. This might not be true in a game where the player could pick up, say, a sealed lucite container with a ten-dollar bill inside; in that case we would have to define our terms more rigorously, perhaps by requiring that the bills be both enclosed and touchable by the buyer. The touchability check adds an extra layer of calculation, however, and since it is not necessary in this example (and probably not in most other cases either), we'll leave it out:

Definition: money is costly if its price is $2.50 or more. Definition: money is cheap if its price is $0.99 or less.
 
Functional relation is a kind of value. The functional relations are overpayment, underpayment and irrelevant. Money has a functional relation.
 
To decide what money is the best money from (buyer - a thing) for (cost - a price):
   repeat with bill offered running through money:
      if the bill offered is enclosed by the buyer:
         if the price of the bill offered is the cost, decide on the bill offered;
         if the price of the bill offered is greater than the cost, now the functional relation of bill offered is overpayment;
         otherwise now the functional relation of the bill offered is underpayment;
      otherwise:
         now the functional relation of the bill offered is irrelevant;
   [say "underpayment: [a list of underpayment money]
   overpayment: [a list of overpayment money]";]
   if the total price of underpayment money is less than the cost:
      decide on the cheapest money which is overpayment;
   otherwise:
      decide on the costliest money which is underpayment.

Notice the "say underpayment/overpayment section…" noted out, above. This is for debugging purposes: when writing complex code, it is sometimes useful to put in lines that will say explicitly what is going on. We can enclose them in brackets and Inform will ignore them as though they were comments; if we run into any problems with the code later, we can erase the brackets and see the diagnostic printed to the screen as we play.

Instead of giving money to someone:
   say "Best to keep the transaction simple by buying whatever you want."
 
Section 4 - The Scenario
 
The player carries 2 dollar bills. The player carries a nickel. The player carries 2 pennies. The player carries a five-dollar bill. The player carries 1 hundred-dollar bill.
 
The Subway Station is a room.
 
The Bitterly Cold Street is north of the Subway Station. "Even though there is no actual snow or ice, the street is about as cold as you can stand, for which reason walking the twenty blocks uptown is not an acceptable option." The Bitterly Cold Street contains a dollar bill.
 
The newspaper man is a man in the Subway Station. "A newspaper man in a knit cap and fingerless gloves is hopping up and down behind his stand[if the turn count is 1]. Cold weather, caffeine overdose, or mental illness? You may never know. Welcome to New York[end if]." The description is "Eye contact with strangers is something to avoid around here."
 
The stand is a supporter in the Station. The stand is scenery.
 
A copy of the New York Times is on the stand. The price of the New York Times is $1.25.
 
A pack of gum is on the stand. The price of the gum is $0.40.
 
A paperback novel is on the stand. The price of the paperback novel is $7.99.
 
A packet of trading cards is on the stand. The price of the packet is $0.99.
 
When play begins:
   now every thing on the stand is owned by the newspaper man;
   now every thing on the stand is for sale.

We could have done all that by hand, but the initialization requires a little less work.

The ticket machine is a container in the Subway Station. It is fixed in place. The description of the ticket machine is "An LED screen on the front instructs you to insert [remaining ticket total] to complete your purchase. You also notice that the NO CHANGE light is lit up." The light is part of the ticket machine. The printed name of the light is "no change light". Understand "no change" or "no change light" as the light.
 
The description of the light is "In the whole of your recollection, the ticket machine has actually had change a total of twice. Usually, as now, the no-change light gleams angrily, daring you to put in more than you owe." A cash return button is part of the ticket machine. Instead of pushing the cash return button: say "The ticket machine regurgitates [the list of things in the ticket machine]."; now every thing in the ticket machine is carried by the player. Instead of taking something which is in the ticket machine: say "The ticket machine has swallowed your money, but it can be retrieved (you hope) with the cash return button."
 
Instead of inserting a hundred-dollar bill into the ticket machine:
   say "What, are you nuts?"
 
To decide what price is the remaining ticket total:
   let absolute cost be $2.25;
   let remaining cost be absolute cost minus the total price of things in the ticket machine;
   if remaining cost is less than $0.00, decide on $0.00;
   decide on remaining cost.
 
Instead of inserting something which is not money into the ticket machine: say "The ticket machine only accepts money, not other tokens of your esteem and regard."
 
Instead of inserting a penny into the ticket machine:
   say "The penny rattles out again mockingly: not even the ticket machine thinks these are worth anything."
 
A subway pass is a kind of thing. 15 subway passes are in the cashbox. The description of a subway pass is usually "A rectangle of thick lavender paper with a black magnetic stripe running up the back side. It is good for one trip on the subway."
 
After inserting something into the ticket machine:
   if the remaining ticket total is $0.00:
      let purchased ticket be a random subway pass in the cashbox;
      if purchased ticket is not a subway pass, say "The ticket machine grunts disobligingly and then the unwelcome word MALFUNCTION parades across the LED screen, three letters at a time." instead;
      repeat with item running through things in the machine:
         now the item is nowhere;
      move purchased ticket to player;
      say "The ticket machine beeps obligingly and disgorges a single subway pass.";
   otherwise:
      say "The ticket machine beeps obligingly and adjusts its price down to [remaining ticket total]."

And because even though the ticket machine is a container, we don't want to say (empty) after it in the room description:

Rule for printing room description details of the ticket machine:
   do nothing instead.
 
Test me with "buy novel / n / get dollar / s / buy novel".

After all that, we should probably give the player a chance to win, as well:

The turnstile is south of the Subway Station. "A turnstile is all that separates you from the subway platform stairs." The turnstile is north of the Platform. The turnstile is a door. Before going down in the presence of the turnstile, try going south instead. The turnstile is openable. The turnstile is open.
 
Instead of going through the turnstile when the player carries a subway pass: say "You enter the turnstile and begin your journey uptown..."; end the story finally saying "At last". Instead of going through the turnstile: say "You can't go through the turnstile without a subway pass. They're very strict about this."
 
Instead of inserting money into the turnstile: say "The turnstile takes passes, not money." Instead of inserting a subway pass into the turnstile, try entering the turnstile.
 
Test more with "buy times / put all but five-dollar bill in machine / press button / buy gum / buy cards / i / put dollar in machine / g / put quarter in machine / i / d".

In fairness to the Metropolitan Transit Authority, we should admit that most of the ticketing machines in the real New York subway are better than this, and will accept, say, a debit card. But that would be so much less exciting to implement.

wi 15.17 Totals
rb 9.4 Money

283. Introduction to Juggling ★★★

Suppose we have a whole catalog-full of equipment that the player might want to purchase and use. We'll start by defining our purchasing rules:

"Introduction to Juggling"

We allow things to have prices, and the player's price to indicate how much money the player has:

Section 1 - Mail-ordering defined
 
Price is a kind of value. $100.99 specifies a price.
 
The player has a price. The price of the player is $60.00.

Because we're allowing the player to order things that he can't currently see, we need to borrow a special kind of grammar from the Understanding chapter. All our orderable items in this example are toys, so "any toy" means any object of the toy kind, whether or not it is in view at the moment:

Understand "buy [any toy]" as ordering. Understand the command "order" as something new. Understand the command "order" as "buy".
 
Ordering is an action applying to one visible thing.
 
Check ordering:
   if the cost of the noun is greater than the price of the player, say "You only have [price of the player], while [the noun] would cost [cost of the noun]." instead.
 
Carry out ordering:
   move the noun to the player;
   decrease the price of the player by the cost of the noun.
 
Report ordering:
   say "You order [a noun], which is delivered instantly."

We should also handle the situation where the player orders another of something he has already bought and which is right in front of him:

Instead of buying something:
   say "You already have [a noun]."

So much for the general rules for this scenario. Now we move on to particulars: the actual items the player is allowed to order. Each item will have a description, a price, and a difficulty representing how skilled the player must be in order to make use of that item.

Since we are going to use price and difficulty in the table that defines our juggling equipment, we need to mention these kinds of value before the line that says how toys are defined.

Section 2 - The Scenario
 
Difficulty is a kind of value. The difficulties are easy, moderate, hard. The player has a difficulty. The difficulty of the player is easy.
 
The plural of toy is toys. A toy is a kind of thing. Some toys are defined by the Table of Juggling Equipment.
 
Table of Juggling Equipment

toycostrestrictiondescriptiondifficultyoutcome
an economy bounce ball set$10.00"comes in set of three""A fairly ordinary rubber ball, solid color."moderate"You create of the balls a cascade of moving color."
an acrylic contact ball$14.00"should be bought with ball polish""A large clear ball, not for throwing but for using in various hand tricks."hard"You rotate the ball between your fingers and pass it over the backs of your hands."
a UV-reactive contact ball$55.00"appears to glow in dark rooms""Similar to the ordinary acrylic contact ball, but UV-reactive."hard"The ball glows as it passes between your fingers and over the backs of your hands, rolls up to your wrist, snaps through the air-- all apparently of its own accord."
a ball polish set$10.00"useful only with acrylic contact balls""Three bottles of polish and a rag for keeping acrylic contact balls scratch-free."hard"You juggle the polish bottles with difficulty, since they are full of sloshing liquid."
a teaching beanbag set$8.00"set of three""Soft, easily-juggled bag."easy"You juggle the beanbags with basic competence."
a stage ball set$13.50"comes in set of three""Not much different in appearance from the economy bounce ball, but larger so as to be visible from a stage."moderate"You create of the balls a cascade of moving color, visible from quite a distance."
a fireball set$33.00"will not be sold to minors""A ball has wicking and a fuel-source inside so that it will burn while being juggled."hard"You juggle the fireballs rapidly, careful never to hold any of them a moment longer than necessary."

Notice that we are allowed to define "description" and other already-known properties in the table as well.

Backstage is a room. "A muffled black room with felt on the floors and walls. A glowing sign over the stage door says SHOW IN PROGRESS."
 
The Juggling Equipment Catalog is a thing in Backstage.
 
Instead of examining the Catalog:
   say "You read through the offerings, including: [paragraph break]";
   repeat through Table of Juggling Equipment:
      say "[bold type][toy entry][roman type]: [description entry] [cost entry], [restriction entry]. [paragraph break]".
 
When play begins:
   now right hand status line is "Budget: [price of the player]";
   now left hand status line is "[location], feeling [if the difficulty of player is easy]incompetent[end if][if the difficulty of player is moderate]moderately skilled[end if][if the difficulty of player is hard]highly skilled[end if]".

And of course this will be no fun unless the player is allowed to use the equipment:

Understand "juggle [something]" as juggling.
 
Juggling is an action applying to one thing.
 
Check juggling:
   if the noun is not a toy listed in the Table of Juggling Equipment, say "You can't juggle [a noun]!" instead;
   if the difficulty of the noun is greater than the difficulty of the player, say "You're not quite ready to juggle something like [the noun]. Better to start with an easier toy." instead.
 
Carry out juggling:
   if a random chance of 1 in 3 succeeds:
      if the difficulty of the player is less than hard and the difficulty of the player is the difficulty of the noun:
         now the difficulty of the player is the difficulty after the difficulty of the player.
 
Report juggling:
   say "[outcome of the noun][paragraph break]".
 
Instead of burning the fireball set:
   say "It will flame by itself when you use it."
 
Test me with "read catalog / buy economy / buy beanbag / juggle economy / juggle beanbag / juggle beanbag / juggle beanbag / juggle beanbag / juggle beanbag / juggle beanbag / juggle economy / juggle economy / juggle economy / buy fireball set / juggle fireball".

wi 16.16 Defining things with tables
rb 9.4 Money

🔗

RB §9.5 Dice and Playing Cards

Most toys are single things, and no harder to create than any other small items, but games often require a multitude of tokens to be combined, and this can be logistically tricky.

The classic example is a pack of playing cards, where the player must individually control 52 items but without fussy commands or verbose text being printed back. Jokers Wild ★★ provides a simple "one card at a time" approach; Tilt ★★★ is more sophisticated, with 52 independently accessible cards; Tilt 2 ★★★ can further judge the value of a selection of cards - the ranking of a poker hand.

Drawing cards from a shuffled pack is only one source of randomness. Games of chance also involve items drawn from a bag: Wonka's Revenge ★ provides just such a lottery. More often, dice are thrown. A single die is easy enough:

The die is carried by the player. After dropping the die: say "It lands with [a random number from 1 to 6] uppermost." Understand "roll [something]" as dropping.

Quick, but not very good. Most dice games involve rolling more than one die at a time, to get a more interesting distribution of outcomes: they may also involve special rules applying to doubles, for instance. See Do Pass Go ★.

Examples

129. Do Pass Go ★

"Do Pass Go"

Go is a room. "A giant square area, where you and your other pewter ornament friends gather before setting out to purchase London."

The pair of dice is carried by the player.

The pair of dice has a number called first die. The pair of dice has a number called second die. The first die of the pair is 6. The second die of the pair is 6. Rule for printing the name of the pair of dice while taking inventory: say "pair of dice".

Rule for printing the name of the pair of dice: say "pair of dice showing [first die of the pair plus second die of the pair]".

To say detailed state of the dice:

if the first die of the pair is the second die of the pair, say "double [first die of the pair]";

otherwise say "[first die of the pair] and [second die of the pair]".

The description of the pair of dice is "The pair of dice are [if the dice are carried]itching to be rolled[otherwise]showing [detailed state of the dice][end if]."

Rolling is an action applying to one carried thing. Understand "roll [something preferably held]" as rolling.

Check rolling when the noun is not the pair of dice: say "Not something you can roll." instead.

Carry out rolling:

now the pair of dice is in the holder of the actor;

now the first die of the pair of dice is a random number from 1 to 6;

now the second die of the pair of dice is a random number from 1 to 6.

Report rolling:

say "You roll [detailed state of the dice]."

Test me with "i / roll dice / look / x dice / get dice / x dice / roll dice / roll dice / roll dice / roll dice / roll dice / roll dice / roll dice".

Because we remember the states of the individual dice, not just a total, we can make use of the combination rolled.

The doubles count is a number that varies.
After rolling:
   if the first die of the pair is the second die of the pair, increment the doubles count;
   otherwise now the doubles count is 0;
   continue the action.
 
Jail is a room. "This is Jail, and not the Just Visiting periphery, either."
 
Every turn when the doubles count is 3:
   say "The blue-uniformed policemen blows his whistle and beckons you sternly...";
   now the player carries the pair of dice;
   now the player is in Jail;
   now the doubles count is 0.
 
Every turn when the doubles count is 1 and the player is in Jail:
   say "The warden gruffly releases you.";
   now the player carries the pair of dice;
   now the player is in Go.

wi 8.18 Randomness
rb 9.5 Dice and Playing Cards

175. Wonka's Revenge ★

"Wonka's Revenge"

The Caribou Lodge is a room. "Hundreds of expectant faces are turned your way from every table." A lottery drum is in the Lodge. "Before you is the lottery drum[if we have spun the drum], ready to disgorge a ticket[otherwise], waiting to be spun[end if]." In the drum are a red ticket, an orange ticket, a yellow ticket, a green ticket, a blue ticket, a purple ticket, and a ticket of pure gold. The drum is closed and openable.

Understand "spin [something]" as spinning.

Spinning is an action applying to one thing.

Check spinning: if the noun is an open container which contains something, say "[The list of things in the noun] would fly out." instead.

Carry out spinning a container:

shuffle the contents of the noun.

Report spinning:

if the noun contains something, say "You rattle [if the noun is transparent][the list of things in the noun][otherwise]the stuff[end if] in [the noun].";

otherwise say "Nothing results of your shaking [the noun]."

Inform keeps track of the order in which things have been put into a container. If we want to change that order without the player's intervention, we can move the things ourselves.

To shuffle the contents of (basket - a container):
   let moves be the number of things in the basket;
   repeat with counter running from 1 to moves:
      move a random thing in the basket to the basket.
 
After opening the drum when we have spun the drum for the first time:
   if something (called the pick) is in the drum:
      try searching the drum;
      say "[The pick] it is, then.";
      silently try taking the pick;
      if the pick is the ticket of pure gold, end the story finally;
      otherwise end the story saying "Oh well, better luck next time."
 
Test me with "open drum / look in drum / close drum / spin drum / open drum".

wi 11.10 Repeat
rb 9.5 Dice and Playing Cards

275. Jokers Wild ★★

Suppose we want a deck of cards which the player can shuffle and draw from. Our first (rather tedious) task is merely to set up the deck as a table:

"Jokers Wild"

Suit is a kind of value. The suits are hearts, clubs, diamonds, and spades.

Table of Cards

suit	value
diamonds	1
diamonds	2
diamonds	3
diamonds	4
diamonds	5
diamonds	6
diamonds	7
diamonds	8
diamonds	9
diamonds	10
diamonds	11
diamonds	12
diamonds	13
spades	1
spades	2
spades	3
spades	4
spades	5
spades	6
spades	7
spades	8
spades	9
spades	10
spades	11
spades	12
spades	13
hearts	1
hearts	2
hearts	3
hearts	4
hearts	5
hearts	6
hearts	7
hearts	8
hearts	9
hearts	10
hearts	11
hearts	12
hearts	13
clubs	1
clubs	2
clubs	3
clubs	4
clubs	5
clubs	6
clubs	7
clubs	8
clubs	9
clubs	10
clubs	11
clubs	12
clubs	13

We're going to describe the higher numbers as face cards, so it helps to write a new "to say" phrase.

To say (count - a number) as a card value:
   choose row with a value of count in the Table of Value Names;
   say "[term entry]".
 
Table of Value Names

valueterm
1"ace"
2"deuce"
3"three"
4"four"
5"five"
6"six"
7"seven"
8"eight"
9"nine"
10"ten"
11"jack"
12"queen"
13"king"

Now we get the shuffling of the deck from "sort in random order", so:

Understand "shuffle" as shuffling. Shuffling is an action applying to nothing.
 
Carry out shuffling:
   sort the Table of Cards in random order;
   say "You expertly rearrange the cards.".
 
When play begins:
   sort the Table of Cards in random order.

This will continue to work properly even as the deck is partially depleted. Speaking of which, suppose we want the player to be able to toss the cards one-by-one into a hat. They are going to need to be removed from the deck, so:

Understand "toss" or "toss a card" or "toss card" as tossing.
 
Tossing is an action applying to nothing.
 
Check tossing:
   if the number of filled rows in the Table of Cards is 0, say "The deck is empty." instead.
 
Carry out tossing:
   repeat through the Table of Cards:
      let new value be value entry;
      let new suit be suit entry;
      say "You throw the [value entry as a card value] of [suit entry] at the top hat, and [if a random chance of 1 in 3 succeeds]hit[otherwise]miss[end if].";
      blank out the whole row;
      rule succeeds.

If we wanted to simulate a slightly more stimulating game, we could instead have a second table to represent the player's hand of cards and record each card drawn. That would get long for the purposes of example, however, so instead we will just admit that the player's life is an empty husk of existence:

The Empty Room is a room. "It has come to this: sitting on the bare floor of Lulu's apartment with nothing to amuse you but a deck of cards and the top hat from last year's act. You reckon [the number of filled rows in the Table of Cards in words] cardtosses are all that stand between you and the utter pointlessness of existence.
 
Once again you curse Lulu for running off with that joker."
 
The player is carrying the deck of cards. The top hat is an open container in the Empty Room. It is scenery.
 
Test me with "toss / again / again / again / again / again / again / again".

wi 16.11 Sorting
rb 9.5 Dice and Playing Cards

318. Tilt 1 ★★★

We've simulated a deck of cards before, but only as entries in a table. This time we're going to do it more completely, with card objects that can be drawn and discarded, and referred to by name. The tedious way to do this would be to make 52 objects by hand and laboriously write out their names and understand rules.

A more sensible way is to make 52 identical card objects, assign them ranks and suits, and allow Inform to generate and parse their names automatically.

So:

"Tilt"

Section 1 - Cards

Suit is a kind of value. The suits are hearts, clubs, diamonds, and spades. Understand "heart" as hearts. Understand "club" as clubs. Understand "diamond" as diamonds. Understand "spade" as spades. [Providing the singular forms means that Inform will also understand >EXAMINE SPADE, >DISCARD CLUB, and so on.]

A card is a kind of thing. A card has a suit. A card has a number called rank. Understand the suit property as describing a card. Understand the rank property as describing a card.

52 cards are in the card repository.

Now, we're going to describe the higher numbers as face cards, so it helps to write a new "to say" phrase, just as we did in Jokers Wild. (A subsequent version of this example shows how to print card values with red and black symbols representing the different suits; see "Tilt 3".)

To say (count - a number) as a card value:
   choose row count in the Table of Value Names;
   say "[term entry]".
 
Rule for printing the name of a card (called target):
   say "[rank of the target as a card value] of [suit of the target]"
 
Table of Value Names

termvaluetopic
"ace""1""ace/A/one"
"deuce""2""deuce/two"
"three""3""three"
"four""4""four"
"five""5""five"
"six""6""six"
"seven""7""seven"
"eight""8""eight"
"nine""9""nine"
"ten""10""ten"
"jack""11""jack/knave/J"
"queen""12""queen/Q"
"king""13""king/K"

This is enough already to let inform understand things like "ten clubs", but we want to add a couple of refinements. For one thing, we'd like to accept "of" when it appears in phrases such as "ten of clubs" (but not generically otherwise); for another, we'd like the player to be able to use various names for ranks. To this end, we need to borrow from the Activities chapter and modify the player's command before attempting to understand it:

After reading a command:
   if the player's command includes "of [suit]":
      while the player's command includes "of":
         cut the matched text;
   repeat through the Table of Value Names:
      while the player's command includes topic entry:
         replace the matched text with value entry.
   [This allows Inform to understand "ace", "deuce", "king", etc., as numerical ranks.]

It may be a bit confusing that the Table of Value Names has both a topic column and a term column, to all appearances essentially identical. But items in the topic column can be matched against the player's input, whereas items in other kinds of text column can be printed out; the two kinds of text are not treated identically by Inform, so we need to have both. Notice that the topic column contains entries like "jack/knave," which will match either "jack" or "knave" in the player's input.

Now to set up the deck at the outset. With some intelligent looping, we avoid having to declare every combination of suit and number individually:

When play begins:
   reconstitute deck.
 
To reconstitute deck:
   let current suit be hearts;
   now every card is in the card repository;
   while a card is in the card repository:
      repeat with current rank running from 1 to 13:
         let item be a random card in card repository;
         now rank of item is current rank;
         now suit of item is current suit;
         now item is in the deck of cards;
      now current suit is the suit after the current suit.

And now we need a simple setting and some actions to manipulate the deck with:

Section 2 - The Deck and the Discard Pile
 
The Empty Room is a room. "Nothing to see here."
 
The deck of cards is in the Empty Room. It is a closed unopenable container. The description is "A standard poker deck."
 
The discard pile is a closed unopenable container. The description is "Cards in this game are discarded face-down, so the discard pile is not very interesting to see. All you can observe is that it currently contains [if the number of cards which are in the discard pile is less than ten][the number of cards which are in the discard pile in words][otherwise]about [the rounded number of cards which are in the discard pile in words][end if] card[s]."
 
To decide what number is the rounded number of (described set - a description of objects):
   let N be the number of members of the described set;
   let R be N divided by 5;
   let total be R times 5;
   decide on total.

The above phrase rounds a number to the nearest five, because it seems unrealistic for the player to be able to count a large number of cards in the discard pile at a single glance.

This next bit is an optional borrowing from the Activities chapter: we want to prevent Inform printing things like "You can see a discard pile (closed) here.", since we don't want the player to think of the piles as containers, even though Inform thinks of them in those terms.

Rule for printing room description details of something: do nothing instead.

Finally, we want the player to use "draw" and "discard" to manipulate his hand of cards:

Section 3 - Drawing and Discarding Actions
 
Understand the commands "take" and "carry" and "hold" and "get" and "drop" and "throw" and "discard" as something new.
 
Understand "take [text]" or "get [text]" or "drop [text]" as a mistake ("Here, you only draw and discard. Nothing else matters at the moment.").
 
Understand "draw" or "draw card" or "draw a card" as drawing. Drawing is an action applying to nothing. The drawing action has an object called the card drawn.
 
Setting action variables for drawing:
   now the card drawn is a random card which is in the deck of cards.
 
Check drawing:
   if the card drawn is nothing, say "The deck is completely depleted." instead.
 
Check drawing:
   if the number of cards carried by the player is greater than four,
      say "This is a five-card game; you must discard something before drawing anything further." instead.
 
Carry out drawing:
   move the card drawn to the player.
 
Report drawing:
   say "You draw [a card drawn]."
 
 
Understand "discard [card]" as discarding. Discarding is an action applying to one thing.
 
Check discarding:
   if the player does not carry the noun, say "You can only discard cards from your own hand." instead.
 
Carry out discarding:
   now the noun is in the discard pile;
   if the discard pile is not visible, move the discard pile to the location.
 
Report discarding:
   say "You toss [the noun] nonchalantly onto the discard pile."
 
Seeding is an action out of world. Understand "seed" as seeding. Carry out seeding: seed the random-number generator with 5681.
 
Test me with "seed / draw / g / g / g / g / i / discard seven of spades / draw / discard six / draw / i / discard hearts / discard six of diamonds card / draw / draw / i / discard spades card / draw / discard king card".

wi 17.15 Understanding things by their properties
rb 9.5 Dice and Playing Cards

406. Tilt 2 ★★★

In our previous implementations of playing cards, we've gotten as far as creating decks of individual cards that the player can draw and discard. But in a poker game, one doesn't just have a collection of cards: one has a hand of a specific kind.

Here we take on the job of writing an inventory listing for a poker hand that will reflect the real value of what the player has drawn. To do this, we create a rulebook to sort and assess the cards in the player's hand; its possible return values are limited to the kinds of poker hands that exist, from "high card" to "royal flush".

The first three sections, creating the deck of cards and the means to parse their names, are identical to those we've already seen in Tilt 1; new material begins at section 4.

For the purposes of demonstration, we're simulating something akin to five-card draw without wilds; stud or hold-em variations would add some other complexities.

"Tilt"

Section 1 - Cards

Suit is a kind of value. The suits are hearts, clubs, diamonds, and spades. Understand "heart" as hearts. Understand "club" as clubs. Understand "diamond" as diamonds. Understand "spade" as spades.

A card is a kind of thing. A card has a suit. A card has a number called rank. Understand the suit property as describing a card. Understand the rank property as describing a card.

52 cards are in the card repository.

To say (count - a number) as a card value:

choose row count in the Table of Value Names;

say "[term entry]".

Rule for printing the name of a card (called target):

say "[rank of the target as a card value] of [suit of the target]"

Table of Value Names

term	value	topic
"ace"	"1"	"ace/A/one"
"deuce"	"2"	"deuce/two"
"three"	"3"	"three"
"four"	"4"	"four"
"five"	"5"	"five"
"six"	"6"	"six"
"seven"	"7"	"seven"
"eight"	"8"	"eight"
"nine"	"9"	"nine"
"ten"	"10"	"ten"
"jack"	"11"	"jack/knave/J"
"queen"	"12"	"queen/Q"
"king"	"13"	"king/K"

After reading a command:

if the player's command includes "of [suit]":

while the player's command includes "of":

cut the matched text;

repeat through the Table of Value Names:

while the player's command includes topic entry:

replace the matched text with value entry.

When play begins:

reconstitute deck.

To reconstitute deck:

let current suit be hearts;

now every card is in the card repository;

while a card is in the card repository:

repeat with current rank running from 1 to 13:

let item be a random card in card repository;

now rank of item is current rank;

now suit of item is current suit;

now item is in the deck of cards;

now current suit is the suit after the current suit.

Section 2 - The Deck and the Discard Pile

The Empty Room is a room. "Nothing to see here."

The deck of cards is in the Empty Room. It is a closed unopenable container. The description is "A standard poker deck."

The discard pile is a closed unopenable container. The description is "Cards in this game are discarded face-down, so the discard pile is not very interesting to see. All you can observe is that it currently contains [if the number of cards which are in the discard pile is less than ten][the number of cards which are in the discard pile in words][otherwise]about [the rounded number of cards which are in the discard pile in words][end if] card[s]."

To decide what number is the rounded number of (described set - a description of objects):

let N be the number of members of the described set;

let R be N divided by 5;

let total be R times 5;

decide on total.

Rule for printing room description details of something: do nothing instead.

Section 3 - Drawing and Discarding Actions

Understand the commands "take" and "carry" and "hold" and "get" and "drop" and "throw" and "discard" as something new.

Understand "take [text]" or "get [text]" or "drop [text]" as a mistake ("Here, you only draw and discard. Nothing else matters at the moment.").

Understand "draw" or "draw card" or "draw a card" as drawing. Drawing is an action applying to nothing. The drawing action has an object called the card drawn.

Setting action variables for drawing:

now the card drawn is a random card which is in the deck of cards.

Check drawing:

if the card drawn is nothing, say "The deck is completely depleted." instead.

Check drawing:

if the number of cards carried by the player is greater than four,

say "This is a five-card game; you must discard something before drawing anything further." instead.

Carry out drawing:

move the card drawn to the player.

Report drawing:

say "You draw [a card drawn]."

Understand "discard [card]" as discarding. Discarding is an action applying to one thing.

Check discarding:

if the player does not carry the noun, say "You can only discard cards from your own hand." instead.

Carry out discarding:

now the noun is in the discard pile;

if the discard pile is not visible, move the discard pile to the location.

Report discarding:

say "You toss [the noun] nonchalantly onto the discard pile."

New material begins here. We want to start by grouping cards together, but identifying poker hands only if the player holds a full five cards.

Section 4 - Assessing Hands
 
Before listing contents while taking inventory: group cards together.
 
Before grouping together cards:
   if the number of cards carried by the player is 5:
      say "[run paragraph on]";
      follow the hand-ranking rules;
      if the rule succeeded, say "[the outcome of the rulebook]";
      otherwise say "some random cards";
      if the outcome of the rulebook is pair outcome, say " of [rank of the first thing held by the player as a card value]s";
   otherwise:
      say "[number of cards carried by the player in words] assorted cards";
   say " (".
 
Rule for grouping together cards:
   say "[list hand]".
 
To say list hand:
   let chosen card be the first thing held by the player;
   while chosen card is a card:
      say "[chosen card]";
      now chosen card is the next thing held after chosen card;
      if chosen card is a card, say ", ".
 
After grouping together cards:
   say ")".

The ranking of poker hands traditionally depends on three features: 1) whether all the cards are of the same suit (flush); 2) whether the cards constitute a numerical run of ranks (straight); and 3) how many cards or sets of cards are of matching rank (pairs, three of a kind, and four of a kind). Here we will start by assessing our hand to determine these qualities:

The hand-ranking rules is a rulebook. The hand-ranking rules have outcomes royal flush, straight flush, four of a kind, full house, flush, straight, three of a kind, two pairs, pair, high card.
 
The hand-ranking rulebook has a truth state called the flushness.
The hand-ranking rulebook has a truth state called the straightness.
 
The hand-ranking rulebook has a number called the pair count.
The hand-ranking rulebook has a number called the triple count.
The hand-ranking rulebook has a number called the quadruple count.

For convenience in identifying hand features, and for elegance when we print the hand-listing, we start by sorting the cards in the player's hand so that the high-ranked cards are listed first. It is rare that we want to concern ourselves with this, but as we saw in the section on "Looking at containment by hand" in the chapter on Change, Inform keeps an ordered list of the items inside any given container; so it does order the objects in the player's hand, and the ordering depends on which things were added to the hand most recently. By moving something to the player's hand again (even if it was already there), we change this ordering, and wind up with a sorted hand.

A card can be sorted or unsorted. A card is usually unsorted.
 
Definition: a card is high if its rank is 11 or more.
Definition: a card is low if its rank is 4 or less.
 
A hand-ranking rule (this is the initial sort rule):
   now every card is unsorted;
   while the player carries an unsorted card:
      let item be the lowest unsorted card held by the player;
      move item to the player;
      now the item is sorted;
   if sort-debugging is true, say "-- after initial sort: [list hand]".

This last printing instruction is there for diagnostic purposes: later we'll add a testing command to turn debugging on and off; when it's on, the game will print out its card list at various stages in sorting, to help us trouble-shoot any problems. In normal play, however, this will be off.

Next up, a check to see whether the player has a flush:

A hand-ranking rule (this is the finding flushness rule):
   let called suit be the suit of a random card carried by the player;
   if every card carried by the player is called suit, now flushness is true.

Now we check for straights; this is slightly complicated by the fact that an ace can be either the bottom of a low straight (lower than 2) or the top of a high straight (higher than king), so we explicitly check both possibilities.

A hand-ranking rule (this is the finding straightness rule):
   now straightness is true;
   let N be the rank of the highest card which is carried by the player;
   repeat with current rank running from N - 4 to N:
      now the test rank is the current rank;
      unless the player carries a matching card:
         if the current rank is N - 4 and the current rank is 9 and the player carries an ace card, do nothing; [this covers the case where an ace could be the top card of the sequence]
         otherwise now straightness is false.

And finally, we need to identify any groups of cards of the same rank. We want to know how many groups there are and how large each group is (though in practice there can only be one group of three or four in a standard-sized poker hand). We also want to mark any grouped cards so that we can move them to the front of the player's hand when we take inventory.

A card can be quadrupled, tripled, paired or uncombined.
 
Test rank is a number that varies. Definition: a card is matching if its rank is the test rank.

This definition is a convenience so that we don't have to write so many explicit loops in the following rule:

A hand-ranking rule (this is the counting multiples rule):
   now every card is uncombined;
   repeat with current rank running from 1 to 13:
      now test rank is current rank;
      let N be the number of matching cards held by the player;
      if N is 4:
         increment the quadruple count;
         now every matching card held by the player is quadrupled;
      if N is 3:
         increment the triple count;
         now every matching card held by the player is tripled;
      if N is 2:
         increment the pair count;
         now every matching card held by the player is paired.

Next we tweak our sorting to reflect the make-up of the hand. There are two reasons why this might differ from the straight highest-to-lowest sort we did earlier:

1) we want to list aces as high unless they are serving as the bottom of a low straight, in which case they should appear last;

2) we want combinations to appear at the front of the list, sorted from highest value to lowest value: larger combinations first, then smaller combinations, and combinations of equal size sorted by rank.

A hand-ranking rule (this is the move aces up unless there's a low straight rule):
   unless the straightness is true and the lowest card carried by the player is an ace card and the rank of the highest card carried by the player is 5,
      now every ace card which is carried by the player is carried by the player;
   if sort-debugging is true, say "-- after ace movement rule: [list hand]".
 
A hand-ranking rule (this is the move pairs forward rule):
   while the player carries a paired card:
      let selection be the lowest paired card which is carried by the player;
      move the selection to the player;
      now the selection is uncombined;
   if sort-debugging is true, say "-- after pairs movement: [list hand]".
 
A hand-ranking rule (this is the raise ace pairs rule):
   if the player carries exactly two ace cards:
      repeat with item running through ace cards which are carried by the player:
         move item to the player;
   if sort-debugging is true, say "-- after paired-ace movement: [list hand]".
 
A hand-ranking rule (this is the move multiples forward rule):
   while the player carries a tripled card:
      let selection be the lowest tripled card which is carried by the player;
      move the selection to the player;
      now the selection is uncombined;
   while the player carries a quadrupled card:
      let selection be the lowest quadrupled card which is carried by the player;
      move the selection to the player;
      now the selection is uncombined;
   if sort-debugging is true, say "-- after multiples movement rule: [list hand]".
 
Definition: a card is ace if its rank is 1.
Definition: a card is king if its rank is 13.

Now, having determined the salient qualities of our hand, we run through rules in order from the highest kind of poker combination to the lowest. Because of the order of the source, Inform will choose whichever combination applies first.

A hand-ranking rule (this is the royal-flush rule):
   if flushness is true and straightness is true and the highest card carried by the player is king and the lowest card carried by the player is ace, royal flush.
 
A hand-ranking rule (this is the straight-flushes rule):
   if flushness is true and straightness is true, straight flush.
 
A hand-ranking rule (this is the four-of-a-kind rule):
   if the quadruple count is 1, four of a kind.
 
A hand-ranking rule (this is the full-house rule):
   if the pair count is 1 and the triple count is 1, full house.
 
A hand-ranking rule (this is the flushes rule):
   if flushness is true, flush.
 
A hand-ranking rule (this is the straights rule):
   if straightness is true, straight.
 
A hand-ranking rule (this is the three-of-a-kind rule):
   if triple count is 1, three of a kind.
 
A hand-ranking rule (this is the two-pair rule):
   if the pair count is 2, two pairs.
 
A hand-ranking rule (this is the pair rule):
   if the pair count is 1, pair.
 
A hand-ranking rule (this is the default rule):
   high card.

And finally, we need to define our debugging variable here, even though we won't give the player the ability to turn it on and off except in the special testing section.

Sort-debugging is a truth state that varies.

For many examples, a test-me script is enough to prove that the example does what it ought. This example, though, is a bit more complicated, and hard to test randomly. The remainder of the source here shows how we might write a test to verify the desired behavior of our rulebook. Those who are only interested in the rulebook itself can stop reading at this point.

Section 5 - Testing hand identification - Not for release

For the sake of testing our rules, we provide an apparatus that will load the player's hand up with sample hands of each kind, then show the result to make sure that the hand is being correctly identified.

Understand "debug sorting" as debugging hand sorting. Debugging hand sorting is an action out of world.
 
Carry out debugging hand sorting:
   if sort-debugging is false, now sort-debugging is true;
   otherwise now sort-debugging is false.
 
Report debugging hand sorting:
   say "Sort debugging is now [if sort-debugging is true]on[otherwise]off[end if]."
 
Test me with "draw / g / g / g / g / force hand / g / g / g / g / g / g / g / g / g / g / g / g".

The somewhat rough-and-ready principle of this table is that we will overwrite the cards in the player's hand by resetting their ranks and suits; every five rows of the table represent a new poker hand for the game to attempt to sort and identify. These include one example of each of the major kinds of poker hand, plus a couple of variations involving aces which test the special sorting rules.

Table of Testing Hands

set suitset rank 
spades1[royal flush]
spades13 
spades12 
spades11 
spades10 
clubs12[straight flush]
clubs11 
clubs10 
clubs9 
clubs8 
diamonds8[four of a kind]
hearts8 
spades8 
clubs8 
clubs3 
clubs1[full house]
spades1 
hearts10 
spades10 
clubs10 
hearts2[flush]
hearts5 
hearts7 
hearts11 
hearts12 
hearts1[straight]
spades13 
diamonds12 
clubs11 
hearts10 
hearts2[three of a kind]
spades2 
clubs2 
clubs4 
spades3 
diamonds6[two pairs]
spades6 
clubs7 
diamonds7 
hearts9 
diamonds6[two pairs, ace high]
spades6 
clubs1 
diamonds7 
hearts1 
hearts12[pair]
spades12 
diamonds10 
spades7 
clubs4 
diamonds13[high]
hearts11 
spades9 
clubs7 
diamonds5 
hearts1[tricky sorting: low straight]
diamonds2 
spades3 
diamonds4 
diamonds5 
 
Understand "force hand" as forcing a hand. Forcing a hand is an action out of world.
 
Current marker is a number that varies.
 
Carry out forcing a hand:
   repeat with item running through cards which are carried by the player:
      increment current marker;
      if current marker is greater than the number of filled rows in the Table of Testing Hands, now current marker is 1;
      choose row current marker in the Table of Testing Hands;
      now the suit of item is the set suit entry;
      now the rank of item is the set rank entry.
 
Report forcing a hand:
   try taking inventory.

wi 19.13 Rulebooks producing values
rb 9.5 Dice and Playing Cards

🔗

RB §9.6 Reading Matter

Many things can be read, from warning notices to encyclopaedias, and a range of techniques is needed to provide them because the quantity of text, and how it presents itself, can vary so much. With a small amount of very large type, the player should not need any command at all to read the text:

The road sign is in the Junction. The road sign is fixed in place. "A road sign points north: 'Weston on the Green - 6'."

If the print is smaller, or the object portable, the player will expect to use the EXAMINE command:

The business card is in the Junction. The description is "'Peter de Sèvres: consultant mnemonicist.'"

But if the object is a leaflet, say, EXAMINE should only describe the cover: READ would be the command a player would expect to use to get at the text itself. Inform normally defines READ to be the same command as EXAMINE, which is good for things like the business card, but counter-productive here. The Trouble with Printing ★ shows how to separate these two commands, allowing any thing to have a property called its "printing" for text produced by READ, which will be different from its "description", the text produced by EXAMINE.

If the object is a lengthy diary, say, nobody would read it from cover to cover in a single IF turn. We might then want to allow the player to turn the pages one by one, with commands like READ PAGE 4 IN DIARY or READ THE NEXT PAGE: see Pages ★.

If the object is an encyclopaedic reference work, the player would consult named entries: see Costa Rican Ornithology ★★★, which allows commands like LOOK UP QUETZAL IN GUIDE.

Still larger sources of text often occur in IF: libraries or bookshelves, where many books are found together, and it is clumsy to write them as many individual items. One approach is to simulate an entire bookshelf with a single thing: see Bibliophilia ★★. (This is much like looking up topics in a single book, except that each topic is a book in itself.) Another is to provide each book as an individual item, but have them automatically join together into a single portable collection: see AARP-Gnosis ★★.

Signs, leaflets and encyclopaedias, being printed, have a wording which will never change during play. But sometimes the player reads something which acts of its own accord. Text substitutions are usually all that is needed to achieve this:

The computer display is on the desk. The description is "Giant green digits read: [the time of day]."

This is easy because we know all the variations we want. But what if we want the player to write his own text, for instance, adding to a diary? This is trickier, because it means storing text as the player typed it, and replaying it later. (And suppose the player types reams and reams of text, not just a few words as we might have hoped?) The Fourth Body ★ and The Fifth Body ★★ show how to use an external file - a multimedia trick requiring features only available if the project is set to the Glulx story file format - to handle even the most difficult cases.

Should we want a computer that responds to vocal commands, as in ASK COMPUTER ABOUT KLINGONS, the built-in extension Inanimate Listeners will allow the player to talk to inanimate objects as well as people.

Examples

292. The Trouble with Printing ★

"The Trouble with Printing"

A thing has some text called printing. The printing of a thing is usually "blank".

Understand the command "read" as something new. Understand "read [something]" as reading. Reading is an action applying to one thing, requiring light. Check reading: if the printing of the noun is "blank", say "Nothing is written on [the noun]." instead. Carry out reading: say "You read: [printing of the noun][line break]". Report reading: do nothing.

The Archive is a room.

Berkeley's report is a thing in the Archive. The description is "A report from Governor Sir William Berkeley of Virginia, in 1671, in answer to the queries sent by the Commissioners of Plantations the year previous. Of this report the better part is burned and only a tail fragment remains." The printing of Berkeley's report is "I thank God, [italic type]there are no free schools[roman type] nor [italic type]printing[roman type], and I hope we shall not have these hundred years; for [italic type]learning[roman type] has brought disobedience, and heresy, and sects into the world, and [italic type]printing[roman type] has divulged them..."

Test me with "examine report / read report".

Since we defined reading as an action requiring light, we could further distinguish reading and examining (if we wanted) by writing some different visibility rules for it.

wi 17.3 Overriding existing commands
rb 9.6 Reading Matter

303. Pages ★

Suppose we have a book that the player must consult page-by-page, and we want to be able to accept all of the following input:

> READ BOOK (to choose a random page and read it)
> READ PAGE 1 IN BOOK
> READ PAGE 2
> READ THE LAST PAGE OF THE BOOK
> READ THE NEXT PAGE
> READ PREVIOUS PAGE IN BOOK
> READ THE FIRST PAGE

One approach would be to write many different understand rules and actions: one action for reading randomly, one for reading a specific page, one for reading the first page, one for reading the previous page, one for reading the next page, and one for reading the last page. But this gets tedious to construct and maintain.

More usefully, we could consider that all of the last four options are essentially the same action at heart: the player is asking to read a page in the book using a name rather than a number, and we will have to perform a minor calculation to discover what the number should be. Here's an implementation using named values to resolve this problem:

"Pages"

The Library is a room. The sinister book is carried by the player. The sinister book has a number called the last page read. The sinister book has a number called the length. The length of the sinister book is 50.

Understand the command "read" as something new.

Understand "read [something]" or "consult [something]" or "read in/from [something]" as reading. Reading is an action applying to one thing, requiring light.

Understand "read [number] in/from/of [something]" or "read page [number] in/from/of [something]" or "look up page [number] in/from/of [something]" or "consult page [number] in/from/of [something]" as reading it in. Reading it in is an action applying to one number and one thing, requiring light.

Named page is a kind of value. The named pages are first page, last page, next page, previous page.

To decide what number is the effective value of (L - last page):

decide on the length of the book.

To decide what number is the effective value of (F - first page):

decide on 1.

To decide what number is the effective value of (N - next page):

let X be the last page read of the book plus 1;

decide on X.

To decide what number is the effective value of (P - previous page):

let X be the last page read of the book minus 1;

decide on X.

Understand "read [named page] in/from/of [something]" or "read the [named page] in/from/of [something]" as reading it relatively in. Reading it relatively in is an action applying to one named page and one thing, requiring light.

Does the player mean reading something in the sinister book: it is very likely.

This is the book requirement rule:

if the player is not carrying the sinister book, say "You're not reading anything." instead.

Check reading it relatively in:

if the second noun is not the sinister book, say "There are no pages in [the second noun]." instead;

abide by the book requirement rule.

Carry out reading it relatively in:

let N be the effective value of the named page understood;

now the number understood is N;

try reading N in the book.

Check reading it in:

if the second noun is not the sinister book, say "There are no pages in [the second noun]." instead;

abide by the book requirement rule.

Check reading it in:

if the number understood is greater than the length of the sinister book, say "There are only [length of sinister book in words] pages in the book." instead;

if the number understood is less than 1, say "The page numbering begins with 1." instead.

Carry out reading it in:

read page number understood.

Check reading:

if the noun is not the sinister book, say "There are no pages in [the noun]." instead;

abide by the book requirement rule.

Carry out reading:

let N be a random number between 1 and the length of the sinister book; now the number understood is N;

say "You flip the pages randomly and arrive at page [the number understood]:[paragraph break]";

try reading the number understood in the sinister book.

Table of Book Contents

page	content
2	"dhuma jyotih salila marutam / samnipatah kva meghah / samdes arthah kva patukaranaih / pranibhih prapaniyah"
13	"amathesteron pws eipe kai saphesteron"
50	"Rrgshilz maplot..."

To read page (N - a number):

now the last page read of the sinister book is N;

if there is a content corresponding to a page of N in the Table of Book Contents:

choose row with a page of N in the Table of Book Contents;

say "You read: '[content entry]'[paragraph break]";

otherwise:

say "Page [N] appears to be blank."

To read page (N - 47):

say "Your eyes burn; your ears ring. Beneath your gaze, the dreadful sigils writhe, reminding you of that which lies outside the edges of the universe...";

end the story saying "You have lost your remaining sanity".

Test me with "read from the sinister book / read the book / read the next page / read page 2 / read previous page / g / read the first page / read the last page of the book / read the next page / read 47 in book".

wi 17.9 Understanding kinds of value
rb 9.6 Reading Matter

442. The Fourth Body ★

Some mystery games supply the player with an in-game system for taking notes, in case he doesn't want to rely on scraps of paper next to the computer. One way of doing this is to write out all the player's notes and observations into a notebook file, whose contents can be retrieved during play (or, indeed, after it).

We'll first invent a general system for writing text into notebooks, by creating a new kind called jotter. Each individual jotter will have its own disc file, and there will be basically three things which can be done with jotters: erasing, reading and writing.

"The Fourth Body"

A jotter is a kind of thing. A jotter has an external file called the text file. A jotter can be fresh or used. A jotter is usually fresh. A jotter has a text called the heading.

The currently erased jotter is an object that varies.

To erase (pad - a jotter):

now the currently erased jotter is the pad;

write "[heading of the currently erased jotter][paragraph break]" to the text file of the pad;

now the pad is fresh.

To write in (pad - a jotter):

append "[the time of day]: [topic understood][line break]" to the text file of the pad;

now the pad is used.

To read (pad - a jotter):

say "You read: [paragraph break][text of the text file of the pad]".

This is all as might be expected, except perhaps for the business of the "currently erased jotter". Why copy "pad" into this - why not simply write "[heading of the pad]"? The answer is that "pad" is a temporary "let" value, and cannot be used inside other phrases, such as the "write … to …" phrase.

We want to erase any jotters when play begins, as otherwise text left over from any previous games will still be visible:

When play begins:
   repeat with pad running through jotters:
      erase the pad.

Now we need to create rules to allow the player to control reading, writing and erasing. Reading we will handle with the ordinary examining action, but we create new actions for writing and erasing. A nice little trick allows WRITE WHATEVER to default to writing WHATEVER in a notebook being carried.

Instead of examining a used jotter (called the pad):
   read the pad.
 
Instead of examining a fresh jotter (called the pad):
   say "There is nothing of note in [the pad]."
 
Understand "write [text] in [something preferably held]" as writing it in. Understand "write [text]" as writing it in. Writing it in is an action applying to a topic and one thing. Rule for supplying a missing second noun while writing: if a jotter (called the pad) is carried, now the second noun is the pad; otherwise say "You will have to specify what to write that it."
 
Check writing it in:
   if the second noun is not a jotter, say "It would be better to write in a notebook." instead.
 
Carry out writing it in:
   write in the second noun.
 
Report writing it in:
   say "Under the current time, you write '[the topic understood]' into [the second noun]."
 
Understand "erase [something preferably held]" as erasing. Erasing is an action applying to one carried thing.
 
Check erasing:
   if the noun is not a jotter, say "It's hard to see how." instead.
 
Carry out erasing:
   erase the noun.
 
Report erasing:
   say "You scrub out all the entries in [the noun]."

That completes a general-purpose implementation of jotters, and we put it to use:

The player carries a jotter called your notebook. The file of Player's Observations is called "notebook". The text file of your notebook is the file of Player's Observations. The heading of your notebook is "Observations in the Pottingham Green Case".
 
The Damp Hillside is a room. "It is just after dawn: among the trees there is misty and pale blue light. [if Havers is in the location]The only saturated color in view is the orange-and-yellow jacket of [Detective Havers]. She is trying unsuccessfully to light a cigarette. [end if][paragraph break]The body itself is further down, closer to the bottom of the ravine. It would be foolish to speculate before seeing it, but the odds are that the corpse was rolled down after death. The ground is not steep enough for the fall itself to be deadly."
 
Detective Havers is a woman in the Damp Hillside. The description is "She gives you a weak smile when you look at her: you know she hasn't slept more than three hours any of the last few nights." Havers is scenery.
 
Havers is carrying a jotter called Barbara's notebook. The file of Barbara's Observations is called "barbara". The text file of Barbara's notebook is the file of Barbara's Observations. The heading of Barbara's notebook is "I could murder a cup of tea".
 
The time of day is 6:32 AM.
 
Instead of examining your notebook when your notebook is fresh:
   say "Your notebook is blank. Back in the office, of course, there are a stack of others. But you brought a fresh notebook in a kind of weary hope. You're going to pretend, just for now, that this body might be unrelated to the graphic string of murders you're already investigating."

wi 23.14 Writing, reading and appending text to files
rb 9.6 Reading Matter

324. Bibliophilia ★★

Suppose we want a bookshelf with a very large number of books on it. They aren't to be taken or carried around in the game, but they should be mentioned, and the player should be allowed to look them up by name. Furthermore, the player's attempts to examine something unrecognized should be understood as an attempt to look up a title -- but only when the player is in the presence of the books. The rest of the time such requests should be rejected in the usual way.

"Bibliophilia"

The Graduate Lounge is a room. "Shabby sofas; plastic cups remaining from the afternoon's pre-lecture espresso; a collection of Xena and Hercules figurines posed for ironic effect. It's somewhat depressing at this hour, when everyone has gone home."

The Classics Reading Room is south of the Lounge. "Not as large a collection as the one in the Library, but it contains copies of everything really essential for reference."

Understand "examine [text]" as examining as a book when the player is in the Reading Room. Understand "look up [text]" as examining as a book when the player is in the Reading Room.

Examining as a book is an action applying to one topic.

Carry out examining as a book:

say "You can't find any such text."

Instead of examining as a book a topic listed in the Table of Book Titles:

say "[description entry][paragraph break]"

Table of Book Titles

topic	title	description
"Reading Greek Death" or "reading/greek/death" or "greek death"	"Reading Greek Death"	"A dense orange paperback treatise on the development of Greek eschatology."
"TAPA/Transactions/134-2"	"TAPA 134-2"	"Transactions of the American Philological Association from 2004."
"Oxford Classical Dictionary" or "OCD/dictionary/classical/oxford"	"Oxford Classical Dictionary"	"A hefty reference with short articles on everything from Greek meter to ancient cosmetics."
"Collected Dialogues of Plato" or "Plato/dialogues/hamilton/cairns"	"Collected Dialogues of Plato"	"All the Platonic dialogues -- some, admittedly, in rather tired translations -- but still a useful single volume, ed. Edith Hamilton and Huntington Cairns."
"Adobe Illustrator CS User Guide" or "user guide" or "adobe illustrator" or "adobe/illustrator/cs/user/guide"	"Adobe Illustrator CS User Guide"	"Hello, how did this get here? A suspiciously familiar name is scribbled inside the front cover..."

Some books are scenery in the Reading Room. Understand "copies" or "book" or "shelf" or "shelves" as the books. Instead of examining the books:

choose a random row in the Table of Book Titles;

say "You scan the shelves and notice, among others, a volume entitled [italic type][title entry][roman type]."

Test me with "south / examine ocd / examine books / examine books / examine plato / n / x hercules / s / x hercules".

Now if we type >X HERCULES in the Lounge, we will get

>x hercules
You can't see any such thing.

thanks to our somewhat slovenly implementation of the Lounge scenery; but in the Reading Room,

>x hercules
You can't find any such text.

In practice we might also want to extend our coverage somewhat to handle a case where the player tried to take books from the bookshelf: currently that would not be understood.

wi 17.17 Context: understanding when
rb 9.6 Reading Matter

335. AARP-Gnosis ★★

Suppose we have a complete Encyclopedia in our game. The player is allowed to pick up the whole set (there must not be too many volumes), but also to do things with individual volumes, and indeed to scatter these volumes all over the place. Putting a volume back in the same place as the rest of the Encyclopedia should, however, restore it to the collective. We will start out by defining general rules for collectives like this:

"AARP-Gnosis"

Fitting relates various things to one thing (called the home). The verb to fit means the fitting relation. Definition: a thing is missing if it is not part of the home of it.

A collective is a kind of thing.

Before doing something to something which is part of a collective:

let space be the holder of the home of the noun;

move the noun to the space.

Instead of examining a collective:

say "[The noun] consists of [the list of things which are part of the noun]."

Now the real work begins. One reason to make this an activity is that we might easily want to override it for specific objects; for instance, the generic collecting activity here would not deal properly with collectives of clothing where some items might be worn and others not. In that case, we would want to write another, more specific "collecting" activity to handle the complexities of fashion.

Collecting something is an activity.
 
Every turn:
   repeat with item running through collectives:
      carry out the collecting activity with the item.
 
To remove (item - a thing) when empty:
   let space be the holder of the item;
   if the number of things which are part of the item is 0:
      now the item is nowhere;
   if the number of things which are part of the item is 1:
      let the last thing be a random thing which is part of the item;
      move the last thing to the space;
      now the item is nowhere.
 
Before collecting a thing (called the item):
   remove item when empty;
   let space be the holder of the item;
   if space is not a thing and space is not a room:
      if something (called the other space) contains at least two things which fit the item, move item to the other space;
      if a room (called the other space) contains at least two things which fit the item, move item to the other space;
      if someone (called the owner) carries at least two things which fit the item, move item to the owner.
 
Rule for collecting a thing (called the item):
   let space be the holder of the item;
   if space is a thing or space is a room:
      repeat with component running through things held by the space:
         if the component fits the item, now the component is part of the item;
      remove item when empty.

And now for a cheerful scenario:

The Boise Memorial Library is a room. "A concrete box of a room, roughly eight feet by fourteen, which contains all the fallout shelter has to offer by way of entertainment. Someone with a grim sense of humor has tacked a READ! literacy poster to the door, as though there were anything else to do while you await the calming of the Geiger counters." The shelf is a supporter in the Library. "A battered utility shelf stands against the south wall."
 
The New Idahoan Encyclopedia Set is a collective. Volume A-Aalto fits the Encyclopedia. It is part of the Set. Volume AAM-Aardvark fits the Encyclopedia. It is part of the Set. Volume Aarhus-Aaron fits the Encyclopedia. It is part of the Set. Volume AARP-Gnosis fits the Encyclopedia. It is part of the Set. Volume Gnu-Zygote fits the Encyclopedia. It is part of the Set. The Set is on the shelf.

Let's have the Encyclopedia describe itself differently depending on whether it's all in one place:

After printing the name of the Set when something missing fits the Set:
   say " (missing [a list of missing things which fit the Set])"
 
Before printing the name of the Set when the number of missing things which fit the set is 0:
   say "complete ".
 
Test me with "get aarhus-aaron / look / inventory / get aam-aardvark / look / get gnu-zygote / look / get aarp-gnosis / look / inventory / drop set / look / get set / get a-aalto / inventory".

wi 18.5 New activities
rb 9.6 Reading Matter

443. The Fifth Body ★★

The implementation here is much like that of the previous example, except that we allow the player to write his notebook input as a separate command, leading to an exchange such as

>write in my notebook
You open your notebook and prepare to write in it.
 
>>Am beginning to think that HT and BGG are in this together.
You finish writing and fold your notebook away.
 
>read my notebook
You read:
 
Wednesday morning
 
Am beginning to think that HT and BGG are in this together.

The opening is much as before:

"The Fifth Body"

A jotter is a kind of thing. A jotter has an external file called the text file. A jotter can be fresh or used. A jotter is usually fresh. A jotter has a text called the heading.

The currently erased jotter is an object that varies.

To erase (pad - a jotter):

now the currently erased jotter is the pad;

write "[heading of the currently erased jotter][paragraph break]" to the text file of the pad;

now the pad is fresh.

To write in (pad - a jotter):

append "[the time of day]: [player's command][line break]" to the text file of the pad;

now the pad is used.

To read (pad - a jotter):

say "You read: [paragraph break][text of the text file of the pad]".

When play begins:

repeat with pad running through jotters:

erase the pad.

Instead of examining a used jotter (called the pad):

read the pad.

Instead of examining a fresh jotter (called the pad):

say "There is nothing of note in [the pad]."

Target jotter is an object that varies. The target jotter is usually nothing.

Understand "write in [something preferably held]" as writing in. Writing in is an action applying to one thing.

Check writing in:

if the noun is not a jotter, say "It would be better to write in a notebook." instead.

Carry out writing in:

now the command prompt is ">>";

now the target jotter is the noun.

Report writing in:

say "You open [the noun] and prepare to write in it."

Now what happens is that the player, having typed WRITE IN NOTEBOOK, will be faced with a ">>" prompt instead of the usual ">": a sign that the input mode has changed.

The next code is to react to reading a command. Whatever the player types at the >> prompt when the target jotter is set will now be recorded in the notebook, though with a character limit of about 60-100 characters depending on how much upper-case and punctuation he uses. (There are ways to lift the character length restriction as well, but they would take us into deeper waters.)

After reading a command when target jotter is a jotter:
   now the command prompt is ">";
   write in target jotter;
   now target jotter is used;
   say "You finish writing and fold your notebook away.";
   now the target jotter is nothing;
   reject the player's command.
 
Understand "erase [something preferably held]" as erasing. Erasing is an action applying to one carried thing.
 
Check erasing:
   if the noun is not a jotter, say "It's hard to see how." instead.
 
Carry out erasing:
   erase the noun.
 
Report erasing:
   say "You scrub out all the entries in [the noun]."
 
The player carries a jotter called your notebook. The file of Player's Observations is called "notebook". The text file of your notebook is the file of Player's Observations. The heading of your notebook is "Sunday Morning".
 
The Vestry is a room. "[Havers] hangs back by the door: the forensics expert is not finished with a preliminary examination of the body. From here you can't see much, except that the expert has peeled back and laid to one side a liturgical vestment that someone at the church used to cover the corpse until the police came. What was once a cream silk with festive Easter embroidery is now stained with blood-colored handprints."
 
Detective Havers is a woman in the Vestry. The description is "She looks glumly back. There's still a purple-ish bruise on her cheekbone from the disaster Thursday afternoon." Havers is scenery.
 
Havers is carrying a jotter called Barbara's notebook. The file of Barbara's Observations is called "barbara". The text file of Barbara's notebook is the file of Barbara's Observations. The heading of Barbara's notebook is "Sun. AM".
 
The time of day is 9:11 AM.

wi 23.14 Writing, reading and appending text to files
rb 9.6 Reading Matter

94. Costa Rican Ornithology ★★★

The following relies on quite a number of features we haven't met yet: tables, rules for printing names, instructions for understanding the player's commands. It is offered simply as an example of how a fully implemented book might be handled in Inform.

"Costa Rican Ornithology"

A book is a kind of thing. Understand "book" as a book. A book has a table name called the contents.

Instead of consulting a book about a topic listed in the contents of the noun:

say "[reply entry][paragraph break]".

Report consulting a book about:

say "You flip through [the noun], but find no reference to [the topic understood]." instead.

With this "topic understood" phrase, we're telling Inform to print back the word or phrase that the player was attempting to look up. This overrides the more general default response, "You discover nothing of interest in the book."

We now have the essential elements to construct whatever books we like. Now let's have an example of a specific book:

The Guide to Central American Birds is a book carried by the player. The contents of the Guide is the Table of Listed Birds.

We will come back to the idea of tables and table names later, but for now the important thing is that we have instructed Inform to look up its answers to consulting the bird guide in this form:

Table of Listed Birds

topicreply
"[red]" or "[red] bird/macaw""You flip through the Guide for a while and eventually discover a reference to the [scarlet macaw], which appears to correspond with what you see before you."
"quetzal/trogon" or "resplendent trogon""The entry on the quetzal is quite lyrical, describing its brilliant plumage, flashing and igniting in the sunshine, which is supposedly sufficient to lure birdwatchers from all over the world. Unfortunately, the quetzal is described as being bright emerald in color, with a pink fuzz on its head and a long soft tail 'like a feather boa'. None of these describes your visitor."

The topic column is a bit special: it matches the player's input, and is not meant to be printed out again. Topic columns will be discussed further in the chapter on Tables. (Note also that, however it may appear in the documentation, the topic column should not be spanning multiple lines in our source text.)

We may also compress long or complicated topics by creating bracketed abbreviations, and in fact it's useful to do so now, to explain the red token we just used:

Understand "red-orange" or "bird" or "red" or "orange" as the scarlet macaw. Understand "red-orange" or "red" or "orange" or "scarlet" as "[red]".

This technique is discussed further in the chapter on Understanding.

If we wanted more books, we could define those in the same way, giving each its own separate contents table to be used for consultation. But for the sake of the example we will keep it simple, and move on to the scenario itself:

The Veranda is a room. "From here you can see a considerable expanse of dense-growing jungle plants, and eventually the open water beyond."
 
The scarlet macaw is an animal in the veranda. "A vibrantly-colored [scarlet macaw] perches on the rail."
 
A thing can be known or unknown.
 
Before printing the name of the scarlet macaw while consulting:
   now the scarlet macaw is known.
 
Rule for printing the name of the unknown scarlet macaw: if the macaw is unknown, say "red-orange bird of unknown species".
 
Test me with "look up penguins in the guide / look up quetzal in guide / look up silver nuthatches in the guide / look / look up red bird in the book / look".

wi 7.6 Reading and talking
rb 9.6 Reading Matter

🔗

RB §9.7 Painting and Labeling Devices

Writing on something is only one way a player can change its visual appearance. IF authors have long been wary of paint brushes, because a sufficiently motivated player could go through a whole landscape like a graffiti artist with a railway bridge. We want to give the player the illusion of freedom of action, while avoiding a situation where unlimited numbers of different decorations might be needed - that would need a table of potentially unlimited size.

One approach is to limit the number of items which can be decorated. In Palette ★, only the canvas can be painted, and each image overlays the last. Early Childhood ★★★ increases the range to allow a whole kind ("block") to be painted, and also shows how the changing colours can be used to distinguish between otherwise identical objects.

Brown ★★★ finds a different way to limit the number of simultaneous decorations: almost anything can have a red sticky label attached, but there is only one red sticky label. (So to decorate a new item, the player must first un-decorate an old one.)

Examples

308. Palette ★

There are hundreds of traditional pigments, from lampblack to burnt sienna, so we will confine ourselves to just two:

"Palette"

The Atelier is a room. "The floridly untidy loft space used by a moderately unsuccessful artist (you, that is)." The canvas, palette and paint brush are here. Understand "painting" as the canvas.

Colour is a kind of value. The colours are white, red, blue and green.

The canvas has a colour. The canvas is white. The printed name of the canvas is "largely [colour] canvas".

Painting is an action applying to one thing and one colour. Check painting: if the noun is not the canvas, say "Centuries of tradition suggest that canvas is the natural home of paint." instead. Carry out painting: now the colour of the canvas is the colour understood. Report painting: say "You splash away at the now [canvas]."

Understand "paint [something] [a colour]" as painting.

Understand "calico" as white. Understand "cerulean" or "cerulean blue" as blue.

Test me with "examine canvas / paint canvas red / examine canvas / paint canvas cerulean / examine canvas".

wi 17.11 Understanding values
rb 9.7 Painting and Labeling Devices

36. Brown ★★★

"Brown"

The Shipping Room is a room. The red sticky label is a thing carried by the player. The description of the red sticky label is "It reads: AIRMAIL[if the label is part of something (called the parent)]. It is stuck to [the parent][end if]."

A black crate is in Shipping. The description is "A boring black crate." The brown crate is a thing in Shipping. The description is "An ordinary brown crate."

After examining something when the label is part of the noun:

say "A bright red sticky label is attached to [the noun]!"

Here is the essential point: whenever we ATTACH LABEL TO something, it becomes part of that object.

Instead of tying the red sticky label to something:
   now the red sticky label is part of the second noun;
   say "You stick [the label] to [the second noun]."

And of course the label cannot be stuck to itself or to more than one thing at a time.

Before tying the label to something when the label is part of something:
   if the label is part of the second noun:
      say "[The label] is already stuck to [the second noun]." instead;
   otherwise:
      say "(first freeing the label)[line break]";
      silently try taking the label;
      if the label is part of something, stop the action.
 
Instead of tying the red sticky label to the label:
   say "That would ruin the label entirely."
 
Instead of taking the label when the label is part of something:
   now the player carries the label;
   say "You peel the label off again."

Much of the rest is just tidying to make sure that the player's commands are redirected into the right syntax.

Instead of tying something to the label:
   try tying the label to the noun.
 
Instead of putting the label on something:
   try tying the label to the second noun.
 
Instead of inserting the label into something:
   try tying the label to the second noun.
 
Understand the commands "stick" or "apply" as "tie".

We could have created a new "sticking" action, but to keep the example short we will use the built-in "tying" action instead, and respond to the command "stick" just as if it were "tie".

Understand "peel [something]" or "peel off [something]" as taking.
 
Test me with "i / put label on the black crate / look / x black / x label / get the label / apply label to brown crate / look / x brown / peel off label / stick label to label".

wi 3.23 Parts of things
rb 9.7 Painting and Labeling Devices

55. Early Childhood ★★★

This would be a one-star example if it were not for the repainting:

"Early Childhood 1"

A building block is a kind of thing. A red block, a blue block and a green block are kinds of building block.

The Nursery is a room. In the Nursery are six red blocks, four blue blocks and a green block.

Test me with "look / get red block".

But a kind cannot change during play, so this will not do. Instead, the colour will have to be a property of the block. So we might first try this:

"Early Childhood 2"

Colour is a kind of value. The colours are red, blue and green. A block is a kind of thing. A block has a colour. A block is usually blue.

The Nursery is a room. In the Nursery are six red blocks, four blue blocks and a green block.

Test me with "look / get red block".

Which is fine, so far as it goes, but the colour property is not at all visible to the player, who simply sees "eleven blocks". We thought of colour as being something outwardly apparent, but Inform does not know this. To achieve a better effect, we will need features from distant chapters. The first is an activity called "printing the name of":

"Early Childhood 3"

Colour is a kind of value. The colours are red, blue and green. A block is a kind of thing. A block has a colour. A block is usually blue. Before printing the name of a block: say "[colour] ". Before printing the plural name of a block: say "[colour] ".

The Nursery is a room. In the Nursery are six red blocks, four blue blocks and a green block.

Test me with "look / get red block".

This too, however, is unsatisfactory. The individual blocks are correctly described, but we are unable to distinguish them during play: we cannot type "take a green block", for instance. And because the blocks are indistinguishable in play, they are still massed together as "eleven blocks" in room descriptions. We need to go one step further:

"Early Childhood 4"

The Nursery is a room. In the Nursery are six red blocks, four blue blocks and a green block.

And now everything works nicely: the blocks are grouped by colour, and can be referred to by colour, and we can even change the colour of an individual block during play, using a bit of extra trickery from later:

Understand "paint [something] [colour]" as painting it. Painting it is an action applying to one thing and one colour. Check painting it: if the noun is not a block, say "Paints are only for blocks." instead. Carry out painting it: now the colour of the noun is the colour understood. Report painting it: say "The block is now [the colour of the noun]."
 
Test me with "get red block / get blue block / g / i / look / paint blue block red / i / look / paint me red".

wi 4.14 Duplicates
rb 9.7 Painting and Labeling Devices

🔗

RB §9.8 Simple Machines

The "device" kind provides for the simplest form of machine: one which is, at any given moment, switched on or switched off. Inform looks after this state, but leaves it to us to make the machine actually do something:

The air-conditioning unit is a device in the Florist's Shop. The air-conditioning is fixed in place and switched on.
 
Every turn when the location is the Florist's Shop:
   if the air-conditioning is switched off, say "You worry about the cut flowers in this jungle-hot air.";
   otherwise say "There is an low susurration from the air-conditioning unit."

One primary dictionary definition for a machine is "an apparatus using or applying mechanical power and having several parts", and we often use the "part of" relationship to build machinery. Control Center ★ provides a neat way to display the component parts of a machine to the player who examines it.

One component almost always part of an electrical machine is the (literal) switch, lever or button to control whether it is switched on or off. In Model Shop ★★ just such an on/off button is automatically made part of every device.

While an electrical device has only two states, a mechanical machine might have many, and for these the best approach is to define a kind of value naming the possibilities: see Signs and Portents ★★★, where the states are the possible destinations pointed towards.

Perhaps stretching the definition of "machine", What Makes You Tick ★ demonstrates a fishing pole which the player can put together from several pieces.

Examples

61. Control Center ★

It is straightforward to make a rule that anything with parts must mention all those parts during an EXAMINE command:

"Control Center"

After examining a thing when something is part of the noun:

say "[The noun] includes [a list of things which are part of the noun]."

The Control Center is a room. "Here you are at the Control Center of the universe."

The Universe Management Computer is a fixed in place thing in the Control Center. "The Universe Management Computer sits directly before you, unguarded." The description of the Universe Management Computer is "The computer is so large that you would be unable to operate it all from one position. Alas, it does not come with a manual."

A chartreuse indicator light, an ennui meter, a golden knob settable to 15,000 positions, a toothpick dispenser, and a button labeled RESTART are part of the Universe Management Computer.

The command chair is an enterable supporter in the Control Center. It is pushable between rooms. "Because the computer is too large for you to reach all of the front panel from a standing position, there is a command chair on casters which allows you to push back and forth." The description of the command chair is "Quite ordinary, really, but for the heady rush of power that comes of sitting in it.". Some casters are part of the command chair.

Now whenever we look at any object with components, we will first see the description, then a list of parts which belong to it. The following refinement brings in elements of later chapters, but it may be worth noting: because we've written our rule as an "After examining…", anything that pre-empts the operation of the examine command will also prevent that rule from occurring. So for instance:

A hair-thick needle is part of the ennui meter.
 
Instead of examining the ennui meter: say "You can't be bothered."

…would not result in the needle being mentioned.

Test me with "x chair / x computer / x ennui meter"

wi 5.5 Text with lists
rb 9.8 Simple Machines

426. What Makes You Tick ★

Suppose we want to let the player build a fishing pole out of three parts: a hook, a string, and a stick.

There are several things we must account for here. One is that our combination verb should be insensitive to ordering: it shouldn't matter whether the player types COMBINE STICK WITH STRING or COMBINE STRING WITH STICK.

Second, we need to make sure that our implementation handles intervening stages of assembly gracefully. The player should be able to combine string and hook first, or string and stick first, and be able to complete the assembly in either case.

Our implementation here uses a table of lists to determine which combinations of inputs should produce which result object. Because we sort our lists before comparing them, we guarantee that the player's ordering doesn't matter: COMBINE STICK WITH STRING will have the same effect as COMBINE STRING WITH STICK.

What's more, our implementation could be expanded to account for many other assemblages, if we wanted object-building to be a running theme of puzzles in our game.

"What Makes You Tick"

Understand "combine [something] with [something]" as combining it with. Combining it with is an action applying to two carried things. Understand the command "connect" as "combine".

Understand the command "attach" as something new. Understand "attach [something] to [something]" as combining it with.

The combining it with action has an object called the item built.

Setting action variables for combining something with something:

let X be a list of objects;

add the noun to X;

add the second noun to X;

sort X;

repeat through the Table of Outcome Objects:

let Y be the component list entry;

sort Y;

if X is Y:

now the item built is the result entry.

Check combining it with:

if the item built is nothing or the item built is not in limbo,

say "You can't combine [the noun] and [the second noun] into anything useful." instead.

Carry out combining it with:

move the item built to the holder of the noun;

now the noun is nowhere;

now the second noun is nowhere.

Report combining it with:

say "You now have [an item built]."

Limbo is a container. Limbo contains a hookless fishing pole, a hooked line, and a complete fishing pole.

Streamside is a room. The player carries a stick, a wire hook, and a string.

Table of Outcome Objects

component list	result
{stick, string}	hookless fishing pole
{wire hook, string}	hooked line
{hooked line, stick}	complete fishing pole
{hookless fishing pole, wire hook}	complete fishing pole

Test me with "combine stick with string / i / combine pole with hook / i".

This kind of implementation makes sense if we don't intend the player to take the fishing pole apart again, or to refer to any of its component parts once it is built. For an alternate approach that does allow assembled objects to be taken apart again, see "Some Assembly Required".

wi 21.6 Lists of objects
rb 9.8 Simple Machines

57. Model Shop ★★

Suppose we're particularly mechanically-minded and would like a game in which all of our mechanical devices have buttons to turn them on and off.

"Model Shop"

An on/off button is a kind of thing.

Instead of pushing an on/off button which is part of a switched off device (called the machine):

try switching on the machine.

Here we are making a rule about how our hypothetical buttons will interact with the machines to which they belong. Instead of pushing… is a rule that pertains to actions, and we will learn more about these in the chapter on actions. "…which is part of a switched off device" provides a specific circumstance - this is only to apply to buttons that are stuck to a machines that can be turned on or off. "(called the machine)" tells Inform that if it finds such a device, it should thereafter refer to it as "the machine." (The called syntax is explained further in the chapter on Change.)

A set of three more rules will complete our instructions about using buttons to control devices:

Instead of pushing an on/off button which is part of a switched on device (called the machine):
   try switching off the machine.
 
Instead of switching on an on/off button which is part of a device (called the machine):
   try switching on the machine.
 
Instead of switching off an on/off button which is part of a device (called the machine):
   try switching off the machine.

Then we hand out buttons with a free hand:

One on/off button is part of every device.
 
The Model Shop is a room. A model train is a fixed in place device in the Model Shop. A toy elephant is a device in the Model Shop.
 
Every turn when the model train is switched on:
   say "The model train circles your feet, blowing small puffs of steam."
 
Every turn when the toy elephant is switched on:
   say "The toy elephant waves its trunk at you."
 
Test me with "push model train's button / push elephant's button / g / switch off model train's button".

And now the game will have a model train's button and a toy elephant's button.

It may be that we want (as an added nuance) to add other names for these items. While we would want an assembly to create objects such as "Lucy's hand" and not "Lucy hand", it is entirely reasonable to want to talk about the model train button or the elephant button. We could define these additional names like so:

Understand "elephant button" or "button on elephant" as the elephant's button.
 
Understand "model train" or "model" or "train" as "[train]". Understand "[train] button" or  "button on [train]" as the model train's button.

In the second case, we are defining [train] to mean any of the three phrases "train", "model", and "model train"; so "[train] button" will match "model train button" or "train button" or "model button" equally well. See the chapter on Understanding for more on how to create alternative phrasings for the player to use.

wi 4.15 Assemblies and body parts
rb 9.8 Simple Machines

53. Signs and Portents ★★★

"Signs and Portents"

Seven Dials is a room. The description of Seven Dials is "There is a signpost, on which seven hands swivel and swing, freely as weathercocks. They make your present road now London, now Abingdon; now Weston-super-Mare, or now Hell."

Seven Dials contains a signpost. The signpost is scenery. Understand "sign" and "post" as the signpost.

Destination is a kind of value. The destinations are London, Abingdon, Luton, Weston-super-Mare, Runnymede, Hell, and Low Noon.

The signpost has a destination.

In order to interact with the signpost, we will need to make use of some action rules:

Instead of examining the signpost:
   say "[The signpost] currently puts you on the road to [italic type][the destination of the signpost][roman type], but it swiftly alters again.";
   now the destination of the signpost is the destination after the destination of the signpost.
 
Instead of turning the signpost:
   now the destination of the signpost is the destination after the destination of the signpost;
   say "With a hand's touch you turn the signpost to mark your way for [italic type][the destination of the signpost][roman type]."
 
Instead of going north in Seven Dials when the destination of the signpost is Hell:
   say "It is a path that goes gently ever down and down with no stumbling block or any distraction at either side; there are no bandits and no tolls.";
   end the story.
 
Instead of going north in Seven Dials when the destination of the signpost is Low Noon:
   say "A long road whose scenery does not change, nor anything on the horizon move but the sun. When at last you come to Noon, she hangs above your head like a hat.";
   end the story finally.
 
Test me with "x signpost / n / turn signpost / n / turn signpost / n / turn signpost / n / turn signpost / n".
 
Test more with  "x signpost / n / turn signpost / n / turn signpost / n / turn signpost / n / turn signpost / turn signpost / n".

wi 4.9 Using new kinds of value in properties
rb 9.8 Simple Machines

🔗

RB §9.9 Televisions and Radios

IF authors often provide clues or background information to the player by means of radio broadcasts, TV shows or video tapes because they can talk to the player without needing to listen back, or to react to what the player does. The simplest radio set, like the one in Aftershock ★★★, really only has one thing to say: which is serendipitously being broadcast just at the moment the player tunes in (regardless of when that is). The next simplest approach is to spool a broadcast on an endless loop taking several turns to play through, as in Radio Daze ★.

Televisions come in all shapes and sizes, and Aspect ★ allows their shape ("aspect ratio") to be described by the player.

In Channel ★★, we can also refer to the television by what it is currently showing: thus WATCH CHANNEL 4 will work if the set is indeed tuned to 4. In Channel 2 ★★★, numbered channel changing is taken further: we can now TUNE TV TO CHANNEL 3, as well. Channel 2 ★★★ is a reasonable base implementation of a television for many purposes.

Examples

66. Radio Daze ★

"Radio Daze" by Jon Ingold

The Living Room is a room. "A long couch, set up so you can see your wireless set. Not that you need to see it, of course."

The long couch is an enterable scenery supporter in the living room. Instead of entering the long couch when the radio was switched off, say "Better turn the radio on before you get comfortable." Report entering the couch: say "You settle yourself down to listen." instead. Instead of listening when the radio is switched on, stop the action.

The radio is a device in the living room. The radio is switched off. "[if switched on]The radio burbles on[otherwise]The radio is off[end if]." Check switching off the radio when the player is on the long couch: say "You can't reach the radio from here." instead.

Every turn when the radio is switched on:

say "[one of]Two characters in the radio play have begun an argument[or]The argument continues[or]The play continues[stopping]: [one of]'Did not!'[or]'Did too!'[or]'Did I?'[or]'You did!'[or]'I couldn't have, Martha!'[or]'But you did, Tom!'[cycling]"

Test me with "sit on couch / turn on radio / sit on couch/ listen / g / g / g / g / g".

wi 5.7 Text with random alternatives
rb 9.9 Televisions and Radios

311. Aspect ★

Named properties are not the only kind that Inform is able to understand referring to an object. We can also use unit and number properties to distinguish things from one another, as here, where televisions have aspect ratios:

"Aspect"

An aspect ratio is a kind of value. 16:9 specifies an aspect ratio.

A television is a kind of device. A television has an aspect ratio. Understand the aspect ratio property as referring to a television. Understand "European standard" as 16:9.

The Office is a room.

The widescreen TV is a television in the Office. The fifties TV is a television in the Office. The widescreen TV is 16:9. The fifties TV is 4:3.

Test me with "examine european standard tv / x 16:9 tv / x 4:3 tv".

wi 17.15 Understanding things by their properties
rb 9.9 Televisions and Radios

313. Channel 1 ★★

We might want to allow every television to be tuned to a channel (a number property) which the player could refer to, so that

WATCH CHANNEL 13
TURN OFF CHANNEL 4

would be directed to the appropriate television object, if any television is turned on and tuned to the correct station. We might now write:

"Channel"

A television is a kind of device. A television has a number called the channel. Understand the channel property as referring to a television. Understand "channel" as a television.

The Office is a room. The widescreen TV is a television in the Office. The fifties TV is a television in the Office.

Changing the channel of it to is an action applying to one thing and one number.

Understand "tune [something] to [number]" or "change channel of [something] to [number]" as changing the channel of it to.

Check changing the channel of something to:

if the noun is not a television, say "[The noun] cannot be tuned to a channel." instead.

Carry out changing the channel of something to:

now the channel of the noun is the number understood.

Report changing the channel of something to:

say "You tune [the noun] to channel [number understood]."

Instead of examining a television:

if the noun is switched off, say "[The noun] is currently turned off." instead;

let the chosen channel be the channel of the noun;

if the chosen channel is a current channel listed in the Table of Television Channels:

choose row with current channel of the chosen channel in the Table of Television Channels;

say "[output entry][paragraph break]";

otherwise:

say "Snow fills the screen of [the noun]."

Table of Television Channels

current channel	output
0	"The screen of [the noun] is completely black."
4	"A gloomy female news anchor describes the latest car bomb in Baghdad: 104 dead today, and no sign of change."
5	"A couple of contestants in spangled scarlet outfits are performing an energetic paso doble."
13	"On-screen, Ichiro is up to bat with one man on second and no outs."

Test me with "change channel of fifties tv to 4 / x channel 4 / switch on fifties / x channel 4 / switch on widescreen / tune fifties tv to 5 / x channel 5 / x fifties tv / x channel 4".

wi 17.15 Understanding things by their properties
rb 9.9 Televisions and Radios

316. Channel 2 ★★★

Our previous implementation of televisions ("Channel 1") doesn't allow the player to type things like

TUNE FIFTIES TELEVISION TO CHANNEL 4

nor does it deal with player input like

TUNE TO CHANNEL 4 ON FIFTIES TELEVISION

TUNE TO CHANNEL 4

where no television is specified. When we are designing commands which involve two elements (here, a television and a channel number), it's usually a good idea to allow the player to specify those elements in either order, as we saw demonstrated briefly in "New commands for old grammar".

We might, therefore, want to add a few refinements: first by defining a "[channel]" token that will accept input of the forms "[number]" and "channel [number]", and second by creating some additional "Understand" lines that will accept variant versions of the player's input.

"Channel 2"

Section 1 - Televisions in General

A television is a kind of device.

A television has a number called the channel. Understand the channel property as referring to a television. Understand "channel" as a television.

Changing the channel of it to is an action applying to one thing and one number.

Understand "tune [television] to [channel]" or "change channel of [television] to [channel]" as changing the channel of it to.

Understand "tune [something] to [channel]" or "change channel of [something] to [channel]" as changing the channel of it to.

Understand "tune to [channel] on [television]" or "change to [channel] on [television]" as changing the channel of it to (with nouns reversed).

Understand "tune to [channel] on [something]" or "change to [channel] on [something]" as changing the channel of it to (with nouns reversed).

Understand "[number]" or "channel [number]" as "[channel]".

Check changing the channel of something to:

if the noun is not a television, say "[The noun] cannot be tuned to a channel." instead.

Carry out changing the channel of something to:

now the channel of the noun is the number understood.

Report changing the channel of something to:

say "You tune [the noun] to channel [number understood]."

Instead of examining a television:

if the noun is switched off, say "[The noun] is currently turned off." instead;

let the chosen channel be the channel of the noun;

if the chosen channel is a current channel listed in the Table of Television Channels:

choose row with current channel of the chosen channel in the Table of Television Channels;

say "[output entry][paragraph break]";

otherwise:

say "Snow fills the screen of [the noun]."

Table of Television Channels

current channel	output
0	"The screen of [the noun] is completely black."

Section 2 - The Scenario

The Office is a room.

The widescreen TV is a television in the Office. The fifties TV is a television in the Office.

And we add the scenario-specific content to our Table of Television Channels; in the case of channel 13, we provide for a changing sequence of events using text variations.

Table of Television Channels (continued)

current channeloutput
4"A gloomy female news anchor describes the latest car bomb in Baghdad: 104 dead today, and no sign of change."
5"A couple of contestants in spangled scarlet outfits are performing an energetic paso doble."
13"[one of]On-screen, Ichiro is up to bat with one man on second and no outs.[or]Ichiro has singled to first and the other man is on third.[or]The next batter is in the middle of flying out.[or]Everything looks rosy until the men in black pull off a double-play and retire the side.[or]The channel has cut to a commercial.[stopping]"
 
Test me with "test one / test two".
 
Test one with "change channel of fifties tv to 4 / x channel 4 / switch on fifties / x channel 4 / switch on widescreen / tune fifties tv to channel 5 / x channel 5 / x fifties tv / x channel 4".
 
Test two with "tune to channel 13 / widescreen / tune channel 13 to channel 5 / tune channel 5 to channel 3 / widescreen / x channel 3".

wi 17.15 Understanding things by their properties
rb 9.9 Televisions and Radios

336. Aftershock ★★★

The built-in behavior of Inform is to print a line after a device is examined, saying whether the item is on or off. This is often inappropriate, and we could simply turn off that behavior in general by instructing Inform to ignore the "examine devices rule" (see the chapter on rulebooks).

Perhaps, though, we would like continue to have a short passage about the action of any switched on device; we'd just like a little more control over what it says from time to time. And in that case, we might change the rule to give a new activity control over that portion of the description:

"Aftershock"

Section 1 - Showing actions

Showing action of something is an activity.

Rule for showing action of something (called item):

if the item is switched on, say "[The item] is switched on.";

otherwise say "[The item] is switched off."

Borrowing from the rulebooks chapter, we can replace the standard "examine devices" rule with something that uses this activity.

The new described devices rule is listed instead of the examine devices rule in the carry out examining rules.
 
This is the new described devices rule:
   if the noun is a device:
      carry out the showing action activity with the noun;
      now examine text printed is true.

Thus far we have essentially replicated the original behavior, but we've made it possible to write specialized behavior for devices, and to invoke that behavior in other places:

Report switching on something:
   say "You flip a switch. ";
   carry out the showing action activity with the noun instead.

This might be useful for an electric lamp kind:

Section 2 - Electric Lamps
 
An electric lamp is a kind of device.
 
Rule for showing action of an electric lamp (called item):
   if the item is switched on, say "[The item] is lit[if the number of visible lit things is greater than 1], competing with [the list of visible lit things which are not the item][end if].";
   otherwise say "[The item] is dark."
 
Carry out switching on an electric lamp: now the noun is lit. Carry out switching off an electric lamp: now the noun is unlit.
 
Section 2 - The Scenario
 
The time of day is 3:47 AM. When play begins, now the right hand status line is "[time of day]".
 
The Downstairs Hallway is a dark room. "The only room in the house with no furniture and almost nothing on the walls. At times like this you always notice the crack in the plaster, originating near the light fixture and running almost all the way to the wall."
 
A plastic jug of filtered water is in the Downstairs Hallway. The description is "Five gallons, not that that will last you very long, hot as it has been lately."
 
The crack is scenery in the Hallway. The description is "No, the ceiling isn't going to fall on you today."
 
The light fixture is an electric lamp in the Hallway. It is switched on, lit, and scenery. The description is "A plain globe of frosted glass containing the light bulb. Nothing special, and you never think about it except when, as now, you are forced to spend hours in this room."
 
The flashlight is an electric lamp carried by the player. The description is "A shiny red flashlight." The portable radio is a device carried by the player. The description is "A small battery-operated radio which you received for free with your subscription to US News & World Report. It has served you well through many earthquakes past."

And with our activity, we can override the flashlight's electric lamp behavior with new behavior:

Rule for showing action of the flashlight:
   if the flashlight is switched on, say "A strong, narrow beam of light shines from the flashlight.";
   otherwise say "It is currently switched off."

…or give special actions for the radio:

Rule for showing action of the radio:
   if the radio is switched on, say "Through the static, you pick up pieces of discussion: a 6.7 on the Richter scale, epicenter... something about Topanga... but it crackles out again.";
   otherwise say "The radio is silent. You're saving the batteries."
 
Instead of listening in the presence of the switched on radio:
   carry out the showing action activity with the radio instead.
 
Test me with "examine light / switch light off / switch flashlight on / switch radio on / examine radio / examine flashlight".

wi 18.5 New activities
rb 9.9 Televisions and Radios

🔗

RB §9.10 Telephones

Telephones are much harder to achieve than televisions and in some ways as difficult to make convincing as a human character is - though of course there are corners which can be cut: we could have the reception drop off, or the other party hang up in a misunderstanding, and so on.

A single telephone line is tricky enough to provide that one might just as well have a general solution providing a whole network. Four Cheeses ★★★ demonstrates a system where we can dial either people or numbers: CALL JANET ON TELEPHONE, or CALL 7103, for instance.

While Four Cheeses ★★★ provides only four-digit phone numbers, like internal company extensions, Alias ★★★ shows how to manage US-style seven digit numbers.

Finally, we might occasionally want the player to be able to address a microphone or telephone receiver directly when the identity of the person on the other end is unknown, in the form TELL MICROPHONE ABOUT CRIME. Ordinarily Inform will disallow this because we're not allowed to talk to inanimate objects, but the extension Inanimate Listeners provides more options.

Examples

226. Four Cheeses ★★★

"Four Cheeses"

Section 1 - Telephones and Connections

A telephone is a kind of thing. Understand "phone" as a telephone.

Understand "call [any telephone] on [something]" as calling it on. Understand "call [any telephone]" as calling it on. Understand the commands "dial" or "phone" or "telephone" as "call". Understand "call [any known person]" as calling it by name on.

Connection relates one thing to another (called the other party).

The verb to reach means the connection relation.

Calling it on is an action applying to one visible thing and one thing.

Check calling it on:

if the second noun is not a telephone, say "[The second noun] is unlikely to be much use in that respect." instead;

if the second noun is the noun, say "You get a busy signal." instead.

Carry out calling it on:

if a person (called the listener) can see the noun, now the player reaches the listener.

Because we've said that connection is a reciprocal, one-to-one relationship, Inform will do the rest of the bookkeeping: if (for instance) we telephone someone else, the first connection will be broken automatically.

Report calling it on:
   say "'Hello?' says [the other party of the player]."

To avoid annoyance, we should also let the player use CALL #### as well as CALL #### ON TELEPHONE. A rule from the chapter on Activities comes in handy here:

Rule for supplying a missing second noun while calling something on:
   assign a phone.
 
To assign a phone:
   if the player can touch a telephone (called the current phone):
      say "(on [the current phone])[line break]";
      now the second noun is the current phone;
   otherwise:
      say "You don't have a phone handy."

Things might be a little more complicated if we had cell phones that could be moved around, but for right now the player can only touch a maximum of one phone at a time.

Suppose we further want to allow the player to call people up by name, but only if they've already been encountered or are familiar to the player for some reason.

A person can be known or unknown.
 
Understand "call [any known person]" as calling it by name on.
 
Understand "call [any known person] on [something]" as calling it by name on.
 
Rule for supplying a missing second noun while calling something by name on:
   assign a phone.
 
Calling it by name on is an action applying to one visible thing and one thing.
 
Check calling it by name on:
   if the noun is in the location, say "[The noun] is right here." instead.
 
Carry out calling it by name on:
   if the noun can touch a telephone (called the link), try calling the link on the second noun;
   otherwise say "You can't reach [the noun]." instead.
 
Before calling something on something when the player reaches someone:
   say "(first ending your conversation with [the other party of the player])[command clarification break]";
   end current conversation.
 
Understand "hang up [something]" as hanging up.
 
Hanging up is an action applying to one thing.
 
Check hanging up:
   if the noun is not a telephone, say "You can't hang up [the noun]." instead;
   if the player does not reach someone, say "You're not on the line with anyone." instead.
 
Carry out hanging up:
   now the player does not reach anyone.
 
Report hanging up:
   say "You put down [the noun], cutting the connection."
 
Before going somewhere when the player reaches someone:
   say "(first hanging up on [the other party of the player])[command clarification break]";
   end current conversation.

And finally we want to make sure that calling random other numbers produces a sensible result:

Understand "call [text]" as misdialling. Misdialling is an action applying to one topic. Carry out misdialling: say "The phone rings and rings but no one answers."
 
Understand "call 911" or "call 999" or "call police" or "call fire department" as a mistake ("After strict warnings, you've given up making prank calls to emergency services.").
 
Before misdialling when the player reaches someone:
   say "(first ending your conversation with [the other party of the player])[command clarification break]";
   end current conversation.
 
To end current conversation:
   let the current phone be a random telephone which can be touched by the player;
   silently try hanging up the current phone.
 
After deciding the scope of the player while the player reaches someone:
   place the other party of the player in scope, but not its contents.

A note about this scope addition: the player can refer to the other party whenever he has the other person on the phone. He can't, however, see or refer to anything that person might be holding or wearing, thanks to the "but not its contents" option.

Furthermore, the player can't actually do anything to that person that requires touching. That's because of the reaching inside rules, which govern whether the player can reach through intervening barriers such as rooms. (See the Advanced Actions chapter for more about changing reachability.) There are two things we might want to be careful about, though.

First, we should specifically disallow the player from looking at the person on the other end of the line. Since sight doesn't require touching, the reaching inside rules will not be consulted about a command such as EXAMINE BOSS or LOOK UNDER BOSS. We can, however, intervene in such cases using the visibility rules, which are consulted for any actions that "require light" (including EXAMINE and LOOK UNDER). Here again we borrow some options from the Advanced Actions chapter:

To decide whether acting through the line:
   if the noun is something and the location of the noun is not the location of the player:
      yes;
   if the second noun is something and the location of the second noun is not the location of the player:
      yes;
   no.
 
Visibility rule when acting through the line:
   there is insufficient light.
 
Rule for printing a refusal to act in the dark when acting through the line:
   say "You're not on a video phone, so you can only hear." instead.

Second, though the existing reaching inside rules are adequate to stop us from touching the person on the other end of the line, the response that's currently printed is a bit generic: it just says "You can't reach into [the room containing the person]." Let's add our own custom reply, instead:

A rule for reaching inside a room (called destination):
   if the other party of the player is enclosed by the destination:
      say "Though you're on the line with [the other party of the player], you can't physically reach to [the destination].";
      deny access.
 
Section 2 - Conversation over the Phone, In General

This portion supplies a simple method of conversation; but we could substitute some completely different conversation system if appropriate. The effect of the telephones is that we are allowed to talk to characters in distant locations under certain circumstances, after which the usual conversation rules apply.

Instead of listening to a telephone when the player reaches someone:
   say "You can hear [the other party of the player] breathing."
 
Before listening to someone when the player cannot touch the noun:
   say "[The noun] is waiting for you to carry on the conversation." instead.
 
A person has a table name called chatter.
 
Before telling someone about something:
   try asking the noun about it instead.
 
Before answering someone that something:
   say "Best to confine your conversation to questions and answers." instead.
 
Before asking someone about something:
   if the topic understood is a topic listed in the chatter of the noun, say "[reply entry][paragraph break]" instead;
   otherwise say "[The noun] does not reply." instead.
 
Section 3 - The Scenario
 
The Guard House is a room. "Here you spend all your nights. Bullet-proof windows offer a panoramic view of serene cliffs, palm trees, and a moonlit ocean. Occasionally someone is foolish enough to try a cliff ascent or even an attack by helicopter, but lately things have been pretty quiet.
 
The mansion is up the hill behind you, security lights ablaze."
 
The grey telephone is a telephone in the Guard House. Understand "6885" as the grey telephone. "Before you is a grey telephone. In black marker someone has written on it: MAIN OFFICE 2802."
 
Before going a direction in the Guard House, say "And leave your post? The boss would have you flayed. No kidding." instead.

In a game where the player could walk around, we would of course want to add a before rule so that he automatically hung up any phone he was using before leaving the room.

The Main Office is a room. The boss is a known woman in the Main Office. A telephone called the red telephone is in the Main Office. Understand "2802" as the red telephone.
 
The Guild is a room. The ninja is an unknown man in the Guild. A telephone called the black telephone is in the Guild. Understand "4431" as the black telephone.
 
Potter's Pizza is a room. The pizza delivery boy is a known man in Pizza. A telephone called the saucy telephone is in Pizza. Understand "8885" as the saucy telephone.
 
The chatter of the boss is the Table of Boss Conversation. The chatter of the delivery boy is the Table of Pizza Conversation. The chatter of the ninja is the Table of Ninja Conversation.
 
After calling the red telephone on something for the first time:
   say "'Yes?' asks the boss. Her voice is especially husky this evening. Maybe that night of passion isn't so far off after all."
 
Table of Boss Conversation

topicreply
"love/passion/tonight/night" or "night of passion""'...Sorry, what?' she asks. 'I wasn't listening.' Oh. Maybe she'd go for some pizza, though."
"pizza""'I'd love some. No pepperoni, though,' she says, sounding dreamy. Yes, this is definitely time for a call to your old friend, the pizza boy."
"imminent ninja attack""'Don't worry about it,' says the boss crisply. 'I have everything under control.'"
 
Table of Pizza Conversation

topicreply
"pizza""'Pepperoni special tonight!' he says proudly."
"pepperoni""'Pepperoni is included free on ALL our pizzas,' he says proudly."
"no pepperoni""'Well, I don't see why you'd want that,' replies the boy sniffily. 'It's free!'"
"jalapeno""'Sorry, we're out of jalapenos this evening. There was a run on them.'"
"sausage""'Sausage, sure, we can do you sausage.'"
"canadian bacon""'There's currently an embargo on Canadian pig products.'"
"cheese""'We use four kinds,' says the boy, then lowers his voice confidentially. 'Actually, two of them are the same. Nobody ever counts. The stringy one, the one that comes in dollops and the orangey one. You know.'"
"pineapple""'We could put pineapple on there, sure,' says the delivery boy, in a tone that lets you know his opinion of people who order fruit-based pizzas."
"pineapple and garlic""'What kind of crazy combination is that?' demands the delivery boy, finally losing all self-control."
"delivery""'Well, I don't know,' says the boy in a worried voice. 'Last time I came there were attack dogs. And ninjas.'"
"massive gratuity""'There's no use in a big tip you don't live to spend,' says the delivery boy quite firmly."
 
Table of Ninja Conversation

topicreply
"imminent attack""'Yes, still on for tonight,' confirms the voice at the other end of the line."
"pizza delivery boy""The voice, in tones of velvet, indicates that it cannot guarantee the safety of any delivery persons whomsoever."
 
Test me with "call 2802 / examine boss / ask boss about night of passion / ask boss about pizza / listen to telephone / call delivery boy on telephone / ask boy about cheese / tell boy about no pepperoni / ask boy about delivery / tell boy about massive gratuity / attack boy".

…and it more or less writes itself from there.

wi 13.6 Making reciprocal relations
rb 9.10 Telephones

253. Alias ★★★

Seven-digit telephone numbers are too long for Inform to handle when compiling to the Z-Machine, but they will work under Glulx. To have this example succeed, make sure that you have selected the Glulx option in your settings menu.

"Alias"

A telephone is a kind of thing. Understand "phone" or "telephone" as a telephone.

A phone number is a kind of value. 999-9999 specifies a phone number.

Now we borrow some techniques from the Understanding chapter to set up dialing actions:

Understand "dial [phone number] on [telephone]" as dialing it on. Understand "dial [phone number] on [something]" as dialing it on.
 
Understand the commands "phone" or "telephone" or "call" as "dial".
 
Understand "call [text]" or "phone [text]" or "dial [text]" or "telephone [text]" as a mistake ("That's not a number you know.").
 
Dialing it on is an action applying to one phone number and one thing.
 
Report dialing it on:
   say "You dial [the phone number understood]."

This much is enough to let us dial telephone numbers and have Inform report that we've done so; it doesn't actually provide a telephone system such that we could reach and converse with other characters (but see the other telephone examples in the recipe book for more on how one might do that).

We'll set up a little political espionage scenario from which our player can make calls:

The Senator's Junior Suite is a room. "The Senator appears, unfortunately, to have very precise habits: little in the room has been moved from its usual place; the trash can is empty; the bed has been remade[if the blue paper is unexamined]. There may in fact be nothing to find here[end if]."
 
The bed is an enterable scenery supporter in the Junior Suite.
 
The player is wearing a housekeeping uniform and a brunette wig. The player carries a telephone called a Nokia.

Borrowing again from the chapter on Understanding, we might arrange things so that the player knows and can call a few standard numbers with such syntax as CALL HOME:

Understand "home" as 555-9200.

And what if we'd like to have the player learn some phone numbers during the game?

A thing can be examined or unexamined. Carry out examining something: now the noun is examined.
 
Understand "Stephen" as 555-2513 when the blue paper is examined.

This will understand CALL STEPHEN once the paper is examined; before that, the player will just get the "That's not a number you know" response that Inform uses for all attempts to call unknown names.

We'd better plant this paper for the player to find:

The blue paper is in the drawer. The description of the blue paper is "It reads: 'Call Stephen - 555-2513'."
 
The drawer is part of the dresser. It is closed and openable. The dresser is in The Senator's Junior Suite. The lamp is on the dresser. The description of the dresser is "The single drawer is [if the drawer is open]open[otherwise]shut[end if]."
 
Test me with "dial 555-9999 / call home on the telephone / phone the president / call stephen / open drawer / read paper / call stephen / put phone in drawer / close drawer / call stephen".

wi 15.2 Numbers and real numbers
rb 9.10 Telephones

🔗

RB §9.11 Clocks and Scientific Instruments

The simplest form of clock is a wrist watch. Here is a choice of analogue or digital:

The player wears a wrist watch. The description of the wrist watch is "It is [the time of day in words]."
 
The player wears a digital watch. The description of the digital watch is "It is [the time of day]."

Better clocks would allow us also to set the time, and to stop and start them: see Tom's Midnight Garden ★.

Scientific instruments provide sharper versions of our own senses. In the case of vision, they allow us to see closer up, or further away. It's a convention of IF that people can normally see only the current location, that is, they cannot see from one location into another. The boundary of the current room is like a horizon, even out of doors (though it's true that there are ways to disguise that with a continuous outdoor landscape). Ginger Beer ★★ provides a telescope able to see into other rooms.

Witnessed 2 ★ provides a meter which measures how close a ghost is to the player.

Examples

180. Witnessed 2 ★

"Witnessed"

The player carries a device called a Trifield Natural EMF Meter. The description of the Meter is "This cost a pretty penny off the internet, but it's worth it: according to the website it has been programmed by PhD physicists to ignore manmade sources of fields and to respond only to paranormal EMF changes.

It also features an optional Tone Alarm, which can be turned on to indicate when readings spike. If the alarm is off, the meter just reads out the magnetic and electric field levels on a scale from 0-100 microteslas, or 0-1000 V/m.

Since both fields are important, you keep the meter set to SUM mode. The meter has its own optional backlighting, so that you can see the reading even if your flashlight is off. Currently it is reading at [meter setting]." A Tone Alarm is part of the Meter. It is a device. The description of the Tone Alarm is "The Tone Alarm will make a noise, if the EMF picks up a spike."

To decide what number is meter setting:

if the meter is switched off, decide on 0;

if a ghost is touchable, decide on 35;

if a ghost is visible, decide on 12;

decide on 0.

After switching on the meter:

say "You turn on the meter. The needle steadies at [meter setting]."

Every turn: if the meter setting is greater than 10 and the Tone Alarm is switched on, say "[The Tone Alarm] shrieks."

Thirtieth Street Station is a room. "A huge, high, rectangular room with coffered ceilings, which looks grand but mostly makes you feel lonely and small. There are long benches in rows down the middle of the room, and an information desk with the train times, and a series of ticket windows, none of which matters very much at the moment."

The benches are an enterable supporter. They are scenery in the Station. The information desk is scenery in the Station. Some ticket windows are scenery in the Station. Instead of examining scenery in the Station: say "You're fairly sure that whatever is going on here has nothing to do with [the noun]." Understand "window" as ticket windows.

The mural is fixed in place in Thirtieth Street. "At the north side of the station is a particularly pointless and empty annex to the main room. It is dominated by a huge relief of sorts, and this is what you remember." Understand "metal" or "relief" or "huge" as the mural. The description of the mural is "It is both stylized and confusing, but you think it might be supposed to represent the various tasks and occupations of Philadelphia's population. The portions closer to the ground look as though they have recently been subjected to a light dusting of talcum powder. No unusual prints are evident."

The wind chimes are fixed in place in Thirtieth Street. "Carefully attached to the wall with a piece of duct tape and a hook is a light-weight set of wind chimes. Someone else has been here before you, it seems." The description is "Several of your friends use wind chimes as a sort of ghost alarm, since ghosts sometimes cause very localized movements of air when there is no natural breeze."

A ghost is a kind of person. The pale figure is a ghost.

At 9:03 AM: move the pale figure to the location; say "You shiver with some sort of presence."

Test me with "turn on alarm / turn on meter / z / z / z / x figure".

wi 11.17 Phrases to decide other things
rb 9.11 Clocks and Scientific Instruments

299. Tom's Midnight Garden ★

Time can also be understood as a token, and the time parsed will be recorded as "the time understood". So therefore, if we wish for clocks which may be set:

"Tom's Midnight Garden"

A clock is a kind of device. A clock has a time called the current time. A clock can be analog or digital. The current time of a clock is usually 9:01 AM. The description of a clock is "It shows the time to be [if analog]about [the current time to the nearest five minutes in words][otherwise][the current time][end if]."

Understand "set [clock] to [time]" as setting it by time. Setting it by time is an action applying to one thing and one time.

Instead of setting a clock to something:

say "[The noun] can be set only to a time of day, such as 8:00 AM, or midnight."

Carry out setting a clock by time:

now the current time of the noun is the time understood.

Report setting a clock by time:

say "You set [the noun] to [time understood]."

Every turn:

repeat with item running through switched on clocks:

now the current time of the item is one minute after the current time of the item.

The Hall is a room. The grandfather clock is a fixed in place analog clock in the Hall. The travel clock is a switched on digital clock in the Hall. When play begins: now the right hand status line is "[time of day]".

Test me with "examine grandfather clock / set it to midnight / switch it on / wait / wait / wait / examine it / set travel clock to 4:12 / examine it".

wi 17.6 Actions applying to kinds of value
rb 9.11 Clocks and Scientific Instruments

365. Ginger Beer ★★

Suppose we want to have a pair of linked lenses so that the player can look into one of them and see things which occur in room containing the other lense.

We begin simply with a bit of environment for the player to wander around:

"Ginger Beer"

The Ginger Beer Factory is a room. "In the center of the room is an enormous pot filled with crushed ginger, which seems to be bubbling slightly on its own. The fumes are overwhelming."

The pot is scenery in the Ginger Beer Factory. The description of the pot is "Cast iron." In the pot is a bubbling brew.

Instead of smelling the Ginger Beer Factory: try smelling the brew.

Instead of smelling the brew, say "You blink back tears."

The Storeroom is south of the Ginger Beer Factory. "The walls here are lined with a prodigious number of small, rounded bottles, each with a screw top and a smiling pirate on the label."

The Clippings Room is west of the Ginger Beer Factory. "A clean room lined with steel tables, for preparing ingredients."

Some steel tables are a supporter in the Clippings Room. They are scenery. The description is "They are roughly the size and height of laboratory worksurfaces."

The quantity of dandelion is on the steel tables. The description is "Horrible common weed."

The wooden box is on the steel tables. It is openable and closed. The description is "A large wooden box with a lid, used for ingredient storage. There is a label on the lid."

The label is part of the box. The description is "BURDOCK: the root beaten with a little salt and laid on the place suddenly easeth the pain thereof, and helpeth those that are bit by a mad dog:... the seed being drunk in wine 40 days together doth wonderfully help the sciatica: the leaves bruised with the white of an egg and applied to any place burnt with fire, taketh out the fire, gives sudden ease and heals it up afterwards.... The root may be preserved with sugar for consumption, stone and the lax."

The quantity of burdock is in the box. The description is "It looks like a kind of thistle."

Some bottles are in the Storeroom. They are scenery. The description is "They are smaller than the average bottle, because more potent." Instead of taking the bottles, say "Take one away and the whole lineup will cascade to the floor."

Now for the lenses themselves:

A lense is a kind of thing.
 
The large end of the telescope is a lense in the Ginger Beer Factory.  "There is a large glass lense propped against the wall, in which are reflected all the contents of the room."  Understand "glass" or "lense" as the large end.
 
The small end of the telescope is a lense in the Storeroom.  "There is a small glass lense sitting on the floor.  Due to some curious effect of the optics, it appears to be giving a view of somewhere else entirely."  Understand "glass" or "lense" as the small end.  The description is "A gleaming lense about the size of a pound coin."

Here is the critical bit, which needs to be somewhat flexible, since the large end of the telescope could in theory be left anywhere in the game (and should still work).

After deciding the scope of the player while the small end is carried by the player:
   let there be the holder of the large end;
   place there in scope.
 
Before searching the small end when the small end is not carried by the player:
   say "(first picking up [the small end] and holding it to your eye)";
   silently try taking the small end.
 
Instead of searching the small end when the player is not carrying the small end:
   say "It's too hard to look through the small end from a distance."
 
Instead of searching the large end,
   say "You see only your own reflection."

We also want to make sure that the player who looks through the small lense does not see the large lense listed among the contents of the other location:

Definition: a thing is recognizable if it is not a lense.
 
Instead of searching the small end:
   let the far side be the holder of the large end of the telescope;
   say "You peer into the little lense and through it see, in [the far side], [the list of recognizable things in the far side]."
 
Test me with "examine lense / south / examine lense / look through lense / north / look through small lense".

And we're done.

wi 18.29 Deciding the scope of something
rb 9.11 Clocks and Scientific Instruments

🔗

RB §9.12 Cameras and Recording Devices

Recording what is going on, for later playing back or examination, is difficult because the range of situations is very complex. Exactly how much information should we store when we make a recording, and will this require problematically large tables? Will it be difficult even to do at all?

The usual approach is to record only basic details of events or situations. In If It Hadn't Been For… ★ the tape recorder preserves only a few different sounds - footsteps, creaking, rustling - rather than capturing exactly the sound of every action taking place in earshot. In Claims Adjustment ★★, we can take up to 36 Polaroid-style photographs, but each is described only by saying what it is a photo of. Thus we can have a photograph of a vase, or even a photograph of a photograph of a vase (because that too is a thing), but not a photograph of a still life in which several items have been gathered together by the player. That would ordinarily require too much storage.

A similar trick, though involving impromptu sculpture rather than photography, can be found in Originals ★. (The artist magically "manifests" these models rather than sculpting the conventional way in order to avoid the nuisance of carrying around raw materials - wax maquettes and so forth - which would clutter up the example.)

Text, of course, can store arbitrary descriptions. Mirror, Mirror ★ provides a perfect visual recorder: it remembers a room description exactly as the player saw it at the time.

Actor's Studio ★★ provides a video camera that records and time stamps all actions performed in its presence while it is set to record.

Examples

273. If It Hadn't Been For... ★

We start out by giving ourselves a capacious recording device:

"If It Hadn't Been For..."

The digital recorder is a device. The description is "A noise-activated recorder, which time-stamps each recording segment. It has space for about 60 short recordings."

Every turn:

if the digital recorder is switched on and the number of blank rows in the Table of Recorded Content is 0, now the recorder is switched off.

Table of Recorded Content

time stamp	sound
a time	some text

with 60 blank rows.

And most of what follows is attaching sounds to various events. (We could have made noises associated with all the actions, but for simplicity we stuck to a few.)

The thing to note here is that the recording happens as part of Carry out, not as part of Report, so sounds will be recorded even when they are the result of non-player action when the player is not even in the room.

Carry out opening something in the presence of the switched on recorder:
   record "A creaking noise, as of something being opened."
 
Carry out someone opening something when the switched on recorder can see the noun:
   record "A creaking noise, as of something being opened."
 
Carry out closing something in the presence of the switched on recorder:
   record "A creaking followed by a slam."
 
Carry out someone closing something in the presence of the switched on recorder:
   record "A creaking followed by a slam."
 
Carry out someone going to a room (called destination) in the presence of the switched on recorder:
   if the destination is the holder of the recorder, record "Footsteps, growing louder.";
   otherwise record "Footsteps, fading out."
 
Carry out going to a room (called destination) in the presence of the switched on recorder:
   if the destination is the holder of the recorder, record "Footsteps, growing louder.";
   otherwise record "Footsteps, fading out."
 
Carry out someone eating something in the presence of the switched on recorder:
   record "Loud uncouth chewing sounds."
 
Carry out eating something in the presence of the switched on recorder:
   record "Distant muffled chewing sounds."
 
To record (noise - some text):
   if the number of blank rows in the Table of Recorded Content is 0, rule succeeds;
   choose a blank row in the Table of Recorded Content;
   now time stamp entry is the time of day;
   now sound entry is noise.
 
Understand "play [something]" as listening.
 
Instead of listening to the recorder:
   if the number of filled rows in the Table of Recorded Content is 0, say "The recorder remains blank." instead;
   repeat through the Table of Recorded Content:
      say "[line break][time stamp entry]: [sound entry]";
   say paragraph break.
 
The Haunted House is a room. The squeaky cupboard is an openable enterable closed fixed in place container in the House. The ghost is a man in the cupboard. The Lawn is outside from the Haunted House.
 
Instead of opening the closed cupboard when the ghost is in the cupboard: say "The cupboard stubbornly refuses to open."
 
Every turn when the player is not in the House:
   if the ghost is in the cupboard:
      try the ghost exiting;
   otherwise if the cupboard is open:
      try the ghost closing the cupboard.
 
Before someone exiting when the person asked is in a closed container (called the trap):
   try the person asked opening the trap.
 
Before someone entering a closed container: try the person asked opening the noun.
 
Before going to the House when the House contains the ghost:
   try the ghost entering the cupboard;
   try the ghost closing the cupboard.
 
The player carries the recorder, chips, and a sandwich. The sandwich is edible. The chips are edible.
 
Carry out someone eating the chips in the presence of the switched on recorder: record "An incredible racket of a packet being opened." Carry out eating the chips in the presence of the switched on recorder: record "An incredible racket of a packet being opened."
 
Test me with "open cupboard / drop recorder / switch it on / eat chips / out / wait / wait / wait / in / switch recorder off / play recorder".

Now we're at liberty to record evidence of the ghost getting out of the cupboard and getting back in, while we ourselves stand about on the lawn.

wi 16.9 Blank rows
rb 9.12 Cameras and Recording Devices

369. Originals ★

We rely here on the understanding-by-relations rules we've already learned, but there is an additional trick: we want to make sure that if the player types "original" or "actual", this word will not be taken to refer to the thing modeled:

"Originals"

A model is a kind of thing. 10 models are in the model-repository.

Appearance relates one thing to various models. The verb to be shown by means the appearance relation.

Indication relates a model (called X) to a thing (called Y) when Y is shown by X and Y is suitable.

Understand "actual" or "original" as "[actual]". Understand "[actual]" as something when the item described is not a model.

Definition: a thing is suitable:

if the player's command includes "[actual]", no;

yes.

Understand "[something related by indication]" as a model.

After printing the name of a model (called target): say " [random thing shown by the target]"

Now our duplication command -- for the sake of simplicity, we'll suppose that in this scenario the player is duplicating objects by magic rather than creating them out of physical materials or supplies:

Understand "duplicate [something]" as duplicating. Duplicating is an action applying to one visible thing.
 
The duplicating action has an object called the selected model.
 
Setting action variables for duplicating:
   let N be a random model in the model-repository;
   now the selected model is N.
 
Check duplicating:
   if the selected model is nothing, say "You're out of power." instead.
 
Carry out duplicating:
   now the noun is shown by the selected model;
   move the selected model to the player.
 
Report duplicating:
   say "You concentrate and manifest [a selected model]."

Now, the challenge is that we want to print the word "actual" before printing the name of an object, but only during disambiguation questions and only when we are not printing the name of the object as part of a model-name! (If we are not careful about the latter point, we will get responses such as "Which do you mean, the model actual deer or the actual deer?" which of course defeats the whole purpose.

The way around this is to remember that activities stack: we're printing the name of the deer while printing the name of a model that involves the deer. So if we set a flag while printing the name of a model, we can control the way the deer's name prints during the transaction. (We could use our …while clause to specify while not printing the name of a model, except that we're already using it for "while asking which do you mean", and these do not stack.) So:

The virtual-context is a truth state that varies. The virtual-context is false.
 
Before printing the name of a model:
   now virtual-context is true.
 
After printing the name of a model:
   now virtual-context is false.
 
Before printing the name of something (called target) while asking which do you mean:
   if the target is not a model and virtual-context is false:
      say "actual ".
 
Forest is a room. It contains a deer and a daisy. The deer is an animal.
 
Test me with "duplicate deer / x model deer / x deer model / drop deer / x deer / actual / x deer / model".

wi 18.31 Asking which do you mean
rb 9.12 Cameras and Recording Devices

416. Mirror, Mirror ★

"Mirror, Mirror"

The Sorcerer's Workshop is a room. "The sorcerer's den is a dusty, whispering place. A grandfather clock with skeletal hands reads [the time of day in words]. The floorboards are stained where that porridge just wouldn't come out."

The Apprentice's Pantry is east of the Workshop. "This is where the aproned apprentice traditionally makes the camomile tea, cleans out the jackdaw cages and furtively examines purloined artefacts."

When play begins: erase the mirror.

The player carries a magic mirror. The magic mirror has a text called the mirror vision.

To erase the mirror: now mirror vision of the mirror is "The mirror is polished clean, and has no impression upon it."

To say current room description: try looking.

To expose the mirror:

say "The mirror shines momentarily with a dazzling light.[paragraph break]";

now mirror vision of the mirror is the substituted form of "The hazy image in the mirror preserves a past sight:[line break][current room description]All is distorted and yet living, as though the past and present are coterminous in the mirror."

Understand "hold up [something preferably held]" or "hold [something preferably held] up" as holding aloft. Holding aloft is an action applying to one carried thing. Report holding aloft: say "You hold [the noun] aloft."

Instead of rubbing the mirror: erase the mirror; try examining the mirror. Instead of holding aloft the mirror: expose the mirror.

The description of the mirror is "[mirror vision of the mirror]".

Test me with "look / examine mirror / hold up mirror / z / look / x mirror / rub mirror / east / hold mirror up / west / x mirror".

wi 20.7 Making new text with text substitutions
rb 9.12 Cameras and Recording Devices

221. Actor's Studio ★★

Here we construct a video camera to track and play back actions:

"The Actor's Studio"

Section 1 - The Video Camera

The video camera is a thing carried by the player.

Table of Videotape

recorded action	time stamp
waiting	9:00 AM

with 25 blank rows.

Mode is a kind of value. The modes are idle, recording, and playing back. The video camera has a mode. The video camera is idle.

Understand "play back" as playing back. Instead of switching on the camera, try tuning the camera to recording. Instead of switching off the camera, try tuning the camera to idle.

The description of the video camera is "It is currently [mode]; its available settings are idle, recording, and playing back."

Understand "set [camera] to [a mode]" as tuning it to. Tuning it to is an action applying to one thing and one mode.

Instead of setting the camera to something:

say "The available settings are idle, recording, and playing back."

Check tuning it to:

if the noun is not the camera, say "Only the video camera can be set to [the mode understood]." instead.

Carry out tuning it to:

now the mode of the noun is the mode understood.

Report tuning it to:

say "You set [the noun] to [mode understood]."

After an actor doing something when the video camera is recording:

if the current action is tuning the video camera to recording, make no decision;

if the number of blank rows in the Table of Videotape is greater than zero:

choose a blank row in the Table of Videotape;

now the recorded action entry is the current action;

now the time stamp entry is the time of day;

otherwise:

now the video camera is idle;

say "The video camera runs out of recording memory and switches off.";

continue the action.

Every turn when the video camera is playing back:

say "On the camera screen, you see [run paragraph on]";

let starting playback be false;

repeat through the Table of Videotape:

if the recorded action entry is not waiting:

now starting playback is true;

say "[line break] -- [if the actor part of the recorded action entry is the player]you [end if][the recorded action entry], time stamped at [time stamp entry]";

blank out the whole row;

if starting playback is false, say "only static.";

otherwise say paragraph break.

Section 2 - The Scenario

The Actor's Studio is a room. Lucas is a man in the Actor's Studio. Persuasion rule: persuasion succeeds.

The Studio contains an edible thing called a croissant.

Test me with "set camera to recording / x lucas / lucas, take inventory / lucas, eat croissant / set camera to playing back / z".

Notice that both Lucas' implied taking action (picking up the croissant) and his eating action are recorded on the same move.

wi 12.20 Stored actions
rb 9.12 Cameras and Recording Devices

322. Claims Adjustment ★★

We start by creating a camera and a photograph object. As usual when we want to have a kind of object that can be dispensed in bulk, we start off with a bunch of identical instances of the object out of play (in this case, kept in an out-of-play container called "film roll"); we can then move them into play and give them characteristics when they're needed.

Each photograph can depict exactly one thing -- we're assuming that the player is not a landscape photographer here -- so we create a relation to indicate what is shown by each photograph. We'll then use that relation to determine how photographs are described, named, and parsed:

"Claims Adjustment"

A photograph is a kind of thing. 36 photographs are in the film roll.

Appearance relates one thing to various photographs. The verb to be shown by means the appearance relation.

The description of a photograph is usually "It shows [a random thing which is shown by the item described]."

Understand "of [something related by reversed appearance]" as a photograph.

This allows the player to refer to any photograph by its subject: useful if we have a large number of them.

Now we create an action to let the player use the camera and generate these photograph objects:

The player carries a cheap instant camera.
 
Understand "photograph [something] with [camera]" as photographing. Understand "photograph [something] with [something preferably held]" as photographing. Photographing is an action applying to one visible thing and one carried thing, requiring light.
 
The photographing action has an object called the selected film.
 
Setting action variables for photographing:
   let N be a random photograph in the film roll;
   now the selected film is N.
 
Check photographing:
   if the second noun is not the camera, say "You need a camera for that purpose." instead.
 
Check photographing:
   if the noun is the camera, say "Sadly impossible." instead.
 
Check photographing:
   if the selected film is nothing, say "You're out of film." instead.
 
Carry out photographing:
   now the noun is shown by the selected film;
   move the selected film to the player.
 
Report photographing:
   say "Your camera instantly spits out [a selected film]."

Now we use two activities from the Activities chapter to describe the photographs to the player more elegantly:

After printing the name of a photograph (called target):
   say " of [a random thing which is shown by the target]".
 
After printing the plural name of a photograph (called target):
   let N be the holder of the target;
   say " of [a list of things which are shown by photographs which are held by N]";
   if the number of things which are shown by photographs which are held by N is greater than one, say " (variously)".

And finally we provide a brief scenario to give the player something to take pictures of:

The Treasure Room is a room. "Despite the fancy name, this is no more than a closet -- albeit a closet with its own special circuit on the house alarm."
 
The Treasure Room contains a small Degas, a Ming vase, and a collection of South African krugerrands. The player is carrying insurance forms, a first-class stamp, and a security envelope.
 
The description of the forms is "Completely filled out in black ink in block letters: now all you need to do is attach photographic evidence of the objects you wish to insure."
 
Test me with "photograph degas / i / photograph degas / i / x photograph of degas / photograph me / x photograph of me / i / photograph vase / photograph camera / photograph collection / g / i / test more".
 
Test more with "x photograph of collection / x photograph of krugerrands / x photograph of collection of south african krugerrands / photograph photograph of degas / x photograph of photograph of degas".

wi 17.16 Understanding things by their relations
rb 9.12 Cameras and Recording Devices

§10.

Gases

§10.

Liquids

§10.

Dispensers and Supplies of Small Objects

§10.

Glass and Other Damage-Prone Substances

§10.

Volume, Height, Weight

§10.

Ropes

§10.

Electricity and Magnetism

§10.

Fire

§10.

Heat

§10.

Magic (Breaking the Laws of Physics)

§10.

Mathematics

🔗

RB §10.1 Gases

Inform normally assumes that everything is solid. It has no built-in support for gases or liquids, because they have so many different behaviours. For instance, is the important thing about gas that it diffuses, or that we breathe it, or that it mixes with other gases to react, or that it sometimes obscures vision? The answer depends on what we are trying to write, and for this reason Inform leaves it up to us.

Gases are easier to deal with than liquids, because they tend to be everywhere in their location at once (unlike a liquid which might form a pool on the floor) and because they diffuse and mix by themselves (rather than being carried around or brought into contact with each other by the player). On the other hand, unlike liquids, gases are compressible: they can be present at low or high pressures, that is, in low or high concentrations.

The simplest approach is the one in Only You… ★★★, where rooms are either filled with smoke or else smoke-free. Smoke gradually fills through the map, obscuring vision: no attempt is made to conserve the total quantity of smoke, as we assume that some fire is churning it out continuously to replace what diffuses away.

Lethal Concentration ★★ and Lethal Concentration 2 ★★★ simulate a gas diffusing through a three-dimensional maze of rooms, and becoming dangerous above certain concentrations. There is just one possible gas, and it is modelled by giving each room a number which represents the concentration (in parts per million). This enables us to conserve the total amount of gas, or to have it released or captured by sources and sinks of given capacity.

This could be extended by giving each room similar concentration levels for other gases, and providing for the diffusion rule to notice when different gases come into contact; or by giving a concentration (and also, for realism, a volume) to each closed container, applying rules for capturing and releasing gases as containers are opened and closed.

Examples

255. Lethal Concentration 1 ★★

"Lethal Concentration"

A concentration is a kind of value. 200.9ppm specifies concentration. 200.9 ppm specifies concentration.

A room has a concentration called current concentration. A room has a concentration called former concentration.

Probability inverse is a number that varies. [This is expressed as an inverse of the actual probability of diffusion from one room to another, to avoid error.] Probability inverse is 20. [That is, any given molecule of gas has a 5% chance of leaving by a given doorway at any given minute. Probability inverse should never drop below 10, the maximum number of exits from the room.]

Every turn:

follow the diffusion rules.

The diffusion rules are a rulebook.

A diffusion rule (this is the gas movement rule):

repeat with space running through rooms:

let sum be 0.0 ppm;

repeat with way running through directions:

let second space be the room way from the space;

if second space is a room:

let difference be the former concentration of the second space minus the former concentration of the space;

increase sum by the difference;

let sum be sum divided by probability inverse;

now current concentration of the space is the former concentration of the space plus the sum.

A technical note: it would be possible to write "repeat with space running through rooms… repeat with second space running through rooms adjacent to the space" instead, but in practice this loops through all the rooms * all the rooms again * all the directions (to determine adjacency). Phrasing the loop this way omits the second multiplier. For a map of 25 rooms, this means that the loop runs 25 times faster than it would otherwise, and of course for a larger map the effect would be even more dramatic.

A diffusion rule (this is the resetting concentration rule):
   repeat with space running through rooms:
      now the former concentration of the space is the current concentration of the space.
 
The last diffusion rule (this is the lethal dosage rule):
   if the current concentration of the location is greater than LC50:
      say "The concentration in the air overpowers you...";
      end the story;
   otherwise:
      if the current concentration of the location is greater than TLV-STEL:
         say "You feel extremely uncomfortable in this environment."
 
Instead of doing something when the current concentration of the location is greater than TLV-STEL:
   if going, continue the action;
   say "You can't work in this environment: your eyes and nose sting and it hurts to breathe."

And, for testing purposes, a square grid of rooms:

Room 1A is west of Room 1B. Room 1B is west of Room 1C. Room 1C is west of Room 1D. Room 1D is west of Room 1E.
 
Room 2A is south of room 1A and west of Room 2B. Room 2B is west of Room 2C and south of Room 1B. Room 2C is west of Room 2D and south of Room 1C. Room 2D is west of Room 2E and south of Room 1D. Room 2E is south of Room 1E.
 
Room 3A is south of room 2A and west of Room 3B. Room 3B is west of Room 3C and south of Room 2B. Room 3C is west of Room 3D and south of Room 2C. Room 3D is west of Room 3E and south of Room 2D. Room 3E is south of Room 2E.
 
Room 4A is south of room 3A and west of Room 4B. Room 4B is west of Room 4C and south of Room 3B. Room 4C is west of Room 4D and south of Room 3C. Room 4D is west of Room 4E and south of Room 3D. Room 4E is south of Room 3E.
 
Room 5A is south of room 4A and west of Room 5B. Room 5B is west of Room 5C and south of Room 4B. Room 5C is west of Room 5D and south of Room 4C. Room 5D is west of Room 5E and south of Room 4D. Room 5E is south of Room 4E.
 
The former concentration of room 3C is 800.0 ppm.

For variety of testing, here is another room set-up, this time with some corridors and walls within; uncommenting it, and commenting out the connected grid, will let us explore what would happen in alternative cases, to prove to ourselves that the model works consistently.

[Room 1A is west of Room 1B. Room 1B is west of Room 1C. Room 1C is west of Room 1D. Room 1D is west of Room 1E.
 
Room 2A is west of Room 2B. Room 2B is west of Room 2C. Room 2C is west of Room 2D. Room 2D is west of Room 2E. Room 2E is south of Room 1E.
 
Room 3A is south of room 2A and west of Room 3B. Room 3B is west of Room 3C. Room 3C is west of Room 3D. Room 3D is west of Room 3E.
 
Room 4A is west of Room 4B. Room 4B is west of Room 4C. Room 4C is west of Room 4D. Room 4D is west of Room 4E. Room 4E is south of Room 3E.
 
Room 5A is south of room 4A and west of Room 5B. Room 5B is west of Room 5C and south of Room 4B. Room 5C is west of Room 5D and south of Room 4C. Room 5D is west of Room 5E and south of Room 4D. Room 5E is south of Room 4E.]

For the sake at least of seeing what's going on in the example, let's also provide the player with the means to view the gas diffusion graphically:

The status grid is a device carried by the player. The status grid is switched on.
 
Every turn:
   try examining the grid.
 
Instead of examining the status grid:
   say "[fixed letter spacing][bar][line break]";
   say "|[state of room 1A]|[state of room 1B]|[state of room 1C]|[state of room 1D]|[state of room 1E]|[line break]";
   say "[bar][line break]";
   say "|[state of room 2A]|[state of room 2B]|[state of room 2C]|[state of room 2D]|[state of room 2E]|[line break]";
   say "[bar][line break]";
   say "|[state of room 3A]|[state of room 3B]|[state of room 3C]|[state of room 3D]|[state of room 3E]|[line break]";
   say "[bar][line break]";
   say "|[state of room 4A]|[state of room 4B]|[state of room 4C]|[state of room 4D]|[state of room 4E]|[line break]";
   say "[bar][line break]";
   say "|[state of room 5A]|[state of room 5B]|[state of room 5C]|[state of room 5D]|[state of room 5E]|[line break]";
   say "[bar][variable letter spacing][line break]".
 
To say bar:
   say "----------------------------------------------".
 
TLV is a concentration that varies. TLV is 30.0ppm. [Long-term exposure maximum, safe for 8 hours a day.]
 
TLV-STEL is a concentration that varies. TLV-STEL is 50.0ppm. [Short-term exposure maximum, safe for fifteen minutes max.]
 
TLV-C is a concentration that varies. TLV-C is 150.0ppm. [Absolute exposure ceiling.]
 
LC50 is a concentration that varies. LC50 is 300.0ppm. [Concentration at which 50 percent of test subjects die of exposure, usually expressed in terms of time and body weight; in our LC50 these are factored in for the player's weight for one minute.]

The values set for these would depend on the type of poisonous gas in question; we'd want to adjust appropriately.

To say state of (space - a room):
   if the space is the location, say bold type;
   if current concentration of space is less than 10.0ppm, say " ";
   if current concentration of space is less than 100.0ppm, say " ";
   say current concentration of space;
   say roman type.

Now, in theory we might also want to account for sources and sinks, items that either inject poisonous gas into the environment or remove it again. For simplicity, we will assume that these contributions can also be calculated in ppm and that the total number of inert and poisonous gas molecules in a room never changes (so if poison gas molecules are added, an equal number of inert molecules are removed). If room pressure were able to change, our model would have to be improved, so let us assume for now that that never happens. We want this sink/source business to calculate before any other portion of the diffusion rulebook, so set it as a first diffusion rule.

A gas source is a kind of thing. A gas source has a concentration called the contribution. The contribution of a gas source is usually 30.0ppm.
 
Room 2B contains a gas source called a spigot. The contribution of the spigot is 50.0ppm. Room 5A contains a gas source.
 
A gas sink is a kind of thing. A gas sink has a concentration called the contribution. The contribution of a gas sink is usually 30.0ppm.
 
Room 5E contains a gas sink called a fan. The contribution of the fan is 80.0ppm.
 
The first diffusion rule (this is the sources and sinks rule):
   follow the sources rule;
   follow the sinks rule.
 
This is the sinks rule:
   repeat with item running through gas sinks:
      let space be the location of the item;
      decrease the former concentration of the space by the contribution of the item;
      if the former concentration of the space is less than 0.0ppm, now the former concentration of the space is 0.0ppm.
 
This is the sources rule:
   repeat with second item running through gas sources:
      let space be the location of the second item;
      increase the former concentration of the space by the contribution of the second item;
      if the former concentration of the space is less than 0.0ppm, now the former concentration of the space is 0.0ppm.
 
Test me with "z / z / z / z / z / z / z / z".

wi 15.8 Units
rb 10.1 Gases

74. Only You... ★★★

Suppose we want to have smoke that spreads from room to room, gradually filling the entire map with a clogging smoke. Having it spread every single turn would make for a pretty rapid diffusion, so we temper this by having it spread only on even-numbered turns, instead. Conveniently, Inform by default already knows about even and odd numbers, so we can write:

"Only You..."

Section 1 - The Procedure

Every turn when the turn count is even:

if every room is smoky, make no decision;

let previously smoky be whether or not the location is smoky;

repeat with area running through smoky rooms:

now every room which is adjacent to the area is smoky;

if previously smoky is false and the location is smoky:

say "[The location] is filling rapidly with smoke."

A room can be smoky or unsmoky.

Some air is a backdrop. Air is everywhere. Instead of doing something other than examining or smelling to air: say "It's just air." Understand "smoke" as the air when the location is smoky.

Instead of examining the air in a smoky room: say "A thick layer of smoke lies just under the ceiling."

Instead of smelling the air in a smoky room: say "Agh, acrid." Instead of smelling a smoky room: try smelling the air.

After looking in a smoky room: say "A thick layer of smoke has gathered under the ceiling."

Section 2 - The Scenario

The Guide Lodge is a room. "A very spacious room capable of containing several hundred girls while they eat, talk, or do crafts. It is constructed in a not-unappealing rustic style, with floor-to-ceiling windows overlooking the lake below, and a fieldstone hearth at the center." The Guide Lodge is smoky.

The Kitchen is north of the Guide Lodge. "Multiple eight-burner ranges, ovens, and a walk-in refrigerator: you know the sort of thing."

The Industrial Pantry is east of the Kitchen. "Awe-inspiring quantities of food line every shelf, from the three-gallon tub of mayonnaise to the 50-pound tub of rice. Perhaps the most astonishing item is a bag of marshmallows big enough to double as a futon."

The player is in the Pantry.

The Hallway is west of the Guide Lodge. The description of the Hallway is "A perpetually-crammed hallway which has to handle the overflow line for the toilets." A singed sign is fixed in place in the Hallway. The description of the sign is "Where the edge of the sign has not been burnt, the legible words are '...Can Prevent Forest Fires'."

The Toilets are north of the Hallway. "Always in full use, at least when the 12-to-15s are here."

The Coat Closet is south of the Hallway. "Muddy boots may not be worn inside the lodge; instead, about 250 pair are piled here, along with their owners' damp parkas and umbrellas."

The Craft Supply Room is west of the Hallway. "A holding-depot for jugs of white glue and popsicle sticks."

Test me with "x smoke / z / z / z / z / x smoke / look".

wi 6.5 Defining adjectives for values
rb 10.1 Gases

257. Lethal Concentration 2 ★★★

This is a slight variation on the previous gas diffusion example: the main difference is that gas preferentially moves towards lower rooms, and will gradually settle in the bottom floor. We do this by calculating the probability of movement separately for each pair of rooms.

"Lethal Concentration"

A concentration is a kind of value. 200.9ppm specifies concentration. 200.9 ppm specifies concentration.

A room has a concentration called current concentration. A room has a concentration called former concentration.

To decide what number is the probability inverse between (space - a room) and (second space - a room):

let guess be 20;

let way be the best route from space to second space;

if way is up, let guess be 50;

if way is down, let guess be 10;

if the guess is less than 10, decide on 10;

decide on guess.

If we wanted, we could introduce other concerns into the calculation here: open and closed doors, windows between rooms, rooms that are outdoors vs. those that are indoors, and so on. The possibilities are numerous, so we will stick with the simple principle that our poison gas sinks.

Every turn:
   follow the diffusion rules.
 
The diffusion rules are a rulebook.
 
A diffusion rule (this is the gas movement rule):
   repeat with space running through rooms:
      let sum be 0.0 ppm;
      repeat with way running through directions:
         let second space be the room way from the space;
         if second space is a room:
            let incoming be the former concentration of the second space divided by the probability inverse between second space and space;
            let outgoing be the former concentration of the space divided by the probability inverse between space and second space;
            let difference be incoming minus outgoing;
            increase sum by the difference;
      now current concentration of the space is the former concentration of the space plus the sum.
 
A diffusion rule (this is the resetting concentration rule):
   repeat with space running through rooms:
      now the former concentration of the space is the current concentration of the space.
 
The last diffusion rule (this is the lethal dosage rule):
   if the current concentration of the location is greater than LC50:
      say "The concentration in the air overpowers you...";
      end the story;
   otherwise:
      if the current concentration of the location is greater than TLV-STEL:
         say "You feel extremely uncomfortable in this environment."
 
Instead of doing something when the current concentration of the location is greater than TLV-STEL:
   if going, continue the action;
   say "You can't work in this environment: your eyes and nose sting and it hurts to breathe."
 
Room 1A is west of Room 1B. Room 1B is west of Room 1C. Room 1C is west of Room 1D. Room 1D is west of Room 1E.
 
Room 2A is west of Room 2B and below room 1A. Room 2B is west of Room 2C and below Room 1B. Room 2C is west of Room 2D and below Room 1C. Room 2D is west of Room 2E and below Room 1D. Room 2E is south of Room 1E and below Room 1E.
 
The former concentration of Room 1C is 800.0 ppm.
 
The status grid is a device carried by the player. The status grid is switched on.

And just for fun, this time we'll make the grid prettier, too; but this will work only on the Z-machine setting, not Glulx.

Every turn:
   try examining the grid.
 
   Instead of examining the status grid:
   say "[unicode box drawings light down and right][top bar][unicode box drawings light down and left][line break]";
   say "[unicode box drawings light vertical]";
   say "[state of room 1A][state of room 1B][state of room 1C][state of room 1D][state of room 1E]   upstairs[line break]";
   say "[unicode box drawings light vertical and right][middle bar][unicode box drawings light vertical and left][line break]";
   say "[unicode box drawings light vertical]";
   say "[state of room 2A][state of room 2B][state of room 2C][state of room 2D][state of room 2E]   downstairs[line break]";
   say "[unicode box drawings light up and right][bottom bar][unicode box drawings light up and left][variable letter spacing][line break]"
 
To say top bar:
   repeat with N running from 1 to 9:
      if the remainder after dividing N by 2 is 0, say "[unicode box drawings light down and horizontal]";
      otherwise say "[unicode box drawings light horizontal]".
 
To say middle bar:
   repeat with N running from 1 to 9:
      if the remainder after dividing N by 2 is 0, say "[unicode box drawings light vertical and horizontal]";
      otherwise say "[unicode box drawings light triple dash horizontal]".
 
To say bottom bar:
   repeat with N running from 1 to 9:
      if the remainder after dividing N by 2 is 0, say "[unicode box drawings light up and horizontal]";
      otherwise say "[unicode box drawings light horizontal]".
 
TLV is a concentration that varies. TLV is 30.0ppm. [Long-term exposure maximum, safe for 8 hours a day.]
 
TLV-STEL is a concentration that varies. TLV-STEL is 50.0ppm. [Short-term exposure maximum, safe for fifteen minutes max.]
 
TLV-C is a concentration that varies. TLV-C is 150.0ppm. [Absolute exposure ceiling.]
 
LC50 is a concentration that varies. LC50 is 300.0ppm. [Concentration at which 50 percent of test subjects die of exposure, usually expressed in terms of time and body weight; in our LC50 these are factored in for the player's weight for one minute.]
 
Include Basic Screen Effects by Emily Short.
 
To say state of (space - a room):
   if the current concentration of space is less than TLV, say blue letters;
   if the current concentration of space is TLV, say blue letters;
   if the current concentration of space is greater than TLV, say green letters;
   if the current concentration of space is greater than TLV-STEL, say yellow letters;
   if the current concentration of space is greater than TLV-C, say red letters;
   say "[unicode square with diagonal crosshatch fill]";
   say default letters;
   say "[unicode box drawings light vertical]".
 
Test me with "z / z / z / z / z / z / z / z".

wi 15.8 Units
rb 10.1 Gases

🔗

RB §10.2 Liquids

Liquids are notoriously difficult to simulate well. A fully thorough approach consumes endless storage and can be very finicky to write and keep realistic. It is essential to decide what aspect of a liquid's behaviour is actually needed in a given story, and to simulate only that. For instance, if we only need a little chemistry, where a player can add (say) water to salt and make a solution, we do not want to fool around with calculating quantities or concentrations: what's important is that "some water" (amount unspecified) combines with "some salt" to produce "some salty water". We should no more calculate precisely here than we would work out where all the furniture is to the nearest inch. Good advice for handling liquids is to simulate the least amount of realism possible, but no less.

Sometimes all we want is a down-in-one drink: we needn't simulate the actual liquid, just the bottle it comes in, and all we need is to handle the "drinking" action. See Beverage Service ★, and also 3 AM ★★★, where carbonated drinks can be shaken - again simulating the vessel, not the liquid.

Some elementary biochemistry in Xylan ★★ is done simply by… well, the point is that two different liquids are represented by single things each, and a chemical reaction simply switches one for the other.

In Frizz ★★★, we allow any container to be filled with water (only) and we simulate what happens to any solid objects also inside: some waterproof, some not. Flotation ★ provides a well (always full of water), with rules to determine whether things dropped into it should sink or float.

Next we move up to quantitative approaches, where we remember not just whether a liquid is present, but how much of it. In its simplest form, we could have a drinking vessel from which we draw in sips, so that it can be full, half-empty or empty: see Thirst ★.

The example with the best compromise between simulation quality and complexity is Lemonade ★★★. Here we provide a kind of container called a "fluid container", not just a single cup, and each such vessel has a given "fluid capacity". Each holds only a single liquid at a time (so no mixtures) and can be empty or full to any level (rounded off to the nearest 0.1 fl oz). We can fill one vessel from another (unless it would make a mixture). But liquids leaving these vessels must be consumed - drunk or poured away without trace: we cannot make pools on the floor, or carry liquids in our cupped hands. There is no object representing "lemonade": there are only fluid containers, but which can be called LEMONADE if that is what they now contain.

Savannah ★★★ is a light elaboration of Lemonade, showing how liquids might be poured on other objects, as for instance to extinguish a fire.

Noisy Cricket ★★★ extends Lemonade ★★★ to allow for mixing, though then the number of different possible mixtures is so large that complexity increases greatly. Lakeside Living ★★★ extends Lemonade ★★★ differently to add a "liquid source" kind, a form of fluid container which has infinite fluid capacity and is scenery - ideal for a lake, river or spring.

Examples

117. Thirst ★

"Thirst"

The player carries a waterskin. The waterskin can be full, partly drained, or empty. The waterskin is full. Understand "water" as the waterskin.

Instead of drinking the waterskin when the waterskin is empty:

say "There is no water left."

Instead of drinking the waterskin: if the waterskin is partly drained, now the waterskin is empty; if the waterskin is full, now the waterskin is partly drained; say "You drink a long draught."

After printing the name of the waterskin: say " ([waterskin condition])"

Campsite is a room. "It is solid night now, and the stars have come out. Unfamiliar stars. On the other side of the valley -- a valley round-bottomed but shallow, like a soup bowl -- burn other campfires, most likely bandits. Their voices do not carry, but the smoke rises and obscures the starlight over that way."

A sleepsack is an enterable container in the Campsite. "Your sleepsack is laid out in a pocket of sandy soil and coarse grass."

The sandy soil, the stars, the distant campfires, and the coarse grass are scenery in the Campsite. Understand "smoke" as the campfires. Instead of listening in the presence of your campfire: say "All you hear are the reassuring snaps and cracks of the sticks in your fire." Understand "campfires" or "fires" as the distant campfires.

Your campfire is scenery in the Campsite. Instead of pushing, pulling, turning, tasting, or touching your campfire, say "You would burn yourself." Understand "fire" as your campfire. The description of your campfire is "A reassuring protection against wild animals and cold."

The description of the stars is "You invent constellations for them. The slingshot. The scroll. The heart (upside down)."

Instead of going nowhere when the player is in Campsite:

say "Now is not the time for wandering, alone in the dark. Better to keep here[if your campfire is visible], by the fire[end if]."

Singing is an action applying to nothing. Understand "sing" as singing.

Instead of singing:

say "You sing, deep and low, a song from home. It is a good night for singing and the song raises your spirits."

Test me with "i / drink water / i / drink water / i".

wi 8.5 Change of properties with values
rb 10.2 Liquids

122. Beverage Service ★

Some kinds of game objects -- food, for instance -- can only sensibly be used once, and should then be destroyed. The EAT command already implements this, but suppose we also had a category of drinkable potions:

"Beverage Service"

A potion is a kind of thing. The sparkly blue potion is a potion carried by the player.

Level 3 is a room.

Instead of drinking a potion (called the drink):

now the drink is nowhere;

say "You quaff [the drink]. It goes down beautifully."

Test me with "drink sparkly / i".

wi 8.10 Removing things from play
rb 10.2 Liquids

402. Flotation ★

Here we want a rulebook to determine whether objects float or sink, so we create an object-based rulebook for the purpose. The more specific rules here, pertaining to corks and to inflated things, will be consulted first; then, as a default, the general flotation rule.

We also want a switch that can turn flotation off at will. The rule about the big switch will be observed before the others because the when… clause makes it more specific than the other rules in the flotation rulebook.

If we wanted, we could also put these rules into a rulebook in an explicit order, overriding Inform's automatic sorting by specificity.

"Flotation"

The Pumping House is a room.

A well is a fixed in place container in the Pumping House.

Instead of examining the well:

say "[if something is in the well]On the surface of the water you can see [a list of things in the well][otherwise]There is nothing on the surface of the water, nor can you see into the depths[end if]."

The well bottom is a container.

The cork, the rubber ring and a lead ingot are in the Pumping House.

A big switch is a fixed in place device in the Pumping House. "A big switch labelled 'MAKE EVERYTHING SINK' is mounted on one wall[if switched on]. It crackles with electricity[otherwise]. It is currently switched off and silent[end if]."

A thing can be inflated or uninflated. A thing is usually uninflated. Before printing the name of an inflated thing: say "inflated ".

The rubber ring is inflated.

The flotation rules are an object-based rulebook.

A flotation rule for the cork: rule succeeds.

A flotation rule for an inflated thing: rule succeeds.

A flotation rule when the big switch is switched on: rule fails.

After inserting something into the well:

follow the flotation rules for the noun;

if the rule succeeded:

say "[The noun] bobs on the surface.";

otherwise:

move the noun to the well bottom;

say "[The noun] sinks out of sight."

A thing can be sinking, rising, or static. A thing is usually static.

Definition: a thing is wet:

if it is in the well, yes;

if it is in the well bottom, yes;

no.

Every turn:

now every thing is static;

repeat with item running through wet things:

follow the flotation rules for the item;

if the rule failed and the item is in the well, now the item is sinking;

if the rule succeeded and the item is in the well bottom, now the item is rising;

now every rising thing is in the well;

now every sinking thing is in the well bottom;

if something is rising, say "[The list of rising things] rise[if the number of rising things is 1]s[end if] to the surface of the well.";

if something is sinking, say "[The list of sinking things] sink[if the number of sinking things is 1]s[end if] out of sight."

And finally a few description rules to make things look prettier:

Rule for writing a paragraph about the well when the well contains something:
   say "The chief feature of the room is a concrete-sided well in which there float[if the number of things in the well is 1]s[end if] [a list of things in the well]."
 
Rule for writing a paragraph about the well:
   say "The chief feature of the room is a concrete-sided well full of water."

As we recall from the chapter on activities, "writing a paragraph about…" is an activity; activities are themselves structured as sets of object-based rulebooks. The activity "writing a paragraph about" uses three object-based rulebooks (before writing…, for writing…, after writing…). We could have made a flotation activity as well, but in general it is overkill to make an activity to make success/failure decisions. For that purpose an object-based rulebook is sufficient.

Test me with "get all / put cork in well / put ring in well / put ingot in well / x well / get cork / get ring / switch switch on / put cork in well / put ring in well / x well / switch switch off / switch switch on".

wi 19.9 Basis of a rulebook
rb 10.2 Liquids

288. Xylan ★★

If we wanted to define a brand new verb that did affect a specific object, we might begin like this:

"Xylan"

Understand "hydrolyze [something]" as hydrolyzing. Hydrolyzing is an action applying to one thing.

Carry out hydrolyzing:

say "[The noun] cannot be hydrolyzed."

Instead of hydrolyzing the xylan:

move the xylose to the holder of the xylan;

now the xylan is nowhere;

say "At once the xylan becomes xylose."

Plant Cell Wall is a room.

There is a xylose sample. The xylan sample is a thing in Plant Cell Wall. The description of the xylan is "A polysaccharide. Totally useless. If only you had some xylose, instead!" The description of the xylose is "Awesome!"

Test me with "x xylan / hydrolyze xylan / x xylose".

Of course, how our players will ever solve this problem is another question (especially if their biology and chemistry are both rusty). When adding entirely new commands to a game, it is often a good idea to provide as many ways of phrasing the command as possible; to drop hints about the correct phrasing within the game's text; or even to tell the player about the expanded command list in some documentation or help at the beginning of the game. So for instance we might also add

Understand "break down [something] with water" or "break [something] down with water" as hydrolyzing.

And these lines will also provide syntax for our new command, without interfering with the previous syntax. It's also good to anticipate alternative (British or American) spellings. People's typing habits are hard to overcome, even if they know you are spelling the word the other way. It is probably best not to annoy them unduly. So:

Understand "hydrolyse [something]" as hydrolyzing.

Then some text in-game might offer a clue, subtle or (since this is an example) blunt:

Instead of examining the player, say "You're a drop of water, which means that you can break down certain chemicals!"
 
Understand "break down [something]" or "break [something] down" as hydrolyzing.

And finally, we could try adding instructions explicitly:

Understand "help" or "hint" or "hints" or "instructions" or "info" or "about" as asking for help. Asking for help is an action out of world. Carry out asking for help: say "The following commands are understood, in addition to the standard ones: EVAPORATE, FREEZE, HYDROLYZE, SUBLIME..."
 
Test more with "help / x me / break down xylan"

…though of course in fact these other commands won't be available until we define them, too.

This last approach, defining all the extra commands up front, is especially useful if these commands are very technical or unusual; if they are needed early in the game, before you've a chance to educate the player; or if they are not suggested by any in-game objects. A player who encounters a tool with an obvious use, such as a hairbrush, will likely think of trying to BRUSH things with it. It's harder to rely on his guessing actions that are both outside the range of usual commands and unrelated to any of the visible props, however.

wi 17.1 Understand
rb 10.2 Liquids

192. Frizz ★★★

Suppose we have some items that get wet in contact with other damp things; in particular, if we touch anything wet while wearing a pair of gloves, the gloves too get damp. This requires that we be systematic about detecting all cases where contact occurs. So:

"Frizz"

A thing can be waterproof or porous. A container is usually waterproof. An animal is usually waterproof.

A thing can be sodden or dry.

A container can be waterfilled or empty.

Before printing the name of a sodden thing: say "sodden ". Understand the sodden property as describing a thing.

The player wears a pair of woolly gloves. Instead of wearing a sodden thing: say "You dubiously contemplate [the noun], and decide it's best to wear dry clothing."

Every turn:

follow the liquid distribution rules.

The liquid distribution rules is a rulebook.

A liquid distribution rule:

repeat with item running through containers:

if the item is open and the item is empty and the item is in a waterfilled container:

now the item is waterfilled;

if the player can see the item, say "[The item] fills up with water, of course.".

A liquid distribution rule:

repeat with item running through things in a waterfilled container:

if the item is porous and the item is dry:

if the player can see the item, say "[The item] soaks through.";

now the item is sodden.

A liquid distribution rule:

repeat with item running through sodden things in the airing cupboard:

if the item is not The Last Man, now the item is dry.

The last liquid distribution rule:

if the player carries a dry copy of The Last Man, end the story finally.

Instead of examining a waterfilled container:

say "[The noun] is full of water[if the noun contains something visible]; it also contains [the list of things in the noun][end if]."

Instead of examining a container:

say "Dry inside[if the noun contains something visible], and containing [a list of things in the noun]."

A book is a kind of thing. Instead of examining a sodden book, say "[The noun] is too soaked to read, thanks to someone's carelessness." Understand "book" as a book.

The copy of The Last Man is a book. The description of The Last Man is "Mary Shelley's very own original copy, loaned to you under the strictest of agreements[if the pond encloses the copy]. How it came to be in its present position is a long story, and not important at the moment: the critical thing is not to blame oneself - who could have anticipated the cricket bat, anyway? - but to fix it immediately, before anything worse occurs[end if]." The The Last Man is in the ziploc bag. The ziploc bag is waterproof and empty. It is openable, transparent, and closed.

The Back Garden is a room. The Back Garden contains a pond. The pond is a waterfilled container. In the pond is the ziploc bag. A carp is in the pond. The carp is an animal. Instead of taking the carp, say "You're not fast enough."

Rule for writing a paragraph about the pond:

if the pond encloses the Last Man:

say "It is a beautiful day just at the end of spring and beginning of summer. The sun shines, the trees blossom, the world conspires in Edenic cheerfulness. You can take in none of it. Your eye is on [the Last Man].";

otherwise:

say "The pond[if something is in the pond] (containing [the list of things in the pond])[end if] remains a figure of menace in an otherwise lushly verdant landscape."

Before printing the name of the Last Man when the Last Man is enclosed by the Pond: if the Last Man is dry, say "delicate, valuable ".

After printing the name of something (called the target) while writing a paragraph about something:

if the Last Man is enclosed by the Pond:

if the target is in something (called the parent), say " - which is in [the parent]".

The Kitchen is west of the Back Garden. "Not in any sense your province: Mrs Peaswell gets agitated if anyone besides herself so much as boils a kettle. In general it is best to sneak through, disturbing as little as possible and preserving the cosy domestic fiction that academics cannot cook.

The nearby stairwell leads up to the second floor."

The Stairwell is above the Kitchen. "Halfway up and halfway down." The airing cupboard is a container in the Stairwell. "An airing cupboard here contains the heating system, and is the ideal place for restoring wet items to a dry state." The airing cupboard is fixed in place.

Now: whenever the player definitely touches something, we want to follow certain rules about the transfer of liquid. These rules need to come after an action's check rules (to make sure the action really occurs) and before the carry out rules (so that nothing has moved or changed yet). So we'll borrow from the chapter on rulebooks to create a whole new stage to the action, occurring between the check and the carry out phases:

The post-check rules are a rulebook.
 
This is the post-check stage rule:
   abide by the post-check rules.
 
The post-check stage rule is listed before the carry out stage rule in the specific action-processing rules.
 
A post-check rule (this is the dry glove rule):
   if we get wet:
      if the player wears the gloves and the gloves are dry:
         now the gloves are sodden;
         say "(soaking your gloves in the process)";
   continue the action.
 
A post-check rule (this is the wet glove rule):
   if the player wears the sodden gloves:
      if the The Last Man must be touched and the Last Man is not sodden:
         say "(soaking the parched pages of The Last Man with the rude touch of your sodden gloves)";
         now the The Last Man is sodden;
      continue the action.
 
Before doing something when the player does not wear the gloves:
   if The Last Man must be touched:
      if The Last Man is dry, say "[The The Last Man] is too precious to endanger when you are not wearing gloves." instead;
      otherwise say "You hesitate instinctively, then recollect that you can hardly harm [The The Last Man] any more than it has already been harmed...".
 
To decide whether we get wet:
   if the noun is not a thing, no;
   if the noun dampens us, yes;
   if the second noun is not a thing, no;
   if the second noun dampens us, yes;
   no.
 
To decide whether (item - a thing) dampens us:
   if the item is not liquiferous, no;
   if item must be touched, yes;
   no.
 
To decide whether (item - a thing) must be touched:
   if the item is the noun and the action requires a touchable noun, yes;
   if the item is the second noun and the action requires a touchable second noun, yes;
   no.
 
Definition: a thing is liquiferous:
   if it is sodden, yes;
   if it is in a waterfilled container, yes;
   no.
 
Test me with "x book / x bag / get bag / take off gloves / w / u / put gloves in cupboard / z / open bag / touch book / push book / turn book / get gloves / wear gloves / get book".
 
Test disaster with "open bag".
 
Test mishandling with "get bag / open bag / get book".

wi 12.7 New actions
rb 10.2 Liquids

193. 3 AM ★★★

"3 AM"

Understand "shake [something preferably held]" as shaking.

Shaking is an action applying to one carried thing.

Carry out shaking:

say "Nothing results of your shaking [the noun]."

Instead of shaking a closed container when something is in the noun:

say "Something rattles inside [the noun]."

Instead of shaking a closed transparent container when something is in the noun:

say "Inside [the noun] there are banging noises produced by [the list of things contained by the noun]."

Instead of shaking an open container which contains something:

say "[The list of things contained by the noun] might fly out."

The Wawa is a room. "A convenience store, if you like to call it that, vending the usual assortment of chips, donuts, soda, and beer. There is something of a line at the sandwich counter."

The box of enrobed cakes is in the Wawa. "A box of Tastykake Enrobed Cakes has fallen off its shelf." The description is "'Enrobed Cakes' is a fancy term for 'strange sponge-like baked good, covered in a thin shell of waxy chocolate'. They are addictive, but not in a way that lets you respect yourself in the morning." The box is a closed openable container. In the box is a cake.

Instead of opening the box, say "The Wawa clerks frown on the consumption of unpurchased foodstuffs."

The can of root beer is a closed openable container carried by the player. The can of root beer is either agitated or calm.

Because the can of root beer should have some reactions to having been shaken later in the game, we need to borrow a few ideas from the chapter on Time:

Instead of shaking the can of root beer:
   the can calms down in five turns from now;
   say "You give the can a good hard shake.";
   now the can is agitated.
 
Instead of listening to the can: say "It sounds [if agitated]fizzy[otherwise]calm[end if]!"
 
At the time when the can calms down:
   now the can is calm.
 
The sticky mess is fixed in place. "There is a sticky mess on the ground."
 
Instead of opening the agitated can of root beer:
   now the can of root beer is nowhere;
   now the sticky mess is in the location;
   say "You open the can and fizzing sweet soda goes absolutely everywhere."
 
Instead of opening the calm can of root beer when the can has been agitated:
   now the can of root beer is nowhere;
   say "The root beer is disappointingly flat. That's what you get for shaking it up!"
 
Test me with "get box / shake box / open box / shake box / listen to can / shake can / listen to can / wait / wait / wait / wait / wait / listen to can / open can".

wi 12.7 New actions
rb 10.2 Liquids

266. Lemonade ★★★

Liquids, and all substances that can be mixed or broken off in partial amounts, pose a challenge to model in interactive fiction. The following example is a simple one, but adequate for many scenarios.

We start by assuming that all liquids in the game will always appear in containers. The player can pour liquids from one container to another, and the containers keep track of how full they are and describe themselves appropriately. The player can also refer to containers by content.

Mixture, however, is not allowed, nor is it possible to put liquids on other objects, pour them out on the ground, etc. These ideas would require a more complicated set-up.

"Lemonade"

A volume is a kind of value. 15.9 fl oz specifies a volume with parts ounces and tenths (optional, preamble optional).

A fluid container is a kind of container. A fluid container has a volume called a fluid capacity. A fluid container has a volume called current volume.

The fluid capacity of a fluid container is usually 12.0 fl oz. The current volume of a fluid container is usually 0.0 fl oz.

Liquid is a kind of value. The liquids are water, milk, lemonade, and iced tea. A fluid container has a liquid.

Instead of examining a fluid container:

if the noun is empty,

say "You catch just a hint of [the liquid of the noun] at the bottom.";

otherwise

say "[The noun] contains [current volume of the noun in rough terms] of [liquid of the noun]."

To say (amount - a volume) in rough terms:

if the amount is less than 0.5 fl oz:

say "a swallow or two";

otherwise if tenths part of amount is greater than 3 and tenths part of amount is less than 7:

let estimate be ounces part of amount;

say "[estimate in words] or [estimate plus 1 in words] fluid ounces";

otherwise:

if tenths part of amount is greater than 6, increase amount by 1.0 fl oz;

say "about [ounces part of amount in words] fluid ounce[s]".

Before printing the name of a fluid container (called the target) while not drinking:

if the target is empty:

say "empty ";

otherwise:

do nothing.

After printing the name of a fluid container (called the target) while not examining:

unless the target is empty:

say " of [liquid of the target]";

omit contents in listing.

Instead of inserting something into a fluid container:

say "[The second noun] has too narrow a mouth to accept anything but liquids."

Definition: a fluid container is empty if the current volume of it is 0.0 fl oz. Definition: a fluid container is full if the current volume of it is the fluid capacity of it.

Understand "drink from [fluid container]" as drinking.

Instead of drinking a fluid container:

if the noun is empty:

say "There is no more [liquid of the noun] within." instead;

otherwise:

decrease the current volume of the noun by 0.2 fl oz;

if the current volume of the noun is less than 0.0 fl oz, now the current volume of the noun is 0.0 fl oz;

say "You take a sip of [the liquid of the noun][if the noun is empty], leaving [the noun] empty[end if]."

We have allowed all liquids to be drunk, but it would be possible also to add checking, if we had a game where some liquids were beverages and others were, say, motor oil.

Understand the command "fill" as something new.
 
Understand "pour [fluid container] in/into/on/onto [fluid container]" as pouring it into. Understand "empty [fluid container] into [fluid container]" as pouring it into. Understand "fill [fluid container] with/from [fluid container]" as pouring it into (with nouns reversed).
 
Understand "pour [something] in/into/on/onto [something]" as pouring it into. Understand "empty [something] into [something]" as pouring it into. Understand "fill [something] with/from [something]" as pouring it into (with nouns reversed).
 
Pouring it into is an action applying to two things.
 
Check pouring it into:
   if the noun is not a fluid container, say "You can't pour [the noun]." instead;
   if the second noun is not a fluid container, say "You can't pour liquids into [the second noun]." instead;
   if the noun is the second noun, say "You can hardly pour [the noun] into itself." instead;
   if the liquid of the noun is not the liquid of the second noun:
      if the second noun is empty, now the liquid of the second noun is the liquid of the noun;
      otherwise say "Mixing [the liquid of the noun] with [the liquid of the second noun] would give unsavory results." instead;
   if the noun is empty, say "No more [liquid of the noun] remains in [the noun]." instead;
   if the second noun is full, say "[The second noun] cannot contain any more than it already holds." instead.
 
Carry out pouring it into:
   let available capacity be the fluid capacity of the second noun minus the current volume of the second noun;
   if the available capacity is greater than the current volume of the noun, now the available capacity is the current volume of the noun;
   increase the current volume of the second noun by available capacity;
   decrease the current volume of the noun by available capacity.
 
Report pouring it into:
   say "[if the noun is empty][The noun] is now empty;[otherwise][The noun] now contains [current volume of the noun in rough terms] of [liquid of the noun]; [end if]";
   say "[the second noun] contains [current volume of the second noun in rough terms] of [liquid of the second noun][if the second noun is full], and is now full[end if]."

This is probably a drier description than we would actually want in our story, but it does allow us to see that the mechanics of the system are working, so we'll stick with this for the example.

Now we need a trick from a later chapter, which allows something to be described in terms of a property it has. This way, the story will understand not only "pitcher" and "glass" but also "pitcher of lemonade" and "glass of milk" -- and, indeed, "glass of lemonade", if we empty the glass and refill it with another substance:

Understand the liquid property as describing a fluid container. Understand "of" as a fluid container.

And now the scenario itself:

The Porch is a room. The porch swing is an enterable supporter in the Porch. "An inviting swing hangs here at the end of the porch, allowing you to enjoy the summer with a cool beverage, and watch your neighbor Ted mowing his lawn with the very last manual powerless lawnmower on the block."
 
The glass is a fluid container carried by the player. The liquid of the glass is milk. The current volume of the glass is 0.8 fl oz.
 
The pitcher is a fluid container in the Porch. The fluid capacity of the pitcher is 32.0 fl oz. The current volume of the pitcher is 20.0 fl oz. The liquid of the pitcher is lemonade.
 
Ted's Lawn is outside from the Porch. Ted is a man in Ted's Lawn. "Ted has taken off his shirt, but still seems a bit oppressed by the sun." The description of Ted is "He looks hot. In all senses."
 
After deciding the scope of the player: place Ted in scope.
 
Instead of doing something to Ted when the player is in the Porch: say "You can't really interact with Ted from this distance, except in the sense of eyeing him surreptitiously."
 
Instead of giving an empty fluid container to Ted: say "Yes, taunt the poor man, why don't you?"
 
Instead of giving a fluid container to Ted when the liquid of the noun is milk: say "Ted looks ruefully at the milk. 'Thanks, but I'm lactose-intolerant,' he says."
 
The block giving rule is not listed in the check giving it to rules.
 
Every turn:
   if Ted is in the location:
      if Ted carries a fluid container (called refreshment):
         try Ted drinking the refreshment;
      otherwise if a random chance of 1 in 3 succeeds:
         say "Ted pushes the ineffective mower over some dandelions."
 
Instead of someone drinking a fluid container:
   if the noun is empty:
      try the person asked giving the noun to the player;
   otherwise:
      decrease the current volume of the noun by 2.0 fl oz;
      if the current volume of the noun is less than 0.0 fl oz, now the current volume of the noun is 0.0 fl oz;
      say "[The person asked] gulps down some [liquid of the noun]."
 
After someone giving something to the player:
   say "'Here,' says [the person asked], handing [the noun] back to you. 'Thanks, I owe you one.'";
   end the story finally.
 
Test me with "x milk / x lemonade / drink lemonade / drink milk / pour lemonade into glass / drink milk / x milk / drink milk / g / i / fill glass with lemonade / drink lemonade / drop glass / drink lemonade / pitcher".
 
Test Ted with "out / give milk to ted / drink milk / g / g / g / give glass to ted / in / fill glass with lemonade / out / give lemonade to ted / wait / z / z / z ".

wi 15.19 Arithmetic with units
rb 10.2 Liquids

267. Savannah ★★★

Here we build very slightly on the existing liquid implementation to add a puzzle where the player puts out a fire with a bucket of water. Most of the liquid implementation remains the same as before, but now we understand the names of containers according to the liquids they contain.

The new material, pertaining to extinguishing fires, is at the bottom in section 2.

"Savannah"

Section 1 - Essentials of Liquid

A volume is a kind of value. 15.9 fl oz specifies a volume with parts ounces and tenths (optional, preamble optional).

A fluid container is a kind of container. A fluid container has a volume called a fluid capacity. A fluid container has a volume called current volume.

The fluid capacity of a fluid container is usually 12.0 fl oz. The current volume of a fluid container is usually 0.0 fl oz.

Liquid is a kind of value. A fluid container has a liquid.

Instead of examining a fluid container:

if the noun is empty,

say "You catch just a hint of [the liquid of the noun] at the bottom.";

otherwise

say "[The noun] contains [current volume of the noun in rough terms] of [liquid of the noun]."

To say (amount - a volume) in rough terms:

if the amount is less than 0.5 fl oz:

say "a swallow or two";

otherwise if tenths part of amount is greater than 3 and tenths part of amount is less than 7:

let estimate be ounces part of amount;

say "[estimate in words] or [estimate plus 1 in words] fluid ounces";

otherwise:

if tenths part of amount is greater than 6, increase amount by 1.0 fl oz;

say "about [ounces part of amount in words] fluid ounce[s]".

Before printing the name of a fluid container (called the target) while not drinking:

if the target is empty:

say "empty ";

otherwise:

do nothing.

After printing the name of a fluid container (called the target) while not examining:

unless the target is empty:

say " of [liquid of the target]";

omit contents in listing.

Instead of inserting something into a fluid container:

say "[The second noun] has too narrow a mouth to accept anything but liquids."

Definition: a fluid container is empty if the current volume of it is 0.0 fl oz. Definition: a fluid container is full if the current volume of it is the fluid capacity of it.

Understand "drink from [fluid container]" as drinking.

Instead of drinking a fluid container:

if the noun is empty:

say "There is no more [liquid of the noun] within." instead;

otherwise:

decrease the current volume of the noun by 0.2 fl oz;

if the current volume of the noun is less than 0.0 fl oz, now the current volume of the noun is 0.0 fl oz;

say "You take a sip of [the liquid of the noun][if the noun is empty], leaving [the noun] empty[end if]."

Understand the command "fill" as something new.

Understand "pour [fluid container] in/into/on/onto [fluid container]" as pouring it into. Understand "empty [fluid container] into [fluid container]" as pouring it into. Understand "fill [fluid container] with/from [fluid container]" as pouring it into (with nouns reversed).

Understand "pour [something] in/into/on/onto [something]" as pouring it into. Understand "empty [something] into [something]" as pouring it into. Understand "fill [something] with/from [something]" as pouring it into (with nouns reversed).

Pouring it into is an action applying to two things.

Check pouring it into:

if the noun is not a fluid container, say "You can't pour [the noun]." instead;

if the second noun is not a fluid container, say "You can't pour liquids into [the second noun]." instead;

if the noun is the second noun, say "You can hardly pour [the noun] into itself." instead;

if the liquid of the noun is not the liquid of the second noun:

if the second noun is empty, now the liquid of the second noun is the liquid of the noun;

otherwise say "Mixing [the liquid of the noun] with [the liquid of the second noun] would give unsavory results." instead;

if the noun is empty, say "No more [liquid of the noun] remains in [the noun]." instead;

if the second noun is full, say "[The second noun] cannot contain any more than it already holds." instead.

Carry out pouring it into:

let available capacity be the fluid capacity of the second noun minus the current volume of the second noun;

if the available capacity is greater than the current volume of the noun, now the available capacity is the current volume of the noun;

increase the current volume of the second noun by available capacity;

decrease the current volume of the noun by available capacity.

Report pouring it into:

say "[if the noun is empty][The noun] is now empty;[otherwise][The noun] now contains [current volume of the noun in rough terms] of [liquid of the noun]; [end if]";

say "[the second noun] contains [current volume of the second noun in rough terms] of [liquid of the second noun][if the second noun is full], and is now full[end if]."

Understand the liquid property as describing a fluid container. Understand "of" as a fluid container.

Section 2 - Putting Out Fires

The Beach is a room. "The Atlantic stretches east to the horizon, though it is at low tide at the moment. It is dawn: time to pack up and go home."

We will skip implementing the Pacific ocean itself, though the example Lakeside Living shows how to incorporate large bodies of water into our liquid simulation.

The liquids are seawater. [We could include others, but for the moment...]
 
Instead of drinking a fluid container when the liquid of the noun is seawater:
   say "Blech!"
 
The bucket is a fluid container carried by the player. The liquid of the bucket is seawater. The current volume of the bucket is 64.0 fl oz.
 
The fire is a fixed in place thing in the beach. "A low fire crackles here, left over from an attempt at s'mores much earlier in the evening."
 
Instead of touching or rubbing or taking the fire, say "You're not such a glutton for punishment."
 
Instead of pouring something into the fire:
   now the fire is nowhere;
   now the current volume of the noun is 0.0 fl oz;
   say "[The second noun] goes out in a great hiss."
 
Test me with "drink seawater / pour seawater on fire / x bucket / i".

This is still a specific implementation: if we wanted to weave liquids together with a full-scale burning model (as in "In Fire or in Flood"), where pretty much any object in the game can be flaming (currently on fire) or damp (extinguished), we might generalize our rule to

Instead of pouring something into a flaming thing:
   now the second noun is damp;
   now the current volume of the noun is 0.0 fl oz;
   say "[The second noun] goes out in a great hiss."

Of course, the merging of fire and liquids also raises the possibility of gasoline and explosives, of heating and boiling liquids, etc.: as always, it's wise to incorporate a simulation that is only as detailed as the game's interactions really justify.

wi 15.19 Arithmetic with units
rb 10.2 Liquids

276. Noisy Cricket ★★★

Our previous experiments into liquid have not dealt with the possibility of mixing components, but that is because for most games, tracking the details of mixture is overkill.

But let's suppose that this time we do want to have mixed liquids; moreover, we want a way to describe the mixtures to the player inventively, so that if he hits specific combinations those combinations are recognized: calling the result a martini, say, rather than just "a mixture of vodka and vermouth".

The implementation that follows relies on a fairly simple idea from linear algebra. Any given liquid can be expressed as a vector in N-space, where N is the number of available ingredients and the length of the vector depends on how much of each ingredient is used; then we find the recipe that best describes the liquid by taking the dot product of our liquid vector with a bunch of sample vectors and selecting the one with the largest result.

If this does not make sense, don't worry: it's not necessary to understand the idea to use the code.

Any implementation involving a large number of place values is always a bit challenging in integer arithmetic. This examples assumes that no bodies of liquid will ever be very large, and that the proportions of ingredients in a mixture will not be vastly askew. (No 20-parts-to-1 proportions, for instance.) This probably works reasonably well for the cocktails that we make the basis of the example.

"Noisy Cricket"

Part 1 - Volumes and Mixtures

A volume is a kind of value. 15.9 fl oz specifies a volume with parts ounces and tenths (optional, preamble optional).

A fluid container is a kind of container. A fluid container has a volume called a fluid capacity. A fluid container has a volume called creme de menthe volume. A fluid container has a volume called vodka volume. A fluid container has a volume called cacao volume.

The fluid capacity of a fluid container is usually 12.0 fl oz. The creme de menthe volume of a fluid container is usually 0.0 fl oz. The vodka volume of a fluid container is usually 0.0 fl oz. The cacao volume of fluid container is usually 0.0 fl oz.

To decide what volume is the current volume of (item - a fluid container):

let total be the creme de menthe volume of the item;

increase total by the vodka volume of the item;

increase total by the cacao volume of the item;

decide on total.

Instead of examining a fluid container:

if the noun is empty,

say "You catch just a hint of [the nominal descriptor of the noun] at the bottom.";

otherwise

say "[The noun] contains [current volume of the noun in rough terms] of [adjectival descriptor of the noun] [nominal descriptor of the noun]."

Adjectival descriptor is a kind of value. The adjectival descriptors are strong, chocolatey, minty, perfect, and pure.

Nominal descriptor is a kind of value. The Nominal descriptors are creme de menthe, vodka, creme de cacao, grasshopper, chocolate vodka, mint vodka, chocolate martini, mintini, chocolate mint martini.

Our table of mixtures is expressed in parts: so if a recipe contains one part X and two parts Y, we would put "1" in the first column and "2" in the second column.

Table of Mixtures

ratingcreme de menthe compvodka compcacao compadjectival descriptornominal descriptor
0.0 fl oz100mintycreme de menthe
0.0 fl oz010chocolateyvodka
0.0 fl oz001chocolateycreme de cacao
0.0 fl oz120chocolateymintini
0.0 fl oz101chocolateygrasshopper
0.0 fl oz021chocolateychocolate martini
0.0 fl oz031chocolateychocolate vodka
0.0 fl oz130chocolateymint vodka
0.0 fl oz121chocolateychocolate mint martini
 
A fluid container has an adjectival descriptor. A fluid container has a nominal descriptor. Understand the adjectival descriptor property as describing a fluid container. Understand the nominal descriptor property as describing a fluid container.
 
To decide what number is (quantity - a number) squared:
   decide on quantity times quantity.
 
To score mixtures in (item - a fluid container):
   repeat through Table of Mixtures:
      let total line parts be creme de menthe comp entry squared;
      let total line parts be total line parts plus vodka comp entry squared;
      let total line parts be total line parts plus cacao comp entry squared;
      let creme de menthe score be creme de menthe comp entry times the creme de menthe volume of item;
      let vodka score be vodka comp entry times the vodka volume of item;
      let cacao score be cacao comp entry times the cacao volume of item;
      let total score be creme de menthe score plus vodka score;
      let total score be total score plus cacao score;
      let total score be total score times calibration for total line parts;
      now rating entry is total score;
      if total line parts is 1, now adjectival descriptor entry is pure;
      otherwise now adjectival descriptor entry is perfect;
      [and for creme de menthe...]
      now creme de menthe comp entry is creme de menthe comp entry plus 1;
      let total line parts be creme de menthe comp entry squared plus vodka comp entry squared;
      let total line parts be total line parts plus cacao comp entry squared;
      let creme de menthe score be creme de menthe comp entry times the creme de menthe volume of item;
      let vodka score be vodka comp entry times the vodka volume of item;
      let cacao score be cacao comp entry times the cacao volume of item;
      let total score be creme de menthe score plus vodka score;
      let total score be total score plus cacao score;
      let total score be total score times calibration for total line parts;
      if total score is greater than rating entry, now adjectival descriptor entry is minty;
      now creme de menthe comp entry is creme de menthe comp entry minus 1;
      [and for vodka...]
      now vodka comp entry is vodka comp entry plus 1;
      let total line parts be creme de menthe comp entry squared plus vodka comp entry squared;
      let total line parts be total line parts plus cacao comp entry squared;
      let creme de menthe score be creme de menthe comp entry times the creme de menthe volume of item;
      let vodka score be vodka comp entry times the vodka volume of item;
      let cacao score be cacao comp entry times the cacao volume of item;
      let total score be creme de menthe score plus vodka score;
      let total score be total score plus cacao score;
      let total score be total score times calibration for total line parts;
      if total score is greater than rating entry, now adjectival descriptor entry is strong;
      now vodka comp entry is vodka comp entry minus 1;
      [and for cacao...]
      now cacao comp entry is cacao comp entry plus 1;
      let total line parts be creme de menthe comp entry squared plus vodka comp entry squared;
      let total line parts be total line parts plus cacao comp entry squared;
      let creme de menthe score be creme de menthe comp entry times the creme de menthe volume of item;
      let vodka score be vodka comp entry times the vodka volume of item;
      let cacao score be cacao comp entry times the cacao volume of item;
      let total score be creme de menthe score plus vodka score;
      let total score be total score plus cacao score;
      let total score be total score times calibration for total line parts;
      if total score is greater than rating entry, now adjectival descriptor entry is chocolatey;
      now cacao comp entry is cacao comp entry minus 1.
 
To identify mixture in (item - a fluid container):
   score mixtures in item;
   sort Table of Mixtures in reverse rating order;
   choose row 1 in Table of Mixtures;
   now nominal descriptor of the item is nominal descriptor entry;
   let sample vodka be vodka comp entry; [Now keep track of all these]
   let sample creme de menthe be creme de menthe comp entry;
   let sample cacao be cacao comp entry;
   if rating entry divided by 100 is the current volume of the item:
      now adjectival descriptor of the item is pure;
   otherwise:
      now adjectival descriptor of the item is adjectival descriptor entry.
 
To decide what number is the raw quantity of (item volume - a volume):
   let raw be item volume divided by 0.5 fl oz;
   decide on raw.
 
To decide what number is calibration for (total - a number):
   if total is an initial listed in the table of Multipliers, decide on result entry;
   decide on 21.

Here we cheat on our arithmetic. The following chart just provides values corresponding roughly to 1/(sqrt (x)), but since Inform does not deal very gracefully with square roots or fractions, we will calculate this elsewhere and just supply the answers in the code:

Table of Multipliers

initialresult
1100
271
357
450
544
641
738
835
933
1031
1130
1229
1328
1427
1526
1625
1724
1824
1923
2022
 
When play begins:
   repeat with item running through fluid containers:
      identify mixture in item.
 
To say (amount - a volume) in rough terms:
   if the amount is less than 0.6 fl oz:
      say "half an ounce or less";
   otherwise if tenths part of amount is greater than 3 and tenths part of amount is less than 7:
      let estimate be ounces part of amount;
      say "[estimate in words] or [estimate plus 1 in words] fluid ounces";
   otherwise:
      if tenths part of amount is greater than 6, increase amount by 1.0 fl oz;
      say "about [ounces part of amount in words] fluid ounce[s]".
 
Before printing the name of a fluid container (called the target) while not drinking or pouring:
   if the target is empty:
      say "empty ";
   otherwise:
      do nothing.
 
After printing the name of a fluid container (called the target) while not examining or pouring:
   unless the target is empty:
      say " of [adjectival descriptor of the target] [nominal descriptor of the target]";
      omit contents in listing.
 
Instead of inserting something into a fluid container:
   say "[The second noun] has too narrow a mouth to accept anything but liquids."
 
Definition: a fluid container is empty if the current volume of it is 0.0 fl oz. Definition: a fluid container is full if the current volume of it is the fluid capacity of it.
 
Understand "drink from [fluid container]" as drinking.
 
Instead of drinking a fluid container:
   if the noun is empty:
      say "There is no more [nominal descriptor of the noun] within." instead;
   otherwise:
      let cacao loss be the consumed cacao of the noun out of sip volume;
      let creme de menthe loss be the consumed creme de menthe of the noun out of sip volume;
      let vodka loss be the consumed vodka of the noun out of sip volume;
      decrease the cacao volume of the noun by the cacao loss;
      decrease the creme de menthe volume of the noun by creme de menthe loss;
      decrease the vodka volume of the noun by vodka loss;
      say "You take a sip of [the nominal descriptor of the noun][if the noun is empty], leaving [the noun] empty[end if].".
 
Sip volume is a volume that varies. Sip volume is 0.5 fl oz.
 
To decide what volume is the consumed cacao of (item - a fluid container) out of (total consumption - a volume):
   let new volume be the cacao volume of the item times 100;
   let percentage be the new volume divided by the current volume of the item;
   let consumed volume be the percentage times total consumption;
   let consumed volume be consumed volume divided by 100;
   if consumed volume is greater than the cacao volume of the item, decide on the cacao volume of the item;
   decide on consumed volume.
 
To decide what volume is the consumed creme de menthe of (item - a fluid container) out of (total consumption - a volume):
   let new volume be the creme de menthe volume of the item times 100;
   let percentage be the new volume divided by the current volume of the item;
   let consumed volume be the percentage times total consumption;
   let consumed volume be consumed volume divided by 100;
   if consumed volume is greater than the creme de menthe volume of the item, decide on the creme de menthe volume of the item;
   decide on consumed volume.
 
To decide what volume is the consumed vodka of (item - a fluid container) out of (total consumption - a volume):
   let new volume be the vodka volume of the item times 100;
   let percentage be the new volume divided by the current volume of the item;
   let consumed volume be the percentage times total consumption;
   let consumed volume be consumed volume divided by 100;
   if consumed volume is greater than the vodka volume of the item, decide on the vodka volume of the item;
   decide on consumed volume.
 
Part 2 - Filling
 
Understand the command "fill" as something new.
 
Understand "fill [something] with/from [something]" as filling it with.
 
Filling it with is an action applying to two things. Carry out filling it with: try pouring the second noun into the noun instead.
 
Understand "pour [fluid container] in/into/on/onto [fluid container]" as pouring it into. Understand "empty [fluid container] into [fluid container]" as pouring it into.
 
Understand "pour [something] in/into/on/onto [something]" as pouring it into. Understand "empty [something] into [something]" as pouring it into.
 
Pouring it into is an action applying to two things.
 
Check pouring it into:
   if the noun is not a fluid container, say "You can't pour [the noun]." instead;
   if the second noun is not a fluid container, say "You can't pour liquids into [the second noun]." instead;
   if the noun is the second noun, say "You can hardly pour [the noun] into itself." instead;
   if the noun is empty, say "No more [nominal descriptor of the noun] remains in [the noun]." instead;
   if the second noun is full, say "[The second noun] cannot contain any more than it already holds." instead.
 
Carry out pouring it into:
   let available capacity be the fluid capacity of the second noun minus the current volume of the second noun;
   if the available capacity is greater than the current volume of the noun, now the available capacity is the current volume of the noun;
   let cacao loss be the consumed cacao of the noun out of available capacity;
   let creme de menthe loss be the consumed creme de menthe of the noun out of available capacity;
   let vodka loss be the consumed vodka of the noun out of available capacity;
   decrease the cacao volume of the noun by the cacao loss;
   decrease the creme de menthe volume of the noun by creme de menthe loss;
   decrease the vodka volume of the noun by vodka loss;
   increase the cacao volume of the second noun by the cacao loss;
   increase the creme de menthe volume of the second noun by creme de menthe loss;
   increase the vodka volume of the second noun by vodka loss.
 
Report pouring it into:
   identify mixture in noun;
   identify mixture in second noun;
   say "[if the noun is empty][The noun] is now empty; [otherwise][The noun] now contains [current volume of the noun in rough terms] of [nominal descriptor of the noun]; [end if]";
   say "[the second noun] contains [current volume of the second noun in rough terms] of [adjectival descriptor of the second noun] [nominal descriptor of the second noun][if the second noun is full], and is now full[end if]."
 
Understand "of" as a fluid container.
 
Part 3 - Scenario
 
When play begins: say "When you decided to try Mixology WS102 (*cross-listed with Women's Studies), you envisioned yourself writing essays about gender discrimination during the Prohibition, say, or reading essays on male vs. female metabolism of alcohol. But no: MxWS102 turns out to be about... mixing the perfect chocolate mint martini."
 
The College of Mixology is a room. The bar is a supporter in the college.
 
The cocktail glass is a fluid container carried by the player. The fluid capacity of the cocktail glass is 4.0 fl oz.
 
The flask is a fluid container carried by the player. The vodka volume of the flask is 4.0 fl oz.
 
The jigger is a fluid container carried by the player. The fluid capacity of the jigger is 1.0 fl oz.
 
The small measure is a fluid container carried by the player. The fluid capacity of the small measure is 0.5 fl oz.
 
The decanter is a fluid container on the bar. The fluid capacity of the decanter is 32.0 fl oz. The creme de menthe volume of the decanter is 20.0 fl oz.
 
The bottle is a fluid container carried by the player. The cacao volume of the bottle is 10.0 fl oz.
 
Test me with "i / pour flask in jigger / pour jigger in glass / pour bottle in jigger / pour jigger in glass / pour bottle in jigger / pour jigger in glass / pour decanter in jigger / pour jigger in glass / drink glass / g / g / x glass / pour flask in glass".

wi 16.12 Listed in...
rb 10.2 Liquids

333. Lakeside Living ★★★

Much of what follows is identical to "Lemonade" earlier; the new material begins at Part 2.

"Lakeside Living"

A volume is a kind of value. 15.9 fl oz specifies a volume with parts ounces and tenths (optional, preamble optional).

A fluid container is a kind of container. A fluid container has a volume called a fluid capacity. A fluid container has a volume called current volume.

The fluid capacity of a fluid container is usually 12.0 fl oz. The current volume of a fluid container is usually 0.0 fl oz.

Liquid is a kind of value. The liquids are water, absinthe, and iced tea. A fluid container has a liquid.

Instead of examining a fluid container:

if the noun is empty,

say "You catch just a hint of [the liquid of the noun] at the bottom.";

otherwise

say "[The noun] contains [current volume of the noun in rough terms] of [liquid of the noun]."

To say (amount - a volume) in rough terms:

if the amount is less than 0.5 fl oz:

say "a swallow or two";

otherwise if tenths part of amount is greater than 3 and tenths part of amount is less than 7:

let estimate be ounces part of amount;

say "[estimate in words] or [estimate plus 1 in words] fluid ounces";

otherwise:

if tenths part of amount is greater than 6, increase amount by 1.0 fl oz;

say "about [ounces part of amount in words] fluid ounce[s]".

Before printing the name of a fluid container (called the target) while not drinking or pouring:

if the target is empty:

say "empty ";

otherwise:

do nothing.

After printing the name of a fluid container (called the target) while not examining or pouring:

unless the target is empty:

say " of [liquid of the target]";

omit contents in listing.

Instead of inserting something into a fluid container:

say "[The second noun] has too narrow a mouth to accept anything but liquids."

Definition: a fluid container is empty if the current volume of it is 0.0 fl oz. Definition: a fluid container is full if the current volume of it is the fluid capacity of it.

Understand "drink from [fluid container]" as drinking.

Instead of drinking a fluid container:

if the noun is empty:

say "There is no more [liquid of the noun] within." instead;

otherwise:

decrease the current volume of the noun by 0.2 fl oz;

if the current volume of the noun is less than 0.0 fl oz, now the current volume of the noun is 0.0 fl oz;

say "You take a sip of [the liquid of the noun][if the noun is empty], leaving [the noun] empty[end if]."

Part 2 - Filling

Understand the command "fill" as something new.

Here we want Inform to prefer full liquid sources to other containers when it chooses an end to a player's unfinished or ambiguous command. And so:

Understand "fill [fluid container] with/from [full liquid source]" as filling it with. Understand "fill [fluid container] with/from [fluid container]" as filling it with.

Both grammar lines point to the same ultimate outcome; the purpose of specifying both is to tell Inform to check thoroughly for full liquid sources before falling back on other fluid containers when making its decisions.

Understand "fill [something] with/from [something]" as filling it with.
 
Filling it with is an action applying to two things. Carry out filling it with: try pouring the second noun into the noun instead.
 
Understand "pour [fluid container] in/into/on/onto [fluid container]" as pouring it into. Understand "empty [fluid container] into [fluid container]" as pouring it into.
 
Understand "pour [something] in/into/on/onto [something]" as pouring it into. Understand "empty [something] into [something]" as pouring it into.
 
Pouring it into is an action applying to two things.
 
Check pouring it into:
   if the noun is not a fluid container, say "You can't pour [the noun]." instead;
   if the second noun is not a fluid container, say "You can't pour liquids into [the second noun]." instead;
   if the noun is the second noun, say "You can hardly pour [the noun] into itself." instead;
   if the liquid of the noun is not the liquid of the second noun:
      if the second noun is empty, now the liquid of the second noun is the liquid of the noun;
      otherwise say "Mixing [the liquid of the noun] with [the liquid of the second noun] would give unsavory results." instead;
   if the noun is empty, say "No more [liquid of the noun] remains in [the noun]." instead;
   if the second noun is full, say "[The second noun] cannot contain any more than it already holds." instead.
 
Carry out pouring it into:
   let available capacity be the fluid capacity of the second noun minus the current volume of the second noun;
   if the available capacity is greater than the current volume of the noun, now the available capacity is the current volume of the noun;
   increase the current volume of the second noun by available capacity;
   decrease the current volume of the noun by available capacity.
 
Report pouring it into:
   say "[if the noun is empty][The noun] is now empty;[otherwise][The noun] now contains [current volume of the noun in rough terms] of [liquid of the noun]; [end if]";
   say "[the second noun] contains [current volume of the second noun in rough terms] of [liquid of the second noun][if the second noun is full], and is now full[end if]."
 
Understand the liquid property as describing a fluid container. Understand "of" as a fluid container.

And now we add our liquid source kind, which will represent lakes, absinthe fountains, and any other infinite supplies of liquid we might need. Note that 3276.7 is the largest possible number of fluid ounces available to us.

A liquid source is a kind of fluid container. A liquid source has a liquid. A liquid source is usually scenery. The fluid capacity of a liquid source is usually 3276.7 fl oz. The current volume of a liquid source is usually 3276.7 fl oz. Instead of examining a liquid source: say "[The noun] is full of [liquid of the noun]."
 
Carry out pouring a liquid source into something: now the current volume of the noun is 3276.7 fl oz.

We want filling things from liquid sources to work the same way as usual, with the distinction that a) the liquid source never depletes in quantity (hence the carry-out rule resetting its fullness); and b) we should report the results a bit differently as well:

After pouring a liquid source into a fluid container:
   say "You fill [the second noun] up with [liquid of the noun] from [the noun]."

On the other hand, pouring liquids into a liquid source needs to work completely differently from pouring liquids into anything else. Let's say we're going to allow any liquid at all to be dumped into rivers and streams (environmental protections evidently are not very well-enforced in this scenario):

Instead of pouring a fluid container into a liquid source:
   if the noun is empty, say "[The noun] is already empty." instead;
   now the current volume of the noun is 0.0 fl oz;
   say "You dump out [the noun] into [the second noun]."

A couple of minor refinements:

Swimming is an action applying to nothing. Understand "swim" or "dive" as swimming.
 
Instead of swimming in the presence of a liquid source:
   say "You don't feel like a dip just now."
 
Before inserting something into a liquid source: say "[The noun] would get lost and never be seen again." instead.
 
Part 3 - Scenario
 
The Lakeside is a room. The Lakeside swing is an enterable supporter in the Lakeside. "Here you are by the lake, enjoying a summery view."
 
The glass is a fluid container carried by the player. The liquid of the glass is absinthe. The current volume of the glass is 0.8 fl oz.
 
The pitcher is a fluid container in the Lakeside. The fluid capacity of the pitcher is 32.0 fl oz. The current volume of the pitcher is 20.0 fl oz. The liquid of the pitcher is absinthe.
 
The lake is a liquid source. It is in the Lakeside.
 
The player wears a bathing outfit. The description of the bathing outfit is "Stylishly striped in blue and white, and daringly cut to reveal almost all of your calves, and quite a bit of upper arm, as well. You had a moral struggle, purchasing it; but mercifully the lakeshore is sufficiently secluded that no one can see you in this immodest apparel."
 
Instead of taking off the outfit: say "What odd ideas come into your head sometimes!"
 
Test me with "fill glass / empty absinthe into lake / fill glass / swim / drink lake / drink / x water / x lake".

wi 17.22 Precedence
rb 10.2 Liquids

🔗

RB §10.3 Dispensers and Supplies of Small Objects

A slightly tricky situation arises in IF when we want to offer the player a simulation of a near-infinite supply of something: a napkin dispenser from which he can keep taking more napkins, or an infinite selection of pebbles on a beach, or something of that nature.

One approach is simply to limit the number of items the player is allowed to pick up at a time, while maintaining the fiction that there are more of these items in existence than the player is allowed to interact with. Extra Supplies ★★ demonstrates this.

The task becomes harder if we do want to let the player have as many napkins as he wants. In some languages, it is possible to generate new objects on the fly after the story has begun (called "dynamic object creation"), and something like this is possible if we are compiling for Glulx. (See the Inform extensions site for examples.) Usually, though, it is less complicated and almost as effective simply to have a very large supply of existing objects, which are moved in and out of play as the player needs them. Pizza Prince ★ demonstrates how to do this with slices of pizza.

Examples

378. Pizza Prince ★

Suppose we want the player to have a pizza buffet from which he can take a number of slices. But we don't want to actually put the slices there in front of him, because "you can see 17 slices of pizza here" is not the descriptive effect we want, and because we want to pretend, at least, that the pizza supply is nearly infinite. In fact, we're going to replenish the supply by allowing eaten slices to return to the buffet table (safer in IF than in real life).

To do this, we create one object to stand in for the pizza supply, but whenever the player tries to take it, we give him a different "pizza slice" object instead. Thus:

"Pizza Prince"

The Pizza Prince is a room.

The buffet table is a supporter in Pizza Prince.

The pizza selection is a thing on the buffet table. Understand "slice" as the pizza selection. The description is "They are all cheese-only, and all luke-warm."

Rule for writing a paragraph about the buffet table:

say "On [the buffet table] is [a pizza selection]. [description of the pizza selection][line break]".

Now we introduce our actual pizza slices, which are retained in a container out of play until they're needed:

A pizza slice is a kind of thing. 10 pizza slices are in Pizza Limbo. A pizza slice is always edible. [After a fashion, anyway.]

In this example we've set that supply to be artificially small, to make it easier to test what happens when the player reaches the limit; but we could provide many more slices to start with in Pizza Limbo, and the aim in practice would be to pick a number high enough (such as 50 or 100) that the average player will get bored of TAKE PIZZA long before he reaches the limit.

The main thing to be aware of is that objects consume memory in the game file, so creating a large number of pizza slices might bulk the game out. This is more of a concern if we're compiling for the Z-machine than if we're compiling for Glulx.

Whenever the player tries to take the selection, we want him to wind up holding an individual slice instead; but of course we need to check and make sure that he hasn't exhausted the pizza slice supply.

Instead of taking the pizza selection:
   let chosen slice be a random pizza slice in Pizza Limbo;
   if chosen slice is nothing: [That is, there were no slices remaining]
      say "[manager refusal]";
   otherwise:
      move the chosen slice to the player;
      say "Taken (gingerly)."
 
To say manager refusal:
   say "[one of]'Hey!' barks a hitherto-unseen manager from behind you. 'It's an 'all you can eat' buffet, not an 'all you can stuff down your pants' buffet.'[or]You are conscious of a disapproving huff from the manager, so you refrain.[stopping]"

That's fine for the case where the player is taking a new slice of pizza explicitly, but we need to handle it a little differently if the taking action is generated in response to EAT PIZZA. In that case, we need to take the slice and also change the identity of the noun, because after the implicit take action happens, the game will test whether the player is holding the noun before attempting to eat it. So we need to refocus its attention:

Rule for implicitly taking the pizza selection:
   let chosen slice be a random pizza slice in Pizza Limbo;
   if chosen slice is nothing: [That is, there were no slices remaining]
      say "[manager refusal]";
   otherwise:
      move the chosen slice to the player;
      say "(helping yourself from the selection)";
      now the noun is the chosen slice.

And finally, a bit of touch-up:

Rule for clarifying the parser's choice of the pizza selection while taking:
   say "(from the magnificent selection before you)[line break]"

For tidiness, we should probably also return the consumed pizza slices to Pizza Limbo so that they can be re-used later:

After eating a pizza slice:
   move the noun to Pizza Limbo;
   continue the action.
 
Test me with "i / get pizza / g / i / get pizza / drop pizza / look / get pizza / g / look / eat pizza / g / g / g / g / get pizza / g / g / g / g / g / g / g / g / g / g / g / g / i / eat pizza / take pizza / g".

wi 18.34 Implicitly taking something
rb 10.3 Dispensers and Supplies of Small Objects

124. Extra Supplies ★★

Suppose we have a supply closet in our game from which the player is allowed to take red pens. To keep modeling simple, we only allow him to have one in play at a time, and we test this by seeing whether the red pen is "off-stage" before moving it to his possession.

This approach might seem no different from having a single red pen sitting in the closet, but it may be preferable, for two reasons. First, it's not very plausible for a supply closet to contain nothing but a single red pen (well, assuming a well-regulated supplier, anyway); and second, it gives the player a way to get a new red pen should the original be destroyed in a tragic handwriting accident.

"Extra Supplies"

The Supply Closet is a room. A supply of red pens is in the Supply Closet. Understand "pen" as the supply of red pens when the red pen is not visible.

There is a red pen.

Instead of taking the supply of red pens:

if the red pen is off-stage:

move the red pen to the player;

say "You help yourself to a fresh red pen.";

otherwise:

say "You're only allowed one pen at a time. The department secretary is very strict."

South of the Supply Closet is the Furnace Room. The incinerator is a thing in the Furnace Room. It is a container. "The incinerator is here, working full blast."

After inserting something into the incinerator:

now the noun is nowhere;

say "A fiery blast consumes [the noun]!"

Test me with "get pen / i / get pen / get supply / s / put pen in incinerator / n / get pen".

wi 8.10 Removing things from play
rb 10.3 Dispensers and Supplies of Small Objects

🔗

RB §10.4 Glass and Other Damage-Prone Substances

Just as Inform normally assumes everything is solid, it also assumes that these solid objects will not buckle, crack, break or deform under pressure, and cannot be fragmented. But breakability adds realism, and breakage need not be negative: sometimes we want the player to break her way in to something.

In IF the word DROP is more often used to mean "put down" or "leave behind" than "let go from a height": so it is perhaps unfair that in Ming Vase ★ something fragile, when dropped, shatters (into nothing). In Spring Cleaning ★, fragile objects must be explicitly attacked by the player in order to break, and although they leave no tangible debris behind, their loss is at least remembered. Kyoto ★★ provides a general-purpose model for things being thrown at other things, with consequences including things moving (even between rooms) as well as breaking each other.

Debris from breakages is to be avoided if possible because it means keeping track of increasing numbers of objects. But we can increase realism by allowing something to have a visibly "broken" state, which it changes to when it breaks, rather than simply vanishing. Terracottissima ★★ provides for broken and unbroken flowerpots in this way.

Since "part of" allows us to have two objects joined together into what the player sees as one, it also gives us a natural seam which allows the whole to be broken back down into its component parts, and this is the neatest way of providing a breakage into pieces. Paddington ★★ demonstrates a cutting action which allows component parts to be cut away from their holders but will only make small surface gashes in any individual thing: so the player can cut something up, but only into the pieces we specifically choose to allow. Cutting also forces an opening into containers.

Examples

97. Ming Vase ★

In emulation of a certain annoying aspect of the original Adventure, in which there is a Ming vase that cannot safely be dropped:

"Ming Vase"

A thing can be strong or fragile. A thing is usually strong.

Instead of attacking or dropping a fragile thing:

now the noun is nowhere;

say "[The noun] breaks into thousands of pieces!"

The Cave is a room. The Ming vase is carried by the player. The vase is fragile.

We could also implement an additional refinement from Adventure, that a fragile thing is safe if dropped when there is a cushion nearby.

The pillow is a portable supporter. It is carried by the player.
 
Instead of dropping a fragile thing when the pillow is in the location: try putting the noun on the pillow instead.
 
After putting a fragile thing on the pillow:
   say "You set [the noun] down gently on the pillow."
 
Test me with "drop pillow / drop vase / get vase / get pillow / drop vase".

In this rule, the pillow is the second noun; if we had a general rule about setting fragile things on soft things, we could say "You set [the noun] down gently on [the second noun]." for the same effect.

If we wanted to be more refined, we would provide extra code so that breaking a container or a supporter would leave behind their contents. We will see how to do that later.

wi 7.10 The noun and the second noun
rb 10.4 Glass and Other Damage-Prone Substances

123. Spring Cleaning ★

Here we have a destruction action that allows the player to break any fragile items. Once destroyed, these things are removed from play, but we can still refer to them: they are now off-stage. This makes it easy for our sulking character to list the ones that have been destroyed:

"Spring Cleaning"

A thing can be tough or fragile. A thing is usually tough.

Instead of attacking something fragile:

say "You smash [the noun] to smithereens!";

now the noun is nowhere.

A knick-knack is a kind of thing which is fragile.

Every turn when a knick-knack is off-stage and Granny Blue can see the player:

say "'Ohh,' whimpers Granny to herself softly. 'How I will miss [the list of off-stage knick-knacks]!'"

The Parlor is a room. Granny Blue is a woman in the Parlor. A china lamb, a porcelain milkmaid, a frolicking Dutch cow, and a crystal unicorn are knick-knacks in the Parlor.

Test me with "break lamb / break milkmaid / break cow / break unicorn".

wi 8.10 Removing things from play
rb 10.4 Glass and Other Damage-Prone Substances

195. Paddington ★★

Suppose we intend a game in which the player needs to cut things open on a regular basis. We'll want to check whether he has the proper tools handy, and deal graciously with commands such as CUT [something] when no tool is specified. So:

"Paddington"

A blade is a kind of thing.

Understand "cut [something] with [something]" as cutting it with.

Instead of cutting something:

if a blade (called the edge) is held by the player,

try cutting the noun with the edge;

otherwise say "Your fingernails are not sharp enough."

Cutting it with is an action applying to two things.

Check cutting it with:

if the noun is a person, say "That would hurt." instead;

if the second noun is not a blade, say "[The second noun] has not got enough of a blade." instead.

Carry out cutting it with:

increment the count of rips of the noun.

Report cutting it with:

say "You slash [the noun] with [the second noun]."

We'll need a way to account for all these cuts and rips.

Definition: a thing is ripped if the count of rips of it > 0.  A thing has a number called the count of rips. After examining something ripped, say "You see [the count of rips of the noun in words] rip[s] in [the noun][if something is in the noun], revealing [a list of things in the noun][end if]."

Moreover, because open containers normally list their contents when examined but we'd prefer Paddington's to be mentioned in the ripping paragraph:

The examine containers rule does nothing when examining the teddy bear.

So far, so good. But suppose that we'd like cutting also to make containers be permanently open and impossible to close again. We could write an "instead" rule, but that would mean that only our instead instructions would take effect, overriding the normal cutting it with rules entirely. Better would be to add a second carry out rule:

Carry out cutting a container with something:
   now the noun is open;
   now the noun is unopenable.

Now our rule will occur whenever a container is cut, but play will still go on to the reporting stage. And indeed we can add more of these, of varying degrees of specificity:

Carry out cutting something which is part of something with something:
   move the noun to the player.
 
Carry out cutting the quilt with something:
   now the description of the quilt is "Horribly tattered."

For that matter, we might want to add a report rule as well, to occur after the "You slash…" rule, so that every time the player cuts something open which has contents, the contents will be listed.

Report cutting it with:
   if the noun is open and the noun contains something,
      say "Visible within [is-are a list of things in the noun]."

This time we do not add the condition to the rule (i.e., Report cutting an open noun…) If we did, this report rule would be more specific than the general report rule, and would occur first.

The Safehouse is a room.
 
The teddy bear is a closed thing in the Safehouse. The description is "Fluffy[if the head is part of the bear], with an outsized head[otherwise], but headless[end if]." The head is a closed part of the teddy bear. In the bear is a large wad of stuffing. In the head are a small wad of stuffing and a packet of smuggled diamonds.
 
The quilt is in the Safehouse. The description is "An old but comforting quilt."
 
The player carries a blade called a switchblade.

Here is a final nicety to get rid of the "which is closed" statement on our closed unopenable teddy bear, using an "activity" rule:

After printing the name of a closed unopenable container:
   omit contents in listing.
 
Test me with "cut quilt with bear / cut quilt with switchblade / examine quilt / cut bear with switchblade / again / examine bear / cut head with switchblade / get diamonds / mourn loss of innocence".

wi 12.9 Check, carry out, report
rb 10.4 Glass and Other Damage-Prone Substances

314. Terracottissima ★★

This easiest way to do this uses the "printing the name of" activity, which will come up in the following chapter:

"Terracottissima"

A flowerpot is a kind of thing. Understand "pot" as a flowerpot.

A flowerpot can be unbroken or broken. After dropping an unbroken flowerpot: say "Crack!"; now the noun is broken. Understand the broken property as describing a flowerpot.

Before printing the name of a broken flowerpot, say "broken ". Before printing the name of an unbroken flowerpot: if a flowerpot is broken, say "unbroken ".

Before printing the plural name of a broken flowerpot, say "broken ". Before printing the plural name of an unbroken flowerpot: if a flowerpot is broken, say "unbroken ".

The Herb Garden is a room. In the Herb Garden are ten unbroken flowerpots.

Test me with "get three flowerpots / drop all / look".

wi 17.15 Understanding things by their properties
rb 10.4 Glass and Other Damage-Prone Substances

403. Kyoto ★★

Suppose we want to expand the function of the existing THROW SOMETHING AT command so that a thrown object actually does make contact most of the time. A glance at the Actions index tells us that the Throwing it at rulebook currently looks like this:

Throwing something at something (past tense thrown it at)
   "drop [something held] at/against/on/onto [something]"

checkan actor throwing something atimplicitly remove thrown clothing rule
checkan actor throwing something atfutile to throw things at inanimate objects rule
checkan actor throwing something atblock throwing at rule

Some of those still look useful. We want to leave the "implicitly remove thrown clothing" rule, for instance -- no fair having the player throw a hat that's on his head. On the other hand, the "futile to throw things at inanimate objects rule" is going to have to go, because that would prevent us from ever being able to complete the throwing command. So let's get rid of that:

"Kyoto"

Part 1 - Throwing Rules

The futile to throw things at inanimate objects rule is not listed in the check throwing it at rules.

That "block throwing at" rule also looks sinister: any "block…" rule in the standard actions library is there to print a message telling the player he can't do what he's asked to do.

But it's not enough to ignore it, the way we did the "futile" rule. Since we are only expanding the command to affect inanimate objects, let's replace the "block throwing at" rule with a different one which will only prevent the player throwing things at people:

The block throwing at people rule is listed instead of the block throwing at rule in the check throwing it at rules.
 
This is the block throwing at people rule:
   if the second noun is a person, say "That might be construed as an attack." instead.

Now we've changed the command so that some action can sometimes be carried out here -- but we don't have any rules for what happens. It's time to create some rules for our model world.

A thing can be hard or soft. A thing can be fragile or strong. Shape is a kind of value. The shapes are round, flat, and linear. A thing has shape.

If we're actually going to allow throwing, we might want to add a couple of extra checks to the rulebook to make sure that this happens when it ought:

Check throwing it at (this is the block juggling rule):
   if the player is carrying the second noun, say "It would be difficult to throw at something you are yourself holding." instead.
 
Check throwing it at (this is the avoid throwing things into themselves rule):
   if the second noun is within the noun, say "That would be a nice magic trick." instead.

And then the rules for the action itself:

Carry out throwing it at (this is the check aerodynamics rule):
   if the noun is flat:
      move noun to location;
      say "[The noun], unwieldy, flutters to the ground.";
      rule succeeds.

That "rule succeeds" ends the action here, if the noun is flat. If not, Inform goes on to the next rule in the carry out throwing it at rulebook:

Carry out throwing it at (this is the contact rule):
   say "[The noun] hits [the second noun].[paragraph break]";
   if the second noun is fragile and the noun is hard:
      destroy the second noun.
 
Carry out throwing it at (this is the landing rule):
   let destination be the location;
   if the second noun is on a supporter (called endtable), let destination be the endtable;
   if the second noun is a supporter, let destination be the second noun;
   move the noun to the destination;
   if the noun is fragile and the second noun is hard:
      destroy the noun;
      rule succeeds;
   say "[The noun] lands [if the destination is the location]nearby[otherwise]on [the destination][end if]."

These rules are assuming some backup information, so let's provide that as well:

Reliance relates a thing (called X) to a thing (called Y) when X is part of Y or X is in Y or X is on Y. The verb to be relying on means the reliance relation.
 
To destroy (item - a thing):
   let home be the holder of the item;
   if the item is part of something (called the superstructure), let home be the holder of the superstructure;
   if the item is visible:
      say "[The item] breaks[if something is relying on the item], leaving [a list of things which are relying on the item] behind[end if].";
   if something is relying on the item,
      now all the things which are relying on the item are in the home;
   now the item is nowhere.

Now suppose we'd like to add some further cases for what happens if the player breaks a fragile door this way:

To destroy (item - a door):
   now the item is open;
   now the item is unopenable;
   say "[The item] smashes."
 
Rule for printing the name of an unopenable open door while not throwing something at something:
   say "open doorway".
 
Understand "door" or "doorway" as a door.

This works, except that objects will continue to "strike" open, unopenable doors, with the result that the player can smash the same door over and over. What we need is another rule, after the aerodynamics rule and before the contact rule, that tells Inform how to handle throwing things at open doors.

This is the flying through doorways rule:
   if the second noun is an open door:
      let the distant room be the other side of the second noun;
      move the noun to the distant room;
      say "[The noun] flies out of sight into [the distant room].";
      rule succeeds.

If the original rulebook is one we wrote ourselves, we could just add that rule in the proper spot in order. If we got it from an extension, though, we might need to put it in the right place explicitly:

The flying through doorways rule is listed before the contact rule in the carry out throwing it at rules.

The magic of rulebooks is that they allow authors to amend each other's work (or the Standard Rules) with a fair amount of freedom. A well-written extension will give individual names to its rules, to allow subsequent authors to modify the function of the extension without too much trouble.

Now for an actual scenario with which to test this:

Part 2 - The Study
 
The sliding paper screen is a door. It is north of the Moss Garden and south of the Study. The paper screen is fragile.
 
The player carries a netsuke and a shamisen. The description of the netsuke is "A weight for the cord on which you wear your purse or your medicine box. This particular one has the shape of a bullfrog, carved from green stone." The netsuke is round, hard, and strong. Understand "green" or "stone" or "bullfrog" as the netsuke.
 
The description of the shamisen is "An instrument you have only begun to learn to play." The shamisen is linear, soft, and fragile. A neck is part of the shamisen. The neck is linear, strong, and hard. A body is part of the shamisen. The body is round, fragile, and soft. A string is part of the shamisen. The string is linear, soft, and strong. The printed name of the body is "[if the body is not part of the shamisen]shamisen [end if]body". The printed name of the neck is "[if the neck is not part of the shamisen]shamisen [end if]neck". Understand "shamisen" as the body when the body is not part of the shamisen. Understand "shamisen" as the neck when the neck is not part of the shamisen.
 
The description of the Study is "A restful three-tatami room." The Study contains a calligraphy box and a hanging scroll. The initial appearance of the hanging scroll is "A handsome scroll depicts two women in kimonos crossing a bridge; Mount Fuji is in the background." The calligraphy box contains a brush. The box is openable and closed. The brush is hard, linear, and strong. The calligraphy box is round, soft, and strong. The hanging scroll is flat, soft, and strong.
 
The description of the Moss Garden is "Earlier today, you arranged three leaves on the moss in imitation of autumn. They must not be disturbed." The leaves are scenery in the Moss Garden. Instead of throwing something at the leaves: say "You spent too long over their placement."
 
Test me with "test one / test two".
 
Test one with "open screen / throw netsuke at screen / n / get netsuke / close screen / get scroll / throw scroll at screen / throw netsuke at scroll / get netsuke / throw netsuke at shamisen / drop netsuke".
 
Test two with "throw shamisen at netsuke / get all / throw netsuke at screen / get netsuke / throw netsuke at door / s / get netsuke".

wi 19.11 Success and failure
rb 10.4 Glass and Other Damage-Prone Substances

🔗

RB §10.5 Volume, Height, Weight

What should fit into what? Inform has basically three sizes: small, person-sized, and room-sized. The difference between "small" and "person-sized" doesn't appear much, but it's the difference between an ordinary container and an enterable container; the fact that a person cannot get inside an ordinary container is one of the few size-related rules built into Inform. It will not object to, say, a fishing rod being put inside a matchbox.

Inform does have one built-in measure of the size of a container: its "carrying capacity". This is a maximum number of contents:

The carrying capacity of the rucksack is 3.

This of course allows three anvils, while forbidding four postage stamps. To do better, we need units of measurement, and Dimensions ★★ demonstrates setting these up. The Speed of Thought ★★, meanwhile, ventures into the area of unit conversion: having multiple types of unit and being able to express them to the player, or parse these in the player's input.

To be fully realistic in what will fit into what, we need sophisticated three-dimensional models of shapes, both of the items being carried and of the free space remaining inside containers. Depth ★ elegantly simplifies this by approximating items as cuboids, with a given width, length and height: these multiply to give a volume. To fit in a container, a new item's volume must not exceed the volume remaining inside the container, and in addition its three dimensions must also fit in one of the possible arrangements at right angles to the sides. (So this system would indeed prevent a 1x1x100 fishing rod from being put inside a 5x2x1 matchbox, but would also prevent a 12x1x1 pencil from being put into a 10x10x1 box, because it would need to be turned diagonally to fit.)

Lead Cuts Paper ★★★ provides a different constraint: here we do not let light-weight containers hold heavy objects.

Weight comes in a different way into Swerve left? Swerve right? Or think about it and die? ★, which exploits up/down map connections to work out which way gravity would take a rolling marble.

Examples

232. Swerve left? Swerve right? Or think about it and die? ★

Suppose we have marbles that roll downhill across our map, in a life-size version of one of those marble-chute toys. We might now want to keep track of both compass relationships and which-room-slopes-into-which, so we make a new relation:

"Swerve left? Swerve right? Or think about it and die?"

Overlooking relates various rooms to various rooms.

The verb to overlook means the overlooking relation.

A thing can be spherical or lumpy. A marble is a kind of thing. A marble is always spherical. The player carries a marble called a red marble. The player carries a marble called an agate marble. The player carries a marble called a blue cloudy marble.

The Long Yellow Slide is north of the Funnel. The Long Yellow Slide overlooks the Blue Funnel. The Ski-jump is below the Blue Funnel. The Blue Funnel overlooks the Ski-jump. The Ski-jump overlooks the Landing Bowl. The Landing Bowl overlooks the Snake Run. The Landing Bowl is north of the Snake Run. The Snake Run overlooks the Goal. The Snake Run is north of the Goal.

Definition: a room is sloping if it overlooks a room.

And let's say we want the player to be allowed to slide, too, since that would be much more fun than just watching the marbles go:

Understand "sit" as sitting down. Sitting down is an action applying to nothing. Check sitting down: if the player is spherical, say "You are already seated." Carry out sitting down: now the player is spherical. Report sitting down: say "You sit, ready to slide wherever fate takes you."
 
Understand the command "stand" as something new.
 
Understand "stand" or "stand up" as standing up. Standing up is an action applying to nothing. Check standing up: if the player is lumpy, say "You are already standing." Carry out standing up: now the player is lumpy. Report standing up: say "You get to your feet."

Now a rule to control what happens to all our sliding and rolling objects:

Every turn:
   repeat with item running through spherical things which are in sloping rooms:
      let the current space be the holder of the item;
      let the final space be a random room which is overlooked by the current space;
      if the player can see the item and the item is a marble, say "[The item] rolls out of the room toward [the final space].[line break]";
      if the player is the item, say "You keep sliding...";
      move the item to the final space;
      if the player can see the item and the item is a marble, say "[The item] rolls into the room from [the current space].[line break]".

Since the Ski-jump overlooks the Landing Bowl, the marble will be able to fly through the air to its destination, even though there is no map connection to allow the player to cross. We might want to let the player make it across this barrier also, so:

Instead of jumping in a sloping room:
   say "You leap...";
   move the player to a random room overlooked by the location.

Because overlooking is various-to-various, we could include that element popular in marble chute toys, the splitter:

The Downhill Splitter is north of the Long Yellow Slide. "The green plastic chute runs downhill towards a Y-junction, forcing incoming marbles right or left."
 
The Downhill Splitter overlooks the Long Yellow Slide and the Purple Snaking Passage. The Purple Snaking Passage is southeast of the Downhill Splitter. The Purple Snaking Passage overlooks the Landing Bowl. The Purple Snaking Passage is above the Landing Bowl.
 
The player is in the Downhill Splitter.
 
Test me with "drop red / drop blue / sit / z / stand up / drop agate / sit / z / z / z / z / z".

wi 13.10 Defining new prepositions
rb 10.5 Volume, Height, Weight

268. Depth ★

In the following, we pretend that every item has a cuboidal shape. Every thing has a length, width and depth, while a "measured container" also has interior dimensions. (Thus a 10x10x10 container with 1cm-thick sides might have interior dimensions 9x9x9.)

"Depth"

A length is a kind of value. 10 cm specifies a length. An area is a kind of value. 10 sq cm specifies an area. A length times a length specifies an area. A volume is a kind of value. 10 cu cm specifies a volume. A length times an area specifies a volume.

A thing has a length called height. A thing has a length called width. A thing has a length called depth. The height of a thing is usually 10 cm. The width of a thing is usually 10 cm. The depth of a thing is usually 10 cm.

To decide what volume is the exterior volume of (item - a thing):

let base area be the height of the item multiplied by the width of the item;

let base volume be the base area multiplied by the depth of the item;

decide on the base volume.

In order to see how these shapes might fit together spatially, we need to work out the three dimensions in order of size. (If we were only dealing with portable objects, we could simply insist that the length always be greater than the width which in turn must be greater than the depth, because we could always turn them over in our hands until this was so: but some of the things we deal with may be fixed in place.) A clever way to do this might be to put them in a table of three rows and sort it, but we will write the calculation out longhand:

To decide what length is the largest dimension of (item - a thing):
   let long side be the height of item;
   if the width of the item is greater than the long side, now the long side is the width of the item;
   if the depth of the item is greater than the long side, now the long side is the depth of the item;
   decide on the long side.
 
To decide what length is the middling dimension of (item - a thing):
   let longer side be the height of item;
   let shorter side be the width of item;
   if the width of the item is greater than the height of the item:
      let shorter side be the height of item;
      let longer side be the width of item;
   if the depth of the item is greater than the longer side, decide on the longer side;
   if the depth of the item is less than the shorter side, decide on the shorter side;
   decide on the depth of the item.
 
To decide what length is the shortest dimension of (item - a thing):
   let short side be the height of item;
   if the width of the item is less than the short side, now the short side is the width of the item;
   if the depth of the item is less than the short side, now the short side is the depth of the item;
   decide on the short side.

When testing this example, the author made use of the following: it's no longer needed, but may be useful to anyone else planning elaborations.

To test the dimensions of (item - a thing):
   say "[the item] - height [height of the item], width [width of the item], depth [depth of the item].";
   say "largest side [largest dimension of the item], middling [middling dimension of the item], smallest [shortest dimension of the item]."

We now introduce a new kind: a measured container, which not only has exterior dimensions - the height, width and depth which every thing now has - but also interior measurements. A convenient way to do calculations with the hollow interior is to regard it as if it were a solid shape in its own right, and we do this with the aid of something out of world, which the player never sees: the "imaginary cuboid", which is made into the shape of whatever measured container's interior is being thought about.

A measured container is a kind of container. A measured container has a length called interior height. A measured container has a length called interior width. A measured container has a length called interior depth.
 
There is an imaginary cuboid.
 
To imagine the interior of (receptacle - a measured container) as a cuboid:
   now the height of the imaginary cuboid is the interior height of the receptacle;
   now the width of the imaginary cuboid is the interior width of the receptacle;
   now the depth of the imaginary cuboid is the interior depth of the receptacle.
 
To decide what volume is the interior volume of (receptacle - a measured container):
   imagine the interior of the receptacle as a cuboid;
   decide on the exterior volume of the imaginary cuboid.

If we assume that we could always pack items into a measured container with perfect ease, never wasting any space, then the only volume constraint will be that the total volume of the contents must not exceed the volume of the inside of the container. So we need to calculate the available volume.

To decide what volume is the available volume of (receptacle - a measured container):
   let the remaining space be the interior volume of the receptacle;
   repeat with item running through things in the receptacle:
      decrease the remaining space by the exterior volume of the item;
   if the remaining space is less than 0 cu cm, decide on 0 cu cm;
   decide on the remaining space.

If we only constrained volume, a 140 cm-long fishing rod could fit into a 12 cm by 12 cm compact disc box. So we also insist the basic shape must fit, in some orientation perpendicular to one of the sides (i.e.: we can turn the item over in any of its three sides, but not turn it diagonally or wedge it in at a tilt). This requires the longest side of the item to be less than the longest side of the receptacle, and the middle-length side, and also the shortest side. The number of these conditions to fail gives us a clue as to how we can best describe the reason why the shape won't squeeze in.

Check inserting something (called the item) into a measured container (called the receptacle):
   if the exterior volume of the item is greater than the interior volume of the receptacle, say "[The item] will never fit inside [the receptacle]." instead;
   if the exterior volume of the item is greater than the available volume of the receptacle, say "[The item] will not fit into [the receptacle] with [the list of things in the receptacle]." instead;
   imagine the interior of the receptacle as a cuboid;
   if the largest dimension of the item is greater than the largest dimension of the imaginary cuboid, say "[The item] is too long to fit into [the receptacle]." instead;
   if the middling dimension of the item is greater than the middling dimension of the imaginary cuboid, say "[The item] is too wide to fit into [the receptacle]." instead;
   if the shortest dimension of the item is greater than the shortest dimension of the imaginary cuboid, say "[The item] is too bulky to fit into [the receptacle]." instead.

And finally a situation to try out these rules.

The Cubist Lab is a room. "A laboratory which, as the art critic Louis Vauxcelles said about Braque's paintings in 1908, is full of little cubes: everyday objects rendered as if cuboidal."
 
The box is a measured container. The interior height is 10 cm. The interior depth is 5 cm. The interior width is 6 cm. The player carries the box.
 
A pebble is a kind of thing. The height is usually 2 cm. The depth is usually 2 cm. The width is usually 2 cm. The player carries 25 pebbles.
 
A red rubber ball is carried by the player. The depth is 5 cm. The width is 5 cm. The height is 5 cm.
An arrow is carried by the player. The height is 40 cm. The width is 1 cm. The depth is 1 cm.
A crusty baguette is carried by the player. The height is 80 cm. The width is 4 cm. The depth is 5 cm.
A child's book is carried by the player. The height is 1 cm. The width is 9 cm. The depth is 9 cm.
A featureless white cube is carried by the player. The height is 6 cm. The width is 6 cm. The depth is 6 cm.
 
Test me with "put arrow in box / put book in box / put cube in box / put ball in box / put baguette in box / put pebbles in box".

Several warnings about this. First, the numbers can't go very high (if the Settings for the project set the story file format to the Z-machine): while the volume can in theory go to 32,767, in practice this equates to an object 32 cm on a side, which is not very large. One way to avoid this is to use the Glulx format, allowing for sizes in excess of 10 m on a side: or we could simply scale the dimensions to suit our purposes, using a decimeter (10 cm) as the basic unit of measurement, for instance.

Second, the system will require a height, width, and depth for every portable object in the game, which is a large commitment to data entry; it may become tiresome. So it is probably not worth bothering with this kind of simulation unless it is going to be genuinely significant.

wi 15.20 Multiplication of units
rb 10.5 Volume, Height, Weight

258. Dimensions ★★

The following is not a very sophisticated approach, because it does not allow for weight to accumulate: if we put a gold ingot into a paper bag, then put the bag on the balance platform, only the bag's weight will register. But it will do for a first try.

"Dimensions"

A length is a kind of value. 10m specifies a length. An area is a kind of value. 10 sq m specifies an area. A length times a length specifies an area.

A weight is a kind of value. 10kg specifies a weight. Everything has a weight.

The verb to weigh means the weight property. A thing usually weighs 1kg.

Definition: A thing is light if its weight is 3kg or less.

Definition: A thing is heavy if its weight is 10kg or more.

The Weighbridge is a room.

A blackboard is in the Weighbridge. "A blackboard propped against one wall reads: '122/10 is [122 divided by 10] remainder [remainder after dividing 122 by 10]; 122kg/10kg is [122kg divided by 10kg] remainder [remainder after dividing 122kg by 10kg]; 122kg/10 is [122kg divided by 10] remainder [remainder after dividing 122kg by 10].'" The blackboard weighs 10kg.

A feather and a lead pig are in the Weighbridge. The lead pig weighs 45kg.

The balance platform is a supporter in the Weighbridge. "The balance platform is 10m by 8m, giving it an area of [10m multiplied by 8m], currently weighing [the list of things on the platform]. The scale alongside reads: [total weight of things on the platform]. [if two things are on the platform]Average weight is: [the total weight of things on the platform divided by the number of things on the platform]. Heaviest item is [the heaviest thing on the platform], at [weight of the heaviest thing on the platform]. Lightest item is [the lightest thing on the platform], at [weight of the lightest thing on the platform].[otherwise]It seems to be able to weigh several things at once."

Test me with "get feather / put it on platform / look / get pig / put it on platform / look".

wi 15.12 Making the verb "to weigh"
rb 10.5 Volume, Height, Weight

270. The Speed of Thought ★★

Suppose that we have a number of objects in the game that are sized in some conventional unit (such as meters), but which we would like to describe in slightly less formal terms. To do this, we will start with measurements as defined in the built-in extension Metric Units, so we don't have to recreate all these.

We'll add our own set of "conceptual units" -- things we're familiar with in real life. As we'll see below, Inform will automatically choose a unit of the right order to express a given distance if we tell it to print a length "in conceptual units".

Note: the following will compile only if you have settings set for Glulx. (To change this, go to the Settings panel and click on the Glulx option.) The Glulx virtual machine is capable of handling larger numbers than the Z-machine.

"The Speed of Thought"

Section 1 - Procedure

Include Metric Units by Graham Nelson.

1 quarter (in conceptual units, in quarters, singular) or 2 quarters (in conceptual units, in quarters, plural) specifies a length equivalent to 24mm.

1 pencil (in conceptual units, in pencils, singular) or 2 pencils (in conceptual units, in pencils, plural) specifies a length equivalent to 18cm.

1 bathtub (in conceptual units, in bathtubs, singular) or 2 bathtubs (in conceptual units, in bathtubs, plural) specifies a length equivalent to 152cm.

1 Olympic swimming pool (in conceptual units, in Olympic swimming pools, singular) or 2 Olympic swimming pools (in conceptual units, in Olympic swimming pools, plural) specifies a length equivalent to 50 meters.

1 Empire state building (in conceptual units, in Empire State buildings, singular) or 2 Empire State buildings (in conceptual units, in Empire State buildings, plural) specifies a length equivalent to 443m.

1 credit card (in conceptual units, in credit cards, singular) or 2 credit cards (in conceptual units, in credit cards, plural) specifies an area equivalent to 46 sq cm.

1 letter sheet (in conceptual units, in letter sheets, singular) or 2 letter sheets (in conceptual units, in letter sheets, plural) specifies an area equivalent to 603 sq cm.

1 queen-sized mattress (in conceptual units, in queen-sized mattresses, singular) or 2 queen-sized mattresses (in conceptual units, in queen-sized mattresses, plural) specifies an area equivalent to 3 square meters.

1 football field (in conceptual units, in football fields, singular) or 2 football fields (in conceptual units, in football fields, plural) specifies an area equivalent to 5351 square meters.

Understand "report [something]" as reporting. Reporting is an action applying to one thing.

Check reporting:

if the noun is not a fact:

say "The public doesn't want to hear about [the noun]." instead.

Carry out reporting:

now the noun is nowhere.

Report reporting:

if the extent of the noun is greater than 0mm and the surface of the noun is greater than 0 sq cm:

contextualize "'[The noun] has a length of [about] [extent of the noun in conceptual units] and an area of [about] [surface of the noun in conceptual units].'";

otherwise if the extent of the noun is greater than 0mm:

contextualize "'[The noun] has a length of [about] [extent of the noun in conceptual units].'";

otherwise if the surface of the noun is greater than 0 sq cm:

contextualize "'[The noun] has an area of [about] [surface of the noun in conceptual units].'";

otherwise:

say "'[The noun] is... pretty hard to imagine,' you say weakly. That's not going to go over well."

To say about:

say "[one of]roughly[or]about[or]around[or]approximately[at random]";

To contextualize (chosen information - text):

say "[one of]You turn to the camera and speak:[or][or]Turning to another camera angle, you add:[or][stopping] ";

say "[chosen information] ";

say "[one of][line break][or]Right now the station will be cutting over to a visual of that.[or][line break][or]Pity the kids in audiovisual who have to scare that image together in a hurry.[or]You smile brightly.[stopping]";

Section 2 - Scenario

The Science Journalism Desk is a room. "From here you, the Science Anchor, have the privilege of reporting the latest and most fascinating stories to an eager public."

After looking:

try thinking.

Instead of thinking:

say "Currently you have to report on the International Space Station. Your story could include [the list of facts carried by the player]."

Instead of taking inventory:

say "It looks foolish to be fiddling with your possessions on camera."

Instead of dropping a fact:

say "You decide to omit [the noun] from your lineup.";

now the noun is nowhere.

A fact is a kind of thing. Every fact is carried by the player. A fact has a length called the extent. A fact has an area called the surface.

The experiment module is a fact. The extent is 1116cm.

The logistics module is a fact. The extent is 421cm.

The solar array is a fact. The surface is 375 sq m. The extent is 58m.

An individual solar cell is a fact. The surface is 8 sq cm.

The orbit height is a fact.

Report reporting the orbit height:

contextualize "'The station orbits at heights between [about] [278km in conceptual units] and [460km in conceptual units] above the earth.'" instead.

Every turn:

if the player carries no facts:

say "And that's all! The channel cuts to weather.";

end the story saying "Time for lunch".

Test me with "report experiment module / report logistics / report height / report array / report solar cell".

wi 15.20 Multiplication of units
rb 10.5 Volume, Height, Weight

259. Lead Cuts Paper ★★★

The following shows the kind of "realism" rules which could be introduced using weights. Not entirely realistic: we do not bother to rupture containers out of the player's sight.

"Lead Cuts Paper"

A weight is a kind of value. 10kg specifies a weight. Everything has a weight. A thing usually has weight 1kg.

A container has a weight called breaking strain. The breaking strain of a container is usually 50kg. Definition: A container is bursting if the total weight of things in it is greater than its breaking strain.

A lead pig, a feather, a silver coin and a paper bag are in a room called the Metallurgy Workshop. The paper bag is a container with breaking strain 2kg. The lead pig has weight 50kg.

Every turn when a container (called the sack) held by someone visible (called the chump) is bursting:

say "[The sack] splits and breaks under the weight! [if the player is the chump]You discard[otherwise][The chump] discards[end if] its ruined remains, looking miserably down at [the list of things in the sack] on the floor.";

now all of the things in the sack are in the location;

now the sack is nowhere.

Test me with "get bag / get feather / put feather in bag / get pig / put pig in bag / look".

wi 15.12 Making the verb "to weigh"
rb 10.5 Volume, Height, Weight

🔗

RB §10.6 Ropes

Ropes, chains and similar long, thin, bendable items present three problems: they are like a liquid in that (unless unbreakable) they can be divided arbitrarily into smaller and smaller portions of themselves, they can be in two or more places at once (even in two or more rooms at once), and they can be tied down at either or both ends, allowing them to occupy an uneasy state in between being "portable" and "fixed in place". Even when all this is simulated, they allow us to pull on one end and so to exert force at the other - allowing action-at-a-distance which Inform's realism rules would ordinarily forbid. Ropes are hard. And it is very difficult to imagine everything a player might try when given a fully practical rope with which to solve puzzles.

Snip ★★★ solves the divisibility question, allowing string to be cut or retied into lengths of any size, with all the consequences for describing and understanding that this entails.

Otranto ★★★ provides a lengthy but straightforward approach to the other rope-related issues, subject to the simplifying assumptions that a rope is indivisible, has about the length of the distance between two adjacent rooms, and cannot be tied to another rope.

Examples

228. Otranto ★★★

The range of things one might want to do with a rope in a work of interactive fiction is fairly overwhelming. One might, in theory, swing from ropes; use them to tie containers shut; cut them up into smaller ropes; tie them together into longer ropes; employ them as fuses; bind other characters with them, or the player character.

Our rope implementation is, by these lights, reasonably simple, but it does account for the possibility of tying and untying both ends; using ropes to descend into lower rooms; pulling objects tied to the far end of the rope; and dragging objects from place to place.

"Otranto"

We start by coming up with a rope.

A rope is a kind of thing.
 
Definition: a thing is nonrope if it is not a rope. [The perfect idiocy of this statement notwithstanding, having a shortcut will come in very handy later]
 
Attachment relates things to each other in groups. The verb to be stuck to means the attachment relation.
 
Definition: a thing is tied if the number of things stuck to it is greater than 1.
 
Definition: a thing is free if it is not tied.
 
Definition: a rope is free if the number of nonrope things stuck to it is less than 2.
 
Definition: a thing is hindering if it is stuck to the noun and it is not within the location.
 
A thing can be round or unevenly shaped. A thing is usually round.
 
Definition: something is anchored if it is fixed in place or it is scenery or it is part of an anchored thing.
 
Definition: something is draggable if it is not had by the player and it is not the player and it is not anchored.

Now, we want a rope to be described in terms of the way it is tied, when it's described in a room description.

Rule for writing a paragraph about a rope (called the coil):
   if the coil is stuck to something which is in a room (called the next room) which is not the location:
      let the way be the best route from the location to the next room;
      if the way is up or the way is down:
         say "[The coil] runs [way] into [the next room].";
      otherwise:
         say "[The coil] snakes across the floor [way] towards [the next room].";
   otherwise:
      say "There is [a coil] here[if the coil is stuck to a visible nonrope thing], tied to [the list of nonrope visible things which are stuck to the coil][end if]."
 
To decide what room is the home of (item - a thing):
   if item is a door:
      let front cut be the number of moves from the location to the front side of the item;
      let back cut be the number of moves from the location to the back side of the item;
      if front cut is -1, let front cut be 999;
      if back cut is -1, let back cut be 999;
      if the location encloses the item, decide on the location;
      if front cut is greater than back cut, decide on the back side of the item;
      decide on the front side of the item;
   decide on the location of the item.
 
Rule for writing a paragraph about a nonrope thing (called the anchor) which is stuck to a rope (called the coil):
   if the coil is in an adjacent room:
      let the next room be the home of the coil;
      let the way be the best route from the location to the next room;
      if the way is up or the way is down:
         say "[The coil] runs [way] from [the anchor] into [the next room].";
      otherwise:
         say "From [the anchor] runs [a coil], heading off toward [the way].";
   otherwise:
      if the coil is stuck to something which is not visible,
         say "[The coil] is tied to [the anchor][if the coil is stuck to something in an adjacent room (called the next room)], and from there runs off towards [the next room][end if]."

We need a way to account for it when it's being carried, as well.

After printing the name of a rope (called the tied object) while taking inventory:
   if something nonrope is stuck to the tied object:
      say " (attached to [the list of nonrope things which are stuck to the tied object])";
   otherwise:
      say " (with both ends free)".

And, indeed, whenever the player examines a rope, we should see what's connected.

Instead of examining a rope (called the cord) when something is stuck to the cord:
   say "[The noun] is tied to [the list of secondary things which are stuck to the noun]."

Similarly, any time the player looks at something tied to a rope.

After examining the player when the player is stuck to something which is not the player:
   say "You're currently lashed to [the list of secondary things stuck to the noun]."
 
After examining something which is stuck to something secondary:
   say "[The noun] is currently attached to [the list of secondary things stuck to the noun]."

We also need to make sure that the rope can be interacted with properly even when it's partly in the next room.

After deciding the scope of the player:
   if something stuck to a rope (called the coil) is in the location, place the coil in scope.
 
A reaching inside rule:
   if the noun is a rope:
      let the anchor be a random visible thing stuck to the noun;
      if the anchor is not the noun:
         if the anchor is touchable, allow access.

Now tying:

Before tying something to a rope:
   if the noun is stuck to the second noun, say "[The noun] and [the second noun] are already tied together." instead;
   if the second noun is not free, say "[The second noun] has no ends free." instead;
   if the noun is round, say "You can't realistically tie anything to [the noun]." instead.
 
Instead of tying a rope to something:
   try tying the second noun to the noun.
 
Instead of tying something to a rope:
   now the noun is stuck to the second noun;
   say "You loop [the second noun] around [the noun] and knot firmly."
 
 
Instead of tying something to a nonrope tied thing:
   let the coil be a random rope stuck to the second noun;
   try tying the noun to the coil.
 
Instead of tying a nonrope tied thing to something:
   let the coil be a random rope stuck to the noun;
   try tying the second noun to the coil.
 
Instead of tying a free nonrope thing to a free nonrope thing:
   if the player carries a free rope (called the coil):
      try tying the noun to the coil;
      if the noun is stuck to the coil and the coil is free:
         try tying the second noun to the coil;
   otherwise:
      say "You lack the requisite spare rope."
 
Understand "untie [something] from [something]" as untying it from. Understand "untie [something]" as untying  it from.
 
Rule for supplying a missing second noun while untying something from:
   if the number of secondary things stuck to the noun is 0, say "[The noun] is already entirely free." instead;
   if the noun is a rope:
      if the number of touchable nonrope things which are stuck to the noun > 1:
         say "You'll have to say which thing you want to untie [the noun] from.";
         rule fails;
      otherwise:
         if the number of touchable nonrope things stuck to the noun is 0, say "You can't reach [the random nonrope thing stuck to the noun]." instead;
         let the tied object be a random touchable nonrope thing which is stuck to the noun;
         say "(from [the tied object])[line break]";
         now the second noun is the tied object;
   otherwise:
      if the noun is stuck to a rope (called the tied object):
         say "(from [the tied object])[line break]";
         now the second noun is the tied object.
 
Untying it from is an action applying to two things.
 
Before untying a rope from something: try untying the second noun from the noun instead.
 
Before untying something from a rope:
   if the second noun is not held:
      say "(first picking up [the second noun])[line break]";
      try taking the second noun.
 
Check untying it from:
   unless the noun is stuck to the second noun or the second noun is stuck to the noun,
      say "[The noun] and [the second noun] are already not tied together." instead.
 
Carry out untying it from:
   now the noun is not stuck to the second noun.
 
Report untying it from:
   say "Untied."

Another part of the fun of a rope is that you can drag things from another room:

After reading a command: now every thing is unmentioned.
 
Before pulling something anchored: say "[The noun] is firmly anchored." instead.
 
Instead of pulling something tied:
   if the noun is unmentioned:
      say "The impulse is transmitted to [the list of pullable things stuck to the noun].";
      repeat with item running through pullable things stuck to the noun:
         say "[item]: [run paragraph on]";
         try pulling the item;
      if the noun is a rope and the noun is not within the location:
         if the number of nonrope hindering things is 0, move the noun to the location;
   otherwise:
      continue the action.
 
Before pulling something which is not visible:
   if the noun is anchored:
      say "[The noun] resists, for whatever reason." instead;
   otherwise:
      let space be the holder of the noun;
      let way be the best route from the space to the location;
      if the way is a direction:
         move the noun to the location;
         say "[The noun] [if the way is up]rises[otherwise]slides[end if] into view." instead;
      otherwise:
         move the noun to the location;
         say "[The noun] slides into view." instead.
 
Definition: a thing is secondary if it is not the noun.  Definition: a thing is pullable if it is not the noun and it is not the player.

A player who is tied to things should also have some restrictions on his ability to move.

Before going a direction (called the way) when the player has something (called the link) which is stuck to something anchored (called the anchor):
   let the next room be the home of the anchor;
   if the next room is not a room, continue the action;
   if the next room is the location:
      if the link is stuck to at least two anchored things,
         say "You can't go far while you're carrying [the link] tied to [the list of anchored things stuck to the link]." instead;
   otherwise:
      let the safe way be the best route from the location to the next room;
      if the safe way is the way:
         if the player is not stuck to the anchor, say "(coiling up your rope again as you go...)";
      otherwise:
         if the safe way is a direction,
            say "While you have [the link] you can't really head any direction but [best route from the location to the next room]." instead;
         otherwise say "You're tied up here." instead.
 
Before going a direction (called the way) when the player is stuck to something anchored (called the anchor):
   let the next room be the home of the anchor;
   if the next room is not a room, continue the action;
   if the next room is the location:
      if the player is stuck to at least two anchored things,
         say "You can't go far while you're tied to [the list of anchored things stuck to the player]." instead;
   otherwise:
      if the best route from the location to the next room is the way:
         say "(coiling up your rope again as you go...)";
      otherwise:
         say "Your attachments prevent you going any way but [best route from the location to the next room]." instead.

Sometimes, if the player is tied to a movable object, the moved object will move with him.

After going somewhere when the player has something (called the link) which is stuck to something draggable:
   if the player is not stuck to the link:
      say "You drag along behind you [the list of draggable things which are stuck to the link].";
      now every draggable thing which is stuck to the link is in the location;
   continue the action.
 
Report going somewhere when the player is stuck to something draggable:
   say "You drag along behind you [the list of draggable things which are stuck to the player].";
   now every draggable thing which is stuck to the player is in the location.

And now the actual game and puzzles.

Use full-length room descriptions.
 
The Fallow Field is a room. "The very land is gloomy, the earth plowed into untended rows that yield no fruit, shadowed by the castle to the north. A chasm, no doubt the product of some upheaval of the earth, opens before your feet.". An oak stump is fixed in place in the Field. "From an oak stump, a few hopeful shoots grow." A hempen rope is a rope in the field. It is stuck to the oak stump and the wooden chest. The stump is unevenly shaped.
 
The Chasm is below the Field. "Your person is most uncomfortably pressed on every side by the closeness of the walls; to which you may add as a further inconvenience, that the irregularity of the floor making it difficult to walk upright." An iron key is in the Chasm. "An iron key nestles in the cleft of earth, its age indicated by its implausibly great size."
 
The wooden chest is a unevenly shaped closed openable container in the Chasm. The description of the wooden chest is "A handsome, solid case not long committed to its dank enclosure, or it would long since have rotted." Rule for printing the name of the wooden chest when the chest is not handled: say "deadweight". Understand "dead" or "weight" or "deadweight" as the chest. Before pulling the wooden chest: now the chest is handled.
 
In the chest is a heavy dagger. The description of the dagger is "Set with red jewels and of a wicked aspect."
 
Before going down from the Field when the player is not stuck to something anchored:
   say "You don't quite dare simply leap into the darkness without some anchor." instead.
 
Before going down from the Field:
   let anchor be a random anchored thing which is stuck to the player;
   say "You lower yourself gingerly, hoping that [the anchor] holds your weight..."
 
Before going up from the Chasm:
   if the player cannot touch a rope which is stuck to an anchored thing which is in the Field, say "And how, precisely, do you mean to do that?" instead.
 
The Castle Hall is north of the Field. "All is desolate: the great hall has no roof, nor is there any glass in the windows. A staircase without banister ascends inside the wall to a musician's gallery without song."
 
The Musician's Gallery is above the Castle Hall. "Of its former cheery aspect only this remains to the Gallery: that chevrons of red and yellow are painted on the wall. But as these are streaked with rain and grime, the banister pulled away, the roof open to the sky, and the corners made a nesting place for birds, the consolation thereby afforded is but slight."
 
The pointed door is north of the Musician's Gallery and south of the Sinister Attic. It is a closed locked openable door. "A pointed door of particularly grim and uninviting aspect leads north." The pointed door is lockable and unevenly shaped. The description of the pointed door is "A door coming to a gothic point and fitted with iron fittings of great strength. The handle looks particularly well-attached." The iron key unlocks the pointed door.
 
A rule for reaching inside the Musician's Gallery:
   allow access.
 
A rule for reaching inside the Sinister Attic:
   allow access.
 
Instead of opening the pointed door for the first time:
   say "When you rattle at the door, there arises from beyond a terrible shrill noise as though something beyond exults in its imminent release."
 
After opening the trapped pointed door when the player can see the pointed door:
   say "Thousands of bats fly from the pointed door, attacking you!";
   end the story.
 
After opening the pointed door when the player cannot see the pointed door: now the pointed door is untrapped; continue the action.
 
The pointed door can be trapped or untrapped. The pointed door is trapped.
 
Before pulling the pointed door: try opening the pointed door instead.
 
The player is unevenly shaped.
 
After going to the sinister attic:
   say "You have arrived at the goal of your quest!";
   end the story finally.
 
Test me with "x rope / pull rope / get chest / untie rope from chest / tie rope to me / down / get key / up / untie rope from stump / north / up / unlock pointed door with key / open it / tie rope to door / down / pull rope / up / north".
 
Test death with "x rope / pull rope / get chest / untie rope from chest / tie rope to me / down / get key / up / untie rope from stump / north / up / unlock pointed door with key / open it / g"

wi 13.7 Relations in groups
rb 10.6 Ropes

261. Snip ★★★

"Snip!"

Length is a kind of value. 30 inch specifies a length. 20 in specifies a length. 50 inches specifies a length.

A string is a kind of thing. A string has a length. The length of a string is usually 36 inches.

Before printing the name of a string, say "[length] piece of ". Rule for printing the plural name of a string: say "[length] pieces of string".

Understand the command "cut" as something new. Understand "cut [length] from/off [something]" as trimming it by (with nouns reversed). Understand "cut [something] by [length]" as trimming it by. Understand the command "trim" as "cut".

Trimming it by is an action applying to one thing and one length.

Check trimming it by:

if the length understood is 0 inches, say "You're approaching Zeno's string at this point." instead;

if the length understood is greater than the length of the noun, say "[The noun] is only [length of the noun] long to start with." instead;

if the length understood is the length of the noun, say "[The noun] is already exactly [length of the noun] long." instead.

Carry out trimming it by:

now the length of the noun is the length of the noun minus the length understood;

let the other half be a random string in the string repository;

now the length of the other half is the length understood;

move the other half to the player.

Report trimming it by:

reset string lengths; [we will define this in a moment; it helps guarantee that our descriptions of the strings are correct when we write the output list]

say "You now have [a list of strings carried by the player]."

Understand "cut [something] in half" as halving. Halving is an action applying to one thing.

Carry out halving:

let half measure be the length of the noun divided by 2;

now the length understood is half measure;

try trimming the noun by half measure.

This fudges slightly, since an odd-length string will be divided into uneven halves. Keeping track of fractional inches would complicate matters, though, so let's assume for now that this doesn't matter.

The player carries a string.
 
The Scissors Room is a room.
 
The string repository contains 35 strings.

Since our initial string is 36 inches long and it is impossible for the player to divide it into pieces smaller than an inch each, we need a total of 36 items to represent all the string-bits: one that the player carries at the outset, and 35 others. We should bear in mind that it is usually a good idea to use the smallest number of spare objects we can get away with: writing a game that required 1000 strings in the string repository would place silly demands on the resources of the system, so it's best to avoid that sort of thing if possible.

Now with a bit of fiddling we can also teach Inform to recognize descriptors such as "the shortest string":

Ordinariness is a kind of value. The ordinarinesses are longest, medium, shortest. A string has an ordinariness. Understand the ordinariness property as referring to a string.
 
Definition: a string is small if its length is 2 in or less. Definition: a string is large if its length is 20 in or more.
 
Before reading a command:
   reset string lengths.
 
To reset string lengths:
   let upper measure be the length of the largest visible string;
   let lower measure be the length of the smallest visible string;
   repeat with item running through strings:
      now the ordinariness of the item is medium;
      if the length of the item is the upper measure, now the item is longest;
      if the length of the item is the lower measure, now the item is shortest.
 
After reading a command:
   if the player's command includes "shorter", replace the matched text with "shortest";
   if the player's command includes "longer", replace the matched text with "longest".
 
Instead of tying a string to a string:
   move the second noun to the string repository;
   now the length of the noun is the length of the noun plus the length of the second noun;
   decrease the length of the noun by 1 inch;
   say "You end up with [a noun], as some is taken up by the knot."

This is still a little incomplete because we cannot refer to strings by their lengths, as in "the 2 inch string" and so on. To do this, we borrow a line from the chapter on Understanding:

Understand the length property as referring to a string.
 
Test me with "trim string by 4 in / cut longer string in half / cut longest string in half / cut shortest string in half / g / g / tie longest string to shortest string / tie longest string to medium string / i / x 16 inch string / drop 8 inch string / i".

wi 15.16 Understanding specified numbers
rb 10.6 Ropes

🔗

RB §10.7 Electricity and Magnetism

Electrons are so tiny, and move so fast, that we will never want to simulate them in ordinary IF. So we simply regard electricity and magnetism as behaviours which are either present or not present, and which have instantaneous effects.

In Witnessed ★★★, batteries provide electricity to enable a "device" to work. Even if switched on, a device with no battery will be ineffective.

Larger voltages are exposed in Electrified ★, which makes certain items untouchable, and ensures that an experienced electrician will not even try.

Rules of Attraction ★ provides for a magnet which attracts metallic items just strongly enough to stick together until pulled apart for any reason.

Examples

346. Rules of Attraction ★

Often we have some salient features of an object that we want to make sure the player notices whenever looking at the item in a room or in inventory. At other times, we may prefer to allow the name of the item to be printed bare. So for instance:

"Rules of Attraction"

A metal form is a kind of thing. A magnet is a kind of metal form.

Every turn:

repeat with item running through nonmagnetic metal forms which are not part of something:

if item is in a container which contains a magnet (called attractor):

say "[The item] sticks to [the attractor].";

now the item is part of the attractor.

The horseshoe magnet is a magnet carried by the player. The nail is a metal form carried by the player. The Barn is a room. In the Barn is a bucket. In the bucket is a metal form called the iron hook.

Definition: a thing is nonmagnetic if it is not a magnet.

Rule for printing room description details of a magnet (called attractor): if something is part of the attractor, say " (stuck to which [is-are the list of things which are part of the attractor])".

After printing the name of a magnet (called attractor) while taking inventory:

if something is part of the attractor, say " (stuck to which [is-are the list of things which are part of the attractor])".

Before taking a touchable thing which is part of a magnet (called attractor):

move the noun to the holder of the attractor.

Test me with "i / put horseshoe in bucket / look / get horseshoe / i / drop horseshoe / i / look / get all / put all in bucket / i / x magnet / get nail / i".

wi 18.16 Printing room description details of something
rb 10.7 Electricity and Magnetism

407. Electrified ★

Suppose we want to prevent the player from touching anything electrified -- not just as a response to TOUCH OBJECT, but at any time when the action would require contact with the object in question.

"Electrified"

A thing can be safe or electrified. A thing is usually safe.

The Open Field is a room. "At this end of the field is a wire fence separating farm country from the government testing grounds beyond." The wire fence is an electrified thing in Open Field. It is scenery. The description of the wire fence is "Built into the fence is [a list of things which are part of the fence]." The scary box is an electrified container. It is part of wire fence. In the scary box is an alluring prize.

The player carries a flashlight, a grappling hook, a very thick rubber glove, and a length of rope. The glove is wearable.

This is the electrocution-wisdom rule:

if the player wears the very thick rubber glove, make no decision;

if the action requires a touchable noun and the noun is electrified, say "You fear touching [the noun]." instead;

if the action requires a touchable second noun and the second noun is electrified, say "You fear touching [the second noun]." instead.

The electrocution-wisdom rule is listed before the basic accessibility rule in the action-processing rules.

Before touching the scary box:

say "You can't help noticing a bright red sticker on the surface of the box." [This rule will fire even if we are not wearing the glove, because Before rules occur before basic accessibility.]

Instead of opening the scary box:

say "The scary box seems to be super-glued shut." [This one won't, because Instead rules occur after basic accessibility.]

Test me with "touch fence / touch box / open box / wear glove / open box".

wi 19.15 Two rulebooks used internally
rb 10.7 Electricity and Magnetism

139. Witnessed 1 ★★★

The following example makes fairly ample use of material that we haven't seen yet, but gives some idea of the flexibility of every turn rules. Suppose we want to have a number of electrical devices, all of which may be powered by a set of batteries. The batteries will all need to be discharged as they are used (regardless of what device they happen to be controlling at the moment). So:

"Witnessed"

A battery is a kind of thing. A battery has a number called charge. The charge of a battery is usually 15.

Every turn:

repeat with hollow running through battery compartments:

if the hollow is part of a switched on device (called the machine):

if a battery (called cell) is in the hollow:

decrement the charge of the cell;

carry out the warning about failure activity with the machine;

if the cell is discharged, carry out the putting out activity with the machine;

otherwise:

carry out the putting out activity with the machine.

Warning about failure of something is an activity.

Rule for warning about failure of a device (called the machine):

if a random battery compartment which is part of the machine contains a battery (called the power source):

if the charge of the power source is 2, say "[The machine] is obviously going to go out quite soon."

Putting out something is an activity.

Rule for putting out a device (called the machine):

say "[The machine] loses power and switches off![line break]";

silently try switching off the machine.

A battery compartment is a kind of container. A battery compartment is usually closed and openable. One battery compartment is part of every device. Instead of inserting something which is not a battery into a battery compartment, say "Only batteries should go in a battery compartment."

And to get rid of annoying messages like "Which would you like to close, the flashlight or the flashlight's battery compartment?" when only the compartment is closable, we might add some understanding instructions:

Understand "turn on [device]" as switching on.
 
Understand "turn off [device]" as switching off.
 
Understand "open [openable closed thing]" as opening.
 
Understand "close [openable open thing]" as closing.
 
Understand "put [something] in [container]" as inserting it into.
 
Instead of opening a device, try opening a random battery compartment which is part of the noun. Instead of closing a device, try closing a random battery compartment which is part of the noun. Instead of inserting a battery into a device, try inserting the noun into a random battery compartment which is part of the second noun.
 
Instead of switching on an empty device:
   say "Nothing happens, perhaps because there isn't a charged battery in [the noun]."
 
Instead of switching on a battery compartment which is part of a device (called the power user), try switching on the power user.
 
Definition: a device is empty:
   if a random battery compartment which is part of it contains a battery (called the power source):
      if the power source is discharged, yes;
      no;
   yes.
 
Definition: a battery is discharged if its charge < 1.
 
A light source is a kind of device. Carry out switching on a light source: now the noun is lit. Carry out switching off a light source: now the noun is unlit.
 
The flashlight is a light source. A D battery is a battery carried by the player.
 
The cassette recorder is a device. Every turn: if the cassette recorder is switched on, say "The cassette recorder hisses faintly."
 
Rule for warning about failure of the cassette recorder:
   if a random battery compartment which is part of the cassette recorder contains a battery (called the power source):
      if the charge of the power source is 2, say "The hiss from [the cassette recorder] begins to warble ominously."
 
The player wears a backpack. The backpack is openable. In the backpack is the flashlight and the cassette recorder.
 
The description of the cassette recorder is "Useful both for recording your notes and for capturing any odd ghostly sounds you may hear."
 
The description of the backpack is "An old familiar pack, which you know so well that you can find all its pockets and take things in and out of it in pitch darkness. To avoid it showing up oddly in photographs, it is entirely black, with no shiny or metallic attachments."
 
The description of the flashlight is "You bought a new one just for this occasion, because you were worried about bringing something too small or light. This is a heavy-duty flashlight with an adjustable-focus beam. The case is made of metal, rather than plastic, and there is a spare light-bulb inside as well. You've put a band of masking tape around the handle and written in your initials in red marker.
 
There is a piece of red cellophane attached to the business end of the flashlight to keep it from being overly bright."
 
The red cellophane is part of the flashlight.
 
Instead of doing something to the red cellophane: say "You need the cellophane on the flashlight so that using it does not completely destroy your night vision."
 
Thirtieth Street Station is a room. "A huge, high, rectangular room with coffered ceilings, which looks grand but mostly makes you feel lonely and small. There are long benches in rows down the middle of the room, and an information desk with the train times, and a series of ticket windows, none of which matters very much at the moment."
 
The benches are an enterable supporter. They are scenery in the Station. The information desk is scenery in the Station. Some ticket windows are scenery in the Station. Instead of examining scenery in the Station: say "You're fairly sure that whatever is going on here has nothing to do with [the noun]." Understand "window" as ticket windows.
 
The mural is fixed in place in Thirtieth Street. "At the north side of the station is a particularly pointless and empty annex to the main room. It is dominated by a huge relief of sorts, and this is what you remember." Understand "metal" or "relief" or "huge" as the mural. The description of the mural is "It is both stylized and confusing, but you think it might be supposed to represent the various tasks and occupations of Philadelphia's population. The portions closer to the ground look as though they have recently been subjected to a light dusting of talcum powder. No unusual prints are evident."
 
The wind chimes are fixed in place in Thirtieth Street. "Carefully attached to the wall with a piece of duct tape and a hook is a light-weight set of wind chimes. Someone else has been here before you, it seems." The description is "Several of your friends use wind chimes as a sort of ghost alarm, since ghosts sometimes cause very localized movements of air when there is no natural breeze."

And this last bit, borrowed from the chapter on Understanding, adds some special instructions to help Inform decide when the player is likely to be referring to a compartment and when he's likely to be referring to the device itself.

Does the player mean doing something other than searching to a battery compartment: it is unlikely. [We discourage Inform from choosing a compartment when the player uses just the name of a device or the word 'battery'.]

We also need to deal with commands like PUT BATTERY IN FLASHLIGHT, where Inform might construe BATTERY as the D battery, the flashlight's battery compartment, or the cassette recorder's battery compartment -- and might also construe FLASHLIGHT as either the flashlight's battery compartment or the flashlight itself.

Does the player mean inserting into a battery compartment:
   if the noun is nothing:
      it is very likely;
   otherwise:
      make no decision.
 
Does the player mean inserting a battery compartment into: it is very unlikely.
 
Does the player mean inserting something into a device: it is unlikely.
 
Does the player mean searching a battery compartment: it is very likely.
 
Test me with "test first / test second".
 
Test first with "i / open flashlight compartment / put battery in it / turn on flashlight / take d battery / open cassette compartment / turn on cassette / put battery in cassette compartment / turn on cassette / z / z / z / z".
 
Test second with "get d battery / put d battery in flashlight compartment / turn on flashlight / z / z / z / z / z / z / turn off flashlight / z / z / turn on flashlight / z".

wi 9.5 Every turn
rb 10.7 Electricity and Magnetism

🔗

RB §10.8 Fire

Fire exhibits some of the properties of a gas: it is only vaguely located and tends to spread out, though it passes by touch rather than on the air. It is hazardous to life, through direct contact, heat, and smoke. Better governed, it provides light and warmth. Worse governed, it consumes almost anything it comes into contact with. Here the problem with "debris" is not so much that we need potentially hundreds of new objects to represent broken items: instead, fire could sweep through a work of IF destroying so much that no play is possible any longer. Setting up a problem in which the player must defeat a fully-capable fire is difficult to balance.

As with liquids, it is best to simulate the least amount of fire that the design will allow. Bruneseau's Journey ★★ provides a single candle which can be lit, or blown out, but where fire can never transfer from the candle's end to anything else - or vice versa: the player's source of fire, with which to light the candle, is discreetly neglected.

In the more realistic Thirst 2 ★, a campfire is lit using a tinderbox, so that fire does transfer from one thing (tinder) to another (the campfire): but it is always confined to just these two items, and can be used only for light and warmth.

The Cow Exonerated ★★ provides a class of matches that can light any flammable object, but assumes that burning objects requires only one turn; lighting one thing does not burn another.

In Fire or in Flood ★★★ provides a complete simulation of what we might call "wild-fire": combustion which spreads through arbitrary objects and rooms, destroying all in its path.

Examples

118. Thirst 2 ★

"Thirst"

The player carries a waterskin. The waterskin can be full, partly drained, or empty. The waterskin is full. Understand "water" as the waterskin.

Instead of drinking the waterskin when the waterskin is empty:

say "There is no water left."

Instead of drinking the waterskin: if the waterskin is partly drained, now the waterskin is empty; if the waterskin is full, now the waterskin is partly drained; say "You drink a long draught."

After printing the name of the waterskin: say " ([waterskin condition])"

A sleepsack is an enterable container in the Campsite. "Your sleepsack is laid out in a pocket of sandy soil and coarse grass."

The description of the stars is "You invent constellations for them. The slingshot. The scroll. The heart (upside down)."

Instead of going nowhere when the player is in Campsite:

say "Now is not the time for wandering, alone in the dark. Better to keep here[if your campfire is visible], by the fire[end if]."

Singing is an action applying to nothing. Understand "sing" as singing.

Instead of singing:

say "You sing, deep and low, a song from home. It is a good night for singing and the song raises your spirits."

The player carries a tinderbox. The tinderbox contains a flint, a steel, some tinder, and a patch of carbonized cloth. The description of the flint is "A flat grey stone with flaked edges." The description of the steel is "Curved so that you can hold it over the knuckles of your right hand and strike it against the flint. There is a knack to it. Those without the knack end up with bloody knuckles and no fire." The steel is wearable. The description of the tinder is "Dried grass and similar." The description of the cloth is "The little, precious, spark-preserving scraps without which the fire would never begin."

Instead of attacking the flint when the steel is not worn by the player:

say "You must wear the steel over your knuckles, in order to hit the flint at the best angle."

Instead of attacking the flint when the steel is worn and the cloth is not in the location:

say "Though you strike the flint sharply with the steel and throw sparks, they have nothing to catch on, since the patch of cloth does not lie beneath."

Instead of attacking the flint when the steel is worn and the cloth is in the location and the cloth is not unlit:

say "The patch of cloth has already caught."

Instead of attacking the flint:

now the cloth is glowing;

say "You strike the flint against the steel and throw sparks onto the patch of cloth; they make tiny circles of orange there, which will only prosper if blown into flame."

Realistically, we ought to attach a randomization to this so that each step of the fire-starting has a good chance of failure. But because our player may not be as patient as someone who actually needs a fire started, we allow him to succeed the first time in every case.

Ignition is a kind of value. The ignitions are whole, fading, glowing, flaming. A thing has an ignition.
 
Blowing on is an action applying to one thing. Understand "breathe on [something]" or "blow on [something]" as blowing on.
 
Instead of blowing on the whole cloth:
   say "There is no point, since no sparks have caught there."
 
Instead of blowing on the fading cloth:
   now the cloth is flaming;
   say "You blow on the faint sparks on the cloth and turn them into the beginnings of flame."
 
Instead of burning the whole tinder:
   if the cloth is not flaming:
      say "The patch of cloth must catch flame before you can light anything with it.";
   otherwise:
      now the tinder is flaming;
      now the cloth is nowhere;
      say "You light the tinder with the patch of cloth, and have the elements of a fire."
 
Every turn:
   unless the cloth is flaming or the cloth is whole:
      now the ignition of the cloth is the ignition before the ignition of the cloth;
      say "Now the patch of cloth is [ignition of the cloth]."
 
Some kindling is in the campsite.
 
Instead of burning the whole kindling:
   if the tinder is not flaming:
      say "You need the tinder to be flaming, first.";
   otherwise:
      now the tinder is nowhere;
      now the kindling is nowhere;
      move the campfire to the location;
      say "You succeed in lighting yourself a proper campfire.";
      now the printed name of Campsite is "By The Campfire".
 
Test me with "i / drink water / i / drink water / i / wear steel / get flint / get cloth / drop cloth / get tinder / hit flint / blow on cloth / burn tinder / burn kindling / look".

wi 8.5 Change of properties with values
rb 10.8 Fire

150. Bruneseau's Journey ★★

"Sire," said the Minister of the Interior to Napoleon, "yesterday I saw the most intrepid man in your Empire." - "What man is that?" said the Emperor brusquely, "and what has he done?" - "He wants to do something, Sire." - "What is it?" - "To visit the sewers of Paris."
 
This man existed and his name was Bruneseau.
 
- Victor Hugo, Les Miserables

Let's say that our intrepid explorer has a candle that can be lit and blown out again, and should accordingly appear unlit, burning, or partly burnt:

"Bruneseau's Journey"

The Sewer Beneath St Denis is a room. "A narrow, stone-lined passageway, with only a little ledge to walk above the level of the refuse that flows down towards the Seine."

The candle is carried by the player. The description of the candle is "A candle, [if the candle has been lit]partially burnt[otherwise]still in pristine condition with untouched wick[end if]."

Instead of examining the lit candle, say "It burns with a pure heart."

The block burning rule is not listed in the check burning rules.

Instead of burning the lit candle:

say "The candle is already lit."

Check burning:

if the noun is not the candle, say "[The noun] cannot profitably be set on fire."

Carry out burning the candle:

now the candle is lit.

Report burning:

if the candle had been lit, say "You relight the candle.";

otherwise say "You light the candle for the first time.".

Understand "blow out [something]" as blowing out. Understand "blow [something] out" as blowing out. Blowing out is an action applying to one thing.

Carry out blowing out the candle:

now the candle is unlit.

Report blowing out:

if the noun is the candle and the candle was lit, say "You blow out [the noun].";

otherwise say "You blow on [the noun], to little effect."

Test me with "x candle / light candle / x candle / blow out candle / x candle".

We must be careful: "if the noun was lit" would throw errors because past-tense rules can only be applied to specific items, not to variables that could be anything.

wi 9.13 The past and perfect tenses
rb 10.8 Fire

417. The Cow Exonerated ★★

Here we create a class of matches that can be used to burn other objects. Our objectives are as follow:

Burned objects other than matches should be removed from play instantly (just as edible objects are instantly eaten). We could give everything its own burning duration, but that complicates matters and allows for fire to spread from one object to another; for an example of how to do that, see the example "In Fire or in Flood".

Matches should be described to show whether they are burning or extinguished, and when the parser chooses one of several identical matches, it should make very clear which match it has selected.

The game must sensibly select and, if necessary, automatically light new matches to carry out a >BURN THING command.

The matches must burn for a set number of turns before going out, never to be used again.

And finally, the part for which the text will be useful: when several matches go out in the same turn, we want the game to print

Four matches go out.

rather than

A match goes out.
A match goes out.
A match goes out.
A match goes out.

This last function appears down in Section 3, if we wish to skip ahead and look at it.

"The Cow Exonerated"

Section 1 - Simple Burning

Understand the commands "light" and "burn" as something new.

Understand "burn [something] with [strikable-match]" as burning it with. Understand "burn [something] with [something preferably held]" as burning it with. Burning it with is an action applying to one thing and one carried thing.

Understand the command "light" as "burn".

A thing can be flammable or impervious. A thing is usually impervious.

Check burning something with something (this is the burn only with flaming matches rule):

if the second noun is not a strikable-match, say "You can only light things with matches." instead;

if the second noun is not flaming, say "[The second noun] needs to be burning first." instead.

Check burning something with something (this is the burn only flammable things rule):

if the noun is impervious, say "[The noun] cannot be burned." instead.

Check burning something with something (this is the burn only things not held rule):

say "[one of]It occurs to you to set down [the noun] before burning, just for safety's sake. [or]Again, you decide to put down [the noun] prior to burning. [or]You try setting down [the noun] as usual. [stopping][run paragraph on]";

silently try the player dropping the noun;

if the player encloses the noun, stop the action.

Carry out burning something with something (this is the simplistic burning rule):

now the noun is nowhere.

Report burning something with something:

say "You burn up [the noun]."

Rule for implicitly taking the second noun while burning something with something which is not a strikable-match:

say "You can only light things with matches.";

stop the action.

Section 2 - Matches

The word "matches" is used by Inform to compare snippets of text (see "Reading a command" in the Activities chapter). This can sometimes cause awkwardness if we also have a kind called "match", so for the occasion we will give our matches a more specialized name, never visible to the player:

A strikable-match is a kind of thing. The plural of strikable-match is s-matches.
 
A strikable-match has a number called duration. The duration of a strikable-match is usually 3.
 
Rule for printing the name of a strikable-match: say "match".
Rule for printing the plural name of a strikable-match: say "matches".
 
Understand "match" as a strikable-match. Understand "matches" as a strikable-match.
 
Flame-state is a kind of value. The flame-states are burnt, flaming, and new. Understand "burning" or "lit" as flaming. Understand "unused" as new.
 
A strikable-match has a flame-state. A strikable-match is usually new. Understand the flame-state property as describing a strikable-match.
 
Before printing the name of a strikable-match while asking which do you mean:
   say "[flame-state] ".
 
Before printing the name of a strikable-match while taking inventory:
   say "[flame-state] ".
Before printing the plural name of a strikable-match while taking inventory:
   say "[flame-state] ".
 
Before printing the name of a strikable-match while clarifying the parser's choice of something:
   if not taking inventory, say "[flame-state] ".
 
After printing the name of a strikable-match (called special-target) while clarifying the parser's choice of something:
   if the player carries the special-target:
      say " you're carrying";
   otherwise if the special-target is in the location:
      say " on the ground";
   otherwise:
      say " [if the holder of the special-target is a container]in[otherwise]on[end if] [the holder of the special-target]".
 
Understand "strike [something]" as attacking.
 
Understand "strike [strikable-match]" as striking. Striking is an action applying to one carried thing.
 
Understand "burn [strikable-match]" as striking.
 
Does the player mean striking a new strikable-match:
   it is very likely.
 
Does the player mean striking a burnt strikable-match:
   it is unlikely.
 
Check striking a strikable-match (this is the strike only new matches rule):
   if the noun is burnt, say "[The noun] has already burnt down and cannot be relit." instead;
   if the noun is flaming, say "[The noun] is already burning." instead.
 
Carry out striking a strikable-match (this is the standard striking rule):
   now the noun is flaming;
   now the noun is lit.
 
Report striking a strikable-match (this is the standard report striking rule):
   say "You light [the noun]."
 
Before burning something with a new strikable-match (this is the prior lighting rule):
   say "(first [if the player does not carry the second noun]taking and [end if]lighting [the second noun])[command clarification break]";
   silently try striking the second noun;
   if the second noun is not flaming, stop the action.
 
Rule for implicitly taking a strikable-match (called target) while striking:
   try silently taking the target.
 
Does the player mean burning something with a flaming strikable-match:
   it is very likely.
 
Does the player mean burning something with a new strikable-match:
   it is likely.
 
Does the player mean burning something with a burnt strikable-match:
   it is unlikely.
 
Instead of burning a burnt strikable-match with something:
   say "[The noun] is completely consumed and cannot be relit."
 
Section 3 - Putting the Matches Out
 
Every turn:
   let N be 0; [here we track how many matches are being put out during this turn, so that we don't have to mention each match individually if several go out during the same move]
   repeat with item running through flaming s-matches:
      decrement the duration of the item;
      if the duration of the item is 0:
         now the item is burnt;
         now the item is unlit;
         if the item is visible, increment N;
   if N is 1:
      say "[if the number of visible flaming s-matches is greater than 0]One of the matches [otherwise if the number of burnt visible s-matches is greater than 1]Your last burning match [otherwise]The match [end if]goes out.";
   otherwise if N is greater than 1:
      let enumeration be "[N in words]";
      if N is the number of visible s-matches:
         if N is two, say "Both";
         otherwise say "All [enumeration]";
      otherwise:
         say "[enumeration in title case]";
      say " matches go out[if a visible strikable-match is flaming], leaving [number of visible flaming s-matches in words] still lit[end if]."
 
Section 4 - Scenario
 
Old Chicago is a room.
 
The player carries a flammable thing called a log. Understand "wooden" and "wood" as the log.
 
The player carries two s-matches. The matchbox is an open openable container. It contains five s-matches. The player carries the matchbox.
 
When play begins:
   now every strikable-match carried by the player is flaming;
   now every strikable-match carried by the player is lit.
 
Test me with "i / burn match / i / i / burn log with match / burn matchbox with match / i".

wi 20.7 Making new text with text substitutions
rb 10.8 Fire

400. In Fire or in Flood ★★★

"In Fire or in Flood"

Part I - Rules for combustion

Heat is a kind of value. The heats are whole, damp, and flaming. A thing has a heat. A thing is usually whole.

A thing has a number called endurance. The endurance of a thing is usually 5. A thing has a number called turns of burning. A thing can be flammable or flame-retardant.

Before printing the name of something flaming:

say "flaming ".

Before burning something when the player is not carrying something flaming:

if a flaming portable thing (called the lighter) is touchable:

say "(with [the lighter], which you first take)[command clarification break]";

try taking the lighter.

Instead of burning something when the player is not carrying something flaming:

say "You would first need a fire source."

Instead of burning something flame-retardant:

say "[The noun] is not the sort of thing that catches fire."

Instead of burning something flammable when the player is carrying something flaming (called the flame source):

say "You light [the noun] with [the flame source].";

now the heat of the noun is flaming.

Instead of burning something when the player is in the noun:

say "That seems dangerous given that you yourself are in [the noun]."

Instead of burning something when the player is on the noun:

say "That seems dangerous given that you yourself are on [the noun]."

Instead of examining something:

say "Hm, the [printed name] appears to be [heat]."

Before taking a flaming thing:

let turns remaining be the endurance of the noun minus the turns of burning of the noun;

if turns remaining is less than two, say "There's no portion of [the noun] sufficiently cool for you to pick up." instead.

But that's only a small part of the battle. The thing about fire is that it keeps on doing fiery things even when the player is otherwise occupied: destroying items that are on fire, and spreading to other things nearby. So we need a set of rules for the fire's behavior.

Every turn when something is flaming:
   follow the fire rules.
 
The fire rules is a rulebook.
 
A fire rule (this is the can't hold flaming objects rule):
   repeat with item running through flaming things:
      if the item is held by the player:
         let turns remaining be the endurance of the item minus the turns of burning of the item;
         if turns remaining is less than two:
            say "[The item] becomes too hot to hold! ";
            try dropping the item;
            if the item is held by the player, say "This is certainly painful."
 
A fire rule (this is the flames spread rule):
   repeat with item running through flaming things:
      if the turns of burning of the item is one:
         spread the flames from the item.
 
A fire rule (this is the fire destroys things rule):
   now started printing is false;
   repeat with item running through flaming things:
      increment the turns of burning of the item;
      if the turns of burning of the item is greater than the endurance of the item, destroy the item;
   if started printing is true, say "[paragraph break]";
   now started printing is false.

Because we've labelled all the fire rules, we could swap their order, or turn some of them off, while allowing the others run as usual. For instance, if there were a pair of fireproof gloves in the game, we might want to turn off the "can't hold flaming objects rule" whenever the player is wearing them.

This sort of flexibility is especially useful in the context of extensions. Someone writing an extension about burning would have no way of anticipating the need for a Fireproof Gauntlet of Thog, but the author would nonetheless be able to implement one easily.

Definition: a thing is vulnerable if it is flammable and it is whole.

The contact between things is a critical factor when it comes to fire, so we might add a couple of conditional relations do determine what is touching what.

Reliance relates a thing (called X) to a thing (called Y) when X is part of Y or X is in Y or X is on Y. The verb to be relying on means the reliance relation.
 
Contact relates a thing (called X) to a thing (called Y) when X is relying on Y or Y is relying on X. The verb to be joined to means the contact relation.

Having these at our disposal makes it much tidier to write what happens next:

To spread the flames from (item - a thing):
   now started printing is false;
   if the item is joined to a flammable whole thing (called the sacrifice):
      if the sacrifice is visible:
         now started printing is true;
         say "Flames engulf [the list of flammable whole things which are joined to the item].";
      now all the flammable whole things joined to the item are flaming.
 
Started printing is a truth state that varies. Started printing is false.
 
To destroy (item - a thing):
   let home be the holder of the item;
   if the item is part of something (called the superstructure), let home be the holder of the superstructure;
   if the item is visible:
      now started printing is true;
      say "[The item] burns away[if something is relying on the item], leaving [a list of things which are relying on the item] behind[end if]. ";
   if something is relying on the item,
      now all the things which are relying on the item are in the home;
   now the item is nowhere;
   now the item is damp;
   now every flaming thing which is part of the item is damp.
 
To destroy (item - a door):
   let home be the holder of the item;
   if item is visible:
      now started printing is true;
      say "[The item] burns away[if something flame-retardant is part of the item], leaving [a list of flame-retardant parts of the item] behind[end if]. ";
   if home is a room, now all of the flame-retardant parts of the item are in the home;
   now the item is damp;
   now the item is open;
   now the item is unopenable.
 
Before printing the name of a damp door:
   say "burnt-out frame of ".
 
Instead of opening or closing a damp door:
   say "[The noun] can no longer be opened or closed in any meaningful sense."
 
Instead of doing something other than examining or dropping to a flaming thing when the turns of burning of the noun is greater than 1:
   say "Fire has too thoroughly engulfed [the noun] for that to be a good idea."
 
Instead of taking something when the noun is in a flaming thing (called the receptacle):
   say "You don't quite dare reach into [the receptacle]."
 
Instead of touching something which is within a flaming thing (called the receptacle):
   say "It seems a little risky since [the receptacle] is on fire."
 
Instead of turning something when the noun is contained in a flaming thing (called the receptacle):
   say "It seems a little risky since [the receptacle] is on fire."
 
Instead of pushing or pulling something when the noun is inside a flaming thing (called the receptacle):
   say "[The receptacle] deters you."
 
Before burning something which is in a container when the holder of the noun contains the player:
   say "This could make things toasty for you..."

And that completes the rules which cover burning: things can catch fire, fire will spread, and gradually consume the world in flames. All of that was general and could be used in any setting, but we now provide a small game to show it off.

Part II - Escape from the Library of the Dead
 
The Library of the Dead is a room. "This room -- little, dank, stone -- is filling with some miasma you do not quite dare breathe. It is imperative that you get out."
 
The desk is a flammable supporter in the Library. A drawer is part of the desk. The drawer is a flammable closed container. It is openable, lockable, and locked. The desk is scenery.
 
A box is in the Library. A metal hinge is part of the box. The hinge is flame-retardant. The box is open, flammable, and openable. The shroud of Laertes is a flammable thing in the box.
 
Instead of examining something when something is part of the noun:
   say "You note [the list of things which are part of the noun]."
 
The world's last manuscript of the Psychagogoi by Aeschylus is on the desk. The manuscript is flammable. The manuscript has endurance 1.
 
The torch is a flammable flaming thing carried by the player. It has endurance 60. The asbestos sack is a flame-retardant player's holdall in the drawer.
 
The trapdoor is up of the Library and east of the Plaza. The trapdoor is a door. It is flammable, closed, lockable, and locked. "A trapdoor in the ceiling is your only hope of escape[if flaming]. Fortunately, it is rapidly burning through[end if]." The trapdoor has endurance 15.
 
Instead of going through the closed trapdoor, say "[The trapdoor] is closed."

We can then add a special fire rule to handle the trapdoor, which will be called as part of the same sequence. Again, this would be most important if the fire rules were part of a standard extension, and the trapdoor fire rule the author's own addition.

A fire rule:
   if the trapdoor is flaming and a random chance of 1 in 3 succeeds:
      let the caught thing be a random flammable whole thing which can be touched by the trapdoor;
      if the caught thing is a thing:
         say "A spark from [the trapdoor] catches [the caught thing]!";
         now the caught thing is flaming.
 
Instead of going to the Plaza:
   say "Out at last!";
   end the story finally.
 
Test me with "get manuscript / get shroud / light desk / look / g / open drawer / look / g / g / g / get sack / put shroud in sack / put manuscript in sack / close sack / light trapdoor / look / g / g / g / g / g / g / g / g / g / g / g / g / g / g / up".

wi 19.8 New rulebooks
rb 10.8 Fire

🔗

RB §10.9 Heat

Since we prefer not to simulate burnt skin, and it is unsporting to kill a player outright merely for touching a hot object, heat is mostly used as a reason why something cannot be picked up at a given moment. This very basic puzzle is demonstrated in Grilling ★.

With the naked eye, it is not always easy to detect what is too hot to touch - a point made in both Masochism Deli ★, where the only solution is to keep picking up potatoes until one doesn't burn, and in Hot Glass Looks Like Cold Glass ★★★, where infrared goggles turn the scales.

If a hot object is not to be touched, will it stay hot forever? It might well, if it is a steak on an electric grill, but not if it is a recently-baked apple pie sitting on a window-sill. Entropy ★ simulates the gradual return of temperature to equilibrium.

Examples

84. Grilling ★

Descriptions of objects can be used in "Instead" rules: we can not only say "Instead of taking the steak", but also "Instead of taking something" or "Instead of taking something which is on the grill".

That last rule is useful if, for example, we want to prevent the player from interacting with anything on a specific supporter:

"Grilling"

The Patio is a room. The Patio contains a grill and an ice chest. The ice chest contains a cold beer. On the grill are a steak and a hot dog.

Mom is a woman in the Patio.

Instead of taking something which is on the grill:

say "'Hey, you'll burn yourself,' says Mom."

Test me with "get steak / get all from grill / get all".

We could just as easily adapt this rule to affect a container: "Instead of taking something which is in the ice chest," for example.

Note also that in older versions of Inform, the pattern "get all from…" was treated differently from "get steak", and had to be accounted for separately. This is no longer the case; this instead of taking… rule will handle all the phrasings which the player might use to try to acquire this object.

wi 7.2 Instead rules
rb 10.9 Heat

182. Entropy ★

"Entropy"

Heat is a kind of value. The heats are frosty, cold, cool, room temperature, warm, hot, and scalding. Everything has a heat. The heat of a thing is usually room temperature.

Every turn:

repeat with item running through things which are not in an insulated container:

if the heat of the item is greater than room temperature, now the heat of the item is the heat before the heat of the item;

if the heat of the item is less than room temperature, now the heat of the item is the heat after the heat of the item.

Definition: a container is insulated if it is closed and it is opaque.

The vacuum thermos is an opaque closed openable container carried by the player. In the vacuum thermos is a frosty thing called an ice cube.

Every turn:

if the heat of the ice cube is greater than cold:

if the ice cube is visible, say "The ice cube melts! 'HA ha,' says Maxwell, in a very unsporting, some might say demonic, way.";

now the ice cube is nowhere.

Before printing the name of something: say "[heat] ".

Equilibrium is a room. "A perfectly smooth chamber sealed from the outside world. You can't at this moment work out where the exit is, though possibly that is just because the lighting is so very very even and diffuse. And doesn't come from anywhere that you can see, either."

Maxwell is a man in Equilibrium. "Maxwell perches awkwardly on a stool across from you[if Maxwell has something], holding [a list of things carried by Maxwell][end if]." He is carrying a box of Chinese food. The Chinese food is scalding. "A discarded [item described] lies on the floor." The description of Maxwell is "He has the faintly peevish look of one who has not been properly fed."

Every turn when Maxwell has the food:

if the heat of the Chinese food is greater than warm, say "Maxwell takes a bite, and swears.";

if the heat of the Chinese food is warm, say "Maxwell eats as fast as he can, enjoying the food while it's at just the right temperature.";

if the heat of the Chinese food is less than warm:

say "Maxwell sadly stabs at his leftovers with a chopstick, but does not try to eat any more.";

move the food to the location.

Test me with "z / z / open thermos / close thermos / open thermos".

wi 11.18 The value after and the value before
rb 10.9 Heat

326. Masochism Deli ★

Here the player has several potatoes; we would like to make him more likely to drop the hot one, and more likely to pick up the cold one, all else being equal. At the same time, we want to phrase our rules so that they don't make the player try to take something he's already holding, or drop something he isn't.

So:

"Masochism Deli"

The Masochism Deli is a room. "Recent restructurings of corporate policy restrict the 'lunch hour' to exactly thirty-two minutes, which means that no one has time to go out. Instead, you and your coworkers eat here, in the company's very own themed lunch room."

The plural of potato is potatoes. A potato is a kind of thing. A potato is edible.

Temperature is a kind of value. The temperatures are hot and cold. A potato has a temperature. A potato is usually cold.

Understand the temperature property as describing a potato. Before printing the name of a potato (called subject): say "[temperature of subject] ". Before printing the plural name of a potato (called subject): say "[temperature of subject] ".

Does the player mean dropping a hot potato which is carried by the player: it is very likely.

Does the player mean taking a cold potato which is not carried by the player: it is very likely.

The player carries three potatoes.

After dropping a hot potato:

say "The guy from Cube B sneers at your lack of potato-holding stamina."

When play begins: now a random potato is hot.

Test me with "inventory / drop potato / g / g / get potato / g / i / get potato".

wi 17.19 Does the player mean...
rb 10.9 Heat

331. Hot Glass Looks Like Cold Glass ★★★

Suppose we have a situation where the player is allowed to talk about the heat of an object only if he's properly equipped to detect it.

"Hot Glass Looks Like Cold Glass"

Use scoring.

Heat is a kind of value. The heats are hot, warm, room temperature, and cold. A thing has a heat.

Understand the heat property as referring to a thing when the player wears the infrared goggles.

The Test Kitchen is a room. "Your own personal lab, ready for scrupulously scientific recipe research. You hope. The previous three runs of this did not go well." The pair of infrared goggles is carried by the player. The description is "A pair of head-mounted IR goggles which look very foolish when worn." The goggles are wearable.

A glass dish is a kind of container. A glass dish is transparent. Three room temperature glass dishes are on the counter. Two hot glass dishes are on the counter. Two cold glass dishes are on the counter. The counter is scenery in the Test Kitchen.

Instead of doing something other than examining to a hot glass dish:

say "Ow! Crikey! You swear, and Claudia makes a sympathetic hiss. 'You're going to have a mark from that for sure,' she comments.";

decrease the score by 2.

Instead of doing something when a hot glass dish is the second noun:

say "You brush [the second noun], and wince, but manage to conceal that from Claudia.";

decrement the score.

Before printing the name of a glass dish when the player wears the goggles: say "[heat] "

Before printing the plural name of a glass dish when the player wears the goggles: say "[heat] "

So far, so good. Now, what if the player tries to GET HOT DISH when the goggles are off? "You can't see any such thing." doesn't seem like quite the right response: he can see such a thing. He just doesn't know which it is.

We could go on to write a mistake rule that would scold the player for trying "get [heat] [text]" when not wearing the goggles. The problem is that this would not cover any other phrasing of the command, nor would it account for all the many other things the player might try to do with an object specified by heat.

What we really want is to catch all instances of the player using the property name when not allowed to do so; and for this purpose we can borrow a trick from the chapter on Activities:

After reading a command:
   if the player wears the goggles, make no decision;
   if the player's command includes "[heat]":
      say "Without the IR goggles on, you cannot tell hot things from cold at sight.";
      rule succeeds.
 
Claudia is a woman in the Test Kitchen. "Your assistant Claudia stands by with [a list of things carried by Claudia]." The description of Claudia is "Infinitely patient and a very good stenographer. She is studiously avoiding giving you any sort of look that might be construed as mocking." Claudia carries a notepad, a brined chicken breast, a blowtorch, and a cup of heavy cream.
 
Instead of asking Claudia for something which is carried by Claudia:
   move the second noun to the player;
   say "'Check, [second noun],' repeats Claudia, in the tone of one who has seen too many medical dramas. She does hand it over, though."
 
Instead of asking Claudia for something:
   say "She clears her throat faintly and glances at [the second noun], as though to say that it's not hers to give."
 
Test me with "get all / drop all / look / wear goggles / look / ask claudia for cream / put cream in hot dish / put cream in cold dish / remove goggles / get hot dish".

wi 17.21 Understanding mistakes
rb 10.9 Heat

🔗

RB §10.10 Magic (Breaking the Laws of Physics)

Every previous section of this chapter has been about adding further realism constraints to Inform, to give it a more advanced understanding of physics (and chemistry). But Inform has plenty of physical laws built into it already, even if they are more mundane: inanimate objects do not spontaneously move or change, one solid object cannot pass through another, there are opaque barriers through which light cannot pass, and so on. These rules stop many attempted actions. (GO EAST - "The oak door is closed." GET EMERALD - "You can't, since the glass display case is in the way.")

In the real world, physics is not negotiable. ("Gravity: it's not just a good idea, it's the law.") But in stories, magic can sometimes happen, and in these examples some of the rules built into Inform are waived in special circumstances, which in effect cancel certain physical laws. Very many other magical tricks could be achieved: if you want to make a given command work despite realism constraints, try typing ACTIONS - a testing command which reveals what is happening behind the scenes - and then typing the command you want. This should reveal which named rule is stopping it: you can then try suspending that rule, and seeing if the effect now works.

Examples

215. Magneto's Revenge ★

"Magneto's Revenge"

The School for Gifted Youngsters is a room. Kitty Pryde is a woman in the School for Gifted Youngsters. "Kitty Pryde waits for you to say why you summoned her out of class." The description is "You see nothing special about Kitty Pryde. But that is only because she has learned to conceal her mutant powers: in fact she has the alternative name Shadowcat, and the ability to phase through solid objects."

The glass box is a container in the School for Gifted Youngsters. It is closed, openable, and transparent. In the box is a quantity of poisonous gas. In the box is a thing called the message from Magneto.

Instead of examining the message when the player is not carrying the message:

say "You'd need to be holding it before you could read it."

Instead of opening the glass box: say "You're deterred by the swirling bottle-green mist within."

Check someone taking the gas (this is the gaseous object rule): rule fails.

Unsuccessful attempt by someone taking the gas: say "The gas isn't something one can pick up in one's bare hands."

Every turn:

if the player can touch the gas:

say "The gas has reached your lungs!";

end the story.

A rule for reaching inside something:

if the person reaching is Kitty, allow access.

Persuasion rule for asking someone to try doing something: persuasion succeeds.

Test me with "get message / kitty, get message / open box / kitty, open box".

Now the player can get Kitty to take the message without releasing the poisonous gas:

Kitty Pride waits for you to tell her why you summoned her out of class.
 
You can also see a glass box (closed) (in which are some poisonous gas and a message from Magneto) here.
 
>kitty, get message
Kitty Pryde picks up a message from Magneto.

wi 12.18 Changing reachability
rb 10.10 Magic (Breaking the Laws of Physics)

225. Interrogation ★

"Interrogation"

The X-Ray Vision Wand is carried by the player.

Instead of waving the X-Ray Vision Wand:

say "Disappointingly, nothing happens."

Instead of waving the X-Ray Vision Wand when the player can see someone who is concealing something:

say "The wand glows green. Immediately you see on the monitor [a list of things which are concealed by people who can be seen by the player]."

After printing the name of a thing (called target) which is carried by someone while waving the wand:

say " (carried by [a random person who carries the target])"

The Interrogation Chamber is a room. "Despite its gothic name, this room is a rather civilized place for your work, with large plate-glass windows and a fitted carpet."

A thing can be secret or obvious. A thing is usually obvious.

Brian is in the Interrogation Chamber."Brian lounges against the wall." Brian carries a quantity of plastic explosive. The explosive is secret.

Janine is in the Interrogation Chamber. "Janine toys nervously with a laptop bag." Janine carries a chocolate biscuit, a laptop bag, and a microfilm. The microfilm is secret. The laptop bag is wearable. In the bag is a laptop computer.

Rule for deciding the concealed possessions of something: if the particular possession is secret, yes; otherwise no.

Instead of examining someone: say "[The noun] is openly carrying [a list of unconcealed things carried by the noun]."

Test me with "wave wand / examine janine / examine brian".

wi 13.4 To carry, to wear, to have
rb 10.10 Magic (Breaking the Laws of Physics)

227. Transmutations ★

Suppose we want to have a machine in our game that can transmute one item into another, similar object with different properties: a bag of jelly beans into a bag of jewels, for instance. Thus each item will be associated with some number of equivalents -- the other objects it can turn into. This is a handy use for group relations:

"Transmutations"

Workshop is a room.

Transmutation relates things to each other in groups. The verb to become means the transmutation relation.

Definition: a thing is transmutable if it becomes more than one thing. [* It always becomes itself.]

A thing can be valuable. Something valuable called a bag of jewels is carried by the player. It becomes the bag of gunpowder and the bag of jelly beans.

A thing can be dangerous. The bag of gunpowder is a dangerous thing.

The bag of jelly beans is an edible thing.

The machine is fixed in place in the workshop.

The can't insert into what's not a container rule does nothing when inserting something into the machine.

Check inserting something which is not transmutable into the machine:

instead say "You can't transmute that."

To decide which thing is new form of (obj - edible thing): decide on a random valuable thing which becomes obj.

To decide which thing is new form of (obj - dangerous thing): decide on a random edible thing which becomes obj.

To decide which thing is new form of (obj - valuable thing): decide on a random dangerous thing which becomes obj.

Carry out inserting something into the machine:

now the noun is nowhere;

now the player carries the new form of the noun;

rule succeeds.

Report inserting something edible into the machine:

say "The machine clicks, whirrs, and spits out [a new form of the noun]. You're rich!";

rule succeeds.

Report inserting something dangerous into the machine:

say "The machine clicks, whirrs, and in a shower of flavor crystals, spits out [a new form of the noun].";

rule succeeds.

Report inserting something valuable into the machine:

say "The machine clicks, whirrs, and with a violent roar, spits out [a new form of the noun].";

rule succeeds.

Test me with "i / put jewels in machine / i / put gunpowder in machine / i / put beans in machine".

In this example we have only defined a single set of transmutable objects, but we could easily expand to include other groups.

(Thanks to Jesse McGrew for proposing this example.)

wi 13.7 Relations in groups
rb 10.10 Magic (Breaking the Laws of Physics)

398. Access All Areas ★

If somebody tries to walk through a closed door, the "can't go through closed doors rule" usually stops them. This is a rule belonging to the "check going" rulebook. These names are fairly explanatory when written out, but hard to remember: fortunately we don't need to remember them, as the Index panel contains a full inventory of the check, carry out and report rules for every action, showing all of their names and the order in which they are checked. (We can also find out which rules are stopping an action by typing the testing command ACTIONS.)

Here we make the rule do nothing provided a condition holds:

"Access All Areas"

The extremely difficult door is north of the Standing Room and south of the Room of Walking Upside Down. It is a locked door.

The player is carrying the Pointy Hat of Liminal Transgression. The hat is wearable.

The can't go through closed doors rule does nothing when the Hat is worn.

Test me with "n / wear hat / n".

(The Pointy Hat may be useful in debugging a game, even if it never makes it into the final published work.)

wi 19.5 Changing the behaviour of rules
rb 10.10 Magic (Breaking the Laws of Physics)

🔗

RB §10.11 Mathematics

It is uncommon, but not absolutely unheard-of, to need to do detailed mathematical calculations in interactive fiction.

The Fibonacci Sequence ★ demonstrates the calculation of a series of numbers; Sieve of Eratosthenes ★ shows off how to calculate the prime numbers within a certain range.

Number Study ★ demonstrates conditional relations between numbers.

Examples

240. Number Study ★

This is the same case given above, but expanded just slightly to demonstrate that the names of the relations can also be printed, if we like:

"Number Study"

Abstraction is a room.

Parity relates a number (called N) to a number (called M) when N minus M is even.

Joint magnitude relates a number (called N) to a number (called M) when N plus M is greater than 7.

To chart (R - a relation of numbers):

repeat with N running from 1 to 5:

repeat with M running from 1 to 5:

if R relates N to M, say "[N] <=> [M] by [R][line break]";

When play begins:

let L be { parity relation, joint magnitude relation };

repeat with R running through L:

chart R.

As this shows, we can even form lists of relations. The kind of L is "list of relations of numbers".

wi 13.14 Relations as values in their own right
rb 10.11 Mathematics

433. The Fibonacci Sequence ★

Fibonacci (a posthumous nickname) spread Arabic mathematical learning across Europe in the 13th century, and it's curious that his name lives on only for a single sequence.

"The Fibonacci Sequence"

Pisa is a room. Leonardo Fibonacci is a man in Pisa. "The modest Italian mathematician, Leonardo Fibonacci (1170-1250), beams at you."

Sequencing is an action applying to one number. Understand "sequence [number]" as sequencing.

Instead of sequencing, say "You make a feeble attempt, sketching in the sand, but it goes nowhere. Leonardo is sympathetic. 'Often goes wrong for me, too, actually. I didn't even invent the thing - the ancient Indians knew about it first.'"

Persuasion rule for asking Leonardo to try sequencing: persuasion succeeds.

Report Leonardo sequencing:

let N be the number understood;

say "Leonardo scratches his head and makes self-deprecating remarks, before coming up with [the first N terms of the Fibonacci sequence]."

An array need not be fixed in length, as the following example shows:

To decide what list of numbers is the first (F - a number) terms of the Fibonacci sequence:
   let the Fibonacci sequence be {1, 1};
   let N be 3;
   while N < F:
      let the last term be entry (N - 1) of the Fibonacci sequence;
      let the penultimate term be entry (N - 2) of the Fibonacci sequence;
      let the next term be the last term plus the penultimate term;
      add the next term to the Fibonacci sequence;
      increment N;
   decide on the Fibonacci sequence.
 
Test me with "sequence 20 / leonardo, sequence 20".

The result of "the first 20 terms of the Fibonacci sequence" is "1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89, 144, 233, 377, 610, 987, 1597, 2584 and 4181". This is a sequence which has a knack of turning up in odd places - it was found in the 1970s to be related to the rings of florets in a sunflower, for instance - and here it is in a book about interactive fiction.

wi 21.11 Variations: arrays, logs, queues, stacks, sets, sieves and rings
rb 10.11 Mathematics

436. Sieve of Eratosthenes ★

In the words of Wikipedia: "Eratosthenes of Cyrene (Greek Eρατοσθένης; 276 BC-194 BC) was a Greek mathematician, poet, athlete, geographer and astronomer." In the words of Tom Lehrer: "It's people like that who make you realise how little you've achieved in life."

A prime number is a number greater than 1 which is not a multiple of anything, so we can find the primes by starting with all the numbers and sieving out all the multiples of 2, then all the multiples of 3, and so on. Here we make our sieve of the unacceptable numbers (the "composite" or non-prime ones) first, then form a list of all the numbers, then sieve out the composites: what are left must be the primes.

"Sieve of Eratosthenes"

Alexandria is a room. Eratosthenes is a man in Alexandria. "The haughty Greek mathematician, Eratosthenes, glowers at you."

Sieving is an action applying to one number. Understand "sieve [number]" as sieving.

Instead of sieving, say "You make a feeble attempt, sketching in the sand, but it goes nowhere. Eratosthenes smirks. 'I expect your friends call you gamma, then?'"

Persuasion rule for asking Eratosthenes to try sieving: persuasion succeeds.

Report Eratosthenes sieving:

let N be the number understood;

let the composites be a list of numbers;

let I be 2;

while I times I is at most N:

if I is not listed in the composites:

let J be I times 2;

while J is at most N:

add J to the composites, if absent;

increase J by I;

increment I;

sort the composites;

let the primes be a list of numbers;

repeat with P running from 2 to N:

add P to the primes;

remove the composites from the primes;

say "Eratosthenes sketches lines in the sand with the air of much practice. 'The primes up to [N] are [the primes]. The composites are [the composites].'"

Test me with "sieve 10 / eratosthenes, sieve 100".

While this could all be done more efficiently with an array, that's only because what we are sieving are numbers: sieving is a technique which can be used for non-numerical decisions, too.

wi 21.11 Variations: arrays, logs, queues, stacks, sets, sieves and rings
rb 10.11 Mathematics

§11.

§11.

§11.

§11.

§11.

Settings and Status Checks During Play

§11.

Ending The Story

🔗

RB §11.1 Start-Up Features

When the story file starts up, it often prints a short introductory passage of text (the "overture") and then a heading describing itself, together with some version numbering (the "banner"). It is traditional that the banner must appear eventually (and one of the few requirements of the Inform licence is that the author acknowledge Inform somewhere, for which the banner is sufficient) but some designs call for a multi-turn prologue before the banner finally appears, and marks the start of play in earnest. Bikini Atoll ★ demonstrates this.

If a story file represents the latest in a sequence of story files representing chapters in some larger narrative, it will need some way to pick up where its predecessor left off. This can be done with the aid of external files (in the Glulx format, at least). Alien Invasion Part 23 ★ shows how.

Another task we might want to perform a the beginning of play is to arrange any randomized features that are supposed to change from one playing to the next. We can add such instructions with "When play begins" rule, as in:

When play begins:
   now the priceless treasure is in a random room.

Since we may want to do something a bit more complicated than this, Hatless ★★ demonstrates effective and ineffective methods of distributing multiple objects (in this case, one randomly-selected hat per person).

Examples

382. Bikini Atoll ★

"Bikini Atoll" by Edward Teller

The Hut and the Tropical Beach are rooms.

The conch shell is in the Hut. After taking the shell for the first time: say "As you gather the oddly-warm conch shell into your arms, you experience a sudden flash of deja-vu...[banner text]"; move the player to the Tropical Beach.

Rule for printing the banner text when the player is not carrying the shell: do nothing.

Test me with "look / examine shell / get shell / look".

(By tradition, and as a courtesy to all the people who have worked on Inform, authors ensure that the banner is printed some time near the beginning of each game played. So please only defer it, rather than suppress it altogether.)

wi 18.37 Printing the banner text
rb 11.1 Start-Up Features

439. Alien Invasion Part 23 ★

Suppose that we have a series of games each of which allows the player to select a puzzle difficulty level. When the player plays a new game in the series, we want him to start out by default with the same difficulty level he faced earlier on, so we store this information in a small preferences file, as follows:

"Alien Invasion Part 23"

A difficulty is a kind of value. The difficulties are easy, moderate, hard, and fiendish.

Understand "use [difficulty] puzzles" as selecting difficulty. Selecting difficulty is an action out of world, applying to one difficulty.

Carry out selecting difficulty:

choose row 1 in the Table of Preference Settings;

now challenge level entry is difficulty understood;

say "Puzzles will be [challenge level entry] from now on."

The File of Preferences is called "prefs".

When play begins:

if File of Preferences exists:

read File of Preferences into the Table of Preference Settings;

choose row 1 in the Table of Preference Settings;

say "(The current puzzle difficulty is set to [challenge level entry].)"

Check quitting the game:

write File of Preferences from the Table of Preference Settings.

Table of Preference Settings

challenge level

easy

The Sewer Junction is a room.

Our preference file is restricted to a single option here for simplicity's sake, but we could keep track of more information -- whether the player preferred verbose or brief room descriptions, screen configurations, and so on.

If we were disposed to be somewhat crueler, we could use a similar method to make the player finish each episode of the series in order to "unlock" the next. All we would need to do is store a numerical password in our preferences file when the player finished a given level; the next level would check, say, the Table of Completed Levels for that password, and refuse to play unless the right number were present.

wi 23.13 Writing and reading tables to external files
rb 11.1 Start-Up Features

126. Hatless ★★

Suppose we want a game in which each scenario starts with the characters wearing hats -- randomly passed out. We might be tempted to write our scenario like this:

"Hatless"

The Costumery is a room. Larry, Curly, and Moe are men in the Costumery. Janine is a woman in the Costumery.

Rule for writing a paragraph about a person (called the target) who wears a hat (called attire):

say "[The target] is here, looking stylish in [an attire]."

Rule for writing a paragraph about a hatless person (called the target):

say "[The target] mopes about, hatless."

A hat is a kind of thing. A hat is always wearable. Definition: a person is hatless if he is not the player and he does not wear a hat.

The indigo bowler, the polka-dotted fedora, the pink beret, and the scarlet cloche are hats.

When play begins:

now every hat is worn by a random hatless person.

And we might hope that this would choose a new hatless person for each hat, but we would be wrong. It will instead choose one hatless person and put all the hats on him -- and everyone else has to go bare-headed. That's clearly no good. Let's try again:

"Hatless 2"

The Costumery is a room. Larry, Curly, and Moe are men in the Costumery. Janine is a woman in the Costumery.

Rule for writing a paragraph about a person (called the target) who wears a hat (called attire):

say "[The target] is here, looking stylish in [an attire]."

Rule for writing a paragraph about a hatless person (called the target):

say "[The target] mopes about, hatless."

A hat is a kind of thing. A hat is always wearable. Definition: a person is hatless if he is not the player and he does not wear a hat.

The indigo bowler, the polka-dotted fedora, the pink beret, and the scarlet cloche are hats.

When play begins:

now every hatless person wears a random hat.

But this selects one random hat and assigns it to each hatless person in turn -- so it will only wind up being worn by the last of them (since Inform knows that only one person can wear a hat at a time).

In this case, we do have to expand out our loop so that the game makes an explicit distribution:

"Hatless 3"

The Costumery is a room. Larry, Curly, and Moe are men in the Costumery. Janine is a woman in the Costumery.

Rule for writing a paragraph about a person (called the target) who wears a hat (called attire):

say "[The target] is here, looking stylish in [an attire]."

Rule for writing a paragraph about a hatless person (called the target):

say "[The target] mopes about, hatless."

A hat is a kind of thing. A hat is always wearable. Definition: a person is hatless if he is not the player and he does not wear a hat.

The indigo bowler, the polka-dotted fedora, the pink beret, and the scarlet cloche are hats.

When play begins:

repeat with item running through hats:

now the item is worn by a random hatless person.

Each time Inform considers the instruction "now the item is worn by a random hatless person", there is one fewer such person to choose from -- so we can guarantee that the hats are distributed one per customer and that all hats are distributed.

Hatless 3 is only guaranteed to work because the number of hats is less than or equal to the number of people; otherwise the final use of random will return "nothing" and then a problem message will appear during play.

wi 8.11 Now...
rb 11.1 Start-Up Features

🔗

RB §11.2 Saving and Undoing

A very few titles in the IF literature - very few being still too many, some would say - restrict the player's ability to save the story.

Removing the player's ability to UNDO is also a risky choice. Inform does provide the facility with the use option

Use undo prevention.

which makes it impossible to UNDO at any time (unless, that is, the player is playing on an interpreter that itself has a built-in UNDO feature -- these do exist). When it works, undo prevention safeguards a randomized story or combat session against brute-force solutions, but it also means that the player who makes even a minor mistake of typing will be stuck with the undesired results.

In many cases it may be preferable to use some subtler method to enforce random effects in a story. Several extensions exist for Inform that either allow selective manipulation of the UNDO command or rig randomization to prevent UNDO and replay attempts.

Examples

210. Spellbreaker ★

The answer is easy, but there is a trap:

Check saving the game when the location is the Vault: say "That spell does not work here." instead.

The trap is that "Before saving the game…", which might have been our first guess, does not work: because out of world actions are exempt from Before, Instead and After rules.

"Spellbreaker" pulls this unpleasant, but in context witty, stunt as part of a situation which is engineered to force the player to reason through a weighing-objects puzzle using the perfect strategy rather than by guesswork. The illusion that the situation is fair - not rigged against the player, that is - would collapse if the player could save the game and keep retrying possibilities in the light of knowledge gained from earlier attempts. The moral of this story is that any attempt to use in-world situations to influence out-of-world commands should be extremely uncommon.

wi 12.15 Out of world actions
rb 11.2 Saving and Undoing

211. A point for never saving the game ★★★

Here is one way to score this point with Inform:

Check saving the game for the first time: decrement the score.

That has the right effect, but it just isn't sneaky enough. Instead let us quietly keep track of how many times the player saves:

Check saving the game: increment the number of saves.
When play ends: if the number of saves is 0, increment the score.

Sneakier, certainly, but now we could get the bonus even if the game ends earlier on, so finally:

When play ends: if the number of saves is 0 and the score is 349, increment the score.

wi 12.15 Out of world actions
rb 11.2 Saving and Undoing

🔗

RB §11.3 Helping and Hinting

IF is difficult to play: often harder than the writer ever suspects. Players are held up by what is "obvious", and they stumble into unforeseen combinations, or spend inordinate amounts of time working on the "wrong" problems. Too much of this and they give up, or post questions on online forums. Against this, many IF authors like to include in-story hints.

There are many approaches, which differ on two main issues.

First: do we spontaneously offer help to the player? The difficulty here is detecting the player's need: Y ask Y? ★ tries to spot aimlessness, while Solitude ★★ has a novice mode where it is reasonable to assume that help is almost always needed. On the other hand, suppose we require that the initiative come from the player. Will a novice know to type HELP? Query ★ shows how to redirect any attempt to ask a direct question into a HELP request. At the other end of the scale, wearily experienced players may type HELP all the time, out of habit, cheating themselves of the fun of frustration: if so, Real Adventurers Need No Help ★★★ provides the nicotine patch against this addiction.

Second: how do we decide what help is needed? Normally the player only types HELP, which is unspecific. The simplest approach offers a menu, diagnosing the player's problem by obliging him to make choices: see Food Network Interactive ★. Listing all the possible problems in the story may give away too much, though, since players may not have reached the puzzles in question yet; so some authors prefer to create menus that adapt to the current state of the story (commonly called "adaptive hints").

Failing this, we can also try to parse commands like HELP ABOUT MICRODOT, as in Ish. ★ Trieste ★★ takes a similar tack, except that instead of offering hints about puzzles, it offers help on story features (such as how to save), and lists all the available topics if the player types simply HELP.

Finally, and perhaps most stylishly, we can try to deduce what the player is stuck on from his immediate circumstances and from what is not yet solved: this needs a powerful adaptive hints system like the one in The Unexamined Life ★★★.

Examples

111. Y ask Y? ★

Suppose we'd like to watch for signs that the player is floundering, and if we see them, recommend that he try the hints. There are probably more sophisticated diagnostics, but as a first cut, let's assume that a player who repeatedly reviews descriptions of objects he's already seen, looks around the room, and takes inventory, is at a loss for more productive activities. So then…

"Y ask Y?"

A thing can be examined or unexamined. A thing is usually unexamined. Carry out examining something: now the noun is examined.

Taking inventory is acting confused. Looking is acting confused. Examining an examined thing is acting confused.

After acting confused for the sixth turn:

say "(If you are feeling lost, try typing HELP for suggestions.)"

And now we write a scenario which will, alas, rather encourage even a deft and clueful player to play as though he were hopelessly confused:

The story headline is "or: Bad Author, No Biscuit".
 
The description of a thing is usually "Hm. [The item described] reminds you quite a lot of [a random visible thing which is not the item described]."
 
The Yurt is a room.
 
Food is a kind of thing. Food is always edible. In the Yurt are a yam and a dish of yakitori. The yam and the yakitori are food. The description of food is "Well, at least it's not [a random edible thing which is not the item described]."
 
In the Yurt is an animal called a yapok.
 
The player wears a yukata. The player carries a yataghan.
 
Every turn:
   if a random chance of 1 in 2 succeeds and something is examined:
      say "Your eye is attracted by some kind of surreptitious movement from [the random examined thing].";
   otherwise if the player carries something and a random chance of 1 in 3 succeeds:
      say "[The random thing carried by the player] tries to slip from your grasp."
 
Test me with "x yam / x yam / look / x yam / i / look / i / help / quit".

And finally a little dollop of perversity from a later chapter:

Check quitting the game:
   say "You're sure? ";
   if player consents, say "[line break]You were getting close to a breakthrough, you know.[line break]";
   otherwise stop the action.
 
Understand "help" as a mistake ("You're doing fine! Just keep at what you're doing now.").

wi 7.16 Repeated actions
rb 11.3 Helping and Hinting

284. Food Network Interactive ★

"Basic Help Menu" is an extension that uses tables to provide a menu of instructions. Suppose we wanted to include this menu in our own game, but add a few custom menu items of our own:

"Food Network Interactive"

Include Basic Screen Effects by Emily Short. Include Menus by Emily Short. Include Basic Help Menu by Emily Short.

Table of Basic Help Options (continued)

title	subtable	description	toggle
"Recipes in This Game"	Table of Recipes	--	--
"Contacting the Author"	--	"If you have any difficulties with [story title], please contact me at fakeaddress@gmail.com."	--

This table is one that is pre-defined by the extension. By continuing it, we add a few additional items to the list.

And since we've promised a sub-menu of recipes:

Table of Recipes

titlesubtabledescriptiontoggle
"Salmon Tartare"--"First, be sure to buy extremely fresh salmon. Raw fish should be served on the day it was caught, if possible. To guarantee this, visit an Asian supermarket or specialty store, and buy salmon marked 'sashimi grade'..."--
"Pecan Brownies"--"Begin by shelling half a pound of pecans..."--
 
Whole Foods is a room.

To test it, type HELP and then experiment.

wi 16.18 Table continuations
rb 11.3 Helping and Hinting

296. Ish. ★

"Ish."

Ichiro's Dubious Sushi Hut is a room. "Despite the allure of the dusty plastic sushi models in the window, you're beginning to have second thoughts about the selection of this particular restaurant for your rendezvous with Agent Fowler. There are no other patrons, for one thing. Afternoon sunlight filters lazily through the window and illuminates a number of empty glass-topped tables, at each of which is a chopstick dispenser (in form of cute ceramic cat) and a pitcher of soy sauce (sticky).

The sushi bar itself is what gives the most pause, however. Behind it sits an angry-looking Japanese woman, aggressively eating a Quarter Pounder with Cheese."

We can, when necessary, accept any text at all as a token:

Understand "help [text]" or "help about [text]" as getting help about. Understand the commands "instructions" or "hint" or "hints" or "menu" or "info" or "about" as "help".
 
Getting help about is an action applying to one topic.

After that, we can use "the topic understood" to refer to the text we read:

Carry out getting help about:
   if the topic understood is a topic listed in the Table of Standard Help:
      say "[explanation entry][paragraph break]";
   otherwise:
      say "You're out of ideas."
 
Table of Standard Help

topictitlesummaryexplanation
"sushi""sushi""Really it's just vinegary rice""Popular misconception says that sushi inevitably entails raw fish, but it is in fact just rice with rice vinegar on it.  It's just that the really good kinds have raw fish in."
"cucumber roll" or "cucumber""Cucumber roll""Sushi for people who are afraid of sushi""It is just rice and slivers of cucumber in the middle, and as long as you don't go too crazy with the wasabi, all should be well."
"california roll" or "california""California roll""Travesty of the sushi concept""It's. Fake. Crab."
"monkfish liver""monkfish liver""Expert eaters only""The odds of Ichiro's having this unusual delicacy is near zero."
"microdot""microdot""What you came here to deliver""There'll be time enough for that later. If Fowler ever turns up. Where is she, anyway?"

Since the player may not know what all the help options are, we might as well let him get an overview, as well.

Understand "help" as summoning help.  Summoning help is an action applying to nothing.
 
Carry out summoning help:
   say "Help is available about the following topics.  Typing HELP followed by the name of a topic will give further information.[paragraph break]";
   repeat through the Table of Standard Help:
      say "  [title entry]: [summary entry][line break]".
 
Test me with "help / help about microdot / help cucumber / help california roll".

wi 17.5 The text token
rb 11.3 Helping and Hinting

329. Query ★

First, we create a single "[query]" token so that we can capture all instances of such sentences in a single line:

"Query"

Blank Room is a room.

Understand "who" or "what" or "when" or "where" or "why" or "how" or "who's" or "what's" or "when's" or "where's" or "why's" or "how's" as "[query]".

Understand "[query] [text]" as a mistake ("[story title] understands commands, such as '[command prompt]examine [a random thing that can be seen by the player]', but not questions. For more instructions, type HELP.").

Test me with "who am I? / who are you? / where is this place?".

Now the game will respond to all questions novice players might type with this reminder to look for help information.

wi 17.21 Understanding mistakes
rb 11.3 Helping and Hinting

285. Trieste ★★

Suppose we are using an extension in which another author has defined some help topics for the player, and we want to amend them for our game.

We'll start with the portion of the text that we have inherited from the extension:

"Trieste"

Section 1 - Procedure

A help-topic is a kind of value. Some help-topics are defined by the Table of Standard Instructions.

Table of Standard Instructions

help-topic	reply
commands	"This game recognizes 150 common commands for forms of military attack. These include..."
saving	"To save the game, type SAVE. You will be prompted to supply a file-name for your saved game. If you'd like to return to play at that point again later, RESTORE the saved game."

Understand "help [help-topic]" as asking for help about. Asking for help about is an action out of world, applying to one help-topic.

Understand "help" or "help [text]" as a mistake ("Help is available on the following topics: [help-topics list]").

To say help-topics list:

repeat through the Table of Standard Instructions:

say "[line break] [help-topic entry]";

Carry out asking for help about:

repeat through the Table of Standard Instructions:

if the help-topic understood is the help-topic entry:

say "[reply entry][paragraph break]";

break.

Section 2 - Scenario

Now, let's imagine our game is a special one in which only a very limited supply of moves are allowed. In that case, we'll want to replace the information on commands:

Table of Standard Instructions (amended)

help-topicreply
commands"The only commands this game recognizes are HOLD, MOVE, CONVOY, SUPPORT MOVE, and SUPPORT HOLD. No others are necessary."
 
Board Room is a room. Mark is a man in the Board Room. "Russia (played by Mark) is also hovering over the board."
 
Guest Bathroom is south of Board Room. Lena and Rob are in the Guest Bathroom. Lena is a woman. Rob is a man.
 
Rule for writing a paragraph about Lena when Lena is in the Guest Bathroom and Rob is in the Guest Bathroom:
   say "[Lena] (Italy) and [Rob] (Great Britain) are having a hushed conversation while leaning against your good towels. They stop and stare at you when you come in."
 
Test me with "help / help commands / help saving".

wi 16.19 Table amendments
rb 11.3 Helping and Hinting

399. Solitude ★★

Observation of novice IF players suggests that they often have a hard time figuring out how to get started, especially if they are encountering the game in a context where they don't have time to settle in and read instructions. Here we provide some training wheels to help them learn to communicate.

This is divided into several parts. The first part is the system of rules for general guidance, which could be excerpted and used anywhere. The second part is a scenario using these rules.

"Solitude"

Part 1 - General Rules

When play begins:

say "Have you played interactive fiction before? >";

if the player consents, now novice mode is false.

The rationale for asking the question this way, and not another, is that novices asked whether they would like instructions very often say no, even if they need them.

Novice mode is a truth state that varies. Novice mode is true.
 
Stopping novice mode is an action out of world.
Starting novice mode is an action out of world.
 
Understand "novice mode off" or "novice off" as stopping novice mode.
Understand "novice mode on" or "novice on" as starting novice mode.
 
Carry out stopping novice mode: now novice mode is false.
Carry out starting novice mode: now novice mode is true.
 
Report stopping novice mode: say "Novice mode is now off."
Report starting novice mode: say "Novice mode is now on."
 
Before reading a command when novice mode is true:
   say "[line break]Some options to try:[line break]";
   follow the novice suggestion rules.
 
The novice suggestion rules is a rulebook.
 
A novice suggestion rule (this is the suggestion that he look rule):
   if not looking and not going, say "  [bold type]look[roman type]".
 
A novice suggestion rule (this is the suggestion that he check inventory rule):
   if the player carries something and we are not taking inventory, say "  [bold type]inventory[roman type] (I)".
 
A novice suggestion rule (this is the suggestion that he put things on rule):
   if the player carries something and a free-standing supporter is relevant, say "  [bold type]put[roman type] something [bold type]on[roman type] [the list of relevant supporters]".
 
A novice suggestion rule (this is the suggestion that he take things rule):
   if a gettable thing is relevant, say "  [bold type]take[roman type] [the list of gettable relevant things]".
 
A novice suggestion rule (this is the suggestion that he examine things rule):
   if an unexamined thing is relevant, say "  [bold type]examine[roman type] (X) [the list of unexamined relevant things]".
 
A novice suggestion rule (this is the suggestion that he enter things rule):
   if a relevant thing is worth entering, say "  [bold type]enter[roman type] [the list of worth entering relevant things], or [bold type]get out[roman type]".
 
A novice suggestion rule (this is the suggestion that he open things rule):
   if an unlocked openable thing is relevant, say "  [bold type]open[roman type] or [bold type]close[roman type] [the list of unlocked openable relevant things]".
 
A novice suggestion rule (this is the suggestion that he lock things rule):
   if a closed lockable thing is relevant, say "  [bold type]lock[roman type] or [bold type]unlock[roman type] [the list of closed lockable relevant things]".
 
A novice suggestion rule (this is the suggestion that he eat things rule):
   if the player carries an edible relevant thing, say "  [bold type]eat[roman type] [the list of edible relevant things carried by the player]".
 
A novice suggestion rule (this is the suggestion that he wear things rule):
   if the player carries a wearable relevant thing, say "  [bold type]wear[roman type] [the list of wearable relevant things carried by the player]".
 
A novice suggestion rule (this is the suggestion that he turn things on rule):
   if a device is relevant, say "  [bold type]turn on[roman type] or [bold type]turn off[roman type] [the list of relevant devices]".
 
A novice suggestion rule (this is the suggestion that he go places rule):
   if a room is adjacent, say "  [bold type]go[roman type][exit list][if in darkness] or try other directions in the dark[otherwise]".
 
A novice suggestion rule (this is the suggestion that he enter doors rule):
   if an open door is relevant, say "  [bold type]go through[roman type] [the list of relevant open doors]".
 
A novice suggestion rule (this is the suggestion that he interact with people rule):
   if another person is relevant, say "  [bold type]kiss[roman type] or [bold type]wake[roman type] [the list of relevant other people][if the player carries something], or [bold type]give[roman type] things [bold type]to[roman type] someone[end if]".
 
A novice suggestion rule (this is the suggestion that he ask for help rule):
   say "  [bold type]help[roman type] to see a more complete set of instructions".
 
A novice suggestion rule (this is the suggestion that he turn off help rule):
   say "  [bold type]novice mode off[roman type] to turn off this guidance".
 
Last novice suggestion rule:
   say "[line break]".

The suggestion about asking for help is no good unless we provide some. This might take any of a number of forms, but for the sake of example we'll use an easy way out:

Include Basic Screen Effects by Emily Short. Include Menus by Emily Short. Include Basic Help Menu by Emily Short.
 
After taking inventory when novice mode is true: say "To get rid of any of these objects, [bold type]drop[roman type] it."
 
A thing can be examined or unexamined. Carry out examining something: now the noun is examined.
 
A thing can be seen or unseen. A thing is usually unseen.
 
Definition: a thing is relevant if it is seen and it is visible. Before printing the name of something (called the target): now the target is seen; if novice mode is true, say "[bold type]". After printing the name of something: say "[roman type]".
 
Definition: a supporter is worth entering:
   if the player carries it, no;
   if it is enterable, yes.
 
Definition: a container is worth entering:
   if the player carries it, no;
   if it is enterable and it is open, yes.
 
Definition: a person is other if it is not the player. Definition: a person is another if it is other.
 
Definition: a thing is free-standing if it is in a room.
 
To say exit list:
   let place be location;
   let count be 0;
   repeat with way running through directions:
      let place be the room way from the location;
      if place is a room:
         increment count;
         say "[if count is greater than 1] or[end if] [bold type][way][roman type]".
 
Definition: a thing is gettable:
   if it is scenery, no;
   if it is fixed in place, no;
   if it is a person, no;
   if the player is carrying it, no;
   if the player is wearing it, no;
   yes.
 
Part 2 - On the Ground
 
Antarctic Research Station is a room. "Though not always the most stimulating of environments, the station is far from your ex-wife and most of the things in the world that annoy you, namely the other 6+ billion people. There is a second room to the south." The station contains a radio. The radio is a device. It is fixed in place.
 
South of the Station is Sitting Room. The description of the Sitting Room is "Just big enough for a very [comfortable chair]." The Sitting Room contains an enterable supporter called a comfortable chair. The chair is scenery. A monograph about penguins is in the Sitting Room.
 
Blistering Cold is a room. "It is white out here and very very very cold." The white door is a door. "[The white door] leads to [the other side of the white door]."  It is west of the Blistering Cold and east of the Antarctic Research Station.
 
Test me with "i / x radio / x door / s / i / x chair / x monograph / sit in chair / get up / n / open door / enter door".

wi 19.8 New rulebooks
rb 11.3 Helping and Hinting

54. Real Adventurers Need No Help ★★★

Suppose we have an action called "asking for help" that gives the player some hints on request. We've also made it possible to turn this feature off, if the player would like to discourage himself from using the hints too much. Now we need a value that varies to keep track of whether hints are currently permitted or currently not permitted. So we might write:

"Real Adventurers Need No Help"

A permission is a kind of value. The permissions are allowed and denied.

Hint usage is a permission that varies. Hint usage is allowed.

And under the right circumstances, we change hint usage to denied:

Check asking for help for the first time:
   say "Sometimes the temptation to rely on hints becomes overwhelming, and you may prefer to turn off hints now. If you do so, your further requests for guidance will be unavailing. Turn off hints? >";
   if player consents:
      now hint usage is denied;
      say "[line break]Truly, a real adventurer does not need hints." instead.

Then we can refer back to this value later to decide whether we want to display the hint menu or not:

Check asking for help:
   if hint usage is denied, say "You have chosen to eschew hints in this game. Be strong! Persevere!" instead.
 
Asking for help is an action out of world. Understand "help" or "hint" or "hints" as asking for help.
 
The Realm of Terribly Unjust Puzzles is a room.
 
Carry out asking for help:
   say "Fine, since you're weak enough to ask: here is a complete walkthrough: GET EGG. PEEL EGG. SMELL EGG. DIVIDE YOLK INTO THREE PORTIONS. GIVE THE SMALLEST PORTION OF YOLK TO THE GOLDEN GOOSE. ASK THE GOOSE ABOUT WHETHER THE SWAN IS TO BE TRUSTED. GIVE THE LARGEST PORTION OF YOLK TO THE SWAN. DANCE CONGA. EAT MEDIUM PORTION. STAND ON HEAD. WEST."
 
Test me with "hint".

Note that it would probably be kinder to offer the player some intermediate level of help, in the actual event.

wi 4.12 Values that vary
rb 11.3 Helping and Hinting

230. The Unexamined Life ★★★

Hint systems in IF come in a variety of flavors: some are a static, prewritten set of guidelines (which might exist in a menu or outside the game entirely); others are built in as part of the program, and attempt to adapt to the situation the player currently faces. Adaptive hints have the advantage that they are less likely to reveal information for which the player is not ready, and the disadvantage that they are more work for the author.

The exercise here is to write an adaptive hint system that will both respond in agile ways to the state of the world model and require a minimum of authorial fussing. We also want the player to be able to ask for a hint about any object he encounters in the game world: this will let him be specific and avoid accidentally receiving hints about the wrong puzzles.

Our baseline assumption is that a player may find a puzzle unsolvable for one of two reasons: he either hasn't seen the relevant clue, or he hasn't got the relevant equipment. If these are true, then he should be given hints about how to find this information, and then once he has it, more specific hints about the puzzle itself -- ending, as a last resort, with the exact command(s) he will need to use in order to bring about the solution.

In practice, there are other possibilities, but this will do for an example.

We begin by defining our relations:

"The Unexamined Life"

Use scoring.

Explaining relates one thing to various things. The verb to explain means the explaining relation.

Instead of hinting about something when something unexamined (called the clue) explains the noun:

say "You're still missing some information that might be useful to understanding the problem. [More]";

if player consents, try hinting about the clue.

Requiring relates one thing to various things. The verb to require means the requiring relation.

Instead of hinting about something when the noun requires something (called the implement) which is not carried by the player:

say "You're missing an object that might be useful to resolving this problem. [More]";

if player consents, try hinting about the implement.

Hinting about is an action applying to one visible thing. Understand "hint about [any thing]" as hinting about.

This allows us to create the most absolutely generic sort of hint -- boring, perhaps, but in practice the player often just needs a nudge about what part of the game world he should be examining for a solution:

Carry out hinting about:
   if something explains the noun, say "You might want to review [the list of things which explain the noun]. ";
   if the noun requires something:
      say "You should be sure that you have [the list of things required by the noun]. ";
   otherwise:
      say "Sorry, I can't advise you further on that.".

These things cover hinting about objects that are themselves puzzles. But what if the player asks for hints about a tool or piece of information because he doesn't know how to apply it yet? We might want to give some guidance there, as well.

Carry out hinting about something which explains something (called target):
   if target is unseen, say "[The noun] might prove useful information, sooner or later." instead;
   otherwise say "You could examine [the noun]." instead.
 
Carry out hinting about something which is required by something:
   say "[The noun] might be useful to have. [More]";
   if player consents:
      if a seen thing requires the noun, say "[The noun] may help with [the list of seen things which require the noun]." instead;
      otherwise say "There are [number of things which require the noun in words] problems for which [the noun] might come in handy." instead.

Now we have these general hints written, but we want to pre-empt them if the player has not yet fulfilled all the prerequisites.

Instead of hinting about something unseen:
   if the noun is visible:
      now the noun is seen;
      continue the action;
   say "Perhaps you should explore further. ";
   if the ultimate location of the noun is an unvisited room:
      try hinting about the ultimate location of the noun;
   otherwise:
      if the ultimate location of the noun is the location:
         say "You're in the correct room right now[if the visible shell of the noun is a thing]. Try further exploring [the visible shell of the noun][end if].";
      otherwise:
         try hinting about the ultimate location of the noun.
 
Instead of hinting about a visited room:
   say "There's a room you've visited, but you haven't exhausted all there is to see there. [More]";
   if player consents:
      say "Try going back to [the noun]. [More]";
      if player consents, direct player to the noun.
 
Instead of hinting about an unvisited room:
   say "There's a room you haven't yet visited.  [More]";
   if player consents, direct player to the noun.
 
To direct player to (goal - a room):
   let way be the best route from location to the goal, using even locked doors;
   if way is a direction, say "Try going [way] to start your explorations.";
   otherwise say "Sorry, the route is an indirect one.".
 
Instead of hinting about a portable seen thing which is not visible:
   if the noun is scenery, continue the action;
   say "You have seen the item you need to solve this problem, but it's not in sight at the moment.  [More]";
   if player consents:
      try hinting about the ultimate location of the noun.

And this business of "seen" things requires, of course, that we keep track:

A thing can be seen or unseen. A thing is usually unseen. The player is seen. After printing the name of something (called target): now the target is seen.

That "After printing…" rule means that as soon as the game automatically prints the name of an object, it tags that object as having been "seen" by the player. This requires just a little care on our part, that we never mention an object without using the game's printing rules. Still, it is much easier than most other possible forms of bookkeeping.

We also need to deal with the question of whether the player has examined an object, for those objects whose descriptions carry vital information:

A thing can be examined or unexamined. A thing is usually unexamined. Carry out examining something: now the noun is examined.

In practice, there might be other ways of getting vital facts, and in a more sophisticated puzzle game we might need a more sophisticated model to track this. But examined or unexamined will do for now.

To decide what room is the ultimate location of (item - a thing):
   let place be the holder of the item;
   while the place is a thing:
      let the place be the holder of the place;
   if the place is a room, decide on the place.
 
To decide what thing is the visible shell of (item - a thing):
   if item is visible, decide on the item;
   let place be the holder of the item;
   while place is a thing and place is not visible:
      let place be the holder of the place;
   if the place is visible, decide on the place.
 
To say more:
   say "[paragraph break]Shall I go on? > ".

That covers most of the generic hints, but let's also add some slightly more precise hints about a few kinds of objects that are especially important in the model world. These hints will probably not be very interesting to a seasoned IF veteran, but a novice player who does not know the wording or cannot guess what something might be for may still find them useful:

Carry out hinting about a locked lockable thing:
   say "You could unlock [the noun] with [the matching key of the noun]." instead.
 
Instead of hinting about a locked thing when the matching key of the noun is not carried by the player:
   if the player can see the matching key of the noun:
      say "Perhaps [the matching key of the noun] would help.";
   otherwise:
      say "[The noun] is locked. There must be a key around somewhere. [More]";
      if player consents, try hinting about the matching key of the noun.
 
Carry out hinting about a closed openable unlocked thing:
   say "You could open [the noun]." instead.
 
Carry out hinting about an open door:
   say "You could enter [the noun]." instead.
 
Carry out hinting about an unexamined thing:
   say "You might find out something if you examine [the noun]." instead.
 
Carry out hinting about an edible thing:
   say "You could eat [the noun]." instead.
 
Carry out hinting about a wearable thing:
   say "You could wear [the noun]." instead.
 
Carry out hinting about a pushable between rooms thing:
   say "You could push [the noun] some direction." instead.

Now to the actual objects in the game:

The Crypt is a room. "This squat, barrel-vaulted chamber runs roughly north-south. Along either side are the graves of Saxon kings and early bishops of the church long since gone to dust -- one [tomb] in particular looks undisturbed."

Notice that we used the bracketed tomb here: the tomb is scenery, and if we do not use the name-printing function, Inform will not register that we have mentioned it to the player.

The tomb is scenery in the Crypt. The tomb is openable and closed. The silver dagger is a thing in the tomb. Understand "tombs" as the tomb. The description of the silver dagger is "Gleaming in a soft light all its own. Its blade is figured with running deer and its hilt is made of horn." The wight requires the silver dagger. The tomb requires the pry bar.
 
Instead of opening the tomb when the player does not carry the pry bar:
   say "The lids are stone, too heavy for you to raise without some implement."

Now we can add specific hints to replace the generic ones:

Carry out hinting about the tomb:
   say "The lids are heavy, but you can open them when you carry the pry bar."

The rest of the hint system ensures that the player will not see this final suggestion until he has the pry bar, since the tomb "requires" the pry bar. Having the hint there doesn't excuse us from providing some alternate wording in case the player solves this not-very-difficult conundrum on his own, though:

Understand "pry [something] with [something preferably held]" as unlocking it with. Understand the commands "lever" or "prise" as "pry".
 
Instead of unlocking something with the pry bar, try opening the noun.
 
The wight is a man in the Crypt. "[The wight] lurks near the south exit." The description of wight is "Old English [italic type]wiht[roman type]: a thing, a creature. It is little more than the memory of a life ill-lived, but it lingers here." Understand "wiht" or "creature" or "ghost" as the wight.
 
Instead of going south in the presence of wight:
   say "The wight breathes chill into your face.
 
Your head swims, and you are aware that you no longer have the willpower to go in that direction."
 
Fresh Air is south from the Crypt.
 
After going to Fresh Air:
   increment the score;
   say "Congratulations, you have escaped!";
   end the story finally.
 
The inscription is fixed in place in the Crypt. "Someone has painstakingly carved [an inscription] into the wall above the door." The description is "Squinting, you decipher the Latin text: [italic type]Silver causes harm to those that live though dead[roman type]." The inscription explains wight.
 
The Treasure Chamber is north of the Crypt. "The walls are thick, the high windows promisingly barred with iron. But for all this there is no hint of any valuable stores remaining."
 
The pry bar is in the Treasure Chamber. "One of the window bars, rusted from its place, lies in a puddle of water." Understand "window" or "bars" as the pry bar. The description of the pry bar is "A few feet long, and not entirely rusted into uselessness yet."
 
Instead of giving the dagger to wight:
   say "The wight recoils, appalled."
 
Carry out hinting about wight:
   say "You will have to find some way to get wight to come in physical contact with the silver dagger, which he will certainly not do willingly. [More]";
   if player consents, say "You could, for instance, throw it at him." instead;
   otherwise stop the action.
 
Understand "touch [something] with [something]" as putting it on (with nouns reversed). Understand "hit [someone] with [something]" as putting it on (with nouns reversed).
 
Instead of attacking the wight:
   say "You can't force yourself to approach close enough for hand to hand combat: if, indeed, the wight has hands."
 
Instead of putting the dagger on wight:
   say "The wight fades out of your way without ever coming into contact with the dagger. Perhaps a more projectile method would work better."
 
Instead of putting something on wight:
   say "The wight dodges you."
 
Instead of throwing the dagger at wight:
   now the wight is nowhere;
   move the dagger to the location;
   increment the score;
   say "The dagger passes through its airy form with a rending like the rip of silk. The fragments dissipate at once."
 
The maximum score is 2.
 
Test me with "hint about wight / north / get bar / south / open tomb / get dagger / south / hint about wight / read inscription / hint about wight / attack wight / throw dagger at wight / south".

Note that, if using TEST ME to run through the solution on the Z-machine, we will have to answer a few yes/no questions along the way.

For Glulx, the code should instead read something like

Test me with "hint about wight / y / north / get bar / south / open tomb / get dagger / south / hint about wight / y / read inscription / hint about wight / y / attack wight / throw dagger at wight / south".

wi 13.9 Defining new assertion verbs
rb 11.3 Helping and Hinting

🔗

RB §11.4 Scoring

Not every work of IF allots a numerical score to the player: for some authors, this emphasises the idea of a story rather than a narrative. The simple sentence

Use scoring.

introduces the concept. Once this is included, Inform will provide built-in support for a single number measuring progress ("score"), and will expect to measure this against a maximum possible ("maximum score", which can either be set by hand or worked out automatically from a table of ranks).

In a story in which scoring exists, the player may choose to turn score notifications (such as "[Your score has just gone up by one point.]") on or off. The commands to do this are NOTIFY ON and NOTIFY OFF; the actions are called switching score notification on and switching score notification off. In the event that we need to amend the behavior of notification, we could do so by adding, removing, or modifying the elements of the check and carry out rulebooks for these commands; as in

Check switching score notification off:
   if the turn count is less than 10:
      say "You are still a novice, grasshopper. Allow your teacher to give you advice until such time as you are ready to go on alone."

If we wish to change the wording of the default message ("[Your score has…"), we may want to use the Responses system.

An especially insidious style of bug allows the player to type the same sequence of commands over and over, earning score endlessly for the same insight, and to avoid this it is usually safest to write source like:

After taking the Picasso miniature when the Picasso miniature is not handled:
   increase the score by 10;
   say "As they say in Montmartre: dude!"

We might also write our condition with "for the first time", like so:

After jumping for the first time:
   increase the score by 5;
   say "Boing! That was certainly entertaining."

But we should be careful not to use "for the first time" in scoring situations where it's possible for the player to try the action but fail. Inform counts even unsuccessful attempts towards the number of times an action is understood to have occurred, so if the player tries to jump and fails, his "for the first time" will be used up and he will never receive the score points.

If there are many "treasure" items like the Picasso miniature, it is best to be systematic, as in No Place Like Home ★★★. Bosch ★ takes another approach to the same idea, by creating a table of point-earning actions that the player will be rewarded for doing; the FULL SCORE command will then play these back.

Mutt's Adventure ★★ demonstrates how we might add a scored room feature, such that the player earns a point when he first arrives at a special room.

A single number does not really sum up a life, or even an afternoon, and Goat-Cheese and Sage Chicken ★★★ and Panache ★★★ offer more detailed citations. Works that are more story than story may prefer to offer a plot summary of the player's experience to date in lieu of more conventional scoring.

Finally, Rubies ★★★ provides a scoreboard that keeps track of the ten highest-scoring players from one playthrough to the next.

Examples

219. Bosch ★

We could, if we wanted, make a table of stored actions all of which represent things that will earn points for the player. For instance:

"Bosch"

Use scoring.

The Garden of Excess is a room. The gilded lily is an edible thing in the Garden of Excess.

The Pathway to Desire is west of the Garden of Excess. The emerald leaf is in the Pathway.

Table of Valuable Actions

relevant action	point value	turn stamp
taking the emerald leaf	15	-1
eating the gilded lily	5	-1

(And our list would presumably continue from there, in the full game.)

The maximum score is 25.
 
After doing something:
   repeat through Table of Valuable Actions:
      if the current action is the relevant action entry and turn stamp entry is less than 0:
         now the turn stamp entry is the turn count;
         increase the score by the point value entry;
   continue the action.
 
Understand "full score" or "full" as requesting the complete score. Requesting the complete score is an action out of world.
 
Check requesting the complete score:
   if the score is 0, say "You have not yet achieved anything of note." instead.
 
Carry out requesting the complete score:
   say "So far you have received points for the following: [line break]";
   sort the Table of Valuable Actions in turn stamp order;
   repeat through the Table of Valuable Actions:
      if the turn stamp entry is greater than 0:
         say "[line break]  [relevant action entry]: [point value entry] points";
   say line break.
 
Test me with "eat lily / w / full score / get leaf / full".

This system is tidy, but limited: we cannot give actions interesting names in the score list, like "seducing the pirate's daughter" or "collecting a valuable artifact". So it will not be ideal in all situations, but it has the virtue of being easy to extend, and of listing all of the player's successes in the order in which they occurred in his play-through.

wi 12.20 Stored actions
rb 11.4 Scoring

136. Mutt's Adventure ★★

Suppose we want to reward the player the first time he reaches a given room. The "unvisited" attribute is useful for this: unlike such constructions as "going to a room for the first time", it doesn't develop false positives when the player has merely tried to go to the room in question. "Every turn when the player is in a room for the first time" is also unhelpful, because it continues to be true as long as the player is in a room on his first visit there.

"Mutt's Adventure"

Use scoring.

Section 1 - Procedure

A room can be scored or unscored.

Carry out going to a unvisited scored room:

increment the score.

Section 2 - Scenario

The Incan Palace Compound is a room. "After numerous false leads through the jungles of Peru, and an arduous trek along the Amazon, you have arrived, at last, here: at Atagon, the lost city of untold treasure."

The startlingly intricate door is a door. It is inside from Incan Palace Compound and outside from the Treasure Room. "A door carved all over with figures of ancient gods, and protected by an assortment of gears and latches, [if open]stands open[otherwise]blocks progress[end if] towards [the other side of the intricate door]."

The description of the Treasure Room is "To your considerable surprise, the treasure room is stocked with art objects from a vast range of eras and geographical locations: beside the expected pre-Columbian gold there are Cycladic figurines, Chinese Tang-dynasty pottery, purses that might have been stolen from Sutton Hoo. [one of]If the British Museum developed a nasty expectorant cough, this is what you'd find in its hanky.[or][stopping]".

The Treasure Room is scored.

Test me with "in / out / in".

wi 9.2 Awarding points
rb 11.4 Scoring

137. No Place Like Home ★★★

Suppose we want to assign scores for a whole range of objects the player might pick up. One systematic way to do this would be with a table of point values for things:

"No Place Like Home"

Use scoring.

The Hall of the Gnome King is a room. The emerald cow is a thing in the Hall of the Gnome King. The ivory chessman is a thing in the Hall of the Gnome King. The book of incantations is a thing in the Hall of the Gnome King.

Table of Point Values

item	score
cow	10
incantations	4
chessman	1

Report taking an item listed in the Table of Point Values:

increase the score by the score entry;

blank out the whole row.

Test me with "take all".

"Blank out the whole row" removes the line from the table, so that each award will occur only once. The player will not be able to earn more and more points by dropping and taking the same item again.

wi 9.2 Awarding points
rb 11.4 Scoring

166. Panache ★★★

If we have a plot that branches and has multiple kinds of outcome, we might well want to assemble these into a plot summary in place of the more traditional score. One way to approach this is to build the scene information into a table, adding information when each scene ends.

We begin with a bit of setup:

"Panache"

The player is in a room called Beneath Roxane's Balcony. Christian is a man in the Balcony. "Christian stands in a spot of moonlight and tries to avoid too obviously glancing at the shadows that conceal you." The description of Christian is "Like you, Christian loves Roxane. Unlike you, he is handsome enough to receive her favor in return. He is the beauty to your brain."

Roxane is a woman in the Balcony. "Above you in the night is Roxane." Roxane can be wooed, skeptical, confused, or annoyed. Roxane is skeptical. The description of Roxane is "The brightest, the most radiant of women -- and in love with an utter fool."

Empty Street is a room. "No one is about at this hour, all alone under a pale moon."

Telling someone about something is speech. Asking someone about something is speech. Answering someone that something is speech.

This next portion borrows from the Advanced Actions chapter to allow us to command Christian to do things:

A persuasion rule for asking Christian to try speech: persuasion succeeds.
 
Carry out Christian answering someone that something:
   now Roxane is wooed;
   say "'[noun], [the topic understood].'"
 
Carry out Christian answering the player that something:
   say "Christian parrots your words back to you." instead.
 
Carry out Christian telling a skeptical Roxane about something:
   now Roxane is confused;
   say "Christian turns to [the noun]. 'I must tell you about [the topic understood],' he says, and comes to a halt, looking at you for further direction.
 
   Perhaps you'd better give him exact lines to say. Surely he can't mess up an instruction like 'say hello to Roxane.'" instead.
 
Carry out Christian asking a skeptical Roxane about something:
   now Roxane is confused;
   say "'So,' says Christian nervously to [the noun]. 'Did you know about [the topic understood]?' But Roxane merely seems puzzled." instead.
 
Carry out Christian telling a confused Roxane about something:
   now Roxane is annoyed;
   say "Christian begins rambling on witlessly about [the topic understood]." instead.
 
Carry out Christian asking a confused Roxane about something:
   now Roxane is annoyed;
   say "Christian puts another confused question about [the topic understood]." instead.

And now we have enough material to begin writing the scenes:

Courting Roxane is a scene. Courting Roxane begins when play begins. Courting Roxane ends in success when Roxane is wooed. Courting Roxane ends in failure when Roxane is annoyed.
 
When Courting Roxane ends in success:
   record "Seduction by Proxy" in the Table of Events;
   say "Roxane, deeply moved by this sentiment, invites Christian up to her balcony. He scrambles up the ivy and disappears into her bedroom; the last thing you hear is a girlish giggle from above.";
   now Roxane is nowhere; now Christian is nowhere;
   move the player to Empty Street.
 
When Courting Roxane ends in failure:
   record "Ruining Christian's Chances" in the Table of Events;
   say "Roxane sighs heavily and goes back into her room, slamming the door behind her.
 
'Thanks very much,' says Christian to you, striding off down the street.";
   now Roxane is nowhere; now Christian is nowhere;
   move the player to Empty Street.
 
Sulky Ramble is a scene. Sulky Ramble begins when Courting Roxane ends in success. Sulky Ramble ends when the time since Sulky Ramble began is 2 minutes. When Sulky Ramble ends: record "Wandering the Streets, Sulking" in the Table of Events.
 
Every turn during Sulky Ramble:
   say "You find yourself kicking fenceposts quite without thinking about it."
 
Smug Ramble is a scene. Smug Ramble begins when Courting Roxane ends in failure. Smug Ramble ends when the time since Smug Ramble began is 2 minutes. When Smug Ramble ends: record "Wandering the Streets, Exultant" in the Table of Events; say "Of course, you will regret this soon enough."
 
Every turn during Smug Ramble:
   say "You find yourself smiling fiercely at the moon."
 
To record (occurrence - text) in (target table - a table name):
   choose a blank row in the target table;
   now the event entry is the occurrence.
 
Table of Events

event
"A Duel of Insults"
 
with 30 blank rows.
 
The plot summary rule is listed instead of the announce the score rule in the carry out requesting the score rules.
 
This is the plot summary rule:
   say "The Plot So Far: [paragraph break]";
   let act number be 0;
   repeat through the table of Events:
      increment act number;
      say "  Act [act number]: [event entry][line break]".
 
Test me with "christian, ask roxane about love / christian, say your breath smells like ripe taleggio to roxane / score / z / z / score".

wi 10.8 Multiple endings
rb 11.4 Scoring

280. Goat-Cheese and Sage Chicken ★★★

Some games provide a FULL SCORE command that gives more information about the player's achievements than SCORE alone. Supposing we wanted to include a FULL SCORE in our game that gave the kind of score reading described in this chapter:

"Goat-Cheese and Sage Chicken"

Use scoring.

The story headline is "An interactive recipe"

Table of Tasks Achieved

Points	Citation	Time
3	"sauteeing onions"	a time
3	"reconstituting apricots"
1	"flattening chicken"
1	"unwrapping goat cheese"

To record (T - text) as achieved:

choose row with a citation of T in the Table of Tasks Achieved;

if there is no time entry:

now time entry is the time of day;

increase the score by the points entry.

Requesting the full score is an action out of world. Understand "full" or "full score" as requesting the full score.

Carry out requesting the full score:

if the score is 0, say "You have achieved nothing towards supper." instead;

repeat through the Table of Tasks Achieved in reverse time order:

say "[time entry]: [citation entry] ([points entry])."

Table of Rankings

Score	Rank
0	"Rank Amateur"
2	"would-be Bobby Flay"
5	"Alton Brown"
8	"Julia Child"

The Kitchen is a room. The description of the Kitchen is "Equipped with many familiar friends: refrigerator, stove, oven; countertop; cabinet for pans and bowls, and a drawer for your tools."

The stove is scenery in the kitchen. It is a supporter. The oven is a container. It is part of the stove. It is closed and openable. The stove's switch is a device. It is switched on. It is part of the stove. The oven's dial is a device. It is switched off. It is part of the oven.

A thing can be heatproof.

Instead of putting something which is not heatproof on the stove when the stove's switch is switched on:

say "You catch yourself just at the last minute: not a good idea to put [the noun] directly on the stove while it's turned on."

Instead of switching on the stove, try switching on the stove's switch. Instead of switching off the stove, try switching off the stove's switch. Instead of switching on the oven, try switching on the oven's dial. Instead of switching off the oven, try switching off the oven's dial.

Before switching on the oven's dial when the oven is open:

say "(closing the oven so that it will heat properly)[command clarification break]";

try closing the oven.

The frying pan is a heatproof unopenable open container on the stove.

The cabinet is a closed openable container in the kitchen. It is scenery. It contains an open unopenable container called a mixing bowl. It contains a portable supporter called a platter. An open unopenable heatproof container called a Calphalon baking dish is in the cabinet. The baking dish has the description "One of those marvelous pieces of kitchen equipment which goes on the stove or in the oven, as you will. The chief thing is never ever to touch it when it is hot, since the handles are metal and the heat retention excellent."

The counter is a supporter in the kitchen. It is scenery. The kettle is a heatproof openable closed container on the counter. Some water is in the kettle.

The water can be cool, warm, or boiling. The printed name of the water is "[water condition] water".

The refrigerator is a closed openable container in the kitchen. It is scenery. Understand "fridge" as the refrigerator.

An ingredient is a kind of thing.

Some onions, some apricots, and some sage are ingredients on the counter. A chicken breast, an egg, and goat cheese are ingredients in the refrigerator.

The goat cheese can be wrapped, snipped open, or unwrapped. The printed name of the goat cheese is "[goat cheese condition] goat cheese".

The sage can be unwashed, clean, or julienned. The sage is unwashed. The printed name of the sage is "[sage condition] sage".

The apricots can be dried, reconstituted, or chopped. The apricots are dried. The printed name of the apricots is "[apricots condition] apricots".

The chicken breast can be whole, flattened, stuffed, rolled, coated, browned, or baked. The printed name of the chicken breast is "[chicken breast condition] chicken breast".

The onions can be unpeeled, peeled, diced, sauteed, or burnt. [The printed name of the onions is "[onions condition] onions".]

The can of chicken broth is a closed container on the counter. The bottle of white cooking wine and the bottle of Thurston Wolfe PGV are a closed containers in the refrigerator.

The description of the Thurston Wolfe is "A Washington State Pinot Gris-Viognier, 2003. It is said to have 'peach aromas', and, startlingly, the untutored person can detect these without resorting to fantasy.

(It is also supposed to possess a delicate perfume and a moderate body; the label author at least stopped short of 'good sense of humor and likes long walks on the beach')."

Understand the commands "wash" and "rinse" as "clean".

Instead of rubbing the unwashed sage:

now the sage is clean;

say "You rinse off the sage. There -- ready to slice."

Instead of cutting the sage:

say "You'd need to have a knife in hand, first."

Instead of cutting the clean sage when the player is carrying the butcher knife:

now the sage is julienned;

say "You slice the sage into thin strips."

Instead of cutting the unwashed sage:

say "It came from the garden, so it won't have any strange chemicals on it, but you should still give it a rinse for dirt and bugs and so on before using it."

Instead of doing something other than examining or rubbing with the unwashed sage:

say "It needs to be washed off."

Understand "peel [something]" as peeling.

Peeling is an action applying to one thing.

Instead of peeling the unpeeled onions:

now the onions are peeled;

say "You tear away the shining outer skin of the onions, leaving them pale and nekkid. Poor things."

Instead of cutting the diced onions:

say "That seems unnecessary now."

Instead of cutting the sauteed onions:

say "Too late; you're well past that stage."

Instead of cutting the burnt onions:

say "There's no rescuing 'em -- the carbon isn't going to flake off, you know."

Instead of cutting the unpeeled onions:

say "It would help to peel them first."

Instead of cutting the peeled onions:

say "You'd need to have a knife in hand, first."

Instead of cutting the peeled onions when the player is carrying the butcher knife:

now the onions are diced;

say "You dice the onions neatly. Your own skill brings tears to your eyes."

Instead of opening the goat cheese:

try peeling the goat cheese instead.

Instead of peeling the unwrapped goat cheese:

say "The goat cheese is already unwrapped. (Stay focused, stay focused...)"

Before peeling the wrapped goat cheese when the shears are held by the player:

try cutting the goat cheese.

Instead of peeling the snipped open goat cheese:

now the goat cheese is unwrapped;

record "unwrapping goat cheese" as achieved;

say "Ah, success. The goat cheese is now free of its packet."

Instead of peeling the wrapped goat cheese:

say "It would help to have a pair of scissors or something -- the packet resists being torn."

Instead of cutting the goat cheese:

say "No need, at this point."

Before cutting the wrapped goat cheese when the shears are not held by the player and the shears are visible:

say "(first picking up the shears)[command clarification break]";

try taking the shears.

Instead of cutting the wrapped goat cheese:

say "Something to cut with would be useful."

Instead of cutting the wrapped goat cheese when the shears are held by the player:

now the goat cheese is snipped open;

say "You neatly snip through the packaging with the shears."

Instead of examining the whole chicken breast:

say "It is still entire and has yet to be pounded flat."

Instead of examining the flattened chicken breast:

say "It has been hammered to a thickness of about a half inch. (The recipe said a quarter inch but you're pretty sure it was joking. You have never been able to achieve a quarter inch.)"

Instead of attacking the whole chicken breast:

say "You need something heavy enough to flatten it with."

Instead of attacking the whole chicken breast when the player is holding the wooden mallet:

now the chicken breast is flattened;

record "flattening chicken" as achieved;

say "You hammer away at the chicken breast, turning all your aggressions into culinary goodness. Several minutes pass. When you are done you have a broad flat chickeny pancake suitable for wrapping about a stuffing."

Before printing the name of onions:

say "[onions condition] ".

The drawer is an openable closed container. It is part of the counter.

A tool is a kind of thing. A spatula, a spoon, a wooden mallet, some shears, and a ball of twine are tools in the drawer. A butcher knife is a tool carried by the player. Understand "scissors" as the shears.

Instead of burning something:

say "You'll have to do that the hard way."

Some steam is fixed in place. "Dense clouds of steam fill the room."

Some smoke is fixed in place. "Smoke is beginning to collect near the ceiling."

Sauteeing Onions is a scene. Sauteeing Onions begins when the diced onions are in a hot container.

Definition: a container is hot if it is on the stove and the stove's switch is switched on.

Instead of touching the hot pan:

say "Ow!"

Scorching Onions is a scene.

Preheating the Oven is a scene. Preheating the Oven begins when the oven's dial is heating.

Definition: a oven's dial is heating if the oven's dial has been switched on for exactly one turn.

Preheating the Oven ends when the time since Preheating the Oven began is five minutes.

When Preheating the Oven begins:

say "The oven begins to warm up."

When Preheating the Oven ends:

say "The oven beeps to inform you that it has reached the desired hotness."

Every turn during Sauteeing Onions:

say "The onions sizzle in the pan."

Every turn during Scorching Onions:

say "The onions are past their prime and are getting blacker by the moment."

Every turn during Hearing the Kettle Whistle:

say "The kettle continues to whistle."

Instead of listening to during Hearing the Kettle Whistle:

say "The only thing you can really hear just at the moment is the kettle."

Instead of smelling the Kitchen during Sauteeing Onions:

try smelling the onions.

Instead of smelling the onions during Sauteeing Onions:

say "The onions smell marvelous."

Instead of opening the oven during Preheating the Oven:

say "It'll never heat if you open it up while it's warming."

Heating Kettle is a scene. Heating Kettle begins when the hot kettle contains cool water.

Before printing the name of the kettle when the kettle is hot:

say "hot "

When Heating Kettle begins:

say "The kettle begins to heat up."

Heating Kettle ends when the time since Heating Kettle began is 7 minutes.

Hearing the Kettle Whistle is a scene. Hearing the Kettle Whistle begins when Heating Kettle ends. Hearing the Kettle Whistle ends when the kettle is not hot.

When Hearing the Kettle Whistle begins:

now the water is boiling;

say "The kettle begins to burble and whistle shrilly."

When Hearing the Kettle Whistle ends:

say "The kettle's screaming dies off."

Idling is a scene. Idling begins when play begins. Idling ends when Sauteeing Onions begins.

Sauteeing Onions ends in disaster when Scorching Onions begins.

Sauteeing Onions ends in success when the onions are sauteed and onions are not in a hot container.

Definition: a thing is alone if it is in a container which contains exactly one thing.

Sauteeing Onions ends in mixture when the sauteed onions are not alone.

When Sauteeing Onions ends in mixture:

say "The mixture of things in [the holder of the onions] stops them cooking quite so fast."

When Sauteeing Onions ends in success:

say "Nice work with the onions."

Every turn:

if diced onions have been in a hot pan for ten turns:

say "The onions are starting to look ready.";

now the onions are sauteed.

Scorching Onions begins when Sauteeing Onions ends in disaster. Scorching Onions begins when the alone sauteed onions are in a hot container.

Scorching Onions ends horribly when the time since Scorching Onions began is three minutes. Scorching Onions ends in reprieve when the sauteed onions are not in a hot container. Scorching Onions ends in mixture when the sauteed onions are not alone.

When Scorching Onions ends in mixture:

record "sauteeing onions" as achieved;

say "The mixture of things in [the holder of the onions] stops them cooking quite so fast."

When Scorching Onions ends horribly:

move smoke to Kitchen;

now the onions are burnt.

When Scorching Onions ends in reprieve:

record "sauteeing onions" as achieved;

say "You've got the onions off heat before they can scorch -- a good sign."

Instead of taking the onions when the onions are in the pan: try taking the pan.

Instead of smelling in the presence of the smoke:

say "The scent of the late disaster lingers in the air."

Reconstituting the Apricots is a scene.

Reconstituting the Apricots begins when the dried apricots are in a container which contains boiling water.

When Reconstituting the Apricots begins:

say "The apricots slowly begin to plump up again."

Reconstituting the Apricots ends when the dried apricots are not in a container which contains boiling water.

Every turn:

if dried apricots have been in a container which contains boiling water for ten turns:

say "The apricots have turned plump(ish).";

now the apricots are reconstituted;

record "reconstituting apricots" as achieved.

Test sautee with "peel onions / cut onions / get onions / put onions in pan / get sage / wash sage / cut sage / wait / wait / wait / wait / wait / wait / wait / get pan".

Test apricots with "get kettle / open kettle / get apricots / put apricots in kettle / put kettle on stove / wait / wait / wait / wait / wait / wait / wait / wait / wait / wait / wait / wait / wait / wait / wait / wait / wait".

Test chicken with "open refrigerator / get chicken / open drawer / get mallet / hit breast".

Test cheese with "get scissors / get cheese / unwrap cheese".

Test me with "full score / test sautee / full score / test apricots / full score / test chicken / full score / test cheese / full score".

And… at that point you're a lot less close to being done than you think. The filling -- onions, sage, apricot, and cheese -- must be assembled and put in the chicken breasts; these tied up in string; each roll dipped in egg yolk and rolled in panko crumbs; these arranged in the Calphalon pan and baked. Then later, the whole retrieved from the oven, and the breasts transferred to a plate while we deglaze the pan and concoct the sauce with the chicken broth, wine, butter, etc. Then the chicken is sliced and plated, and the sauce poured over top. Usually one also wants a side dish or two. A number of things can go interestingly wrong in this process, of course, and implementing it would require, among other things, an intelligent management of all the possible mixtures that result.

wi 16.14 Another scoring example
rb 11.4 Scoring

441. Rubies ★★★

The trick here is that we need a table with text in order to keep track of the players' names.

Part 1 largely replicates the source from "Identity Theft"; new material starts at Part 2.

"Rubies"

Use scoring.

Part 1 - Collecting Names

The player's forename is a text that varies. The player's full name is a text that varies.

When play begins:

now the command prompt is "What is your name? > ".

To decide whether collecting names:

if the command prompt is "What is your name? > ", yes;

no.

After reading a command when collecting names:

if the number of words in the player's command is greater than 5:

say "[paragraph break]Who are you, a member of the British royal family? No one has that many names. Let's try this again.";

reject the player's command;

now the player's full name is the player's command;

now the player's forename is word number 1 in the player's command;

now the command prompt is ">";

say "Hi, [player's forename]!";

say "[banner text]";

move the player to the location;

reject the player's command.

Instead of looking when collecting names: do nothing.

Rule for printing the banner text when collecting names: do nothing.

Rule for constructing the status line when collecting names: do nothing.

Part 2 - Adding the Leaderboard

File of Leaderboard is called "leaderboard".

When play begins:

if the File of Leaderboard exists:

read File of Leaderboard into the Table of Leaders;

sort the Table of Leaders in reverse scored amount order.

When play ends:

choose row 10 in the Table of Leaders; [we've sorted the table, so the lowest score will be the one at the bottom]

if the score is greater than scored amount entry:

now name entry is the player's forename;

now the scored amount entry is the score;

show leaderboard;

write the File of Leaderboard from the Table of Leaders.

To show leaderboard:

sort the Table of Leaders in reverse scored amount order;

say "Current leading scores: [paragraph break]";

say fixed letter spacing;

repeat through Table of Leaders:

if scored amount entry is greater than 0:

say " [name entry]";

let N be 25 minus the number of characters in name entry; [here we want to space out the scores so they make a neat column]

if N is less than 1, now N is 1;

say N spaces;

say "[scored amount entry][line break]";

say variable letter spacing.

To say (N - a number) spaces:

repeat with index running from 1 to N:

say " ".

Table of Leaders

scored amount	name
0	"Smithee"
0	"Smithee"
0	"Smithee"
0	"Smithee"
0	"Smithee"
0	"Smithee"
0	"Smithee"
0	"Smithee"
0	"Smithee"
0	"Smithee"

And now we introduce a scenario that allows different players to come up with different scores -- admittedly not a very interesting scenario, but it will do for now:

Part 3 - Scenario
 
Carry out taking something which is not handled:
   increment score.
 
The Big Treasure Chamber is a room. It contains a ruby, an emerald, a gold tooth, an antique katana, and a silver coin.
 
Instead of waiting, end the story finally.
 
Test me with "get ruby / z".

wi 23.13 Writing and reading tables to external files
rb 11.4 Scoring

🔗

RB §11.5 Settings and Status Checks During Play

Several default actions allow the player some control over the presentation of the story, or permit the player to request information about what is going on. In addition to the standard commands described elsewhere in this section (SCORE, SAVE, UNDO, QUIT, RESTART, and RESTORE), Inform has the following actions that control the player's experience:

Preferring abbreviated room descriptions (SUPERBRIEF)
Preferring unabbreviated room descriptions (VERBOSE)
Preferring sometimes abbreviated room descriptions (BRIEF)
Switching score notification on (NOTIFY ON)
Switching score notification off (NOTIFY OFF)

The first three of these allow the player to change the way rooms are described on first and subsequent versions; the last two, when used in a story that provides a score feature, toggle on and off reports such as "[Your score has just gone up by three points.]" These are discussed elsewhere in the Recipe Book (see cross-references below).

These provide immediate feedback about the status of the story file being played:

Verifying the story file (VERIFY)
Requesting the story file version (VERSION)
Requesting the pronoun meanings (PRONOUNS)

VERIFY examines checksums to make sure that the story file being run is intact and correct. This is less often an issue now than it was in the days when story files were distributed by highly corruptible floppy disk, but the command persists and is very occasionally useful. VERSION gives the full banner text associated with the story, including title, author, release number, IFID, and other bibliographical data; it follows this with a list of the included extensions.

PRONOUNS announces to the player what the story is currently understanding as the antecedents of "him", "her", "it", and "them". This is often useful during testing, but sometimes also during play.

The following allow the player (when supported by his interpreter) to create a log of play:

Switching the story transcript on (TRANSCRIPT ON)
Switching the story transcript off (TRANSCRIPT OFF)

It is rarely a good idea to change the default performance of such commands: they are often finicky and closely tied to the interpreter in which the story runs. Moreover, disabling the "version" command means that the story file is not able to display attribution information for Inform and any included extensions, in violation of their respective licenses.

RB §11.6 Ending The Story

Play can end in many ways, at the writer's discretion:

end the story;
end the story finally;
end the story saying "You have reached an impasse, a stalemate";
end the story finally saying "You have succeeded.";

The phrase "end the story" by itself will finish play, printing "*** The End ***". Using one of the phrases with "saying…" allows us to specify some other text with which to conclude. Including "finally" means that the player has earned access to AMUSING text and other notes, if any of these are provided.

We can eliminate the asterisked headline entirely by removing the rule that prints it, thus:

The print obituary headline rule is not listed in any rulebook.

The next step is to print the player's score and, if applicable, the rank he achieved. By default a story doesn't feature scoring, but the following use option will incorporate it:

Use scoring.

Then, if we want to allow a score but alter the way it is reported, we may remove or modify the print final score rule, as in

The print final score rule is not listed in any rulebook.

or perhaps something like

The chatty final score rule is listed instead of the print final score rule in for printing the player's obituary.
 
This is the chatty final score rule: say "Wow, you achieved a whole [score in words] point[s] out of a possible [maximum score in words]! I'm very proud of you. This was a triumph. I'm being so sincere right now."

What happens next is normally that the player is invited to RESTART, RESTORE (from a saved story), QUIT or UNDO the last command. The presence of the question can somewhat undercut a tragedy, and Battle of Ridgefield ★ shows another way to go out.

If we do leave the question in, the text is formed by the Table of Final Question Options, which by default looks like this:

Table of Final Question Options

final question wordingonly if victorioustopicfinal response rulefinal response activity
"RESTART"false"restart"immediately restart the VM rule--
"RESTORE a saved story"false"restore"immediately restore saved story rule--
"see some suggestions for AMUSING things to do"true"amusing"--amusing a victorious player
"QUIT"false"quit"immediately quit rule--
"UNDO the last command"false"undo"immediately undo rule--

Because this is a table, we may alter the behavior by changing entries or continuing the table. Finality ★ shows how we might take out the option to UNDO the last command, for instance.

Using an ending phrase that includes "finally" tells Inform to include the options that are marked "only if victorious". One common use is to let the player read some special bit of additional text, perhaps describing easter eggs he might have missed in the story or presenting some authorial notes. Xerxes ★★ demonstrates a simple AMUSING command to read final information, while Jamaica 1688 ★ shows how to add completely new elements to the list of options.

Old-school adventures expected their adventurers to die early and die often. Labyrinth of Ghosts ★★ shows how the residue of such past attempts can be preserved into subsequent attempts, using an external file. Big Sky Country ★★★ shows how a player can be resurrected by, let us say, some beneficent god, so that a player can even die more than once in the same attempt.

Examples

383. Battle of Ridgefield ★

Occasionally, a piece of IF is sufficiently serious that it feels bathetic to offer the player the usual restore-restart-undo-quit options at the end. The following would replace "*** You have died ***" with a centered epitaph, then quit the game when the player hits a key.

This example relies on a standard extension to avoid any fancy programming:

"Battle of Ridgefield"

Include Basic Screen Effects by Emily Short.

Ridgefield is a room.

Instead of doing something when the turn count is greater than 1: say "Alas, you no longer have the strength."; end the story.

Rule for printing the player's obituary:

say paragraph break;

center "In defense of American Independence";

center "at the Battle of Ridgefield, April 27, 1777,";

center "died Eight Patriots who were laid in this ground,";

center "Companioned by Sixteen British Soldiers,";

center "Living, their enemies,";

center "Dying, their guests";

say paragraph break;

wait for any key;

stop game abruptly;

rule succeeds.

wi 18.38 Printing the player's obituary
rb 11.6 Ending The Story

384. Finality ★

By default, Inform reminds the player that he has the option of typing UNDO after a story-ending action. This is generally good practice, especially for the sake of novice players who might not be aware of this possibility otherwise, and might be frustrated by a loss they could easily step back from.

Just occasionally, though, we may decide that the player does not deserve any such notification:

"Finality"

Cliff Edge is a room. "This narrow strip overlooks a gorge many hundreds of feet deep, at whose bottom is a river of molten lava. The walls of the gorge are lined with poison-tipped spikes. Furthermore, the birds that inhabit this valley spit balls of fire. Good thing you're safe up here."

The Table of Final Question Options determines what options are to be given to the player after the story ends. We can change what is mentioned there by altering the entries. (The example Jamaica 1688 explains this table in more detail, and demonstrates some other things that we might do with it.)

When play begins:
   choose row with a final response rule of immediately undo rule in the Table of Final Question Options;
   blank out the final question wording entry.
 
Instead of jumping:
   say "If you insist.";
   end the story.

And if we decided that we didn't want the player to be able to undo the command at all, we should add the use option

Use undo prevention.
 
Test me with "jump".

wi 18.38 Printing the player's obituary
rb 11.6 Ending The Story

385. Jamaica 1688 ★

The options offered to the player at the end of the game are listed in the Table of Final Question Options, which means that we can add to them simply by continuing the table; what's more, the table gives us the opportunity to create a "final response rule", a rule that the game should follow in order to parse the player's input at this point.

So, for instance, if we wanted the player to be allowed to ask for notes about any of the rooms, characters, or objects in a historical game:

"Jamaica 1688"

Use scoring.

Section 1 - Procedure

Table of Final Question Options (continued)

final question wording	only if victorious	topic	final response rule	final response activity
"REVEAL the inspiration for something or somewhere"	true	"reveal [any thing]"	investigate something rule	--
--	true	"reveal [any room]"	investigate something rule	--

This is the investigate something rule:

repeat through the Table of Footnotey Stuff:

if the player's command matches the topic entry:

say "[revelation entry][paragraph break]";

rule succeeds;

say "I'm afraid I have no revelation to vouchsafe there."

Section 2 - Scenario

The Upper Deck is a room. Lucius is a man in the Upper Deck.

The maximum score is 501.

When play begins: now the score is 501; end the story finally.

Table of Footnotey Stuff

topic	revelation
"reveal [Lucius]"	"Lucius is based on a historical buccaneer who sailed with William Dampier. The original did carry a Greek New Testament, from which he read aloud when the men were stranded in the jungles near Panama."
"reveal [Upper Deck]"	"The Callisto is a simplified and tidied representation of a pirate sloop ca. 1688."

wi 18.38 Printing the player's obituary
rb 11.6 Ending The Story

386. Xerxes ★★

Building a menu is moderately tedious, so we will rely on the standard menu extensions provided. Thus:

"Xerxes"

Include Basic Screen Effects by Emily Short. Include Menus by Emily Short.

Table of Amusing Matter

title	subtable	description	toggle
"Cult Revisions"	--	"Did you try... [paragraph break] banning the worship of Seth? [line break] of Dionysus? [line break] assigning all your priests to Re? [line break] assigning male priests to Cybele? [line break] assigning married priestesses to Hestia? [line break] identifying one god as another (e.g., Isis and Hecate)? [line break] identifying a mortal as a god (e.g., Alexander as Helios-Apollo)?"	--
"Military Revisions"	--	"Did you try... [paragraph break] allying a Greek city-state with the Persians? (try >MEDIZE) [line break] playing Athens as a land-based power?"	--

Rule for amusing a victorious player:

now the current menu is the Table of Amusing Matter;

now the current menu title is "Things to Try";

carry out the displaying activity;

clear the screen.

Omitting about a half million words from this rigorous and educational but nonetheless enthralling simulation of centuries of history, culture, and religion, we will skip directly to:

Athens is a room.
 
Use scoring.
 
Every turn:
   if the score is greater than 10000, end the story finally.
 
When play begins: now the score is 10001.
 
Test me with "z".

wi 18.39 Amusing a victorious player
rb 11.6 Ending The Story

440. Labyrinth of Ghosts ★★

A tradition among Nethack-like computer games of the old school is that a player's death in a given place leaves a ghost behind to haunt subsequent players. Information about past lives is sometimes stored in a "bones file", and in this example we do exactly that, for a grievously unfair little dungeon.

To begin with, the labyrinth itself. We create a kind of value to remember possible means of death in these tunnels, and we assign a coordinate position in some grid to each location. (We do this because grid positions can safely be stored in tables saved out to external files, whereas room names cannot - they represent data which changes each time we amend the source.)

"Labyrinth of Ghosts"

Use scoring.

A demise is a kind of value. The demises are drowned, buried by a rockfall, pierced by an arrow and slain. The latest demise is a demise that varies.

A grid location is a kind of value. (1,19) specifies a grid location. A room has a grid location called coordinates.

The Gateway is a room. "For the foolhardy adventurer, the perilous labyrinth lies north, east or south." The coordinates are (6,6). The Tomb is east of the Gateway. The coordinates are (7,6). The Rockfall Cave is north of the Gateway. "This partly fallen cave may perhaps extend further north." The coordinates are (6,5). Instead of going north in the Rockfall Cave, have the player buried by a rockfall. The Archery Canyon is south of the Gateway. "No telling why this canyon is named after archery, but perhaps if you wait around you'll find out." The coordinates are (6,7). Instead of waiting in the Archery Canyon, have the player pierced by an arrow. The Rock Pool is east of the Tomb. The coordinates are (8,6). The cold mountain pool is in the Rock Pool. The cold pool is fixed in place. Instead of entering the cold mountain pool, have the player drowned.

Every turn when a random chance of 1 in 10 succeeds:

say "A dwarf appears out of nowhere, and throws a nasty little knife.";

have the player slain.

And as compensation for these hazards:

Some silver bars are in the Tomb. The emerald is in the Rock Pool. The platinum pyramid is in the Canyon.
 
Table of Point Values

itemscore
silver bars3 
platinum pyramid10 
emerald4 
 
Report taking an item listed in the Table of Point Values:
   increase the score by the score entry;
   blank out the whole row.

We are now ready for the actual undertaking. The Table of Ghostly Presences holds up to twenty death notices, and is initially blank. Deaths are sequentially numbered, and this number is stored in the sequence column.

Table of Ghostly Presences

haunted positionscore at deathturns at deathmanner of deathsequence
a grid locationa numbera numbera demisea number
with 19 blank rows.

As the story file starts up, we look to see if a ghosts file already exists. If one does, we load up the Table of Ghostly Presences with it: and if not, as will be the case the first time the player explores, we leave the table blank. We sort the table so that it has earlier deaths (lower sequence numbers) first.

The File of Ghosts is called "ghosts".
 
When play begins:
   if the File of Ghosts exists, read File of Ghosts into the Table of Ghostly Presences;
   sort the Table of Ghostly Presences in sequence order.

How will ghosts manifest themselves? Because this is only a small example, we will simply tell the player that he senses something. If several ghosts are present in the same place, the most aggrieved (that is, the most recent) is sensed first…

After looking:
   repeat through the Table of Ghostly Presences in reverse sequence order:
      if the haunted position entry is the coordinates of the location, say "You sense the ghostly presence of an adventurer, [manner of death entry] with a score of [score at death entry] in [turns at death entry] turns."

(For instance, "You sense the ghostly presence of an adventurer, buried by a rockfall with a score of 10 in 5 turns.") That just leaves the rule for bumping off the player. When the Table is full, and there are already 20 ghosts, the one who died longest ago (with the lowest sequence count) is eliminated, and his row blanked out. (This will always be row 1 since we sorted the table in sequence order on reading it in.)

To have the player (sticky end - a demise):
   let the new sequence number be 0;
   repeat through the Table of Ghostly Presences:
      let S be the sequence entry;
      if S is greater than the new sequence number, let the new sequence number be S;
   increment the new sequence number;
   if the number of blank rows in the Table of Ghostly Presences is 0:
      choose row 1 in the Table of Ghostly Presences;
      blank out the whole row;
   choose a blank row in the Table of Ghostly Presences;
   now the sequence entry is the new sequence number;
   now the manner of death entry is the sticky end;
   now the turns at death entry is the turn count;
   now the score at death entry is the score;
   now the haunted position entry is the coordinates of the location;
   write the File of Ghosts from the Table of Ghostly Presences;
   now the latest demise is the sticky end;
   end the story saying "You have been [latest demise]".

Strictly speaking we ought to worry that after 2,147,483,647 deaths, the sequence numbers would grow too large to store in a single value, and then the sequence of ghosts will be erratic. But it seems unlikely that anyone will play this example 2.1 billion times.

wi 23.13 Writing and reading tables to external files
rb 11.6 Ending The Story

138. Big Sky Country ★★★

Some older games allowed the player to be resurrected after a death, but punished him by distributing his possessions far and wide. Here we emulate that effect.

"Big Sky Country"

Use scoring.

When play begins: say "There's a bit of a drive over from Anaconda, Montana, and then through a couple or three ghost towns, but finally you find what you're looking for, and strike out on foot..."

Entrance to Devil's Canyon is a room. "You are at the top of a steep road, which proceeds down into the canyon proper." A sign is in Devil's Canyon. It is fixed in place. "An ominous sign has been put up by the local sheriff's office." The description is "PROCEED AT OWN RISK - NO RESCUES!"

Instead of going down when a random chance of 1 in 3 succeeds:

say "Whoooops, your footing is not as secure as you thought...";

end the story.

Dusty Path is below Entrance. "A dusty path, with grey-brown thorny bushes on either side. Immediately to your right is a sheer drop; far below you can see the rusting remains of a Model T that some fool tried to drive by here."

Hairpin is below Dusty Path. "A sharp bend in the road, doubling back down towards the bottom of the canyon. Just north of here there is also a small cavern of some kind[if the stick pin is in the cavern], which attracts your eye with some glittery thing[end if]."

The Cavern is north of Hairpin. "Really not much more than a little hollow in the side of the canyon." In the cavern are a snake and a diamond stick pin. The snake is an animal. The description of the snake is "You're no expert, but it looks like a rattler."

Instead of taking the diamond stick pin in the presence of the snake: say "Turns out the snake is partial to that there pin, and takes exception to your intending to make off with it."; end the story.

In a fuller implementation of this game, we might make it possible to get by the snake, but in this version, it's just going to remain troublesome.

Crooked Path is below Hairpin. "You're about two thirds of the way down to the bottom of the cavern at this point."
 
At the Spot is below Crooked Path. "This'll be it: a bare patch of ground that might as well have an X painted right on it."
 
Rule for supplying a missing noun while digging:
   now noun is the location.
 
Understand "dig" or "dig hole/here" or "dig in ground/dirt/earth" as digging. Digging is an action applying to one thing.
 
Instead of digging at the spot:
   say "You dig and dig, and after a half hour or so, sure enough, you do turn up a big box of gold! You're going to be richer than God and Bill Gates put together.";
   increase the score by 5;
   end the story finally.
 
Instead of digging at the spot when the player does not carry the shovel:
   say "What, without your shovel? That won't work too well."
 
The player carries a walking stick. The player wears a hat, a whistle, and a daypack. The daypack contains a mylar blanket, a granola bar, a cellular phone, a water bottle, a folding shovel, and a photocopied map. The granola bar is edible. Instead of drinking the water, say "You quench your thirst, for the time being." The description of the map is "The map shows the winding path of Devil's Canyon, with a large X down by the south end. That would be where your uncle Jesse buried the gold from the train robbery."
 
The maximum score is 5.
 
When play ends when the story has not ended finally:
   say "Oh dear, that ought to be fatal! However, if you like I can get you out of it...
 
   Shall I? >";
   if the player consents:
      repeat with item running through things had by the player:
         move the item to a random visited room;
      say "A strong wind picks you up and sets you back at [the location], though perhaps minus a few of your things.";
      resume the story;
      try looking.

"If the player consents" is just a convenient way to ask a yes/no question that the player must answer before going on with the game.

wi 9.4 When play ends
rb 11.6 Ending The Story

Element	Symbol	Atomic number	Atomic weight
"Hydrogen"	"H"	1	1
"Iron"	"Fe"	26	56
"Zinc"	"Zn"	30	65
"Uranium"	"U"	92	238

Element	Symbol	Atomic number	Atomic weight
"Hydrogen"	"H"	1	1
"Iron"	"Fe"	26	56
"Zinc"	"Zn"	30	65
"Uranium"	"U"	92	238

Element	Symbol	Atomic number	Atomic weight
"Hydrogen"	"H"	1	1
"Iron"	"Fe"	26	56
"Zinc"	"Zn"	30	65
"Uranium"	"U"	92	238

Name	Accession	Family
"Anne"	1702	Stuart
"George I"	1714	Hanover
"George II"	1720	Hanover
"George III"	1760	Hanover
"George IV"	1820	Hanover
"William IV"	1830	Hanover
"Victoria"	1837	Hanover
"Edward VII"	1901	Saxe-Coburg-Gotha
"George V"	1910	Windsor
"Edward VIII"	1936	Windsor
"George VI"	1936	Windsor
"Elizabeth II"	1952	Windsor

Element	Symbol	Atomic number	Atomic weight
"Hydrogen"	"H"	1	1
"Iron"	"Fe"	--	56
"Zinc"	--	30	65
"Uranium"	"U"	92	238

Score	Rank
0	"Beginner"
25	"Amateur Adventurer"
50	"Novice Adventurer"
100	"Junior Adventurer"
200	"Adventurer"
300	"Master"
330	"Wizard"
350	"Master Adventurer"

Index	Comment
1	"Originally row 1"
2	"Originally row 2"
2	"Originally row 3"
3	"Originally row 4"

Topic	Muse
"calliope"	"epic poetry"
"clio"	"history"
"erato"	"love poetry"
"euterpe"	"music"
"melpomene"	"tragedy"
"polyhymnia"	"sacred poetry"
"terpsichore"	"dancing"
"thalia"	"comedy"
"urania"	"astronomy"
"monica"	"tidiness"
"phoebe"	"massage"
"rachel"	"oval hair-cuts"

jersey	year established	citation
a yellow jersey	1919	"race leader"
a polkadot jersey	1933	"King of the Mountains"
a green jersey	1953	"highest point scorer on sprints"
a white jersey	1975	"best cyclist aged 25 or less"

planet	semimajor axis
Jupiter	5 AU
Saturn	10 AU
Uranus	19 AU
Neptune	30 AU
Pluto	39 AU

planet	semimajor axis	centre of government
Jupiter	5 AU	Jupiter
Saturn	10 AU	Saturn
Uranus	19 AU	Saturn
Neptune	30 AU	Pluto
Pluto	39 AU	Pluto

planet	semimajor axis
Orcus	39 AU
Quaoar	43 AU
Xena	68 AU
Sedna	524 AU

moment	outcome
10 AM	"takeover of Mars"
11:30 AM	"canals reflooded"
11:45 AM	"chocolate bar production doubled"

feeling	extent	consequence
pumped	1	"you feel able to run for your life"
pumped	2	"you feel able to run for President"
wired	1	"you feel able to run"
languid	1	"you feel"

^	Matches (accepting no text) only at the start of the text
$	Matches (accepting no text) only at the end of the text
\b	Word boundary: matches at either end of text or between a \w and a \W
\B	Matches anywhere where \b does not match

Points	Citation	Time
1	"pride"	a time
3	"anger"
2	"avarice"
4	"envy"
1	"lust"
2	"gluttony"
3	"sloth"

word	score
"quartzy"	126
"squeezy"	126

recipe	ingredients
"duck à l'orange"	{the duck, the orange}
"spiced cider"	{the cider, the cinnamon, the orange}

\char	If char is other than a-z, A-Z, 0-9 or space, matches that literal char
\\	For example, this matches literal backslash "\"
\n	Matches literal line break character
\t	Matches literal tab character (but use this only with external files)

\d	Matches any single digit
\l	Matches any lower case letter (by Unicode 4.0.0 definition)
\p	Matches any single punctuation mark: . , ! ? - / " : ; ( ) [ ] { } \sMatches any single spacing character (space, line break, tab) \uMatches any upper case letter (by Unicode 4.0.0 definition) \wMatches any single word character (neither \p nor \s) \DMatches any single non-digit \LMatches any non-lower-case-letter \PMatches any single non-punctuation-mark \SMatches any single non-spacing-character \UMatches any non-upper-case-letter \WMatches any single non-word-character (i.e., matches either \p or \s)

.	Matches any single character
<...>	Character range: matches any single character inside
<^...>	Negated character range: matches any single character not inside

e-h	Any character in the run "e" to "h" inclusive (and so on for other runs)
>...	Starting with ">" means that a literal close angle bracket is included
\	Backslash has the same meaning as for backslashed character classes: see above

\|	Divides alternatives: "fish\|fowl" matches either
(?i)	Always matches: switches to case-insensitive matching from here on
(?-i)	Always matches: switches to case-sensitive matching from here on

...?	Matches "..." either 0 or 1 times, i.e., makes "..." optional
...*	Matches "..." 0 or more times: e.g. "\s*" matches an optional run of space
...+	Matches "..." 1 or more times: e.g. "x+" matches any run of "x"s
...{6}	Matches "..." exactly 6 times (similarly for other numbers, of course)
...{2,5}	Matches "..." between 2 and 5 times
...{3,}	Matches "..." 3 or more times
....?	"?" after any repetition makes it "lazy", matching as few repeats as it can

(...)	Groups part of the expression together: matches if the interior matches
\1	Matches the contents of the 1st subexpression reading left to right
\2	Matches the contents of the 2nd, and so on up to "\9" (but no further)

(# ...)	Comment: always matches, and the contents are ignored
(?= ...)	Lookahead: matches if the text ahead matches "...", but doesn't consume it
(?! ...)	Negated lookahead: matches if lookahead fails
(?<= ...)	Lookbehind: matches if the text behind matches "...", but doesn't consume it
(?<! ...)	Negated lookbehind: matches if lookbehind fails
(> ...)	Possessive: tries to match "..." and if it succeeds, never backtracks on this
(?(1)...)	Conditional: if \1 has matched by now, require that "..." be matched
(?(1)...\|...)	Conditional: ditto, but if \1 has not matched, require the second part
(?(?=...)...\|...)	Conditional with lookahead as its condition for which to match
(?(?<=...)...\|...)	Conditional with lookbehind as its condition for which to match

\char	If char is other than a-z, A-Z, 0-9 or space, expands to that literal char
\\	In particular, "\\" expands to a literal backslash "\"
\n	Expands to a line break character
\t	Expands to a tab character (but use this only with external files)
\0	Expands to the full text matched
\1	Expands to whatever the 1st bracketed subexpression matched
\2	Expands to whatever the 2nd matched, and so on up to "\9" (but no further)
\l0	Expands to \0 converted to lower case (and so on for "\l1" to "\l9")
\u0	Expands to \0 converted to upper case (and so on for "\u1" to "\u9")

font	font (named in double-quotes)
minimum-map-width	integer (measured in points: 72 = 1 inch)
title	text (in double-quotes)
title-size	integer (measured in points)
title-font	font (named in double-quotes)
title-colour	colour (named in double-quotes)
map-outline	on/off
border-size	integer (measured in points)
vertical-spacing	integer (measured in points)
monochrome	on/off
annotation-size	integer (measured in points)
annotation-length	integer (length to abbreviate down to)
annotation-font	font (named in double-quotes)
subtitle	text (in double-quotes)
subtitle-size	integer (measured in points)
subtitle-font	font (named in double-quotes)
subtitle-colour	colour (named in double-quotes)
grid-size	integer (measured in points)
route-stiffness	integer (Bezier spline curve scale factor)
route-thickness	integer (measured in points)
route-colour	colour (named in double-quotes)
room-offset	offset (in percentages of grid-size)
room-size	integer (measured in points)
room-colour	colour (named in double-quotes)
room-name	text (in double-quotes)
room-name-size	integer (measured in points)
room-name-font	font (named in double-quotes)
room-name-colour	colour (named in double-quotes)
room-name-length	integer (length to abbreviate down to)
room-name-offset	offset (in percentages of grid-size)
room-outline	on/off
room-outline-colour	colour (named in double-quotes)
room-outline-thickness	integer (measured in points)
room-shape	shape (named in double-quotes)

Example

See Also

See Also

Examples

Examples

Examples

See Also

Example

Examples

Example

Example

Examples

See Also

Example

See Also

Examples

See Also

Examples

Examples

See Also

Examples

See Also

See Also

Examples

Example

Examples

See Also

Example

See Also

Example

Examples

Example

Example

Examples

Example

Examples

Example

Example

Examples

See Also

Examples

Example

Example

Examples

Example

Examples

Examples

Examples

Example

Example

Example

See Also

Examples

See Also

Example

Example

stellar object	example
galaxy	"Andromeda Galaxy M31"
star	"Sirius"
planet	"Neptune"
moon	"Enceladus"
dwarf planet	"Ceres"
plutino	"38628 Huya"
cubewano	"Easterbunny"

number	output
11	"X is eleven!"
12	"X is twelve!"
13	"X is thirteen!"

threshold	approximation
1	"no"
2	"one"
3	"a couple of"
6	"a few"
11	"some"
21	"many"
1000	"lots and lots of"

State	Topic	Comment
"Florida"	"1845"	"March 3rd"
"Delaware"	"1787"	"December 7th"
"Hawaii"	"1960"	"July 4th"

both	here	there
"From here, you make out [a list of mentionable things in the noun] a little way [chosen direction], and, further on, [a list of mentionable things in the second noun]."	"From here, you make out [a list of mentionable things in the noun] [if the noun is not adjacent to the location]some distance [end if]to [the chosen direction]."	"From here, you make out [a list of mentionable things in the second noun] some distance [chosen direction]."
"To [the chosen direction] there [is-are a list of mentionable things in the noun], partly obscuring your further view of [a list of mentionable things in the second noun]."	"To [the chosen direction] there [is-are a list of mentionable things in the noun]."	"Quite a way [chosen direction] [is-are a list of mentionable things in the second noun]."
"Then [chosen direction] [is-are a list of mentionable things in the noun], and beyond [a list of mentionable things in the second noun]."	"Meanwhile, to [the chosen direction] [is-are a list of mentionable things in the noun]."	"Meanwhile, [chosen direction] in the middle distance [is-are a list of mentionable things in the second noun]."
"When you turn [chosen direction], you see [a list of mentionable things in the noun], and somewhat further on [a list of mentionable things in the second noun]."	"When you turn [chosen direction], you see [a list of mentionable things in the noun]."	"If you turn [chosen direction], you see [a list of mentionable things in the second noun] some way off."
"Somewhere generally [chosen direction] [is-are a list of mentionable things in the noun], beyond which, [a list of mentionable things in the second noun]."	"Roughly [chosen direction] [is-are a list of mentionable things in the noun]."	"Moreover, in the [chosen direction] distance [is-are a list of mentionable things in the second noun]."
"[The chosen direction] shows [a list of mentionable things in the noun] and then [a list of mentionable things in the second noun]."	"And to [the chosen direction] [a list of mentionable things in the noun]."	"Meanwhile, [chosen direction] in the middle distance [is-are a list of mentionable things in the second noun]."
"Then, [chosen direction], [is-are a list of mentionable things in the noun], and beyond [a list of mentionable things in the second noun]."	"Meanwhile, to [the chosen direction] [is-are a list of mentionable things in the noun]."	"Meanwhile, [chosen direction] in the middle distance [is-are a list of mentionable things in the second noun]."
"Finally, [chosen direction], [is-are a list of mentionable things in the noun], somewhat nearer than [a list of mentionable things in the second noun]."	"Finally, to [the chosen direction] [is-are a list of mentionable things in the noun]."	"Finally, [chosen direction] in the middle distance [is-are a list of mentionable things in the second noun]."

Trade	nickname	family	Date attested
"architect"	"Robert"	"Snead"	1684
"baker"	"William"	"Wingar"	1683
"barber"	"William"	"Alcocke"	1676
"blacksmith"	"William"	"Davidson"	1679
"bricklayer"	"Samuel"	"Richardson"	1683
"butcher"	"John"	"Dennis"	1676
"carpenter"	"John"	"Albert"	1675
"cabinet-maker"	"Robert"	"Avis"	1666
"joiner"	"Peter"	"Bartaboa"	1666
"chandler"	"William"	"Bates"	1674
"chyrurgeon"	"William"	"Axtell"	1674
"chyrurgeon"	"Thomas"	"Trapham"	1678
"combmaker"	"Paul"	"Bennett"	1673
"cooper"	"James"	"Hall"	1676
"cooper"	"Henry"	"Pullein"	1675
"cordwainer"	"George"	"Barnard"	1675
"cordwainer"	"Edward"	"Skannon"	1680
"cordwainer"	"John"	"Wilmott"	1675
"drugster"	"William"	"Mathews"	1682
"fisherman"	"Richard"	"Collingwood"	1674
"glazier"	"Thomas"	"Hudson"	1684
"goldsmith"	"Richard"	"Lord"	1677
"gunsmith"	"Stephen"	"Massey"	1664
"hatmaker"	"John"	"Rosewell"	1683
"ivory turner"	"William"	"Clifton"	1691
"labourer"	"John"	"Dennis"	1674
"limeburner"	"John"	"Hardwick"	1675
"mariner"	"Alexander"	"Bailing"	1680
"mariner"	"Thomas"	"Bowtell"	1675
"mariner"	"Peter"	"Claiton"	1675
"mariner"	"Joseph"	"Cupid"	1672
"mariner"	"Michael"	"Dunn"	1675
"mason"	"John"	"Stone"	1673
"merchant"	"John"	"Agard"	1680
"merchant"	"David Lopez"	"Narbona"	1674
"merchant"	"Abraham"	"Langford"	1675
"merchant"	"John"	"Sweeting"	1675
"merchant"	"Charles"	"Knight"	1680
"merchant"	"Cornelius"	"Vandananker"	1670
"merchant"	"Moses Jesurum"	"Cordova"	1675
"pewterer"	"Simon"	"Benning"	1667
"pipemaker"	"John"	"Pope"	1680
"porter"	"George"	"Paul"	1670
"poulterer"	"Richard"	"Jeffreys"	1677
"sailmaker"	"Adam"	"Brewer"	1671
"schoolmaster"	"Peter"	"Bird"	1677
"shipwright"	"William"	"Cavell"	1676
"tailor"	"William"	"Case"	1676
"tailor"	"Pewter"	"Ebden"	1683
"waterman"	"William"	"Brocke"	1674
"waterman"	"Joel"	"Clements"	1668
"wherryman"	"John"	"Grant"	1669
"victualler"	"Barnaby"	"Adams"	1675
"vintner"	"Gabriel"	"Adkins"	1668
"tavern-keeper"	"John"	"Baldwin"	1670
"tavern-keeper"	"Mary"	"Dayton"	1664
"tavern-keeper"	"James"	"Turpin"	1679
"tavern-keeper"	"Christopher"	"Mayham"	1664

hair	height	grooming	description
red-headed	tall	messy	"An older woman with long red hippie-hair poking out of a ponytail in straggles, and bent to hide how tall she is."
red-headed	medium-height	messy	"A shaggy red-head with shingled hair."
red-headed	short	messy	"Almost an urchin, and very young, with ginger hair and a smudged nose and far too many freckles."
red-headed	tall	tidy	"A precise career woman with henna-red hair."
red-headed	medium-height	tidy	"Her hair is red in the way that lollipops and fire trucks are red: not by nature but by art. The rest of her clothing is pretty ordinary, though."
red-headed	short	tidy	"Thin and small in every sense, with chin-length red-hair. Even high heels do not bring her head much above your shoulder."
brunette	tall	messy	"A Juno-esque woman with dark hair, wearing something resembling a tent."
brunette	medium-height	messy	"An unremarkable woman with dark brown hair and the aura of needing a wash."
brunette	short	messy	"There are mustard stains on the t-shirt of this short brown-haired woman. Estimated age ca. 40. Possibly homeless."
brunette	tall	tidy	"A leggy brunette in business attire."
brunette	medium-height	tidy	"Medium-height, brown-haired, generally nondescript."
brunette	short	tidy	"A neat little dark-haired girl."
blonde	tall	messy	"A tall blonde of about thirteen who looks as though she has not yet figured out how to get her wardrobe to catch up with her rate of growth. Her t-shirt and her pants are too short."
blonde	medium-height	messy	"Black leather pants and the wall-o-hair look."
blonde	short	messy	"One of those shocking platinum blonde types, with a tiger-patterned skirt. Reeally trashy."
blonde	tall	tidy	"Elfin and severe, with perfectly straight hair falling to the middle of the back."
blonde	medium-height	tidy	"A rounded, Marilyn-esque blonde."
blonde	short	tidy	"Pin-precise in a blue-and-white striped suit and a boyish haircut."

era	event
8-24	"A wisp-thin cloud blows rapidly across the face of Nepenthe, the lesser of the two green moons."
8-28	"The cloud across Nepenthe clears."

name-text	relevant list
"left hand of autumn"	"[arcane list]"
"gloves"	"[glove list]"
"pair of gloves"	"[glove list]"

item	reply
letter	"'It is enciphered,' she remarks[if the advisor can see the letter], glancing over the contents[otherwise], after you have offered a detailed description[end if]. 'A substitution cipher of some complexity, I believe.'"
Advisor	"She listens to your inquiries about her identity and parentage with a placid smile, but does not answer."