Monster Media 1994 #1/monster.zip/monster/BBS_GAME/JFKENO10.ZIP/JFKENO.DOC

Text File | 1994-01-10 | 22KB | 392 lines

         ┌─────────────────────────────────────┐┌──────────────────┐
         │          From "FairWare"            ││ ┌──┐┌──┐┌──┐┌──┐ │
         │  ┌───────────────────────────────┐  ││ │01││02││03││04│ │
         │  │ ▀█▀ █▀▀    █ █▀ █▀▀ █▀█ █ █▀█ │  ││ └──┘└──┘└──┘└──┘ │
         │  │  █  █▀     █▀█  █▀  █ █ █ █ █ │  ││ ┌──┐┌──┐┌──┐┌──┐ │
         │  │ ▀▀  ▀      ▀ ▀▀ ▀▀▀ ▀ ▀▀▀ ▀▀▀ │  ││ │11││12││13││14│ │
         │  └─────────── Ver 1.0 ───────────┘  ││ └──┘└──┘└──┘└──┘ │
         │┌───────────────────────────────────┐││ ┌──┐┌──┐┌──┐┌──┐ │
         ││  Reno Keno game from: James Fair  │││ │21││22││23││24│ │
         │└───────────────────────────────────┘││ └──┘└──┘└──┘└──┘ │
         └─────────────────────────────────────┘└──────────────────┘

                            Written by: James Fair
                         Compiled in Turbo Pascal v6.0

                          BBS Door game written for
                         ───────────────────────────
                      RA/QBBS/RBBS - Spitfire - PCB12.x
                     PCB14.x - Wildcat v2.x - Wildcat3.x
                         ───────────────────────────
                              (c)Copyright 1994



╔════════════════════════════════════════════════════════════════════════╗
║  ■ JFKeno Overview and Instructions ■                                  ║
╚════════════════════════════════════════════════════════════════════════╝
 JFKeno is a neat little Reno Keno Door Game. It is played much like the Keno
 games in Vegas. The object of the game is quite simple.
 There are 80 numbers (1 thru 80) on a number board. You put bets down on any
 20 numbers. Then see how many you match with the computer's 20 random picks.

 JFKeno is played much the same. You may pick up to 20 numbers (if you wish
 to start the computer's picks before you select 20 you may press "S" at any
 time). Once you select a number you may De-Select it by pressing "U"ndo
 last selection. When 20 numbers are picked, or you hit "S", the computer
 will make his 20 random number selections. You payoff is determined by how
 many you match with the computer's picks. The computer's numbers are shown
 with a blue background. Your picks are shown with Yellow foreground. Your
 matches are shown with Flashing Yellow numbers on a blue background. Also,
 the number of "Hits" (matches) is shown, for each turn, in the User
 information area on the right. You have 10 turns per game, and one game
 per day. Make-Up days are available in the REGISTERED version.

 You make your picks by simply typing in the number and pressing Enter. As
 mentioned above your picks show up as Yellow numbers. If you make a mistake
 you can use backspace to correct it. If an invalid number is entered the
 game will beep and inform you that it is invalid. Also, if a number has
 already been picked and you try to enter it again, it will beep and inform
 you of the number being previously selected. A count of how many numbers
 have been selected is shown on the bottom after each number is entered.

That is basically it. A simple, yet very fun and addicting game. I hope you
enjoy it.


