home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / DMANIA30.ZIP / DMANIA.DOC < prev    next >
Text File  |  1995-07-24  |  12KB  |  314 lines
  1.  
  2.                       ┌────────────────────────────┐
  3.                       │============================│
  4.                       │        Dollarmania!        │
  5.                       │============================│
  6.                       │COPYRIGHT 1995 T&J Software │
  7.                       └────────────────────────────┘
  8.         One of the T&J Software Collection of multi-BBS door programs.
  9.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  10.                UltraBBS, Telegard, TriBBS, and Remote Access.
  11.  
  12.                        VERSION 3.00     07/24/95
  13.  
  14.                                    By
  15.  
  16.                                Tom Wildoner
  17.                              397 West Broadway
  18.                               Jim Thorpe, PA
  19.                                   18229
  20.                             VOICE (717)325-9480
  21.                    *between 6:00 & 8:00 p.m. Eastern Time
  22.  
  23.                                   From
  24.  
  25.                            The T&J Software BBS
  26.                         NODE 1: (717)325-9481 28.8k
  27.                         NODE 2: (717)325-4369 28.8k
  28.                         NODE 3: (717)325-2054 28.8k
  29.                                24 Hours/Day
  30.  
  31.                  INTERNET:  tjsoft@postoffice.ptd.net
  32.                  FIDO: 1:268/400 FREQ TJSOFT for info packet!
  33.                  FTP: ftp europa.com /outgoing/DOORS/tj-software
  34.  
  35.  
  36. LATEST VERSION:
  37. ^^^^^^^^^^^^^^^
  38. Please call the T&J BBS for the latest version of this program. It will
  39. always be found in file area #1 on our BBS.
  40.  
  41. LEGALITIES:
  42. ^^^^^^^^^^^
  43. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  44. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  45. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  46. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  47. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  48. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  49.  
  50. DISTRIBUTION:
  51. ^^^^^^^^^^^^^
  52. You may make this file available for downloading from your BBS or you may
  53. upload it to any BBS of your choice, provided that you do not make any
  54. changes to the contents of the archive (ZIP file). The archive and its
  55. individual contents may not be used by any service that charges any money
  56. whatsoever, without the written permission of the author. This does not
  57. include pay BBS's or placing this archive on CD-Roms. You have the
  58. authors permission to place this on the CD of your choice.
  59.  
  60. PROGRAM DESCRIPTION:
  61. ^^^^^^^^^^^^^^^^^^^^
  62. Dollarmania! is a simple slot machine door program -- players enter
  63. bets (up to the sysop defined maximum), press enter, and wait for their
  64. big payoff!
  65.  
  66. Online help, payoff tables and the alltime high scorer information is
  67. available while the user is in the door. The jackpot, player starting
  68. money and number of attempts per day is all sysop configurable!
  69.  
  70. At the conclusion of play, the door also creates a top 25 score file,
  71. both color and mono. The door resets automatically every Monday.
  72.  
  73. The jackpot automatically increments upward with every play.
  74.  
  75. If the users spends all of his/her money, he cannot play again until
  76. Monday when the door resets!
  77.  
  78. This version supports the InterBBS play style. Using a front end program
  79. multiple BBS's may join their users together to compete for the high
  80. score! Please consult the IBBS.TXT file for further details.
  81.  
  82. NOTE:
  83. ^^^^^
  84. Your users will only be allowed 5 attempts per day until the door is
  85. registered.
  86.  
  87. REGISTRATION:
  88. ^^^^^^^^^^^^^
  89. Upon registering this program, you will receive a file called
  90. DMANIA.KEY which will unlock the full potential of the program.
  91. Distribution of a registered key file will void all programs you
  92. have purchased from T&J Software.
  93.  
  94. Key files are not tranferrable to any other BBS unless your BBS
  95. closes or is sold. T&J Software charges $5 per door transfer fee to
  96. create a new KEY file. This $5 fee is also included if you frequently
  97. change your BBS Name or Phone Number. By frequently, we mean 3-5 times
  98. per year - yes, some people do!
  99.  
  100. INSTALLATION: (using the DMANIA UTILITY command)
  101. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  102. Run Dollarmania! using the command string UTILITY (i.e.  DMANIA UTILITY)
  103.  
  104.      Just type:  DMANIA UTILITY
  105.  
  106. You will be presented with a list options:
  107.  
  108.     1.] Reset the door.
  109.     2.] Setup your DMANIA.CFG file.
  110.     3.] Setup your SYSOP.CFG file.
  111.     4.] Reset the ALLTIME high score file.
  112.     5.] Quit.
  113.  
  114. Let's start with number one and reset the entire door from scratch!
  115.  
  116. Now, select number two to setup the DMANIA.CFG file. Just answer all
  117. the questions that are presented.
  118.  
  119. Now, select number three to setup your SYSOP.CFG file. You will be asked
  120. the following questions:
  121.  
  122.     --- Starting jackpot amount.
  123.     --- Number of tries per day.
  124.     --- Starting cash.
  125.     --- PATH to color bulletin.
  126.     --- PATH to mono bulletin.
  127.     --- Number of times they can play per day.
  128.  
  129. These are further explained in the UTILITY sub-program.
  130.  
  131. CONFIGURATION:
  132. ^^^^^^^^^^^^^^
  133. The DMANIA.CFG contains only FOUR (4) lines. Running DMANIA UTILITY
  134. will prompt you for all the info!
  135.  
  136. LINE 1: Must contain the complete PATH and FILENAME to your BBS
  137.         Caller DROP FILE. Please consult your BBS documentation to
  138.         what drop files are supported by your BBS system.
  139.  
  140.  
  141. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  142. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  143. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  144. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  145. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  146. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  147.                           where 'x' is the BBS Node number.
  148. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  149.  
  150. LINE 2: Contains your BBS Name.
  151.  
  152. LINE 3: Contains the Sysop's first name.
  153.  
  154. LINE 4: Contains the Sysop's last name.
  155.  
  156. See the sample DMANIA.CFG provided!
  157.  
  158. Example Batch File
  159. ^^^^^^^^^^^^^^^^^^
  160. A sample batch file is included and is similer to the following:
  161.    ECHO OFF
  162.    CD\DOORS\DMANIA          <=- Switch to the door's Directory.
  163.    DMANIA DMANIA.CFG        <=- Execute the door program and pass the
  164.                                 configuration filename to the program.
  165.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  166.    BOARD                    <=- Restart BBS.
  167.  
  168. NOTE: Not all BBS's require you to restart the BBS! For Wildcat! v4.x
  169.       systems:
  170.  
  171.    ECHO OFF
  172.    CD\WILDCAT\DOORS\DMANIA
  173.    DMANIA DMANIA.CFG
  174.  
  175. This Door is multi-node  compatible so you may run more than 1 node from
  176. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  177. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  178. variables, (q.v.)
  179.  
  180. Normally, when running multinode, just setup different DMANIA.CFG files
  181. for each node:   DMANIA1.CFG   DMANIA2.CFG  etc....
  182.  
  183. Environment Variables
  184. ^^^^^^^^^^^^^^^^^^^^^
  185. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  186. variables. Non-PCBoard systems may also use these variables by including
  187. the following in either your BBS batch or AUTOEXEC.BAT
  188.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  189.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  190. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  191. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  192. .CFG file for multi-node operation!
  193.  
  194. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  195. command line.  For example:
  196.  
  197.      DMANIA DMANIA.CFG /5
  198. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  199.      DMANIA DMANIA.CFG /%IRQ%
  200.  
  201. This tells the program to use IRQ 5 instead of the standard IRQ.
  202.  
  203.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  204.  systems. Seems Novell also uses the / character so something went screwy
  205.  somewhere. So I added the * (asterisk) which may be used instead of the /
  206.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  207.  and are interchangeable.
  208.  
  209. When specifying the location of the system file on line 1 of the doors .CFG
  210. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  211. and %wcnodeid%. Some examples:
  212.  
  213.  PCBoard: 
  214.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  215.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  216.  
  217.  Wildcat!:
  218.  
  219.    DOOR.SYS in C:\WILDCAT\WCWORK\NODE Directories
  220.  
  221.    In each CAT.BAT file that starts a NODE place the SET WCNODEID=
  222.    statement. EXAMPLE: In my CAT1.BAT file, which loads NODE 1 in
  223.    DESQview, I have this line:
  224.  
  225.    SET WCNODEID=1
  226.  
  227.    In my CAT2.BAT file I have SET WCNODEID=2
  228.  
  229.    Your DMANIA.CFG file, line 1, would read:
  230.  
  231.    C:\WILDCAT\WCWORK\NODE%WCNODEID%\DOOR.SYS
  232.  
  233.    The 1 or 2 will replace the %WCNODEID% variable in the cfg file!
  234.  
  235. Non-PCBoard systems may use the PCB environment variables by setting them
  236. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  237.  SET PCBDRIVE=C:
  238.  SET PCBDIR=\BBSDIR
  239.  SET PCBNODE=1
  240.  
  241. Fossil Driver Support
  242. ^^^^^^^^^^^^^^^^^^^^^
  243. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  244. Fossil driver instead of the standard COM ports, just put /FD on the command
  245. line when running the door. For example:
  246.      MYDOOR MYDOOR.CFG /FD
  247. indicates that a Fossil driver is present and should be used. If no Fossil
  248. driver is detected, DoorFrame will print a message to that effect and exit
  249. the door gracefully.
  250.  
  251. This is generally required for those running under a digiboard setup. For
  252. Digiboards, you will also have to obtain a copy of DigiFossil.
  253.  
  254. CD\WILDCAT\DOORS\DMANIA
  255. DF ON
  256. DMANIA DMANIA.CFG /FD
  257. DF DIGI
  258.  
  259. Sysop Keys
  260. ^^^^^^^^^^
  261. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  262.          written to DOOR.SYS and USERS.SYS
  263. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  264.          and/or written to DOOR.SYS and USERS.SYS
  265. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  266. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  267.          and/or written to DOOR.SYS and USERS.SYS
  268. F8    -  Returns the caller involuntarily to the BBS.
  269. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  270.          and/or written to DOOR.SYS and USERS.SYS
  271. F10   -  Activates SysOp CHAT mode within the DOOR.
  272. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  273. UP    -  Give the caller extra time while in the DOOR.  
  274. DN    -  Subtract time from the caller while in the DOOR. 
  275. HOME  -  HELP key for Status Line options.
  276. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  277. ALT-X -  PCBoard will exit after current caller logs off. Value is
  278.          passed to PCBoard. Not available on non-PCBoard systems.
  279.  
  280. PROBLEMS:
  281. ^^^^^^^^^
  282. See the TJHELP.TXT file!
  283. Please feel free to contact me if you have any problems at all.
  284.  
  285. MAINTENANCE:
  286. ^^^^^^^^^^^^
  287. No nightly maintenance required in this version! If you previously
  288. ran nightly maintenance, remove it from your nightly batch file! It
  289. won't cause any problems, but may make a loud beep.
  290.  
  291. RUNNING LOCALLY:
  292. ^^^^^^^^^^^^^^^^
  293. To run in LOCAL mode simply type DMANIA LOCAL
  294.  
  295. UPGRADING:
  296. ^^^^^^^^^^
  297. See UPGRADE.DOC.
  298.  
  299. FUTURE VERSIONS:
  300. ^^^^^^^^^^^^^^^^
  301. Let me know what you would like to see added!!
  302.  
  303. VERSION HISTORY:
  304. ^^^^^^^^^^^^^^^^
  305. See the HISTORY.TXT file.
  306.  
  307. REGISTERING:
  308. ^^^^^^^^^^^^
  309. That's all there is to it! If you have any problems or questions
  310. please feel free to call the T&J BBS at (717)325-9481 and join the
  311. T&J Software Conference.
  312.  
  313. See the enclosed registration form for ordering!  (REGISTER.TXT)
  314.