home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / p / peanut16.zip / PEANUTS.DOC < prev    next >
Text File  |  1993-02-21  |  13KB  |  287 lines
  1.          ┌▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄┐
  2.          ├▌▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▐┤
  3.  ────────┤▌ G  A  M  E  K  E  E  P  E  R    D  O  O  R  W  A  R  E ▐├────────
  4.          ├▌▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▐┤
  5.          ├▌▒▒▒▒▒▒▒▒▒  Quality BBS Door Software for Less!  ▒▒▒▒▒▒▒▒▐┤
  6.          ├▌▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▐┤
  7.          └▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀┘
  8.  
  9.                                P E A N U T S !
  10.                                ~~~~~~~~~~~~~~~
  11.                                  Version 1.6
  12.  
  13.                     Copyright (c) Steve Sharpe 1992,1993
  14.  
  15. SYSTEM REQUIREMENTS
  16. ~~~~~~~~~~~~~~~~~~~
  17. Any BBS capable of producing the following DOOR.SYS drop files:
  18.  
  19.    *  Original "GAP standard" DOOR.SYS (31 line version)
  20.         - for example, Spitfire BBSs use this one!
  21.  
  22.    *  New (currently 52 line) version DOOR.SYS promoted by Raymond Clements
  23.         - for example, PCBoard BBSs use this one!
  24.  
  25. PEANUTS! can be played using ANSI color or monochrome graphics, however, the
  26. game is easier to play in color.
  27.  
  28. SYSTEM OPTIONS
  29. ~~~~~~~~~~~~~~
  30. PEANUTS! supports the use of FOSSIL drivers and non-standard port
  31. addresses.  Refer to the INSTALLATION instructions for more information.
  32.  
  33. FILES CONTAINED IN PEANUT16.ZIP
  34. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  35.      PEANUT16.EXE   <-- The main program
  36.      PEANUTS.DOC    <-- The file you are reading!
  37.      GAME.CFG       <-- The game configuration file
  38.      REVISION.DOC   <-- Revision notes
  39.      DOORWARE.DOC   <-- Gamekeeper Doorware
  40.  
  41. FILES CREATED BY PEANUT16.EXE
  42. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  43.      PERFECT.SCR   <-- Most recent perfect score *
  44.      HIGHEST.SCR   <-- Highest score less than 52 points *
  45.  
  46. * REGISTERED VERSION ONLY
  47.  
  48. OVERVIEW
  49. ~~~~~~~~
  50. Peanuts! is a variation of the many versions of playing card solitaire. 
  51. In this BBS game, the object is to score as many points as possible within 
  52. the 10 minutes that are allocated for the game! 
  53.  
  54. The Deal 
  55. ~~~~~~~~ 
  56. A standard deck of 52 cards is shuffled prior to the start of each game.  The 
  57. first 5 cards are dealt face up across the screen.   The next 11 cards are 
  58. placed in the lower left corner of the screen and named the draw pile.  The 
  59. top card of the draw pile is exposed.  The remaining 36 cards are placed in 
  60. the lower right corner of the screen and named the main pile.  All cards in 
  61. the main pile are face down. 
  62.  
  63. The Layout 
  64. ~~~~~~~~~~ 
  65. Valid locations for cards are identified by column letters.  Card suit spots 
  66. are placed across the top of the screen.  These spots are used to collect 
  67. cards in their respective suits from Ace (low) through King.  A menu area at 
  68. the bottom of the screen allows the player to select a move menu, start a new
  69. game, or quit.
  70.  
  71. The Play 
  72. ~~~~~~~~ 
  73. Players have 10 minutes to earn as many points as possible.  1 point is earned 
  74. for every card that is placed in the applicable suit spot at the top of the 
  75. screen.  As such, a perfect game is 52 points.  There is a challenge though! 
  76. The game ends when time expires or the draw pile is exhausted.  If you run 
  77. out of time, no points are credited.  As soon as the last draw pile card is 
  78. played, the game calls "PEANUTS!" and the score is calculated. 
  79.  
  80. Cards can only be placed on the suit spots in ascending order from Ace to King. 
  81. No cards can be moved to the draw or main piles.  Cards placed in the center 
  82. playing area (5 columns) must be stacked in alternating colors and normal card 
  83. number/letter order.  Players can move the bottom card from columns to any 
  84. valid destination.  Entire columns can be moved between columns as long as the 
  85. top card of the moving column falls in sequence with the bottom card of the 
  86. receiving column.  Cards that are buried in the middle of columns cannot be 
  87. accessed until the lower cards have been moved individually.  Error messages 
  88. reflect invalid move attempts!  Main pile cards are dealt in groups of 3.  This 
  89. means the number of different cards available for immediate use from the main 
  90. pile varies depending on how many total cards remain in the pile.  When the 
  91. main pile falls below 4 cards, only the card on the bottom of the pile can be 
  92. displayed.  The player must find a use for it before the next card will be 
  93. exposed!  With a little luck and some steady nerves, you can achieve a perfect 
  94. game! 
  95.  
  96. INSTALLATION
  97. ~~~~~~~~~~~~
  98. PEANUTS! is easy to install.  Simply follow these steps:
  99.  
  100. 1.  'Unzip' the file PEANUT16.ZIP into the directory of your choice.  All
  101. files must remain in the same directory.
  102.  
  103. 2.  Edit the GAME.CFG configuration file according to the CONFIGURATION FILE
  104. section of these instructions using your favorite word processor.  Ensure you
  105. save it as an ASCII text file.
  106.  
  107. 3.  Create or edit the batch file your BBS will use to activate the door.
  108. The main door program name is PEANUT16.EXE.  For example, if you are running
  109. a Spitfire BBS, you would edit SF.BAT to look similar to the following:
  110.  
  111. :DOOR_A
  112.    REM Place Door A Commands Here
  113.    CD\SF\DOORS\PEANUTS   <-- Change to the PEANUTS! directory
  114.    PEANUT16 GAME.CFG     <-- The main program with configuration file argument
  115.    CD\SF                 <-- Change back to the Spitfire directory
  116.    GOTO LOOP
  117.  
  118. NON-STANDARD PORT USE:  You may specify the use of non-standard communications
  119. ports with the PORT command.  The syntax for the PORT command is PORT:03E8:5,
  120. where 03E8 represents a different base address and 5 indicates the IRQ.  For
  121. example, the main program line in the example above would be changed to
  122. PEANUT16 GAME.CFG PORT:03E8:5 to reflect the use of a non-standard comm port.
  123.  
  124. FOSSIL DRIVER USE:  You may specify the use of a FOSSIL driver with the PORT
  125. command added to the main program command line.  The syntax for the PORT
  126. command is PORT:F:P, where F instructs the door to use a FOSSIL driver and P
  127. identifies the port.  For example, the main program line in the example above
  128. would be changed to PEANUT16 GAME.CFG PORT:F:1 if the SysOp wished to specify
  129. a FOSSIL driver on port 1.
  130.  
  131. NOTE:  The PORT command must be the third command in the main program command
  132. line, if used.  If not used, the door defaults to the use of the 4 standard
  133. communications ports (1-4) by reading the BBS file.
  134.  
  135. CONFIGURATION FILE
  136. ~~~~~~~~~~~~~~~~~~
  137. Entries in the GAME.CFG file must be accurate or the door cannot be expected
  138. to function properly.  Save your changes to the GAME.CFG file in ASCII text
  139. format.
  140.  
  141. The GAME.CFG file
  142. ~~~~~~~~~~~~~~~~~
  143. Peanuts!                    <-- Line 1  (See below)
  144. c:\sf\door.sys              <-- Line 2    "     "
  145. The Gamekeeper's Lair       <-- Line 3    "     "
  146. Steve Sharpe                <-- Line 4    "     "
  147. 000000000000                <-- Line 5    "     "
  148. 1                           <-- Line 6    "     "
  149.  
  150. Line 1 - This line reflects the name of the door.  The registration algorithm
  151. is based on some of this data.  DO NOT CHANGE LINE 1!
  152.  
  153. Line 2 - Enter the full path and filename for the BBS DOOR.SYS file.
  154.  
  155. Line 3 - Enter the name of your BBS.
  156.  
  157. Line 4 - Enter the SysOp's name.
  158.  
  159. Line 5 - Enter 12 zeros if the door is not registered.  Registered users enter
  160. the registration number provided by the author.  Other numbers will prevent
  161. the door from running.
  162.  
  163. Line 6 - Enter 1 if your BBS DOOR.SYS drop file is the original GAP standard
  164. 31 line version.  Enter 2 if your BBS DOOR.SYS drop file is the newer (longer)
  165. version (presently 52 lines).
  166.  
  167. SYSOP KEYS
  168. ~~~~~~~~~~
  169. The following keys assist the SysOp in the management of the door:
  170.  
  171.          F5 - Shell to DOS
  172.          F8 - Return user to system
  173.          F9 - Toggle display on/off
  174.         F10 - Chat mode (ESC to exit)
  175.       ALT H - Toggle between status lines
  176.  
  177. REGISTRATION
  178. ~~~~~~~~~~~~
  179. Registered versions of PEANUTS! display a high score screen upon exit.
  180. The registration fee for PEANUTS! is $10.  The unregistered door displays
  181. "EVALUATION COPY" upon entry and exit.  Please register or remove the door
  182. within 90 days of first use.  As a BBS SysOp, I understand how costly it can
  183. be to register BBS software.  I have purposely kept the cost of registering
  184. PEANUTS! to a minimum with that thought in mind.  I believe the fee is
  185. quite reasonable, based on the many long hours of programming required.  Upon
  186. receipt of the registration fee, you will be provided with a unique
  187. registration number.  Once you insert the registration number into the GAME.CFG
  188. file, the opening and closing "EVALUATION COPY" messages will be replaced with
  189. the following messages:
  190.  
  191. [OPENING MESSAGE]
  192.  
  193.                                 Your BBS name
  194.  
  195.                                   presents
  196.  
  197. [CLOSING MESSAGE]
  198.  
  199.                              Thanks for playing
  200.  
  201.                                   Peanuts!
  202.  
  203.                                      on
  204.  
  205.                                Your BBS name
  206.  
  207. COMMENTS/BUG REPORTS
  208. ~~~~~~~~~~~~~~~~~~~~
  209. I'm interested in all user comments and bug reports.  Please send your comments
  210. to:
  211.  
  212. Steve Sharpe                              Call The Gamekeeper's Lair BBS
  213. 1835 Stonetree Dr.              or        (208) 587-1105
  214. Mountain Home, ID 83647                   and leave a message
  215.  
  216.                                  Warranty
  217.                                ------------
  218.        This program has been thoroughly tested on a Spitfire 3.2 BBS,
  219.        however, it should perform equally well on any BBS that can
  220.        produce a BBS drop file listed in this documentation.
  221.  
  222.        I make no warranty of any kind, express or implied, including
  223.        without limitation, any warranties of merchantability and/or
  224.        fitness for a particular purpose.  I shall not be held liable for
  225.        any  damages, whether direct, indirect, special or consequential
  226.        arising from a failure  of this program to operate in the manner
  227.        desired by the user.  I shall not be held liable for any damage to
  228.        data or property which may be caused directly or indirectly by the
  229.        use of this program.
  230.  
  231.        In no event will I be held liable for any damages, including (but
  232.        not limited to) any lost profits, lost savings or other incidental
  233.        or consequential damages arising out of the use or inability to
  234.        use this program, or for any claim by any other party.
  235.  
  236.        This warranty is governed by the laws of the State of Idaho.
  237.                               REGISTRATION FORM
  238.                               -----------------
  239.  
  240.   PEANUTS!                         Return to:  Steve Sharpe
  241.   Version 1.6                                  Attn: Door Registration
  242.   Registration Cost: $10                       1835 Stonetree Dr.
  243.                                                Mountain Home, ID 83647
  244.  
  245.   Name ______________________________________________________________
  246.  
  247.   Address ___________________________________________________________
  248.  
  249.           ___________________________________________________________
  250.  
  251.   Voice Phone _____________________ Data Phone ______________________
  252.  
  253.   Enter GAME.CFG file information below:
  254.  
  255.   BBS Name______________________________________________
  256.  
  257.   SysOp Name____________________________________________
  258.  
  259.   CHOOSE ONE OPTION BELOW:
  260.  
  261.   ____  I wish to download my registration number from The Gamekeeper's Lair
  262.         BBS at (208) 587-1105.  Enter the password you will use to log on to
  263.         The Gamekeeper's Lair BBS: _________________________________________
  264.         Enter your birthdate for pre-verification: _________________________
  265.         Please allow enough time for your registration fee to reach the author
  266.         before calling for your registration number.
  267.  
  268.   ____  I wish to have my registration number mailed to the address listed
  269.         above.
  270.  
  271.   ____  I would like a disk of all Gamekeeper Doorware and my registration
  272.         number mailed to the address listed above (add $2.00 for shipping
  273.         and handling).        Circle disk size   [ 5.25 ] or [ 3.5 ]
  274.  
  275.   Orders outside the USA add $2.00 . . . . . . . . . . . . _________
  276.  
  277.       Please find enclosed a check or money order for USA $_________
  278.   payable to Steve Sharpe.  This shows my support of Shareware products
  279.   and the Shareware concept.  It also shows my encouragement to help further
  280.   the development of BBS doors.
  281.  
  282.       I understand that PEANUTS! is provided as-is and no warranties of
  283.   any kind, expressed or otherwise, are included and that I am using it at my
  284.   own risk.
  285.  
  286.   Signed: _________________________________________  Date: _________
  287.