; ^Mini-Adventure^ user's manual
                          *** Mini Adventure ***

ADV is an adventure file processor.

If you type ADV, you will get a list of available adventures.
If you type ADV FILNAM, you will get the adventure named FILNAM.

The files are standard VUE files with 'DOT' commands which allow
control and special processing other than straight text display.
All capabilities of QED HELP FILES are supported (see MANUAL HELP
for information on writing HELP files).

'DOT' commands for CRT control
       .U x - Define Underline toggle
       .B x - Define Blink toggle
       .H x - Define Hilight
       .R x - Define Reverse video toggle
       .P x - Define Pause code
       .;   - Comment line (not printed)
\
Specialized dot commands:

.FILE n,ext       - sets extension of file for option #n to "ext"
                     (N is between 1 and 10)

.ASK m            - Gets option between 1 and m
.RND m            - Gets a random number (max value m) into option

.CHAIN            - Hops to the file whose extension is currently in option
.CHAIN ext        - Chains to extension "ext"

.SET x            - Sets flag x ON (x is between 1 and 50)
.CLR x            - Clears flag x
.IF x,label       - If flag x is SET, skip to "label"
.INIT             - Initialize all flags to CLR status
.SHOW             - Display all SET flags & OPTION

:label            - Define a label as "label"

.BR label         - Branches to "label"
.OPT n,label      - If OPTION=n, branch to label
\
Specialized dot commands continued:

.ZERO             - Sets point counter to 0
.ADD x            - Adds x to point counter
.SUB x            - Subtracts x from point counter
.DISPLAY          - Displays current point counter (score)

.MORE x,label     - Branches to "label" if Point counter>X
.EQUAL x,label    - Branches to "label" if X=Point counter

NOTE: ALL branching may only be done in the FORWARD direction.
\
When you CHAIN to another file, it is assumed that the file will have the same
extension, and be located in the same account as the header file.  You may
have as many files as necessary as long as the file NAME is the same.

FLAGS are provided for you to keep track of things (like does the player
currently have the key, has he been to the red room etc.).

Normally after each text display, you will ask for an option and
transfer control to another file to continue the game.

Note that the header file (first file) should have the extension .ADV
\
A sample adventure follows:

     .TYPE ADV1.ADV
       Hello, and welcome to Mini-adventure #1.

       Whoops, you are suddenly attacked by an ORC!
       Do you (1) stand and fight, (2) run away.
       .ASK 2
       .OPT 1,FIGHT
       .; user wants to run
       Well, you escaped.
       That is all for this adventure. (phew)
       :FIGHT
       CHAIN A01

     .TYPE ADV1.A01
       You lost!
       Too bad, because this could have been fun!
       Bye now.
\
Another way of doing this is as follows:

     .TYPE ADV1.ADV
       Hello, and welcome to Mini-adventure #1.

       Whoops, you are suddenly attacked by an ORC!
       Do you (1) stand and fight, (2) run away.
       .ASK 2
       .SET 1,A00
       .SET 2,A02
       .CHAIN

     .TYPE ADV.A00
       Well, you escaped.
       That is all for this adventure. (phew)

     .TYPE ADV1.A01
       You lost!
       Too bad, because this could have been fun!
       Bye now.

You are viewing proxied material from gopher.floodgap.com. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.