Category : BBS Programs+Doors
Archive   : GREATWHT.ZIP
Filename : GREATWHT.DOC

 
Output of file : GREATWHT.DOC contained in archive : GREATWHT.ZIP















THE GREAT WHITE CARD GAME
=============================

A Live Game for
=================
Wildcat! 1.13 & 2.0+ BBS's
Quick BBS
Pcboard BBS 14.0+
Gap BBS
Spitfire BBS
=================
Supports Single & Multinode

Game Release Version 2.0 - 7/01/90
(C)opyright 1989, 1990

By
Rusty Johnson
P.O. Box 405
Ona, West Virginia
25545-0405

River Cities Public Service BBS
(304) 733-4148
300 / 1200 / 2400 24 Hours
Fido Node 1:262/28

* System Operators *
Bruce Cottrell Rusty Johnson


















Great White (C)opyright 1989, 1990 - Page 1







Important Notes About This Door
=====================================

BBS's It Supports:

The Great White doors game directly supports, Wildcat 1.13 & 2.0+, QuickBBS,
Gap, Pcboard 14.0+ and Spitfire BBS's. It will also run directly with Remote
Access and RBBS in QuickBBS Mode. It's designed for easy setup for each BBS by
simply telling it which kind of BBS your running in the configuration file
described in detail later in this document.

Running Great White:
There are three different ways to run Great White; Locally, as a Demo Door
and as as Registered Door. Below are the steps you must take to operate
Great White.

Locally:
To run Great White locally just edit the configuration
file (explained later in this doc) with your system
information. Then to run type:
GREATWHT LOCAL GREATWHT.CFG
at the dos prompt. By specifying the configuration
file this will allow Great White 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.

Demo Door:
To run Great White as a demo door requires that you call
one of the support BBS's listed towards the end of this
document. Where you can download (FREQ where available)
a 30 day demo key. These keys are only 1,500 bytes large
so they can be downloaded or freq'd very quickly. These
keys will allow you to run this door for 30 days so you
and your users may try it to see if you want it. If you
can't download/freq the key then fill out REGISTER.FRM
and check the keys you want and send it with $2 dollars
for shipping and the requested demo keys will be mailed
to you.

NOTE: Only one key for Great White is allowed for each
system that's trying it out.
DO NOT distribute these keys when you download
one. Let each system download there own key.

Registerd Door:
To run Great White as a registered door you must register.
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. Then send it along with a
check or money order (US Currency) for the said ammount,
to the address on the form itself or at the end of this
documentation.
Upon reciept of your order you will be sent your regist-
ered key. This will be done, via net-mail where
applicable or uploaded to your BBS. If these attempts
fail it will be sent US mail. All COD orders will be sent
UPS or US Mail.

Great White (C)opyright 1989, 1990 - Page 2







Comments form Author about distribution:

This kind of distribution has good points and well as bad.

