ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng)/ProfitPress-MegaCDROM2.B6I/BBS/DOORS/JFYAHT13.ZIP/JFYAHT.DOC

Text File | 1991-10-24 | 22.3 KB | 414 lines

   ┌──────────┬───────┐        ┌──┐  ┌──┬──────┬──┐  ┌──┬────────┐
   └───┐  ┌──┬┘ ┌─────┘        │  │  │  │ ┌─┐  │  │  │  ├──┐  ┌──┘
       │  │  │  │              │  └──┘  │ │ │  │  │  │  │  │  │
       │  │  │  └──┐  █▀█████  └──┐  ┌─┬┘ └─┘  │  └──┘  │  │  │
    ┌─┐│  │  │  ┌──┘  ███▀███     │  │ │  ┌─┐  │  ┌──┐  │  │  │
    │ └┘  │  │  │     █████▀█     │  │ │  │ │  │  │  │  │  │  │   ver 1.3
    └─────┘  └──┘     ▀▀▀▀▀▀▀     └──┘ └──┘ └──┴──┘  └──┘  └──┘

               On-Line Game Written in Turbo Pascal 5.5
                      for QuickBBS/RemoteAccess
                           by: James Fair
                 (c)CopyRight 1991 "FairWare" Program


                  -- First in the FairWare Series --
 ╓────────────────────────────────────────────────────────────────────────╖
 ║ ████ Overview ████████████████████████████████████████████████████████ ║
 ╙────────────────────────────────────────────────────────────────────────╜
       - Adapted from the MLyaht computer game from MicroLink -
JFYhat ver 1.0 is a great little On-Line version of the Milton Bradley game
Yahtzee. I feel I have created a fun and good looking On-line game. All of
the rules of the board game Yahtzee apply here. In this multi-player game,
the object is to finish the game with the highest score. This game is
written for QuickBBS/RemoteAccess and reads the Dorinfo1.def file for user
information. In most of my previous games I would support many, many door
types. However, this only complicated the code and added to the size of the
game. Most good sysops have a door converter existing on their system any-
way. Therefore, if you do not run Quick/RA then you need to get a door
converter to convert the userfile to Dorinfo1.def. If you are a Wildcat sysop
I strongly recommend "Calldoor" version 3.7 - great utility. This game also
only supports ANSI graphics due to the graphic nature of the game itself.
Packaged with this game is the latest version of Calldoor!!


 ╓────────────────────────────────────────────────────────────────────────╖
 ║ ████ Features █████████████████████████████████████████████████████████║
 ╙────────────────────────────────────────────────────────────────────────╜
JFYaht has full carrier checking during all parts of the game. Also the .exe
file has been compressed so it only takes 30k. JFYaht, due to the graphic
nature of the game, supports only ansi graphics - No black and white. However,
there is built in protection to prompt a black-and-white user before they enter
the game and makes sure they have at least a CGA monitor that will handle ansi
graphics. There is a Re-draw feature in the game (in case of line noise etc.).
And there is the ability to quit at any time during the game in case of a need
for a quick exit on the caller's end. JFYaht keeps up with each players highest
game score and their total score as well. Total score is each day's score added
together and the top ten scores are kept from this perspective. JFyaht also has
support for COM1,2,3, and 4 and supports locked bauds up to 38,400 with it's
own built-in comm routines. JFYaht is a monthly game, That is, on the first day
of a month the scores are automatically reset and a new month of fierce
competetion starts again. With the REGISTERED version, Make-up days are allowed.
A player may make up 3 days per day. That is, they may play today's game and 3
more on that same day. This is all automatically kept up with within the game.
I hope you enjoy the game. It is well written and your caller's will love it!

 ╓────────────────────────────────────────────────────────────────────────╖
 ║ ████ Game Play ████████████████████████████████████████████████████████║
 ╙────────────────────────────────────────────────────────────────────────╜
On a turn, you may roll the dice up to three times in order to obtain a
scoring combination. After your turn, you MUST place a score (or a zero)
in one of the scoring categories. The game ends after a player has taken
13 turns.

