home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbsdoor / hot_dice.zip / HOT-DICE.DOC < prev    next >
Text File  |  1993-05-02  |  16KB  |  398 lines
  1.  
  2.                       * * *  H O T - D I C E  * * *
  3.                      Copyright 1993 by M & S Software
  4.  
  5. Hot-Dice Version 1.4
  6. 5/02/1993 by M & S Software
  7.  
  8. Author: Mike Jordan    
  9.               
  10. Built in BBS Support For: 
  11.  
  12.   Wildcat! BBS 3.X, 2.X, 1.13       PCBoard BBS 14.X           QuickBBS
  13.   Remote Access                     Spitfire BBS               GAP BBS
  14.   RBBS-PC BBS                       T.A.G. BBS
  15.  
  16.  
  17. *** Game Discription ***
  18.  
  19. Hot-Dice is a game played with two dice and a 3 x 3 board with the 
  20. numbers 1 through 9.  The object of the game is to select all the 
  21. numbers by rolling the dice and selecting numbers that add up to the
  22. total of the dice roll.  As they say, "You roll the dice and you
  23. takes your chances."  
  24.  
  25. Hot-Dice does not use a Demo Key nor does it expire.  It has 
  26. no annoying beeps, whistles, slow downs or other devices to get you 
  27. to register.  The registered version does have a few features not 
  28. found in the non-registered version though. Non-registered only works
  29. in single node mode, scores are reset after 21 days and bulletins are 
  30. not created.  In addition the makeup and play-ahead feature is not available.
  31.  
  32. *** Warranty ***
  33.  
  34. This product is provided "as is" without warranty of any kind. The entire
  35. risk as to the results and performance of the program is assumed by you.
  36. Furthermore, the author does not warrant, guarantee, or make any representa-
  37. tions regarding the use of, or the results of the use of the program, and you
  38. rely on the program and results solely at your own risk. The author cannot
  39. accept responsibility for system damage, loss of profit, or any other special,
  40. incidental, or consequential damages resulting from the use of or inability to
  41. use this product.  
  42.  
  43. *** Licensing ***
  44.     
  45. Upon registering you are granted a licensed HOT-DICE.KEY, which gives you
  46. certain limited rights to use Hot-Dice.
  47.  
  48. You are granted the use of Hot-Dice on a single BBS System. 
  49. It may be used on several CPUs in a Networking or Multi-Tasking environment 
  50. where the BBS System has more than one physically connected node (i.e. 
  51. LAN Network).
  52.  
  53. You do not become an owner of Hot-Dice.  M & S Software retains 
  54. all rights to the software, copies of the software and related 
  55. materials. Also upon registering, you agree to use reasonable efforts to 
  56. protect the registered HOT-DICE.KEY file from unauthorized use, reproduction 
  57. and distribution.  All rights not specifically granted in this license are
  58. reserved by M & S Software.
  59.                                                          
  60. Failure to comply with this License can result in termination of the
  61. License without refund.
  62.  
  63.  
  64. *** Shareware Version ***
  65.  
  66. This door game is distributed under the SHAREWARE concept. Under
  67. this concept you may use the SHAREWARE (unregistered evaluation version)
  68. version for a reasonable period of time, which is normally thirty to sixty 
  69. days.  After this period you must either register your copy or discontinue 
  70. usage.  
  71.  
  72. *** Three Ways To Run Hot-Dice ***
  73.  
  74. 1.  Running Locally:
  75.   
  76. To run locally you must first create a HOT-DICE.CFG file.  To create this file
  77. run HD_SETUP.COM and fill in the fields that are presented.  The .CFG file can
  78. also be created or edited with any ASCII editor.  See the example HOT-DICE.CFG
  79. file for the lines required.  You can also run the setup program by typeing
  80. HOT-DICE at the DOS prompt without any parameters.  This will bring up the
  81. setup program.
  82.  
  83. Then at the DOS prompt type:
  84.                          
  85.         HOT-DICE HOT-DICE.CFG LOCAL
  86.  
  87. By specifying the configuration file the game will use the Sysop's real
  88. name instead of the name "Sysop".  It will also use the other parameters
  89. in the HOT-DICE.CFG file that are active with the non-registered version.
  90. If the registered HOT-DICE.KEY is present then all parameters will be
  91. active.
  92.  
  93. 2.  Running in Evaluation Mode:
  94.  
  95. Hot-Dice does not need a Demo Key to run in evaluation mode.  Create a 
  96. HOT-DICE.CFG and setup as described later in this documentation and you are
  97. all set.  The evaluation mode will give you all the features of the 
  98. registered version EXCEPT that Bulletins will not be created, the multi-node
  99. option will not function and the dedication line will not be implemented. In
  100. addition the game will reset the score board every 21 days (the reset at the
  101. 1st of each month is normal) and continue as if it was the first of the month.
  102.  
  103. 3.  Running as a Registered Door:
  104.  
  105. You must have the Registration Key to run as a registered door. To register 
  106. simply print-out or copy the contents of the REGISTER.FRM file provided 
  107. in this package. Fill it out with the requested information and send it
  108. with check, money order or COD information to the address on the form itself
  109. or at the end of this documentation.  You may also send the information
  110. by Net Mail or upload it to my board for COD orders.  
  111.  
  112. Upon receipt of your order you will be sent your registered key.  This
  113. will be done, via Net-Mail where applicable, upload to your BBS if 
  114. possible or by U.S. Mail.  All COD orders will be sent UPS or U.S. Mail. 
  115. ** Note: All COD fees will be added to the registration price.
  116.  
  117. *** Support ***
  118.  
  119. I will do my best to help with any problems encountered weither the game
  120. is registered or not. 
  121.  
  122. If you register this door, I will do my best to ensure that the registered
  123. key is sent promptly.  I will do the best I can to support this door and
  124. resolve any problems that might arise.  I can't guarantee to fix or resolve 
  125. all problems since there are so many different combinations of hardware, 
  126. software and system configurations being used but I will do my best.
  127.  
  128. Support can be obtained by calling my BBS, by mail or though the FIDO Network.
  129. My current Node addresses are 1:105/314, 1:105/317, 1:105/330.  I also 
  130. participate in the FIDO echos DOORWARE, On-Line-Games and DOORGAMES as well as 
  131. the WILDCAT echo and will answer any questions addressed to me. 
  132.  
  133. *** Features ***
  134.  
  135.         * Supports Wildcat 1.13, 2.X & 3.X, QuickBBS, PCBoard 14.X, Gap,
  136.           Spitfire, RBBS-PC, Remote Access and T.A.G. directly without the
  137.           use of converters (and any others that use the same type info files).
  138.  
  139.         * File Sharing & Record Locking for Networks & Multi-Tasking Systems.
  140.           (Feature requires Registered Key File.)
  141.  
  142.         * DESQview Detection & Awareness, which speeds program execution. 
  143.  
  144.         * Complete Setup Program to create the HOT-DICE.CFG file.
  145.  
  146.         * Full ANSI Game.
  147.  
  148.         * Full Spilt-Screen Chat.
  149.  
  150.         * Sysop can Add or Decrease Time allowed in door with function keys.
  151.  
  152.         * Sysop can force user back to BBS with function key.
  153.  
  154.         * Mono selected colors for sharp picture when played in Mono Mode.
  155.  
  156.         * Built in bulletin generator for ANSI and ASCII bulletins (registered
  157.           version only).
  158.  
  159.         * Selectable In-depth Log File capability.
  160.  
  161.         * Carrier Drop Detection.
  162.  
  163.         * No Input In 5 Minutes, Time Out Detection.
  164.  
  165.         * Full BBS and FIDO Support (Demo or Registered)
  166.  
  167.         * Supports Comm Ports 1, 2, 3 & 4 And Non-Standard IRQ selection.
  168.  
  169.         * Supports Locked DTE Rate from 300 to 115,200 Baud.
  170.  
  171.     * Supports FOSSIL detection
  172.  
  173. *** Files In Archive ***
  174.  
  175. The following files are found either in the BOOBYTRP.ZIP or will be
  176. created during the runtime execution.
  177.  
  178. HOT-DICE.EXE    <--- Executable Program.
  179.  
  180. HD_SETUP.COM    <--- Hot-Dice Setup Program
  181.  
  182. HOT-DICE.CFG  * <--- Sample Configuration File.
  183.  
  184. HOT-DICE.DAT  * <--- Store User's Name, Last Play Date & Scores.
  185.  
  186. HOT-DICE.HPS    <--- Ansi Mode Instructions Used By Program.
  187.  
  188. HOT-DICE.DOC    <--- This File.
  189.  
  190. HOT-DICE.SLB    <--- Screen Library.
  191.  
  192. HOT-DICE.CHP  * <--- Last Month's Champion File.
  193.  
  194. HOT-DICE.LOG  * <--- Game Activity Log.
  195.  
  196. DOOR.BAT        <--- Simple Sample Batch File For Door Execution.
  197.  
  198. REGISTER.FRM    <--- Registration Form For This And Other Doors.
  199.  
  200. HISTORY.TXT     <--- History file listing changes.
  201.  
  202. UPGRADE.TXT     <--- Explains what is needed to upgrade to new release
  203.                      from previous one.
  204.  
  205. HOT-DICE.KEY    <--- Registration key. (Not needed for Evaluation mode)
  206.  
  207. SUPPORT.TXT     <--- List of boards carring the latest version.
  208.  
  209. FOSSIL.TXT      <--- Information on Fossil support
  210.  
  211. * DENOTES that file is created during RUN-TIME.
  212.  
  213. HOT-DICE.CHP:
  214.  
  215. This is the Last Month's Champion file. It contains the Champ's Name, Score,
  216. Date and How many games won that month. This file is automatically created
  217. when the game is first executed.
  218.  
  219. Deleting the HOT-DICE.CHP file will cause the game to re-initialize
  220. itself. It will create a new HOT-DICE.CHP file and a new HOT-DICE.DAT file.
  221.  
  222.  
  223. *** Setup & Installation ***
  224.  
  225. Installation procedures are very simple if you have setup a live program in
  226. the past. First create a Sub-Directory for the door game and copy all the
  227. files from the HOT-DICE.ZIP file into this directory.
  228.  
  229. Now execute the Setup program HD_SETUP.COM by either typing HOT-DICE with
  230. no parameters at the DOS prompt or executing the HD_SETUP.COM program
  231. itself. 
  232.  
  233. This will run the game's setup feature that will create a HOT-DICE.CFG
  234. file. The setup program has complete on-line help so I will not duplicate
  235. it here.
  236.  
  237. This is what the HOT-DICE.CFG contains when created (less the comments).
  238.  
  239.    1                        <-- COM PORT 1, 2, 3, 4 or &H###/#
  240.    N                        <-- Multi-Node 'Y' or 'N' 
  241.    COM-DAT BBS              <-- Name Of BBS
  242.    Mike Jordan              <-- Sysop's Full Name
  243.    DOOR.SYS                 <-- BBS Callers File
  244.    C:\WC30\WCWORK\NODE1\    <-- Drive & Path Of System's Caller File 
  245.    LOG                      <-- LOG to keep user log or NOLOG to disable
  246.    C:\BULLETIN\BULL99.BBS   <-- Drive\Path\BulletinName For Ansi Scores
  247.    C:\BULLETIN\BULL99.SCR   <-- Drive\Path\BulletinName For Ascii Scores
  248.    Wildcat                  <-- Type of BBS System You're Running See Note 1
  249.    Thanks For The Donations <-- 50 character dedication line
  250.    Please Help Register     <-- 55 character "Nag" line.
  251.    10                       <-- Games Allowed Per Day (1 to 50)
  252.    5                        <-- Number of Days allowed for Makeup 
  253.    1                        <-- Day that Makeup Games Start
  254.  
  255. NOTE 1: Valid System Callers files for each BBS system are as follows:
  256.  
  257.             Wildcat 3.X BBS System         <->  USERINFO.DAT or DOORS.SYS
  258.             Wildcat! 1.X & 2.X BBS System  <->  CALLINFO.BBS
  259.             QuickBBS System                <->  DORINFOx.DEF
  260.             RBBS-PC BBS System             <->  DORINFOx.DEF
  261.             Remote Access BBS System       <->  DORINFOx.DEF
  262.             T.A.G. BBS System              <->  DORINFOx.DEF
  263.             PCBoard BBS System             <->  PCBOARD.SYS
  264.             Gap BBS System                 <->  DOORS.SYS
  265.             Spitfire BBS System            <->  SFDOORS.DAT
  266.  
  267. If you use another BBS System besides those listed, then you must use
  268. a converter to convert to one of the above caller file formats.
  269.  
  270. ** The Bulletin Drive\Path\Bulletin Name is designed to accept any valid
  271. Drive, Path and Filename of your choice. This allows each BBS system to
  272. configure for its individual system.
  273.  
  274. Note 3: Lines 11 and 12 (the dedication and Nag line) are required, even
  275. if they are left blank.
  276.  
  277. *** Execution ***
  278.  
  279. Some BBS Systems call batch files and some run doors directly. If you
  280. don't know how to install a door on your particular BBS System then please
  281. see your BBS manual. This game merely needs the .CFG file name passed to it on
  282. the command line to operate, i.e. 
  283.  
  284.           HOT-DICE.EXE HOT-DICE.CFG
  285.  
  286. An example HOT-DICE.BAT file could look like this:
  287.  
  288.      C:                       <-- Change to drive door is in
  289.      CD \HOT-DICE              <-- Change to door directory
  290.      HOT-DICE.EXE HOT-DICE.CFG  <-- Execute door with config file
  291.      CD\BBS                   <-- Change back to BBS (may not be needed)
  292.      
  293.  
  294. *** Multi-Node Use ***
  295.    
  296. Running this game on more than a single node requires a Multi-Node Key.
  297. When running in Evaluation mode, only one (1) Node will be able to access the
  298. door at a time. You may use different configuration file names for each node 
  299. when running in Multi-Node.
  300.  
  301. Use the SETUP program to create the configuration file and then rename
  302. it for each node. For a short cut, you may create one file and copy
  303. it to the different names and edit the file with any text editor. Just
  304. be sure to keep all fields correct.  
  305.  
  306. **Make sure the PORT number is correct for each node.**
  307.  
  308. Example Of File Naming and execution:
  309.  
  310.         Node 1: HOT-DICE HOT-DICE.CF1
  311.         Node 2: HOT-DICE HOT-DICE.CF2
  312.         Node 3: HOT-DICE HOT-DICE.CF3
  313.  
  314.  
  315. *** Notes Of Interest ***
  316.  
  317. This game does not require a monitoring program for dropped carrier as
  318. it automatically detects this and exits back to the BBS.
  319.  
  320. This door DOES NOT require any runtime modules. It will run
  321. as is without aid from outside utilities.
  322.  
  323.  
  324. *** Technical Support ***
  325.  
  326. If you have problems with this door game you can contact me through
  327. my BBS at the numbers listed below, or though my FIDO addresses 1:105/314,
  328. 1:105/317 or 1:105/330. 
  329.  
  330. BBS Phone:       Com-Dat
  331.          Node 1 - (503) 681-0543 (14.4 HST) 
  332.          Node 2 - (503) 640-0278 (14.4 v.32)
  333.          FIDO 1:105/314 (14.4 HST)
  334.                  FIDO 1:105/317 (14.4 V.32) 
  335.          24 hour - First time callers have access to
  336.                  door programs.
  337.  
  338.    or    :       Com-Dat II  (CM Mail Only - No Human callers)
  339.          Net Mail and File Requests of latest version
  340.          FIDO 1:105/330 - V.32 14.4
  341.  
  342. Mailing Address: Mike Jordan 
  343.                  2001 NE Hyde St.
  344.                  Hillsboro, OR.  97124
  345.  
  346.  
  347. *** Ordering Information ***
  348.  
  349. Please see the file REGISTER.FRM file in this package for ordering
  350. information.
  351.  
  352. *** Updates To M & S Doors ***
  353.  
  354. Updates to any M & S Software product may be downloaded from any Distribution
  355. BBS.  My intent is to always supply updates FREE unless major revisions are 
  356. made to the software, in which case a small update fee will be charged.
  357.  
  358. *** Distribution ***
  359.  
  360. You are free, in fact encouraged, to distribute the SHAREWARE version
  361. of the door game provided that all files contained in the original
  362. archive are distributed in their original unmodified state.
  363.  
  364. The Registered Key MAY NOT be distributed in any form.
  365.  
  366.  
  367. *** Acknowledgements ***
  368.  
  369.               Wildcat BBS System - Mustang Software
  370.               GAP Communications - The GAP Development Company
  371.               PCBoard - Clark Development Company, Inc.
  372.               Spitfire - Mike Woltz, Buffalo Creek Software
  373.               QuickBBS - The QuickBBS Group, Inc
  374.               Remote Access - Continental Software
  375.  
  376. *** Special Acknowledgement ***
  377.  
  378. I would like to give a very big thank you to the person that has done the
  379. most to make this game (plus all my past and hopefully future door games)
  380. possible.  This person is Rusty Johnson of JNS Software. Rusty has released
  381. many excellent door games into the BBS arena and you will probably see a lot of
  382. similarities in my games and his.  This is because Rusty has provided me with
  383. much of the code needed to make a door game work.  It's my code for the game,
  384. but it's Rusty's code that provides the Comm routines, scoring, bulletins,
  385. setup and just about everything else required to make this a working door. 
  386. Rusty and I have known each other for several years now and have helped each
  387. other many times and this is one case where giving has been rewarded tenfold. 
  388. I'm glad to be able to call Rusty my friend.  Thanks Rusty.
  389.  
  390. If you have not played any of Rusty's games then you are missing out on some
  391. of the best games available for BBSing.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398. Hot-Dice Copyright 1993 by M & S Software