Black Box 4/BlackBox.cdr/bbs_door/bbytrp11.arj/BOOBYTRP.DOC

Text File | 1991-12-20 | 15KB | 384 lines

                        * * * B O O B Y   T R A P * * *
                         Copyright 1991 by M & S Software

Booby Trap Version 1.1
12/22/1991 M & S Software


Author: Mike Jordan


Built in BBS Support For:

  Wildcat! BBS 3.X, 2.X, 1.13       PCBoard BBS 14.X           QuickBBS
  Remote Access                     Spitfire BBS               GAP BBS
  RBBS-PC BBS                       T.A.G. BBS


*** Warranty ***

This product is provided "as is" without warranty of any kind. The entire
risk as to the results and performance of the program is assumed by you.
Furthermore, the author does not warrant, guarantee, or make any represent-
ions regarding the use of, or the results of the use of the program, and  you
rely on the program and results solely at your own risk. The author cannot
accept responsibility for system damage, loss of profit, or any other special,
incidental, or consequential damages resulting from the use of or inability to
use this product.


*** Licensing ***

Upon registering you are granted a licensed BOOBYTRP.KEY, which gives you
certain limited rights to use Booby Trap.

You are granted the use of Booby Trap on a single BBS System. It may be used on
several CPU's in a Networking or Multi-Tasking environment where the BBS System
has more than one physically connected node (i.e. LAN Network).

You do not become an owner of Booby Trap.  M & S Software retains
all rights to the software, copies of the software and related
materials. Also upon registering, you agree to use reasonable efforts to
protect the registered BOOBYTRP.KEY file from unauthorized use, reproduction
and distribution.  All rights not specifically granted in this license are
reserved by M & S Software.

Failure to comply with this License can and will result in termination of the
License without refund.

The Booby Trap door game is distributed under the SHAREWARE concept.
Under this concept you may use the SHAREWARE (unregistered evaluation)
version for a reasonable period of time, which is normally thirty days set by
the evaluation (demo) key.  After 30 days you must either register your copy or
discontinue usage.  Only one demo key per door game will be allowed per BBS
system.


*** Three Ways To Run Booby Trap ***

1.  Running Locally:

To run locally just run BOOBYTRP.EXE without parameters or with the parameter
SETUP to create a BOOBYTRP.CFG file (you must have a BOOBYTRP.CFG file to run).
Then at the DOS prompt type:

        BOOBYTRP BOOBYTRP.CFG LOCAL

By specifying the configuration file this will allow the game to write the
bulletins (to a path of your choice) and to allow the game to use the Sysop's
real name instead of the name "Sysop".

2.  Running With Evaluation (Demo) Key:

To run as an evaluation (Demo) door requires that you call one of the
support BBS's listed in the SUPPORT.TXT file (included in the BOOBYTRP.ZIP file)
where you can download (FREQ where available) a 30 day evaluation (Demo) key.
These keys are only 1,500 bytes big so they can be downloaded or File REQuested
very quickly. This key will allow you to run this door for 30 days so you and
your users may evaluate it. If you can't download/freq the key then fill out the
REGISTER.FRM and check the keys you want and send it with $2 for shipping and
the requested demo keys will be mailed to you.

    NOTE: Only one demo key per door allowed for each system.

                      DO NOT DISTRIBUTE EVALUATION KEYS
                      Let each system download their own key.

3.  Running as A Registered Door:

You must have the Registration Key to run as a registered door. To register
simply print-out or copy the contents of the REGISTER.FRM file provided
in this package. Fill it out with the requested information and send it
with check, money order or COD information to the address on the form itself
or at the end of this documentation.  You may also send the information
by Net Mail for COD orders.

Upon receipt of your order you will be sent your registered key. This
will be done, via Net-Mail where applicable, upload to your BBS if
possible or it will be sent U.S. Mail.  All COD orders will be sent UPS
or U.S. Mail.  All COD fees will be added to the registration price.

*** Support ***

If you register this door, I will do my best to ensure that the registered
key will be sent promptly.  I will do the best I can to support this door and
resolve any problems.  I won't guarantee to fix or resolve all problems since
there are so many different combinations of hardware, software and system
configurations being used.

Support can be obtained by calling my BBS, mail or though the FIDO Network.
My current Node address is 1:105/314 (this may be changing in the
near future so try under my name as well as my node ID, it should still show
Hillsboro, OR.).  I participate in the DOORWARE as well as the WILDCAT echo and
will answer any questions addressed to me.