On the first roll of your turn, you must roll all five dice. On the second
and third rolls, you may roll ANY or ALL of the dice again. You may choose
to stop after the first or second roll, but you may take NO MORE THAN THREE
rolls in a turn.

The left side of the score card contains the categories Ones, Twos, Threes,
Fours, Fives, and Sixes. When selecting on of these categories, your score
for that category is determined by the number of dice which have the same
number showing as the category name. For example: a roll of 2,5,5,5,4 would
score 2 points in the Twos category (one die X 2), or 4 points in the Fours
category (one die X 4), or 15 points in the Fives Category (3 dice X 5). A
Bonus of 35 points can be earned for the left side if your score from Ones
through Sixes totals at least 63 points (Scoring 3 dice in each of the six
categories will add up to exactly 63 points).

THREE OF A KIND means three dice of any one number (3 one's, 3 two's, etc.),
and scores the sum of all five dice in the roll.

FOUR OF A KIND means four dice of any one number (4 one's, 4 two's etc.), and
scores the sum of all five dice in the roll.

FULL HOUSE is three of one number, and two of another (3 four's and two five's)
for example). Score is 25 points.

SMALL STRAIGHT is four dice in numerical sequence (1,2,3,4 or 2,3,4,5 or 3,
4,5,6). Score is 30 points.

LARGE STRAIGHT is five dice in numerical sequence (1,2,3,4,5 or 2,3,4,5,6).
Score is 35 points.

YAHTZEE is five dice of the same number (5 one's, 5 two's, etc.). Score is
50 points.
For every additional Yahtzee you roll after having scored 50 pints in your
Yahtzee category, you will get an additional bonus of 100 points. If you
have taken a Zero in your Yahtzee category, you receive no such bonus.

CHANCE is simply the total of all five dice. Any combination of dice is valid.

GAME CONTROLS
Most of the control of JFYaht is accomplished with the cursor keys (NUM LOCK
MUST BE ON!). To De-select a Die hit the down arrow(2), to re-select a Die
hit the up arrow(8) and move left or right with the left arrow(4) and right
arrow(6) keys. Once you have selected/de-selected the dice you want, hit the
Enter <Return> to re-roll the de-selected dice. If you are happy with your
roll after 1 or 2 turns just hit "T" to <T>ake this roll and play the
current 5 dice. Once you <T>ake a roll or roll 3 times the score card below
will highlight in Yellow numbers all of the possible scores beside each
category. simply use the arrow keys to highlight your best score and hit
Enter. This play continues until you take 13 turns.

Well, enough on how to play the game...let's get to the good stuff.....


 ╓────────────────────────────────────────────────────────────────────────╖
 ║ ████ JFYaht Files ████████████████████████████████████████████████████ ║
 ╙────────────────────────────────────────────────────────────────────────╜
The following files should be included in your JFYaht.zip file:

JFYaht.exe --------->  The executable file itself
JFYaht.dat --------->  Dat file for the scores
JFYaht.cfg --------->  Small config file
JFYaht.doc --------->  The file you are reading now
Register.frm ------->  Registration form for JFYaht

Let's look closer at the first three files...

JFYAHT.EXE is written in Turbo Pascal ver 5.5 - Compiled on Oct 24th 1991.

JFYAHT.DAT is the high score file. It is a straight ascii text file and quite
easy to edit should something go wrong. Some of you may feel this is a little
primitive but this is the easiest type of file to work with if something did
go wrong on your system. Also it is a good idea to back up all of your .dat
files each night in some kind of nightly event.
The format for the file is as follows:


 Top Ten               Date         Highest Total
User Name           Last Played       Game  Score
1-----------------------25-------------40---45---> Column each data starts on
JAMES FAIR              09-06-1991     265  6045
DONNA FAIR              09-05-1991     272  5904
etc...

If you ever just wanted to restart the scores just put any month different from
the current month in the "Date Last Played" area and run the game. It will re-
start the scores and start a new database. In other words, Scores are
automatically re-started the first day of each new month.



