Bronze — 46 of 46

Emily Short

Release 13

Section 2 - Menu System

Include Menus by Emily Short. [1]

Include Basic Help Menu by Emily Short. [2]

Understand "menu" as asking for help.

When play begins:

choose row 1 in the Table of Basic Help Options;

now description entry is "[bold type][story title][roman type][paragraph break][story description]";

choose row 2 in the Table of Basic Help Options;

now title entry is "Instructions for Playing IF in General";

Table of Basic Help Options (continued)

titlesubtabledescriptiontoggle
"Special Commands In [story title]"--"[story title] has a few special commands not found in every game.

GO TO {any room} will allow you to travel automatically, assuming that there are no locked doors or other impediments in your way.

FIND {any object} will similarly take you to any items you have seen already (but not find anything that you haven't seen yet).

LOOK {a direction} will tell you what lies that way without your having to go there.

ROOMS will list all the rooms you have visited so far; OBJECTS will similarly list all the things you have seen in the course of the game.

THINK ABOUT {any object} will provide extra information and sometimes context-sensitive hints, depending on what you have done so far.

NOVICE MODE ON and NOVICE MODE OFF toggle the functioning of novice mode, which puts in bold-face the names of objects the player might want to attend to, and offers some command suggestions each turn. The game runs very slightly more slowly in novice mode because it is also calculating what the player might like to do at each turn. It is recommended that the novice player try this for a while, then turn it off when he gets the hang of the command-driven interface. Novice mode does not list every possible command, only those that seem especially obvious or relevant at any given moment."
--
"Credits"--"Inform 7 is the work of Graham Nelson, and [story title] was compiled using Andrew Hunter's compiler for Mac OS X.

Admiral Jota, Dan Shiovitz, and David Welbourn offered some beta-testing corrections on an early prototype version of Bronze. The fuller version of the game was beta-tested by Annette Edelman, Michael Gentry, Dene Goodman, Yoon Ha Lee, Nick Montfort, Brian Rapp, and Dan Shiovitz. Bugs corrected after the first public release were submitted by Paul Trembath, Brett Witty, Nick Montfort, L. Ross Raszewski, Samuel Bronson, Christopher Tate, Brian Campbell, and Eric Eve.

Novice-friendly features are designed based on observations of frequent errors in logs of phpZork, rec.arts.int-fiction posts from players, and some analysis of novice transcripts by Aaron Reed."
--
"Contacting the Author"--"If you have any difficulties with [story title], feel free to contact me at emshort@mindspring.com."--

[Number of beta-testers is negotiable; in general, the larger and more complex the piece, the more testers it needs. I try to get at least three for all but the simplest, smallest pieces. With Bronze, I was aiming at novice-friendliness, and so it was especially important to smooth down the rough edges of the parser and find the places where puzzles were underclued. So I looked for more testers and included some I hadn't worked with before, specifically because I wanted to test with some users who were *not* familiar and comfortable with my writing style. The testing list also includes a mix of more- and less-experienced players, and a range of interests (some are more apt to comment on writing, some on puzzle design, and so on).]

Table of Stuckness Advice (continued)

titlesubtabledescriptiontoggle
"Try hints"--"If you're still stuck after your best efforts, figure out what seems to be stumping you and try THINK ABOUT {whatever it is}. The game may have some suggestions to offer you."--

[And here we get rid of the "score notification" setting, because we don't want anyone to try turning it on.]

When play begins:

choose row 2 in Table of Setting Options;

now title entry is "[if novice mode is functioning]Novice mode on[otherwise]Novice mode off[end if]";

now toggle entry is the switch novice mode rule.

This is the switch novice mode rule:

if novice mode is functioning, now novice mode is dead;

otherwise now novice mode is functioning.

Understand "credits" as asking for help.

Notes

[1]. An extension to do menu systems on screen, using tables.

[2]. An extension that contains some boilerplate help text in a form compatible with the menu extension.