╔════════════════════════════════════════════════════════════════════════╗
║  ■ JFKeno Features ■                                                   ║
╚════════════════════════════════════════════════════════════════════════╝
JFKeno v1.0 has many nice features built into the .EXE file. They are:

   ■ JFKeno is a Great RenoKeno Game which features a fun to look at interface,
     simple operation, ReDraw Screen, Instructions, High Score Bulletins etc.
   ■ Built-in Configuration Utility. Simply run Kenocfg.exe first and
     answer the questions. "JFKeno#.cfg" written for you.
   ■ Full Carrier Checking built-in. Will detect loss of carrier and return
     to the bbs immediately. Also writes "JFKeno.log" indicating when and
     who dropped carrier.
   ■ It's own comm routines. Supports COM1 through COM4 and locked bauds up
     to 38400 (I recommend NOT locking bauds for games but if you must...)
   ■ Direct support for RA/QBBS/RBBS (any that write "dorinfo1.def") and
     Spitfire, PCBoard v12.x, PCBoardv14.x, Wildcat 2.x, Wildcat 3.x (any
     that write the generic Door.sys file used by Wildcat v3.0), and WWIV.
   ■ TimeOut feature (5 minutes) - When a user falls asleep at the keyboard
     for more than 5 minutes it will exit the game and go directly back to
     the BBS. (This game is not counted against the user).
   ■ If a user runs out of time before finishing the current game (warning
     message and beep at 3, 2, and 1 minutes) It will force them back to the
     board but will NOT count the current game.
   ■ Built in check for ANSI capability. Due to the graphic nature of the
     game, JFKeno supports only systems with ANSI graphics capability. If
     a "non ANSI" systems attempts to play the game it will prompt them first
     to make sure they can see the ANSI characters. At that time the user must
     answer "Y"es or "N"o to continue or abort the game.
   ■ Creates an ANSI and ASCII bulletin in the path and filename of your choice.
   ■ Built-In Chat - Great little Chat window in the lower (User Information)
     block. Enter Chat using "Alt-C" and exit with "Alt-X". When Chat is exited
     User Information block returns and Play continues.
   ■ Version 1.0 has full support for Multi-node systems. Nodes 1 through 9
     are supported. The new Kenocfg.exe file now asks for which node the
     current Jfkeno.cfg is for and writes "JFKeno#.cfg" (# = 1-9) for which-
     ever node the current config file is going to be written for. Then on the
     command line simply write "JFKeno 1" for node 1 configuration (using
     JFKeno1.cfg) or "JFKeno 2" for node 2 configuration (using Jfkeno2.cfg)
     etc. For single node systems Please put 1 in Kenocfg.exe when it asks for
     which node.
(+)■ Support for up to 99 Players. In UnRegistered mode only 10 users are
     allowed. Also Make-Up days are added for Registration. A nice feature!
(+)■ Your name and (optional) Board name in the closing screen. This not only
     gives you that good "Warm feeling" knowing that you registered this great
     game, but let's all of your games players know that you support "FairWare"



╔════════════════════════════════════════════════════════════════════════╗
║  ■ JFKeno Necessary Files ■                                            ║
╚════════════════════════════════════════════════════════════════════════╝
Your JFKeno10.zip file should contain the following files:

 JFKeno.exe  -> The executable file
 Kenocfg.exe -> Configuration file utility (Run This first)
 JFKeno.dat  -> User Score and information file
 Kenowin.dat -> Last month's winner's name and score
 JFKeno.frm  -> JFKeno Registration Form
 JFkeno.doc  -> This documentation File
 KenoAd .ans -> Just a little ANSI file YOU MAY MODIFY announcing JFkeno

Let's take a quick look at each file.

 JFKeno.exe  - This is quite simply the executable file for JFKeno. You may
               compress this file using PKLite or other .exe compression
               programs. It was written and compiled in Turbo Pascal v6.0.

 Kenocfg.exe - This is the configuration file utility. You must run this first
               before running the game. It is a nice graphical setup utility
               in which you tell the game where to find your user files, where
               and what name to give the high score bulletins, your comm port,
               and more. This is also where you put in your Name and your
               Registration key. Please answer all questions each time you run
               this .EXE file. I make no assumption from previous times run and
               re-write the file each time you run the utility. Therefore, BE
               SURE TO ANSWER ALL QUESTIONS EACH TIME.
               (More on this file in the Installation section)

 JFkeno.dat  - This is the file containing all of the users information on
               date last played, score, make-up days played etc. It is in a
               fixed data type format so please do not try to modify or the
               file will corrupt and be re-written. That is, any tampering with
               this file and it will be re-written the next time the game is
               run!

 Kenowin.dat - This is where Last month's winner's name and score are stored.
               It is a straight ASCII text file. Line one is the user's name
               and line two is their score. This file is kept up with by the
               game and if corrupted or missing for any reason will be re-
               written with "THE CHAMPION" and "100,000".

 JFKeno.frm  - This is the JFkeno Registration form. Please refer to the
               section below for more information on registration procedures.


 KenoAd.ans  - This is just a little ANSI file (which you may modify) to use
               on your opening screens, or whatever, to announce JFkeno on
               your system.

 = Files Created during Runtime =

 JFKeno.log  - Should a user drop carrier or a related error occur a file
               called "JFKeno.log" will be created or appended showing this
               information.

 JFKeno.dat  - This file is updated as necessary, after each game is
               completed, with the users game and score information.


╔════════════════════════════════════════════════════════════════════════╗
║  ■ JFKeno Installation Instructions ■                                  ║
╚════════════════════════════════════════════════════════════════════════╝
Installation of JFkeno is quite simple.

= Kenocfg.exe =
First Copy all files to a subdirectory of your choice: C:\Doors\JFKeno, for
example. Next run the Kenocfg.exe file and answer all questions as explained
above. I'll run quickly through all of the questions in Kenocfg.exe:

1) The first screen to come up will ask for your BBS type. Enter the number
   next to your BBS type. Below is a list of the BBStype and the userfile(s)
   written by each which is used by JFKeno for all user information:

   1) QBBS/RA/RBBS    --> Dorinfo1.def
   2) PCBoard v12.x   --> PCBoard.sys/PCBoard.dat/User
   3) PCBoard v14.x   --> PCBoard.sys/PCBoard.dat/User
   4) Wildcat v2.x    --> Callinfo.bbs
   5) Spitfire        --> SFDoors.dat
   6) Wildcat v3.x    --> Door.sys/Sysinfo.dat
   7) WWIV            --> Chain.txt