JFYAHT.CFG is the config file. It consists of only 2 lines. The first line is
the COM port you are using (JFYaht supports COM1,2,3,or 4). The second line is
the locked baud rate. (If you lock your baud with the fossil, for example, just
put the rate on the second line). JFYaht supports locked bauds up to 38,400.
Please do not put commas in the numbers on this line or it will not work! If
you do not lock your comm port put the word "NO" (all caps) on the second line.
Here is an example JFyaht.cfg file locking the comm port at 19,200:

COM1
19200

Here is an example JFYaht.cfg file with com2 and no locked baud rate:

COM2
NO

 For Multi-Node operation you could have two .cfg files. One Using COM1 and
 one using COM2 etc.


 ╓────────────────────────────────────────────────────────────────────────╖
 ║ ████ JFYaht Command Line █████████████████████████████████████████████ ║
 ╙────────────────────────────────────────────────────────────────────────╜
The command line syntax for JFYaht is quite simple. All I need on the command
line is the path to "Dorinfo1.def". Below is an example of the correct syntax:

        JFYaht D:\RA D:\RA\JFYaht
          │      │        │
          │      │        └> Path to JFYaht.cfg (Useful for Multi-Node) *
          │      │
          │      └> Path to Dorinfo1.def (Userfile written by Quick/RA).
          │
          └> Executable file.

* This second command line parameter was added for Version 1.1 so that you
  may have multiple .cfg files for Multi-Node operation.

That's it. Easy enough huh?.. Just make sure that JFYaht.exe, and
JFYaht.dat are in the same directory and you are in business. Enjoy...

Just type "JFYaht" at the dos prompt for a brief explanation of command line!!

 ╓────────────────────────────────────────────────────────────────────────╖
 ║ ████ Dorinfo1.def ████████████████████████████████████████████████████ ║
 ╙────────────────────────────────────────────────────────────────────────╜
Let's take a quick look at the Dorinfo1.def file needed for the game. It is
a straight ASCII text file 12 lines long. Here's an example:

The Fishing Hole BBS    --> BBS name (from origin line in RAconfig/Qconfig)
James                   --> Sysop's first name
Fair                    --> Sysop's last name
COM1                    --> COM port being used for the game
2400 BAUD,N,8,1         --> Baud rate, Parity, Data bits, Stop bits
0                       --> Just a "0" (Separates Sysop data from User data)
ROBERT                  --> User's first name
HARRIS                  --> User's last name
Nashville, TN           --> User's City, State
1                       --> "1"-Color  "0"-Monochrome
100                     --> User's security level
45                      --> User's time remaining

All of these lines must be present for the game to operate properly. This file
is automatically written by Quick/RA when you do a type 7 or type 15 exit. To
Play the game locally - FROM THE DOS PROMPT - just create this file with your
favorite text editor and make line 4 say "COM0" and line 5 say "0 BAUD,N,8,1"
and put your name on lines 7 and 8.

 ╓────────────────────────────────────────────────────────────────────────╖
 ║ ████ Batch File Examples █████████████████████████████████████████████ ║
 ╙────────────────────────────────────────────────────────────────────────╜
Here is a batch file example for running JFYaht from a type 15 exit assuming
the game is in the D:\RA\DOORS directory:

If errorlevel 50 goto JFYaht    --> call to label "JFYaht"

:JFYaht                         --> Label JFYaht
cd\ra\doors                     --> change dir to where the game is located
jfyaht d:\ra d:\ra\jfyaht       --> command line to run the game
cd\ra                           --> change directory back to the bbs
goto restart                    --> back to label to restart the bbs

Here is a batch file example for running JFYaht from a type 7 exit assuming
the game is in the D:\RA\DOORS directory:

  ---  On the "Optional Data Field" of your menu editor put ---
       *C /C jfyaht.bat *M

Then the batch file would look like:
@echo off                       --> turn echo off
cd\ra\doors                     --> change directory to the game
JFYaht d:\ra d:\ra\jfyaht       --> run the game
cd\ra                           --> change directory back to the bbs
              That's it. Again...it's quite simple to run.

