Black Box 4/BlackBox.cdr/bbs_door/gamble.arj/GAMBLE.DOC

Text File | 1991-06-29 | 16KB | 530 lines

                 ┌────────────────────────────────────────────┐
                 │                                            │
                 │              GAMBLE 'N GUESS               │
                 │           =======================          │
                 │                                            │
                 │         A Live Game for Many BBS's         │
                 │                                            │
                 │   Game Release Version 3.0 - 01/01/91      │
                 │                                            │
                 │             (C)opyright 1988               │
                 │                                            │
                 │                   By                       │
                 │                                            │
                 │            SECRET SERVICE BBS              │
                 │                                            │
                 │              Mike Wilson                   │
                 │             P.O. Box 9521                  │
                 │            Huntington, WV                  │
                 │                  25704                     │
                 │                                            │
                 │            BBS [phone]              │
                 │           1200/2400/9600  24 hrs.          │
                 │                                            │
                 │                                            │
                 │                                            │
                 │                                            │
                 └────────────────────────────────────────────┘

























                   Gamble N' Guess  (C)opyright 1988 - Page 1

                                  Warranty


This is 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. Futher more, I the author do not warrant, guarantee, or make any
representations 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.  I the author
cannot accept responsibility for system damage, loss of profit, or any other
special, incidental, or consequential damages resulting from the use or
inability to use this product.

                                 Copyright


The Multi-Board Gamble N' Guess live game is distributed as SHAREWARE.
Under this concept you may use the SHAREWARE (unregistered) version for a
reasonable period of time, which I consider to be three weeks, after which you
must either register your copy or discontinue usage.

                               Registration

With registration you will recieve the latest registered copy of Gamble N'
Guess with the ability to download any futher updates from Secret Service BBS
at no extra  cost. You will also recieve any support the author can give
in reference to bugs or other problems that may arise in using the game.

I feel that sysop's have enough expense without charging a high cost for a game
for their users. I have set the cost of registration at $10.00 which I feel
if people will follow the shareware concept will be enough to cover shipping
and handling and encourage me to write more doors.
See register.txt for ordering instructions.


                               Distribution

You are free, in fact encouraged, to distribute the SHAREWARE (unregistered)
version of the Multi-Board Gamble 'N Guess Live Game provided that all files
contained in the original Gamble N' Guess archive are distributed in their
original unmodified state.


                               Introduction
                                     &
                                How To Play

The game of Gamble 'N Guess is played much like the shell games that you see
at a Carnival. A ball is placed under one of the shells and then the shells
are mixed up. You have up to 15 plays per day to make wagers and to guess
which shell the ball was placed under. If you win then the wager is added
to your totals.

                          Options and Information

This door is one of the few that 40 column users can play. The game works
with Commodores, CoCo's as well as IBM'ers.
This door game will also create color and mono top 10 bulletins and write them
in directories of your choice written in the .CFG file. It also has a in depth
LOG capability which is optional by the sysop. The log will tell if the user
completed the game, quit before playing, quit in the middle,
dropped carrier, time limit exceeded, no input in 3 minutes and more.
This option was added so that the sysop could see just what his user's are
doing when entering the game. Like whther they play it or just look and quit.

                   Gamble N' Guess  (C)opyright 1988 - Page 2

                            Installation and Setup

Installation procedures are relatively simple.
Create a new directory and dissolve the contents of Gamble.zip into it.
Run Setup.exe and answer the questions as they appear.
If you have problems answering a particular question refer to the detailed
description of each file below.
Create a batch file to call the door from your BBS. If you don't know how
to do this please read the section of this file titled BATCH FILES.

The following is a listing of what is in each file:

GAMBLE.CFG contains:

The Secret Service BBS           <-- Name of BBS
Mike                             <-- Sysop's first name
Wilson                           <-- Sysop's last name
C:\Path\BBSinfo.???  <-- Path and filename for Board Info File (See below)
C:\Path\Color.scr    <-- Path & Filename to create COLOR bulletin
C:\Path\Mono.scr     <-- Path & Filename to create MONO bulletin
NO                   <-- NO or locked COM PORT Baud Rate
LOG                  <-- LOG to keep user log or N for No log
U                    <-- U for Unlimited plays per day O for Once per day