2) The second screen will ask for which node the current config file is for.
   For single node systems enter a "1" here. For multi-node systems you need
   to run the Kenocfg.exe file once for each node and change this number for
   the node for which this config file will be used. For instance, if you
   are running this one for node 1 put a "1" here and Kenocfg.exe will write
   the information given in a file called JFKeno1.cfg. Run Kenocfg again for
   a second node and put a "2" here. Kenocfg.exe will write JFKeno2.cfg with
   the information given this time with the new comm port, userfile path, and
   other information for the second node. Continue this process for each node.
   Then on the command line (discussed below) put "JFKeno #" where "#" is the
   node number and which config file it will look for.

3) The third screen will ask for the full path to the userfile. For instance
   RA/QBBS/RBBS generate the userfile "Dorinfo1.def". I need the path of where
   that file is written, or if you copy it elsewhere, the path of where it was
   copied. I need PATH ONLY - do not include the userfile name. An example
   would be "C:\RA" or "C:\WILDCAT". If you get an error when bringing up the
   game and it says userfile bad or missing, please check the path given here.


4) Next it will ask for your COM PORT. Please enter only the Number 1,2,3,or 4
   for whichever COM port you are using.

5) The next screen will ask for a locked baud rate (If used). If you lock your
   COM port put the locked rate here. If you do not lock your baud simply hit
   the enter key. (I strongly suggest not locking the baud for games due to
   all of the problems with buffering between dissimilar modems possibly
   trashing the action in many games etc. but If you must lock your baud rate
   JFKeno supports locked bauds up to 38400.)

6) Next it will ask for your Bulletin Board Name. Please enter your board name
   here.

7) The next Screen asks for the full path and FileName of the ANSI and ASCII
   bulletins you want generated by the game. JFKeno will create an ANSI and
   ASCII bulletin showing the top 15 scores in the path and FileName of your
   choice.

8) The Last Screen asks for your Name and Registration Key Number. Be sure to
   capitalize the First letter of your first and last name. If you have
   Registered your copy of JFKeno I will give you a Registration Key Number
   to install at this screen. Otherwise enter any number here or leave it
   blank.

That covers all questions asked in Kenocfg.exe. This will then write the
configuration file "JFKeno#.cfg" for you in the current directory.



╔════════════════════════════════════════════════════════════════════════╗
║  ■ JFKeno Command Line Parameters ■                                    ║
╚════════════════════════════════════════════════════════════════════════╝
Now you have all of the necessary files written to run the game. That's it!
The Command line has one switch which must to be given. Since ver 1.0
directly supports multi-node and multiple config files you must give the
node number on the command line. A couple of examples are show below:

■ Command Line for single node operation ■

  "JFKeno 1"   -or-  "JFKeno"  -> if no node is given "node 1" is assumed
                                    and "JFKeno1.cfg is used.

■ Command Line for multi-node operation ■

  "JFKeno #"  -> where "#" is the current node (1 - 9)
   This will use JFKeno#.cfg for the user information and comm port etc.
   for each node.


So to recap, Only three steps are necessary to install JFKeno:

1) Unzip JFKeno.zip to a subdirectory of your choice.
2) Run Kenocfg.exe and answer all questions for each node.
3) Create any batch file and/or Update any door menu/util to run the game.


╔════════════════════════════════════════════════════════════════════════╗
║  ■ JFKeno Batch File Examples ■                                        ║
╚════════════════════════════════════════════════════════════════════════╝
For RA/QBBS type systems a batch file is not even necessary, but if you run
other bbs types the batch file would be quite simple.

= Batch example for Wildcat (single node operation) =
 CD\WILDCAT\DOORS\JFKENO ---> (Change directory to the Jfkeno files)
 JFKENO 1                ---> (Run the game on Node1)
 CD\WILDCAT              ---> (Change directory back to the board)