- For multi-node operation you might have two batch files. One that would -
- point to a second jfyaht.cfg file.                                      -

            -- Node 1 --                  -- Node 2 --
       @echo off                       @echo off
       cd\ra\doors                     cd\ra\doors
       JFYaht d:\ra d:\ra\jfyaht       JFYaht d:\ra2 d:\ra2
       cd\ra                           cd\ra2

 This would simply point the game to use the dorinfo1.def and jfyaht.cfg file
 in the node 2 dir which in the example above is in the D:\RA2 directory.

 ╓────────────────────────────────────────────────────────────────────────╖
 ║ ████ Registration ████████████████████████████████████████████████████ ║
 ╙────────────────────────────────────────────────────────────────────────╜
This game is the first in the "FairWare" series. What this is, is what I
believe to be a "Fair" price for a Great Product, with full support.

The Un-registered version of JFYhat is fully functional. I do not believe in
cripple-ware and date sensitive programs. However, I can see how some door
writers can get discouraged with the small number of registrations when they
see their games plastered on boards around the US. Please feel free to use
this game for 30 days. After that, if you enjoy the game and would like to
continue to run it, you must register JFYaht.
There are a few incentives placed in the Un-registered version of JFYaht.

1. The Un-registered version only allows 10 players - MAXIMUM -
2. At the beginning of the game it just Says "JFYaht ver 1.0""
3. At the end of the game it does not include your name nor your board name.
   It says, returning you to "UNregistered BBS".
=============================================================================
IF you Register JFYaht the game will support 50 players, at the beginning it
will have your name and say that you support "FairWare", and at the end of
the game, your name and board name will be presented saying you registered
the game and support FairWare. Also the game will allow make-up days. A player
may make up 3 games per day. This is a very nice feature that your users will
love...Thanks in advance for your support.
=============================================================================
Knowing the hard work, costs and sacrifices it takes to run a nice board, I
am only asking $10.00 for this game. I feel this is very FAIR. I have put a
lot of time and work into developing a fun and good-looking game. Please use
the file "Register.frm" for all registrations.
                        PLEASE SUPPORT FairWare



 ╓────────────────────────────────────────────────────────────────────────╖
 ║ ████ Revision History ████████████████████████████████████████████████ ║
 ╙────────────────────────────────────────────────────────────────────────╜
VER 1.0 - First Release (beta version) tested out on a few local board here
in Nashville. Thanks to Bobby Binkley for testing.

VER 1.1 - Small bug fix and a few cosmetic changes.

VER 1.2 - Bug fix for first player of the month. I had inadvertently left out
a line in the code that would not allow a second player for the month. Nice
move huh?!?..fixed that.

VER 1.3 - Someone had found a way to cheat on the game using the "T"ake this
roll feature and saying no on all subsequent turns. Anyway this version fixes
that. If you select "T"ake this turn and have any dice down, it will re-draw
all dice on the top row and ask "are you sure?". One little update - I have
added a feature when selecting the score to take, you may hit the up arrow on
the ones category and it will go to chance. And, when you are on chance and
hit the down arrow it will go to ones. Just makes it a little quicker to get
from the ones to chance etc.


 ╓────────────────────────────────────────────────────────────────────────╖
 ║ ████ Disclaimer/Warranty █████████████████████████████████████████████ ║
 ╙────────────────────────────────────────────────────────────────────────╜
James Fair, The Fishing Hole BBS, and it's co-sysops will in no way be held
responsible for any damages to your machine as a result of using this product.
JFYaht was compiled in Turbo Pascal 5.5 and has been tested on a number of
machines from XT's to 386's of all types and runs perfectly on all MS-DOS
and PC-DOS systems. I will not be held responsible if the program is modified
in any way. The exe file has been compressed to make it as small and as fast
executing as possible. JFYaht is the first in the series of "FairWare" and is
as good a product as I can make it. Thanks for using JFYaht.

 ╓────────────────────────────────────────────────────────────────────────╖
 ║ ████ FairWare ████████████████████████████████████████████████████████ ║
 ╙────────────────────────────────────────────────────────────────────────╜
FairWare is my new concept mentioned above of providing Great doors and utils
for a Fair price. Please be sure to get all of these other FairWare products.

============================= FairWare Utilities ============================