The line that asks for Board Info file refers to the path and file name of
the file that your particular BBS creates when it drops out to run a door.
This would be:
Wildcat up to 2.0   -> Callinfo.bbs        PCBoard ----> PCBoard.sys
GAP or Wildcat 3.0+ -> Door.sys            Spitfire ---> SFDoors.dat
QuickBBS ----------> DorinoX.def (The X is 1 or 2 depending on Node #)

A proper example of the line would be: c:\Wildcat\callinfo.bbs

The lines refering to Color and Mono Top ten bulletins can be any proper
Path and DOS filename that you want these bulletins written to.

NOTE FOR MULTI NODES!
----------------------
You may now have several .cfg files to allow use on multinode systems.
Use the above .cfg format but name each .cfg file differently. You
may call them what you want as long as you correctly call them from
the batch file command line.

Example:    Node1:     game game.cfg

            Node2:     game game1.cfg

** If you need to alter the Com 3 or 4 address or IRQ then please read
   the file called Port.Doc for instructions!

Gamble.DAT contains:

This file contains the following user data:

"The Champion","11-01-1988","100"
"Mike Wilson","11-23-1988","100"

Data has to be kept in this format, but you can delete all lines except for
line number 1 which is the Last Months Champ line. You can alter line 1 but
not remove it. You need to alter line 1's Date form 11-01-1988 to the month
that your setting up this door. For example if it is December just simply
change the Date to 12-01-1988. It doesn't matter if it's the 1st or the 10th,
only the Month (12) will make any difference.

                   Gamble N' Guess  (C)opyright 1988 - Page 3


GAMBLE.TXT contains:

This is the instruction file for Gamble N' Guess. When a user selects the
See Instructions option during the game, this file is read for
instructions. This file MUST BE PRESENT and Not altered in any way for
Gamble N' Guess to run properly

BOARD.TXT
---------
Don't worry about this file. It is created when you run setup.exe
This file tells the game which BBS Software you are running and
tells it to read the correct board file. THERE SHOULD NOT BE A
BOARD.TXT FILE IN THE GAME DIRECTORY IF YOUR RUNNING WILDCAT
PRIOR TO VERSION 3.0!
The game looks for this file and defaults to Wildcat if it isn't
found.

For other boards it will contain one line with one of the following:
QuickBBS --------> QBBS         GAP or Wildcat 3.0+ --> GAP
PCBoard ---------> PCB          Spitfire -------------> SPITFIRE





                          List of Files In Archive

The following files are either found in your Gamble N' Guess Arc or will be
created during the runtime execution of the game.


SETUP.EXE     <--- Executable Setup program for game

GAMBLE.EXE    <--- Executable Program.

GAMBLE.CFG   #<--- Configuration File.

GAMBLE.DAT    <--- Store User's Name, Last Play Date & Score.

GAMBLE.TXT    <--- Instructions Used By Program.

BULLET##.SCR *<--- COLOR Bulletin

BULLET##.BBS *<--- MONO Bulletin

GAMBLE.LOG   *<--- User Log File

GAMBLE.DOC    <--- This File.

PORT.DOC      <--- Instructions for altering Com 3 or 4 Address or IRQ

* DENOTES that file is created during RUN-TIME.
# DENOTES that file is created during Setup.exe execution



                                  Batch Files
                               =================

Be sure that you have edited or created the GAMBLE.CFG file with the correct
information as described earlier in these docs. The individual setups do not
repeat this necessary process.

                   Gamble N' Guess  (C)opyright 1988 - Page 4




Wildcat! 1.13 & 2.0+ Setup:
---------------------------
First, create your DOOR##.BAT (2.0+) or LIVE##.BAT (1.13) like this eample:

   ECHO OFF
   CD \WILDCAT\DOORS\GAMBLE
   GAMBLE GAMBLE.CFG
   CD \WILDCAT
   CAT.BAT

place this batch file in your Node# directory if running Multi-Nodes or in
your Wildcat (default) directory if single node.

Second, Create a sub-directory for the door program such as in the following
example:

C:\WILDCAT\DOORS\GAMBLE

Third, put the GAMBLE game files in the \WILDCAT\DOORS\GAMBLE directory.

Forth, add this game to your live program menu for user selection and your
ready to run the door.

If this is a little unclear then please read your systems documentation for
more detailed instructions.

If you use a door monitoring program then read their documentation for
their specific setup.



Gap Setup:
----------
First, add the number and name of the door to your menu. This will allow the
user to select the door by number.

Second, edit or create the file called DOORS.DAT which is normally in the GEN
directory. Following is an example line to add:

   GG 10

where 'GG' stands for the name of the batch file (shown below) to invoke the
the door and '10' is the required security level.

Third, create a sub-directory for GAMBLE to be placed in. And example
would be:

C:\GAP\GAMBLE

place all the files in the GAMBLE.ZIP archive inside this directory.

Forth, create a batch file called GAMBLE which should be placed in the
default directory. Following is example contents of this file:

   ECHO OFF
   CD\GAP\GAMBLE
   GAMBLE GAMBLE.CFG
   CD\GAP
   GAP

the last line in the GAMBLE file should invoke the batch file which loads
the GAP BBS system.

                   Gamble N' Guess  (C)opyright 1988 - Page 5

If this is a little unclear then please read your systems documentation for
more detailed instructions.

If you use a door monitoring program then read their documentation for
their specific setup.


Spitfire Setup:
---------------
First edit your SFDOOR.MNU and add the following line. If you are not running
and doors at this time you will need to create this file.

   GAMBLE, 10

   Where GAMBLE is the name of the door to appear on your menu and the 10
   is the lowest security level that will be allowed to enter the door. Don't
   forget the comma (,) after the name.

Second create a sub-directory to place the door game in. In this example we
will use 'C:\SF\DOOR_A' for the game directory.


Third move all the files in the GAMBLE.ZIP archive into this directory.

Forth edit your SF.BAT file adding the following lines.

:DOOR_A
   CD\SF\DOORS_A
   GAMBLE GAMBLE.CFG
   CD\SF
   GOTO LOOP

Fifth, rerun Sf.BAT and your ready to begin play.

If this is a little unclear then please read your systems documentation for
more detailed instructions.

If you use a door monitoring program then read their documentation for
their specific setup.


PCBoard 14.0+ Setup:
--------------------
First, edit your DOORS and DOORSG file so that it shows GAMBLE with the door
number relating to it's position in DOORS.DAT.

Second, edit the DOORS.DAT file so that it includes GAMBLE.

Third, create a sub-directory for GAMBLE to be placed in. And example
would be:

C:\PCB\GAMBLE

place all the files in the GAMBLE.ZIP archive inside this directory.

Forth, create a batch file called GAMBLE which should be placed in the
default directory. Following is example contents of this file:

   ECHO OFF
   CD\PCB\GAMBLE
   GAMBLE GAMBLE.CFG
   CD\PCB
   BOARD

                   Gamble N' Guess  (C)opyright 1988 - Page 6



the last line in the GAMBLE file should invoke the batch file which loads
the PCboard BBS system.

If this is a little unclear then please read your systems documentation for
more detailed instructions.

If you use a door monitoring program then read their documentation for
their specific setup.




QuickBBS Setup:
---------------
First, add the game to your games menu and select the correct type for doors.

Second, create a sub-directory for the game and move all the files from the
zip file to this directory.

Third, the game reads the file DORINFOx.DEF. Where 'x' is the node number.
Since QuickBBS only supports one node at this time then this file should be
'DORINFO1.DEF'. This file's drive\path\filename should be on the third line
of the configuration file.

   Note: It was told to me that the upcoming 3.0 version of QuickBBS will
         support Multi-Nodes and that the 'DORINFOx.DEF' will be changed
         to 'DORINFxx.DEF' to support Multi-Nodes. This game is written
         where you can specify this new name as well as any others.

Forth, create a batch file called GAMBLE which should be placed in the
default directory. Following is example contents of this file:

   ECHO OFF
   CD\QUICKBBS\GAMBLE
   GAMBLE GAMBLE.CFG
   CD\QUICKBBS
   QBBS.BAT

the last line in the GAMBLE file should invoke the batch file which loads
the QuickBBS system.

If this is a little unclear then please read your systems documentation for
more detailed instructions.

If you use a door monitoring program then read their documentation for
their specific setup.


                            Technical Support

If you have problems with the Multi-Board Gamble N' Guess live game you may
contact Mike Wilson at the Secret Service BBS 24 hours per day.

Secret Service [phone]

PCRelay Net ID: ->SECRET        FIDO  1:262/29






                   Gamble N' Guess  (C)opyright 1988 - Page 7

                              Order Information


Just mail Check or Money Order or Cash to:

Mike Wilson
P.O. Box 9521
Huntington, WV
            25704

Make Checks out to Mike Wilson.
Alll fund MUST be U.S.!

Thank you for trying Gamble N' Guess and look for more games and utilities
in the near future.

Thanks to Jeff Sumberg for some great C routines used in this door!















































                   Gamble N' Guess  (C)opyright 1988 - Page 8