spec.md

   1 # The \"Cloak of Darkness\" specification
   2
   3 Implementations should try be made as similar as possible. That is,
   4 things like object names and room descriptions should be identical,
   5 and the general flow of the game should be pretty comparable. Having
   6 said that, games are implemented using the native capabilities of the
   7 various systems, using features that a beginner might be expected to
   8 master; there shouldn\'t be any need to resort to assembler routines,
   9 library hacks, or other advanced techniques. The target is to write
  10 naturally and simply, while sticking as closely as possible to the
  11 goal of making the games directly equivalent.
  12
  13 \"Cloak of Darkness\" is not going to win prizes for its prose,
  14 imagination or subtlety. Or scope: it can be played to a successful
  15 conclusion in five or six moves, so it\'s not going to keep you
  16 guessing for long. (On the other hand, it may qualify as the most
  17 widely-available game in the history of the genre.) There are just
  18 three rooms and three objects.
  19
  20 -   The **Foyer** of the Opera House is where the game begins. This
  21     empty room has doors to the south and west, also an unusable exit
  22     to the north. There is nobody else around.
  23 -   The **Bar** lies south of the **Foyer**, and is initially unlit.
  24     Trying to do anything other than return northwards results in a
  25     warning message about disturbing things in the dark.
  26 -   On the wall of the **Cloakroom**, to the west of the **Foyer**, is
  27     fixed a small brass **hook**.
  28 -   Taking an inventory of possessions reveals that the player is
  29     wearing a black velvet **cloak** which, upon examination, is found
  30     to be light-absorbent. The player can drop the **cloak** on the
  31     floor of the **Cloakroom** or, better, put it on the **hook**.
  32 -   Returning to the **Bar** without the **cloak** reveals that the
  33     room is now lit. A **message** is scratched in the sawdust on the
  34     floor.
  35 -   The **message** reads either \"You have won\" or \"You have
  36     lost\", depending on how much it was disturbed by the player while
  37     the room was dark.
  38 -   The act of reading the **message** ends the game.
  39
  40 And that\'s all there is to it\...
  41
  42 # Acknowledgements
  43
  44 Thanks to Stuart Allen, Mike Arnautov, Steve Breslin, Neil Cerutti, Al
  45 Golden, Stephen Griffiths, Mark Hughes, John Menichelli, Todd Nathan,
  46 Roger Plowman, Roddie Ramieson, Robin Rawson-Tetley, Dan Shiovitz,
  47 Kent Tessman, Alex Warren and Campbell Wild for contributing versions
  48 of \"Cloak of Darkness\". Not forgetting the special debt of gratitude
  49 we owe to those who created the authoring systems, without whom we\'d
  50 probably still be adventuring in FORTRAN.
  51
  52 # Licensing
  53
  54 Copyright (C) Roger Firth
  55
  56 Copying and distribution, with or without modification, are permitted
  57 in any medium without royalty provided the copyright notice and this
  58 notice are preserved.