The BAD POINTS (I'm sure your saying) are that downloading
demo keys cost a few cents. And also the whole idea of demo
keys is for the birds. It does seem an awlful lot just to
run a doors game. I agree with all these arguments. But I
was forced to do this cuase of those that WILL NOT even
consider registering. They are using the doors for nothing
while you may be paying for it. And so I have taken steps
(which I would have rather spent my time doing something
better) trying to eliminate these thiefs. I work long and
hard hours trying to make a quality program and I don't
think it's to much to ask for those that use it to send
the small registeration fee.

The GOOD POINTS are that by using the KEY system it allows
me to distribute a full working copy of the program. Also
new updates and/or bug fixes can be downloaded from just
about any BBS as they get distributed, and run immediatly
as a registered door since you already have a registered key.
This will save long distance calls in some instances and
also make availability easier than calling only one BBS and
getting busy signals. Also this will allow me to get your
registered key to you fast. Since it won't be thousands of
bytes I can simply send them electronically.




Support Of Product
========================

I just want to ensure those that decide to register this door that shipment
of the registered key will be sent promptly. I want to make it clear that
all my door games are supported by me to the best of my ability. If you have
any problems at all with any of my doors, I will try to solve your problem as
best as I can and also as quick as possible.




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.
Futhermore, I the author do not warrant, guarantee, or make any represent-
tions 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.




Great White (C)opyright 1989, 1990 - Page 3







Copyright
===============

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

Distribution
==================

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

Special Features Of Great White
====================================

* Supports Wildcat 1.13 & 2.0+ , QuickBBS, PCBoard 14.0+, Gap and
Spitfire directly without the use of converters.

* Support's Multi-Node Systems.

* Has only ANSI versions of game at this time.

* Has Sysop 'One Liner' window (F5 Key) for comments to player.

* Has a Full Spilt-Screen Chat mode in Ansi Version.

* 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.

* Opening ANSI screen (after registeraion screen) may be edited
to reflect your inforamtion.

* Built in bulletin generator for ANSI and ASCII bulletins.

* Selectable Indept Log File capability.

* Carrier Drop Detection.

* No Input In 5 Minutes, Time Out Detection.

* Full BBS and Voice Support (Demo or Registered)









Great White (C)opyright 1989, 1990 - Page 4







Introduction & How To Play
================================

The Great White Card Game has Hot Key's as a standard. You do
not press the RETURN (ENTER) key any where except when entering
a wager. So if you get press to many keys you might do something
that you didn't intend to do. This shouldn't be a problem after
you get use to it.
The Great White Card Game is a game that is played in two
different parts. Part One consists of Seven Rounds where the
player is shown six cards all but one is face down and it's the
starter card. To the left of the starter card is a change card
and all the cards to the right are play cards. You try to guess
rather the next card from left to right will be lower or higher
than the preceding card. You can use the change card once each
round to change an unwanted card. If you guess each card correct
for a round you win $100. If a guess is made an the next card is
a match then you are credited with a correct guess and may cont-
inue. The money won is these Seven rounds is used in the Second
Part of the game called the Super Round. If no money is won in
Part One then game is over.
In Part Two there are 15 cards dealt face down in three rows
with the bottom and middle rows containing five play cards and
one change card, and the top row containing 2 play cards and one
change card. The First play card in the bottom row is the start
card. In Super Round the game is played like Part One except you
use the money from Part One to bet with on each guess. And also
the last card in each row is moved to the first postion of the
next row. You may bet any amount but not over the amount in the
Play Account except on the top row when you have to bet at least
half of all your accounts which at this time are added togather
and displayed in both account windows.
You have two accounts (mentioned above), The Play Account and
the Bank Account. The Play Account is started at zero each time
you enter the game and where your money is stored during play.
The Bank Account is where your daily earnings are stored and is
kept for the entire month. Money in the Bank Account is safe un-
til then Top Row of the Super Round where the two accounts are
added togather and you must bet at least half of the combined
accounts.
At this time I have not added a joker to the game so you need
not worry with that obstacle.
















Great White (C)opyright 1989, 1990 - Page 5







List of Files In Archive
==============================

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


GREATWHT.EXE <--- Executable Program.

GREATWHT.CFG <--- Configuration File.

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

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

GREATWHT.DOC <--- This File.

GREATWHT.SCR <--- Ansi Mode Opening Screen.

GREATWHT.CHP <--- Last Months Champion File.

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

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

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

* DENOTES that file is created during RUN-TIME.


GREATWHT.CHP contains:

"The Champ","100000","05-01-1990","1"

This is the Last Months Champion file. It contains the Champs Name, Score,
Date and How many games won that month. You should edit this file to reflect
the DATE of the month your in. For example,if it's June 15, 1990 then change
the date to 06-01-1990. This will save the data from being deleted when first
setting up the game if the old date was an earlier month. If you don't under-
stand this then ignore it and it will straighen itself out when a new champion
is named.


GREATWHT.SCR

This file is the opening screen. It may be edited to reflect your BBS
name and other information. DO NOT add clear screen codes to this file when
editing. If you do then the sysop lines at the bottom of the screen will be
cleared from the screen and not redrawn for the entire game.







Great White (C)opyright 1989, 1990 - Page 6







Setup & Installation
==========================

Installation procedures are relatively 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 GREATWHT.ZIP file into this directory.

Edit or create the GREATWHT.CFG file to your system information. Following is
and example of this file.

GREATWHT.CFG contains:

River Cities Public Service BBS <-- Name Of BBS
Rusty Johnson <-- Sysop's Full Name
C:\Wildcat\Callinfo.bbs <-- Drive\Path\Filename Of Systems Caller File
NO <-- NO or locked COM PORT Baud Rate
LOG <-- LOG to keep user log or (blank line)
D:\Bulletin\Bull99.Bbs <-- Drive\Path\BulletinName For Ansi Scores
D:\Bulletin\Bull99.Scr <-- Drive\Path\BulletinName For Ascii Scores
Wildcat <-- Type of BBS System Your Running


Note #1: Valid System Callers files for each BBS sytem are as follows:

Wildcat! BBS System <-> CALLINFO.BBS
QuickBBS System <-> DORINFOx.DEF
PCBoard BBS System <-> PCBOARD.SYS
Gap BBS System <-> DOORS.TXT
Spitfire BBS System <-> SFDOORS.DAT


Note: The Type of BBS System Line (Bottom Line) Must match the
Caller file for that system. Accepted names include:
WILDCAT / QUICKBBS / PCBOARD / GAP / SPITFIRE
These names MUST BE spelled correctly!!!

Note: On QuickBBS Systems the 'x' in DORINFOx.DEF will be
either 1 or 2.


Note #2: This game SHOULD NOW WORK when the DTE is LOCKED at 19,200.
There was a problem with this but it has been fixed.



Note #3: The Bulletin Drive\Path\Bulletin Name is designed to accecpt any valid
Drive, Path and Filename of your choice. This allows each BBS system
to configure for their individual system.










Great White (C)opyright 1989, 1990 - Page 7







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: GREATWHT GREAT-1.CFG

Node2: GREATWHT GREAT-2.CFG



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

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



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\GREATWHT
GREATWHT GREATWHT.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\GREATWHT

Third, put the Great White game files in the \WILDCAT\DOORS\GREATWHT
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.







Great White (C)opyright 1989, 1990 - Page 8







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:

TC 10

where 'TC' 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 GREATWHT to be placed in. And example
would be:

C:\GAP\GREATWHT

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

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

ECHO OFF
CD\GAP\GREATWHT
GREATWHT GREATWHT.CFG
CD\GAP
GAP

the last line in the GREATWHT file should invoke the batch file which loads
the GAP 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.



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.

Great White, 10

Where Great White is the name of the door to appear on your menu and the
10is 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.





Great White (C)opyright 1989, 1990 - Page 9







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

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

:DOOR_A
CD\SF\DOORS_A
GREATWHT GREATWHT.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 Great White with
the door number relating to it's position in DOORS.DAT.

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

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

C:\PCB\GREATWHT

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

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

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

the last line in the GREATWHT 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.







Great White (C)opyright 1989, 1990 - Page 10







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 QucikBBS 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 GREATWHT which should be placed in the
default directory. Following is example contents of this file:

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

the last line in the GREATWHT 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.


Special Notes
===================

Also the Great White game does not need any monitoring program for
dropped carrier's.

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


Feature Not On Sysop Line
===============================

One feature activated by the Function Five (F5) key is the Sysop One Liner
Window. This is like a One-Way Chat, but will not distrub play of the game.
Once activated the Sysop can type remarks at any time to the user. I added
this option for the reason that while beta testing users may need a little
instruction or would make some of the worse card selections. So with this
option I could simply type in help, or ridicule, or whatever the situation
warranted. It's a lot of fun since the user can't respond! Press the ESC
key to turn this option off.

Great White (C)opyright 1989, 1990 - Page 11







Function Key Usage
========================

All function keys will become active after the user selects the PLAY option
for the menu. This was done to conserve code that I would have to add to stop
screen writing updates for the game screen before the actual game screen was
drawn. Also, if a card is being played then the Function Key event selected
will not activate till the card is completely moved.


Chat Modes
=======================

Selecting Function Key Seven (F7) will invoke the chat mode. If the user is
in Color or Mono mode then the Split Screen chat is invoked. If the user is
in Ascii mode then the regualer ascii chat is invoked. Pressing the ESC key
will deactivate both modes. After pressing the ESC key in any mode, the game
will be redrawn exactly as it was before the chat was invoked and play resumes
where it left off.

Distribution BBS's
========================

River Cities Public Service BBS
(304) 733-4148
300 / 1200 / 2400
24 Hours / 7 Days
Fido Node # 1:262/28
Sysop: Bruce Cottrell & Rusty Johnson
Ona, West Virginia
========================

COM - DAT BBS
(704) 549-1789
300 / 1200 / 2400 / 9600
24 Hours / 7 Days
Fido Node # 1:379/11
Sysop: Mike Jordan
Charlotte, North Carolina
========================

Robert's Room BBS
(703) 680-4973
1200 / 2400
24 Hours / 7 Days
Sysop: Bob Metheny
Woodbridge, Virginia
========================

Valley Business BBS
(714) 678-4299
1200 / 19,200
24 Hours / 7 Days
Fido Node # 1:207/204
Sysop: George Rowell
Wildomar, California
========================

Great White (C)opyright 1989, 1990 - Page 12







Technical Support
=======================

If you have problems with the Great White door game you can contact me,
Rusty Johnson via River Cities Public Service BBS. DO NOT contact the
other Distribution BBS's for technical support.

BBS Phone: (304) 733-4148
Voice Phone: (304) 733-0113


Ordering Information
==========================

Please fill out the REGISTER.FRM file in this package and mail it with a Check
or Money Order to:

Rusty Johnson <--- Make checks payable too Rusty Johnson
P. O. Box 405
Ona, WV 25545-0405

NOTE: You may also order any games C.O.D. (U.S. ONLY) by calling my Voice
number or calling River Cities Public Service BBS and filling out
questionaire #1. Please leave a comment to sysop to validate the order
so I will know it's not a prank. C.O.D. add $5 for Shipping & Handling.

Thank you for trying the Great White game and look for more games for these
BBS's in the near future.

NOTE: This game should run on other BBS systems beside these mentioned with
the use of a conversion utility to create a one of these other caller
info files. If you find that your BBS has trouble with this then please
contact me and we will try to solve the problem.


Acknowledgements
======================

Wildcat! - Mustang Software, Inc.
GAP Communications - The GAP Development Company
PCBoard - Clark Development Company, Inc.
Spitfire - Mike Woltz, Buffalo Creek Software
QuickBBS - The QuickBBS Group, Inc.
















Great White (C)opyright 1989, 1990 - Page 13