ftp.wwiv.com

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

/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / CL_SOL20.ZIP / CLASSIC.DOC < prev next >

Wrap

Text File | 1995-02-09 | 22KB | 561 lines

┌──────────────────────────────────┐ │ Classic Solitaire- BBS door game │█ └──────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Version number: 2.0 Release date: February 9, 1995 Programmed by: Tim L Winkfein- McKinney, Texas Copyright: (c) 1994,95 by Tim L Winkfein, All rights reserved. Registration fee: $15.00 Supported drop files: DOOR.SYS DORINFOx.DEF PCBOARD.SYS INFO.BBS SFDOORS.DAT CHAIN.TXT JUMPER.DAT TRIBBS.SYS CALLINFO.BBS If your BBS uses a drop file other than one directly supported, you will need to use some type of conversion utility to convert it to a supported format. ┌──────────────────────────────────┐ │ Acknowledgments │█ └──────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Thanks to the three best BBS SysOp's on the planet, for ALL of their time, patience, and help during development and Beta testing of Classic Solitaire on their systems. (in order of appearance) Jim Green Castle Rock BBS (214)613-9422 Stan Gunn Blue Event Horizon BBS (214)373-6732 Ron Oliveri The Black Gate BBS (214)519-0080 A big thanks to the people that made the DDPlus Door Driver possible: Scott Baker Derrick Parkhurst Steven Lorenz Bob Dalton A special thank you to all of the wonderful players on Castle Rock BBS for their patience during the "NO CARRIER" phase of development! ┌──────────────────────────────────┐ │ Licensing agreement │█ └──────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ By registering Classic Solitaire you are granted a users license that gives you the right to use the Classic Solitaire door game under the following conditions: You are granted rights to use Classic Solitaire on a single BBS System. You do not become an owner of Classic Solitaire, you become a licensed user. TiJaSoft and Tim L Winkfein retains all rights to the software, copies of the software, and all materials pertaining to this product. You must agree to protect the registered copy of Classic Solitaire from unauthorized use, reproduction, and distribution to a reasonable degree. Failure to comply with this license agreement will result in suspension of your License to Classic Solitaire without refund. ┌──────────────────────────────────┐ │ Warranty │█ └──────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ This software product is provided "as is" and without warranty of any kind. The risk of using this program is completely assumed by you. I, the author of this Classic Solitaire door game, disclaim any and all responsibilities for any undesirable results caused by the use, or misuse of this product, including system damage, loss of profit, or anything else that may occur. ┌──────────────────────────────────┐ │ Shareware │█ └──────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Classic Solitaire is being marketed under the SHAREWARE concept. you may use the Shareware version free for a period of time not to exceed thirty days. Thirty days is more than ample time to evaluate the usefulness of this product. After this trial period, you must either register Classic Solitaire and obtain your license, or discontinue usage of the game. Please help support the Shareware concept and register this program! ┌──────────────────────────────────┐ │ Game features │█ └──────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Easy set-up and configuration. Make-up and Play-ahead days, with calendar. (Registered version only) AutoPlay function to finish out a hand that has been won. Automatic daily and monthly maintenance. Auto-detects RIP and adjusts users font to full screen mode. Exports ANSI and ASCII scores bulletins. Configuration file editor for easy and complete game control. Data file editor in case a user drops carrier in the middle of a game. Customizable by changing colors of game and adding initials to card back. Tournament mode option so each player gets the same hands each day. Redraw option for line noise, etc. Automatically tracks last months champion and all-time champion. Full ANSI support. Optionally keep log file of game activity. Carrier drop detection. All future upgrades are free, uses same key. (Registered version only) ┌──────────────────────────────────┐ │ How to register │█ └──────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ We will accept a check, money order, or credit cards drawn in U.S. funds. Please see the file ORDER.FRM included in this package for an order form that you can print-out or copy. Fill it out completely with all requested information and send it along with payment to the address on the form. If possible, edit that file with all requested information with a text editor before printing, doing this will help avoid confusion's in penmanship. See ONLINE.REG for informatiuon about on-line credit card and checking account registration through my BBS or by voice call. ┌──────────────────────────────────┐ │ Installation │█ └──────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Installation is simple, even if you have never set-up a door program before. First: create a sub-directory for the door game and copy all of Classic Solitaire's files into it. Next: you should run the configuration file editor "CS_CFG.EXE" to set up the game configuration options, such as path to bulletins, number of hands, colors, tournament mode status, etc. Then: manually edit the CLASSIC.CTL file to set up the communications aspect of Classic Solitaire, this file is heavily documented for your convenience. Finally: execute "CLASSIC.EXE /L" to run in Local mode. ** See !README.1ST for additional installation tips. *** Classic Solitaire's directory must be current to run, you may need to create a batch file to change the directory to run the game, then change it back afterwards, if your BBS requires its directory to be current. --- The first time Classic Solitaire is executed, it will create five files: CLASSIC.DF1- This is the main binary data file that holds all player information and scores for the entire month. CLASSIC.DF2- This binary file stores last months champ, all time champ, current leaders and a few other items necessary for the program to have. CLASSIC.ANS- ANSI scores bulletin. (These files are updated each time a user exits Classic Solitaire) CLASSIC.ASC- ASCII scores bulletin. HANDS.DAT- This small 62 byte file holds the random number seeds for all days of the month for tournament mode. If, for some reason, any of these files become corrupt, you can simply delete them and allow the program to re-create them upon execution. ** If you delete the data files, ALL PREVIOUS RECORDS WILL BE LOST! **** If an abnormal exit occurs, that is, other than exiting from one of the menus, a file named ERROR.LOG will be generated holding information that will help us to track down the problem. If you need assistance, please have this file available along with the USER.LOG file. ┌──────────────────────────────────┐ │ The CLASSIC.CFG file │█ └──────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Before running Classic Solitaire, the configuration file should be created. This can be done two different ways, the best way is to use the configuration file editor included with this package, using this you can set the Path to the bulletin files along with other items. The other way is with a text file editor. About the only reason that you may want to do this is if you lose the editor, or if you want to make a simple change to the config file quickly. A file named CLASSIC.CFG will be created. This ASCII text file contains the configurable aspects of the game, listed below. Listed below are the actual defaults of the configuration file, the line numbers have been added for detailed instructions. 1) PATH TO BULLETINS: (leave blank for current directory) 2) REG GAMES: 3 3) MAX GAMES: 10 4) EXTRA DAYS: 3 5) PAD START: 20 6) NUM ROUNDS: 5 7) MAIN: BLUE 8) CARD: MAGENTA 9) MSG: SOL 10) LOG: OFF 11) TOURNY: ON Line # and Description 1) The first line is for the path to your bulletins. DEFAULT: blank (current Classic directory) 2) This is the number of regular games that you will allow your users to play each day, this is not including free games. DEFAULT: 3 games per day. 3) This line holds the MAXIMUM number of games your users will be allowed to play each day, this is including free games. DEFAULT: 10 games maximum per day. 4) This line controls the number of extra days your users are allowed to play each day. This is in addition to their current days play. DEFAULT: 3 extra days allowed per day. 5) This number controls the day that your users can begin play-ahead days. DEFAULT: 20th day of the month. 6) This number controls the number of times the player can go through the deck each game. DEFAULT: 5 rounds per game. 7) This number controls the main display color of the game. This includes the main frame, the upper & the lower status bars, and the View Scores screen. Valid colors are: blue green cyan red magenta brown gray DEFAULT: BLUE. 8) This number controls the color of the card's back. The same color choices as above are active. DEFAULT: MAGENTA. 9) This is the 3 character message that is displayed on the back of the cards, it can be any 3 ASCII characters. DEFAULT: 'SOL'. 10) This line is a simple ON or OFF option that tells the program whether to keep a log file of game activity or not. An ON here will instruct Classic to keep a log file named "USER.LOG" in the current directory, an OFF will not keep a log file. DEFAULT: 'OFF', no log file kept. 11) This is another ON or OFF prompt, for tournament mode. An "ON" here will activate the tournament mode, and will deal the same hands to each player each day, An OFF here will de-activate Tournament mode. DEFAULT: 'ON', Tournament mode is active. ┌──────────────────────────────────┐ │ Automatic daily & monthly reset │█ └──────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Classic Solitaire will automatically reset all of the daily statistics with the first player of each day. Classic Solitaire will also reset for the month with the first caller of each month. The player file will be re-initialized with no players, the records file will be updated with a new Last Months Champion and All Time Champion (if applicable), the new random numbers will be generated for tournament mode play, and all the players, their scores, and other data from last month will be exported to a file named "LASTMNTH.TOP" in Classic Solitaire's directory. This is the file that is displayed when a user elects to view last month's scores from the start-up or exit menu and is a DOS text file that you can edit if necessary, or if you want to add your own comments for your users to see. This file is over-written each month with the new scores, simply copy this file under a new name each month if you want to keep all scores. * Classic Solitaire will look for a file named "LASTMNTH.TOP" to display last months scores, so do not just rename it. ┌──────────────────────────────────┐ │ How to play Classic Solitaire │█ └──────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ There are many different ways to play Solitaire. It seams like everyone plays at least, a little differently. The rules I used in writing this game are, for the most part, the rules established in the book "The new complete Hoyle, revised" published by Doubleday, with a couple of minor modifications to help improve your chances of winning. --- Object of the Game --- The object of the Classic Solitaire game is to use all of the 52 cards in the deck to build up all four suit stacks from Ace to King. --- Cursor and card movement --- This game is best played using the number keypad on the right side of your keyboard. The keystrokes used are laid out in as simple a pattern as possible, plus these keys are the standard for most card games. [Key] Reaction [ENTER] Spreads a new set of play cards from the stock pile, if any. If all cards have been spread, this will replace the cards to the stock pile, if you have any rounds remaining. ENTER will automatically place the cursor on the next playable card on the talon. [5] The "5" key is the card movement key. Position the cursor over the row of the card you want to move (or over the talon) and press "5" to select that card, then move the cursor to the row where you want to move the card to and press the "5" key again to place the card. The game will not allow you to make an illegal move. [4,6] Press "4" to move to the row to the left, or "6" to move to the row to the right. If the cursor is on one of the end rows, it will wrap to the other side. These keys have no effect when the cursor is on the talon unless a card is selected, if a card is selected, press "4" to jump to the right row, "6" to jump to the left row. [2] Press the "2" key when you want to move between the rows and the talon. pressing "2" while on one of the top rows will place the cursor on the next playable card on the talon, pressing "2" while on the talon will place the cursor on the row you were last on before moving there. [8] Press the "8" key to play a card on its suit stack. Position the cursor over the row (or on the talon) of the card you want to move to its suit stack and press "8". This will automatically move that card to the correct suit pile and credit your account 100 points. --- Rules of the Game --- Solitaire has four game areas: Stock pile- Located at the lower left of the playing area, these cards are always face down while in stock. The Talon- This is the play stack located next to the stock. These are the cards spread from stock, and only the top most card is playable. Suit stacks- Located at the upper left of the screen, this is where you build the suits from Ace to King. The suit stacks start out empty, and once a card has been played here, it cannot be moved. The Tableau- This is the main play field consisting of seven rows. The number of cards in each row increases from one to seven, from left to right. The top card of each row is face up, and is playable, the rest are face down and cannot be played. You draw cards from stock three at a time and move the top "playable" card to its suit stack or to a row if you can. The number of cards remaining in stock is displayed to the left of the stock pile. When you have used all the cards from the stock pile, you can "turn the deck over" and continue to draw cards, the number of times you can go through the deck is set by the SysOp, but defaults to 5. You build the rows in descending order, alternating between red and black cards. For example: a red 7 can only be played on a black 8. Suit does not make a difference unless playing to the suit stacks. All face-up cards on a row must be moved as a single unit. You can move a card in a row to another row or to a suit stack. If you uncover a face-down card in a row, the program will turn the card face-up. You can only move a King to an empty row. You build the suit stacks in ascending order, starting with the Ace. You may only move an Ace to an empty suit stack. You win the game when you have used all cards in the deck to build the four suit stacks up to the King. --- Scoring --- You are awarded 100 points each time you play a card to its suit stack, for a total of 5200 points for winning the game. You receive a 500 point bonus each time you move all four of the same value card to their suit stacks, for example, play all four Aces to their suit stacks, all four twos, all four threes, etc. through the Queen, for a total of 6000 points for winning the game. When you move all four Kings, i.e. win a game, you get a free game and a 5000 point bonus! The grand total for winning the game is 16200 points. ┌──────────────────────────────────┐ │ Included files │█ └──────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ This list of files are the files found in the archive, and does not include those created during program execution. CLASSIC.CTL - Communications control file and BBS set-up. CLASSIC.DOC - Your reading it! CLASSIC.EXE - Main executable program. CLASSIC.HLP - On-line help file used in the program with ANSI codes. COMBO.TXT - Information on discounts for buying 2 games. CONVERT.EXE - Conversion utility to convert v1.x data files to v2.0+ CS_CFG.EXE - Stand alone configuration file editor. CS_CFG.TXT - Instructions for CS_CFG.EXE. CS_DFED.EXE - Data file editor in case a user drops carrier during game. CS_DFED.TXT - Instructions for CS_DFED.EXE. FILE_ID.DIZ - Description file used by some BBS's. HISTORY.TXT - Revision history for Classic Solitaire. ONLINE.REG - On-line credit card & checking account ordering info. ORDER.FRM - Registration form for Classic Solitaire. !README.1ST - Quick-start and last minute info text file. REG-USER.TXT - Info on how registered users can get their free key. ┌──────────────────────────────────┐ │ Distribution │█ └──────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ You are allowed, and even encouraged to distribute the Shareware version of Classic Solitaire, provided that all files contained in the original CL_SOL20.ZIP archive are packed in their original, unmodified state. Please give this to all of your friends and upload it to all of your favorite BBS's. The registered key for Classic Solitaire MAY NOT be distributed in any way, shape, or form. See license agreement above. ┌──────────────────────────────────┐ │ The CLUB character │█ └──────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ One problem that plagues most card based door games is the Club character failing to appear on the cards. This can be controlled by the user. Some communication programs default to ON for CompuServe quick B file transfers, (sometimes called CIS-B), if it is set to ON, the communication program will strip the ASCII Code #005, which is the CLUB character used on the card. And could cause the program to hang. Have your users set this to OFF if the Club character does not appear on the cards or if the user has problems staying connected. This configuration option can generally be found in their communication program's Terminal Set-up area. I have added a screen at the beginning that will ask the users once a month if the Club character is visable, hopefully this will help with this problem! ┌──────────────────────────────────┐ │ Technical Support/Who to contact │█ └──────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ I do support, and will continue to support all door games that I write. If you have any problems with Classic Solitaire, or any TiJaSoft door game you can contact me via US Mail, my support BBS, by voice phone, or by contacting one of the other BBS's as listed below. All upgrades to my doors will be FREE to currently registered users. The only cost to them will be picking up the new version! Any comments or suggestions you may have can also be forwarded to one of the following addresses. Mailing Address: TiJaSoft P.O. Box 313 McKinney, Texas 75070-0313 Support BBS: TiJaSoft BBS (214)562-9402 anytime except ZMH 1,200-28,800 bps Voice phone: (214) 562-TiJa (8452) You may also leave me mail on one of these fine BBS's, I usually check in daily, so your message will be answered promptly. You can also find all the latest versions of my software here. BBS SysOp Phone Castle Rock Jim Green (214)613-9422 Blue Event Horizon Stan Gunn (214)373-6732 You can also catch me in the ON-LINE-GAMES, DOORGAMES or DOORWARE echoes on FidoNet.