
                      Ŀ
                      ============================
                              Dollarmania!        
                      ============================
                      *Copyright 2004- BBSFiles.com*
                      *                            *
                      *          original          *
                      COPYRIGHT 1995 T&J Software 
                      

                       VERSION 3.00     07/24/95

                                   By

                               Tom Wildoner


LATEST VERSION:
^^^^^^^^^^^^^^^
Please visit http://BBSFiles.com for the latest version of this program.

LEGALITIES:
^^^^^^^^^^^
THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.

DISTRIBUTION:
^^^^^^^^^^^^^
You may make this file available for downloading from your BBS or you may
upload it to any BBS of your choice, provided that you do not make any
changes to the contents of the archive (ZIP file). The archive and its
individual contents may not be used by any service that charges any money
whatsoever, without the written permission of the author. This does not
include pay BBS's or placing this archive on CD-Roms. You have the
authors permission to place this on the CD of your choice.

PROGRAM DESCRIPTION:
^^^^^^^^^^^^^^^^^^^^
Dollarmania! is a simple slot machine door program -- players enter
bets (up to the sysop defined maximum), press enter, and wait for their
big payoff!

Online help, payoff tables and the alltime high scorer information is
available while the user is in the door. The jackpot, player starting
money and number of attempts per day is all sysop configurable!

At the conclusion of play, the door also creates a top 25 score file,
both color and mono. The door resets automatically every Monday.

The jackpot automatically increments upward with every play.

If the users spends all of his/her money, he cannot play again until
Monday when the door resets!

This version supports the InterBBS play style. Using a front end program
multiple BBS's may join their users together to compete for the high
score! Please consult the IBBS.TXT file for further details.

NOTE:
^^^^^
Your users will only be allowed 5 attempts per day until the door is
registered.

REGISTRATION:
^^^^^^^^^^^^^
A public registration key is included


INSTALLATION: (using the DMANIA UTILITY command)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Run Dollarmania! using the command string UTILITY (i.e.  DMANIA UTILITY)

     Just type:  DMANIA UTILITY

You will be presented with a list options:

    1.] Reset the door.
    2.] Setup your DMANIA.CFG file.
    3.] Setup your SYSOP.CFG file.
    4.] Reset the ALLTIME high score file.
    5.] Quit.

Let's start with number one and reset the entire door from scratch!

Now, select number two to setup the DMANIA.CFG file. Just answer all
the questions that are presented.

Now, select number three to setup your SYSOP.CFG file. You will be asked
the following questions:

    --- Starting jackpot amount.
    --- Number of tries per day.
    --- Starting cash.
    --- PATH to color bulletin.
    --- PATH to mono bulletin.
    --- Number of times they can play per day.

These are further explained in the UTILITY sub-program.

CONFIGURATION:
^^^^^^^^^^^^^^
The DMANIA.CFG contains only FOUR (4) lines. Running DMANIA UTILITY
will prompt you for all the info!

LINE 1: Must contain the complete PATH and FILENAME to your BBS
        Caller DROP FILE. Please consult your BBS documentation to
        what drop files are supported by your BBS system.


C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
                          where 'x' is the BBS Node number.
C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)

LINE 2: Contains your BBS Name.

LINE 3: Contains the Sysop's first name.

LINE 4: Contains the Sysop's last name.

See the sample DMANIA.CFG provided!

Example Batch File
^^^^^^^^^^^^^^^^^^

   ECHO OFF
   CD\DOORS\DMANIA          <=- Switch to the door's Directory.
   DMANIA DMANIA.CFG        <=- Execute the door program and pass the
                                configuration filename to the program.
   CD\PCB                   <=- Go back to PCB DIR when user exits door.
   BOARD                    <=- Restart BBS.

NOTE: Not all BBS's require you to restart the BBS! For Wildcat! v4.x
      systems:

   ECHO OFF
   CD\WILDCAT\DOORS\DMANIA
   DMANIA DMANIA.CFG

This Door is multi-node  compatible so you may run more than 1 node from
the same .CFG file provided the path to your system file (DORINFOx.DEF,
CALLINFO.BBS, etc) is exactly the same unless you are using environment
variables, (q.v.)