*** Features ***

        * Supports Wildcat 1.13, 2.X & 3.X, QuickBBS, PCBoard 14.X, Gap,
          Spitfire, RBBS-PC, Remote Access and T.A.G. directly without the
          use of converters (and any others that use the same type info files).

        * File Sharing & Record Locking for Networks & Multi-Tasking Systems.
          (Feature requires Registered Key File.)

        * DESQview Detection & Awareness, which speeds program execution.

        * Complete Setup Program to create BOOBYTRP.CFG file.

        * Full ANSI Game.

        * Full Spilt-Screen Chat.

        * Add or Decrease Time allowed in door with function keys.

        * Force user back to BBS with function key.

        * Mono selected colors for sharp picture when played in Mono Mode.

        * Built in bulletin generator for ANSI and ASCII bulletins.

        * Selectable In-depth Log File capability.

        * Carrier Drop Detection.

        * No Input In 5 Minutes, Time Out Detection.

        * Full BBS and FIDO Support (Demo or Registered)

        * Supports Comm Ports 1, 2, 3 & 4 And Non-Standard IRQ selection.

        * Supports Locked DTE Rate from 300 to 115,200 Baud.


*** Files In Archive ***

The following files are found either in the BOOBYTRP.ZIP or will be
created during the runtime execution.

BOOBYTRP.EXE    <--- Executable Program.

BOOBYTRP.CFG  * <--- Sample Configuration File.

BOOBYTRP.DAT  * <--- Store User's Name, Last Play Date & Scores.

BOOBYTRP.HPS    <--- Ansi Mode Instructions Used By Program.

BOOBYTRP.DOC    <--- This File.

BOOBYTRP.ASC    <--- ASCII MONO Mode Opening Screen.

BOOBYTRP.ANS    <--- ANSI COLOR Mode Opening Screen.

BOOBYTRP.CHP  * <--- Last Months Champion File.

BOOBYTRP.LOG  * <--- Game Activity Log.

DOOR.BAT        <--- Simple Sample Batch File For Door Execution.

REGISTER.FRM    <--- Registration Form For This And Other Doors.

HISTORY.TXT     <--- History file listing changes.

UPGRADE.TXT     <--- Explains what is needed to upgrade to new release
                     from previous one.

BOOBYTRP.KEY    <--- Demo Key Needed To Run As A Door. Downloadable or
                     Freq'able From Listed Distribution BBS's. Also Available
                     Upon Registration. (Registered Key WILL NOT Expire)

SUPPORT.TXT     <--- List of boards carring the latest file and Demo Key.

* DENOTES that file is created during RUN-TIME.


BOOBYTRP.CHP contains:

This is the Last Months Champion file. It contains the Champs Name, Score,
Date and How many games won that month. This file is automatically created
when the game is first executed.

Deleting the BOOBYTRP.CHP file will cause the game to re-initialize
itself. It will create a new BOOBYTRP.CHP file and a new BOOBYTRP.DAT file.


*** Setup & Installation ***

Installation procedures are very simple if you have setup a live program in
the past. First create a Sub-Directory for the door game and copy all the
files from the BOOBYTRP.ZIP file into this directory.

Now execute BOOBYTRP.EXE with the SETUP parameter as shown below:

      BOOBYTRP SETUP

This will run the games setup feature that will create a BOOBYTRP.CFG
file. The setup program has complete on-line help so I will not duplicate
it here.

This is what the BOOBYTRP.CFG contains when created (less the comments).

   1                        <-- COM PORT 1, 2, 3, 4 or &H###/#
   N                        <-- Multi-Node 'Y' or 'N'
   COM-DAT BBS              <-- Name Of BBS
   Mike Jordan              <-- Sysop's Full Name
   DOOR.SYS                 <-- BBS Callers File
   C:\WC30\                 <-- Drive & Path Of Systems Caller File
   LOG                      <-- LOG to keep user log or NOLOG to disable
   C:\BULLETIN\BULL99.BBS   <-- Drive\Path\BulletinName For Ansi Scores
   C:\BULLETIN\BULL99.SCR   <-- Drive\Path\BulletinName For Ascii Scores
   Wildcat                  <-- Type of BBS System Your Running
   10                       <-- Games Allowed Per Day (1 to 50)

   NOTE: Valid System Callers files for each BBS system are as follows:

            Wildcat 3.X BBS System         <->  USERINFO.DAT or DOORS.SYS
            Wildcat! 1.X & 2.X BBS System  <->  CALLINFO.BBS
            QuickBBS System                <->  DORINFOx.DEF
            RBBS-PC BBS System             <->  DORINFOx.DEF
            Remote Access BBS System       <->  DORINFOx.DEF
            T.A.G. BBS System              <->  DORINFOx.DEF
            PCBoard BBS System             <->  PCBOARD.SYS
            Gap BBS System                 <->  DOORS.SYS
            Spitfire BBS System            <->  SFDOORS.DAT