Calldoor ver 3.7 - An excellent Wildcat3.0 door converter utility. Converts
                   to 8 door types and will even let you run RA as a door
    $15.00         from Wildcat. Reads and Writes Users.bbs and Exitinfo.bbs
                   and allows flags settings etc in RA mode. Converts to
                   RA/Quick/RBBS, Wildcat 2.xx, GTPowerNode, Gap, PCBoard12,
                   and PCBoard14.x, and Doorway modes. STRONGLY SUGGESTED.
                 * FileReq with magic name "CallDoor" @fidonet 1:116/43

Qdoor ver 2.2    - Another excellent Door Converter for Quick/RA/RBBS.Converts
                   to 6 door types. Has protection built in for AVATAR or ANSI
     $5.00         so that doors that do not support AVATAR will run correctly.
                   Converts to Wildcat2.xx, GAP, PCBoard12, PCBoard14.x, Doorway
                   and GTPowerNode. Great Utility.
                 * FileReq with Magic name "Qdoor" @fidonet 1:116/43

GTConvert ver 2.0- A door converter for GTPowerNode. Converts to 8 door types.
                   Wildcat, RA/Quick/RBBS, GAP, PCBoard12, PCBoard14.x, and
     $5.00         DoorWay doors. Small and Fast.
                 * FileReq with Magic name "GTCvt" @fidonet 1:116/43

BackDate ver 2.0 - One of my earliest but most useful utilities. Don't you hate
                   taking time to download a door only to find out it expires
     $1.00         in a few days, or if you don't have the right key (date
                   sensitive) you just wasted your time getting it. Well,
                   BackDate to the rescue! This nice little utility allows you
                   to quite simply backdate your system to allow you to run
                   and evaluate expired (date sensitive) doors and games, then
                   return your system date to it's original date when you exit
                   the game. Small and simple. Very Fast too.
                 * FileReq with Magic name "BackDate" @fidonet 1:116/43

=========================== FairWare Door Games =============================

Midway ver 1.0   - MidWay Card Game. A great Card game where you bet on odds
                   that the next card drawn from a deck will be "Mid-Way" of
    $10.00         the two face up cards. Lots of fun - Watch out for the
                   JOKER. Many features. Supports All 8 door types mentioned
                   above.
                 * FileReq with Magic name "MidWay" @fidonet 1:116/43

OutNumber ver 1.0- OutNumber is a great thinking game. You vs. the Computer in
                   a numbers game. You may only move Horizontally. The computer
    $10.00         may only move Vertically on an 8 x 8 grid of numbers. $5 for
                   every point you beat him by. Chat Mode, support for Mono and
                   more!! Fun and challenging.
                 * FileReq with Magic name "OutNum" @fidonet 1:116/43

JFYaht ver 1.1   - The Latest game out. JFYaht ver 1.1 - A really beautiful new
    $10.00         Yahtzee door. Not like the ones you've seen before. really
                   nice graphics and has many built in features. Be sure to get
                   this one. It's great!
                 * FileReq with Magic name "JFYaht" @fidonet 1:116/43

========================= Other Great Games ==================================

FreshWater Fishing Simulator ver 1.82 - This is one of the best games out
written by Eric Hamilton. Has many different lakes and types of fish. Excellent
simulation of catching fish. Next to the real thing! Be on the lookout for
Freshwater Fishing ver 2.0 - Lots of enhancements.
Also - The Fishing Hole BBS is the official home of "FreshWater Fishing Forum"
       a message area devoted to the game itself. Ask any questions or make any
       comments to the author himself. Any comments or suggestion are welcome.
 $?.?? You have a direct line to the Author of the game here.
                 * FileReq with Magic name "FFS" @fidonet 1:116/43


 ╓────────────────────────────────────────────────────────────────────────╖
 ║ ████ Special Thanks ██████████████████████████████████████████████████ ║
 ╙────────────────────────────────────────────────────────────────────────╜
Special thanks to MicroLink for the original PC Yahtzee game idea. And thanks
to everyone who helped me beta test the program on their system. But most
of all...Thanks to you for using this product.

             Please forward any comments or suggestions to:

James Fair                       or                     The Fishing Hole BBS
813 Bellevue Rd                                         [phone]
Nashville, TN  37221                                    fido-net  1:116/43