Normally, when running multinode, just setup different DMANIA.CFG files
for each node:   DMANIA1.CFG   DMANIA2.CFG  etc....

Environment Variables
^^^^^^^^^^^^^^^^^^^^^
PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
variables. Non-PCBoard systems may also use these variables by including
the following in either your BBS batch or AUTOEXEC.BAT
  SET PCBDRIVE=C:               <- Drive letter of your BBS files
  SET PCBDIR=\BBSDIR            <- Path to your BBS files
Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
.CFG file for multi-node operation!

To specify a non-standard IRQ, put the IRQ number after the .CFG on the
command line.  For example:

     DMANIA DMANIA.CFG /5
or using the PCBDRIVE procedure:   SET IRQ=5   and use
     DMANIA DMANIA.CFG /%IRQ%

This tells the program to use IRQ 5 instead of the standard IRQ.

  Had reports of conflicts when using non-standard IRQ's on Novell/Netware
 systems. Seems Novell also uses the / character so something went screwy
 somewhere. So I added the * (asterisk) which may be used instead of the /
 in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
 and are interchangeable.

When specifying the location of the system file on line 1 of the doors .CFG
file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
and %wcnodeid%. Some examples:

 PCBoard: 
   USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
   USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS

 Wildcat!:

   DOOR.SYS in C:\WILDCAT\WCWORK\NODE Directories

   In each CAT.BAT file that starts a NODE place the SET WCNODEID=
   statement. EXAMPLE: In my CAT1.BAT file, which loads NODE 1 in
   DESQview, I have this line:

   SET WCNODEID=1

   In my CAT2.BAT file I have SET WCNODEID=2

   Your DMANIA.CFG file, line 1, would read:

   C:\WILDCAT\WCWORK\NODE%WCNODEID%\DOOR.SYS

   The 1 or 2 will replace the %WCNODEID% variable in the cfg file!

Non-PCBoard systems may use the PCB environment variables by setting them
in either AUTOEXEC.BAT or in the batch that runs the door. For example:
 SET PCBDRIVE=C:
 SET PCBDIR=\BBSDIR
 SET PCBNODE=1

Fossil Driver Support
^^^^^^^^^^^^^^^^^^^^^
DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
Fossil driver instead of the standard COM ports, just put /FD on the command
line when running the door. For example:
     MYDOOR MYDOOR.CFG /FD
indicates that a Fossil driver is present and should be used. If no Fossil
driver is detected, DoorFrame will print a message to that effect and exit
the door gracefully.

This is generally required for those running under a digiboard setup. For
Digiboards, you will also have to obtain a copy of DigiFossil.

CD\WILDCAT\DOORS\DMANIA
DF ON
DMANIA DMANIA.CFG /FD
DF DIGI

Sysop Keys
^^^^^^^^^^
F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
         written to DOOR.SYS and USERS.SYS
F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
         and/or written to DOOR.SYS and USERS.SYS
F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
         and/or written to DOOR.SYS and USERS.SYS
F8    -  Returns the caller involuntarily to the BBS.
F9    -  Toggles the local display On/Off. Value is passed to PCBoard
         and/or written to DOOR.SYS and USERS.SYS
F10   -  Activates SysOp CHAT mode within the DOOR.
ESC   -  Deactivates CHAT mode.  DOOR is resumed.
UP    -  Give the caller extra time while in the DOOR.  
DN    -  Subtract time from the caller while in the DOOR. 
HOME  -  HELP key for Status Line options.
ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
ALT-X -  PCBoard will exit after current caller logs off. Value is
         passed to PCBoard. Not available on non-PCBoard systems.

PROBLEMS:
^^^^^^^^^
See the TIPS.TXT file!

MAINTENANCE:
^^^^^^^^^^^^
No nightly maintenance required in this version!

RUNNING LOCALLY:
^^^^^^^^^^^^^^^^
To run in LOCAL mode simply type DMANIA LOCAL


VERSION HISTORY:
^^^^^^^^^^^^^^^^
See the HISTORY.TXT file.

REGISTERING:
^^^^^^^^^^^^
visit http://BBSFiles.com to purchase a "vanity" key.
