home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / ARCADE_3.ZIP / TRIVIA10.ZIP / TRIVIA.DOC < prev    next >
Text File  |  1996-03-10  |  16KB  |  350 lines

  1.  
  2.  
  3.                       T R I V I A     D O C U M E N T A T I O N
  4.  
  5.                                   Version 1.0
  6.                           Copyright 1995 - 1996 SoftNet
  7.                                All Rights Reserved
  8.  
  9.  
  10.  
  11.                             Co-Owners' of SoftNet
  12.  
  13.  
  14.                      David Smart                  Peter Kling
  15.                     Space Station         Info System Technology, Inc.
  16.  FidoNet:             1:324/285                    1:374/169
  17.  Phone BBS/FAX:    1-508-454-0356               1-407-729-9166
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24. ╒════════════════════════════════════════════════════════════════════════════╕
  25. │░░░░░░ LICENSING INFORMATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ Trivia 1.00 ░░░│
  26. ╘════════════════════════════════════════════════════════════════════════════╛
  27.  
  28. This is a licence agreement between you the end user and SoftNet Trivia,
  29. including any files, executables, documentation, etc are the property of SoftNet
  30. Please read the terms and conditions of this licence agreement carefully
  31. before using the software. If you for any reason, whatsoever, cannot accept the
  32. conditions in this agreement, you are not permitted to use Trivia.
  33.  
  34. You acknowledge and agree that Trivia is a proprietary product of SoftNet
  35. protected by applicable copyright laws and international treaty provisions. You
  36. further acknowledge and agree that all rights,  title,  and interest in, and to
  37. Trivia are and shall remain with SoftNet
  38.  
  39. Trivia may be used for a period of thirty (30) days on a trial basis to allow
  40. you to determine its  suitability for your particular application.   After this
  41. period you MUST register Trivia, or remove it from your system.
  42.  
  43. Registration entitles you to use  Trivia and any future versions of  Trivia for
  44. as  long  as you wish,  subject  to any  special  licensing  conditions  and/or
  45. applicable upgrade fees attached to future versions.
  46.  
  47. In the event that you are in violation of this licence agreement, you agree and
  48. accept that  SoftNet  may  cancel your  registration and any rights to use
  49. Trivia that you may have. In the case of a dispute over the licence agreement
  50. you further agree and accept to fully reimburse SoftNet for legal and other
  51. expenses resulting from the dispute.
  52.  
  53. Trivia  is  provided  "as is",  without  warranty of any kind, or fitness for a
  54. particular purpose, either expressed or implied,  all of are hereby  explicitly
  55. disclaimed. SoftNet only guarantees that Trivia will occupy disk space.
  56.  
  57. SoftNet liability resulting from your use or inability to use Trivia is
  58. limited to the amount that the affected party has paid for it,  or in the event
  59. that  Trivia  was  registered with a  third party  for payment to SoftNet,
  60. liability is limited to the amount that was received by SoftNet  from that
  61. third party.
  62.  
  63. Neither SoftNet nor any of its employees, agents, or other representatives
  64. are in any way obligated to provide future versions of or support for Trivia.
  65. You may freely distribute and copy Trivia provided that no fee is charged and
  66. the Trivia distribution  archive contains  unmodified  copies of the original
  67. files as  produced by  SoftNet  Pay  Bulletin Board Systems may,  however,
  68. charge  their  normal  fee  provided that  no additional charge for Trivia is
  69. levied.  No part  of  Trivia may be  modified,  altered,  reverse engineered,
  70. sold, or distributed  in  any  form  whatsoever which  would  involve some sort
  71. of trade without prior written permission from SoftNet
  72.  
  73.  
  74.  
  75. ╒══════════════════════════════════════════════════════════════════════════════╕
  76. │░░░░░░ INTRODUCTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ Trivia 1.00 ░░░│
  77. ╘══════════════════════════════════════════════════════════════════════════════╛
  78.  
  79.  
  80.        Trivia is an online Trivia Question and Answer type Game for any BBS
  81.     that uses a fossil driver, and is capable of creating a DOOR.SYS or a
  82.     DORINFO1.DEF drop file.  If the door is used with RemoteAccess, QBBS,
  83.     SuperBBS, or ProBoard, then the user will be allowed to gamble Time in
  84.     the game.  Support is also provided for running a TimeBank door capable
  85.     of reading THEBANK.EXT files (Such as SoftNet's RATS TimeBank)
  86.  
  87.     The program is pretty straight forward and and easy to install. It does
  88.     not require ANSI graphics to be turned ON by the user. If a caller runs
  89.     Trivia and does not have graphics turned on, the program will switch
  90.     into the non-graphics mode.
  91.  
  92.        Trivia allows the BBS Sysop to configure the game to allow time
  93.     betting or not as well as the maximum number of minutes a user may
  94.     accumulate while in the game.  Once a user has reached a maximum number
  95.     of accumulative minutes, the user is not allowed to access the game until
  96.     the next day.
  97.  
  98.        If Trivia has been configured to allow Time Betting then the player
  99.     may turn this feature off and on at his/her discretion. This will allow
  100.     a player who wants to play just for points to do so.
  101.  
  102.        Trivia has a default answer timeout of 45 seconds which means that
  103.     the player has 45 seconds to answer the question before the game gives
  104.     an "Incorrect" response.
  105.  
  106.        Sysops may configure the game to allow questions to be skipped.
  107.     A word of warning on this is that a player can go through the database
  108.     and answer only the questions he/she knows. If the time betting is
  109.     active, it would be very easy for one to win the maximum amount of time
  110.     allowed. If you enable time gambling, you should disable the ability
  111.     to Skip Questions.
  112.  
  113.  
  114.     
  115.  
  116.   ╒══════════════════════════════════════════════════════════════════════════╕
  117.   │░░░░░░ INSTALLATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ Trivia 1.00 ░░░│
  118.   ╘══════════════════════════════════════════════════════════════════════════╛
  119.  
  120.  
  121.     Trivia is easy to install.  With a RemoteAccess or QuickBBS setup,
  122.     A type 7 menu entry may be used, as follows:
  123.  
  124.         Optional Data : *C /C C:\BBS\DOORS\Trivia\Trivia.EXE /N*N *M
  125.  
  126.        Of course your path may differ from the above example.
  127.        The '*N' is an example of how the BBS passes the node number
  128.        to the door.
  129.  
  130.        Add a '/D' without the quotes as a command line parameter if you
  131.     are using a DOOR.SYS drop file. Time betting will be disabled if this
  132.     switch is used.
  133.  
  134.  
  135.     
  136.  
  137.   ╒══════════════════════════════════════════════════════════════════════════╕
  138.   │░░░░░░ CONFIGURATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ Trivia 1.00 ░░░│
  139.   ╘══════════════════════════════════════════════════════════════════════════╛
  140.  
  141.  
  142.     C:\DOORS\RATS\
  143.     Y
  144.     Y
  145.     10
  146.     200
  147.     45
  148.     General
  149.     Music
  150.     Television
  151.     Star Trek
  152.     Movies
  153.     Sports
  154.     History
  155.     Geography
  156.  
  157.     This is the configuration file for Trivia. The first 22 lines are read.
  158.     All lines after that are ignored and should be considered comments.
  159.  
  160.     Line 1 : This is where the external time bank support file (THEBANK.EXT)
  161.              will be appended/created. Leave blank if you don't want to
  162.              use the Time Bank support.
  163.     Line 2 : If this is set to "Y" then the players will be allowed to
  164.              skip question. If "N" they will not.
  165.     Line 3 : Set to "Y" or "N". This is where 'Y' the door will operate on a
  166.              "Bet time on your Answer" or 'N' as a plain Trivia door.
  167.     Line 4 : This is the maximum number of minutes that can be bet on any one
  168.              question. Only if line 3 is set to "Y".
  169.     Line 5 : Maximum winnings.  This is a value between 1 and 32000.  If not in
  170.              this range, the default of 100 will be used.  This is the maximum
  171.              number of minutes that a player can come back to the BBS with.
  172.              Anything over this amount will be automatically deposited in the
  173.              user's RATS bank account (or chopped off it RATS is not being used).
  174.              If you're not using RATS, set this value high if you want to avoid
  175.              chopping the user's time off.
  176.              Only if line 1 is a valid path and line 3 is set to "Y".
  177.     Line 6 : This is the Answer timeout in seconds. If a player has not input
  178.          his full answer by the time this reaches 0 then he is penalized
  179.          with a wrong answer. The default is 45 seconds.
  180.     Line 7 : These are the Question Area display list. All 16 lines MUST be
  181.       to     allocated even if some are left blank. The entries will be
  182.     Line 22: displayed in the Area Choice Menus to the first blank line found
  183.              above or to the 16th entry ( line 22 ).
  184.  
  185.  
  186.     NOTE!!!  The Trivia.CFG file has been named Trivia.CNF in this
  187.              distribution archive so as not to overwrite any existing
  188.              one you may have.  RENAME it to Trivia.CFG if you are
  189.              installing this for the first time.
  190.  
  191.     
  192.  
  193.   ╒══════════════════════════════════════════════════════════════════════════╕
  194.   │░░░░░░ COMMAND LINE PARAMETERS ░░░░░░░░░░░░░░░░░░░░░░░░░░░ Trivia 1.00 ░░░│
  195.   ╘══════════════════════════════════════════════════════════════════════════╛
  196.  
  197.  
  198.               Trivia MAINT 45
  199.  
  200.        This is used to compress the player data base. There must be no
  201.     one playing the game on any node when you run the maintenance.
  202.     In the example, any player that has not entered the door within
  203.     45 days will be deleted.
  204.     This has no effect on the Question & Answer database.
  205.  
  206.  
  207.               Trivia EXPORT Myfile.txt
  208.  
  209.       This allows you to export the Question & Answer base for editing with
  210.     you favorite text editor. May be ran while someone is playing the game.
  211.  
  212.  
  213.               Trivia IMPORT Myfile.txt
  214.  
  215.       This allows you to import the Question & Answer base after editing it
  216.     with you FAVORITE text editor. There must be NO ONE PLAYING THE GAME when
  217.     you import your text Q & A file or undesirable results may occur. The
  218.     Trivia.DAT file will have the new questions added to the end of it so
  219.     you have to delete it if you are starting new oe editing the whole file.
  220.  
  221.     The file has to be a formatted text file as follows :
  222.  
  223.     1  Which company makes the best BBS game doors?
  224.     SoftNet                        Jeff Wilson
  225.  
  226.     Line 1 Column 1 to 2   : This is the area that the question should be
  227.                              placed into. ( 2 digits Maximum! )
  228.     Line 1 Column 4 to 78  : This is the Question that is displayed.
  229.  
  230.     Line 2 Column 1 to 35  : This is the Answer that Your input answer is
  231.                              compared to. ( UPPER CASE ONLY! )
  232.     Line 2 Column 36 to 70 : This is the entered by field. The player who
  233.                              wrote the question name goes here. If not
  234.                              filled in, Trivia will use "Trivia".
  235.  
  236.  
  237.     For an example, use EXPORT to export the Q & A base to a text file
  238.     and look at it..
  239.  
  240.  
  241.     
  242.  
  243.   ╒══════════════════════════════════════════════════════════════════════════╕
  244.   │░░░░░░ SUPPORT FILES ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ Trivia 1.00 ░░░│
  245.   ╘══════════════════════════════════════════════════════════════════════════╛
  246.  
  247.  
  248.         The Trivia archive comes with a few files needed by the program.
  249.     You can run Trivia from any directory.
  250.     The files that come with the archive are:
  251.  
  252.  
  253.     Trivia.EXE                       This is the door program.
  254.     Trivia.CFG                       This is the configuration file.
  255.     TMENU.ANS                        This is the graphic main menu.
  256.     TMENU.ASC                        This is the non graphic main menu.
  257.     Trivia.DOC                       This document.
  258.     Trivia.HLP                       This is the players help file.
  259.     Trivia.DAT                       The Question and Answer Data File
  260.  
  261.  
  262.     NOTE: - You can edit or change the contents of TMENU.ANS, TMENU.ASC
  263.             These files are only bound by the keys available for use by the
  264.             program.
  265.           - In the Trivia.HLP file you see some control codes for color.
  266.             You can edit these within this format :
  267.  
  268.                      Control-K [ ForeGround, Background
  269.  
  270.             The foreground and background colors must be a Hexadecimal digit
  271.             from 1 to F.  BACKGROUND colors above 7 cause the foreground to
  272.             flash.
  273.  
  274.             Foreground            Background   ->   Flashing Foreground
  275.             ──────────            ──────────        ───────────────────
  276.              0 - Black             0 - Black                N
  277.              1 - Blue              1 - Blue                 N
  278.              2 - Green             2 - Green                N
  279.              3 - Cyan              3 - Cyan                 N
  280.              4 - Red               4 - Red                  N
  281.              5 - Magenta           5 - MAGENTA              N
  282.              6 - Brown             6 - Brown                N
  283.              7 - Light Grey        7 - Light Grey           N
  284.              8 - Dark Grey         8 - Black                Y
  285.              9 - Light Blue        9 - Blue                 Y
  286.              A - Light Green       A - Green                Y
  287.              B - Light Cyan        B - Cyan                 Y
  288.              C - Light Red         C - Red                  Y
  289.              D - Light MAGENTA     D - MAGENTA              Y
  290.              E - Yellow            E - Brown                Y
  291.              F - White             F - Light Grey           Y
  292.  
  293.  
  294.  
  295.  
  296.  
  297.     
  298.  
  299.   ╒══════════════════════════════════════════════════════════════════════════╕
  300.   │░░░░░░ SUPPORT FILES ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ Trivia 1.00 ░░░│
  301.   ╘══════════════════════════════════════════════════════════════════════════╛
  302.  
  303.  
  304.        In addition to these files, Trivia will also create files it needs to
  305.     operate.  They are :
  306.  
  307.  
  308.     TUSERS.DAT                     - The Players data file.
  309.     THEBANK.EXT                      - External time bank utility file.  This
  310.                                        file is created and is read by
  311.                                        RATS v1.10 and later.
  312.                                        Do not delete this file.  RATS will
  313.                                        delete it each time it has read it.
  314.     TRIV??.ERR                     - Reference to any unusual game exits
  315.                                        that might occur. Helpful in debugging
  316.                                        problems. The ?? will be replaced by
  317.                                        the node number that generated the
  318.                                        error.
  319.     Trivia.BAD                     - This optional file can contain words
  320.                                        that you don't want to appear in new
  321.                                        questions and answers. One word per
  322.                                        line. The words may be uppercase or
  323.                                        lowercase. If one of these words are
  324.                                        found when a player adds a new question
  325.                                        and answer, they will be notified that
  326.                                        their input was rejected and allowed
  327.                                        to try again.
  328.  
  329.  
  330.     
  331.  
  332.  ╒══════════════════════════════════════════════════════════════════════════╕
  333.  │░░░░░░ MORE ON TIME BANKING ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ Trivia 1.00 ░░░│
  334.  ╘══════════════════════════════════════════════════════════════════════════╛
  335.  
  336.  
  337.      When The Bank is run and locates THEBANK.EXT, it will read it through to
  338.   the end of the file updating or adding user accounts as needed.  The format
  339.   of THEBANK.EXT is:  User Name:Time
  340.  
  341.        For example, if JOHN DOE wins 80 minutes and Trivia deposits 20
  342.     minutes into his account, the following line will be appended
  343.     to THEBANK.EXT:
  344.  
  345.                                 JOHN DOE:20
  346.  
  347.        A user's name can appear in this file more than once.  The Bank will
  348.     handle it properly.  For more details, see RATS 1.01 or later.
  349.  
  350.