+----------------------------+
                         |  The Multi-Adventure Door  |
                         |             by             |
                         |       Mark D. Turner       |
                         +----------------------------+



          =-=-=-=-=-=-=-=-=   GENERAL INFORMATION  =-=-=-=-=-=-=-=-=

This door will allow you to create your own simple adventures by just
creating a text file.  There are several files which you need to change
or create:

        MENU.DAT   This is the menu of available games.
                   When you create an adventure, add the
                   title onto this file.  There can be
                   up to 40 games.

        GAME.X     This is the file of questions, answers,
                   and responses that makeup the game.
                   GAME.1 would be the game file for the
                   first entry in MENU.DAT.  GAME.2 would
                   be for the second...

        INTRO.X    This is an opening screen for the game.
                   INTRO.1 would be displayed before GAME.1
                   was played.  Not a required file.

        WINNER.X   This is an end-of-the-game message.
                   This is only shown to someone who has
                   won the adventure.  WINNER.1 would be
                   displayed at the completion of GAME.1.
                   Not a required file.



          =-=-=-=-=-=-=-=  HOW TO CREATE A GAME FILE  =-=-=-=-=-=-=-=

The file starts with the first question.  The line must start with "\Q\".
The question can be several lines long.  Each of them do NOT start with
"\Q\"!  Blank lines are acceptable.

The question is followed by the possible answers.  Each answer must
starts with "\A\".  Each answer can be several lines long and each of
them do NOT start with "\A\".

The answers are then followed by the responses which the computer will
give.  Each response must start with one of the following:

    "\Y\"  which means the person can continue on with the game.
    "\N\"  which means the game is over.
    "\W\"  which means the person won the game.

Each response can be several lines long but only the first should
start with "\Y\" or "\N\" or "\W\".

Example:


\Q\Who is Paul McCartney?
\A\He was one of the Beatles.
\A\He played bagpipes for Lawrence Welk.
\A\I'm not sure.
\W\Yes!  Paul was one of the Beatles.
You win the game!
\N\No!  If you don't know that then there's
no use in playing this game.
\Y\Well, we'll let you try another question then.


The player would be asked:

Who is Paul McCartney?

1. He was one of the Beatles.
2. He played bagpipes for Lawrence Welk.
3. I'm not sure.


If they picked "1", they would win the game.
If they picked "2", the game would be over.
If they picked "3", they would get another question.

A question can have up to 9 different answers.  There can be as many
"\Y\" or "\N\" or "\W\" as you like.  The last question MUST have a
"\W\" or the game will crash!

Blank lines will be ignored.  Place a "space" on lines that you want
to display as blank.

A file can have up to 100 questions.


                    =-=-=-=-=-=-=-=  FUTURE  =-=-=-=-=-=-=-=

Look for more adventure files in the future.  If you create any,
please upload them to my board and I'll upload them to Percy's bbs
when I have several.  Or, you can upload them straight to Percy's
bbs, if you prefer.


Calls and comments are greatly appreciated.  My bbs is:

                             +--------------------+
                             |  The Outer Limits  |
                             |   (304) 327-7452   |
                             |  Monday -- Friday  |
                             |  8:00am - 7:00 pm  |
                             |  300 -- 2400 baud  |
                             +--------------------+


Any contributions may be sent to my new address:

                                   Mark Turner
                                  P.O. Box 1955
                             Bluefield, WV 24701-6955

This program is copyrighted 1990 by Mark D. Turner.  It may be
freely distributed and changed as you see fit.  Please give me
credit for the original version, though.  I am not responsible
for any problems which may arise from the use of this program.

                  =-=-=-=-=-=-=-=  REVISIONS  =-=-=-=-=-=-=-=

v1.01  Fixed error handling.