home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbsdoor / mctriv10.zip / MCTRIVIA.DOC < prev    next >
Text File  |  1991-11-07  |  18KB  |  405 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                 ┌──────────────────────────────────────────────┐
  18.                 │             MOTOR CITY SOFTWARE              │
  19.                 │   ┌──────────────────────────────────────┐   │
  20.                 │   │         Trivia Masters Door          │   │
  21.                 │   │           Copyrighted 1991           │   │
  22.                 │   │             ┌──────────┐             │   │
  23.                 │   │             │\         │             │   │
  24.                 │   │             │ \        │             │   │
  25.                 │   │             │  \       │             │   │
  26.                 │   │             │   \      │             │   │
  27.                 │   │             │   │      │             │   │
  28.                 │   │             │   │      │             │   │
  29.                 │   │             │   │      │             │   │
  30.                 │   │             │  o│      │             │   │
  31.                 │   │             │   │      │             │   │
  32.                 │   │             \   │──────┘             │   │
  33.                 │   │              \  │                    │   │
  34.                 │   └───────────────\ │────────────────────┘   │
  35.                 │       The Ultimate \│ in Door Writing .      │
  36.                 └─────────────────────┴────────────────────────┘
  37.  
  38.  
  39.                             MCTrivia  -  Version 1.0
  40.                       Copyright 1991 by Motor City Software
  41.                                All Rights Reserved
  42.  
  43.  
  44.  
  45.     
  46.  
  47.     ╒══════════════════════════════════════════════════════════════════════════╕
  48.     │░░░░░░ LICENSING INFORMATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░ MCTrivia v1.0 ░░░│
  49.     ╘══════════════════════════════════════════════════════════════════════════╛
  50.  
  51.        This program is not Freeware.  This is SHAREWARE which means it is user-
  52.     supported software.  If you use this program for more than 30 days, you are
  53.     required to register or remove it from your system.  The registration fee
  54.     is a mere $10.00 and is not a lot to ask.
  55.  
  56.        The concept works only with your support.  If you find that you can use
  57.     this program, then a registration fee of $10.00 U.S. funds will help defray
  58.     the development cost and encourage the authorship of other programs that
  59.     might be useful to you.  A  Registration Form for this purpose is included
  60.     with the distribution archive and is called REGISTER.??? where ??? is a
  61.     country with a registration site.
  62.  
  63.        MCTrivia is Copyrighted 1991 by Motor City Software and all rights are
  64.     reserved. You may copy this program and documentation for backup purposes.
  65.     You also may copy and share UNMODIFIED copies of the program package,
  66.     providing that the copyright notice is reproduced and included on all
  67.     copies.
  68.  
  69.        You may not sell the product for a fee and/or distribute the product
  70.     along with other products without expressed written permission from Motor
  71.     City Software, nor may you modify or remove the Copyright Notice from the
  72.     program or the documentation.
  73.  
  74.        Comments, suggestions and bug reports are welcome.  If you have any, you
  75.     should contact one of the Motor City Software Support Systems listed below.
  76.  
  77.  
  78.     Sysop Name           Location               Phone           Net Address
  79.     ----------           --------               -----           -----------
  80.     Rod Hancock          Oshawa, Ont. Can.      (416) 579-6318  1:229/418
  81.     Jeff Wilson          Bowmanville Ont Can.   (416) 623-5148  1:229/414
  82.     Peter Kling          Albany NY USA          (518) 437-1267  1:267/169
  83.     Denis Bennet         Faversham Kent UK      +44-795-538359  2:440/11
  84.     Peter Janssens       Venray Netherlands     +31-4780-12428  2:512/1
  85.     Terry Harvey         Burwood NSW Australia  +61-2-7453500   3:712/704
  86.  
  87.     We also have a VOICE support line.  If you have any problems which require
  88.     immediate help, feel free to call us.
  89.  
  90.     Motor City Software
  91.     Oshawa Ontario Canada
  92.     (416) 579-3256  (9am - 5pm)  VOICE ONLY
  93.  
  94.  
  95.     If you're reporting a bug, please give as much detail as possible about the
  96.     problem you are experiencing so that it can be duplicated and fixed.
  97.  
  98.  
  99.     
  100.  
  101.     ╒══════════════════════════════════════════════════════════════════════════╕
  102.     │░░░░░░ INTRODUCTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ MCTrivia v1.0 ░░░│
  103.     ╘══════════════════════════════════════════════════════════════════════════╛
  104.  
  105.  
  106.        MCTrivia is an online Trivia Question and Answer type Game for QuickBBS
  107.     and RemoteAccess BBS which utilizes full record locking. Therefore you may
  108.     have more than one user playing the game at the same time.
  109.  
  110.        It allows users to gamble their time remaining while online if
  111.     configured to do so. Otherwise it runs as a straight forward Trivia game.
  112.     The program is pretty straight forward and and easy to install. It does
  113.     not require ANSI graphics to be turned ON by the user. If a caller runs
  114.     MCTrivia and does not have graphics turned on, the program will switch
  115.     into the non-graphics mode.
  116.  
  117.        MCTrivia allows the BBS Sysop to configure the game to allow time
  118.     betting or not as well as the maximum number of minutes a user may
  119.     accumulate while in the game.  Once a user has reached a maximum number
  120.     of accumulative minutes, the user is not allowed to access the game until
  121.     the next day.
  122.  
  123.        If MCTrivia has been configured to allow Time Betting then the player
  124.     may turn this feature off and on at his/her discretion. This will allow
  125.     a player who wants to play just for points to do so.
  126.  
  127.        MCTrivia has a default answer timeout of 45 seconds which means that
  128.     the player has 45 seconds to answer the question before the game gives
  129.     an "Incorrect" response.
  130.  
  131.        Sysops may configure the game to allow questions to be skipped.
  132.     A word of warning on this is that a player can go through the database
  133.     and answer only the questions he/she knows. If the time betting is
  134.     active, it would be very easy for one to win the maximum amount of time
  135.     allowed.
  136.  
  137.  
  138.     
  139.  
  140.     ╒══════════════════════════════════════════════════════════════════════════╕
  141.     │░░░░░░ INSTALLATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ MCTrivia v1.0 ░░░│
  142.     ╘══════════════════════════════════════════════════════════════════════════╛
  143.  
  144.  
  145.     MCTrivia is easy to install.  With a RemoteAccess or QuickBBS setup,
  146.     A type 7 menu entry may be used, as follows:
  147.  
  148.     Optional Data : *C /C MCTrivia.Bat
  149.  
  150.     This calls a batch file MCTRIVIA.BAT which looks like this:
  151.  
  152.     cd \doors\mctrivia
  153.     mctrivia 1
  154.     cd \bbs
  155.  
  156.        Within your batch file, you will execute MCTrivia. Do this by entering
  157.     the command line:
  158.  
  159.           MCTRIVIA 1
  160.  
  161.        This will bring the door up as an online game. Please follow the
  162.     instructions in the MCTRIV1.CFG file. The ''1'' can be replace by the
  163.     node number that you are setting the door up for. For example,
  164.     MCTRIV2.CFG file would be set up for Node 2 and called from your batch
  165.     file like:
  166.  
  167.                   MCTRIVIA 2
  168.  
  169.  
  170.     
  171.  
  172.     ╒══════════════════════════════════════════════════════════════════════════╕
  173.     │░░░░░░ CONFIGURATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ MCTrivia v1.0 ░░░│
  174.     ╘══════════════════════════════════════════════════════════════════════════╛
  175.  
  176.  
  177.     C:\DOORS\MCTRIVIA\
  178.     C:\DOORS\RATS\
  179.     1
  180.     Y
  181.     Y
  182.     10
  183.     200
  184.     45
  185.     General
  186.     Music
  187.     Television
  188.     Star Trek
  189.     Movies
  190.     Sports
  191.     History
  192.     Geography
  193.  
  194.     This is the configuration file for MCTrivia.  The first 6 lines are read.
  195.     All lines after that are ignored and should be considered comments.
  196.  
  197.     Line 1 : Path to DORINFOx.DEF/EXITINFO.BBS.  (i.e. \RA\)
  198.              MCTrivia may be run without an EXITINFO.BBS but the time
  199.              betting feature will be disabled.
  200.     Line 2 : Path to RATS.EXE.  This is where the external time bank support
  201.              file will be appended/created. Leave blank if you don't want to
  202.              use the Time Bank support.
  203.     Line 3 : This is the 'node' or 'line' number in use.  IMPORTANT: If this
  204.              is a '1' then MCTrivia will look for DORINFO1.DEF.  If this is
  205.              a '2' then MCTrivia will look for DORINFO2.DEF, etc..
  206.     Line 4 : If this is set to "Y" then the players will be allowed to
  207.              skip question. If "N" they will not.
  208.     Line 5 : Set to "Y" or "N". This is where 'Y' the door will operate on a
  209.              "Bet time on your Answer" or 'N' as a plain Trivia door.
  210.     Line 6 : This is the maximum number of minutes that can be bet on any one
  211.              question. Only if line 5 is set to "Y".
  212.     Line 7 : Maximum winnings.  This is a value between 1 and 32000.  If not in
  213.              this range, the default of 100 will be used.  This is the maximum
  214.              number of minutes that a player can come back to the BBS with.
  215.              Anything over this amount will be automatically deposited in the
  216.              user's RATS bank account (or chopped off it RATS is not being used).
  217.              If you're not using RATS, set this value high if you want to avoid
  218.              chopping the user's time off.
  219.              Only if line 2 is a valid path and line 4 is set to "Y".
  220.     Line 8 : This is the Answer timeout in seconds. If a player has not input
  221.          his full answer by the time this reaches 0 then he is penialized
  222.          with a wrong answer. The default is 45 seconds.
  223.     Line 9 : These are the Question Area display list. All 8 lines MUST be
  224.       to     alocated even if some are left blank. The entries will be
  225.     Line 16: displayed in the Area Choice Menus to the first blank line found
  226.              above or to the 8th entry ( line 16 ).
  227.  
  228.  
  229.     
  230.  
  231.     ╒══════════════════════════════════════════════════════════════════════════╕
  232.     │░░░░░░ COMMAND LINE PARAMETERS ░░░░░░░░░░░░░░░░░░░░░░░░░ MCTrivia v1.0 ░░░│
  233.     ╘══════════════════════════════════════════════════════════════════════════╛
  234.  
  235.  
  236.               MCTRIVIA MAINT 45
  237.  
  238.        This is used to compress the player data base. There must be no
  239.     one playing the game on any node when you run the maintenance.
  240.     In the example, any player that has not entered the door within
  241.     45 days will be deleted.
  242.     This has no effect on the Question & Answer database.
  243.  
  244.  
  245.               MCTRIVIA EXPORT Myfile.txt
  246.  
  247.       This allows you to export the Question & Answer base for editing with
  248.     you favourite text editor. May be ran while someone is playing the game.
  249.  
  250.  
  251.               MCTRIVIA IMPORT Myfile.txt
  252.  
  253.       This allows you to import the Question & Answer base after editing it
  254.     with you favourite text editor. There must be NO ONE PLAYING THE GAME when
  255.     you import your text Q & A file or undesireable results may occur. The
  256.     MCTRIVIA.DAT file will have the new questions added to the end of it so
  257.     you have to delete it if you are starting new oe editing the whole file.
  258.  
  259.     The file has to be a formatted text file as follows :
  260.  
  261.     1 Which company makes the best BBS game doors?
  262.     MOTOR CITY SOFTWARE                 Jeff Wilson
  263.  
  264.     Line 1 Column 1        : This is the area that the question should be
  265.                              placed into. ( 1 digit only! )
  266.     Line 1 Column 3 to 77  : This is the Question that is displayed.
  267.  
  268.     Line 2 Column 1 to 35  : This is the Answer that Your input answer is
  269.                              compared to. ( UPPERCASE ONLY! )
  270.     Line 2 Column 36 to 70 : This is the entered by field. The name of the
  271.                              player who wrote the question goes here. If
  272.                              this is not filled in, MCTrivia will use
  273.                              "MCTrivia".
  274.  
  275.  
  276.     For an example, use EXPORT to export the Q & A base to a text file
  277.     and look at it..
  278.  
  279.  
  280.     
  281.  
  282.     ╒══════════════════════════════════════════════════════════════════════════╕
  283.     │░░░░░░ SUPPORT FILES ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ MCTrivia v1.0 ░░░│
  284.     ╘══════════════════════════════════════════════════════════════════════════╛
  285.  
  286.  
  287.         The MCTrivia archive comes with a few files needed by the program.
  288.     You can run MCTrivia from any directory.
  289.     The files that come with the archive are:
  290.  
  291.     MCTRIVIA.EXE                       This is the door program
  292.     MCTMENU.ANS                        This is the graphic main menu
  293.     MCTMENU.ASC                        This is the non graphic main menu
  294.     MCTRIVIA.DOC                       This document
  295.     MCTRIVIA.HLP                       This is the players help file
  296.  
  297.     NOTE: - You can edit or change the contents of MCTMENU.ANS, MCTMENU.ASC
  298.             These files are only bound by the keys available for use by the
  299.             program.
  300.           - In the MCTRIVIA.HLP file you see some control codes for color.
  301.             You can edit these within this format :
  302.  
  303.                      Control-K [ ForeGround, Backround
  304.  
  305.             The foreground and background colors must be a Hexadecimal digit
  306.             from 1 to F.  Backround colors above 7 cause the foreground to
  307.             flash.
  308.  
  309.             Foreground            Background   ->   Flashing Foreground
  310.             ──────────            ──────────        ───────────────────
  311.              0 - Black             0 - Black                N
  312.              1 - Blue              1 - Blue                 N
  313.              2 - Green             2 - Green                N
  314.              3 - Cyan              3 - Cyan                 N
  315.              4 - Red               4 - Red                  N
  316.              5 - Magneta           5 - Magneta              N
  317.              6 - Brown             6 - Brown                N
  318.              7 - Light Grey        7 - Light Grey           N
  319.              8 - Dark Grey         8 - Black                Y
  320.              9 - Light Blue        9 - Blue                 Y
  321.              A - Light Green       A - Green                Y
  322.              B - Light Cyan        B - Cyan                 Y
  323.              C - Light Red         C - Red                  Y
  324.              D - Light Magneta     D - Magneta              Y
  325.              E - Yellow            E - Brown                Y
  326.              F - White             F - Light Grey           Y
  327.  
  328.        In addition to these files, MCTrivia will also create files it needs to
  329.     operate.  They are :
  330.  
  331.     MCTUSERS.DAT                     - The Players data file.
  332.     THEBANK.EXT                      - External time bank utility file.  This
  333.                                        file is created and is read by
  334.                                        RATS (Remote Access TimeBank System)
  335.                                        Do not delete this file.  RATS will
  336.                                        delete it each time it has read it.
  337.     MCTERROR.LOG                     - Reference to any run time errors that
  338.                                        might occur.
  339.     MCTEXIT.LOG                      - Reference to any unusual game exits
  340.                                        that might occurr. Helpful in debugging
  341.                                        problems.
  342.  
  343.     
  344.  
  345.     ╒══════════════════════════════════════════════════════════════════════════╕
  346.     │░░░░░░ MORE ON TIME BANKING ░░░░░░░░░░░░░░░░░░░░░░░░░░░░ MCTrivia v1.0 ░░░│
  347.     ╘══════════════════════════════════════════════════════════════════════════╛
  348.  
  349.  
  350.        When RATS is run and locates THEBANK.EXT, it will read it through to
  351.     the end of the file updating or adding user accounts as needed.  The format
  352.     of THEBANK.EXT is:  User Name:Time
  353.  
  354.        For example, if JOHN DOE wins 80 minutes and MCTrivia deposits 20
  355.     minutes into his account, the following line will be appended
  356.     to THEBANK.EXT:
  357.  
  358.                                 JOHN DOE:20
  359.  
  360.        A user's name can appear in this file more than once.  The Bank will
  361.     handle it properly.  For more details, see RATS 1.01 or later.
  362.  
  363.  
  364.  
  365.     ╒══════════════════════════════════════════════════════════════════════════╕
  366.     │░░░░░░ NOTES FROM THE AUTHOR ░░░░░░░░░░░░░░░░░░░░░░░░░░░ MCTrivia v1.0 ░░░│
  367.     ╘══════════════════════════════════════════════════════════════════════════╛
  368.  
  369.  
  370.        MCTrivia has built in carrier detect and inactivity timer routines.
  371.     When tested on COM1 thru COM4, carrier detect and inactivity timers both
  372.     worked flawlessly.
  373.  
  374.        That's as far in as I'm going to go technically with this program.
  375.     Once you load it up, you will see that it is self-explainatory.
  376.     But there are a few limitations that I would like to mention.
  377.  
  378.        MCTrivia will not run in Time betting mode unless it finds EXITINFO.BBS
  379.     and DORINFO1.DEF in the directory specified in the config file. If it
  380.     finds just the DORINFO1.DEF, it will run as a non betting door.
  381.  
  382.        MCTrivia will not allow a user with less than 3 minutes access to the
  383.     program.
  384.  
  385.        When a player enters the game, their time remaining is recorded.  They
  386.     are issued a grand total based on their time remaining.
  387.     The field "Total Time" in the "Your Scores" reflects the amount of time
  388.     available for gambling purposes.  It does not affect the time the player
  389.     has within the program.  If a player has 10 minutes left when he enters
  390.     the program, he can play for 10 minutes regardless of how much time he
  391.     wins.  The reason for this is if a system event is pending in 10 minutes
  392.     and the user enters the program, then the program must return the user to
  393.     the BBS in time for that event to run.  If the user has won time, he can
  394.     call back after the system event has run and the time should still be
  395.     available provided it was not truncated by the BBS (this may be the case
  396.     if no time banking support is used).
  397.  
  398.        As always, if you have any questions, comments, or problems with this
  399.     program, feel free to contact one of the support systems listed above.
  400.  
  401.     Thank You,
  402.  
  403.     Jeff Wilson,
  404.     Motor City Software
  405.