home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_door / pyramid1.arj / PYRAMID.DOC < prev    next >
Text File  |  1991-07-04  |  16KB  |  528 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                  ┌────────────────────────────────────────────┐
  15.                  │                                            │
  16.                  │              Pyramid Guppies               │
  17.                  │           =======================          │
  18.                  │                                            │
  19.                  │         A Live Game for Many BBS's         │
  20.                  │                                            │
  21.                  │   Game Release Version 1.0 - 01/20/91      │
  22.                  │                                            │
  23.                  │             (C)opyright 1990               │
  24.                  │                                            │
  25.                  │                   By                       │
  26.                  │                                            │
  27.                  │            SECRET SERVICE BBS              │
  28.                  │                                            │
  29.                  │              Mike Wilson                   │
  30.                  │             P.O. Box 9521                  │
  31.                  │            Huntington, WV                  │
  32.                  │                  25704                     │
  33.                  │                                            │
  34.                  │            BBS (304) 429-6838              │
  35.                  │            1200/2400/9600 24 hrs.          │
  36.                  │                                            │
  37.                  │                                            │
  38.                  │                                            │
  39.                  │                                            │
  40.                  └────────────────────────────────────────────┘
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.               Pyramid Guppies  (C)opyright 1990 - Page 1
  67.  
  68.  
  69.  
  70.  
  71.                                   Warranty
  72.  
  73.  
  74. This is product is provided "as is" without warranty of any kind.  The
  75. entire risk as to the results and performance of the program is assumed by
  76. you. Futher more, I the author do not warrant, guarantee, or make any
  77. representations regarding the use of, or the results of the use of the program,
  78. and you rely on the program and results solely at your own risk.  I the author
  79. cannot accept responsibility for system damage, loss of profit, or any other
  80. special, incidental, or consequential damages resulting from the use or
  81. inability to use this product.
  82.  
  83.  
  84.                                  Copyright
  85.  
  86.  
  87. The Multi-Board Pyramid Guppies live game is distributed as SHAREWARE.
  88. Under this concept you may use the SHAREWARE (unregistered) version for a
  89. reasonable period of time, which I consider to be three weeks, after which you
  90. must either register your copy or discontinue usage.
  91.  
  92.  
  93.                                Registration
  94.  
  95. With registration you will recieve the latest registered copy of Pyramid
  96. Guppies with the ability to download any futher updates from Secret Service BBS
  97. at no extra  cost. You will also recieve any support the author can give
  98. in reference to bugs or other problems that may arise in using the game.
  99.  
  100. I feel that sysop's have enough expense without charging a high cost for a game
  101. for their users. I have set the cost of registration at $20.00 which I feel
  102. if people will follow the shareware concept will be enough to cover shipping
  103. and handling and encourage me to write more doors.
  104. See register.txt for ordering instructions.
  105.  
  106.  
  107.                                Distribution
  108.  
  109. You are free, in fact encouraged, to distribute the SHAREWARE (unregistered)
  110. version of Multi-board Pyramid Guppies Live Game provided that all files
  111. contained in the original Pyramid Guppies archive are distributed in their
  112. original unmodified state.
  113.  
  114.  
  115.  
  116.                                Introduction
  117.                                      &
  118.                                 How To Play
  119.  
  120. Pyramid Guppies is a Pyramid version of the popular card game. The cards
  121. are dealt into a pyramid and a user bets on whether the next card will
  122. be higher or lower than the display card. Users may then use the number
  123. locked arrow keys to pick the next card to turn over.
  124. On the last card a player must bet at least half of his account.
  125. A joker appears on occassion and causes the player to lose whatever
  126. he has won during that day.  If he has lost then the new lower score
  127. is saved.
  128.  
  129.  
  130.  
  131.  
  132.               Pyramid Guppies  (C)opyright 1990   Page - 2
  133.  
  134.  
  135.  
  136.                           Options and Information
  137.  
  138. This door game will also create color and mono top 10 bulletins and write them
  139. in directories of your choice written in the .CFG file. The top player of the
  140. previous month is displayed within the bulletins as well as the all time
  141. high scorer.
  142.  
  143.  
  144.  
  145.                       Installation and Setup
  146.  
  147. Setup of the game is a simple procedure. Create a directory for Pyramid
  148. Guppies and unzip the files in Pyramid.zip into the directory.
  149. Run Setup.exe and answer the questions that are asked. (If your unsure
  150. of an answer refer to areas described below in the docs).
  151. Once you answer the questions in the setup program set up a batch
  152. file to call it from within your bbs as described in the batch
  153. file section of these docs.
  154.  
  155. I will describe each file that exists or is created by Setup.exe
  156.  
  157.  
  158. Pyramid.CFG contains:
  159.  
  160. The Secret Service BBS           <-- Name of BBS
  161. Mike                             <-- Sysop's first name
  162. Wilson                           <-- Sysop's last name
  163. C:\Path\BBSinfo.???              <-- Path and filename for Board Info File
  164. C:\Path\Bulletin.clr   <-- Path & Filename to create COLOR bulletin
  165. C:\Path\Bulletin.asc   <-- Path & Filename to create MONO bulletin
  166. NO                               <-- NO or locked COM PORT Baud Rate
  167.  
  168. The line above that references the path and name of the board info file
  169. should be the path and file to the file that your particular BBS creates
  170. when it drops out to run a game. This would be:
  171. WILDCAT prior to V3.0 --> Callinfo.bbs     Spitfire --> SFDoors.dat
  172. GAP or WILDCAT 3.0+ ----> Door.sys         PCBoard -> PCBoard.sys
  173. QuickBBS ---> DorinfoX.Def (The X is 1 or 2 depending on node)
  174.  
  175. The path to color and mono bulletins can be any valid path and any
  176. valid name that you want the top ten scores bulletins written to.
  177.  
  178.  
  179. NOTE FOR MULTI NODES!
  180. You may now have several .cfg files to allow use on multinode systems.
  181. Use the above .cfg format but name each .cfg file differently. Just use
  182. an ASCII format word processor or Copy Con or Edlin. You may call
  183. them what you want as long as you correctly call them from the
  184. batch file command line.
  185.  
  186. Example:    Node1:     game game.cfg
  187.  
  188.             Node2:     game game1.cfg
  189.  
  190.  
  191. ** NOTE: If you run Multi-nodes and use a Non-Standard Port Address
  192.          or IRQ value then read PORT.DOC to set these up!
  193.  
  194.  
  195.  
  196.  
  197.  
  198.               Pyramid Guppies  (C)opyright 1990  Page - 3
  199.  
  200.  
  201.  
  202. Pyramid.DAT contains:
  203.  
  204.  
  205. This file contains the following user data:
  206.  
  207. "The Champion","01-20-1991","100"
  208.  
  209. Data has to be kept in this format, but you can delete all lines except for
  210. line number 1 which is the Last Months Champ line. You can alter line 1 but
  211. not remove it. You need to alter line 1's Date form 01-12-1990 to the month
  212. that your setting up this door. For example if it is December just simply
  213. change the Date to 12-01-1990. It doesn't matter if it's the 1st or the 10th,
  214. only the Month (12) will make any difference.
  215.  
  216.  
  217. Pyramid.TXT contains:
  218.  
  219. This is the instruction file for Pyramid Guppies. When a user selects the
  220. See Instructions option during the game, this file is read for
  221. instructions. This file MUST BE PRESENT and Not altered in any way for
  222. Pyramid Guppies to run properly
  223.  
  224.  
  225.  
  226. BOARD.TXT
  227. ---------
  228. Don't worry about this file. It is created when you run setup.exe
  229. This file tells the game which BBS Software you are running and
  230. tells it to read the correct board file. THERE SHOULD NOT BE A
  231. BOARD.TXT FILE IN THE GAME DIRECTORY IF YOUR RUNNING WILDCAT
  232. PRIOR TO VERSION 3.0!
  233. The game looks for this file and defaults to Wildcat if it isn't
  234. found.
  235. For other boards it will contain one line with one of the following:
  236. QuickBBS --------> QBBS         GAP or WILDCAT 3.0+ ------> GAP
  237. PCBoard ---------> PCB          Spitfire -----------------> SPITFIRE
  238.  
  239.  
  240.  
  241. PORT.DOC
  242. ---------
  243. Read this only if you run coms 3 or 4 as Non-standard port addresses
  244. or non-standard IRQ's.
  245.  
  246.  
  247.                           List of Files In Archive
  248.  
  249. The following files are either found in your Pyramid Guppies .ZIP or will be
  250. created during the runtime execution of the game.
  251.  
  252.  
  253. Pyramid.EXE    <--- Executable Program.
  254.  
  255. Setup.exe    <--- Setup program for Pyramid Guppies
  256.  
  257. Pyramid.DAT    <--- Store User's Name, Last Play Date & Score.
  258.  
  259. Pyramid.TXT    <--- Instructions Used By Program.
  260.  
  261. BULLET##.SCR *<--- COLOR Bulletin
  262.  
  263.  
  264.               Pyramid Guppies  (C)opyright 1990  Page - 4
  265.  
  266. BULLET##.BBS *<--- MONO Bulletin
  267.  
  268. Pyramid.DOC    <--- This File.
  269.  
  270. Champion.txt <--- The file that stores the all time champion score
  271.  
  272. Register.txt <--- Registration Information
  273.  
  274. Port.doc <------- Information on setting up Non-standard Ports & IRQ's
  275.  
  276. * DENOTES that file is created during RUN-TIME.
  277.  
  278.                                   Batch Files
  279.                                =================
  280.  
  281. Be sure that you have edited or created the Pyramid.CFG file with the correct
  282. information as described earlier in these docs. The individual setups do not
  283. repeat this necessary process.
  284.  
  285. Wildcat! 1.13 & 2.0+ Setup:
  286. ---------------------------
  287. First, create your DOOR##.BAT (2.0+) or LIVE##.BAT (1.13) like this eample:
  288.  
  289.    ECHO OFF
  290.    CD \WILDCAT\DOORS\Pyramid
  291.    Pyramid Pyramid.CFG
  292.    CD \WILDCAT
  293.    CAT.BAT
  294.  
  295. place this batch file in your Node# directory if running Multi-Nodes or in
  296. your Wildcat (default) directory if single node.
  297.  
  298. Second, Create a sub-directory for the door program such as in the following
  299. example:
  300.  
  301. C:\WILDCAT\DOORS\Pyramid
  302.  
  303. Third, put the Pyramid Guppies game files in the \WILDCAT\DOORS\Pyramid
  304. directory.
  305.  
  306. Forth, add this game to your live program menu for user selection and your
  307. ready to run the door.
  308.  
  309. If this is a little unclear then please read your systems documentation for
  310. more detailed instructions.
  311.  
  312. If you use a door monitoring program then read their documentation for
  313. their specific setup.
  314.  
  315.  
  316. Gap Setup:
  317. ----------
  318. First, add the number and name of the door to your menu. This will allow the
  319. user to select the door by number.
  320.  
  321. Second, edit or create the file called DOORS.DAT which is normally in the GEN
  322. directory. Following is an example line to add:
  323.  
  324.    PG 10
  325.  
  326. where 'PG' stands for the name of the batch file (shown below) to invoke the
  327. the door and '10' is the required security level.
  328.  
  329.  
  330.               Pyramid Guppies  (C)opyright 1990  Page - 5
  331.  
  332. Third, create a sub-directory for Pyramid Guppies to be placed in. And example
  333. would be:
  334.  
  335. C:\GAP\Pyramid
  336.  
  337. place all the files in the Pyramid.ZIP archive inside this directory.
  338.  
  339. Forth, create a batch file called Pyramid which should be placed in the
  340. default directory. Following is example contents of this file:
  341.  
  342.    ECHO OFF
  343.    CD\GAP\Pyramid
  344.    Pyramid Pyramid.CFG
  345.    CD\GAP
  346.    GAP
  347.  
  348. the last line in the Pyramid file should invoke the batch file which loads
  349. the GAP BBS system.
  350.  
  351. If this is a little unclear then please read your systems documentation for
  352. more detailed instructions.
  353.  
  354. If you use a door monitoring program then read their documentation for
  355. their specific setup.
  356.  
  357.  
  358.  
  359. Spitfire Setup:
  360. ---------------
  361. First edit your SFDOOR.MNU and add the following line. If you are not running
  362. and doors at this time you will need to create this file.
  363.  
  364.    PyramidGuppies, 10
  365.  
  366.    Where Pyramid Guppies is the name of the door to appear on your menu and the
  367.    10
  368.    is the lowest security level that will be allowed to enter the door. Don't
  369.    forget the comma (,) after the name.
  370.  
  371. Second create a sub-directory to place the door game in. In this example we
  372. will use 'C:\SF\DOOR_A' for the game directory.
  373.  
  374.  
  375. Third move all the files in the Pyramid.ZIP archive into this directory.
  376.  
  377. Forth edit your SF.BAT file adding the following lines.
  378.  
  379. :DOOR_A
  380.    CD\SF\DOORS_A
  381.    Pyramid Pyramid.CFG
  382.    CD\SF
  383.    GOTO LOOP
  384.  
  385. Fifth, rerun Sf.BAT and your ready to begin play.
  386.  
  387. If this is a little unclear then please read your systems documentation for
  388. more detailed instructions.
  389.  
  390. If you use a door monitoring program then read their documentation for
  391. their specific setup.
  392.  
  393.  
  394.  
  395.  
  396.               Pyramid Guppies  (C)opyright 1990  Page - 6
  397.  
  398. PCBoard 14.0+ Setup:
  399. --------------------
  400. First, edit your DOORS and DOORSG file so that it shows Pyramid Guppies with the
  401. door
  402. number relating to it's position in DOORS.DAT.
  403.  
  404. Second, edit the DOORS.DAT file so that it includes Pyramid.
  405.  
  406. Third, create a sub-directory for Pyramid Guppies to be placed in. And example
  407. would be:
  408.  
  409. C:\PCB\Pyramid
  410.  
  411. place all the files in the Pyramid.ZIP archive inside this directory.
  412.  
  413. Forth, create a batch file called Pyramid which should be placed in the
  414. default directory. Following is example contents of this file:
  415.  
  416.    ECHO OFF
  417.    CD\PCB\Pyramid
  418.    Pyramid Pyramid.CFG
  419.    CD\PCB
  420.    BOARD
  421.  
  422. the last line in the Pyramid file should invoke the batch file which loads
  423. the PCboard BBS system.
  424.  
  425. If this is a little unclear then please read your systems documentation for
  426. more detailed instructions.
  427.  
  428. If you use a door monitoring program then read their documentation for
  429. their specific setup.
  430.  
  431.  
  432.  
  433. QuickBBS Setup:
  434. ---------------
  435. First, add the game to your games menu and select the correct type for doors.
  436.  
  437. Second, create a sub-directory for the game and move all the files from the
  438. zip file to this directory.
  439.  
  440. Third, the game reads the file DORINFOx.DEF. Where 'x' is the node number.
  441. Since QuickBBS only supports one node at this time then this file should be
  442. 'DORINFO1.DEF'. This file's drive\path\filename should be on the third line
  443. of the configuration file.
  444.  
  445.    Note: It was told to me that the upcoming 3.0 version of QucikBBS will
  446.          support Multi-Nodes and that the 'DORINFOx.DEF' will be changed
  447.          to 'DORINFxx.DEF' to support Multi-Nodes. This game is written
  448.          where you can specify this new name as well as any others.
  449.  
  450. Forth, create a batch file called Pyramid which should be placed in the
  451. default directory. Following is example contents of this file:
  452.  
  453.    ECHO OFF
  454.    CD\QUICKBBS\Pyramid
  455.    Pyramid Pyramid.CFG
  456.    CD\QUICKBBS
  457.    QBBS.BAT
  458.  
  459. the last line in the Pyramid file should invoke the batch file which loads
  460. the QuickBBS system.
  461.  
  462.               Pyramid Guppies  (C)opyright 1990  Page - 7
  463.  
  464. If this is a little unclear then please read your systems documentation for
  465. more detailed instructions.
  466.  
  467. If you use a door monitoring program then read their documentation for
  468. their specific setup.
  469.  
  470.  
  471.  
  472.                             Technical Support
  473.  
  474. If you have problems with the  Pyramid Guppies live game you may
  475. contact Mike Wilson at the Secret Service BBS 24 hours per day.
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.                               Order Information
  483.  
  484.  
  485. Just mail $20.00 Check or Money Order or Cash to:
  486.  
  487. Mike Wilson
  488. P.O. Box 9521
  489. Huntington, WV
  490.             25704
  491.  
  492. Make Checks out to Mike Wilson.
  493.  
  494.  
  495. Thank you for trying Pyramid Guppies and look for more games and utilities
  496. in the near future.
  497.  
  498. Special thanks to Jeff Sumberg for some great C routines used in this door!
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.               Pyramid Guppies  (C)opyright 1990  Page - 8