Media Share 9

home *** CD-ROM | disk | FTP | other *** search

/ Media Share 9 / MEDIASHARE_09.ISO / bbsdoor / bbsbwl14.zip / BBSBOWL.DOC next >

Wrap

Text File | 1992-08-01 | 26KB | 469 lines

┌─────────────────────────────────────────────────────┐ │ ╕ ╕ ╕ ╕ │ │ │ │ │ │ │ │ ╞══╕╞══╕╒══╕ ╞══╕╒══╕╕ ╕│ │ │ │ ││ │╘══╕ │ ││ ││ ││ ver 1.4 │ │ ╘══╛╘══╛╘══╛ ╘══╛╘══╛╘═╧═╛╘═ ▄██ │ │ ▄██▄█ │ │ ──────── ─────────────── ─────── ▄██▀███ │ │ ────────── ── ──────────── ─ ████▀██ ▄▄▄▄ │ │ ──── ─ ───────────── ───── ▀███▀▄███▀▄▀▀ │ └─────────────────────────────────────────────────────┘ Written by: James Fair Compiled in Turbo Pascal v5.5 BBS Door game written for ─────────────────────────── RA/QBBS/RBBS - Spitfire - PCB12.x PCB14.x - Wildcat v2.x - Wildcat3.x ─────────────────────────── (c)Copyright 1991,1992 ╔════════════════════════════════════════════════════════════════════════╗ ║ ■ BBS Bowl Overview and Instructions ■ ║ ╚════════════════════════════════════════════════════════════════════════╝ ═ Overview ═ BBSBowl is my latest On-Line Game in the "FairWare" series. I have attempted to make this game as realistic as possible. The pin action and ball action is all controlled by you. BBSBowl was written and compiled in Turbo Pascal v5.5 and the .EXE file was compressed using PKLite v1.14 to hold the size down to only 37k. I spent a great deal of time and effort into this game and I hope you all appreciate another great "FairWare" game. Throughout the rest of this document, anything preceeded by a "(+)" denotes a registered feature. ═ Instructions ═ Most of the controls in the game are done using the SPACEBAR and the ARROW keys on your 10-key pad (NUMLOCK ON). When you start the game you will have 4 options. (S)tart - Quite obviously this will start the game for you. (Q)uit - This will quit the game immediately (you may press "Q" to quit at any time in the game. However, if you have a game in progress it will use your current score regardless of where you are in the game) (H)igh Scores - Will show you the high scores (Up to the top 50 scores) (I)nstructions - Will display the game instructions to the user and give them 4 practice rolls. They may enter "I" as many times as they wish and get the practice rolls each time. Once you (S)tart the game the user information (time remaining, high game etc) will be displayed in the bottom right block. The ball will be displayed at the bottom center of the alley. The user simply uses the "4" and "6" keys (arrow keys with NumLock ON) to move the ball to the desired starting location. Once he/she has the ball placed simply hit the SPACEBAR to start the "Curve Bar". It looks something like: Left Straight Right ┌────────┼────────┐ │▓▓▓ │ └────────┼────────┘ As soon as you hit the SPACEBAR a '▓' character starts moving from left to right. To STOP the CurveBar hit SPACEBAR again. The more to the left you stop the CurveBar, the more left hook the ball will have rolling down the alley. The more to the right you stop it the more right hook the ball will have. And obviously, if you stop it in the center the ball will roll straight. **Warning** Be careful not to "hold down" the spacebar or hit it more than once to start and stop each time or it will take off for your next turn before you are ready. I have put in a "Com_Flush_Rx" to try to prevent this but I can't anticipate when or how long you might hold the spacebar down each time so just be careful not to hold it down. *********** Once you stop the CurveBar sit back and watch the ball roll and the pin action. I have done my best to simulate all of the true pin action. There are literally hundreds of possibilities and I think I got 'em all..whew! - All scoring etc is taken care of for you. There are comments built into the game also. You may hit "C"omments ON/OFF at any time to toggle the comments off and on. There is also a "R"edraw option which allows you to redraw the screen in case of line noise or garbage on the screen for any other reason. Once you finish a game your score and average are caculated and given for you. ╔════════════════════════════════════════════════════════════════════════╗ ║ ■ BBS Bowl Features ■ ║ ╚════════════════════════════════════════════════════════════════════════╝ BBSBowl v1.4 has many nice features built into the .EXE file. They are: ■ Only need three files to start the game! All other files are created or updated for you. ■ Small .EXE file - BBSBowl.exe only takes 38kbytes because it has been PKlite'd using PKlite v1.14. ■ Built-in Comments in the game. Some of you may love these comments and then some of you may not. You may Enable/Disable the comments at any time by hitting "C". ■ Built-in Configuration Utility. Simply run Bowlcfg.exe first and answer the questions. "BBSBowl.cfg" written for you. ■ Full Carrier Checking built-in. Will detect loss of carrier and return to the bbs immediately. Also writes "BBSBowl.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) ■ BBSBowl has a built in feature to make all of the "Curve Bar" action and ball/pin action run at the same speed no matter what baud rate you are connected at. That is, if you are connected at 1200 baud you have no better chance (considering response time to curve bar) that a caller at 9600 and vice-versa. A very Nice Feature. This is also true for playing at the local keyboard. ■ 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 against them. ■ Built in check for ANSI capability. Due to the graphic nature of the game, BBSBowl 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 top 10 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 bowling continues. ■ Ver 1.4 has a sysop configurable "Straight Roll" key function. Uses the "5" key on the 10-key pad. This allows the user to hit the "5" key to roll a straight ball for some of those tough spares. (+)■ Support for up to 99 players. In UnRegistered mode only supports 10 players. (+)■ Fully featured "Make-Up Days" (Not supported at all in unregistered ver). If days are missed a user may select any previous un-played day. Up to 3 make-up days allowed per day. (A user may play their game for the day, plus three make-up days - Exit to the board and then come back and play three more make-up days etc until all days are made up). I did not publicize this feature on purpose. If you want your users to know then you may note it in your opening screen or whatever. If you don't wish to allow someone to spend all their time playing make-up days and allow only 3 per day then you may not want to publicize this 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" ■ *** New in version 1.2 *** Added a sysop configurable games-per-day option in the bowlcfg.exe. Please note - you must delete the existing bbsbowl.dat file due to new data file structure to support this new feature. Added feature that when bowlwin.dat file is corrupt or missing (file with last month's winner information" will create a new one with "The Champion" and "5000" points. Before ver 1.2 would end with run-time error and exit back to the BBS. Also bbsbowl.log is appended with this information. ■ *** New in version 1.3 *** Version 1.3 adds full support for Multi-node systems. Nodes 1 through 9 are supported. The new bowlcfg.exe file now asks for which node the current bbsbowl.cfg is for and writes "BBSBowl#.cfg" (# = 1-9) for which- ever node the current config file is going to be written for. Then on the command line simply write "BBSBowl 1" for node 1 configuration (using BBSBowl1.cfg) or "BBSBowl 2" for node 2 configuration (using BBSBowl2.cfg) etc. For single node systems Please put 1 in bowlcfg.exe when it asks for which node. ■ *** New in version 1.4 *** Version 1.4 in addition to Multi-node support also has complete file locking/sharing for Novell/LAN type systems for protection of bbsbowl.dat and other file used by the game. Ver 1.4 should also have all of the little bugs I (and several users) have found FIXED!! I truly feel that this version is completely bug free! (but if you find one I didn't say that).. hee hee... ╔════════════════════════════════════════════════════════════════════════╗ ║ ■ BBS Bowl Necessary Files ■ ║ ╚════════════════════════════════════════════════════════════════════════╝ Your BBSBowl.zip file should contain the following files: BBSBowl.exe -> The executable file BowlCfg.exe -> Configuration file utility (Run This first) BowlWin.dat -> Last month's winner information BBSBowl.frm -> BBSBowl Registration Form BBSBowl.doc -> This documentation File Bowlogo.exe ┬> 640x480x16 .pcx logo file for the new BBSBowl. Check it out! Bowlogo.pcx ┘ Bowlad .ans -> Just a little ANSI file YOU MAY MODIFY announcing BBSBowl Whats.new -> Fixes and enhancements in BBSBowl all versions and updates. That's it! only three files necessary to start the game. Let's take a quick look at each file. BBSBowl.exe - This file has been PKlite'd with PKlite ver1.14. The executable file is only 36k. If you desire another compression method or do not want a compressed .EXE file I will be happy to give you an Un-Compressed version. Approx 100Kbytes. BowlCfg.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) BowlWin.dat - This is a simple two-line ASCII text file holding last month's winners Name and Score. BBSBowl.frm - This is the BBSBowl Registration form. Please refer to the section below for more information on registration procedures. Whats.new - This is quite simply a text files explaining the new features of BBSbowl version 1.4 - Please take a mintue to read through this file. All update information and instructions for upgrading to the latest version is in this file. Bowlogo.exe - This is a neat little 640x480x16 pcx file I wrote for the logo for bbsbowl ver 1.4 - Please be sure to check it out. Just type "bowlogo" at the dos prompt! = Files Created during Runtime = BBSBowl.dat - High score data file created after each game. This file contains all of the users scores, high game, average, and make-up day information. DO NOT EDIT OR MODIFY THIS FILE IN ANY WAY OR THE FILE WILL CORRUPT. In other words, any attempt to modify this file will result in corruption of bbsbowl.dat and when the next player plays a game it will be re-written or possibly garbaged! BBSBowl.log - Should a user drop carrier or a related error occur a file called "bbsbowl.log" will be created or appended showing this information. Also new in ver 1.4 - If the file bowlwin.dat is corrupt or missing it will re-create this file with "The Champion and 5000 points" and note this in the bbsbowl.log. Earlier version would quit back to the board with a run-time error. ╔════════════════════════════════════════════════════════════════════════╗ ║ ■ BBS Bowl Installation Instructions ■ ║ ╚════════════════════════════════════════════════════════════════════════╝ Installation of BBSBowl is quite simple. = BowlCfg.exe = First Copy all files to a subdirectory of your choice: C:\Doors\BBSbowl for example. Next run the Bowlcfg.exe file and answer all questions as explained above. I'll run quickly through all of the questions in Bowlcfg.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 BBSBowl 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 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 Bowlcfg.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 bowlcfg.exe will write the information given in a file called bbsbowl1.cfg. Run bowlcfg again for a second node and put a "2" here. Bowlcfg.exe will write bbsbowl2.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 "BBSBowl #" 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) The next screen will ask for the number of games-per-day to allow. Version 1.4 of BBSBowl now supports 1 to 3 games per day including make-up days. So please enter a 1,2 or 3 here. 5) NEXT IS A NEW FEATURE FOR VER1.1 - Allow the "Straight Roll" key. That is: I have had a request to make a key roll a straight ball. The "5" key (on the 10-key pad) will roll a straight ball. No need to hit "SpaceBar". Just hit the "5" key and it will roll a straight ball from your current position. If you answer "Y" here it will display "[5] - Straight Roll" in the user information area. If you answer "N" this function is not available and it is not displayed in the user information area. I feel this is almost like cheating when it is enabled so I made it sysop configurable. It's up to you! 6) 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. 7) 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 BBSBowl supports locked bauds up to 38400.) 8) Next it will ask for your Bulletin Board Name. Please enter your board name here. 9) The next Screen asks for the full path and FileName of the ANSI and ASCII bulletins you want generated by the game. BBSBowl will create an ANSI and ASCII bulletin showing the top 10 bowlers in the path and FileName of your choice. 10) 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 BBSBowl I will give you a Registration Key Number to install at this screen. Otherwise enter any number here or leave it blank. ******************************************************************************* ** Warning - for ver1.4 to work correctly you MUST run Bowlcfg.exe again and ** ** answer all questions. The "Straight Roll" key function was added here. ** ******************************************************************************* That covers all questions asked in Bowlcfg.exe. This will then write the configuration file "bbsbowl.cfg" for you in the current directory. ╔════════════════════════════════════════════════════════════════════════╗ ║ ■ BBS Bowl Command Line Parameters ■ ║ ╚════════════════════════════════════════════════════════════════════════╝ Now you have all of the necessary files written to run the game. That's it! The Command line (as of version 1.3 has only one switch which must to be given) Since ver 1.4 now 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 ■ "BBSbowl 1" -or- "BBSBowl" -> if no node is given "node 1" is assumed and "BBSBowl1.cfg is used. ■ Command Line for multi-node operation ■ "BBSBowl #" -> where "#" is the current node (1 - 9) This will use BBSBowl#.cfg for the user information and comm port etc. for each node. So to recap, Only three steps are necessary to install BBSBowl: 1) Unzip BBSBowl.zip to a subdirectory of your choice. 2) Run Bowlcfg.exe and answer all questions for each node. 3) Create any batch file and/or Update any door menu/util to run the game. ╔════════════════════════════════════════════════════════════════════════╗ ║ ■ BBS Bowl 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\BBSBOWL ---> (Change directory to the bbsbowl files) BBSBOWL 1 ---> (Run the game) CD\WILDCAT ---> (Change directory back to the board) = Batch example for RA (single node operation) = CD\DOORS\BBSBOWL ---> (Change directory to the bbsbowl files) BBSBOWL 1 ---> (Run the game) 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 BBSBOWL.EXE 1 *M = Batch example for RA node 2 = CD\DOORS\BBSBOWL ---> (Change directory to the bbsbowl files BBSBOWL 2 ---> (will use "bbsbowl2.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 bowlcfg.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 "bbsbowl #" then change directory back to the bbs on the next line. ╔════════════════════════════════════════════════════════════════════════╗ ║ ■ BBS Bowl Registration Information ■ ║ ╚════════════════════════════════════════════════════════════════════════╝ Registration of BBSBowl reflects the concept of "FairWare". I thought about this long and hard and decided that I would charge $15.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 BBSBowl. 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 $20.00 - That's $10.00 for a GREAT game! Registration brings you: ■ 99 player support ■ Full featured Make-Up Days ■ 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 "BBSBOWL.FRM" for Registration ═══════════ ╔════════════════════════════════════════════════════════════════════════╗ ║ ■ BBS Bowl 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 BBSBowl. 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.4 - My Latest and Best! BBSBowl ver 1.4 - 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! $10.00 * FileReq with Magic name "BBSBowl" @fidonet 1:116/43 Please forward any comments or suggestions to: James Fair or The Fishing Hole BBS 813 Bellevue Rd (615)646-5550 Nashville, TN 37221 fido-net 1:116/43