home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbsdoor / sfklttrv.zip / SFKLTTRV.DOC < prev    next >
Text File  |  1993-05-15  |  22KB  |  505 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                         ·        ·    ·       .      ·°     .     ·   °  ·
  9.    .   ·   ·         ·      _------_        _------_
  10. ·           °  ·           / /~~~~~~~\----/~~~~~~~\ \     ·             ·     *
  11.        .                __|_|    /~ _-~~~~-_ ~\    |_|__         ·    .
  12.           ·       __--~~____|   |  /________\  |   |____~~--__           ·
  13.      ·      __--~~__--~~     ~---__\   ()   /__---~     ~~--__~~--__
  14. ·        /~~__--~~         .        ~--__--~                  ~~--__~~\       ·
  15.        / /~~                                        ·   .           ~~\ \
  16.      / /            ·   ·         ·        ·                            \ \
  17.     ( )        ·     .       ·       ·        .          ·       ·       ( )
  18. ·                                          ·      ·          .
  19. .               ·
  20.  
  21.                    ▀▀▀▀▀    ▀▀▀▀▀  ▀▀▀▀▀▀  ▀▀       ▀▀▀▀▀  ██
  22.                   ▀▀   ▀▀  ▀▀   ▀▀ ▀▀   ▀▀ ▀▀      ▀▀   ▀▀  ▀
  23.                  ▀▀▀   ▀▀▀ ▀▀▀▀▀▀▀ ▀▀▀▀▀▀  ▀▀      ▀▀▀▀▀▀▀
  24.                   ▀▀ ▀ ▀▀  ▀▀   ▀▀ ▀▀      ▀▀      ▀▀   ▀▀
  25.                    ▀▀▀▀ ▀  ▀▀   ▀▀ ▀▀      ▀▀▀▀▀▀▀ ▀▀   ▀▀
  26.  
  27.  
  28.  
  29.  
  30.  
  31.                                   "SFKLTTRV"
  32.  
  33.                          Spitfire Klingon Trivia Door
  34.                            Release 1.0  (04/01/93)
  35.                                       by
  36.                               Robert J. Ferguson
  37.  
  38.             ═════════════════════════════════════════════════════
  39.              (C) 1993 Klingon SoftWare Labs, All Rights Reserved
  40.                         215-426-5596 ... 1200-19200bps
  41.                 FidoNet - 1:273/935     TrekNet - 87:6007/9016
  42.                                   Member of
  43.                   Klingon Legion of Assault Warriors (KLAW)
  44.             ═════════════════════════════════════════════════════
  45.  
  46.  
  47.  
  48.    INTRODUCTION
  49.    ^^^^^^^^^^^^
  50.  
  51.     SFKLTTRV is a fast paced Klingon Language Trivia designed to run
  52.    as a door feature within the SPITFIRE Bulletin Board System or any other
  53.    BBS program, provided, you use a door converter program (i.e. QkDoor,
  54.    etc.). I am currently running nine (9) SpitFire Trivia Door Games from my
  55.    WildCat! v2.55s. Klingon Trivia can also be run as a stand-alone (from DOS
  56.    prompt). It can also be installed as a SysOp configurable command from the
  57.    Main, File or Message menus of SPITFIRE.  A data file containing 200+
  58.    Klingon Trivia questions is randomly accessed and displayed to the
  59.    screen. With each question that is displayed, four multiple choice options
  60.    are provided from which the player may select.  SFKLTTRV allows the player
  61.    ten seconds to read the question and respond with the number corresponding
  62.    to the answer they wish to select.
  63.  
  64.  
  65.    SFKLTTRV SETUP AS A SPITFIRE DOOR
  66.    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  67.  
  68.     To set up SFKLTTRV to be executed as a door, it is recommended that
  69.    a separate directory be set up for it.  For explanation purposes, let's
  70.    assume the directory DOORA is created for use with SFKLTTRV. The following
  71.    files must then be placed in the directory:
  72.  
  73.    SFKLTTRV.EXE    The actual game program.
  74.  
  75.    SFKLTTRV.DAT    The data file containing the trivia questions.
  76.  
  77.    SFKLTTRV.TOP    This is a listing of the top ten players. SFKLTTRV.EXE
  78.                    will create this file if it is not found.
  79.  
  80.    SFKLTTRV.CLR    This is a listing in Color of the top ten players.
  81.                    SFKLTTRV.EXE will create this file if it is not found.
  82.  
  83.    SFKLTTRV.LMT    This allows you to set time limits according to your
  84.                    callers security level. Sample information in file.
  85.  
  86.    SFKLTTRV.DOC    The file you are reading now.
  87.  
  88.    SFKLTTRV.REG    Registration Key (delivered upon registration)
  89.  
  90.    REGISTER.TXT    Form to use to register your copy of "SFKLTTRV".
  91.  
  92.    PACKING.LST     Contains the listing of all the original files that are
  93.                    supposed to be in the "SFKLTTRV.ZIP" archive.
  94.  
  95.    GO.BAT          This will run Klingon Trivia in local mode.
  96.  
  97.    KSL.COM         Klingon SoftWare Labs Advertising Screen.
  98.  
  99.    INSTALL.BAT     Use this to install on you HDDrive.
  100.  
  101.     The SysOp will then need to use a text editor to edit the SF.BAT file
  102.    as illustrated below:
  103.  
  104.        :DOOR_A
  105.        COPY SFDOORS.DAT C:\SF\DOORA
  106.        SFKLTTRV
  107.        ERASE SFDOORS.DAT
  108.        GOTO LOOP
  109.        :DOOR_B
  110.  
  111.     You will notice that the commands needed to execute SFKLTTRV are placed
  112.    between the :DOOR_A and GOTO LOOP command lines.  These are entered in
  113.    place of the existing REM Place Program Name Here.  The following will
  114.    briefly explain each of the commands which were set up within SF.BAT to
  115.    run SFKLTTRV as a SPITFIRE Door program:
  116.  
  117.     SFDOORS.DAT is created automatically by SPITFIRE when a user enters a
  118.    door.  It contains information about the user such as name and password.
  119.    SFKLTTRV requires access to the information within SFDOORS.DAT. Therefore,
  120.    before executing the program it must be copied to the directory in which
  121.    SFKLTTRV is running.
  122.  
  123.     SFKLTTRV is the program name and executes the game program from within
  124.    the door program.
  125.  
  126.     Once the user has terminated the game play of SFKLTTRV, SPITFIRE
  127.    erases the SFDOORS.DAT file.
  128.  
  129.  
  130.     SFKLTTRV SETUP AS A SYSOP CONFIGURABLE COMMAND
  131.     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  132.  
  133.     SPITFIRE has a SysOp configurable command for the Main, Message and
  134.    File menus.  The SysOp configurable command is executed through a
  135.    batch file which corresponds to the menu it is being run from.  In
  136.    other words, SFMAIN.BAT runs the SysOp configurable command from
  137.    the Main Menu, SFMESS.BAT runs the one from the Message Menu and
  138.    SFFILE.BAT the one from the File Menu.  The commands necessary
  139.    to execute SFKLTTRV can be set up in the batch file which corresponds
  140.    to the menu you wish to have SFKLTTRV run from.
  141.  
  142.     The first thing you will need to establish is which of these menus
  143.    you wish to use to run SFKLTTRV.  For this purpose, let's assume that
  144.    it is going to be set up so it can be run from the Main Menu.  (It
  145.    should be noted the set up procedure is the same regardless of which
  146.    Menu you are running SFKLTTRV from.)
  147.  
  148.     Next, you will need to decide what you wish to name the command
  149.    option and establish what security level will be required for
  150.    users of your system to be able to access this option.  Once this
  151.    is determined you will need to modify the SFMAIN.MNU file using
  152.    your favorite text editor, as long as it saves in ASCII format.
  153.    (Refer to the SPITFIRE manual for further documentation on this
  154.    if needed.  It should also be noted that if SFKLTTRV were being
  155.    set up to run from the File Menu, you would need to modify the
  156.    SFFILE.MNU file and if it was being set up to be run from the
  157.    Message Menu you would need to modify the SFMSG.MNU file.)
  158.  
  159.  
  160.     Examining the default SFMAIN.MNU file, you will notice the SysOp
  161.    configurable command appears as:
  162.  
  163.         <K>............. Add Your Own,,1000,@
  164.  
  165.     This will need to be replaced with a Command Character that will
  166.    be used to select the option from the menu.  It is ASOLUTELY IMPERATIVE
  167.    that the Command Character must not duplicate an existing Command
  168.    Character for another menu option.  You will then need to include
  169.    a brief description of the Spitfire door program you are running, two
  170.    commas, the security level required to access this feature, and another
  171.    comma followed by the a @.  The @ must not be changed! (For more detailed
  172.    information on modifying your SFMAIN.MNU, SFMSG.MNU or SFFILE.MNU refer
  173.    to your SPITFIRE manual.)
  174.  
  175.        <K>.... Brief Program Description,,10,@
  176.  
  177.     Now you will need to modify the corresponding batch file, SFMAIN.BAT,
  178.    so that it can be executed from the Main Menu.  Do this using your
  179.    favorite text editor, as long as it saves in ASCII format.  (Again, it
  180.    should be noted that if SFKLTTRV were being set up to run from the File
  181.    Menu, you would need to modify the SFFILE.BAT file and if it was being
  182.    set up to be run from the Message Menu you would need to modify the
  183.    SFMESS.BAT file.)
  184.  
  185.     Place the SFKLTTRV.EXE file in the directory you wish to run the
  186.    program from.  SFKLTTRV will create its own player score file,
  187.    SFKLTTRV.TOP, if does not already exist.
  188.  
  189.     The commands set up in the SFMAIN.BAT file are very similar to
  190.    those used for executing the game through a door in the SF.BAT file.
  191.    For instance, if you were running SFKLTTRV from the main SPITFIRE
  192.    directory your SFMAIN.BAT file might look like this:
  193.  
  194.        ECHO OFF
  195.        BRK OFF
  196.        SFKLTTRV
  197.        BRK ON
  198.  
  199.     (BRK is not included in the SFKLTTRV package because it is written
  200.    and copyrighted by Solid Systems, 1985, but can be downloaded from
  201.    Klingon Bird of Prey! and Buffalo Creek's BBS as well as a number of other
  202.    BBS systems.  BRK is not required to run SFKLTTRV, however, it
  203.    is recommended since it will prevent a user using the CTRL BRK command
  204.    to terminate the batch file, gaining access to your system at the
  205.    DOS level.). We did include a file titled BRK.DRV which is a driver file
  206.    that you can add into your CONFIG.SYS (DEVICE=drive\path\BRK.DRV).
  207.  
  208.     If you wish to set SFKLTTRV up in a separate subdirectory from
  209.    SPITFIRE, for instance, a subdirectory named SFKLTTRV, your batch
  210.    file might look like this.
  211.  
  212.        ECHO OFF
  213.        BRK OFF
  214.        COPY SFMAIN.DAT \SF\SFKLTTRV
  215.        CD \SF\SFKLTTRV
  216.  
  217.        ERASE SFMAIN.DAT
  218.        CD \SF
  219.        BRK ON
  220.  
  221.     When SFKLTTRV is executed, from either the door with the SF.BAT file
  222.    or from the SysOp configurable command through a menu with the
  223.    corresponding batch file, it will first look for the SFMAIN.DAT file,
  224.    then the SFMESS.DAT file, then the SFFILE.DAT file and lastly the
  225.    SFDOORS.DAT file.  It will look for each of these files until it finds
  226.    it and the commands required for its execution.  If none of these
  227.    files are found, SFKLTTRV will halt its execution.
  228.  
  229.                      KLINGON LANGUAGE HIGH SCORE BULLETINS
  230.                      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  231.  
  232.     A command line parameter is available which will automatically
  233.    create Ansi and Non-Ansi high score bulletins for your BBS system.
  234.    If you would like to use this option, a "/P" should follow the
  235.    SFKLTTRV in the command line to indicate a valid DOS path where the
  236.    bulletin file will be created.   (NOTE:  This should be the same
  237.    as the display file path you have set up within SPITFIRE.)  The path
  238.    is then followed by the file name of the bulletin to be created.  It
  239.    is not necessary to include the file extension.  SFKLTTRV will
  240.    automatically add a .BBS extension for the Non-Ansi display file and
  241.    a .CLR extension for the Ansi display file created.  The correct
  242.    syntax should look like this:
  243.  
  244.     SFKLTTRV /P C:\SF\DISPLAY\DORBUL1
  245.  
  246.     The "/P" command line is optional and SFKLTTRV will operate perfectly
  247.    fine without it.  However, it is a convenient means of providing and
  248.    posting high score bulletins for the Klingon Trivia door.
  249.  
  250.     LOCAL PLAY OF SFKLTTRV
  251.     ^^^^^^^^^^^^^^^^^^^^^^
  252.  
  253.     It should also be noted that a SysOp can play SFKLTTRV locally by
  254.    entering the following command at the DOS prompt:
  255.  
  256.     C:>SFKLTTRV /L
  257.  
  258.     ** SPECIAL NOTE **  The "/L" and the "/P" command parameters can
  259.     be used together in one command line to specify the drive, path
  260.     and filename of the bulletin to be created when playing in
  261.     local mode.
  262.  
  263.  
  264.     DTE LOCK FEATURE
  265.     ^^^^^^^^^^^^^^^^
  266.  
  267.     SFKLTTRV automatically detects if the DTE is locked at 19200 baud.  If
  268.    SFKLTTRV detects that the DTE is locked, then SFKLTTRV opens the serial
  269.    port to the maximum baud rate of your system.  If SFKLTTRV does not
  270.    detect that the DTE is locked, then the serial port is opened to the
  271.    baud rate of the caller.
  272.  
  273.     SYSOP FEATURES
  274.     ^^^^^^^^^^^^^^
  275.  
  276.     First, a status line is now displayed on the BBS monitor that
  277.    provides information concerning the caller's name, baud rate of the
  278.    caller and the security level of the caller.
  279.  
  280.     A SFKLTTRV.LMT file allows the SysOp to establish a time limit for
  281.    door play according to the security level the caller has on the system.
  282.    To modify the accompanying SFKLTTRV.LMT file, use your favorite text
  283.    editor to represent the various security levels you have available on
  284.    your system, a comma then the corresponding time you wish to allow for
  285.    that particular security level in minutes.  For instance, it might
  286.    look like this:
  287.  
  288.             10,15
  289.             25,20
  290.             50,25
  291.             999,30
  292.  
  293.     Each security level should begin a new line and you should have a
  294.    setting for each security level you have available on your system.
  295.    If you do not have a time limit set for a particular security
  296.    SFKLTTRV will default to the level 10 security level setting.
  297.  
  298.     Pressing the Shift Key and the F1 key simultaneously will
  299.    terminate game play of SFKLTTRV and return the caller back to the
  300.    BBS.  Pressing the Shift Key and the F9 key simultaneously will
  301.    terminate game play of SFKLTTRV and log the caller off of the BBS.
  302.    If the Shift Key and the F9 key are pressed together, logging the
  303.    caller off the BBS, SPITFIRE will recycle and return to the
  304.    SPITFIRE Ready For Caller Prompt.
  305.  
  306.  
  307.     SFKLTTRV EXECUTION
  308.     ^^^^^^^^^^^^^^^^^^
  309.  
  310.     When first executed, SFKLTTRV will display a list of the Top Ten
  311.    high score players and the percentage of correct responses they acheived
  312.    while playing SFKLTTRV.  Initially, this will be a dummy listing with
  313.    ten lines that display:
  314.  
  315.       0%...............YOUR NAME COULD BE HERE
  316.  
  317.     However, as the game is played, this will fill with the name of the
  318.    players, their percentage ratings and the date that the player was
  319.    added to the top ten listing.
  320.  
  321.     NOTE: At least twenty questions must be attempted before SFKLTTRV will
  322.          figure the percentage rating for the player.
  323.  
  324.     To keep things interesting...the SysOp can erase the file which contains
  325.    the top ten listings SFKLTTRV.TOP on a routine basis to give additional
  326.    players a chance to have their name added to the list.
  327.  
  328.     As the top ten list is displayed, at the bottom of the screen  is a
  329.    question which prompts the user whether they want to have ANSI Graphics
  330.    (y/n)? available to them during game play.  If the user responds with a
  331.    y (for yes) the game will display in color and if the user responds with
  332.    a n (for no) the game will display in monochrome.
  333.  
  334.     PLAYING SFKLTTRV
  335.     ^^^^^^^^^^^^^^^^
  336.  
  337.     Immediately after pressing any key (other than <Q> for Quit) from
  338.    the Top Ten listing the game screen is displayed.  The screen will
  339.    look like the following:
  340.  
  341.    ------------------------------------------------------------------------
  342.  
  343.                ╔═════════════════════════════════════════════╗
  344.                ║            >>>>>>> SFKLTTRV <<<<<<<         ║
  345.                ║                  Release 1.0                ║
  346.                ║      Klingon Trivia For SPITFIRE Doors      ║
  347.                ║    Klingon Bird of Prey! - (215) 426-5596   ║
  348.                ║ In Cooperation with Buffalo Creek SoftWare  ║
  349.                ║ Copyright (C) by Robert J. Ferguson, 1993   ║
  350.                ║        UNREGISTERED ShareWare VERSION!      ║
  351.                ╚═════════════════════════════════════════════╝
  352.  
  353.     RIGHT: 0                        WRONG: 0
  354.  
  355.     QUESTION:
  356.     The Klingon Language question will be displayed
  357.     here.
  358.  
  359.     <1> Choice 1                        <2> Choice 2
  360.     <3> Choice 3                        <4> Choice 4
  361.  
  362.              Enter Answer: [ 1 2 3 4 <Q>uit]?
  363.  
  364.    -----------------------------------------------------------------------
  365.  
  366.     The first randomly choosen trivia question is selected from the data
  367.    file and is displayed to the screen.
  368.  
  369.     The player makes his selection by entering the corresponding number.
  370.    as the game progresses, SFKLTTRV will provide a running total of the
  371.    correct answers and also of the wrong answers the user has selected
  372.    during the game play.
  373.  
  374.     If the ten second timer should elapse before you respond, SFKLTTRV
  375.    will count this as a wrong response and add an incorrect answer to
  376.    the total WRONG answers obtained so far.
  377.  
  378.  
  379.     EXITING PLAY
  380.     ^^^^^^^^^^^^
  381.  
  382.     When you are ready to exit the game, simply select press "Q" for
  383.    <Q>uit.  If you qualify as one of the top ten players to date,
  384.    SFKLTTRV will congratulate you for becoming one of the top ten scorers
  385.    and add your name to the Top Ten listing.  You will once again see the
  386.    Top Ten list displayed with your name added to the list.
  387.  
  388.     If you exit the game before you have completed the twenty
  389.    questions required for eligibility to the Top Ten list or if you do not
  390.    qualify as a Top Ten player, the Top Ten listing will be displayed and
  391.    you will be prompted to press any key to return to SPITFIRE.
  392.  
  393.  
  394.     TECHNICAL SUPPORT SERVICES
  395.     ^^^^^^^^^^^^^^^^^^^^^^^^^^
  396.  
  397.     Satisfied customers are our greatest asset. As a registered customer,
  398.    you will be  enrolled in our telephone technical support program.
  399.    Klingon Trivia was designed for ease and use, and this manual should
  400.    contain the answers to most of your questions. Until your registration
  401.    information is received, technical support is NOT available via our BBS
  402.    or by phone from our technical staff. You may first want to call our own
  403.    WildCat! Public-Access System at 215-426-5596 and leave a quick question
  404.    to our technical staff. You will NOT have full access on your first call
  405.    since we need you to fill out the user database information, such as
  406.    your password, etc. Your security access will be upgraded within 24hrs
  407.    after your first call, providing your registration information is on
  408.    file. This method of obtaining support is especially useful if you want
  409.    expert guidance regarding the most advanced features. Support is not
  410.    available by mail or FAX.
  411.  
  412.  
  413.     BENEFITS OF SENDING YOUR REGISTRATION
  414.     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  415.  
  416.     *    Free technical support by voice phone Monday through Friday
  417.          between 9am and 5pm Eastern time.
  418.  
  419.     *    Automatic notification of major program updates.
  420.  
  421.     *    24-hour access to the private "Registered Users" HQ BBS at the
  422.          Klingon SoftWare Labs.
  423.  
  424.     *    BBS access to download proprietary programs written by both KSL
  425.          and other authors which enhance and add features.
  426.  
  427.     *    1 year "Paid Subscription" to our BBS.
  428.  
  429.     DISTRIBUTION
  430.     ^^^^^^^^^^^^
  431.  
  432.     Please feel free to share SFKLTTRV.ZIP with others.  However, it must
  433.    be distributed with ALL files shown in the distribution package. The
  434.    listing of the files can be found in the file PACKING.LST in the same
  435.    archive as the rest. The files must not be altered in any way or by
  436.    any means.
  437.  
  438.     SFKLTTRV.ZIP is distributed as ShareWare SoftWare.  You are free to
  439.    try SFKLTTRV, and if you find it to be a program you use please fill out
  440.    the enclosed registration form (REGISTER.TXT) and mail along with a money
  441.    order for $15.00, you will have available to you a registered file you can
  442.    download from Klingon Bird of Prey! at (215)426-5596 in the BoP SoftWare
  443.    Registered Files Area, we will also "CRASH" it to you if you are a FidoNet
  444.    system or mail the disk to you. The registration form tells you everything
  445.    you need to know.
  446.  
  447.  
  448.     DISCLAIMER
  449.     ^^^^^^^^^^
  450.  
  451.     Robert J. Ferguson, Klingon Bird of Prey! or KSL SoftWare Labs shall not
  452.    be held responsible for any damage incurred by the user to hardware,
  453.    SoftWare, or peripheral devices while running SFKLTTRV. All of the
  454.    responsibility lies in the user of the SoftWare.
  455.  
  456.     Many thanks are indeed owed to Mike Woltz of Buffalo Creek BBS (515)-
  457.    225-8496 for his assistance.  Without his help this program would not
  458.    have been possible.
  459.  
  460.  
  461.     ACKNOWLEDGMENTS
  462.     ^^^^^^^^^^^^^^^
  463.  
  464.     We would like to thank the following people for their contributions to
  465.    The Klingon SoftWare Labs:
  466.  
  467.    Trivia Questions - Tony Rowley (U.S.S. Malverne, Philadelphia PA)
  468.    Beta Testing - Chuck/Gigi Wingel (GraveYard BBS 215-622-0309)
  469.    Beta Testing - Earl Driscoll (Earl's EX-XT Board 215-727-8085)
  470.    Beta Testing - Dan Fanin (Tower BBS 215-525-5917)
  471.  
  472.  
  473.     SFKLTTRV and other SPITFIRE programs are available for download from:
  474.  
  475.                                Buffalo Creek BBS
  476.                                SysOp - Mike Woltz
  477.                                  (515) 225-8496
  478.                                   1200 - 19200
  479.  
  480.  
  481.  
  482.  ╒══════════════════════════════════PART I ══╕
  483.  │ KLINGON LANGUAGE TRIVIA           v1.0    │
  484.  │ A fast paced Klingon Trivia Door:         │ FileName: SFKLTTRV.ZIP
  485.  │ designed to run on any BBS or as a Stand  │ MagicName: KLINLANG
  486.  │ Alone (DOS prompt). Has over 200+ trivia  │ FidoNet - 1:273/935
  487.  │ questions in Klingon to English  - AND -  │ TrekNet - 87:6007/9016
  488.  │ English to Klingon!     (1st Release)     │ PhoneNum: 215-426-5596
  489.  │ PROGRAM AUTHOR: Robert J Ferguson - SysOp │ USRobotics 14.4/HST
  490.  │ Klingon Bird of Prey BBS (215) 426-5596   │
  491.  ╘═══════════════════════════════════════════╛
  492.  (C) 1993 Klingon SoftWare Labs, All Rights Reserved
  493.  Support is avail at: Klingon SoftWare Labs
  494.                       FidoNet Node 1:273/935 (DoorWare/DoorGames Conf)
  495.                       TrekNet Node 87:6007/9016 (Klingon Conf)
  496.                       (215) 426-5596   Available 23hrs Daily
  497.                       1200 - 14.4 USRobotics/HST
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.