home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / DMANIA27.ZIP / DMANIA.DOC < prev    next >
Text File  |  1993-08-11  |  15KB  |  389 lines
  1.  
  2.                       ┌────────────────────────────┐
  3.                       │============================│
  4.                       │        Dollarmania!        │
  5.                       │============================│
  6.                       │COPYRIGHT 1993 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, Remote Access, and WWIV.                                Digiboard
  11.  
  12.                        VERSION 2.70     08/11/93
  13.  
  14.                                    By
  15.  
  16.                                Tom Wildoner
  17.                              397 West Broadway
  18.                               Jim Thorpe, PA
  19.                                   18229
  20.                             VOICE (717)325-9480
  21.                    *between 5:30 & 10:00 p.m. Eastern Time
  22.  
  23.                                   From
  24.  
  25.                                The T&J BBS
  26.                               (717)325-9481
  27.                         1200/2400/9600/19200/38400
  28.                                24 Hours/Day
  29.  
  30.  
  31. LATEST VERSION:
  32. ^^^^^^^^^^^^^^^
  33. Please call the T&J BBS for the latest version of this program.
  34.  
  35.  
  36. LEGALITIES:
  37. ^^^^^^^^^^^
  38. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  39. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  40. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  41. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  42. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  43. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  44.  
  45.  
  46. DISTRIBUTION:
  47. ^^^^^^^^^^^^^
  48. You may make this file available for downloading from your BBS or you may
  49. upload it to any BBS of your choice, provided that you do not make any
  50. changes to the contents of the archive (ZIP file). The archive and its
  51. individual contents may not be used by any service that charges any money
  52. whatsoever, without the written permission of the author.
  53.  
  54.  
  55. PROGRAM DESCRIPTION:
  56. ^^^^^^^^^^^^^^^^^^^^
  57. Dollarmania! is a simple slot machine door program -- players can enter
  58. from one to ten coins (in STANDARD mode) or any dollar amount thet
  59. want (in CUSTOM mode). The two modes are sysop configurable in the
  60. SETUP sub-program. Online help, payoff tables and the alltime high
  61. scorer information is available while the user is in the door. The
  62. jackpot, player starting money and number of attempts per day is all
  63. sysop configurable!
  64.  
  65. At the conclusion of play, the door also creates a top ten score file,
  66. both color and mono. The door resets automatically every Monday with
  67. the help of a maintenance program which is built-in to the main
  68. Dollarmania! program.
  69.  
  70. The jackpot increases $5 per play when setup in the STANDARD mode and
  71. $100 per play when setup in the CUSTOM mode.
  72.  
  73. If the users spends all of his/her money, he cannot play again until
  74. Monday when the door resets!
  75.  
  76.  
  77. NOTE:
  78. ^^^^^
  79. The DMANIA.KEY file that is distributed with this door does NOT expire!
  80. This is simply here so the door has a KEY to read. When you register,
  81. you will receive a new DMANIA.KEY file.
  82.  
  83. Your users will only be allowed 10 attempts per day until the door is
  84. registered.
  85.  
  86. Running the door locally (DMANIA LOCAL) will let you evaluate the
  87. door with no crippling effects. You get the total turns that you have
  88. the door configured for.
  89.  
  90.  
  91. FEATURES:
  92. =========
  93.            --- Desqview Aware.
  94.            --- COM0-15 support and non-standard IRQ's.
  95.            --- Colorful ANSI screens.
  96.            --- Chat function.
  97.            --- NO BRUN module needed for play.
  98.            --- BETA tested on five different boards.
  99.            --- Will return to BBS on dropped carrier.
  100.            --- Use of HOT KEYS while in the door.
  101.            --- Support BBS available.
  102.            --- STANDARD and CUSTOM mode available.
  103.            --- The jackpot is progressive.
  104.            --- A log file that shows who entered the game.
  105.  
  106.  
  107. INSTALLATION: (using the DMANIA UTILITY command)
  108. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  109. Run Dollarmania! using the command string UTILITY (i.e.  DMANIA UTILITY)
  110.  
  111.      Just type:  DMANIA UTILITY
  112.  
  113. You will be presented with a list options:
  114.  
  115.     1.] Reset the door.
  116.     2.] Setup your DMANIA.CFG file.
  117.     3.] Setup your SYSOP.CFG file.
  118.     4.] Reset the ALLTIME high score file.
  119.     5.] Toggle local display ON or OFF.
  120.     6.] Set keyboard TIMEOUT.
  121.     7.] Toggle sysop status lines ON or OFF.
  122.     8.] Quit.
  123.  
  124. Let's start with number one and reset the entire door from scratch!
  125.  
  126. Now, select number two to setup the DMANIA.CFG file. Just answer all
  127. the questions that are presented.
  128.  
  129. Now, select number three to setup your SYSOP.CFG file. You will be asked
  130. the following questions:
  131.  
  132.     --- Starting jackpot amount.
  133.     --- Number of tries per day.
  134.     --- Starting cash.
  135.     --- CUSTOM or STANDARD mode.
  136.     --- PATH to color bulletin.
  137.     --- PATH to mono bulletin.
  138.  
  139. These are further explained in the UTILITY sub-program.
  140.  
  141.  
  142. CONFIGURATION:
  143. ^^^^^^^^^^^^^^
  144. Example configuration file for PCBOARD.SYS
  145. ------------------------------------------
  146.  
  147. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  148. T&J Software        <=-  (Change this to your BBS name)
  149. Tom                 <=-  (The Sysop's first name)
  150. Wildoner            <=-  (The Sysop's last name)
  151.  
  152. Example configuration file for USERS.SYS
  153. ----------------------------------------
  154.  
  155. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  156. T&J Software        <=-  (Change this to your BBS name)
  157. Tom                 <=-  (The Sysop's first name)
  158. Wildoner            <=-  (The Sysop's last name)
  159.  
  160. Example configuration file for DOOR.SYS
  161. ---------------------------------------
  162.  
  163. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  164. T&J Software        <=-  (Change this to your BBS name)
  165. Tom                 <=-  (The Sysop's first name)
  166. Wildoner            <=-  (The Sysop's last name)
  167.  
  168. Example configuration file for USERINFO.DAT
  169. -------------------------------------------
  170.  
  171. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  172. T&J Software        <=-  (Change this to your BBS name)
  173. Tom                 <=-  (The Sysop's first name)
  174. Wildoner            <=-  (The Sysop's last name)
  175. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  176.  
  177. Example configuration file for CALLINFO.BBS
  178. -------------------------------------------
  179.  
  180. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  181. T&J Software        <=-  (Change this to your BBS name)
  182. Tom                 <=-  (The Sysop's first name)
  183. Wildoner            <=-  (The Sysop's last name)
  184.  
  185. Example configuration file for DORINFOx.DEF
  186. -------------------------------------------
  187.  
  188. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  189.                           where 'x' is the BBS Node number.
  190. T&J Software        <=-  (Change this to your BBS name)
  191. Tom                 <=-  (The Sysop's first name)
  192. Wildoner            <=-  (The Sysop's last name)
  193.  
  194. Example configuration file for SFDOORS.DAT
  195. ------------------------------------------
  196.  
  197. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  198. T&J Software        <=-  (Change this to your BBS name)
  199. Tom                 <=-  (The Sysop's first name)
  200. Wildoner            <=-  (The Sysop's last name)
  201.  
  202. Example configuration file for CHAIN.TXT
  203. ----------------------------------------
  204.  
  205. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  206. T&J Software        <=-  (Change this to your BBS name)
  207. Tom                 <=-  (The Sysop's first name)
  208. Wildoner            <=-  (The Sysop's last name)
  209.  
  210. Example configuration file for GTUSER.BBS
  211. -----------------------------------------
  212.  
  213. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  214. T&J Software        <=-  (Change this to your BBS name)
  215. Tom                 <=-  (The Sysop's first name)
  216. Wildoner            <=-  (The Sysop's last name)
  217. 1                   <=-  (COM port number - defaults to 1)
  218. 1                   <=-  (Node number - defaults to 1)
  219.  
  220.  
  221. Example Batch File
  222. ^^^^^^^^^^^^^^^^^^
  223. A sample batch file is included and is similer to the following:
  224.    ECHO OFF
  225.    CD\DOORS\ONLINE          <=- Switch to the door's Directory.
  226.    DMANIA DMANIA.CFG        <=- Execute the door program and pass the
  227.                                 configuration filename to the program.
  228.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  229.    BOARD                    <=- Restart BBS.
  230.  
  231.  
  232. This Door is multi-node  compatible so you may run more than 1 node from
  233. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  234. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  235. variables, (q.v.)
  236.  
  237. Normally, when running multinode, just setup different DMANIA.CFG files
  238. for each node:   DMANIA1.CFG   DMANIA2.CFG  etc....
  239.  
  240.  
  241. Environment Variables
  242. ^^^^^^^^^^^^^^^^^^^^^
  243. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  244. variables. Non-PCBoard systems may also use these variables by including
  245. the following in either your BBS batch or AUTOEXEC.BAT
  246.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  247.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  248. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  249. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  250. .CFG file for multi-node operation!
  251.  
  252. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  253. command line.  For example:
  254.  
  255.      DMANIA DMANIA.CFG /5
  256. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  257.      DMANIA DMANIA.CFG /%IRQ%
  258.  
  259. This tells the program to use IRQ 5 instead of the standard IRQ.
  260.  
  261.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  262.  systems. Seems Novell also uses the / character so something went screwy
  263.  somewhere. So I added the * (asterisk) which may be used instead of the /
  264.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  265.  and are interchangeable.
  266.  
  267. When specifying the location of the system file on line 1 of the doors .CFG
  268. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  269. and %wcnodeid%. Some examples:
  270.  PCBoard: 
  271.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  272.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  273.  
  274.  Wildcat!:
  275.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  276.  
  277. Non-PCBoard systems may use the PCB environment variables by setting them
  278. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  279.  SET PCBDRIVE=C:
  280.  SET PCBDIR=\BBSDIR
  281.  SET PCBNODE=1
  282.  
  283.  
  284. Fossil Driver Support
  285. ^^^^^^^^^^^^^^^^^^^^^
  286. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  287. Fossil driver instead of the standard COM ports, just put /FD on the command
  288. line when running the door. For example:
  289.      MYDOOR MYDOOR.CFG /FD
  290. indicates that a Fossil driver is present and should be used. If no Fossil
  291. driver is detected, DoorFrame will print a message to that effect and exit
  292. the door gracefully.
  293.  
  294.  
  295. Sysop Keys
  296. ^^^^^^^^^^
  297. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  298.          written to DOOR.SYS and USERS.SYS
  299. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  300.          and/or written to DOOR.SYS and USERS.SYS
  301. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  302. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  303.          and/or written to DOOR.SYS and USERS.SYS
  304. F8    -  Returns the caller involuntarily to the BBS.
  305. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  306.          and/or written to DOOR.SYS and USERS.SYS
  307. F10   -  Activates SysOp CHAT mode within the DOOR.
  308. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  309. UP    -  Give the caller extra time while in the DOOR.  
  310. DN    -  Subtract time from the caller while in the DOOR. 
  311. HOME  -  HELP key for Status Line options.
  312. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  313. ALT-X -  PCBoard will exit after current caller logs off. Value is
  314.          passed to PCBoard. Not available on non-PCBoard systems.
  315.  
  316.  
  317. PROBLEMS:
  318. ^^^^^^^^^
  319. See the TJHELP.TXT file!
  320. Please feel free to contact me if you have any problems at all.
  321.  
  322.  
  323. MAINTENANCE:
  324. ^^^^^^^^^^^^
  325. No nightly maintenance required in this version! If you previously
  326. ran nightly maintenance, remove it from your nightly batch file! It
  327. won't cause any problems, but may make a loud beep.
  328.  
  329.  
  330. RUNNING LOCALLY:
  331. ^^^^^^^^^^^^^^^^
  332. To run in LOCAL mode simply type DMANIA LOCAL
  333.  
  334.  
  335. UPGRADING:
  336. ^^^^^^^^^^
  337. See UPGRADE.DOC.
  338.  
  339.  
  340. FUTURE VERSIONS:
  341. ^^^^^^^^^^^^^^^^
  342. Let me know what you would like to see added!!
  343.  
  344.  
  345. VERSION HISTORY:
  346. ^^^^^^^^^^^^^^^^
  347. Version 1.00 ......... First release. 01/22/92
  348. Version 1.10 ......... Corrected bug that prevented SysOp's running a
  349.                        BBS with no locked com port from using the door.
  350. Version 2.00 ......... Switched door writing code to DoorFrame.
  351.                        02/20/92
  352. Version 2.10 ......... Recompiled using newest door writing routines,
  353.                        added internal maintenance, and added new bulletins.
  354.                        04-17-1992
  355. Version 2.50 ......... Recompiled using the newest door rotuines, switched
  356.                        to an external maintenance program, added support
  357.                        for STANDARD or CUSTOM modes of play, new bulletins,
  358.                        door resets every Monday, added support to play the
  359.                        door locally with no crippling, screens updated,
  360.                        added alltime high score screen for the users to
  361.                        view. 07-02-1992
  362. Version 2.60 ......... Recompiled using the newest door routines. Screen
  363.                        now redraws itself after a drop to dos or after
  364.                        chatting with the user. The 30 something line
  365.                        version of DOOR.SYS is now supported as well as
  366.                        the 52 line version. Added support for fossil
  367.                        drivers. Added support for double digit IRQ
  368.                        numbers when used.  12-04-92
  369. Version 2.70 ......... Added support for COM 0-15, better support for
  370.                        Wildcat IM and PCBoard/M versions, sysop config
  371.                        options for local display toggling, sysop
  372.                        status line toggling, and keyboard timeout
  373.                        period, new top ten bulletin, no external maint
  374.                        required (now automatic), added better
  375.                        internal error controls, scores can now go as
  376.                        high as several TRILLION dollars. Added an
  377.                        option to let players play subsequent rounds if
  378.                        they have more plays left. Dropped support for
  379.                        CHAIN.TXT.
  380.  
  381.  
  382. REGISTERING:
  383. ^^^^^^^^^^^^
  384. That's all there is to it! If you have any problems or questions
  385. please feel free to call the T&J BBS at (717)325-9481 and join the
  386. T&J Software Conference.
  387.  
  388. See the enclosed registration form for ordering!  (REGISTER.TXT)
  389.