If you use another BBS System besides what is listed then you must use
a converter to convert to one of the above caller file formats.

** The Bulletin Drive\Path\Bulletin Name is designed to accept any valid
Drive, Path and Filename of your choice. This allows each BBS system to
configure for their individual system.

** Also note that at this time the two bulletin fields must have somethng in
them.  If you do not plan on showing scores then make this the directory
where the door is.  I will be correcting this so bulletins do not have
to be identified.

*** Execution ***

Some BBS Systems call batch files and some run doors direct. So if you
don't know how to install a door on your particular BBS System then please
see your BBS manual. This game merely needs the CFG file name passed to it on
the command line to operate. ie.

          BOOBYTRP.EXE BOOBYTRP.CFG

An example BOOBYTRP.BAT file could look like this:

     C:                       <-- Change to drive door is in
     CD \BOOBYTRP             <-- Change to door directory
     BOOBYTRP.EXE BOOBYTRP.CFG<-- Execute door with config file
     CD\BBS                   <-- Change back to BBS (may not be needed)


*** Multi-Node Use ***

Running this game on more than a single node requires a Multi-Node Key.
When using a Evaluation Key you must allow only one (1) Node to access the
door at a time. You may use different configuration file names for each node.

Use the SETUP parameter with Booby Trap to create a BOOBYTRP.CFG
configuration file and then rename it for each node. For a short cut, you
may create one file and copy it to the different names and edit the file
with any text editor. Just be sure to keep all fields correct.

Example Of File Naming and execution:

        Node 1: BOOBYTRP BOOBYTRP.CF1
        Node 2: BOOBYTRP BOOBYTRP.CF2
        Node 3: BOOBYTRP BOOBYTRP.CF3

*** Notes Of Interest ***

This game does not require any monitoring program for dropped carrier,
it automatically detects this and exits back to the BBS.

This door DOES NOT require any runtime modules to run. It is run
as is without any aid from outside utilities.


*** Technical Support ***

If you have problems with this door game you can contact me through
my BBS at the number listed below, or though my FIDO address 1:105/314 or
1:105/330. (Note that my node address may change in the near future so try
by my name also.  It should still show me in Hillsboro, OR.).

BBS Phone:       Com-Dat
         [phone] (14.4 HST)
         FIDO 1:105/314
                 24 hour - First time callers have access to
                 door programs and keys.

   or    :       Com-Dat II  (Mail Only - No Human callers)
         Net Mail and File Requests of latest and keys
         FIDO 1:105/330 - Mail Only V.32 9600

Mailing Address: Mike Jordan
                 2401 NE Cornell #174
                 Hillsboro, OR.  97124


*** Ordering Information ***

Please see the file REGISTER.FRM file in this package for ordering
information.


*** Evaluation Keys ***

Please see the SUPPORT.TXT file in this package for a list of available
Distribution Sites where the latest version and evaluation keys may be
downloaded or F'REQed.


*** Updates To M & S Doors ***

Updates to any M & S Software product may be downloaded from any Distribution
BBS Free of charge. My intent is to always supply updates Free unless major
revisions are made to the software in which case a small update fee will be
charged.


*** Distribution ***

You are free, in fact encouraged, to distribute the SHAREWARE BOOBYTRP.ZIP
version of the door game provided that all files contained in the original
BOOBYTRP.ZIP archive are distributed in their original unmodified state.

The Evaluation Key or Registered Key MAY NOT be distributed in any form.


*** Acknowledgements ***

              Wildcat BBS System - Mustang Software
              GAP Communications  - The GAP Development Company
              PCBoard - Clark Development Company, Inc.
              Spitfire - Mike Woltz, Buffalo Creek Software
              QuickBBS - The QuickBBS Group, Inc
              Remote Access - Continental Software

*** Special Acknowledgement ***

I would like to give a very big thank you to the person that has done the
most to make this game (plus all my past and hopefully future door games)
possible.  This person is Rusty Johnson of JNS Software. Rusty has released
many excellent door games into the BBS arena and you will probably see a lot of
similarities in my games and his.  This is because Rusty has provided me with
much of the code needed to make a door game work.  It's my code for the game,
but it's Rusty's code that provides the Comm routines, scoring, bulletins,
setup and just about everything else required to make this a working door.
Rusty and I have known each other for several years now and have helped each
other many times and this is one case where giving has been rewarded tenfold.
I'm glad to be able to call Rusty my friend.  Thanks Rusty.

If you have not played any of Rusty's games then you are missing out on some
of the best games available for BBSing.  You can find a listing of his doors
in the file RUSTY.LST.






Booby Trap Copyright 1991 by M & S Software