home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / DOORS / QPRIZE25.ZIP / QPRIZE.DOC < prev    next >
Encoding:
Text File  |  1990-12-08  |  15.2 KB  |  340 lines
  1.  
  2.       ▄██████▄    ▀████████▄ ▀████████▄  ▀████▀ ██████████ ▀██████████
  3.      ██▀    ▀██     ██▀   ▀██  ██▀   ▀██   ██   █▀      ██   ██     ▀█
  4.      ██      ██     ██     ██  ██     ██   ██         ▄██    ██
  5.      ██      ██ ▄▄▄ ███▄▄▄██   ███▄▄▄██    ██       ▄██▀     █████
  6.      ██      ██     ██▀▀▀▀▀    ██▀██▀▀     ██     ▄██▀       ██
  7.      ██▄   █▄██     ██         ██  ▀█▄     ██   ▄██▀    ▄█   ██     ▄█
  8.       ▀███████     ▄██        ▄██   ▀██▄ ▄████▄ ██████████ ▄██████████ v2.5
  9.             ▀██
  10.                     The QuickBBS / RemoteAccess Prize Door
  11.  
  12.  ════════════════════════════════════════════════════════════════════════════
  13.                           A Hysteriaware[tm] Product
  14.                             The MASS Hysteria BBS
  15.                          (508)465-3198 - 300/9600HST
  16.                                Fido: 1:324/174
  17.  ════════════════════════════════════════════════════════════════════════════
  18.  
  19.  ■ Legal Statement
  20.    ═══════════════
  21.  
  22.            Nobody ever reads this but here it is.  This program may be
  23.            distributed among people as long as absolutely no modifications
  24.            are made in the program.  I, Brian Tardiff, will not be
  25.            responsible for ANY damage that this program may cause.  This
  26.            program shouldn't cause any damage but I will not be responsible
  27.            if it does.  PLEASE read this documentation (or at least the
  28.            setup) before you install the program.  Most damage is a result
  29.            of ignorance to follow instructions.  Thank You.
  30.  
  31.  
  32.  ■ Introduction   Q-Prize is a unique door for QuickBBS and RemoteAccess
  33.    ════════════   that allows the user to guess a number, and if he or she
  34.                   is correct, it lets the user select his or her OWN prize!
  35.                   The prizes are 100% SysOp Configurable.  They are:
  36.  
  37.                                            ■ System Time
  38.                                            ■ Upload Credit
  39.                                            ■ Message Post Credit
  40.                                            ■ A SPECIAL Prize Feature
  41.  
  42.                   The prizes suit the needs of almost any user.  If a user
  43.                   has a terrible file ratio, he or she may cash in with this
  44.                   prize.  If your system uses a Post/Call Ratio (Like QMRD,
  45.                   another Hysteriaware product available on MASS Hysteria)
  46.                   the user may select this option to up his or her ratio.
  47.                   Most obviously though, many users would love to have a
  48.                   little more time.  The user may take the time option and
  49.                   bank it for later use or use it during that call.
  50.  
  51.                   The SPECIAL Prize feature allows you to give away something
  52.                   that isn't supported by Q-Prize.  This feature is optional.
  53.  
  54.                   Users are only allowed in Q-Prize once per day.  That is,
  55.                   after they guess a number, they can't go back in until
  56.                   midnight.  If for some reason a user drops carrier BEFORE
  57.                   he or she guesses a number, the user will be permitted back
  58.                   into the door that day.
  59.  
  60.                   Q-Prize is fully multi-node compatible.  The door can
  61.                   flawlessly handle multiple users simultaneously.
  62.  
  63.                   Q-Prize has a full built in chat mode so you can talk to
  64.                   your user while he or she is in the door.
  65.  
  66.                   Q-Prize has a 'Throw out User' feature so you can
  67.                   immediately return a user to the BBS for any reason.
  68.  
  69.                   Q-Prize has a 'Force Win' feature.  You may force the
  70.                   user on-line to come out a winner.  The number the user
  71.                   guesses becomes irrelevant.
  72.  
  73.                   Q-Prize constantly monitors Carrier Detection so programs
  74.                   such as WatchDog are [NOT] required.
  75.  
  76.                   Q-Prize monitors Keyboard Timeout.  If the program stays idle
  77.                   for two minutes, the door will automatically exit back to
  78.                   your system.  However, the door will warn the user 15
  79.                   seconds before this happens.
  80.  
  81.  
  82.  ■ Archive Files
  83.    ═════════════
  84.  
  85.           QPRIZE.EXE   =  Main program
  86.  
  87.           QPRIZE.CFG   =  Sample configuration file
  88.  
  89.           QPRIZE.DOC   =  The file you are reading!
  90.  
  91.           QPINTRO.TXT  =  File displayed if user wants instructions.
  92.                           Modify this as you wish.
  93.  
  94.           QPSPEC.TXT   =  File displayed if winner selects Special Prize.
  95.                           Used for information of prize/obtaining/ect.
  96.                           Modify this as you wish.
  97.  
  98.           QPHELP.TXT   =  File displayed if winner selects "Help" from
  99.                           the Prize Menu.
  100.                           Modify this as you wish.
  101.  
  102.           QP1NODE.BAT  =  Example .BAT file for single node system not
  103.                           running Q-Prize from main BBS directory.
  104.  
  105.           QPMULTI.BAT  =  Example .BAT file for multi node systems.
  106.  
  107.           ORDER.FRM    =  Used to obtain registration KEY.  Details (and
  108.                           address) at end of documentation.
  109.  
  110.           UPDATE.DOC   =  Upgrading from v2.2 information.
  111.  
  112.  
  113.  ■ Files Q-Prize Creates
  114.    ═════════════════════
  115.  
  116.           QPRIZE.DAY   =  Stores information of who has used their turn
  117.                           for the current day.
  118.  
  119.           QPRIZE.WIN   =  A list of all winners.  If there is no .WIN
  120.                           file, this indicates that nobody has
  121.                           won.  You specify in the .CFG file how
  122.                           many recent winners are shown to the
  123.                           user.
  124.  
  125.  
  126.  ■ Configuration  Installing Q-Prize to your system is very simple.  First,
  127.    ═════════════  you must edit the QPRIZE.CFG file to customize Q-Prize to
  128.                   your system.  The format of the file is:
  129.  
  130.                                               Example in .CFG File
  131.                                               ═══════════════════════
  132.              Line #1:  BBS Name               The MASS Hysteria BBS
  133.              Line #2:  Range of number        15
  134.              Line #3:  Minutes to give        30
  135.              Line #4:  Uploads to give        5
  136.              Line #5:  K-Bytes for each u/l   25
  137.              Line #6:  M. Posts to give       10
  138.              Line #7:  Special Prize          *      [See BELOW!!]
  139.              Line #8:  # Of Recent Winners    15
  140.              Line #9:  Type of BBS            RA, QUICK or SUPER
  141.  
  142.                 ■ The "Range of number" option [Line #2] is the highest
  143.                   possible number that Q-Prize will select.  For example, if
  144.                   this is set to 15, then the number the user is to guess
  145.                   is between 0 and 15.
  146.  
  147.                 ■ The "Uploads to give" and "K-Bytes for each u/l" work
  148.                   together.  In this example, the user would receive 5 uploads
  149.                   each being worth 25k each (125k total).
  150.  
  151.                 ■ The SPECIAL PRIZE may be an 11 character description of what
  152.                   the prize is.  (i.e. 'Software').  If you place an * on this
  153.                   line, instead of a word, the SPECIAL PRIZE feature will not
  154.                   be implemented.  The prize will simply be listed as "N/A".
  155.  
  156.                 ■ The "# Of Recent Winners" option tells Q-Prize how many
  157.                   of the recent winners to show to the user. The QPRIZE.WIN
  158.                   file keeps the names of everyone who has ever won Q-Prize.
  159.                   Say you set this variable to 15, then only the last 15
  160.                   of these people will be shown to the user.  Handling
  161.                   the list this way benefits the SysOp and the User.  The
  162.                   sysop has a log of everyone that ever won, and the user
  163.                   only has to look at a certain amount of them.
  164.  
  165.                 ■ Type of BBS tells Q-Prize which BBS software you are
  166.                   running.  RA for RemoteAccess, QUICK for QuickBBS or
  167.                   SUPER for SuperBBS.
  168.  
  169.                 ■ The other options are basically self-explanatory.
  170.  
  171.  
  172.  ■ Installation - Single Node Setup
  173.    ═════════════════════════════════
  174.  
  175.         For a 1 node RemoteAccess system, you have two options for
  176.         installing Q-Prize.
  177.  
  178.         Option #1: Place all of the files in your main BBS directory.
  179.                    (ie: C:\RA).  Simply execute QPRIZE.EXE from a
  180.                    Type 7 Menu Command and you are all set.  No
  181.                    parameters are needed to run the program.
  182.  
  183.         Option #2: You may wish to run Q-Prize from a seperate directory.
  184.                    To do this, create a directory on your system to
  185.                    hold all the Q-Prize files. (I'll refer to this
  186.                    directory as \QPRIZE but you may name it whatever
  187.                    you desire).  To run the program from another
  188.                    directory the path to the EXITINFO.BBS and DORINFO1.DEF
  189.                    must be supplied as a parameter:
  190.  
  191.                             Example: QPRIZE.EXE C:\RA
  192.  
  193.                    See QP1NODE.BAT for example on this method!
  194.  
  195.  
  196.  ■ Installation - Multi Node Setup
  197.    ═══════════════════════════════
  198.  
  199.         Q-Prize is a complete multi-node door.  If you following the setup
  200.         correctly, Q-Prize will handle simultaneous users flawlessly.  This
  201.         is NOT another one of those doors that say "Sorry, someone is using
  202.         this door." when a person is already in.
  203.  
  204.         Just so there is NO confusion on how to set this door for multi-
  205.         node operation, I have provided detailed instructions on this.
  206.         Many people are new to this concept.  QPMULTI.BAT is the example
  207.         file included with this archive and is the file I will often
  208.         refer to.  You may rename this to QPRIZE.BAT or whatever you
  209.         wish.
  210.  
  211.         Hopefully your multi-node system is set in away so the paths
  212.         are identical except for the node number. (ie: \RA\NODE1, \RA\NODE2)
  213.         If this isn't the case, you will need more than one batch file.
  214.         If this is your case, contact me and I will inform you on how
  215.         to accomplish this.
  216.  
  217.               Create a Type 7 menu entry with the following info:
  218.               ───────────────────────────────────────────────────
  219.  
  220.               1         2         3         4         5         6
  221.               123456789012345678901234567890123456789012345678901
  222.               [^Z^] Q-Prize
  223.  
  224.               COMMAND.COM /C QPMULTI.BAT *N
  225.  
  226.               ───────────────────────────────────────────────────
  227.  
  228.  
  229.         The COMMAND.COM /C QPMULTI.BAT loads the batch file to run the
  230.         door.  Make sure the batch file is located in a directory that
  231.         has been pathed otherwise it will not load.
  232.  
  233.         The *N passes the current node number to the batch file.  This
  234.         is required for multi-node operation.
  235.  
  236.         Finally, edit the batch file that comes with this program to
  237.         suit your needs.  The QPMULTI.BAT contains extra info to show
  238.         you how this works.
  239.  
  240.  
  241.  ■ Registration
  242.    ════════════
  243.  
  244.              If you hate seeing the 'Unregistered Version' on the door,
  245.              just imagine getting rid of it!  For a small donation, you
  246.              can do just that.  HysteriaWare software is kept running
  247.              by SysOps JUST LIKE YOU who continue to register these
  248.              programs.  Without you guys, none of these programs would
  249.              be made available.  There are many registration options
  250.              available and I feel that all of them are very fair. Any
  251.              contribution would be greatly appreciated.
  252.  
  253.              Registration Options
  254.  
  255.               ■ One time registration obtains a KEY for all future versions.
  256.  
  257.                 $ 6.00  -  File Request KEY from BBS.
  258.                 $ 8.50  -  Mailed KEY (5.25" Disk).
  259.                 $10.00  -  Mailed KEY (3.5" Disk).
  260.  
  261.                 $20.00  -  HysteriaWare Special! Mailed (5.25") -> See Below
  262.                 $22.50  -  HysteriaWare Special! Mailed (3.5")
  263.  
  264.  
  265.                 The HysteriaWare Special is three of the major HysteriaWare
  266.                 programs.  The programs are the Q-Dog Door, Leech Finder v4.0
  267.                 (The Enhanced Version), and of course, The Q-Prize door! .
  268.  
  269.                        HysteriaWare Special constists of:
  270.  
  271.                                  ■ All 3 latest releases of the Public
  272.                                    Programs.
  273.  
  274.                                  ■ Registration keys or actual registered
  275.                                    .EXE files for all three.
  276.  
  277.  
  278.  
  279.                Simply print the ORDER.FRM file to your printer, fill out the
  280.                required information and send a check or money order (no cash
  281.                please) to:
  282.  
  283.                                    Brian Tardiff
  284.                                    9 Hawthorne Rd
  285.                                    Newburyport, Ma 01950
  286.  
  287.                Note:  Please make the check payable to Brian Tardiff.
  288.  
  289.  
  290.  ■ Implementing Registration
  291.    ═════════════════════════
  292.  
  293.              When you receive your key, you must rename it "QPRIZE.KEY"
  294.              and place it in the directory that Q-Prize is run from.
  295.              If Q-Prize recognizes it as a valid key, it will display
  296.              that it is a registered door.  If your Q-Prize door still
  297.              says "Un-Registered Copy", and you have followed the proper
  298.              procedure, there may be a problem with your key.  If this
  299.              happens, contact me.  ANY PROBLEM WITH A KEY THAT IS A RESULT
  300.              OF MY ERROR, WILL BE RE-COMPILED AND SENT TO YOUR SYSTEM FREE
  301.              OF CHARGE.
  302.  
  303.  
  304.  
  305. ══════════════════════════════════════════════════════════════════════════
  306.  
  307. HysteriaWare Software
  308.  
  309.     HysteriaWare Products are available on many poplular bulletin boards
  310.     including the four Official Distribution sites.  If you wish to
  311.     become a distribution site, or simply just tap into our echo link,
  312.     please let me know by sending netmail to 1:324/174 telling me about
  313.     your system.
  314.  
  315.     Sorry, but due to the enormous amount of long distance NETmail I
  316.     have been receiving lately, we cannot send back the reply.  This
  317.     is especially a problem with the overseas netmail.  Your mail will
  318.     be held for you and you must call back for it.  Thanks for your
  319.     cooperation.
  320.  
  321.        To receive a list of all the currrent HysteriaWare products,
  322.            you can simplay F'req 'HYSTWARE.TXT' from the system.
  323.  
  324.  
  325.  
  326.          The MASS Hysteria BBS             The Redstone BBS
  327.          Home of HysteriaWare!             Canadian Distribution Site - I
  328.          SysOp: Mark Warnat & Myself       SysOp: Alan Shi
  329.          (508)465-3198 - 1:324/174         (519)742-7549 - 1:221/185
  330.          300-9600 (HST) - 24 Hours         300-9600 (HST) - 24 Hours
  331.  
  332.          Billboard BBS                     Echo Valley
  333.          Philippines/Japan Site            Canadian Distribution Site - II
  334.          SysOp: Bill English               SysOp: Rick Chartrand
  335.          460-385-3884                      (613)749-1016 - 1:163/234
  336.          (Commercial 01-63-47-385-3884)    300-2400 Baud - 24 Hours
  337.          Fido (Local): 3:2/3
  338.  
  339.  
  340.