= Batch example for RA (single node operation) =
CD\DOORS\JFKENO          ---> (Change directory to the JFKeno files)
JFKENO 1                 ---> (Run the game on Node1)
CD\RA                    ---> (Change directory back to the board)

Another example for RA might be running it straight from a type 7 exit and
on the Optional Data Field simply enter:
               *C /C JFKENO.EXE 1 *M

= Batch example for RA node 2 =
CD\DOORS\JFKENO   ---> (Change directory to the JFKeno files)
JFKENO 2          ---> (will use "JFKeno2.cfg" for userfile information etc)
CD\RA\NODE2       ---> (Change directory back to the second node)

Just follow this example for all multi-node systems replacing "2" with the
correct node number. Also must run Kenocfg.exe and answer the "node" question
with the correct number and file/path/comport information.

For any other bbs batch files simply change directory to the game and then
run the game with "JFKeno #" then change directory back to the bbs on the
next line.


╔════════════════════════════════════════════════════════════════════════╗
║  ■ JFKeno Registration Information ■                                   ║
╚════════════════════════════════════════════════════════════════════════╝
Registration of JFKeno reflects the concept of "FairWare".

I thought about this long and hard and decided that I would charge $10.00
for registration of this game. I feel that is a "Fair" price for this game
and all of the long hours I spent developing JFKeno. However, In keeping
with the "FairWare" concept I also want to introduce a "Buddy System"
registration package. That is, If you and a buddy want to register the game,
I will Register two copies for $15.00 - That's $7.50 apiece for a GREAT game!

Registration brings you:
■ All UnRegistered verbage taken out of the Game
■ 99 Player support and Make-Up Days capability!
■ Your Name and (optional) Board Name in the closing screen
■ An incredible warm feeling in your heart knowing you support "FairWare"
■ Direct support provided for any bugs or special applications.

══════════ Please use the File "JFKENO.FRM" for Registration ═══════════


╔════════════════════════════════════════════════════════════════════════╗
║  ■ JFKeno Warranty and Disclaimer ■                                    ║
╚════════════════════════════════════════════════════════════════════════╝
 = 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, either directly or indirectly from
the use of this product.

 = Disclaimer =
The Author of this program, The Fishing Hole and its Co-sysop are in no
way responsible for any damages sustained either directly or indirectly
from the use of JFKeno. Also if the file has been modified in any way I
will take no responsibility for it's use Whatsoever! The .EXE file has
been tested on several machines, from XT's to 386's and worked perfectly
on all. If you should have any problems with this file please call the
Fishing Hole BBS to obtain a good copy.


  ═════════════════════════ 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.3   - A great yaht game. JFYaht ver 1.3 - 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
═══════════════════════════════════════════════════════════════════════
BBSBowl ver 1.7  - My Latest and Best! BBSBowl ver 1.7 - A Beautiful Graphic
    $15.00         bowling game. Full featured. You control the ball and pin
                   action yourself. Allows Curve on the ball, and realistic
"Buddy System"     pin action. You must try this one. GREAT GAME!
    $20.00       * FileReq with Magic name "BBSBowl" @fidonet 1:116/43
═══════════════════════════════════════════════════════════════════════
BBSGolf ver 1.0  - This is IT! A Putt-Putt golf door like none you've seen yet.
    $20.00         Realistic courses featuring hills, greens, walls, tunnels,
                   water, sand and more. You control the ball direction and
                   putt strength. Registration gives you the ability to create/
"Buddy System"     modify your own courses. Up to 10 courses! Excellent Game!
    $30.00       * FileReq with Magic name "BBSGolf" @fidonet 1:116/43
═══════════════════════════════════════════════════════════════════════
JFKeno ver 1.0   - Great Reno Keno game like the Vegas games. Nice interface,
    $10.00         simple operation, and addictive fun. Pick your best numbers
                   and see how you do! Registration gives you full support
"Buddy System"     for 99 players and Full Make-Up day capabilities. Un-
    $15.00         Registered allows 10 players and no Make-Up Days.
                 * FileReq with Magic name "JFKeno" @fidonet 1:116/43
═══════════════════════════════════════════════════════════════════════

             Please forward any comments or suggestions to:

James Fair                       or                     The Fishing Hole BBS
813 Bexhill Ct. N.                                      [phone]
Hermitage, TN  37076                                    fido-net  1:116/43
[phone]                                           06:00 - 18:00 M-F
after hours and weekends!